X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemctl.xml;h=c45b11a51059ca911fd5f785cc5acb1435a26474;hp=2fa448874b279baee35a91a15725dce470a641e7;hb=30732560c415f52d2a58fc8fab10b602a40c7274;hpb=6f3525444e177e8413d46c5029a7dced7fb4818d
diff --git a/man/systemctl.xml b/man/systemctl.xml
index 2fa448874..c45b11a51 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.
+
+
@@ -119,6 +126,15 @@
they are set or not.
+
+
+
+ When listing units,
+ show only failed units. Do not confuse
+ with
+ .
+
+
@@ -137,7 +153,9 @@
unfinished job, fail the command. If
this is not specified the requested
operation will replace the pending job,
- if necessary.
+ if necessary. Do not confuse
+ with
+ .
@@ -147,7 +165,7 @@
Suppress output to
STDOUT in
snapshot,
- check,
+ is-active,
enable and
disable.
@@ -163,6 +181,13 @@
argument it is only verified and
enqueued.
+
+
+
+ Do not pipe output into a
+ pager.
+
+
@@ -171,10 +196,10 @@
-
+ Talk to the systemd
- session manager of the calling user.
+ manager of the calling user.
@@ -217,10 +242,10 @@
When used with
enable and
disable, operate on the
- global session configuŕation
+ global user configuration
directory, thus enabling or disabling
a unit file globally for all future
- sessions of all users.
+ logins of all users.
@@ -234,6 +259,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 behavior off. In this
+ case the password must be supplied by
+ some other means (for example
+ graphical password agents) or the
+ service might fail.
+
+
@@ -246,7 +294,7 @@
to select
whether to kill the entire control
group, the process group or only the
- selected process itself. If ommitted
+ selected process itself. If omitted
defaults to
if
is
@@ -266,22 +314,22 @@
to select whether
to kill only the main process of the
unit, the control process or all
- processes of the unit. If ommitted
+ processes of the unit. If omitted
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
+ known signal specifiers such as
SIGTERM, SIGINT or SIGSTOP. If
- ommitted defaults to
+ omitted defaults to
.
@@ -386,21 +434,31 @@
units specified on the command
line. If the units are not running yet
the operation will
- fail.
+ fail. Note that for compatibility
+ with Red Hat init scripts
+ condrestart is
+ equivalent to this command.
reload-or-restart [NAME...]
+
+ Reload one or more
+ units if they support it. If not,
+ restart them instead. If the units
+ are not running yet they will be
+ started.
+
+ reload-or-try-restart [NAME...]Reload one or more
units if they support it. If not,
- restart them instead. Note that for
- compatibility with SysV and Red Hat
- init scripts
- force-reload and
- condrestart may be
- used as equivalent commands to
- reload-or-try-restart.
+ restart them instead. If the units
+ are not running yet the operation
+ will fail. Note that for
+ compatibility with SysV init scripts
+ force-reload is
+ equivalent to this command.
isolate [NAME]
@@ -439,7 +497,7 @@
is-active [NAME...]Check whether any of
- the specified units is active
+ the specified units are active
(i.e. running). Returns an exit code
0 if at least one is active, non-zero
otherwise. Unless
@@ -539,7 +597,7 @@
administrator is free to make
additional changes manually, by
placing or removing symlinks in the
- directory. This is particular useful
+ directory. This is particularly useful
to create configurations that deviate
from the suggested default
installation. In this case the
@@ -568,11 +626,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.
@@ -611,9 +669,9 @@
.
- This command honours
+ This command honors
,
- ,
+ ,
in a similar
way as
enable.
@@ -670,7 +728,7 @@
Cancel one or more
jobs specified on the command line by
their numeric job
- IDs. If not job id is specified cancels all jobs that are pending.
+ IDs. If no job id is specified, cancel all pending jobs.monitor
@@ -726,7 +784,7 @@
A snapshot refers to a saved
state of the systemd manager. It is
- implemented itself as unit that is
+ implemented itself as a unit that is
generated dynamically with this
command and has dependencies on all
units active at the time. At a later
@@ -781,16 +839,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 +871,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 +906,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 are killed
+ and all file systems are unmounted or
+ mounted read-only, immediately
+ followed by the
+ system halt.
poweroff
@@ -841,7 +923,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 are killed
+ and all file systems are unmounted or
+ mounted read-only, immediately
+ followed by the
+ powering off.
reboot
@@ -851,35 +940,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 are killed
+ and all file systems are 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 are killed
+ and all file systems are 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.