X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemctl.xml;h=5656564f54bf6837bb9f37123efcae460369db27;hb=9f26c90cb50c45d4549c4dd569917b4ac143b94d;hp=c233543d7d2224c67b415d4b0dc129173c7e0847;hpb=b7cf6049a36dfd8e5f3c6420243eb49d348dbd2f;p=elogind.git
diff --git a/man/systemctl.xml b/man/systemctl.xml
index c233543d7..5656564f5 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -117,10 +117,11 @@ along with systemd; If not, see .
- When showing unit/job/manager properties, limit
- display to certain properties as specified as argument. If
- not specified all set properties are shown. The argument
- should be a comma-seperated list of property names, such as
+ When showing unit/job/manager properties with the
+ show command, limit display to certain
+ properties as specified as argument. If not specified all
+ set properties are shown. The argument should be a
+ comma-seperated list of property names, such as
MainPID. If specified more than once all
properties with the specified names are shown.
@@ -170,6 +171,17 @@ along with systemd; If not, see .
+
+
+
+
+ Mark this transaction's jobs as irreversible. This prevents
+ future conflicting transactions from replacing these jobs.
+ The jobs can still be cancelled using the cancel
+ command.
+
+
+
@@ -195,7 +207,7 @@ along with systemd; If not, see .
sleep state. Any user may take these locks and privileged
users may override these locks. If any locks are taken,
shutdown and sleep state requests will normally fail
- (regardless if privileged or not) and list of active locks
+ (regardless if privileged or not) and a list of active locks
is printed. However if
is specified the locks are ignored and not printed, and the
operation attempted anyway, possibly requiring additional
@@ -381,14 +393,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.
@@ -620,6 +640,98 @@ along with systemd; If not, see .
human-readable output.
+
+
+ get-cgroup-attr NAMEATTRIBUTE...
+
+
+ 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 NAMEATTRIBUTEVALUE...
+
+
+ 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 NAMEATTRIBUTE...
+
+ 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 NAMECGROUP...
+ unset-cgroup NAMECGROUP...
+
+ 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...
@@ -630,6 +742,7 @@ along with systemd; If not, see .
shown.
+
reset-failed [NAME...]
@@ -995,8 +1108,8 @@ along with systemd; If not, see .
halt
- Shut down and halt the system. This is mostly
- equivalent to start halt.target but also
+ Shut down and halt the system. This is mostly equivalent to
+ start halt.target --irreversible but also
prints a wall message to all users. If combined with
shutdown of all running services is
skipped, however all processes are killed and all file
@@ -1012,8 +1125,8 @@ along with systemd; If not, see .
Shut down and power-off the system. This is mostly
- equivalent to start poweroff.target but
- also prints a wall message to all users. If combined with
+ equivalent to start poweroff.target --irreversible
+ but also prints a wall message to all users. If combined with
shutdown of all running services is
skipped, however all processes are killed and all file
systems are unmounted or mounted read-only, immediately
@@ -1028,8 +1141,8 @@ along with systemd; If not, see .
Shut down and reboot the system. This is mostly
- equivalent to start reboot.target but
- also prints a wall message to all users. If combined with
+ equivalent to start reboot.target --irreversible
+ but also prints a wall message to all users. If combined with
shutdown of all running services is
skipped, however all processes are killed and all file
systems are unmounted or mounted read-only, immediately
@@ -1044,7 +1157,7 @@ along with systemd; If not, see .
Shut down and reboot the system via kexec. This is
- mostly equivalent to start kexec.target
+ mostly equivalent to start kexec.target --irreversible
but also prints a wall message to all users. If combined
with shutdown of all running
services is skipped, however all processes are killed and