1
2CGCREATE(1)                    libcgroup Manual                    CGCREATE(1)
3
4
5

NAME

7       cgcreate - create new cgroup(s)
8
9

SYNOPSIS

11       cgcreate [-h] [-t <tuid>:<tgid>] [-a <agid>:<auid>] [-f mode] [-d mode]
12       [-s mode] -g <controllers>:<path> [-g ...]
13
14

DESCRIPTION

16       The command creates new cgroup(s) defined by the options -g.
17
18
19       -a <agid>:<auid>
20              defines the name of the user and the group which own the rest of
21              the  defined  control  group’s files. These users are allowed to
22              set subsystem parameters  and  create  subgroups.   The  default
23              value is the same as has the parent cgroup.
24
25
26       -d, --dperm=mode
27              sets the permissions of a control groups directory.  The permis‐
28              sions needs to be specified as octal numbers e.g.  -d 775.
29
30
31       -f, --fperm=mode
32              sets the permissions of the control groups parameters.  The per‐
33              missions  needs  to  be specified as octal numbers e.g.  -f 775.
34              The value is not used as given because the current owner's  per‐
35              missions  are used as an umask (so 777 will set group and others
36              permissions to the owners permissions).
37
38
39       -g <controllers>:<path>
40              defines control groups to be added.  controllers is  a  list  of
41              controllers.  Character  "*"  can be used as a shortcut for "all
42              mounted controllers".  path is  the  relative  path  to  control
43              groups  in the given controllers list. This option can be speci‐
44              fied multiple times.
45
46
47       -h, --help
48              display this help and exit
49
50
51       -s, --tperm=mode
52              sets the permissions of the control group tasks file.  The  per‐
53              missions  needs  to  be specified as octal numbers e.g.  -s 775.
54              The value is not used as given because the current owner's  per‐
55              missions  are used as an umask (so 777 will set group and others
56              permissions to the owners permissions).
57
58
59       -t <tuid>:<tgid>
60              defines the name of the user and the  group,  which  owns  tasks
61              file of the defined control group. I.e. this user and members of
62              this group have write access to the file.  The default value  is
63              the same as has the parent cgroup.
64
65

ENVIRONMENT VARIABLES

67       CGROUP_LOGLEVEL
68              controls  verbosity of the tool. Allowed values are DEBUG, INFO,
69              WARNING or ERROR.
70
71

EXAMPLES

73       cgcreate -g *:student -g devices:teacher
74              create control group student in all mounted hierarchies and cre‐
75              ate  control  group  teacher  in hierarchy containing controller
76              devices.
77
78
79
80
81

SEE ALSO

83       cgrules.conf (5) cgexec (1) cgclassify (1)
84
85
86
87Linux                             2009-03-15                       CGCREATE(1)
Impressum