summaryrefslogtreecommitdiff
path: root/man/systemd.unit.xml
diff options
context:
space:
mode:
authorFrantisek Sumsal <frantisek@sumsal.cz>2022-03-10 16:15:54 +0100
committerFrantisek Sumsal <frantisek@sumsal.cz>2022-03-10 19:03:22 +0100
commit6ceb0a4094908dd213a78b9f6d0c59a684831ab0 (patch)
tree4e1d6720898bf86ccb1f39a97b7f1ccca5a5c5a6 /man/systemd.unit.xml
parentb6e78cdde1a69377605ebdbb0ac106620f59515d (diff)
downloadsystemd-6ceb0a4094908dd213a78b9f6d0c59a684831ab0.tar.gz
core: introduce %R specifier for pretty hostname
Resolves: #20054
Diffstat (limited to 'man/systemd.unit.xml')
-rw-r--r--man/systemd.unit.xml9
1 files changed, 9 insertions, 0 deletions
diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index b20072f0a2..8f2f649747 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -2031,6 +2031,8 @@ Note that this setting is <emphasis>not</emphasis> influenced by the <varname>Us
</row>
<row>
<entry><literal>%l</literal></entry>
+ <!-- We do not use the common definition from standard-specifiers.xml here since we want a
+ slightly more verbose explanation here, referring to the reload cycle. -->
<entry>Short host name</entry>
<entry>The hostname of the running system at the point in time the unit configuration is loaded, truncated at the first dot to remove any domain component.</entry>
</row>
@@ -2063,6 +2065,13 @@ Note that this setting is <emphasis>not</emphasis> influenced by the <varname>Us
<entry>Same as <literal>%p</literal>, but with escaping undone.</entry>
</row>
<row>
+ <!-- We do not use the common definition from standard-specifiers.xml here since we want a
+ slightly more verbose explanation here, referring to the reload cycle. -->
+ <entry><literal>%R</literal></entry>
+ <entry>Pretty host name</entry>
+ <entry>The pretty hostname of the running system at the point in time the unit configuration is loaded, as read from the <varname>PRETTY_HOSTNAME=</varname> field of <filename>/etc/machine-info</filename>. If not set, resolves to the short hostname. See <citerefentry><refentrytitle>machine-info</refentrytitle><manvolnum>5</manvolnum></citerefentry> for more information.</entry>
+ </row>
+ <row>
<entry><literal>%s</literal></entry>
<entry>User shell</entry>
<entry>This is the shell of the user running the service manager instance. In case of the system manager this resolves to <literal>/bin/sh</literal>.</entry>