X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd-install.xml;h=228a9169990b6360e4cf1e8d7f8cc2e1697f8183;hp=c3ec4bdcd8f24988c459494340919dcbfebd5531;hb=9d8a57fff160cc14873ebcbc79a4216a18b42f70;hpb=72f957066d9ccc43699c813d0498fc7f6732a838
diff --git a/man/systemd-install.xml b/man/systemd-install.xml
index c3ec4bdcd..228a91699 100644
--- a/man/systemd-install.xml
+++ b/man/systemd-install.xml
@@ -55,6 +55,9 @@
systemd-install OPTIONSdisableNAME
+
+ systemd-install OPTIONSrealizeNAME
+ systemd-install OPTIONStestNAME
@@ -65,7 +68,8 @@
systemd-install enables or
disables systemd units, or checks whether they are
- enabled.
+ enabled, according to the installation suggestions
+ included in the unit files.
This command is useful to apply or undo the
installation instructions encoded in the [Install]
@@ -80,6 +84,15 @@
files in the configuration tree, but does not start
them. The latter equals starting them, but does not
necessarily require them to be enabled.
+
+ Note that while
+ systemd-install is the recommended
+ tool to create or remove symlinks in the systemd
+ configuration directory the administrator can also
+ create links there manually, which is particularly
+ useful to use configurations that deviate from the
+ installation suggestions included in the unit
+ files.
@@ -130,13 +143,14 @@
-
+ After
- enabling/disabling stop/restart the
- unit and reload manager
+ enabling/disabling stop/restart/stop
+ the unit and reload manager
configuration. Optionally, takes one
of ,
+ ,
,
or
. If
@@ -145,13 +159,17 @@
configuration and no service will be
started or stopped after
enabling/disabling of the unit
- files. If is
- passed and a unit is being enabled it
- will also be restarted should it
- already be running. If a unit is being
- disabled it will be stopped should it
- be running. In either case the
- daemon configuration is
+ files. If is
+ passed the daemon configuration is
+ reloaded but the unit otherwise not
+ started/stopped/restarted. If
+ is passed and
+ a unit is being enabled it will also
+ be restarted should it already be
+ running. If a unit is being disabled
+ it will be stopped should it be
+ running. In either case the daemon
+ configuration is
reloaded. is
similar to this, but the unit will
also be started if it is being enabled
@@ -163,14 +181,42 @@
starts the unit
unconditionally after enabling. This
setting defaults to
- . If the mode value
- is omitted defaults to
- . This option
+ . If
+ is
+ specifieed but the mode value is
+ omitted defaults to
+ . This option
has no effect when
or
- test is
- used.
+ test is used, or
+ when systemd is not running or the
+ command is executed in a
+ chroot2
+ environment. This option is implied if
+ the realize command
+ is used.
+
+
+
+
+
+ If set makes sure that
+ all symlinks on the specified unit are
+ removed from the configuration
+ directory and its subdirectories, not
+ just those specified in the
+ [Install]
+ section.
+
+
+
+
+
+
+ Show what is done as
+ it is done.
+
The following commands are understood:
@@ -179,9 +225,9 @@
enable
- Enable a unit. This
- will create a number of symlinks as
- encoded in the
+ Enable one or more
+ units. This will create a number of
+ symlinks as encoded in the
[Install] section
of a unit file.
@@ -189,24 +235,51 @@
disable
- Disable a unit. This
- will remove a number of symlinks as
- encoded in the
+ Disable or more
+ units. This will remove a number of
+ symlinks as encoded in the
[Install] section
of a unit file.
+
+ realize
+
+ Does not enable or
+ disable any unit. Checks whether any
+ of the units specified are enabled,
+ and then starts/stops/restarts the
+ units accordingly. This will check for
+ the existence of a number of symlinks
+ as encoded in the
+ [Install] section
+ of a unit file, and then executes the
+ action normally specified by
+ . If
+ is not
+ specified implies
+ mode. To
+ override this mode specify
+ in
+ addition to
+ realize.
+
+
test
- Checks whether any of
- the units specified are
- installed. This will check for the
+ Does not enable or
+ disable any unit. Checks whether any
+ of the units specified are
+ enabled. This will check for the
existence of a number of symlinks as
encoded in the
[Install] section
- of a unit file.
+ of a unit file, and return with an
+ exit code of 0 if a unit is enabled, 1
+ otherwise.
+