X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-install.xml;h=28415d19e11cf3283813f4c78dbc9b7a7013d8e6;hb=73c33e7f225f81e6066386fba997e8ea2ba361b3;hp=9881e9819e29bc22b540abce5af3d5cb0bad9f22;hpb=359957ee23e8dad97f6c75969d7ecfe4d3c4369f;p=elogind.git
diff --git a/man/systemd-install.xml b/man/systemd-install.xml
index 9881e9819..28415d19e 100644
--- a/man/systemd-install.xml
+++ b/man/systemd-install.xml
@@ -21,7 +21,7 @@
along with systemd; If not, see .
-->
-
+systemd-install
@@ -50,13 +50,13 @@
- systemd-install optionsname
+ systemd-install OPTIONSenableNAME
- systemd-install optionsname
+ systemd-install OPTIONSdisableNAME
- systemd-install optionsname
+ systemd-install OPTIONStestNAME
@@ -67,18 +67,36 @@
disables systemd units, or checks whether they are
enabled.
+ This command is useful to apply or undo the
+ installation instructions encoded in the [Install]
+ section of unit files. See
+ systemd.unit5
+ for more information.
+
+ Enabling units (as with systemd-install
+ enable) should not be confused with
+ activating units (as with systemctl
+ start). The former simply installs the unit
+ files in the configuration tree, but does not start
+ them. The latter equals starting them, but does not
+ necessarily require them to be enabled.
+
+
+
+ Options
+
The following options are understood:
- --help
+ Prints a short help
text and exits.
- --force
+ Enable/disable a
service even if it conflicts
@@ -89,14 +107,14 @@
- --system
+ Enable/disable a
system service.
- --session
+ Enable/disable a
session service for the calling
@@ -104,44 +122,98 @@
- --global
+ Enable/disable a
session service for all
users.
+
+
+
+
+ After
+ enabling/disabling stop/restart/stop
+ the unit and reload manager
+ configuration. Optionally, takes one
+ of ,
+ ,
+ ,
+ or
+ . If
+ is passed the
+ manager will not reload its
+ configuration and no service will be
+ started or stopped after
+ enabling/disabling of the unit
+ 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
+ and any of the units listed in
+ WantedBy= in the
+ [Install] section
+ of the unit file is already
+ activated. Finally
+ starts the unit
+ unconditionally after enabling. This
+ setting defaults to
+ . If the mode value
+ is omitted defaults to
+ . This option
+ has no effect when
+ or
+ test is used, or
+ when systemd is not running or the
+ command is executed in a
+ chroot2
+ environment.
+
- The following verbs are understood:
+ The following commands are understood:
- enable
+ enableEnable a unit. This
will create a number of symlinks as
- encoded in the [Install] section of a
- unit file.
+ encoded in the
+ [Install] section
+ of a unit file.
- disable
+ disableDisable a unit. This
- will removed a number of symlinks as
- encoded in the [Install] section of a
- unit file.
+ will remove a number of symlinks as
+ encoded in the
+ [Install] section
+ of a unit file.
- test
+ testChecks whether any of
the units specified are
installed. This will check for the
- existance of a number of symlinks as
- encoded in the [Install] section of a
- unit file.
+ existence of a number of symlinks as
+ encoded in the
+ [Install] section
+ of a unit file.
@@ -157,6 +229,7 @@
See Also
+ systemd1,
systemctl1,
systemd.unit5