X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemctl.xml;h=e9e3371ba8d00e6c1613aa28be77369f54b2b953;hb=0b4ebf07bcdf9ca684424b72f2e5a19cacea42c5;hp=844d218877ad37c6aea5313d221436ce4b1c364b;hpb=af2d49f70bcff20efaf2d69aecaf4b3e898ff1fa;p=elogind.git
diff --git a/man/systemctl.xml b/man/systemctl.xml
index 844d21887..e9e3371ba 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -126,6 +126,15 @@
they are set or not.
+
+
+
+ When listing units,
+ show only failed units. Do not confuse
+ with
+ .
+
+
@@ -144,7 +153,24 @@
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
+ .
+
+
+
+
+
+ When enqueuing a new
+ job ignore all its dependencies and
+ execute it immediately. If passed no
+ required units of the unit passed will
+ be pulled in, and no ordering
+ dependencies will be honoured. This is
+ mostly a debugging and rescue tool for
+ the administrator and should not be
+ used by
+ applications.
@@ -154,7 +180,7 @@
Suppress output to
STDOUT in
snapshot,
- check,
+ is-active,
enable and
disable.
@@ -170,6 +196,13 @@
argument it is only verified and
enqueued.
+
+
+
+ Do not pipe output into a
+ pager.
+
+
@@ -224,7 +257,7 @@
When used with
enable and
disable, operate on the
- global user configuŕation
+ global user configuration
directory, thus enabling or disabling
a unit file globally for all future
logins of all users.
@@ -257,7 +290,7 @@
systemctl will
query the user on the terminal for the
necessary secrets. Use this option to
- switch this behaviour off. In this
+ switch this behavior off. In this
case the password must be supplied by
some other means (for example
graphical password agents) or the
@@ -271,13 +304,11 @@
kill, choose the
mode how to kill the selected
processes. Must be one of
- ,
- or
+ or
to select
whether to kill the entire control
- group, the process group or only the
- selected process itself. If ommitted
- defaults to
+ group or only the selected process
+ itself. If omitted defaults to
if
is
set, or
@@ -296,22 +327,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
.
@@ -349,6 +380,27 @@
file that shall be
disabled.
+
+
+
+
+
+ Execute operation
+ remotely. Specifiy a hostname, or
+ username and hostname seperated by @,
+ to connect to. This will use SSH to
+ talk to the remote systemd
+ instance.
+
+
+
+
+
+
+ Acquire privileges via
+ PolicyKit before executing the
+ operation.
+ The following commands are understood:
@@ -414,23 +466,34 @@
Restart one or more
units specified on the command
- line. If the units are not running yet
- the operation will
- fail.
+ line if the units are running. Do
+ nothing if units are not running.
+ 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. Do nothing if
+ the units are not running. Note that
+ for compatibility with SysV init
+ scripts
+ force-reload is
+ equivalent to this
+ command.
isolate [NAME]
@@ -469,7 +532,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
@@ -569,7 +632,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
@@ -641,7 +704,7 @@
.
- This command honours
+ This command honors
,
,
in a similar
@@ -700,7 +763,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
@@ -756,7 +819,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
@@ -881,8 +944,8 @@
users. If
combined with
shutdown of all running services is
- skipped, however all processes killed
- and all file systems unmounted or
+ skipped, however all processes are killed
+ and all file systems are unmounted or
mounted read-only, immediately
followed by the
system halt.
@@ -898,8 +961,8 @@
users. If
combined with
shutdown of all running services is
- skipped, however all processes killed
- and all file systems unmounted or
+ skipped, however all processes are killed
+ and all file systems are unmounted or
mounted read-only, immediately
followed by the
powering off.
@@ -915,8 +978,8 @@
users. If
combined with
shutdown of all running services is
- skipped, however all processes killed
- and all file systems unmounted or
+ skipped, however all processes are killed
+ and all file systems are unmounted or
mounted read-only, immediately
followed by the
reboot.
@@ -931,8 +994,8 @@
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
+ skipped, however all processes are killed
+ and all file systems are unmounted or
mounted read-only, immediately
followed by the
reboot.