From a330b376bac697ecf13cada5f96070a318ab9ab9 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Wed, 27 Feb 2013 19:37:04 +0100 Subject: man: document the new systemctl cgroup commands --- man/systemctl.xml | 107 ++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 104 insertions(+), 3 deletions(-) (limited to 'man') diff --git a/man/systemctl.xml b/man/systemctl.xml index 39229a0075..87d783e45d 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -392,14 +392,22 @@ along with systemd; If not, see . - When used with - enable/disable/is-enabled + When used with enable, + disable, is-enabled (and related commands), make changes only temporarily, so - that they are dropped on the next reboot. This will have the + that they are lost on the next reboot. This will have the effect that changes are not made in subdirectories of /etc but in /run, with identical immediate effects, however, since the latter is lost on reboot, the changes are lost too. + + Similar, when used with + set-cgroup-attr, + unset-cgroup-attr, + set-cgroup and + unset-cgroup, make changes only + temporarily, so that they are lost on the next + reboot. @@ -631,6 +639,98 @@ along with systemd; If not, see . human-readable output. + + + get-cgroup-attr NAME ATTRIBUTE... + + + Retrieve the specified control group attributes of the + specified unit. Takes a unit name and one or more attribute + names such as cpu.shares. This will + output the current values of the specified attributes, + separated by new-lines. For attributes that take list of + items the output will be new-line separated, too. This + operation will always try to retrieve the data in question + from the kernel first, and if that is not available use the + configured values instead. Instead of low-level control + group attribute names high-level pretty names may be used, + as used for unit execution environment configuration, see + systemd.exec5 + for details. For example, passing + memory.limit_in_bytes and + MemoryLimit is equivalent. + + + + + set-cgroup-attr NAME ATTRIBUTE VALUE... + + + Set the specified control group attribute of the + specified unit to the specified value. Takes a unit + name and an attribute name such as + cpu.shares, plus one or more values + (multiple values may only be used for attributes that take + multiple values). This operation will immediately update the + kernel attribute for this unit and persistently store this + setting for later reboots (unless + is passed, in which case the setting is not saved + persistently and only valid until the next reboot.) Instead + of low-level control group attribute names high-level pretty + names may be used, as used for unit execution environment + configuration, see + systemd.exec5 + for details. For example, passing + memory.limit_in_bytes and + MemoryLimit is equivalent. This operation + will implicitly create a control group for the unit in the + controller the attribute belongs to, if needed. For + attributes that take multiple values, this operation will + append the specified values to the previously set values + list (use unset-cgroup-attr to reset the + list explicitly). For attributes that take a single value + only the list will be reset implicitly. + + + + + unset-cgroup-attr NAME ATTRIBUTE... + + Unset the specified control group attributes + of the specified unit. Takes a unit name and one or more + attribut names such as cpu.shares. This + operation might or might not have an immediate effect on the + current kernel attribute value. This will remove any + persistently stored configuration values for this attribute + (as set with set-cgroup-attr before), + unless is passed, in which case the + configuration is reset only until the next reboot. Again, + high-level control group attributes may be used instead of the + low-level kernel ones. For attributes which take multiple + values, all currently set values are reset. + + + + + set-cgroup NAME CGROUP... + unset-cgroup NAME CGROUP... + + Add or remove a unit to/from a specific + control group hierarchy and/or control group path. Takes a + unit name, plus a control group specification in the syntax + CONTROLLER:PATH + or CONTROLLER. In the latter syntax + (where the path is ommitted) the default unit control group + path is implied. Examples: cpu or + cpu:/foo/bar. If a unit is removed from a + control group hierarchy all its processes will be moved to the + root group of the hierarchy and all control group attributes + will be reset. These operations are immediately reflected in + the kernel hierarchy, and stored persistently to disk (unless + is passed). + + + help NAME...|PID... @@ -641,6 +741,7 @@ along with systemd; If not, see . shown. + reset-failed [NAME...] -- cgit v1.2.3-54-g00ecf