NAME

       cgcreate - create new cgroup(s)

SYNOPSIS

       cgcreate  [-h]  [-b]  [-c]  [-t  <tuid>:<tgid>]  [-a  <agid>:<auid>]  [-f  mode]  [-d  mode] [-s mode] -g
       <controllers>:<path> [-g ...]

DESCRIPTION

       The command creates new cgroup(s) defined by the options -g.

       -a <agid>:<auid>
              defines the name of the user and the group which own the  rest  of  the  defined  control  group’s
              files.  These  users  are  allowed  to set subsystem parameters and create subgroups.  The default
              value is the same as has the parent cgroup.

       -b     ignores the default systemd delegated hierarchy path and constructs the path of the control groups
              relative to the cgroup root hierarchy.

       -c, --scope
              creates a new systemd scope. The cgroup name provided after the  -g  flag  must  be  of  the  form
              <slice-name>.slice/<scope-name>.scope.  If  the  slice  does  not  exist,  systemd will create it.
              Libcgroup will place an idle process in the scope's  cgroup.procs  file  unless  the  -p  flag  is
              provided.

       -d, --dperm=mode
              sets  the  permissions  of  a  control groups directory.  The permissions needs to be specified as
              octal numbers e.g.  -d 775.

       -f, --fperm=mode
              sets the permissions of the control groups parameters.  The permissions needs to be  specified  as
              octal  numbers  e.g.   -f  775.   The  value  is  not  used  as  given because the current owner's
              permissions are used as an umask (so 777 will set group  and  others  permissions  to  the  owners
              permissions).

       -g <controllers>:<path>
              defines  control  groups  to be added.  controllers is a list of controllers. Character "*" can be
              used as a shortcut for "all mounted controllers".  path is the relative path to control groups  in
              the given controllers list. This option can be specified multiple times.

       -h, --help
              display this help and exit

       -p, --pid=pid
              moves   the  provided  pid  into  the  <slice-name>.slice/<scope-name>.scope.   Must  be  used  in
              conjunction with -c.

       -s, --tperm=mode
              sets the permissions of the control group tasks file.  The permissions needs to  be  specified  as
              octal  numbers  e.g.   -s  775.   The  value  is  not  used  as  given because the current owner's
              permissions are used as an umask (so 777 will set group  and  others  permissions  to  the  owners
              permissions).

       -S, --setdefault
              sets  the scope specified via the -c option as the default libcgroup scope.  This default scope is
              used by libcgroup tools to build up the cgroup path.  See the -b option.

       -t <tuid>:<tgid>
              defines the name of the user and the group, which owns tasks file of the  defined  control  group.
              I.e.  this user and members of this group have write access to the file.  The default value is the
              same as has the parent cgroup.

ENVIRONMENT VARIABLES

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

EXAMPLES

       cgcreate -g *:student devices:teacher
              create control group student in all mounted  hierarchies  and  create  control  group  teacher  in
              hierarchy containing controller devices.

SEE ALSO

       cgrules.conf (5) cgexec (1) cgclassify (1)

Linux                                              2009-03-15                                        CGCREATE(1)