X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemctl.xml;h=c21ed855659d1ed88abcc239438b566d1515f777;hp=10e0f82441368eb8460b260e7692fbbb96963bd5;hb=b24a167b6f0f9a44686736734e6d0cec07e1efa3;hpb=501fc174c22aebd3181af08a4cfa65cc92bbe233 diff --git a/man/systemctl.xml b/man/systemctl.xml index 10e0f8244..c21ed8556 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -44,7 +44,7 @@ systemctl - Control the systemd system and session manager + Control the systemd system and service manager @@ -59,7 +59,7 @@ systemctl may be used to introspect and control the state of the systemd1 - system and session manager. + system and service manager. @@ -154,7 +154,7 @@ Suppress output to STDOUT in snapshot, - check, + is-active, enable and disable. @@ -170,6 +170,13 @@ argument it is only verified and enqueued. + + + + Do not pipe output into a + pager. + + @@ -178,10 +185,10 @@ - + Talk to the systemd - session manager of the calling user. + manager of the calling user. @@ -224,10 +231,10 @@ When used with enable and disable, operate on the - global session configuŕation + global user configuration directory, thus enabling or disabling a unit file globally for all future - sessions of all users. + logins of all users. @@ -257,7 +264,7 @@ systemctl will query the user on the terminal for the necessary secrets. Use this option to - switch this behaviour off. In this + switch this behavior off. In this case the password must be supplied by some other means (for example graphical password agents) or the @@ -276,7 +283,7 @@ to select whether to kill the entire control group, the process group or only the - selected process itself. If ommitted + selected process itself. If omitted defaults to if is @@ -296,22 +303,22 @@ to select whether to kill only the main process of the unit, the control process or all - processes of the unit. If ommitted + processes of the unit. If omitted defaults to . - + When used with kill, choose which signal to send to selected processes. Must be one of the well - know signal specifiers such as + known signal specifiers such as SIGTERM, SIGINT or SIGSTOP. If - ommitted defaults to + omitted defaults to . @@ -416,21 +423,31 @@ units specified on the command line. If the units are not running yet the operation will - fail. + fail. Note that for compatibility + with Red Hat init scripts + condrestart is + equivalent to this command. reload-or-restart [NAME...] + + Reload one or more + units if they support it. If not, + restart them instead. If the units + are not running yet they will be + started. + + reload-or-try-restart [NAME...] Reload one or more units if they support it. If not, - restart them instead. Note that for - compatibility with SysV and Red Hat - init scripts - force-reload and - condrestart may be - used as equivalent commands to - reload-or-try-restart. + restart them instead. If the units + are not running yet the operation + will fail. Note that for + compatibility with SysV init scripts + force-reload is + equivalent to this command. isolate [NAME] @@ -469,7 +486,7 @@ is-active [NAME...] Check whether any of - the specified units is active + the specified units are active (i.e. running). Returns an exit code 0 if at least one is active, non-zero otherwise. Unless @@ -569,7 +586,7 @@ administrator is free to make additional changes manually, by placing or removing symlinks in the - directory. This is particular useful + directory. This is particularly useful to create configurations that deviate from the suggested default installation. In this case the @@ -598,11 +615,11 @@ Depending on whether , - or + or is specified this enables the unit for the system, - for sessions of the calling user only - or for all future session of all + for the calling user only + or for all future logins of all users. Note that in the latter case no systemd daemon configuration is reloaded. @@ -641,9 +658,9 @@ . - This command honours + This command honors , - , + , in a similar way as enable. @@ -700,7 +717,7 @@ Cancel one or more jobs specified on the command line by their numeric job - IDs. If not job id is specified cancels all jobs that are pending. + IDs. If no job id is specified, cancel all pending jobs. monitor @@ -756,7 +773,7 @@ A snapshot refers to a saved state of the systemd manager. It is - implemented itself as unit that is + implemented itself as a unit that is generated dynamically with this command and has dependencies on all units active at the time. At a later @@ -881,8 +898,8 @@ users. If combined with shutdown of all running services is - skipped, however all processes killed - and all file systems unmounted or + skipped, however all processes are killed + and all file systems are unmounted or mounted read-only, immediately followed by the system halt. @@ -898,8 +915,8 @@ users. If combined with shutdown of all running services is - skipped, however all processes killed - and all file systems unmounted or + skipped, however all processes are killed + and all file systems are unmounted or mounted read-only, immediately followed by the powering off. @@ -915,8 +932,8 @@ users. If combined with shutdown of all running services is - skipped, however all processes killed - and all file systems unmounted or + skipped, however all processes are killed + and all file systems are unmounted or mounted read-only, immediately followed by the reboot. @@ -931,8 +948,8 @@ a wall message to all users. If combined with shutdown of all running services is - skipped, however all processes killed - and all file systems unmounted or + skipped, however all processes are killed + and all file systems are unmounted or mounted read-only, immediately followed by the reboot. @@ -942,9 +959,9 @@ Ask the systemd manager to quit. This is only - supported for session managers + supported for user service managers (i.e. in conjunction with the - option) and + option) and will fail otherwise.