CGRULES.CONF(5) libcgroup Manual CGRULES.CONF(5)NAMEcgrules.conf - libcgroup configuration file
DESCRIPTIONcgrules.conf configuration file is used by libcgroups to define control
groups to which a process belongs.
The file contains a list of rules which assign to a defined group/user
a control group in a subsystem (or control groups in subsystems).
Rules have two formats:
<user> <controllers> <destination>
<user>:<process name> <controllers> <destination>
Where:
user can be:
- a user name
- a group name with @group syntax
- the wildcard '*', for any user or group
- '%', which is equivalent to "ditto" (useful for
multi-line rules where different cgroups need to be
specified for various hierarchies for a single user)
process name is optional and it can be:
- a process name
- a full command path of a process
controllers can be:
- comma separated controller names (no spaces) or
- * (for all mounted controllers)
destination can be:
- path relative to the controller hierarchy (ex. pgrp1/gid1/uid1)
- following strings will get expanded
%u username, uid if name resolving fails
%U uid
%g group name, gid if name resolving fails
%G gid
%p process name, pid if name not available
%P pid
'\' can be used to escape '%'
First rule which matches the criteria will be executed.
Any text starting with '#' is considered as a start of comment line and
is ignored.
EXAMPLES
student devices /usergroup/students
Student's processes in the 'devices' subsystem belong to the control
group /usergroup/students.
student:cp devices /usergroup/students/cp
When student executes 'cp' command, the processes in the 'devices' sub‐
system belong to the control group /usergroup/students/cp.
@admin * admingroup/
Processes started by anybody from admin group no matter in what subsys‐
tem belong to the control group admingroup/.
peter cpu test1/
% memory test2/
The first line says Peter's task for cpu controller belongs to test1
control group. The second one says Peter's tasks for memory controller
belong to test2/ control group.
* * default/
All processes in any subsystem belong to the control group default/.
Since the earliest matched rule is applied, it makes sense to have this
line at the end of the list. It will put a task which was not mentioned
in the previous rules to default/ control group.
FILES
/etc/cgrules.conf
default libcgroup configuration file
SEE ALSO
cgconfig.conf (5), cgclassify (1), cgred.conf (5)
BUGSLinux 2009-03-10 CGRULES.CONF(5)