NAME

       cgcreate - create new cgroup(s)

SYNOPSIS

       cgcreate  [-h]  [-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.

       -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

       -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).

       -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)