CGGET

Section: libcgroup Manual (1)
Updated: 2010-01-18
Page Index

NAME

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

SYNOPSIS

cgget [-n] [-v] [-r <name>] [-g <controller>] [-a] <path> ...
cgget [-n] [-v] [-r <name>] -g <controller>:<path> ...

DESCRIPTION

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

<path>

is the name of the cgroup which should be read. This parameter can be used multiple times.

-a, --all

print the variables for all controllers which consist in the given cgroup

-g <controller>

defines controllers whose values should be displayed. This option can be used multiple times.

-g <controller>:<path>

defines control groups whose values should be displayed. This option can be used multiple times.

-h, --help

display help and exit

-n

do not print headers, i.e. names of groups.

-r, --variable <name>

defines parameter to display. This option can be used multiple times.

-v, --values-only

print only values, not parameter names.

EXAMPLES

$ 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

ENVIRONMENT VARIABLES

CGROUP_LOGLEVEL: controls verbosity of the tool. Allowed values are DEBUG, INFO, WARNING or ERROR.