3 (C) Copyright Canonical Ltd. 2013
6 Stéphane Graber <stgraber@ubuntu.com>
8 This library is free software; you can redistribute it and/or
9 modify it under the terms of the GNU Lesser General Public
10 License as published by the Free Software Foundation; either
11 version 2.1 of the License, or (at your option) any later version.
13 This library is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 Lesser General Public License for more details.
18 You should have received a copy of the GNU Lesser General Public
19 License along with this library; if not, write to the Free Software
20 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24 <!DOCTYPE refentry PUBLIC @docdtd@ [
26 <!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
27 <!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
32 <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
35 <refentrytitle>lxc-info</refentrytitle>
36 <manvolnum>1</manvolnum>
40 <refname>lxc-info</refname>
43 query information about a container
49 <command>lxc-info</command>
50 <arg choice="req">-n <replaceable>name</replaceable></arg>
51 <arg choice="opt">-c <replaceable>KEY</replaceable></arg>
52 <arg choice="opt">-s</arg>
53 <arg choice="opt">-p</arg>
54 <arg choice="opt">-t <replaceable>state</replaceable></arg>
59 <title>Description</title>
61 <command>lxc-info</command> queries and shows information about a
67 <title>Options</title>
72 <option>-n <replaceable>name</replaceable></option>
83 <option><optional>-c <replaceable>KEY</replaceable></optional></option>
87 Print a configuration key from the running container. This option
88 may be given mulitple times to print out multiple key = value pairs.
95 <option><optional>-s</optional></option>
99 Just print the container's state.
106 <option><optional>-p</optional></option>
110 Just print the container's pid.
117 <option><optional>-t <replaceable>state</replaceable></optional></option>
121 Check whether the container is in the provided state.
131 <title>Examples</title>
134 <term>lxc-info -n foo</term>
137 Show information for foo.
143 <term>lxc-info -n foo -t RUNNING</term>
146 exits 0 if foo is RUNNING, 1 otherwise.
152 <term>lxc-info -n foo -c lxc.network.0.veth.pair</term>
155 prints the veth pair name of foo.
166 <title>Author</title>
167 <para>Stéphane Graber <email>stgraber@ubuntu.com</email></para>
171 <!-- Keep this comment at the end of the file
176 sgml-minimize-attributes:nil
177 sgml-always-quote-attributes:t
180 sgml-parent-document:nil
181 sgml-default-dtd-file:nil
182 sgml-exposed-tags:nil
183 sgml-local-catalogs:nil
184 sgml-local-ecat-files:nil