10139N/A<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
10139N/A<!--ArborText, Inc., 1988-1999, v.4002-->
15941N/A<!--ARC : LSARC 2005/734 GNOME For Nevada -->
10139N/A<!ENTITY cmd "gst-std-options">
10139N/A<!ENTITY % commonents SYSTEM "smancommon.ent">
10139N/A%commonents;
10139N/A<!ENTITY % booktitles SYSTEM "booktitles.ent">
10139N/A%booktitles;
11913N/A<!ENTITY suncopy "Copyright (c) 2004,2006,2007 Sun Microsystems, Inc. All Rights Reserved.">
10139N/A]>
10139N/A<?Pub UDT _bookmark _target>
10139N/A<?Pub Inc>
10139N/A<refentry id="gst-std-options-5">
10139N/A<!-- %Z%%M% %I% %E% SMI; -->
10139N/A<refmeta><refentrytitle>gst-std-options</refentrytitle><manvolnum>5</manvolnum>
11913N/A<refmiscinfo class="date">12 Nov 2007</refmiscinfo>
10139N/A<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
11904N/A<refmiscinfo class="software">&release;</refmiscinfo>
10139N/A<refmiscinfo class="arch">generic</refmiscinfo>
10139N/A<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
10139N/A</refmeta>
10139N/A<indexterm><primary>gst-std-options</primary></indexterm><indexterm><primary>
10139N/Astandard options available for most GStreamer applications</primary></indexterm>
10139N/A<refnamediv id="gst-std-options-5-name"><refname>gst-std-options</refname>
10139N/A<refpurpose>standard options available for most GStreamer applications</refpurpose>
10139N/A</refnamediv>
10139N/A<refsect1 id="gst-std-options-5-desc"><title>&desc-tt;</title>
11913N/A<para>
11913N/AGStreamer standard options which are available for most GStreamer
11913N/Abased applications.
11913N/A</para>
10139N/A</refsect1>
10139N/A<refsect1 id="gst-std-options-5-opts"><title>&opts-tt;</title>
10139N/A<para>The following options are supported:</para>
10139N/A<variablelist termlength="wholeline">
11913N/A<varlistentry>
11913N/A<term><option>-help-gst</option></term>
11913N/A<listitem><para>
11913N/ADisplay GStreamer help options.</para>
11913N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term><option>-gst-debug-disable</option></term>
11913N/A<listitem><para>
10139N/ADisables debugging.</para>
10139N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term><option>-gst-debug-help</option></term>
11913N/A<listitem><para>
10139N/APrints a list of available debug categories and their default debugging level.
10139N/A</para>
10139N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term><option>-gst-debug-level=<replaceable>level</replaceable></option></term>
11913N/A<listitem><para>
11913N/ASets the threshold for printing debugging messages. A higher level prints
11913N/Amore messages. The useful range is 0-5, the default value is 0.
11913N/A</para>
10139N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term><option>-gst-debug-no-color</option></term>
11913N/A<listitem><para>
11913N/AGStreamer normally prints debugging messages so that the messages are
10139N/Acolor-coded when printed to a terminal that handles ANSI escape sequences.
11913N/AThis option causes GStreamer to print messages without color. Setting
11913N/Athe GST_DEBUG_NO_COLOR environment variable achieves the same thing.
11913N/A</para>
11913N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term><option>-gst-debug=<replaceable>string</replaceable></option></term>
11913N/A<listitem><para>
11913N/ASpecifies debugging levels for each category, where
11913N/A<replaceable>string</replaceable> is a colon-separated list of
11913N/A<replaceable>category_name=level </replaceable> pairs.
11913N/A<replaceable>level</replaceable> is in the range 0-5 where 0 shows no
11913N/Amessages and 5 shows all messages. The wildcard * can be used to match
11913N/Acategory names. Use the <option>-gst-debug-help</option> option to show
11913N/Acategory names.
11913N/A</para>
11913N/A<para>
11913N/AExample: GST_CAT=5:GST_ELEMENT_*=3
11913N/A</para>
10139N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term><option>-gst-disable-registry-fork</option></term>
11913N/A<listitem><para>
11913N/ADisable the use of
11913N/A<citerefentry><refentrytitle>fork</refentrytitle><manvolnum>2</manvolnum></citerefentry>
11913N/Awhen scanning the registry.
11913N/A</para>
11913N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term><option>-gst-disable-segtrap</option></term>
11913N/A<listitem><para>
11913N/ADisables trapping of segmentation faults during plugin loading.
11913N/A</para>
10139N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term><option>-gst-fatal-warnings</option></term>
11913N/A<listitem><para>
11913N/ACauses GStreamer to abort if a warning message occurs.
11913N/A</para>
10139N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term><option>-gst-plugin-load=<replaceable>plugins</replaceable></option></term>
11913N/A<listitem><para>
11913N/APreloads the plugins specified in a comma-separated list. Another way to
11913N/Aspecify plugins to preload is to use the environment variable
11913N/AGST_PLUGIN_PATH.
11913N/A</para>
10139N/A</listitem></varlistentry>
11913N/A<varlistentry><term>
11913N/A<option>-gst-plugin-path=<replaceable>path</replaceable></option></term>
11913N/A<listitem><para>
11913N/AAdds directories separated with ':' to the plugin search path.
10139N/A</para>
10139N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term><option>-gst-plugin-spew</option></term>
11913N/A<listitem><para>
10139N/AGStreamer info flags to set Enable printout of errors while loading GStreamer
11913N/Aplugins.
11913N/A</para>
11913N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term><option>-gst-version</option></term>
11913N/A<listitem><para>
11913N/APrints the version string of the GStreamer core library.
11913N/A</para>
11913N/A</listitem></varlistentry>
11913N/A</variablelist></refsect1>
11913N/A<refsect1 id="gst-std-options-5-envr"><title>&envr-tt;</title>
11913N/A<para>See <citerefentry><refentrytitle>environ</refentrytitle><manvolnum>
11913N/A5</manvolnum></citerefentry> for descriptions of the following environment
11913N/Avariables:</para>
11913N/A<variablelist>
11913N/A<varlistentry>
11913N/A<term>GST_DEBUG</term>
11913N/A<listitem><para>
11913N/AComma-separated list of debug categories and levels. Values are the same
11913N/Aas used with the <option>-gst-debug</option> argument.
11913N/A</para>
11913N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term>GST_DEBUG_NO_COLOR</term>
11913N/A<listitem><para>
11913N/AWhen this environment variable is set, colored debug output is disabled.
11913N/A</para>
10139N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term>GST_REGISTRY</term>
11913N/A<listitem><para>
11913N/APath of the registry file. Default is <filename>~/.gstreamer-0.10/registry-*.xml</filename>.
11913N/A</para>
11913N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term>GST_PLUGIN_PATH</term>
11913N/A<listitem><para>
11913N/ASpecify a list of directories to scan for additional plugins. These
11913N/Atake precedence over the system plugins.
11913N/A</para>
11913N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term>GST_PLUGIN_SYSTEM_PATH</term>
11913N/A<listitem><para>
11913N/ASpecifies a list of plugins that are always loaded by default. If not set,
11913N/Athis defaults to the system-installed path, and the plugins installed in
11913N/Athe user's home directory.
11913N/A</para>
11913N/A</listitem></varlistentry>
11913N/A<varlistentry>
11913N/A<term>OIL_CPU_FLAGS</term>
11913N/A<listitem><para>
11913N/AUseful liboil environment variable. Set OIL_CPU_FLAGS=0 when debugging tools
11913N/Atrip over liboil's CPU detection.
11913N/A</para>
11913N/A</listitem></varlistentry>
11913N/A</variablelist></refsect1>
11913N/A<refsect1 id="gst-std-options-5-file"><title>&file-tt;</title>
11913N/A<para>The following files are used by GStreamer based applications:</para>
16402N/A<variablelist termlength="wholeline">
16402N/A<varlistentry>
16402N/A<term><filename>/usr/lib/gstreamer-0.10/</filename></term>
16402N/A<listitem><para>
16402N/AGStreamer system plugin directory.
16402N/A</para></listitem></varlistentry>
16402N/A
16402N/A<varlistentry>
16402N/A<term><filename>~/gstreamer-0.10/plugins</filename></term>
16402N/A<listitem><para>
16402N/AGStreamer user-specific plugin directory.
16402N/A</para></listitem></varlistentry>
16402N/A
16402N/A<varlistentry>
11913N/A<term><filename>~/gstreamer-0.10/registry-*.xml</filename></term>
11913N/A<listitem><para>
16402N/AGStreamer plugin registry for user.
16402N/A</para></listitem></varlistentry>
10139N/A</variablelist></refsect1>
10139N/A<refsect1 id="gst-std-options-5-attr"><title>&attr-tt;</title>
10139N/A<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
10139N/A<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
10139N/Afor descriptions of the following attributes:</para>
10139N/A<informaltable frame="all">
10139N/A<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
10139N/A<colspec colname="COLSPEC1" colwidth="1*">
10139N/A<thead>
10139N/A<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
10139N/Avalign="middle">ATTRIBUTE VALUE</entry></row>
10139N/A</thead>
10139N/A<tbody>
18745N/A<row><entry><para>Availability</para></entry><entry><para>library/audio/gstreamer
10139N/A</para></entry></row>
10139N/A<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
10139N/Acolname="COLSPEC1"><para>Volatile</para></entry></row>
10139N/A</tbody>
10139N/A</tgroup>
10139N/A</informaltable>
10139N/A</refsect1>
10139N/A<refsect1 id="gst-std-options-5-also"><title>&also-tt;</title>
10139N/A<!--Reference to another man page-->
10139N/A<!--Reference to a Help manual-->
10139N/A<!--Reference to a book.-->
10139N/A<para>
10139N/A<citerefentry><refentrytitle>gst-feedback</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>gst-inspect</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>gst-launch</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>gst-typefind</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>gst-xmlinspect</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>gst-xmllaunch</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>gstreamer-properties</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
11913N/A<citerefentry><refentrytitle>libgstreamer-0.10</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
11913N/A<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
11913N/A<citerefentry><refentrytitle>environ</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
11913N/A<citerefentry><refentrytitle>gnome-interfaces</refentrytitle><manvolnum>5</manvolnum></citerefentry>
10139N/A</para>
10139N/A</refsect1>
10139N/A<refsect1 id="gst-std-options-5-note"><title>&note-tt;</title>
11933N/A<para>Original man page written by the GStreamer team at
11933N/A<literal>http://gstreamer.net/</literal>.
10139N/A</para>
11913N/A<para>Updated by Brian Cameron, Sun Microsystems Inc., 2004, 2006, 2007.</para>
10139N/A</refsect1>
10139N/A</refentry>