X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemctl.xml;h=f22338371635d170530ba703c43f0805903401ff;hp=e3d22a7b5bf000281d7e849c10182b144b51a405;hb=55c0b89c575fcb2c075286d444ed4fb1cf8c8563;hpb=9980033377c105d2cd6539c9d73ee61d4c2263b0
diff --git a/man/systemctl.xml b/man/systemctl.xml
index e3d22a7b5..f22338371 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -87,14 +87,31 @@
- When listing units,
- limit display to certain unit
- types. If not specified units of all
- types will be shown. The argument
- should be a unit type name such as
- ,
- and
- similar.
+ 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 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.
+
+ As a special case, if the argument
+ is , a list of
+ allowed values will be printed and the
+ program will exit.
+
@@ -139,7 +156,7 @@
Do not ellipsize unit
- names and truncate unit descriptions
+ names, cgroup members, and truncate unit descriptions
in the output of
list-units and
list-jobs.
@@ -166,13 +183,40 @@
execute it immediately. If passed no
required units of the unit passed will
be pulled in, and no ordering
- dependencies will be honoured. This is
+ dependencies will be honored. This is
mostly a debugging and rescue tool for
the administrator and should not be
used by
applications.
+
+
+
+
+ When system shutdown
+ or a sleep state is requested, ignore
+ inhibitor locks. Applications can
+ establish inhibitor locks to avoid
+ that certain important operations
+ (such as CD burning or suchlike) are
+ interrupted by system shutdown or a
+ 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 is
+ printed. However if
+
+ is specified the locks are ignored and
+ not printed, and the operation
+ attempted anyway, possibly requiring
+ additional
+ privileges.
+
+
@@ -181,6 +225,7 @@
STDOUT in
snapshot,
is-active,
+ is-failed,
enable and
disable.
@@ -430,17 +475,6 @@
10.
-
-
-
-
- When used with
- status continously
- prints new journal entries as they are
- appended to the
- journal.
-
-
@@ -594,6 +628,18 @@
this will also print the current unit
state to STDOUT.
+
+ is-failed [NAME...]
+
+ Check whether any of
+ the specified units are failed.
+ Returns an exit code
+ 0 if at least one is failed, non-zero
+ otherwise. Unless
+ is specified
+ this will also print the current unit
+ state to STDOUT.
+ status [NAME...|PID...]
@@ -670,24 +716,29 @@
enable [NAME...]
- Enable one or more
- unit files, as specified on the
+ Enable one or
+ more unit files or unit file
+ instances, as specified on the
command line. This will create a
- number of symlinks as encoded in the
- [Install] sections
- of the unit files. After the symlinks
- have been created the systemd
- configuration is reloaded (in a way
- that is equivalent to
- daemon-reload) to
- ensure the changes are taken into
+ number of symlinks as encoded in
+ the [Install]
+ sections of the unit files. After
+ the symlinks have been created the
+ systemd configuration is reloaded
+ (in a way that is equivalent to
+ daemon-reload)
+ to ensure the changes are taken into
account immediately. Note that this
does not have the effect that any of
the units enabled are also started at
- the same time. If this is desired a
- separate start
- command must be invoked for the
- unit.
+ the same time. If this is desired
+ a separate start
+ command must be invoked for the unit.
+ Also note that in case of instance
+ enablement, symlinks named same as
+ instances are created in install
+ location, however they all point to
+ the same template unit file.This command will
print the actions executed. This
@@ -760,7 +811,7 @@
configuration after completing the
disabling of the units. Note that this
command does not implicitly stop the
- units that is being disabled. If this
+ units that are being disabled. If this
is desired an additional
stop command should
be executed afterwards.
@@ -783,7 +834,7 @@
is-enabled [NAME...]Checks whether any of
- the specified unit files is enabled
+ the specified unit files are enabled
(as with
enable). Returns an
exit code of 0 if at least one is
@@ -945,6 +996,17 @@
ordering and requirement
dependencies.
+
+ list-dependencies [NAME]
+
+
+ Shows required and wanted units of given unit.
+ Target units are recursively expanded.
+ When is passed
+ dependency tree is generated for all
+ subsidiary units.
+
+ snapshot [NAME]
@@ -1090,7 +1152,7 @@
mounted read-only, immediately
followed by the system halt. If
is specified
- twice the the operation is immediately
+ twice the operation is immediately
executed without terminating any
processes or unmounting any file
systems. This may result in data
@@ -1111,7 +1173,7 @@
unmounted or mounted read-only,
immediately followed by the powering
off. If is
- specified twice the the operation is
+ specified twice the operation is
immediately executed without
terminating any processes or
unmounting any file systems. This may
@@ -1132,7 +1194,7 @@
unmounted or mounted read-only,
immediately followed by the reboot. If
is specified
- twice the the operation is immediately
+ twice the operation is immediately
executed without terminating any
processes or unmounting any file
systems. This may result in data
@@ -1167,12 +1229,29 @@
suspend
- Suspend the system.
+ Suspend the
+ system. This will trigger activation
+ of the special
+ suspend.target
+ target.hibernate
- Hibernate the system.
+ Hibernate the
+ system. This will trigger activation
+ of the special
+ hibernate.target
+ target.
+
+
+ hybrid-sleep
+
+ Hibernate and suspend
+ the system. This will trigger
+ activation of the special
+ hybrid-sleep.target
+ target.switch-root [ROOT] [INIT]
@@ -1190,10 +1269,10 @@
directory, and the path to the new
system manager binary below it to
execute as PID 1. If the latter is
- ommitted or the empty string, a
+ omitted or the empty string, a
systemd binary will automatically be
searched for and used as init. If the
- system manager path is ommitted or
+ system manager path is omitted or
equal the empty string the state of
the initrd's system manager process is
passed to the main system manager,