cgcreate - create new cgroup(s)

NAME  SYNOPSIS  DESCRIPTION  ENVIRONMENT VARIABLES  EXAMPLES  SEE ALSO 

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)


Updated 2024-01-29 - jenkler.se | uex.se