]> git.ipfire.org Git - thirdparty/systemd.git/blob - man/standard-specifiers.xml
Merge pull request #32677 from keszybz/wording-fixes
[thirdparty/systemd.git] / man / standard-specifiers.xml
1 <?xml version="1.0"?>
2 <!DOCTYPE tbody PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
4 <!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
5
6 <tbody>
7 <!-- note: units also use the following deprecated specifiers that are not documented:
8 %c, %r, %R. Do not reuse. -->
9
10 <row id='a'>
11 <entry><literal>%a</literal></entry>
12 <entry>Architecture</entry>
13 <entry>A short string identifying the architecture of the local system. A string such as <constant>x86</constant>, <constant>x86-64</constant> or <constant>arm64</constant>. See the architectures defined for <varname>ConditionArchitecture=</varname> in <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry> for a full list.</entry>
14 </row>
15 <row id='A'>
16 <entry><literal>%A</literal></entry>
17 <entry>Operating system image version</entry>
18 <entry>The operating system image version identifier of the running system, as read from the <varname>IMAGE_VERSION=</varname> field of <filename>/etc/os-release</filename>. If not set, resolves to an empty string. See <citerefentry><refentrytitle>os-release</refentrytitle><manvolnum>5</manvolnum></citerefentry> for more information.</entry>
19 </row>
20 <row id='b'>
21 <entry><literal>%b</literal></entry>
22 <entry>Boot ID</entry>
23 <entry>The boot ID of the running system, formatted as string. See <citerefentry><refentrytitle>random</refentrytitle><manvolnum>4</manvolnum></citerefentry> for more information.</entry>
24 </row>
25 <row id='B'>
26 <entry><literal>%B</literal></entry>
27 <entry>Operating system build ID</entry>
28 <entry>The operating system build identifier of the running system, as read from the <varname>BUILD_ID=</varname> field of <filename>/etc/os-release</filename>. If not set, resolves to an empty string. See <citerefentry><refentrytitle>os-release</refentrytitle><manvolnum>5</manvolnum></citerefentry> for more information.</entry>
29 </row>
30 <row id='H'>
31 <entry><literal>%H</literal></entry>
32 <entry>Host name</entry>
33 <entry>The hostname of the running system.</entry>
34 </row>
35 <row id='l'>
36 <entry><literal>%l</literal></entry>
37 <entry>Short host name</entry>
38 <entry>The hostname of the running system, truncated at the first dot to remove any domain component.</entry>
39 </row>
40 <row id='m'>
41 <entry><literal>%m</literal></entry>
42 <entry>Machine ID</entry>
43 <entry>The machine ID of the running system, formatted as string. See <citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry> for more information.</entry>
44 </row>
45 <row id='M'>
46 <entry><literal>%M</literal></entry>
47 <entry>Operating system image identifier</entry>
48 <entry>The operating system image identifier of the running system, as read from the <varname>IMAGE_ID=</varname> field of <filename>/etc/os-release</filename>. If not set, resolves to an empty string. See <citerefentry><refentrytitle>os-release</refentrytitle><manvolnum>5</manvolnum></citerefentry> for more information.</entry>
49 </row>
50 <row id='o'>
51 <entry><literal>%o</literal></entry>
52 <entry>Operating system ID</entry>
53 <entry>The operating system identifier of the running system, as read from the <varname>ID=</varname> field of <filename>/etc/os-release</filename>. See <citerefentry><refentrytitle>os-release</refentrytitle><manvolnum>5</manvolnum></citerefentry> for more information.</entry>
54 </row>
55 <row id='q'>
56 <entry><literal>%q</literal></entry>
57 <entry>Pretty host name</entry>
58 <entry>The pretty hostname of the running system, 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>
59 </row>
60 <row id='T'>
61 <entry><literal>%T</literal></entry>
62 <entry>Directory for temporary files</entry>
63 <entry>This is either <filename>/tmp<!-- no / --></filename> or the path <literal>$TMPDIR</literal>, <literal>$TEMP</literal> or <literal>$TMP</literal> are set to. (Note that the directory may be specified without a trailing slash.)</entry>
64 </row>
65 <row id='v'>
66 <entry><literal>%v</literal></entry>
67 <entry>Kernel release</entry>
68 <entry>Identical to <command>uname -r</command> output.</entry>
69 </row>
70 <row id='V'>
71 <entry><literal>%V</literal></entry>
72 <entry>Directory for larger and persistent temporary files</entry>
73 <entry>This is either <filename>/var/tmp<!-- no / --></filename> or the path <literal>$TMPDIR</literal>, <literal>$TEMP</literal> or <literal>$TMP</literal> are set to. (Note that the directory may be specified without a trailing slash.)</entry>
74 </row>
75 <row id='w'>
76 <entry><literal>%w</literal></entry>
77 <entry>Operating system version ID</entry>
78 <entry>The operating system version identifier of the running system, as read from the <varname>VERSION_ID=</varname> field of <filename>/etc/os-release</filename>. If not set, resolves to an empty string. See <citerefentry><refentrytitle>os-release</refentrytitle><manvolnum>5</manvolnum></citerefentry> for more information.</entry>
79 </row>
80 <row id='W'>
81 <entry><literal>%W</literal></entry>
82 <entry>Operating system variant ID</entry>
83 <entry>The operating system variant identifier of the running system, as read from the <varname>VARIANT_ID=</varname> field of <filename>/etc/os-release</filename>. If not set, resolves to an empty string. See <citerefentry><refentrytitle>os-release</refentrytitle><manvolnum>5</manvolnum></citerefentry> for more information.</entry>
84 </row>
85 <row id='percent'>
86 <entry><literal>%%</literal></entry>
87 <entry>Single percent sign</entry>
88 <entry>Use <literal>%%</literal> in place of <literal>%</literal> to specify a single percent sign.</entry>
89 </row>
90 </tbody>