X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemctl.xml;h=844d218877ad37c6aea5313d221436ce4b1c364b;hb=04d148459f4da7e4d695c998a1d87e65f9d35b79;hp=2fa448874b279baee35a91a15725dce470a641e7;hpb=6f3525444e177e8413d46c5029a7dced7fb4818d;p=elogind.git diff --git a/man/systemctl.xml b/man/systemctl.xml index 2fa448874..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,6 +241,29 @@ 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. + + @@ -568,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. @@ -613,7 +643,7 @@ This command honours , - , + , in a similar way as enable. @@ -781,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 @@ -823,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 @@ -831,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 @@ -841,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 @@ -851,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 - - Enter default - mode. This is mostly equivalent to - start - default.target. - - - rescue + kexec - 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.