This file is indexed.

/usr/include/gstreamermm-1.0/gstreamermm/miniobject.h is in libgstreamermm-1.0-dev 1.4.3+dfsg-5.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
// -*- c++ -*-
// Generated by gmmproc 2.42.0 -- DO NOT MODIFY!
#ifndef _GSTREAMERMM_MINIOBJECT_H
#define _GSTREAMERMM_MINIOBJECT_H


#include <glibmm/ustring.h>
#include <sigc++/sigc++.h>

/* gstreamermm - a C++ wrapper for gstreamer
 *
 * Copyright 2008 The gstreamermm Development Team
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free
 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

#include <gst/gst.h>
#include <glibmm/value.h>
#include <sigc++/sigc++.h>

#include <map>


namespace Gst
{

/** @addtogroup gstreamermmEnums gstreamermm Enums and Flags */

/** 
 *  @var MiniObjectFlags MINI_OBJECT_FLAG_LOCKABLE
 *  The object can be locked and unlocked with Gst::MiniObject::lock() and Gst::MiniObject::unlock().
 * 
 *  @var MiniObjectFlags MINI_OBJECT_FLAG_LOCK_READONLY
 *  The object is permanently locked in READONLY mode. Only read locks can be performed on the object.
 * 
 *  @var MiniObjectFlags MINI_OBJECT_FLAG_LAST
 *  First flag that can be used by subclasses.
 * 
 *  @enum MiniObjectFlags
 * 
 * Flags for the mini object
 * @ingroup gstreamermmEnums
 * @par Bitwise operators:
 * <tt>%MiniObjectFlags operator|(MiniObjectFlags, MiniObjectFlags)</tt><br>
 * <tt>%MiniObjectFlags operator&(MiniObjectFlags, MiniObjectFlags)</tt><br>
 * <tt>%MiniObjectFlags operator^(MiniObjectFlags, MiniObjectFlags)</tt><br>
 * <tt>%MiniObjectFlags operator~(MiniObjectFlags)</tt><br>
 * <tt>%MiniObjectFlags& operator|=(MiniObjectFlags&, MiniObjectFlags)</tt><br>
 * <tt>%MiniObjectFlags& operator&=(MiniObjectFlags&, MiniObjectFlags)</tt><br>
 * <tt>%MiniObjectFlags& operator^=(MiniObjectFlags&, MiniObjectFlags)</tt><br>
 */
enum MiniObjectFlags
{
  MINI_OBJECT_FLAG_LOCKABLE = (1 << 0),
  MINI_OBJECT_FLAG_LOCK_READONLY = (1 << 1),
  MINI_OBJECT_FLAG_LAST = (1 << 4)
};

/** @ingroup gstreamermmEnums */
inline MiniObjectFlags operator|(MiniObjectFlags lhs, MiniObjectFlags rhs)
  { return static_cast<MiniObjectFlags>(static_cast<unsigned>(lhs) | static_cast<unsigned>(rhs)); }

/** @ingroup gstreamermmEnums */
inline MiniObjectFlags operator&(MiniObjectFlags lhs, MiniObjectFlags rhs)
  { return static_cast<MiniObjectFlags>(static_cast<unsigned>(lhs) & static_cast<unsigned>(rhs)); }

/** @ingroup gstreamermmEnums */
inline MiniObjectFlags operator^(MiniObjectFlags lhs, MiniObjectFlags rhs)
  { return static_cast<MiniObjectFlags>(static_cast<unsigned>(lhs) ^ static_cast<unsigned>(rhs)); }

/** @ingroup gstreamermmEnums */
inline MiniObjectFlags operator~(MiniObjectFlags flags)
  { return static_cast<MiniObjectFlags>(~static_cast<unsigned>(flags)); }

/** @ingroup gstreamermmEnums */
inline MiniObjectFlags& operator|=(MiniObjectFlags& lhs, MiniObjectFlags rhs)
  { return (lhs = static_cast<MiniObjectFlags>(static_cast<unsigned>(lhs) | static_cast<unsigned>(rhs))); }

/** @ingroup gstreamermmEnums */
inline MiniObjectFlags& operator&=(MiniObjectFlags& lhs, MiniObjectFlags rhs)
  { return (lhs = static_cast<MiniObjectFlags>(static_cast<unsigned>(lhs) & static_cast<unsigned>(rhs))); }

