X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd-install.xml;h=03ed0c7449caad2fa2d1a253548b118dec3f7101;hp=c3ec4bdcd8f24988c459494340919dcbfebd5531;hb=ad780f1991d81c8013cc345488b9a035bf30aae7;hpb=72f957066d9ccc43699c813d0498fc7f6732a838 diff --git a/man/systemd-install.xml b/man/systemd-install.xml index c3ec4bdcd..03ed0c744 100644 --- a/man/systemd-install.xml +++ b/man/systemd-install.xml @@ -55,6 +55,9 @@ systemd-install OPTIONS disable NAME + + systemd-install OPTIONS realize NAME + systemd-install OPTIONS test NAME @@ -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,13 +181,20 @@ starts the unit unconditionally after enabling. This setting defaults to - . If the mode value - is omitted defaults to + . 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. @@ -179,9 +204,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 +214,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. +