diff options
| author | Lennart Poettering <lennart@poettering.net> | 2012-06-22 16:24:57 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2012-06-22 16:24:57 +0200 |
| commit | 8ff290af3b7db00eef76bdec61fee4aca7d84d0b (patch) | |
| tree | f378f2089f6582f1a15a45134827b130b9bdce89 /man/systemd.unit.xml | |
| parent | a3a3e5b6ae7836152052d77a9e6032a9e84e2039 (diff) | |
unit: drop the Names= option
Names= is a source of errors, simply because alias names specified like
this only become relevant after a unit has been loaded but cannot be
used to load a unit.
Let's get rid of the confusion and drop this field. To establish alias
names peope should use symlinks, which have the the benefit of being
useful as key to load a unit, even though they are not taken into
account if unit names are listed but they haven't been explicitly
referenced before.
Diffstat (limited to 'man/systemd.unit.xml')
| -rw-r--r-- | man/systemd.unit.xml | 54 |
1 files changed, 1 insertions, 53 deletions
diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index 123965bd44..93fb37b72b 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -870,35 +870,6 @@ </varlistentry> <varlistentry> - <term><varname>Names=</varname></term> - - <listitem><para>Additional names for - this unit. The names listed here must - have the same suffix (i.e. type) as - the unit file name. This option may be - specified more than once, in which - case all listed names are used. Note - that this option is different from the - <varname>Alias=</varname> option from - the [Install] section mentioned - below. See below for details. Note - that in almost all cases this option - is not what you want. A symlink alias - in the file system is generally - preferable since it can be used as - lookup key. If a unit with a symlinked - alias name is not loaded and needs to - be it is easily found via the - symlink. However, if a unit with an - alias name configured with this - setting is not loaded it will not be - discovered. This settings' only use is - in conjunction with service - instances.</para> - </listitem> - </varlistentry> - - <varlistentry> <term><varname>SourcePath=</varname></term> <listitem><para>A path to a configuration file this unit has been @@ -936,30 +907,7 @@ time, <command>systemctl enable</command> will create symlinks from these names - to the unit file name. Note that this - is different from the - <varname>Names=</varname> option from - the [Unit] section mentioned above: - The names from - <varname>Names=</varname> apply - unconditionally if the unit is - loaded. The names from - <varname>Alias=</varname> apply only - if the unit has actually been - installed with the - <command>systemctl enable</command> - command. Also, if systemd searches for a - unit, it will discover symlinked alias - names as configured with - <varname>Alias=</varname>, but not - names configured with - <varname>Names=</varname> only. It is - a common pattern to list a name in - both options. In this case, a unit - will be active under all names if - installed, but also if not installed - but requested explicitly under its - main name.</para></listitem> + to the unit file name.</para></listitem> </varlistentry> <varlistentry> |