<!DOCTYPE refentry PUBLIC @docdtd@ [
+<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
]>
<arg choice="opt">--frozen</arg>
<arg choice="opt">--running</arg>
<arg choice="opt">--stopped</arg>
+ <arg choice="opt">--defined</arg>
<arg choice="opt">-f</arg>
<arg choice="opt">-F <replaceable>format</replaceable></arg>
- <arg choice="opt">--nesting</arg>
- <arg choice="opt">filter</arg>
+ <arg choice="opt">-g <replaceable>groups</replaceable></arg>
+ <arg choice="opt">--nesting=<replaceable>NUM</replaceable></arg>
+ <arg choice="opt">--filter=<replaceable>regex</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<variablelist>
<varlistentry>
<term>
- <option><optional>-1</optional></option>
+ <option>-1</option>
</term>
<listitem>
<para>
<varlistentry>
<term>
- <option><optional>--active</optional></option>
+ <option>--active</option>
</term>
<listitem>
<para>
<varlistentry>
<term>
- <option><optional>--frozen</optional></option>
+ <option>--frozen</option>
</term>
<listitem>
<para>
<varlistentry>
<term>
- <option><optional>--running</optional></option>
+ <option>--running</option>
</term>
<listitem>
<para>
<varlistentry>
<term>
- <option><optional>--stopped</optional></option>
+ <option>--stopped</option>
</term>
<listitem>
<para>
<varlistentry>
<term>
- <option><optional>-f, --fancy</optional></option>
+ <option>--defined</option>
+ </term>
+ <listitem>
+ <para>
+ List only defined containers.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
+ <option>-f,--fancy</option>
</term>
<listitem>
<para>
<varlistentry>
<term>
- <option><optional>-F, --fancy-format <replaceable>format</replaceable></optional></option>
+ <option>-F,--fancy-format <replaceable>format</replaceable></option>
</term>
<listitem>
<para>
- Comma separate list of column to show in the fancy output.
+ Comma separated list of columns to show in the fancy output.
The list of accepted and default fields is listed in --help.
</para>
</listitem>
<varlistentry>
<term>
- <option><optional>--nesting</optional></option>
+ <option>-g,--groups <replaceable>groups</replaceable></option>
</term>
<listitem>
<para>
- Show nested containers.
+ Comma separated list of groups the container must have to be displayed.
+ The parameter may be passed multiple times.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
- <option><optional>filter</optional></option>
+ <option>--nesting=<replaceable>NUM</replaceable></option>
</term>
<listitem>
<para>
- The filter passed to <command>lxc-ls</command> will be
- applied to the container name. The format is a regular expression.
+ Show nested containers. The number of nesting levels to be shown can
+ be specified by passing a number as argument.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
+ <option>--filter=<replaceable>regex</replaceable></option>
+ </term>
+ <listitem>
+ <para>
+ The regular expression passed to <command>lxc-ls</command> will be
+ applied to the container name. The format is a POSIX extended
+ regular expression. It can also be given as additional argument
+ without explicitly using <option>--filter</option>.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
+ &commonoptions;
+
&seealso;
+ <refsect1>
+ <title>History</title>
+ Written originally as a shell script by Daniel Lezcano and Serge Hallyn.
+ Later reimplemented and extended in Python by Stéphane Graber and then
+ reimplemented and extended in C by Christian Brauner.
+ </refsect1>
+
<refsect1>
<title>Author</title>
- <para>Stéphane Graber <email>stgraber@ubuntu.com</email></para>
+ <para>Christian Brauner <email>christian.brauner@mailbox.org</email>,
+ Stéphane Graber <email>stgraber@ubuntu.com</email></para>
</refsect1>
+
</refentry>
<!-- Keep this comment at the end of the file