4 lxc: linux Container library
6 (C) Copyright IBM Corp. 2007, 2008
9 Daniel Lezcano <daniel.lezcano at free.fr>
11 This library is free software; you can redistribute it and/or
12 modify it under the terms of the GNU Lesser General Public
13 License as published by the Free Software Foundation; either
14 version 2.1 of the License, or (at your option) any later version.
16 This library is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 Lesser General Public License for more details.
21 You should have received a copy of the GNU Lesser General Public
22 License along with this library; if not, write to the Free Software
23 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
27 <!DOCTYPE refentry PUBLIC @docdtd@ [
29 <!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
34 <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
37 <refentrytitle>lxc-ps</refentrytitle>
38 <manvolnum>1</manvolnum>
42 <refname>lxc-ps</refname>
45 list the processes belonging to a specific container.
51 <command>lxc-ps</command>
52 <arg choice="opt">--name <replaceable>name</replaceable></arg>
53 <arg choice="opt">--lxc</arg>
54 <arg choice="opt">--host</arg>
55 <arg choice="opt">-- <replaceable>ps options</replaceable></arg>
60 <title>Description</title>
62 <command>lxc-ps</command> is a wrapper to the ps command
63 to report the name of lxc container associated
64 to reported processes.
67 The cgroup fs must be mounted before container creation,
68 to be able to have <command>lxc-ps</command> to find
69 the container associated to processes.
72 The additional specified <replaceable>ps options</replaceable> must not
73 remove the default ps header and the pid information,
74 to be able to have the <command>lxc-ps</command> to find
75 the container associated to processes.
80 <title>Options</title>
85 <option>-n, --name <replaceable>name</replaceable></option>
89 specify the container <replaceable>name</replaceable>
90 to limit the output to the processes belonging
91 to this container name.
98 <option>--lxc</option>
102 limit the output to the processes belonging
103 to all lxc containers.
110 <option>--host</option>
114 limit the output to the processes belonging
122 <option><optional><replaceable>ps options</replaceable></optional></option>
126 The <command>ps</command> options must be separated
127 from <command>lxc-ps</command> options by
128 the <option>--</option> parameter.
138 <title>Example</title>
141 <term>lxc-ps --name foo -- --forest</term>
144 list all the processes belonging to container 'foo' and show
153 <title>See Also</title>
157 <refentrytitle>ps</refentrytitle>
158 <manvolnum>1</manvolnum>
167 <title>Author</title>
168 <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
173 <!-- Keep this comment at the end of the file
178 sgml-minimize-attributes:nil
179 sgml-always-quote-attributes:t
182 sgml-parent-document:nil
183 sgml-default-dtd-file:nil
184 sgml-exposed-tags:nil
185 sgml-local-catalogs:nil
186 sgml-local-ecat-files:nil