← Back to branch summary

~ubuntu-branches/ubuntu/trusty/gstreamer1.0/trusty

« back to all changes in this revision

Viewing changes to docs/gst/running.xml

  • Committer: Package Import Robot
  • Author(s): Sebastian Dröge
  • Date: 2012-05-21 11:14:06 UTC
  • mfrom: (1.1.1)
  • Revision ID: package-import@ubuntu.com-20120521111406-1wfas0o9fdaxjyo8
Tags: 0.11.91-1
* New upstream release, "I will give you five magic beans!":
  + debian/libgstreamer.symbols:
    - Update symbols file.
* debian/libgstreamer-dev.install:
  + Don't ship useless .la file for the core plugins.
  + Don't ship .a and .la files for the library.
* debian/control.in:
  + Update debhelper dependency version and Standards-Version.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/gst/running.xml
95
95
  <para>
96
96
The variable takes a comma-separated list of "category_name:level" pairs
97
97
to set specific levels for the individual categories.
98
 
The level value ranges from 0 (nothing) to 5 (LOG).
 
98
The level value ranges from 0 (nothing) to 9 (MEMDUMP).
99
99
    <variablelist>
100
100
 
101
101
      <varlistentry>
120
120
      </varlistentry>
121
121
 
122
122
      <varlistentry>
123
 
        <term>3 - <option>INFO</option></term>
 
123
        <term>3 - <option>FIXME</option></term>
 
124
        <listitem>
 
125
<para>
 
126
Logs all fixme messages. Fixme messages are messages that indicate that something
 
127
in the executed code path is not fully implemented or handled yet.  The purpose
 
128
of this message is to make it easier to spot incomplete/unfinished pieces of
 
129
code when reading the debug log.
 
130
</para>
 
131
        </listitem>
 
132
      </varlistentry>
 
133
 
 
134
      <varlistentry>
 
135
        <term>4 - <option>INFO</option></term>
124
136
        <listitem>
125
137
<para>
126
138
Logs all informational messages.  These are typically used for events in
131
143
      </varlistentry>
132
144
 
133
145
      <varlistentry>
134
 
        <term>4 - <option>DEBUG</option></term>
 
146
        <term>5 - <option>DEBUG</option></term>
135
147
        <listitem>
136
148
<para>
137
149
Logs all debug messages.  These are general debug messages for events
142
154
      </varlistentry>
143
155
 
144
156
      <varlistentry>
145
 
        <term>5 - <option>LOG</option></term>
 
157
        <term>6 - <option>LOG</option></term>
146
158
        <listitem>
147
159
<para>
148
160
Logs all log messages.  These are messages for events
151
163
</para>
152
164
        </listitem>
153
165
      </varlistentry>
 
166
 
 
167
      <varlistentry>
 
168
        <term>7 - <option>TRACE</option></term>
 
169
        <listitem>
 
170
<para>
 
171
Logs all trace messages.  These messages for events
 
172
that happen repeatedly during an object's lifetime such as the
 
173
ref/unref cycles.
 
174
</para>
 
175
        </listitem>
 
176
      </varlistentry>
 
177
 
 
178
      <varlistentry>
 
179
        <term>9 - <option>MEMDUMP</option></term>
 
180
        <listitem>
 
181
<para>
 
182
Log all memory dump messages. Memory dump messages are used to log
 
183
(small) chunks of data as memory dumps in the log. They will be displayed
 
184
as hexdump with ASCII characters.
 
185
</para>
 
186
        </listitem>
 
187
      </varlistentry>
154
188
    </variablelist>
155
189
 
156
190
 The category_name can contain "<option>*"</option> as a wildcard.
158
192
 
159
193
  <para>
160
194
For example, setting <envar>GST_DEBUG</envar> to
161
 
<option>GST_AUTOPLUG:5,GST_ELEMENT_*:3</option>, will cause the
 
195
<option>GST_AUTOPLUG:6,GST_ELEMENT_*:4</option>, will cause the
162
196
<option>GST_AUTOPLUG</option> category to be logged at full
163
197
<option>LOG</option> level, while all categories starting with
164
198
<option>GST_ELEMENT_</option> will be logged at <option>INFO</option> level.
167
201
  <para>
168
202
To get all possible debug output, set
169
203
<envar>GST_DEBUG</envar>
170
 
to <option>*:5</option>
 
204
to <option>*:9</option>
171
205
  </para>
172
206
 
173
207
</formalpara>
236
270
 
237
271
</formalpara>
238
272
 
 
273
<formalpara id="GST_TRACE">
 
274
  <title><envar>GST_TRACE</envar></title>
 
275
 
 
276
  <para>
 
277
    Enable memory allocation tracing. Most GStreamer objects have support for
 
278
    tracing the number of unfreed objects and their memory pointers.
 
279
  </para>
 
280
  <para>
 
281
The variable takes a comma-separated list of tracing options to enable.
 
282
    <variablelist>
 
283
 
 
284
      <varlistentry>
 
285
        <term>live</term>
 
286
        <listitem>
 
287
<para>
 
288
  Counts all live objects and dumps an overview of the number of unfreed
 
289
  objects at program exit.
 
290
</para>
 
291
        </listitem>
 
292
      </varlistentry>
 
293
 
 
294
      <varlistentry>
 
295
        <term>mem-live</term>
 
296
        <listitem>
 
297
<para>
 
298
  Keep track of the unfreed memory pointers and dump an overview of all unfreed
 
299
  memory at program exit. Together with a level 9 debug log this can be used to
 
300
  follow the lifecycle of leaked objects in order to track down where they are
 
301
  leaked.
 
302
</para>
 
303
        </listitem>
 
304
      </varlistentry>
 
305
    </variablelist>
 
306
 
 
307
 Use <option>all</option> to enable all tracing flags.
 
308
  </para>
 
309
</formalpara>
 
310
 
239
311
<formalpara id="ORC_CODE">
240
312
  <title><envar>ORC_CODE</envar></title>
241
313