X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemctl.xml;h=50e6bc93f2ce5c725cb7a5b8fca79b9dc896e91d;hb=ffd8644641d32abf2b6aac03feea7e7c1eed9348;hp=8a0f65181d766a4626bdb231a7d4c12b21fd6fcd;hpb=507e28d844e335fe9fc84b549577fcce398f3a5d;p=elogind.git
diff --git a/man/systemctl.xml b/man/systemctl.xml
index 8a0f65181..50e6bc93f 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -3,22 +3,22 @@
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
.
Note that any After= dependency is
automatically mirrored to create a
Before= dependency. Temporal dependencies
- may be specified explictly, but are also created implicitly
+ may be specified explicitly, but are also created implicitly
for units which are WantedBy= targets
(see
systemd.target5),
@@ -321,15 +321,6 @@ along with systemd; If not, see .
-
-
-
-
- Do not print the legend, i.e. the column headers and
- the footer with hints.
-
-
-
@@ -386,7 +377,6 @@ along with systemd; If not, see .
querying the user for authentication for privileged
operations.
-
@@ -482,7 +472,7 @@ along with systemd; If not, see .
When used with enable,
- disable,
+ disable, edit,
(and related commands), make changes only temporarily, so
that they are lost on the next reboot. This will have the
effect that changes are not made in subdirectories of
@@ -548,9 +538,10 @@ along with systemd; If not, see .
+
+
-
@@ -992,6 +983,56 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
+
+ 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 the preset
+ policy files. This has the same effect as
+ disable or enable,
+ depending how the unit is listed in the preset files.
+
+ Use to control
+ whether units shall be enabled and disabled, or only
+ enabled, or only disabled.
+
+ For more information on the preset policy format,
+ see
+ systemd.preset5.
+ For more information on the concept of presets, please
+ consult the Preset
+ document.
+
+
+
+
+ preset-all
+
+
+ Resets all installed unit files to the defaults
+ configured in the preset policy file (see above).
+
+ Use to control
+ whether units shall be enabled and disabled, or only
+ enabled, or only disabled.
+
+
+
is-enabled NAME...
@@ -1063,56 +1104,6 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
-
- 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 the preset
- policy files. This has the same effect as
- disable or enable,
- depending how the unit is listed in the preset files.
-
- Use to control
- whether units shall be enabled and disabled, or only
- enabled, or only disabled.
-
- For more information on the preset policy format,
- see
- systemd.preset5.
- For more information on the concept of presets, please
- consult the Preset
- document.
-
-
-
-
- preset-all
-
-
- Resets all installed unit files to the defaults
- configured in the preset policy file (see above).
-
- Use to control
- whether units shall be enabled and disabled, or only
- enabled, or only disabled.
-
-
-
mask NAME...
@@ -1139,6 +1130,20 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
+
+ link FILENAME...
+
+
+ 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
+ is not installed directly in the unit search path.
+
+
+
add-wants TARGETNAME...
@@ -1159,16 +1164,39 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
- link FILENAME...
+ edit 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
- is not installed directly in the unit search path.
+ Edit a drop-in snippet or a whole replacement file if
+ is specified, to extend or override the
+ specified unit.
+
+ Depending on whether (the default),
+ , or is specified,
+ this creates a drop-in file for each unit either for the system,
+ for the calling user or for all futures logins of all users. Then,
+ the editor (see the "Environment" section below) is invoked on
+ temporary files which will be written to the real location if the
+ editor exits successfully.
+
+ If is specified, this will copy the
+ original units instead of creating drop-in files.
+
+ If is specified, the changes will
+ be made temporarily in /run and they will be
+ lost on the next reboot.
+
+ If the temporary file is empty upon exit the modification of
+ the related unit is canceled
+
+ After the units have been edited, systemd configuration is
+ reloaded (in a way that is equivalent to daemon-reload).
+
+
+ Note that this command cannot be used to remotely edit units
+ and that you cannot temporarily edit units which are in
+ /etc since they take precedence over
+ /run.
@@ -1176,8 +1204,9 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
get-default
- Get the default target specified
- via default.target link.
+ Return the default target to boot into. This returns
+ the target unit name default.target
+ is aliased (symlinked) to.
@@ -1185,10 +1214,12 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
set-default NAME
- Set the default target to boot into. Command links
- default.target to the given unit.
+ Set the default target to boot into. This sets
+ (symlinks) the default.target alias
+ to the given target unit.
+
@@ -1310,7 +1341,10 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
- import-environment VARIABLE...
+
+ import-environment
+ VARIABLE...
+ Import all, one or more environment variables set on
@@ -1333,12 +1367,16 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
daemon-reload
- Reload systemd manager configuration. This will reload
- all unit files and recreate the entire dependency
- tree. While the daemon is being reloaded, all sockets systemd
- listens on behalf of user configuration will stay
- accessible.This command should not be confused
- with the reload command.
+ Reload systemd manager configuration. This will
+ rerun all generators (see
+ systemd.generator7),
+ reload all unit files, and recreate the entire dependency
+ tree. While the daemon is being reloaded, all sockets
+ systemd listens on behalf of user configuration will stay
+ accessible.
+
+ This command should not be confused with the
+ reload command.
@@ -1510,6 +1548,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
firmware over the air update.
+
kexec
@@ -1523,6 +1562,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
immediately followed by the reboot.
+
exit
@@ -1532,8 +1572,29 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
with the option) and will fail
otherwise.
+
+
+
+ switch-root ROOTINIT
+
+ Switches to a different root directory and executes a
+ new system manager process below it. This is intended for
+ usage in initial RAM disks ("initrd"), and will transition
+ from the initrd's system manager process (a.k.a "init"
+ process) to the main system manager process. This call takes two
+ arguments: the directory that is to become the new root directory, and
+ the path to the new system manager binary below it to
+ execute as PID 1. If the latter is omitted or the empty
+ string, a systemd binary will automatically be searched for
+ and used as init. If the system manager path is omitted or
+ equal to the empty string, the state of the initrd's system
+ manager process is passed to the main system manager, which
+ allows later introspection of the state of the services
+ involved in the initrd boot.
+
+
suspend
@@ -1543,6 +1604,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
+
hibernate
@@ -1552,6 +1614,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
+
hybrid-sleep
@@ -1561,26 +1624,6 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
hybrid-sleep.target target.
-
- switch-root ROOTINIT
-
-
- Switches to a different root directory and executes a
- new system manager process below it. This is intended for
- usage in initial RAM disks ("initrd"), and will transition
- from the initrd's system manager process (a.k.a "init"
- process) to the main system manager process. This call takes two
- arguments: the directory that is to become the new root directory, and
- the path to the new system manager binary below it to
- execute as PID 1. If the latter is omitted or the empty
- string, a systemd binary will automatically be searched for
- and used as init. If the system manager path is omitted or
- equal to the empty string, the state of the initrd's system
- manager process is passed to the main system manager, which
- allows later introspection of the state of the services
- involved in the initrd boot.
-
-
@@ -1617,11 +1660,11 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
may match zero units and this is not considered an error.
Glob patterns use
- fnmatch3,
+ fnmatch3,
so normal shell-style globbing rules are used, and
*, ?,
[] may be used. See
- glob7
+ glob7
for more details. The patterns are matched against the names of
currently loaded units, and patterns which do not match anything
are silently skipped. For example:
@@ -1647,21 +1690,43 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
code otherwise.
-
+
+ Environment
+
+
+
+ $SYSTEMD_EDITOR
+
+ Editor to use when editing units; overrides
+ $EDITOR and $VISUAL. If neither
+ $SYSTEMD_EDITOR nor $EDITOR nor
+ $VISUAL are present or if it is set to an empty
+ string or if their execution failed, systemctl will try to execute well
+ known editors in this order:
+ nano1,
+ vim1,
+ vi1.
+
+
+
+
+
+ See Alsosystemd1,
- systemadm1,
journalctl1,
loginctl1,
+ machinectl1,
systemd.unit5,
- systemd.resource-management5,
+ systemd.resource-control5,
systemd.special7,
wall1,
- systemd.preset5
- glob7
+ systemd.preset5,
+ systemd.generator7,
+ glob7