gst-std-options.5 revision 11925
f743002678eb67b99bbc29fee116b65d9530fec0wrowe<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
80833bb9a1bf25dcf19e814438a4b311d2e1f4cffuankg<!--ArborText, Inc., 1988-1999, v.4002-->
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic%commonents;
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic%booktitles;
4da61833a1cbbca94094f9653fd970582b97a72etrawick<!ENTITY suncopy "Copyright (c) 2004,2006,2007 Sun Microsystems, Inc. All Rights Reserved.">
4789804be088bcd86ae637a29cdb7fda25169521jailletc<!-- %Z%%M% %I% %E% SMI; -->
4789804be088bcd86ae637a29cdb7fda25169521jailletc<refmeta><refentrytitle>gst-std-options</refentrytitle><manvolnum>5</manvolnum>
e50c3026198fd496f183cda4c32a202925476778covener<refmiscinfo class="software">&release;</refmiscinfo>
e50c3026198fd496f183cda4c32a202925476778covener<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
5b88c8507d5ef6d0c4cfbc78230294968175b638minfrin<indexterm><primary>gst-std-options</primary></indexterm><indexterm><primary>
6c3b9cebb551140fbb25d58bae08b539b3802133ylavicstandard options available for most GStreamer applications</primary></indexterm>
6c3b9cebb551140fbb25d58bae08b539b3802133ylavic<refnamediv id="gst-std-options-5-name"><refname>gst-std-options</refname>
6c3b9cebb551140fbb25d58bae08b539b3802133ylavic<refpurpose>standard options available for most GStreamer applications</refpurpose>
4f29b65ab4b547ad5dbe506e2d0ff5d12ead9247ylavic</refnamediv>
4f29b65ab4b547ad5dbe506e2d0ff5d12ead9247ylavic<refsect1 id="gst-std-options-5-desc"><title>&desc-tt;</title>
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavicGStreamer standard options which are available for most GStreamer
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavicbased applications.
69301145375a889e7e37caf7cc7321ac0f91801erpluem<refsect1 id="gst-std-options-5-opts"><title>&opts-tt;</title>
506bfe33206b2fece40ef25f695af39dd4130facjkaluza<varlistentry>
d58a848a016d401b965111e50ef829e1641f7834minfrinDisplay GStreamer help options.</para>
d58a848a016d401b965111e50ef829e1641f7834minfrin<varlistentry>
2e6f4d654c96c98b761fb012fd25c5d5b1558c44sfDisables debugging.</para>
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic<varlistentry>
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavicPrints a list of available debug categories and their default debugging level.
e8bd80a4bb88199d2f9a24a50345688e52d9c116ylavic<varlistentry>
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic<term><option>-gst-debug-level=<replaceable>level</replaceable></option></term>
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavicSets the threshold for printing debugging messages. A higher level prints
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavicmore messages. The useful range is 0-5, the default value is 0.
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic<varlistentry>
d7205b1a86c51c27b71a2c458dc453fd53a261c1covenerGStreamer normally prints debugging messages so that the messages are
d7205b1a86c51c27b71a2c458dc453fd53a261c1covenercolor-coded when printed to a terminal that handles ANSI escape sequences.
d7205b1a86c51c27b71a2c458dc453fd53a261c1covenerThis option causes GStreamer to print messages without color. Setting
44ff304057225e944e220e981d434a046d14cf06covenerthe GST_DEBUG_NO_COLOR environment variable achieves the same thing.
44ff304057225e944e220e981d434a046d14cf06covener<varlistentry>
5d1ba75b8794925e67591c209085a49279791de9covener<term><option>-gst-debug=<replaceable>string</replaceable></option></term>
5d1ba75b8794925e67591c209085a49279791de9covenerSpecifies debugging levels for each category, where
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand<replaceable>string</replaceable> is a colon-separated list of
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand<replaceable>category_name=level </replaceable> pairs.
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand<replaceable>level</replaceable> is in the range 0-5 where 0 shows no
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrandmessages and 5 shows all messages. The wildcard * can be used to match
caad2986f81ab263f7af41467dd622dc9add17f3ylaviccategory names. Use the <option>-gst-debug-help</option> option to show
caad2986f81ab263f7af41467dd622dc9add17f3ylaviccategory names.
45a10d38e6051fd7bdf9d742aaae633d97ff02abjailletcExample: GST_CAT=5:GST_ELEMENT_*=3
2165214331e4afafca4048f66f303d0253d7b001covener<varlistentry>
a34684a59b60a4173c25035d0c627ef17e6dc215rpluem<term><option>-gst-disable-registry-fork</option></term>
1e2d421a36999d292042a5539971070d54aa6c63ylavicDisable the use of
1e2d421a36999d292042a5539971070d54aa6c63ylavic<citerefentry><refentrytitle>fork</refentrytitle><manvolnum>2</manvolnum></citerefentry>
1e2d421a36999d292042a5539971070d54aa6c63ylavicwhen scanning the registry.
fa7ed98b9dc94c5845cf845aea0a44ecacd290c9humbedooh<varlistentry>
0b67eb8568cd58bb77082703951679b42cf098actrawickDisables trapping of segmentation faults during plugin loading.
fb1985a97912b25ec6564c73e610a31e5fc6e25fcovener<varlistentry>
6502b7b32f980cc2093bb3ebce37e5e4dc68fba4ylavicCauses GStreamer to abort if a warning message occurs.
c1a63b8fad09c419c1a64f75993feb8a343a6801ylavic<varlistentry>
c1a63b8fad09c419c1a64f75993feb8a343a6801ylavic<term><option>-gst-plugin-load=<replaceable>plugins</replaceable></option></term>
e6b4bd1113567627ab6bb6c6a7105e1e01a7d889jailletcPreloads the plugins specified in a comma-separated list. Another way to
e466c40e1801982602ee0200c9e8b61cc148742djailletcspecify plugins to preload is to use the environment variable
e466c40e1801982602ee0200c9e8b61cc148742djailletcGST_PLUGIN_PATH.
04983e3bd1754764eec7d6bb772fe3b0bf391771jorton<option>-gst-plugin-path=<replaceable>path</replaceable></option></term>
15890c9306ba98f6fc243e15a3c4778ddc7d773erpluemAdds directories separated with ':' to the plugin search path.
49dacedb6c387b786b7911082ff35121a45f414bcovener<varlistentry>
cfd9415521847b2f9394fad04fb701cfb955f503rjungGStreamer info flags to set Enable printout of errors while loading GStreamer
28c31fb73c1264bd1d0ff932573677030b024c7dwrowe<varlistentry>
8491e0600f69b0405e156ea8a419653c065c645bcovenerPrints the version string of the GStreamer core library.
49dacedb6c387b786b7911082ff35121a45f414bcovener<refsect1 id="gst-std-options-5-envr"><title>&envr-tt;</title>
49dacedb6c387b786b7911082ff35121a45f414bcovener<para>See <citerefentry><refentrytitle>environ</refentrytitle><manvolnum>
49dacedb6c387b786b7911082ff35121a45f414bcovener5</manvolnum></citerefentry> for descriptions of the following environment
49dacedb6c387b786b7911082ff35121a45f414bcovenervariables:</para>
3c990331fc6702119e4f5b8ba9eae3021aea5265jim<variablelist>
3c990331fc6702119e4f5b8ba9eae3021aea5265jim<varlistentry>
fc42512879dd0504532f52fe5d0d0383dda96a1eniqComma-separated list of debug categories and levels. Values are the same
0451df5dc50fa5d8b3e07d92ee6a92e36a1181a5niq<varlistentry>
983528026996668ea295be95aedb9c7a346af470ylavicWhen this environment variable is set, colored debug output is disabled.
06b8f183140c8e02e0974e938a05078b511d1603covener<varlistentry>
15890c9306ba98f6fc243e15a3c4778ddc7d773erpluemPath of the registry file. Default is <filename>~/.gstreamer-0.10/registry-*.xml</filename>.
259878293a997ff49f5ddfc53d3739cbdc25444ecovener<varlistentry>
b54b024c06a19926832d77d40ba35ad8c41e4d3dminfrinSpecify a list of directories to scan for additional plugins. These
b54b024c06a19926832d77d40ba35ad8c41e4d3dminfrintake precedence over the system plugins.
65967d05f839dbf27cf91d91fa79585eeae19660minfrin<varlistentry>
8152945ae46857b170cb227e79bb799f4fc7710dminfrinSpecifies a list of plugins that are always loaded by default. If not set,
8152945ae46857b170cb227e79bb799f4fc7710dminfrinthis defaults to the system-installed path, and the plugins installed in
8152945ae46857b170cb227e79bb799f4fc7710dminfrinthe user's home directory.
75f5c2db254c0167a0e396254460de09b775d203trawick<varlistentry>
4f0358189bfa57b8e75bd6b94db264302a8f336amrumphUseful liboil environment variable. Set OIL_CPU_FLAGS=0 when debugging tools
4f0358189bfa57b8e75bd6b94db264302a8f336amrumphtrip over liboil's CPU detection.
5716f9c6daa92dde5f2f9d11ed63f7c9549c223atrawick<refsect1 id="gst-std-options-5-file"><title>&file-tt;</title>
54d750a84a175d8e338880514d440773eb986b50covener<para>The following files are used by GStreamer based applications:</para>
54d750a84a175d8e338880514d440773eb986b50covener<term><filename>~/gstreamer-0.10/registry-*.xml</filename></term>
54d750a84a175d8e338880514d440773eb986b50covenerThe XML plugin database. Can be deleted at any time, and it will be
54d750a84a175d8e338880514d440773eb986b50covenerrecreated automatically when it is needed or when the installed plugins
54d750a84a175d8e338880514d440773eb986b50covener<refsect1 id="gst-std-options-5-attr"><title>&attr-tt;</title>
83b50288fa7d306324bba68832011ea08f5c7832covener<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
4e30ef014533a7e93c92d88306291f5e49c9692ftrawick<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
83b50288fa7d306324bba68832011ea08f5c7832covenerfor descriptions of the following attributes:</para>
5f066f496cd9f20a2a701255bc67d44e7cb46daetrawick<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
2e15620d724fb8e3a5be183b917359a2fd6e9468covener<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
1b988c41ee505962781d110a3e4c2c90f1ea0aa4covener<row><entry><para>Availability</para></entry><entry><para>SUNWgnome-media
1b988c41ee505962781d110a3e4c2c90f1ea0aa4covener<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
b8efdc95bec9cf089aa1be0bfd07d46aa1137a7acovenercolname="COLSPEC1"><para>Volatile</para></entry></row>
f06e7c4b1bce6b6491e5de0b7998d3f5696b293dchrisd</informaltable>
f06e7c4b1bce6b6491e5de0b7998d3f5696b293dchrisd<refsect1 id="gst-std-options-5-also"><title>&also-tt;</title>
179565be4043d7e5f9161aa75271fa0a001866d9covener<!--Reference to another man page-->
179565be4043d7e5f9161aa75271fa0a001866d9covener<!--Reference to a Help manual-->
179565be4043d7e5f9161aa75271fa0a001866d9covener<!--Reference to a book.-->
fce4949fb0b309a5744afcd503c6ed2d35621ee2covener<citerefentry><refentrytitle>gst-feedback</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
fce4949fb0b309a5744afcd503c6ed2d35621ee2covener<citerefentry><refentrytitle>gst-inspect</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
fce4949fb0b309a5744afcd503c6ed2d35621ee2covener<citerefentry><refentrytitle>gst-launch</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
fce4949fb0b309a5744afcd503c6ed2d35621ee2covener<citerefentry><refentrytitle>gst-typefind</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
7b7430e701e9a31ce809da7c220bb8dfcf68c86etrawick<citerefentry><refentrytitle>gst-xmlinspect</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
7b7430e701e9a31ce809da7c220bb8dfcf68c86etrawick<citerefentry><refentrytitle>gst-xmllaunch</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
7b7430e701e9a31ce809da7c220bb8dfcf68c86etrawick<citerefentry><refentrytitle>gstreamer-properties</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
ccc20788c1e5fc973f36df634399c89acb70deaejerenkrantz<citerefentry><refentrytitle>libgstreamer-0.10</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
ccc20788c1e5fc973f36df634399c89acb70deaejerenkrantz<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
ccc20788c1e5fc973f36df634399c89acb70deaejerenkrantz<citerefentry><refentrytitle>environ</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
273e512f20f262e5e2aa8e0e83371d1929fb76adjkaluza<citerefentry><refentrytitle>gnome-interfaces</refentrytitle><manvolnum>5</manvolnum></citerefentry>
efe780dcf13b2b95effabf897d694d8f23feac74trawick<refsect1 id="gst-std-options-5-note"><title>¬e-tt;</title>
fe83f60b41477b14a37edcfcd1f7f5c5a1ebfe44minfrin<para>Original man page written by the GStreamer team at http://gstreamer.net/.
fe83f60b41477b14a37edcfcd1f7f5c5a1ebfe44minfrin<para>Updated by Brian Cameron, Sun Microsystems Inc., 2004, 2006, 2007.</para>