CGGET(1)                                 libcgroup Manual                                CGGET(1)



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 speci‐
       fied, the values of all possible variables are displayed.


       <path> is the name of the cgroup which should be read.  This parameter can be used  multi‐
              ple 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 mul‐
              tiple 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.


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




Linux                                       2010-01-18                                   CGGET(1)