libcgroup/libcgroup-0.41/doc/man/cgget.1
2014-02-05 16:04:04 +01:00

97 lines
1.9 KiB
Groff

.\" 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)