X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemctl.xml;h=60a0f401bdc139537b327bd679d2fc97b46b26af;hp=c452dfc43ff975611d435f7c42a02bb9d65c9872;hb=78a92a5a2306709e4587e332728a76901323ade9;hpb=aae9a96d4b3a8562af9e8c6a23871b442645b954 diff --git a/man/systemctl.xml b/man/systemctl.xml index c452dfc43..60a0f401b 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -106,6 +106,11 @@ 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. @@ -151,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. @@ -178,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. + + @@ -193,6 +225,7 @@ STDOUT in snapshot, is-active, + is-failed, enable and disable. @@ -595,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...] @@ -766,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. @@ -789,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 @@ -951,6 +996,19 @@ ordering and requirement dependencies. + + list-dependencies [NAME] + + Shows required and + wanted units of the specified unit. If + no unit is specified + default.target is + implied. Target units are recursively + expanded. When + is passed all other units aare + recursively expanded as well. + + snapshot [NAME] @@ -1173,12 +1231,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]