X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemctl.xml;h=10e0f82441368eb8460b260e7692fbbb96963bd5;hp=2eb153e73810c0e9257e2653f40af89dc87acaf2;hb=799fd0fd23028a58e1f605c6b0d9aaab65b4fb1f;hpb=96d4ce01103ebebe9335fb321667043bb620c06b diff --git a/man/systemctl.xml b/man/systemctl.xml index 2eb153e73..10e0f8244 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -76,6 +76,13 @@ text and exits. + + + + Prints a short version + string and exits. + + @@ -234,13 +241,101 @@ changes. + + + + When used with + start and related + commands, disables asking for + passwords. Background services may + require input of a password or + passphrase string, for example to + unlock system hard disks or + cryptographic certificates. Unless + this option is specified and the + command is invoked from a terminal + systemctl will + query the user on the terminal for the + necessary secrets. Use this option to + switch this behaviour off. In this + case the password must be supplied by + some other means (for example + graphical password agents) or the + service might fail. + + + + + + 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. @@ -358,6 +453,18 @@ 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...] @@ -704,16 +811,6 @@ configuration will stay accessible. - - daemon-exit - - Ask the systemd - manager to quit. This is only - supported for session managers - (i.e. in conjunction with the - option) and - will fail otherwise. - show-environment @@ -746,7 +843,34 @@ is only removed if it has the specified value. + + default + Enter default + mode. This is mostly equivalent to + start + default.target. + + + rescue + + Enter rescue + mode. This is mostly equivalent to + isolate + rescue.target but also + prints a wall message to all + users. + + + emergency + + Enter emergency + mode. This is mostly equivalent to + isolate + emergency.target but also + prints a wall message to all + users. + halt @@ -754,7 +878,14 @@ system. This is mostly equivalent to start halt.target but also prints a wall message to all - users. + users. If + combined with + shutdown of all running services is + skipped, however all processes killed + and all file systems unmounted or + mounted read-only, immediately + followed by the + system halt. poweroff @@ -764,7 +895,14 @@ equivalent to start poweroff.target but also prints a wall message to all - users. + users. If + combined with + shutdown of all running services is + skipped, however all processes killed + and all file systems unmounted or + mounted read-only, immediately + followed by the + powering off. reboot @@ -774,35 +912,40 @@ equivalent to start reboot.target but also prints a wall message to all - users. + users. If + combined with + shutdown of all running services is + skipped, however all processes killed + and all file systems unmounted or + mounted read-only, immediately + followed by the + reboot. - default + kexec - Enter default - mode. This is mostly equivalent to - start - default.target. - - - rescue - - Enter rescue - mode. This is mostly equivalent to - isolate - rescue.target but also - prints a wall message to all - users. + Shut down and reboot + the system via kexec. This is mostly + equivalent to start + kexec.target but also prints + 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 + mounted read-only, immediately + followed by the + reboot. - emergency + exit - Enter emergency - mode. This is mostly equivalent to - isolate - emergency.target but also - prints a wall message to all - users. + Ask the systemd + manager to quit. This is only + supported for session managers + (i.e. in conjunction with the + option) and + will fail otherwise.