.\" Copyright (C) 2010 Red Hat, Inc. All Rights Reserved.
.\" Written by Jan Safranek <jsafrane@redhat.com>

.TH CGGET  1 2010-01-18 "Linux" "libcgroup Manual"
.SH NAME

cgget \- print parameter(s) of given group(s)

.SH SYNOPSIS
\fBcgget\fR [\fB\-n\fR] [\fB\-v\fR] [\fB\-r\fR <\fIname\fR>]
[\fB\-g\fR <\fIcontroller\fR>] [\fB\-a\fR] <\fBpath\fR> ...
.br
\fBcgget\fR [\fB\-n\fR] [\fB\-v\fR] [\fB\-r\fR <\fIname\fR>]
\fB\-g\fR <\fIcontroller\fR>:<\fBpath\fR> ...

.SH DESCRIPTION
Prints the parameter(s) of input cgroup(s).
If neither controller nor variable are specified,
the values of all possible variables are displayed.

.TP
.B <path>
is the name of the cgroup which should be read.
This parameter can be used multiple times.

.TP
.B \-a, \-\-all
print the variables for all controllers which consist in the  given cgroup

.TP
.B \-g <controller>
defines controllers whose values should be displayed.
This option can be used multiple times.

.TP
.B \-g <controller>:<path>
defines control groups whose values should be displayed.
This option can be used multiple times.

.TP
.B \-h, \-\-help
display help and exit

.TP
.B \-n
do not print headers, i.e. names of groups.

.TP
.B \-r, \-\-variable <name>
defines parameter to display.
This option can be used multiple times.


.TP
.B \-v, \-\-values-only
print only values, not parameter names.

.SH EXAMPLES
.nf
$ cgget \-r cpuset.cpus \-r cpuset.mems first second
first:
cpuset.cpus=0-1
cpuset.mems=0

second:
cpuset.cpus=0
cpuset.mems=0

$ cgget \-n \-r cpuset.cpus \-r cpuset.mems first second
cpuset.cpus=0-1
cpuset.mems=0
cpuset.cpus=0
cpuset.mems=0

$ cgget \-nv \-r cpuset.cpus \-r cpuset.mems first second
0-1
0
0
0

$ cgget \-n \-g cpu /
cpu.rt_period_us=1000000
cpu.rt_runtime_us=950000
cpu.shares=1024

.fi

.SH ENVIRONMENT VARIABLES
.TP
.B CGROUP_LOGLEVEL
controls verbosity of the tool. Allowed values are \fBDEBUG\fR,
\fBINFO\fR, \fBWARNING\fR or \fBERROR\fR.

.SH SEE ALSO
cgrules.conf (1), cgcreate (1), cgget (1)