3 lxc: linux Container library
5 (C) Copyright IBM Corp. 2007, 2008
8 Daniel Lezcano <daniel.lezcano at free.fr>
10 This library is free software; you can redistribute it and/or
11 modify it under the terms of the GNU Lesser General Public
12 License as published by the Free Software Foundation; either
13 version 2.1 of the License, or (at your option) any later version.
15 This library is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 Lesser General Public License for more details.
20 You should have received a copy of the GNU Lesser General Public
21 License along with this library; if not, write to the Free Software
22 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
26 <!DOCTYPE refentry PUBLIC @docdtd@ [
28 <!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
29 <!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
34 <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
37 <refentrytitle>lxc-cgroup</refentrytitle>
38 <manvolnum>1</manvolnum>
42 <refname>lxc-cgroup</refname>
45 manage the control group associated with a container
51 <command>lxc-cgroup</command>
52 <arg choice="req">-n <replaceable>name</replaceable></arg>
53 <arg choice="req"><replaceable>state-object</replaceable></arg>
54 <arg choice="opt">value</arg>
59 <title>Description</title>
62 <command>lxc-cgroup</command> gets or sets the value of a
63 <replaceable>state-object</replaceable> (e.g., 'cpuset.cpus')
64 in the container's cgroup for the corresponding subsystem (e.g.,
65 'cpuset'). If no <optional>value</optional> is specified, the
66 current value of the <replaceable>state-object</replaceable> is
67 displayed; otherwise it is set.
71 Note that <command>lxc-cgroup</command> does not check that the
72 <replaceable>state-object</replaceable> is valid for the running
73 kernel, or that the corresponding subsystem is contained in any
74 mounted cgroup hierarchy.
79 <title>Options</title>
84 <option><replaceable>state-object</replaceable></option>
88 Specify the state object name.
95 <option><optional>value</optional></option>
99 Specify the value to assign to the state object.
111 <title>Examples</title>
114 <term>lxc-cgroup -n foo devices.list</term>
117 display the allowed devices to be used.
123 <term>lxc-cgroup -n foo cpuset.cpus "0,3"</term>
126 assign the processors 0 and 3 to the container.
135 <title>Diagnostic</title>
140 <term>The container was not found</term>
143 The container is not running.
156 <title>Author</title>
157 <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
162 <!-- Keep this comment at the end of the file
167 sgml-minimize-attributes:nil
168 sgml-always-quote-attributes:t
171 sgml-parent-document:nil
172 sgml-default-dtd-file:nil
173 sgml-exposed-tags:nil
174 sgml-local-catalogs:nil
175 sgml-local-ecat-files:nil