X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.preset.xml;h=1ba9272398e33c1f0fdf5b0d7a6d9c756efa1115;hb=ee2babf4c36f9ab65e9ebbe966ed7839c532df45;hp=21de5293666508a086936adde222b7ae656fdefb;hpb=75d67e683735035949bfdcf71140747b9909d8a1;p=elogind.git diff --git a/man/systemd.preset.xml b/man/systemd.preset.xml index 21de52936..1ba927239 100644 --- a/man/systemd.preset.xml +++ b/man/systemd.preset.xml @@ -58,7 +58,7 @@ Description Preset files may be used to encode policy which - services shall be enabled by default and which ones + units shall be enabled by default and which ones shall be disabled. They are read by systemctl preset (for more information see systemctl1) @@ -72,9 +72,14 @@ set of units to be enabled/disabled even before installing the actual package. + For more information on the preset logic please + have a look at the Presets + document. + It is not recommended to ship preset files within the respective software packages implementing - the services, but rather centralize them in a + the units, but rather centralize them in a distribution or spin default policy, which can be amended by administrator policy. @@ -104,7 +109,7 @@ by default, disable to disable units by default. - If multiple lines apply to a unit name the + If multiple lines apply to a unit name, the first matching one takes precedence over all others. @@ -126,14 +131,14 @@ precedence over another file with an alphabetically earlier name, if both files contain lines that apply to the same unit names. It is recommended to prefix - all file names with two-digit number, to simplify + all filenames with two-digit number, to simplify ordering. If the administrator wants to disable a preset - file supplied by the vendor the recommended way is to + file supplied by the vendor, the recommended way is to place a symlink to /dev/null in /etc/systemd/system-preset/ - bearing the same file name. + bearing the same filename. @@ -145,8 +150,8 @@ disable * - This disables all units. Due to the file name - prefix 99- it will be read last and + This disables all units. Due to the filename + prefix 99-, it will be read last and hence can easily be overridden by spin or administrator preset policy or suchlike. @@ -182,7 +187,7 @@ disable * This enables three specific services and disables all others. This is useful for administrators to specifically select the units to enable, and - disable all others. Due to the file name prefix + disable all others. Due to the filename prefix 00- it will be read early and hence overrides all other preset policy files.