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)