X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;ds=sidebyside;f=man%2Fsystemctl.xml;h=2739df69d42d805fec304f34cd224cda57f113ee;hb=a432cb691ca3c1e18b012cb8e9f6e5654b3652a2;hp=0ceb26d59b40406bbc3182ee1f58fb2be5417eda;hpb=23ade460e5a118daa575a961b405d089f95e0617;p=elogind.git
diff --git a/man/systemctl.xml b/man/systemctl.xml
index 0ceb26d59..2739df69d 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -92,21 +92,22 @@ along with systemd; If not, see .
- The argument should be a unit type name such as
- and , or a
- unit load state such as and
- .
-
-
- If the argument is a unit type, when listing units,
- limit display to certain unit types. If not specified units
+ The argument should be a comma separated list of unit
+ types such as and
+ , or unit load states such as
+ and
+ (types and states can be mixed).
+
+ If one of the arguments is a unit type, when listing
+ units, limit display to certain unit types. Otherwise units
of all types will be shown.
- If the argument is a unit load state, when listing
- units, limit display to certain unit types. If not specified
- units of in all load states will be shown.
+ If one of the arguments is a unit load state, when
+ listing units, limit display to certain unit
+ types. Otherwise units of in all load states will be
+ shown.
- As a special case, if the argument is
+ As a special case, if one of the arguments is
, a list of allowed values will be
printed and the program will exit.
@@ -117,10 +118,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.
@@ -131,10 +133,35 @@ along with systemd; If not, see .
- When listing units, show all units, regardless of
- their state, including inactive units. When showing
+ When listing units, show all loaded units, regardless
+ of their state, including inactive units. When showing
unit/job/manager properties, show all properties regardless
whether they are set or not.
+ To list all units installed on the system, use the
+ list-unit-files command instead.
+
+
+
+
+
+
+
+ Show reverse dependencies between units with
+ list-dependencies, i.e. units with
+ dependencies of type Wants= or
+ Requires= on the given unit.
+
+
+
+
+
+
+
+
+
+ Show which units are started after, resp. before
+ with list-dependencies.
+
@@ -170,6 +197,14 @@ along with systemd; If not, see .
+
+
+
+
+ When showing sockets, show the type of the socket.
+
+
+
@@ -206,7 +241,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
@@ -392,14 +427,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.
@@ -469,6 +512,31 @@ along with systemd; If not, see .
This is the default command.
+
+
+ list-sockets
+
+
+ List socket units ordered by the listening address. Produces output
+ similar to
+
+LISTEN UNIT ACTIVATES
+/dev/initctl systemd-initctl.socket systemd-initctl.service
+...
+[::]:22 sshd.socket sshd.service
+kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
+
+5 sockets listed.
+
+ Note: because the addresses might contains spaces, this output
+ is not suitable for programatic consumption.
+
+
+ See also the options ,
+ , and .
+
+
+
start NAME...
@@ -631,6 +699,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 omitted) 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 +801,7 @@ along with systemd; If not, see .
shown.
+
reset-failed [NAME...]
@@ -1006,8 +1167,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
@@ -1023,8 +1184,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
@@ -1039,8 +1200,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
@@ -1055,7 +1216,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