/** @ingroup gstreamermmEnums */
inline MiniObjectFlags& operator^=(MiniObjectFlags& lhs, MiniObjectFlags rhs)
  { return (lhs = static_cast<MiniObjectFlags>(static_cast<unsigned>(lhs) ^ static_cast<unsigned>(rhs))); }

} // namespace Gst


#ifndef DOXYGEN_SHOULD_SKIP_THIS
namespace Glib
{

template <>
class Value<Gst::MiniObjectFlags> : public Glib::Value_Flags<Gst::MiniObjectFlags>
{
public:
  static GType value_type() G_GNUC_CONST;
};

} // namespace Glib
#endif /* DOXYGEN_SHOULD_SKIP_THIS */


namespace Gst
{

/** 
 *  @var LockFlags LOCK_FLAG_READ
 *  Lock for read access.
 * 
 *  @var LockFlags LOCK_FLAG_WRITE
 *  Lock for write access.
 * 
 *  @var LockFlags LOCK_FLAG_EXCLUSIVE
 *  Lock for exclusive access.
 * 
 *  @var LockFlags LOCK_FLAG_LAST
 *  First flag that can be used for custom purposes.
 * 
 *  @enum LockFlags
 * 
 * Flags used when locking miniobjects
 * @ingroup gstreamermmEnums
 * @par Bitwise operators:
 * <tt>%LockFlags operator|(LockFlags, LockFlags)</tt><br>
 * <tt>%LockFlags operator&(LockFlags, LockFlags)</tt><br>
 * <tt>%LockFlags operator^(LockFlags, LockFlags)</tt><br>
 * <tt>%LockFlags operator~(LockFlags)</tt><br>
 * <tt>%LockFlags& operator|=(LockFlags&, LockFlags)</tt><br>
 * <tt>%LockFlags& operator&=(LockFlags&, LockFlags)</tt><br>
 * <tt>%LockFlags& operator^=(LockFlags&, LockFlags)</tt><br>
 */
enum LockFlags
{
  LOCK_FLAG_READ = (1 << 0),
  LOCK_FLAG_WRITE = (1 << 1),
  LOCK_FLAG_EXCLUSIVE = (1 << 2),
  LOCK_FLAG_LAST = (1 << 8)
};

/** @ingroup gstreamermmEnums */
inline LockFlags operator|(LockFlags lhs, LockFlags rhs)
  { return static_cast<LockFlags>(static_cast<unsigned>(lhs) | static_cast<unsigned>(rhs)); }

/** @ingroup gstreamermmEnums */
inline LockFlags operator&(LockFlags lhs, LockFlags rhs)
  { return static_cast<LockFlags>(static_cast<unsigned>(lhs) & static_cast<unsigned>(rhs)); }

/** @ingroup gstreamermmEnums */
inline LockFlags operator^(LockFlags lhs, LockFlags rhs)
  { return static_cast<LockFlags>(static_cast<unsigned>(lhs) ^ static_cast<unsigned>(rhs)); }

/** @ingroup gstreamermmEnums */
inline LockFlags operator~(LockFlags flags)
  { return static_cast<LockFlags>(~static_cast<unsigned>(flags)); }

/** @ingroup gstreamermmEnums */
inline LockFlags& operator|=(LockFlags& lhs, LockFlags rhs)
  { return (lhs = static_cast<LockFlags>(static_cast<unsigned>(lhs) | static_cast<unsigned>(rhs))); }

/** @ingroup gstreamermmEnums */
inline LockFlags& operator&=(LockFlags& lhs, LockFlags rhs)
  { return (lhs = static_cast<LockFlags>(static_cast<unsigned>(lhs) & static_cast<unsigned>(rhs))); }

/** @ingroup gstreamermmEnums */
inline LockFlags& operator^=(LockFlags& lhs, LockFlags rhs)
  { return (lhs = static_cast<LockFlags>(static_cast<unsigned>(lhs) ^ static_cast<unsigned>(rhs))); }

} // namespace Gst


#ifndef DOXYGEN_SHOULD_SKIP_THIS
namespace Glib
{

template <>
class Value<Gst::LockFlags> : public Glib::Value_Flags<Gst::LockFlags>
{
public:
  static GType value_type() G_GNUC_CONST;
};

} // namespace Glib
#endif /* DOXYGEN_SHOULD_SKIP_THIS */


namespace Gst
{


/** This is a base class for data which represents qdata.
 */
class QuarkData
{
public:
  virtual ~QuarkData(){}
};

/** This is a base class for some gstreamermm objects.
 * It is similar to Glib::Object but has no GObject property or signal support.
 */
class MiniObject
{
  public:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
  typedef MiniObject CppObjectType;
  typedef GstMiniObject BaseObjectType;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */


