X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemctl.xml;h=7f7064214e907a22628518ddd071ac3880a39594;hb=895aeb27795c00f365ce3b30b1dca549b4f5468e;hp=c5fae825aa1e80ce3a918bab70e7b6a14a8b8692;hpb=29283ea4cf5df20aa0ea9e24e3cb7035bf4c4a04;p=elogind.git diff --git a/man/systemctl.xml b/man/systemctl.xml index c5fae825a..7f7064214 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -69,8 +69,8 @@ - + Prints a short help text and exits. @@ -84,8 +84,8 @@ - + The argument should be a unit type name such as @@ -106,12 +106,17 @@ 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. - + When showing unit/job/manager properties, limit @@ -127,8 +132,8 @@ - + When listing units, show all units, regardless of their @@ -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,7 +183,7 @@ 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 @@ -186,13 +191,41 @@ - + + + + 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. + + + + Suppress output to STDOUT in snapshot, is-active, + is-failed, enable and disable. @@ -238,32 +271,6 @@ manager of the calling user. - - - - - When used in - conjunction with the - dot command (see - below), selects which dependencies are - shown in the dependency graph. If - is passed - only dependencies of type - After= or - Before= are - shown. If - is passed only dependencies of type - Requires=, - RequiresOverridable=, - Requisite=, - RequisiteOverridable=, - Wants= and - Conflicts= are - shown. If neither is passed, shows - dependencies of all these - types. - - @@ -337,8 +344,8 @@ - + When used with kill, choose which @@ -351,8 +358,8 @@ - + When used with enable, overwrite any @@ -430,8 +437,8 @@ - + When used with status controls the @@ -443,19 +450,8 @@ - - - - When used with - status continuously - prints new journal entries as they are - appended to the - journal. - - - - + When used with status controls the @@ -606,6 +602,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...] @@ -777,7 +785,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. @@ -800,7 +808,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,22 +953,17 @@ applications. - dot + list-dependencies [NAME] - Generate textual - dependency graph description in dot - format for further processing with the - GraphViz - dot1 - tool. Use a command line like - systemctl dot | dot -Tsvg > - systemd.svg to generate a - graphical dependency tree. Unless - or - is passed - the generated graph will show both - ordering and requirement - dependencies. + 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] @@ -1107,7 +1110,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 @@ -1128,7 +1131,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 @@ -1149,7 +1152,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 @@ -1184,12 +1187,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] @@ -1232,7 +1252,7 @@ Environment - + $SYSTEMD_PAGER Pager to use when