1CGXGET(1)                      libcgroup Manual                      CGXGET(1)
2
3
4

NAME

6       cgxget - print parameter(s) of given group(s)
7
8

SYNOPSIS

10       cgxget  [-1]  [-2]  [-i]  [-n]  [-v] [-r <name>] [-g <controller>] [-a]
11       <path> ...
12       cgxget [-1] [-2] [-i] [-n] [-v] [-r <name>] -g <controller>:<path> ...
13
14

DESCRIPTION

16       Prints the parameter(s) of input cgroup(s).  If neither controller  nor
17       variable  are  specified, the values of all possible variables are dis‐
18       played.  When the request's cgroup version differs  from  the  system's
19       cgroup  version,  cgxget  will attempt to translate from one version to
20       the other.  If the request version and the  system's  version  are  the
21       same,  no translation is done and cgxget will behave like cgget.  If no
22       version is specified by the user (either [-1] or [-2]), the behavior is
23       undefined.
24
25
26       <path> is  the name of the cgroup which should be read.  This parameter
27              can be used multiple times.
28
29
30       -1, --v1
31              data in/out of cgxget is in cgroup v1 format.  In this mode, the
32              user  will provide values in cgroup v1 format and receive values
33              in v1 format.  format.  If the system is running  in  cgroup  v2
34              mode, libcgroup will convert the data as necessary
35
36
37       -2, --v2
38              data in/out of cgxget is in cgroup v2 format.  In this mode, the
39              user will provide values in cgroup v2 format and receive  values
40              in v2 format.  If the system is running in cgroup v1 mode, libc‐
41              group will convert the data as necessary
42
43
44       -a, --all
45              print the variables for all controllers  which  consist  in  the
46              given cgroup
47
48
49       -g <controller>
50              defines  controllers whose values should be displayed.  This op‐
51              tion can be used multiple times.
52
53
54       -g <controller>:<path>
55              defines control groups whose values should be  displayed.   This
56              option can be used multiple times.
57
58
59       -h, --help
60              display help and exit
61
62
63       -i, --ignore-unmappable
64              ignore  errors for values that cannot be converted from v1 to v2
65              or vice versa
66
67
68       -n     do not print headers, i.e. names of groups.
69
70
71       -r, --variable <name>
72              defines parameter to display.  This option can be used  multiple
73              times.
74
75
76
77       -v, --values-only
78              print only values, not parameter names.
79
80

EXAMPLES

82       $ cgxget -1 -r cpuset.cpus -r cpuset.mems first second
83       first:
84       cpuset.cpus=0-1
85       cpuset.mems=0
86
87       second:
88       cpuset.cpus=0
89       cpuset.mems=0
90
91       $ cgxget -1 -n -r cpuset.cpus -r cpuset.mems first second
92       cpuset.cpus=0-1
93       cpuset.mems=0
94       cpuset.cpus=0
95       cpuset.mems=0
96
97       $ cgxget -1 -nv -r cpuset.cpus -r cpuset.mems first second
98       0-1
99       0
100       0
101       0
102
103       $ cgxget -1 -n -g cpu /
104       cpu.rt_period_us=1000000
105       cpu.rt_runtime_us=950000
106       cpu.shares=1024
107
108       $ cgxget -2 -r cpu.max first
109       first:
110       cpu.max: max 100000
111
112
113

ENVIRONMENT VARIABLES

115       CGROUP_LOGLEVEL
116              controls  verbosity of the tool. Allowed values are DEBUG, INFO,
117              WARNING or ERROR.
118
119

AUTHOR

121       Tom Hromatka <tom.hromatka@oracle.com>
122
123

SEE ALSO

125       cgrules.conf (1), cgcreate (1), cgget (1), cgset (1), cgxset (1)
126
127
128
129Linux                             2022-08-03                         CGXGET(1)