  /** Increment the reference count for this object.
   * You should never need to do this manually - use the object via a RefPtr instead.
   */
  void reference()   const;

  /** Decrement the reference count for this object.
   * You should never need to do this manually - use the object via a RefPtr instead.
   */
  void unreference() const;

  ///Provides access to the underlying C instance.
  GstMiniObject*       gobj();

  ///Provides access to the underlying C instance.
  const GstMiniObject* gobj() const;

  ///Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
  GstMiniObject* gobj_copy() const;

protected:
  // Do not derive this.  Gst::MiniObject can neither be constructed nor deleted.
  MiniObject();
  void operator delete(void*, std::size_t);

private:
  // noncopyable
  MiniObject(const MiniObject&);
  MiniObject& operator=(const MiniObject&);


public:
  typedef sigc::slot< void > SlotFinalizer;

  ~MiniObject();
   guint get_flags() const;
    void set_flags(const guint& value);
 
   gint get_refcount() const;
 
   gint get_lockstate() const;
 
  
  /** Lock the mini-object with the specified access mode in @a flags.
   * 
   * @param flags Gst::LockFlags.
   * @return <tt>true</tt> if @a object could be locked.
   */
  bool lock(LockFlags flags);
  
  /** Unlock the mini-object with the specified access mode in @a flags.
   * 
   * @param flags Gst::LockFlags.
   */
  void unlock(LockFlags flags);
  
  /** If @a mini_object has the LOCKABLE flag set, check if the current EXCLUSIVE
   * lock on @a object is the only one, this means that changes to the object will
   * not be visible to any other object.
   * 
   * If the LOCKABLE flag is not set, check if the refcount of @a mini_object is
   * exactly 1, meaning that no other reference exists to the object and that the
   * object is therefore writable.
   * 
   * Modification of a mini-object should only be done after verifying that it
   * is writable.
   * 
   * @return <tt>true</tt> if the object is writable.
   */
  bool is_writable() const;

  
  /** Checks if a mini-object is writable.  If not, a writable copy is made and
   * returned.  This gives away the reference to the original mini object,
   * and returns a reference to the new object.
   *
   * MT safe
   * @return A mini-object (possibly the same pointer) that
   * is writable.
   */
  Glib::RefPtr<MiniObject> create_writable();

  /** This sets an opaque, named pointer on a miniobject.
   * The name is specified through a #GQuark (retrived e.g. via
   * g_quark_from_static_string()), and the pointer
   * can be gotten back with get_qdata().
   * Setting a previously set user data pointer, overrides (frees)
   * the old pointer set, using NULL as pointer essentially
   * removes the data stored.
   * @param quark a GQuark, naming the user data pointer.
   * @param data an opaque user data pointer.
   */
  void set_qdata(GQuark quark, QuarkData *data);
  

  /** This function gets back user data pointers stored via
   * set_qdata().
   * @param quark a GQuark, naming the user data pointer.
   * @return the user data pointer set, or NULL.
   */
  QuarkData* get_qdata(GQuark quark) const;
  

  /** This function gets back user data pointers stored via set_qdata()
   * and removes the data from @a object without invoking its destroy() function (if
   * any was set).
   * 
   * @param quark A Quark, naming the user data pointer.
   * @return The user data pointer set, or <tt>0</tt>.
   */
  QuarkData* steal_qdata(GQuark quark);

  // Copying a mini object can be achieved by assignment.
  

  /** Adds notifier when mini object is finalized
   * @param slot notifier.
   */
  void add_finalize_notifier(const SlotFinalizer& slot);

  /** Remove finalize notifier
   */
  void remove_finalize_notifier();

  
private:
  // In this class non-static member cannot exists, so there is a map
  // with key = gobj() and value = handler.
  static std::map<GstMiniObject*, SlotFinalizer*> finalizers;

  static void destroy_qdata(gpointer qdata);

  static void MiniObject_Finalizer_gstreamermm_callback(gpointer userdata, GstMiniObject *obj);


};

} // namespace Gst


namespace Glib
{

  /** A Glib::wrap() method for this object.
   * 
   * @param object The C instance.
   * @param take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
   * @result A C++ instance that wraps this C instance.
   *
   * @relates Gst::MiniObject
   */
  Glib::RefPtr<Gst::MiniObject> wrap(GstMiniObject* object, bool take_copy = false);

} // namespace Glib


#endif /* _GSTREAMERMM_MINIOBJECT_H */