X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemctl.xml;h=844d218877ad37c6aea5313d221436ce4b1c364b;hb=a45b9fd09442eb75d39e3419c1fced90c7e339e7;hp=88bc48fca520a81871c49051431c4f671c1a34f2;hpb=a9c72fe933efc9c77580fb4d7212e00f7a690c36;p=elogind.git
diff --git a/man/systemctl.xml b/man/systemctl.xml
index 88bc48fca..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...]
@@ -445,7 +552,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.
@@ -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.