.\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH lxc-cgroup 1 2024-09-16 "" ""
.SH NAME
lxc-cgroup \- manage the control group associated with a container 
.SH SYNOPSIS
'nh
.fi
.ad l
\fBlxc-cgroup\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
{-n \fIname\fR} {\fIstate-object\fR} [value]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBlxc-cgroup\fR gets or sets the value of a
\fIstate-object\fR (e.g., 'cpuset.cpus')
in the container's cgroup for the corresponding subsystem (e.g.,
\&'cpuset'). If no [value] is specified, the
current value of the \fIstate-object\fR is
displayed; otherwise it is set.
.PP
Note that \fBlxc-cgroup\fR does not check that the
\fIstate-object\fR is valid for the running
kernel, or that the corresponding subsystem is contained in any
mounted cgroup hierarchy.
.SH OPTIONS
.TP 
\fIstate-object\fR 
Specify the state object name.
.TP 
\*(T<\fB[value]\fR\*(T> 
Specify the value to assign to the state object.
.SH "COMMON OPTIONS"
These options are common to most of lxc commands.
.TP 
\*(T<\fB\-?, \-h, \-\-help\fR\*(T>
Print a longer usage message than normal.
.TP 
\*(T<\fB\-\-usage\fR\*(T>
Give the usage message
.TP 
\*(T<\fB\-q, \-\-quiet\fR\*(T>
mute on
.TP 
\*(T<\fB\-P, \-\-lxcpath=\fR\*(T>\fIPATH\fR
Use an alternate container path. The default is /var/lib/lxc.
.TP 
\*(T<\fB\-o, \-\-logfile=\fR\*(T>\fIFILE\fR
Output to an alternate log
\fIFILE\fR. The default is no log.
.TP 
\*(T<\fB\-l, \-\-logpriority=\fR\*(T>\fILEVEL\fR
Set log priority to
\fILEVEL\fR. The default log
priority is \*(T<ERROR\*(T>. Possible values are :
\*(T<FATAL\*(T>, \*(T<ALERT\*(T>,
\*(T<CRIT\*(T>,
\*(T<WARN\*(T>, \*(T<ERROR\*(T>,
\*(T<NOTICE\*(T>, \*(T<INFO\*(T>,
\*(T<DEBUG\*(T>, \*(T<TRACE\*(T>.

Note that this option is setting the priority of the events
log in the alternate log file. It do not have effect on the
ERROR events log on stderr.
.TP 
\*(T<\fB\-n, \-\-name=\fR\*(T>\fINAME\fR
Use container identifier \fINAME\fR.
The container identifier format is an alphanumeric string.
.TP 
\*(T<\fB\-\-rcfile=\fR\*(T>\fIFILE\fR
Specify the configuration file to configure the virtualization
and isolation functionalities for the container.

This configuration file if present will be used even if there is
already a configuration file present in the previously created
container (via lxc-create).
.TP 
\*(T<\fB\-\-version\fR\*(T>
Show the version number.
.SH EXAMPLES
.TP 
lxc-cgroup -n foo devices.list
display the allowed devices to be used.
.TP 
lxc-cgroup -n foo cpuset.cpus "0,3"
assign the processors 0 and 3 to the container.
.SH DIAGNOSTIC
.TP 
The container was not found
The container is not running.
.SH "SEE ALSO"
\fBlxc\fR(7),
\fBlxc-create\fR(1),
\fBlxc-copy\fR(1),
\fBlxc-destroy\fR(1),
\fBlxc-start\fR(1),
\fBlxc-stop\fR(1),
\fBlxc-execute\fR(1),
\fBlxc-console\fR(1),
\fBlxc-monitor\fR(1),
\fBlxc-wait\fR(1),
\fBlxc-cgroup\fR(1),
\fBlxc-ls\fR(1),
\fBlxc-info\fR(1),
\fBlxc-freeze\fR(1),
\fBlxc-unfreeze\fR(1),
\fBlxc-attach\fR(1),
\fBlxc.conf\fR(5)