X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemctl.xml;h=2fa448874b279baee35a91a15725dce470a641e7;hp=1c5c884f8ce9b1efcb99216cda8847f361b6cf6d;hb=6f3525444e177e8413d46c5029a7dced7fb4818d;hpb=75676b7287c50b5e03ed0143c65b93d435ff8b6c diff --git a/man/systemctl.xml b/man/systemctl.xml index 1c5c884f8..2fa448874 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -123,7 +123,8 @@ Do not ellipsize unit - names in the output of + names and truncate unit descriptions + in the output of list-units and list-jobs. @@ -154,13 +155,13 @@ - Do not synchronously wait for - the requested operation to finish. If this is - not specified the job will be verified, - enqueued and systemctl will - wait until it is completed. By passing this - argument it is only verified and - enqueued. + Do not synchronously wait for + the requested operation to finish. If this is + not specified the job will be verified, + enqueued and systemctl will + wait until it is completed. By passing this + argument it is only verified and + enqueued. @@ -233,13 +234,78 @@ changes. + + + + When used with + kill, choose the + mode how to kill the selected + processes. Must be one of + , + or + to select + whether to kill the entire control + group, the process group or only the + selected process itself. If ommitted + defaults to + if + is + set, or + otherwise. You probably never need to + use this switch. + + + + + + When used with + kill, choose which + processes to kill. Must be one of + , + or + to select whether + to kill only the main process of the + unit, the control process or all + processes of the unit. If ommitted + 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 + SIGTERM, SIGINT or SIGSTOP. If + ommitted defaults to + . + + + When used with enable, override any existing conflicting symlinks. + + When used with + halt, + poweroff, + reboot or + kexec execute + selected operation without shutting + down all units. However, all processes + will be killed forcibly and all file + systems are unmounted or remounted + read-only. This is hence a drastic but + relatively safe option to request an + immediate reboot. @@ -341,8 +407,33 @@ Start the unit specified on the command line and its - dependencies and stop all - others. + dependencies and stop all others. + + This is similar to changing the + runlevel in a traditional init system. The + isolate command will + immediately stop processes that are not + enabled in the new unit, possibly including + the graphical environment or terminal you + are currently using. + + Note that this works only on units + where is + enabled. See + systemd.unit5 + for details. + + + kill [NAME...] + + Send a signal to one + or more processes of the unit. Use + to select + which process to kill. Use + to + select the kill mode and + to select + the signal to send. is-active [NAME...] @@ -395,18 +486,19 @@ - reset-maintenance [NAME...] + reset-failed [NAME...] - Reset maintenance - state of the specified units, or if no - unit name is passed of all units. When - a unit fails in some way (i.e. process - exiting with non-zero error code, - terminating abnormally or timing out) - it will automatically enter - maintenance state and its exit codes - and status is recorded for - introspection by the administrator + Reset the + 'failed' state of the + specified units, or if no unit name is + passed of all units. When a unit fails + in some way (i.e. process exiting with + non-zero error code, terminating + abnormally or timing out) it will + automatically enter the + 'failed' state and + its exit code and status is recorded + for introspection by the administrator until the service is restarted or reset with this command. @@ -430,7 +522,7 @@ does not have the effect that any of the units enabled are also started at the same time. If this is desired a - seperate start + separate start command must be invoked for the unit.