X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemctl.xml;h=844d218877ad37c6aea5313d221436ce4b1c364b;hb=3686ced6d76d72a7364db4616c14a164f9c1f01e;hp=2eb153e73810c0e9257e2653f40af89dc87acaf2;hpb=96d4ce01103ebebe9335fb321667043bb620c06b;p=elogind.git diff --git a/man/systemctl.xml b/man/systemctl.xml index 2eb153e73..844d21887 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. @@ -76,6 +76,13 @@ text and exits. + + + + Prints a short version + string and exits. + + @@ -171,10 +178,10 @@ - + Talk to the systemd - session manager of the calling user. + manager of the calling user. @@ -217,10 +224,10 @@ When used with enable and disable, operate on the - global session configuŕation + global user configuŕation directory, thus enabling or disabling a unit file globally for all future - sessions of all users. + logins of all users. @@ -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...] @@ -491,11 +598,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. @@ -536,7 +643,7 @@ This command honours , - , + , in a similar way as enable. @@ -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 user service managers + (i.e. in conjunction with the + option) and + will fail otherwise.