X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemctl.xml;h=3266333be1b41b80174508f2758c4a2941780740;hb=2d44fc7ba5aaf700672baa7b0697caefddafdc53;hp=d37a7d95dc23e461272d442e07765df98fbf297d;hpb=e67c3609b18ab09499b361e18addfcfdec853fdd;p=elogind.git
diff --git a/man/systemctl.xml b/man/systemctl.xml
index d37a7d95d..3266333be 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -102,7 +102,7 @@
When showing
- unit/job/manager information, limit
+ unit/job/manager properties, limit
display to certain properties as
specified as argument. If not
specified all set properties are
@@ -121,7 +121,7 @@
When listing units,
show all units, regardless of their
state, including inactive units. When
- showing unit/job/manager information,
+ showing unit/job/manager properties,
show all properties regardless whether
they are set or not.
@@ -194,7 +194,16 @@
enqueued and systemctl will
wait until it is completed. By passing this
argument it is only verified and
- enqueued.
+ enqueued.
+
+
+
+
+
+ Do not print a legend, i.e.
+ the column headers and the footer with hints.
+
+
@@ -297,27 +306,6 @@
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 omitted
- defaults to
- if
- is
- set, or
- otherwise. You probably never need to
- use this switch.
-
-
@@ -361,26 +349,70 @@
halt,
poweroff,
reboot or
- kexec execute
+ kexec execute the
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.
+ immediate reboot. If
+ is specified
+ twice for these operations, they will
+ be executed immediately without
+ terminating any processes or umounting
+ any file systems. Warning: specifying
+ twice with
+ any of these operations might result
+ in data loss.
-
+ When used with
- disable, ensures
- that only the symlinks created by
- enable are removed,
- not all symlinks pointing to the unit
- file that shall be
- disabled.
+ enable/disable/is-enabled (and
+ related commands), use alternative
+ root path when looking for unit
+ files.
+
+
+
+
+
+ When used with
+ enable/disable/is-enabled (and related commands), make
+ changes only temporarily, so that they
+ are dropped on the next reboot. This
+ will have the effect that changes are
+ not made in subdirectories of
+ /etc but in
+ /run, with
+ identical immediate effects, however,
+ since the latter is lost on reboot,
+ the changes are lost
+ too.
+
+
+
+
+
+
+ Execute operation
+ remotely. Specify a hostname, or
+ username and hostname separated by @,
+ to connect to. This will use SSH to
+ talk to the remote systemd
+ instance.
+
+
+
+
+
+
+ Acquire privileges via
+ PolicyKit before executing the
+ operation.
@@ -447,9 +479,9 @@
Restart one or more
units specified on the command
- line. If the units are not running yet
- the operation will
- fail. Note that for compatibility
+ 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.
@@ -468,12 +500,13 @@
Reload one or more
units if they support it. If not,
- restart them instead. If the units
- are not running yet the operation
- will fail. Note that for
- compatibility with SysV init scripts
+ 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.
+ equivalent to this
+ command.
isolate [NAME]
@@ -577,6 +610,13 @@
command.
+
+ list-unit-files
+
+ List installed unit files.
+
+
+
enable [NAME...]
@@ -661,14 +701,11 @@
configuration directory, and hence
undoes the changes made by
enable. Note
- however that this by default removes
+ however that this removes
all symlinks to the unit files
(i.e. including manual additions), not
just those actually created by
- enable. If only the
- symlinks that are suggested by default
- shall be removed, pass
- . This
+ enable. This call
implicitly reloads the systemd daemon
configuration after completing the
disabling of the units. Note that this
@@ -700,8 +737,85 @@
(as with
enable). Returns an
exit code of 0 if at least one is
- enabled, non-zero
- otherwise.
+ enabled, non-zero otherwise. Prints
+ the current enable status. To suppress
+ this output use
+ .
+
+
+
+ reenable [NAME...]
+
+ Reenable one or more
+ unit files, as specified on the
+ command line. This is a combination of
+ disable and
+ enable and is
+ useful to reset the symlinks a unit is
+ enabled with to the defaults
+ configured in the
+ [Install] section
+ of the unit file.
+
+
+
+
+ preset [NAME...]
+
+ Reset one or more unit
+ files, as specified on the command
+ line, to the defaults configured in a
+ preset file. This has the same effect
+ as disable or
+ enable, depending
+ how the unit is listed in the preset
+ files.
+
+
+
+
+ mask [NAME...]
+
+ Mask one or more unit
+ files, as specified on the command
+ line. This will link these units to
+ /dev/null, making
+ it impossible to start them. This is a stronger version
+ of disable, since
+ it prohibits all kinds of activation
+ of the unit, including manual
+ activation. Use this option with
+ care.
+
+
+
+
+ unmask [NAME...]
+
+ Unmask one or more
+ unit files, as specified on the
+ command line. This will undo the
+ effect of
+ mask.
+
+
+
+
+ link [NAME...]
+
+ Link a unit file that
+ is not in the unit file search paths
+ into the unit file search path. This
+ requires an absolute path to a unit
+ file. The effect of this can be undone
+ with disable. The
+ effect of this command is that a unit
+ file is available for
+ start and other
+ commands although it isn't installed
+ directly in the unit search
+ path.
+
@@ -745,16 +859,6 @@
their numeric job
IDs. If no job id is specified, cancel all pending jobs.
-
- monitor
-
- Monitor unit/job
- changes. This is mostly useful for
- debugging purposes and prints a line
- each time systemd loads or unloads a
- unit configuration file, or a unit
- property changes.
- dump
@@ -921,14 +1025,19 @@
system. This is mostly equivalent to
start halt.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
+ 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.
+ followed by the system halt. If
+ is specified
+ twice the the operation is immediately
+ executed without terminating any
+ processes or unmounting any file
+ systems. This may result in data
+ loss.
poweroff
@@ -937,32 +1046,40 @@
power-off the system. This is mostly
equivalent to start
poweroff.target but also
- prints a wall message to all
- users. If
+ 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
- powering off.
+ skipped, however all processes are
+ killed and all file systems are
+ unmounted or mounted read-only,
+ immediately followed by the powering
+ off. If is
+ specified twice the the operation is
+ immediately executed without
+ terminating any processes or
+ unmounting any file systems. This may
+ result in data loss.
reboot
- Shut down and
- reboot the system. This is mostly
- equivalent to start
+ Shut down and reboot
+ the system. This is mostly equivalent
+ to start
reboot.target but also
- prints a wall message to all
- users. If
+ 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.
+ skipped, however all processes are
+ killed and all file systems are
+ unmounted or mounted read-only,
+ immediately followed by the reboot. If
+ is specified
+ twice the the operation is immediately
+ executed without terminating any
+ processes or unmounting any file
+ systems. This may result in data
+ loss.kexec
@@ -1001,11 +1118,28 @@
code otherwise.
+
+ Environment
+
+
+
+ $SYSTEMD_PAGER
+ Pager to use when
+ is not given;
+ overrides $PAGER. Setting
+ this to an empty string or the value
+ cat is equivalent to passing
+ .
+
+
+
+
See Alsosystemd1,
systemadm1,
+ systemd-loginctl1,
systemd.unit5,
systemd.special7,
wall1