<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML
><HEAD
><TITLE
>Debugging</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
TITLE="GStreamer Application Development Manual"
HREF="index.html"><LINK
REL="UP"
TITLE="Appendices"
HREF="part-appendices.html"><LINK
REL="PREVIOUS"
TITLE="Appendices"
HREF="part-appendices.html"><LINK
REL="NEXT"
TITLE="Adding a custom debug handler"
HREF="section-debugging-adding-handler.html"></HEAD
><BODY
CLASS="chapter"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
><SPAN
CLASS="application"
>GStreamer</SPAN
> Application Development Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="part-appendices.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="section-debugging-adding-handler.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="chapter"
><H1
><A
NAME="chapter-debugging"
></A
>Chapter 32. Debugging</H1
><P
>
GStreamer has an extensive set of debugging tools for
plugin developers.
</P
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="section-debugging-command-line"
>32.1. Command line options</A
></H1
><P
>
Applications using the GStreamer libraries accept the following set
of command line argruments to enable the debugging system.
</P
><P
>
<P
></P
><UL
><LI
><P
> <VAR
CLASS="option"
>--gst-debug-mask=<VAR
CLASS="replaceable"
>mask</VAR
></VAR
>
Sets the mask for the debugging output.
</P
></LI
><LI
><P
> <VAR
CLASS="option"
>--gst-info-mask=<VAR
CLASS="replaceable"
>mask</VAR
></VAR
>
Sets the mask for the info output.
</P
></LI
><LI
><P
> <VAR
CLASS="option"
>--gst-mask=<VAR
CLASS="replaceable"
>mask</VAR
></VAR
>
Sets the mask for the info *and* the debug output.
</P
></LI
><LI
><P
> <VAR
CLASS="option"
>--gst-mask-help</VAR
>
Print out the meaning of gst-mask-* values.
</P
></LI
><LI
><P
> <VAR
CLASS="option"
>--gst-plugin-spew</VAR
>
Enable printout of errors while loading GST plugins.
</P
></LI
><LI
><P
> <VAR
CLASS="option"
>--gst-plugin-path=<VAR
CLASS="replaceable"
>PATH</VAR
></VAR
>
Add a directory to the plugin search path.
</P
></LI
><LI
><P
> <VAR
CLASS="option"
>--help</VAR
> Print the a short desciption of the
options
</P
></LI
></UL
>
</P
><P
> The following table gives an overview of the mask values and their meaning. (enabled) means
that the corresponding flag is set by default. This table is available to any GStreamer
application by the --gst-mask-help option.
</P
><PRE
CLASS="programlisting"
> Mask (to be OR'ed) info/debug FLAGS
--------------------------------------------------------
0x00000001 (enabled)/ GST_INIT
0x00000002 / COTHREADS
0x00000004 / COTHREAD_SWITCH
0x00000008 / AUTOPLUG
0x00000010 / AUTOPLUG_ATTEMPT
0x00000020 / PARENTAGE
0x00000040 / STATES
0x00000080 / PLANING
0x00000100 / SCHEDULING
0x00000200 / OPERATION
0x00000400 / BUFFER
0x00000800 / CAPS
0x00001000 / CLOCK
0x00002000 / ELEMENT_PADS
0x00004000 / ELEMENT_FACTORY
0x00008000 / PADS
0x00010000 / PIPELINE
0x00020000 / PLUGIN_LOADING
0x00040000 / PLUGIN_ERRORS
0x00080000 / PLUGIN_INFO
0x00100000 / PROPERTIES
0x00200000 / THREAD
0x00400000 / TYPES
0x00800000 / XML
0x01000000 / NEGOTIATION
0x02000000 / REFCOUNTING
</PRE
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="part-appendices.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="section-debugging-adding-handler.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Appendices</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="part-appendices.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Adding a custom debug handler</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
