common_options.sgml.in revision 67e571de63a8e465dc8f1b17e16744a1d3fb552c
6bdda696b3ea703c47e87fea61017ec655f91d92nd<!--
6bdda696b3ea703c47e87fea61017ec655f91d92nd
6bdda696b3ea703c47e87fea61017ec655f91d92ndlxc: linux Container library
6bdda696b3ea703c47e87fea61017ec655f91d92nd
6bdda696b3ea703c47e87fea61017ec655f91d92nd(C) Copyright IBM Corp. 2007, 2008
6bdda696b3ea703c47e87fea61017ec655f91d92nd
6bdda696b3ea703c47e87fea61017ec655f91d92ndAuthors:
6bdda696b3ea703c47e87fea61017ec655f91d92ndDaniel Lezcano <dlezcano at fr.ibm.com>
6bdda696b3ea703c47e87fea61017ec655f91d92nd
6bdda696b3ea703c47e87fea61017ec655f91d92ndThis library is free software; you can redistribute it and/or
0662ed52e814f8f08ef0e09956413a792584eddffuankgmodify it under the terms of the GNU Lesser General Public
6bdda696b3ea703c47e87fea61017ec655f91d92ndLicense as published by the Free Software Foundation; either
6bdda696b3ea703c47e87fea61017ec655f91d92ndversion 2.1 of the License, or (at your option) any later version.
6bdda696b3ea703c47e87fea61017ec655f91d92nd
6bdda696b3ea703c47e87fea61017ec655f91d92ndThis library is distributed in the hope that it will be useful,
6bdda696b3ea703c47e87fea61017ec655f91d92ndbut WITHOUT ANY WARRANTY; without even the implied warranty of
6bdda696b3ea703c47e87fea61017ec655f91d92ndMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
6bdda696b3ea703c47e87fea61017ec655f91d92ndLesser General Public License for more details.
6bdda696b3ea703c47e87fea61017ec655f91d92nd
6bdda696b3ea703c47e87fea61017ec655f91d92ndYou should have received a copy of the GNU Lesser General Public
16b55a35cff91315d261d1baa776138af465c4e4fuankgLicense along with this library; if not, write to the Free Software
16b55a35cff91315d261d1baa776138af465c4e4fuankgFoundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16b55a35cff91315d261d1baa776138af465c4e4fuankg
6bdda696b3ea703c47e87fea61017ec655f91d92nd-->
6bdda696b3ea703c47e87fea61017ec655f91d92nd
6bdda696b3ea703c47e87fea61017ec655f91d92nd<refsect1>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <title>Common Options</title>
6bdda696b3ea703c47e87fea61017ec655f91d92nd
6bdda696b3ea703c47e87fea61017ec655f91d92nd <para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd These options are common to most of lxc commands.
6bdda696b3ea703c47e87fea61017ec655f91d92nd </para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd
6bdda696b3ea703c47e87fea61017ec655f91d92nd <variablelist>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <varlistentry>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <term><option>-?, -h, --help</option></term>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd Print a longer usage message than normal.
6bdda696b3ea703c47e87fea61017ec655f91d92nd </para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </varlistentry>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <varlistentry>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <term><option>--usage</option></term>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd Give the usage message
6bdda696b3ea703c47e87fea61017ec655f91d92nd </para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </varlistentry>
6bdda696b3ea703c47e87fea61017ec655f91d92nd
6bdda696b3ea703c47e87fea61017ec655f91d92nd <varlistentry>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <term><option>-q, --quiet</option></term>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd mute on
6bdda696b3ea703c47e87fea61017ec655f91d92nd </para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </varlistentry>
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg
6bdda696b3ea703c47e87fea61017ec655f91d92nd <varlistentry>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <term><option>-P, --lxcpath=<replaceable>PATH</replaceable></option></term>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd Use an alternate container path. The default is @LXCPATH@.
6bdda696b3ea703c47e87fea61017ec655f91d92nd </para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </varlistentry>
6bdda696b3ea703c47e87fea61017ec655f91d92nd
6bdda696b3ea703c47e87fea61017ec655f91d92nd <varlistentry>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <term><option>-o, --logfile=<replaceable>FILE</replaceable></option></term>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <para>
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg Output to an alternate log
6bdda696b3ea703c47e87fea61017ec655f91d92nd <replaceable>FILE</replaceable>. The default is no log.
6bdda696b3ea703c47e87fea61017ec655f91d92nd </para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </varlistentry>
6bdda696b3ea703c47e87fea61017ec655f91d92nd
6bdda696b3ea703c47e87fea61017ec655f91d92nd <varlistentry>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <term><option>-l, --logpriority=<replaceable>LEVEL</replaceable></option></term>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd Set log priority to
6bdda696b3ea703c47e87fea61017ec655f91d92nd <replaceable>LEVEL</replaceable>. The default log
6bdda696b3ea703c47e87fea61017ec655f91d92nd priority is <literal>ERROR</literal>. Possible values are :
6bdda696b3ea703c47e87fea61017ec655f91d92nd <literal>FATAL</literal>, <literal>CRIT</literal>,
6bdda696b3ea703c47e87fea61017ec655f91d92nd <literal>WARN</literal>, <literal>ERROR</literal>,
6bdda696b3ea703c47e87fea61017ec655f91d92nd <literal>NOTICE</literal>, <literal>INFO</literal>,
6bdda696b3ea703c47e87fea61017ec655f91d92nd <literal>DEBUG</literal>.
6bdda696b3ea703c47e87fea61017ec655f91d92nd </para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd Note that this option is setting the priority of the events
6bdda696b3ea703c47e87fea61017ec655f91d92nd log in the alternate log file. It do not have effect on the
6bdda696b3ea703c47e87fea61017ec655f91d92nd ERROR events log on stderr.
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg </para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </varlistentry>
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg
6bdda696b3ea703c47e87fea61017ec655f91d92nd <varlistentry>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <term><option>-n, --name=<replaceable>NAME</replaceable></option></term>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd <para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd Use container identifier <replaceable>NAME</replaceable>.
6bdda696b3ea703c47e87fea61017ec655f91d92nd The container identifier format is an alphanumeric string.
6bdda696b3ea703c47e87fea61017ec655f91d92nd </para>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </listitem>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </varlistentry>
6bdda696b3ea703c47e87fea61017ec655f91d92nd </variablelist>
6bdda696b3ea703c47e87fea61017ec655f91d92nd
ac7985784d08a3655291f24f711812b4d8b1cbcffuankg</refsect1>
0662ed52e814f8f08ef0e09956413a792584eddffuankg
6bdda696b3ea703c47e87fea61017ec655f91d92nd<!-- Keep this comment at the end of the file
ac7985784d08a3655291f24f711812b4d8b1cbcffuankgLocal variables:
6bdda696b3ea703c47e87fea61017ec655f91d92ndmode: sgml
6bdda696b3ea703c47e87fea61017ec655f91d92ndsgml-omittag:t
6bdda696b3ea703c47e87fea61017ec655f91d92ndsgml-shorttag:t
6bdda696b3ea703c47e87fea61017ec655f91d92ndsgml-minimize-attributes:nil
6bdda696b3ea703c47e87fea61017ec655f91d92ndsgml-always-quote-attributes:t
6bdda696b3ea703c47e87fea61017ec655f91d92ndsgml-indent-step:2
6bdda696b3ea703c47e87fea61017ec655f91d92ndsgml-indent-data:t
6bdda696b3ea703c47e87fea61017ec655f91d92ndsgml-parent-document:nil
6bdda696b3ea703c47e87fea61017ec655f91d92ndsgml-default-dtd-file:nil
6bdda696b3ea703c47e87fea61017ec655f91d92ndsgml-exposed-tags:nil
0662ed52e814f8f08ef0e09956413a792584eddffuankgsgml-local-catalogs:nil
6bdda696b3ea703c47e87fea61017ec655f91d92ndsgml-local-ecat-files:nil
6bdda696b3ea703c47e87fea61017ec655f91d92ndEnd:
6bdda696b3ea703c47e87fea61017ec655f91d92nd-->
6bdda696b3ea703c47e87fea61017ec655f91d92nd