d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanolxc: linux Container library
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano(C) Copyright IBM Corp. 2007, 2008
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoThis library is free software; you can redistribute it and/or
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanomodify it under the terms of the GNU Lesser General Public
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoLicense as published by the Free Software Foundation; either
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoversion 2.1 of the License, or (at your option) any later version.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoThis library is distributed in the hope that it will be useful,
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanobut WITHOUT ANY WARRANTY; without even the implied warranty of
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoLesser General Public License for more details.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoYou should have received a copy of the GNU Lesser General Public
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoLicense along with this library; if not, write to the Free Software
250b1eec71b074acdff1c5f6b5a1f0d7d2c20b77Stéphane GraberFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
7f95145833bb24f54e037f73ecc37444d6635697Dwight Engen<!DOCTYPE refentry PUBLIC @docdtd@ [
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
99e4008cad9e959b683c6f48411fcf15a92be3b5Michel Normand<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <refentrytitle>lxc-ls</refentrytitle>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <manvolnum>1</manvolnum>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <refnamediv>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <refname>lxc-ls</refname>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <refpurpose>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano list the containers existing on the system
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refpurpose>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refnamediv>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <refsynopsisdiv>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <cmdsynopsis>
b4578c5b380130a41a69b5b49c970157acaf1dbbDwight Engen <command>lxc-ls</command>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <arg choice="opt">-1</arg>
b4578c5b380130a41a69b5b49c970157acaf1dbbDwight Engen <arg choice="opt">--active</arg>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <arg choice="opt">--frozen</arg>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <arg choice="opt">--running</arg>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <arg choice="opt">--stopped</arg>
c5afb6e455d9ec00af9f3399836152eaf9d0a4f5Stéphane Graber <arg choice="opt">-f</arg>
c5afb6e455d9ec00af9f3399836152eaf9d0a4f5Stéphane Graber <arg choice="opt">-F <replaceable>format</replaceable></arg>
0f027869da6fe8c448d374eb272b2f394c688937Stéphane Graber <arg choice="opt">-g <replaceable>groups</replaceable></arg>
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner <arg choice="opt">--nesting=<replaceable>NUM</replaceable></arg>
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner <arg choice="opt">--filter=<replaceable>regex</replaceable></arg>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </cmdsynopsis>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refsynopsisdiv>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <title>Description</title>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <command>lxc-ls</command> list the containers existing on the
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refsect1>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <title>Options</title>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <variablelist>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>-1</option>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber Show one entry per line. (default when /dev/stdout isn't a tty)
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber </varlistentry>
7ef0141356454503ab81460290b5dffa32c1f441David Ward <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>--active</option>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber List only active containers (same as --frozen --running).
7ef0141356454503ab81460290b5dffa32c1f441David Ward </varlistentry>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>--frozen</option>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber List only frozen containers.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </varlistentry>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>--running</option>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber List only running containers.
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber </varlistentry>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>--stopped</option>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber List only stopped containers.
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber </varlistentry>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <varlistentry>
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner <option>-f,--fancy</option>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber Use a fancy, column-based output.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </varlistentry>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <varlistentry>
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner <option>-F,--fancy-format <replaceable>format</replaceable></option>
e5a8e4e15b7da892884cb62d17c181c6e18f1d4bEvgeni Golov Comma separated list of columns to show in the fancy output.
860490af5db945c37e9e6e24c019899fbe739dc5Stéphane Graber The list of accepted and default fields is listed in --help.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </varlistentry>
0f027869da6fe8c448d374eb272b2f394c688937Stéphane Graber <varlistentry>
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner <option>-g,--groups <replaceable>groups</replaceable></option>
0f027869da6fe8c448d374eb272b2f394c688937Stéphane Graber Comma separated list of groups the container must have to be displayed.
0f027869da6fe8c448d374eb272b2f394c688937Stéphane Graber The parameter may be passed multiple times.
0f027869da6fe8c448d374eb272b2f394c688937Stéphane Graber </varlistentry>
0e21ea4b15b1f1a066da54aed04f4fcac45d5741Stéphane Graber <varlistentry>
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner <option>--nesting=<replaceable>NUM</replaceable></option>
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner Show nested containers. The number of nesting levels to be shown can
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner be specified by passing a number as argument.
0e21ea4b15b1f1a066da54aed04f4fcac45d5741Stéphane Graber </varlistentry>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <varlistentry>
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner <option>--filter=<replaceable>regex</replaceable></option>
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner The regular expression passed to <command>lxc-ls</command> will be
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner applied to the container name. The format is a POSIX extended
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner regular expression. It can also be given as additional argument
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner without explicitly using <option>--filter</option>.
2cf7c05abee6116ffb41acffbcd033b880bfd3b1KATOH Yasufumi </varlistentry>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </variablelist>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refsect1>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <title>Examples</title>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <variablelist>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <varlistentry>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <term>lxc-ls --fancy</term>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber list all the containers, listing one per line along with its
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber name, state, ipv4 and ipv6 addresses.
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber </varlistentry>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <varlistentry>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber <term>lxc-ls --active -1</term>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber list active containers and display the list in one column.
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber </varlistentry>
4e7186c53554cdbf4b4b85568daf84740c120505Stéphane Graber </variablelist>
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner &commonoptions;
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner <title>History</title>
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner Written originally as a shell script by Daniel Lezcano and Serge Hallyn.
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner Later reimplemented and extended in Python by Stéphane Graber and then
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner reimplemented and extended in C by Christian Brauner.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <title>Author</title>
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner <para>Christian Brauner <email>christian.brauner@mailbox.org</email>,
37cf83ea151d58a60d05930acb683739dec73ca2Christian Brauner Stéphane Graber <email>stgraber@ubuntu.com</email></para>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refsect1>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano<!-- Keep this comment at the end of the file
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoLocal variables:
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-omittag:t
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-shorttag:t
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-minimize-attributes:nil
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-always-quote-attributes:t
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-indent-step:2
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-indent-data:t
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-parent-document:nil
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-default-dtd-file:nil
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-exposed-tags:nil
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-local-catalogs:nil
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-local-ecat-files:nil