mirrors/systemd
0
0
Fork 0
mirror of https://github.com/systemd/systemd.git synced 2024-11-23 02:03:37 +08:00
Code Issues Packages Projects Releases Wiki Activity

man: drop whitespace from final <programlisting> lines

Browse Source 
In the troff output, this doesn't seem to make any difference. But in the
html output, the whitespace is sometimes preserved, creating an additional
gap before the following content. Drop it everywhere to avoid this.
This commit is contained in:
Zbigniew Jędrzejewski-Szmek 2024-11-07 16:47:48 +01:00
parent 56f9a56a6f
commit fe45f8dc9b
44 changed files with 146 additions and 145 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
man/environment.d.xml
View File

@ -86,7 +86,7 @@
PATH=/opt/foo/bin:$PATH
LD_LIBRARY_PATH=/opt/foo/lib${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}
XDG_DATA_DIRS=/opt/foo/share:${XDG_DATA_DIRS:-/usr/local/share/:/usr/share/}
</programlisting>
</programlisting>
</example>
</refsect2>
</refsect1>

2
man/libsystemd.xml
View File

@ -36,7 +36,7 @@
#include &lt;systemd/sd-messages.h&gt;
#include &lt;systemd/sd-path.h&gt;
#include &lt;systemd/sd-varlink.h&gt;
</programlisting>
</programlisting>
<cmdsynopsis>
<command>pkg-config --cflags --libs libsystemd</command>

4
man/loader.conf.xml
View File

@ -362,7 +362,7 @@ attr=NON_VOLATILE,RUNTIME_ACCESS,BOOTSERVICE_ACCESS,TIME_BASED_AUTHENTICATED_WRI
sbvarsign --attr "${attr}" --key PK.key --cert PK.pem --output PK.auth PK PK.esl
sbvarsign --attr "${attr}" --key PK.key --cert PK.pem --output KEK.auth KEK KEK.esl
sbvarsign --attr "${attr}" --key KEK.key --cert KEK.pem --output db.auth db db.esl
</programlisting>
</programlisting>
<para>This feature is considered dangerous because even if all the required files are signed with the
keys being loaded, some files necessary for the system to function properly still won't be. This
@ -409,7 +409,7 @@ sbvarsign --attr "${attr}" --key KEK.key --cert KEK.pem --output db.auth db db.e
timeout 0
default 01234567890abcdef1234567890abdf0-*
editor no
</programlisting>
</programlisting>
<para>The menu will not be shown by default (the menu can still be shown by
pressing and holding a key during boot). One of the entries with files with a

2
man/org.freedesktop.LogControl1.xml
View File

@ -55,7 +55,7 @@ node /org/freedesktop/LogControl1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->

6
man/org.freedesktop.home1.xml
View File

@ -125,7 +125,7 @@ node /org/freedesktop/home1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -337,7 +337,7 @@ node /org/freedesktop/home1 {
can be used to further customize the behavior of this method via flags defined as follows:</para>
<programlisting>
#define SD_HOMED_UPDATE_OFFLINE (UINT64_C(1) &lt;&lt; 0)
</programlisting>
</programlisting>
<para>When <constant>SD_HOMED_UPDATE_OFFLINE</constant> (0x01) is set, no attempt is made to update the copies
of the user record and blob directory that are embedded into the home directory. Changes will be stored, however,
and may be propagated into the home directory the next time it is reconciled (most likely when the user next logs in).
@ -495,7 +495,7 @@ node /org/freedesktop/home1/home {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.DBus.ObjectManager { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->

4
man/org.freedesktop.hostname1.xml
View File

@ -106,7 +106,7 @@ node /org/freedesktop/hostname1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -436,7 +436,7 @@ node /org/freedesktop/hostname1 {
<programlisting>$ gdbus introspect --system \
--dest org.freedesktop.hostname1 \
--object-path /org/freedesktop/hostname1
</programlisting>
</programlisting>
</example>
</refsect1>

8
man/org.freedesktop.import1.xml
View File

@ -155,7 +155,7 @@ node /org/freedesktop/import1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -362,7 +362,7 @@ node /org/freedesktop/import1/transfer/_1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -439,7 +439,7 @@ node /org/freedesktop/import1/transfer/_1 {
<programlisting>$ gdbus introspect --system \
--dest org.freedesktop.import1 \
--object-path /org/freedesktop/import1
</programlisting>
</programlisting>
</example>
<example>
@ -448,7 +448,7 @@ node /org/freedesktop/import1/transfer/_1 {
<programlisting>$ gdbus introspect --system \
--dest org.freedesktop.import1 \
--object-path /org/freedesktop/import1/transfer/_1
</programlisting>
</programlisting>
</example>
</refsect1>

4
man/org.freedesktop.locale1.xml
View File

@ -63,7 +63,7 @@ node /org/freedesktop/locale1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -175,7 +175,7 @@ node /org/freedesktop/locale1 {
$ gdbus introspect --system \
--dest org.freedesktop.locale1 \
--object-path /org/freedesktop/locale1
</programlisting>
</programlisting>
</example>
</refsect1>

26
man/org.freedesktop.login1.xml
View File

@ -289,7 +289,7 @@ node /org/freedesktop/login1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--property SleepOperation is not documented!-->
@ -673,7 +673,7 @@ node /org/freedesktop/login1 {
#define SD_LOGIND_SOFT_REBOOT (UINT64_C(1) &lt;&lt; 2)
#define SD_LOGIND_SOFT_REBOOT_IF_NEXTROOT_SET_UP (UINT64_C(1) &lt;&lt; 3)
#define SD_LOGIND_SKIP_INHIBITORS (UINT64_C(1) &lt;&lt; 4)
</programlisting>
</programlisting>
<para>When the <varname>flags</varname> is 0 then these methods behave just like the versions without
flags. Since systemd version 257 active inhibitors are honoured by default for privileged users too.
<constant>SD_LOGIND_ROOT_CHECK_INHIBITORS</constant> (0x01) now only applies to weak inhibitors, to
@ -945,7 +945,7 @@ node /org/freedesktop/login1/seat/seat0 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -1065,7 +1065,7 @@ node /org/freedesktop/login1/user/_1000 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -1260,7 +1260,7 @@ node /org/freedesktop/login1/session/1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -1566,12 +1566,12 @@ node /org/freedesktop/login1/session/1 {
<programlisting>$ gdbus introspect --system --dest org.freedesktop.login1 \
--object-path /org/freedesktop/login1
</programlisting>
</programlisting>
<para>or</para>
<programlisting>$ busctl introspect org.freedesktop.login1 /org/freedesktop/login1
</programlisting>
</programlisting>
</example>
<example>
@ -1579,12 +1579,12 @@ node /org/freedesktop/login1/session/1 {
<programlisting>$ gdbus introspect --system --dest org.freedesktop.login1 \
--object-path /org/freedesktop/login1/seat/seat0
</programlisting>
</programlisting>
<para>or</para>
<programlisting>$ busctl introspect org.freedesktop.login1 /org/freedesktop/login1/seat/seat0
</programlisting>
</programlisting>
<para>Seat <literal>seat0</literal> is the default seat, so it'll be present unless local configuration
is made to reassign all devices to a different seat. The list of seats and users can be acquired with
@ -1596,12 +1596,12 @@ node /org/freedesktop/login1/session/1 {
<programlisting>$ gdbus introspect --system --dest org.freedesktop.login1 \
--object-path /org/freedesktop/login1/user/_1000
</programlisting>
</programlisting>
<para>or</para>
<programlisting>$ busctl introspect org.freedesktop.login1 /org/freedesktop/login1/user/_1000
</programlisting>
</programlisting>
</example>
<example>
@ -1609,12 +1609,12 @@ node /org/freedesktop/login1/session/1 {
<programlisting>$ gdbus introspect --system --dest org.freedesktop.login1 \
--object-path /org/freedesktop/login1/session/45
</programlisting>
</programlisting>
<para>or</para>
<programlisting>$ busctl introspect org.freedesktop.login1 /org/freedesktop/login1/session/45
</programlisting>
</programlisting>
</example>
</refsect1>

8
man/org.freedesktop.machine1.xml
View File

@ -183,7 +183,7 @@ node /org/freedesktop/machine1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--method UnregisterMachine is not documented!-->
@ -531,7 +531,7 @@ node /org/freedesktop/machine1/machine/rawhide {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--method GetUIDShift is not documented!-->
@ -687,7 +687,7 @@ node /org/freedesktop/machine1/machine/rawhide {
$ gdbus introspect --system \
--dest org.freedesktop.machine1 \
--object-path /org/freedesktop/machine1
</programlisting>
</programlisting>
</example>
<example>
@ -697,7 +697,7 @@ $ gdbus introspect --system \
$ gdbus introspect --system \
--dest org.freedesktop.machine1 \
--object-path /org/freedesktop/machine1/machine/rawhide
</programlisting>
</programlisting>
</example>
</refsect1>

16
man/org.freedesktop.network1.xml
View File

@ -94,7 +94,7 @@ node /org/freedesktop/network1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--method ListLinks is not documented!-->
@ -270,7 +270,7 @@ node /org/freedesktop/network1/link/_1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--method SetNTP is not documented!-->
@ -407,7 +407,7 @@ node /org/freedesktop/network1/network/_1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--property Description is not documented!-->
@ -464,7 +464,7 @@ node /org/freedesktop/network1/link/_1 {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.network1.Link { ... };
};
</programlisting>
</programlisting>
<!--property Leases is not documented!-->
@ -501,7 +501,7 @@ node /org/freedesktop/network1/link/_1 {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.network1.Link { ... };
};
</programlisting>
</programlisting>
<!--property State is not documented!-->
@ -538,7 +538,7 @@ node /org/freedesktop/network1/link/_1 {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.network1.Link { ... };
};
</programlisting>
</programlisting>
<!--property State is not documented!-->
@ -571,7 +571,7 @@ node /org/freedesktop/network1/link/_1 {
$ gdbus introspect --system \
--dest org.freedesktop.network1 \
--object-path /org/freedesktop/network1
</programlisting>
</programlisting>
</example>
<example>
@ -581,7 +581,7 @@ $ gdbus introspect --system \
$ gdbus introspect --system \
--dest org.freedesktop.network1 \
--object-path /org/freedesktop/network1/link/_11
</programlisting>
</programlisting>
</example>
</refsect1>

2
man/org.freedesktop.oom1.xml
View File

@ -47,7 +47,7 @@ node /org/freedesktop/oom1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--method DumpByFileDescriptor is not documented!-->

6
man/org.freedesktop.portable1.xml
View File

@ -117,7 +117,7 @@ node /org/freedesktop/portable1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -329,7 +329,7 @@ node /org/freedesktop/portable1 {
#define SD_SYSTEMD_PORTABLE_RUNTIME (UINT64_C(1) &lt;&lt; 0)
#define SD_SYSTEMD_PORTABLE_FORCE_ATTACH (UINT64_C(1) &lt;&lt; 1)
#define SD_SYSTEMD_PORTABLE_FORCE_EXTENSION (UINT64_C(1) &lt;&lt; 2)
</programlisting>
</programlisting>
</refsect2>
<refsect2>
@ -428,7 +428,7 @@ node /org/freedesktop/portable1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--method GetOSRelease is not documented!-->

8
man/org.freedesktop.resolve1.xml
View File

@ -154,7 +154,7 @@ node /org/freedesktop/resolve1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -705,7 +705,7 @@ node /org/freedesktop/resolve1/link/_1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -920,7 +920,7 @@ node /org/freedesktop/resolve1/link/_1 {
$ gdbus introspect --system \
--dest org.freedesktop.resolve1 \
--object-path /org/freedesktop/resolve1
</programlisting>
</programlisting>
</example>
<example>
@ -930,7 +930,7 @@ $ gdbus introspect --system \
$ gdbus introspect --system \
--dest org.freedesktop.resolve1 \
--object-path /org/freedesktop/resolve1/link/_11
</programlisting>
</programlisting>
</example>
</refsect1>

38
man/org.freedesktop.systemd1.xml
View File

@ -568,7 +568,7 @@ node /org/freedesktop/systemd1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--method GetUnitByInvocationID is not documented!-->
@ -1532,7 +1532,7 @@ node /org/freedesktop/systemd1 {
#define SD_SYSTEMD_UNIT_RUNTIME (UINT64_C(1) &lt;&lt; 0)
#define SD_SYSTEMD_UNIT_FORCE (UINT64_C(1) &lt;&lt; 1)
#define SD_SYSTEMD_UNIT_PORTABLE (UINT64_C(1) &lt;&lt; 2)
</programlisting>
</programlisting>
<para><varname>SD_SYSTEMD_UNIT_RUNTIME</varname> will enable or disable the unit for runtime only,
<varname>SD_SYSTEMD_UNIT_FORCE</varname> controls whether symlinks pointing to other units shall be
@ -2140,7 +2140,7 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--method EnqueueJob is not documented!-->
@ -3390,7 +3390,7 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.systemd1.Unit { ... };
};
</programlisting>
</programlisting>
<!--method GetProcesses is not documented!-->
@ -4856,7 +4856,7 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice {
<programlisting>
#define SD_EXEC_DIRECTORY_READ_ONLY (UINT64_C(1) &lt;&lt; 0)
</programlisting>
</programlisting>
<para><varname>ExtraFileDescriptorNames</varname> contains file descriptor names passed to the service via
the <varname>ExtraFileDescriptors</varname> property in the <function>StartTransientUnit()</function>
@ -5575,7 +5575,7 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2esocket {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.systemd1.Unit { ... };
};
</programlisting>
</programlisting>
<!--method GetProcesses is not documented!-->
@ -6927,7 +6927,7 @@ node /org/freedesktop/systemd1/unit/basic_2etarget {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.systemd1.Unit { ... };
};
</programlisting>
</programlisting>
<para>Target units have neither type-specific methods nor properties.</para>
</refsect1>
@ -6950,7 +6950,7 @@ node /org/freedesktop/systemd1/unit/dev_2dttyS0_2edevice {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.systemd1.Unit { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -7582,7 +7582,7 @@ node /org/freedesktop/systemd1/unit/home_2emount {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.systemd1.Unit { ... };
};
</programlisting>
</programlisting>
<!--method GetProcesses is not documented!-->
@ -8771,7 +8771,7 @@ node /org/freedesktop/systemd1/unit/proc_2dsys_2dfs_2dbinfmt_5fmisc_2eautomount
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.systemd1.Unit { ... };
};
</programlisting>
</programlisting>
<!--property Where is not documented!-->
@ -8862,7 +8862,7 @@ node /org/freedesktop/systemd1/unit/systemd_2dtmpfiles_2dclean_2etimer {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.systemd1.Unit { ... };
};
</programlisting>
</programlisting>
<!--property OnClockChange is not documented!-->
@ -9556,7 +9556,7 @@ node /org/freedesktop/systemd1/unit/dev_2dsda3_2eswap {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.systemd1.Unit { ... };
};
</programlisting>
</programlisting>
<!--method GetProcesses is not documented!-->
@ -10721,7 +10721,7 @@ node /org/freedesktop/systemd1/unit/cups_2epath {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.systemd1.Unit { ... };
};
</programlisting>
</programlisting>
<!--property MakeDirectory is not documented!-->
@ -10983,7 +10983,7 @@ node /org/freedesktop/systemd1/unit/system_2eslice {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.systemd1.Unit { ... };
};
</programlisting>
</programlisting>
<!--method GetProcesses is not documented!-->
@ -11615,7 +11615,7 @@ node /org/freedesktop/systemd1/unit/session_2d1_2escope {
interface org.freedesktop.DBus.Properties { ... };
interface org.freedesktop.systemd1.Unit { ... };
};
</programlisting>
</programlisting>
<!--method GetProcesses is not documented!-->
@ -12114,7 +12114,7 @@ node /org/freedesktop/systemd1/job/666 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--method GetAfter is not documented!-->
@ -12186,7 +12186,7 @@ node /org/freedesktop/systemd1/job/666 {
$ gdbus introspect --system \
--dest org.freedesktop.systemd1 \
--object-path /org/freedesktop/systemd1
</programlisting>
</programlisting>
</example>
<example>
@ -12198,7 +12198,7 @@ $ busctl introspect org.freedesktop.systemd1 \
/org/freedesktop/systemd1 \
org.freedesktop.systemd1.Manager \
GetUnit s systemd-resolved.service | cut -d'"' -f2)
</programlisting>
</programlisting>
</example>
<example>
@ -12207,7 +12207,7 @@ $ busctl introspect org.freedesktop.systemd1 \
<programlisting>
$ gdbus introspect --system --dest org.freedesktop.systemd1 \
--object-path /org/freedesktop/systemd1/job/1292
</programlisting>
</programlisting>
</example>
</refsect1>

14
man/org.freedesktop.sysupdate1.xml
View File

@ -53,7 +53,7 @@ node /org/freedesktop/sysupdate1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -149,7 +149,7 @@ node /org/freedesktop/sysupdate1/target/host {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -194,7 +194,7 @@ node /org/freedesktop/sysupdate1/target/host {
<programlisting>
#define SD_SYSUPDATE_OFFLINE (UINT64_C(1) &lt;&lt; 0)
</programlisting>
</programlisting>
<para>When <constant>SD_SYSUPDATE_OFFLINE</constant> is set, this method returns only the versions
installed locally. Otherwise, this method pulls metadata from the network and returns all versions
@ -452,7 +452,7 @@ node /org/freedesktop/sysupdate1/job/_1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -525,7 +525,7 @@ node /org/freedesktop/sysupdate1/job/_1 {
<programlisting>$ gdbus introspect --system \
--dest org.freedesktop.sysupdate1 \
--object-path /org/freedesktop/sysupdate1
</programlisting>
</programlisting>
</example>
<example>
@ -534,7 +534,7 @@ node /org/freedesktop/sysupdate1/job/_1 {
<programlisting>$ gdbus introspect --system \
--dest org.freedesktop.sysupdate1 \
--object-path /org/freedesktop/sysupdate1/target/host
</programlisting>
</programlisting>
</example>
<example>
@ -543,7 +543,7 @@ node /org/freedesktop/sysupdate1/job/_1 {
<programlisting>$ gdbus introspect --system \
--dest org.freedesktop.sysupdate1 \
--object-path /org/freedesktop/sysupdate1/job/_1
</programlisting>
</programlisting>
</example>
</refsect1>

4
man/org.freedesktop.timedate1.xml
View File

@ -66,7 +66,7 @@ node /org/freedesktop/timedate1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--Autogenerated cross-references for systemd.directives, do not edit-->
@ -186,7 +186,7 @@ node /org/freedesktop/timedate1 {
$ gdbus introspect --system \
--dest org.freedesktop.timedate1 \
--object-path /org/freedesktop/timedate1
</programlisting>
</programlisting>
</example>
</refsect1>

4
man/org.freedesktop.timesync1.xml
View File

@ -68,7 +68,7 @@ node /org/freedesktop/timesync1 {
interface org.freedesktop.DBus.Introspectable { ... };
interface org.freedesktop.DBus.Properties { ... };
};
</programlisting>
</programlisting>
<!--method SetRuntimeNTPServers is not documented!-->
@ -146,7 +146,7 @@ node /org/freedesktop/timesync1 {
$ gdbus introspect --system \
--dest org.freedesktop.timesync1 \
--object-path /org/freedesktop/timesync1
</programlisting>
</programlisting>
</example>
</refsect1>

2
man/pam_systemd.xml
View File

@ -409,7 +409,7 @@ pam_set_data(handle, "systemd.tasks_max", (void *)"50", cleanup);
pam_set_data(handle, "systemd.cpu_weight", (void *)"100", cleanup);
pam_set_data(handle, "systemd.io_weight", (void *)"340", cleanup);
pam_set_data(handle, "systemd.runtime_max_sec", (void *)"3600", cleanup);
</programlisting>
</programlisting>
</para>
</refsect1>

4
man/pam_systemd_loadkey.xml
View File

@ -119,14 +119,14 @@
-auth optional pam_gnome_keyring.so
-session optional pam_gnome_keyring.so auto_start
-session optional pam_kwallet5.so auto_start
</programlisting>
</programlisting>
<para>And add the following lines to your display manager's systemd service file, so it can access root's keyring:</para>
<programlisting>
[Service]
KeyringMode=inherit
</programlisting>
</programlisting>
<para>In this setup, early during the boot process,
<citerefentry><refentrytitle>systemd-cryptsetup@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>

6
man/sd_bus_message_append.xml
View File

@ -194,12 +194,12 @@ sd_bus_message_append(m, "ynqiuxtd", y, n, q, i, u, x, t, d);</programlisting>
<para>Append a structure composed of a string and a D-Bus path:</para>
<programlisting>sd_bus_message_append(m, "(so)", "a string", "/a/path");
</programlisting>
</programlisting>
<para>Append an array of UNIX file descriptors:</para>
<programlisting>sd_bus_message_append(m, "ah", 3, STDIN_FILENO, STDOUT_FILENO, STDERR_FILENO);
</programlisting>
</programlisting>
<para>Append a variant, with the real type "g" (signature),
and value "sdbusisgood":</para>
@ -210,7 +210,7 @@ sd_bus_message_append(m, "ynqiuxtd", y, n, q, i, u, x, t, d);</programlisting>
</para>
<programlisting>sd_bus_message_append(m, "a{is}", 3, 1, "a", 2, "b", 3, NULL);
</programlisting>
</programlisting>
</refsect1>
<refsect1>

2
man/sd_bus_message_dump.xml
View File

@ -83,7 +83,7 @@
STRING "AnExplicitProperty";
};
};
</programlisting>
</programlisting>
</para>
</refsect1>

2
man/sd_bus_message_read.xml
View File

@ -249,7 +249,7 @@ sd_bus_message_read(m, "v", "gt", &amp;s, &amp;v);</programlisting>
const char *s, *t, *u;
sd_bus_message_read(m, "a{is}", 3, &amp;i, &amp;s, &amp;j, &amp;t, &amp;k, &amp;u);
</programlisting>
</programlisting>
<para>Read a single file descriptor, and duplicate it in order to keep it open after the message is
freed.</para>

2
man/sd_event_wait.xml
View File

@ -262,7 +262,7 @@
|
v
FINISHED
</programlisting>
</programlisting>
</refsect1>
<refsect1>

2
man/sd_notify.xml
View File

@ -632,7 +632,7 @@ sd_notifyf(0, "STATUS=Failed to start up: %s\n"
sd_notify(0, "READY=1");
/* set timeout to 5 seconds */
sd_notify_barrier(0, 5 * 1000000);
</programlisting>
</programlisting>
</example>
</refsect1>

4
man/systemctl.xml
View File

@ -192,7 +192,7 @@ NEXT LEFT LAST PASSED
Sun 2017-02-26 18:55:42 EST 1min 14s left Thu 2017-02-23 13:54:44 EST 3 days ago systemd-tmpfiles-clean.timer systemd-tmpfiles-clean.service
Sun 2017-02-26 20:37:16 EST 1h 42min left Sun 2017-02-26 11:56:36 EST 6h ago apt-daily.timer apt-daily.service
Sun 2017-02-26 20:57:49 EST 2h 3min left Sun 2017-02-26 11:56:36 EST 6h ago snapd.refresh.timer snapd.refresh.service
</programlisting>
</programlisting>
</para>
<para><emphasis>NEXT</emphasis> shows the next time the timer will run.</para>
@ -2867,7 +2867,7 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
[Unit]
AllowedCPUs=7,11
EOF
</programlisting>
</programlisting>
<para>Multiple drop-ins may be "edited" in this mode; the same contents will be written to all of
them.</para>

16
man/systemd-analyze.xml
View File

@ -271,7 +271,7 @@ multi-user.target reached after 47.820s in userspace
23ms sysroot.mount
11ms initrd-udevadm-cleanup-db.service
3ms sys-kernel-config.mount
</programlisting>
</programlisting>
</example>
</refsect2>
@ -670,7 +670,7 @@ NAutoVTs=8
# /etc/systemd/logind.conf.d/50-override.conf
... some administrator override
</programlisting>
</programlisting>
</example>
</refsect2>
@ -716,7 +716,7 @@ $ systemd-analyze compare-versions 1 lt 2; echo $?
0
$ systemd-analyze compare-versions 1 ge 2; echo $?
1
</programlisting>
</programlisting>
</example>
</refsect2>
@ -768,7 +768,7 @@ Error: org.freedesktop.systemd1.LoadFailed:
No such file or directory.
Failed to create user.slice/start: Invalid argument
user.slice: man nosuchfile(1) command failed with code 16
</programlisting>
</programlisting>
</example>
<example>
@ -787,7 +787,7 @@ Accept=yes
$ systemd-analyze verify ./a.socket ./b.socket
Service a.service not loaded, a.socket cannot be started.
Service b@0.service not loaded, b.socket cannot be started.
</programlisting>
</programlisting>
</example>
<example>
@ -807,7 +807,7 @@ Failed to prepare filename /tmp/source: Invalid argument
$ systemd-analyze verify /tmp/source:alias.service
alias.service:7: Unknown key name 'MysteryKey' in section 'Service', ignoring.
</programlisting>
</programlisting>
</example>
</refsect2>
@ -886,7 +886,7 @@ alias.service:7: Unknown key name 'MysteryKey' in section 'Service', ignoring.
"buildId" : "b5e428254abf14237b0ae70ed85fffbb98a78f88"
}
}
</programlisting>
</programlisting>
</example>
</refsect2>
@ -1762,7 +1762,7 @@ io.systemd.credential:vmm.notify_socket=vsock-stream:2:254570042
"range": 1
}
}
</programlisting>
</programlisting>
</example>
</refsect1>

4
man/systemd-coredump.xml
View File

@ -172,7 +172,7 @@ COREDUMP_CMDLINE=/usr/lib64/firefox/firefox -contentproc -childID 5 -isForBrowse
COREDUMP_CGROUP=/user.slice/user-1000.slice/user@1000.service/app.slice/app-….scope
COREDUMP_FILENAME=/var/lib/systemd/coredump/core.Web….552351.….zst
…
</programlisting>
</programlisting>
<para>The following fields are saved (if known) with the journal entry</para>
@ -305,7 +305,7 @@ flags: ...
pos: ...
flags: ...
...
</programlisting>
</programlisting>
<para>The first line contains the file descriptor number <replaceable>fd</replaceable> and the path,
while subsequent lines show the contents of

4
man/systemd-id128.xml
View File

@ -186,7 +186,7 @@ $ systemd-id128 show --value --uuid user-home
$ systemd-id128 show 773f91ef-66d4-49b5-bd83-d683bf40ad16
NAME ID
user-home 773f91ef66d449b5bd83d683bf40ad16
</programlisting>
</programlisting>
</example>
<example>
@ -205,7 +205,7 @@ $ systemd-id128 machine-id -u -a 1fb8f24b-02df-458d-9659-cc8ace68e28a
$ systemd-id128 -Pu show 3a9d668b-4db7-4939-8a4a-5e78a03bffb7 \
-a 1fb8f24b-02df-458d-9659-cc8ace68e28a
47b82cb1-5339-43da-b2a6-1c350aef1bd1
</programlisting>
</programlisting>
<para>On a given machine with the ID 3a9d668b-4db7-4939-8a4a-5e78a03bffb7, for the application
1fb8f24b-02df-458d-9659-cc8ace68e28a, we generate an application-specific machine ID

6
man/systemd-journal-remote.service.xml
View File

@ -343,7 +343,7 @@
<para>Copy local journal events to a different journal directory:
<programlisting>
journalctl -o export | systemd-journal-remote -o /tmp/dir/foo.journal -
</programlisting>
</programlisting>
</para>
<para>Retrieve all available events from a remote
@ -352,7 +352,7 @@ journalctl -o export | systemd-journal-remote -o /tmp/dir/foo.journal -
<filename>/var/log/journal/remote/remote-some.host.journal</filename>:
<programlisting>
systemd-journal-remote --url http://some.host:19531/
</programlisting>
</programlisting>
</para>
<para>Retrieve current boot events and wait for new events from a remote
@ -361,7 +361,7 @@ systemd-journal-remote --url http://some.host:19531/
<filename>/var/log/journal/remote/remote-some.host.journal</filename>:
<programlisting>
systemd-journal-remote --url http://some.host:19531/entries?boot&amp;follow
</programlisting>
</programlisting>
</para>
</refsect1>

2
man/systemd-measure.xml
View File

@ -381,7 +381,7 @@ $ ukify build \
--public-key=tpm2-pcr-public-key-initrd.pem \
--phase=enter-initrd
Wrote unsigned vmlinux-1.2.3.efi
</programlisting>
</programlisting>
<para><command>ukify</command> prints out both invocations of <command>systemd-measure</command> as
informative output (the lines starting with <literal>+</literal>); this allows us to see how

2
man/systemd-resolved.service.xml
View File

@ -265,7 +265,7 @@
send them out over the network using the usual rules for multi-label name routing <footnote><para>For
example, if <filename>/etc/resolv.conf</filename> has <programlisting>nameserver 127.0.0.53
search foobar.com barbar.com
</programlisting>and we look up <literal>localhost</literal>, <filename>nss-dns</filename> will send
</programlisting>and we look up <literal>localhost</literal>, <filename>nss-dns</filename> will send
the following queries to <filename>systemd-resolved</filename> listening on 127.0.0.53:53: first
<literal>localhost.foobar.com</literal>, then <literal>localhost.barbar.com</literal>, and finally
<literal>localhost</literal>. If (hopefully) the first two queries fail,

4
man/systemd-run.xml
View File

@ -647,7 +647,7 @@ There is a screen on:
<programlisting>$ systemd-run -t echo "&lt;${INVOCATION_ID}>" '&lt;${INVOCATION_ID}>'
&lt;> &lt;5d0149bfa2c34b79bccb13074001eb20>
</programlisting>
</programlisting>
<para>The first argument is expanded by the shell (double quotes), but the second one is not expanded
by the shell (single quotes).
@ -673,7 +673,7 @@ There is a screen on:
<programlisting>$ systemd-run --expand-environment=no -t bash \
-c 'echo $SHELL $$ >/dev/stdout'
/bin/bash 12345
</programlisting>
</programlisting>
<para>The last argument is passed verbatim to the
<citerefentry project='man-pages'><refentrytitle>bash</refentrytitle><manvolnum>1</manvolnum></citerefentry>

11
man/systemd-vmspawn.xml
View File

@ -508,7 +508,7 @@
<programlisting>
$ mkosi -d arch -p systemd -p linux --autologin -o image.raw -f build
$ systemd-vmspawn --image=image.raw
</programlisting>
</programlisting>
</example>
<example>
@ -523,7 +523,7 @@ $ gpgv --keyring ./fedora.gpg Fedora-Cloud-&fedora_latest_version;-&fedora_cloud
$ sha256sum -c Fedora-Cloud-&fedora_latest_version;-&fedora_cloud_release;-x86_64-CHECKSUM
# machinectl import-raw Fedora-Cloud-Base-&fedora_latest_version;-&fedora_cloud_release;.x86_64.raw.xz fedora-&fedora_latest_version;-cloud
# systemd-vmspawn -M fedora-&fedora_latest_version;-cloud
</programlisting>
</programlisting>
</example>
<example>
@ -537,9 +537,10 @@ $ systemd-vmspawn \
--linux mkosi.output/system.efi \
--forward-journal=vm.journal \
enforcing=0
</programlisting>
</programlisting>
<para>Note: this example also uses a kernel command line argument to ensure SELinux isn't started in enforcing mode.</para>
<para>Note: this example also uses a kernel command line argument to ensure SELinux isn't started in
enforcing mode.</para>
</example>
<example>
@ -555,7 +556,7 @@ $ systemd-vmspawn \
--vsock-cid $my_vsock_cid \
enforcing=0
$ ssh root@vsock/$my_vsock_cid -i /run/user/$UID/systemd/vmspawn/machine-*-system-ed25519
</programlisting>
</programlisting>
</example>
</refsect1>

10
man/systemd.exec.xml
View File

@ -4722,7 +4722,7 @@ OnFailure=myhandler.service
[Service]
ExecStart=/bin/myprogram
</programlisting>
</programlisting>
<para>A service <filename index="false">mysuccess.service</filename> which can trigger an
<varname>OnSuccess=</varname> dependency.</para>
@ -4734,7 +4734,7 @@ OnSuccess=myhandler.service
[Service]
ExecStart=/bin/mysecondprogram
</programlisting>
</programlisting>
<para>A service <filename index="false">myhandler.service</filename> which can be triggered
by any of the above services.</para>
@ -4745,7 +4745,7 @@ Description=Acts on service failing or succeeding
[Service]
ExecStart=/bin/bash -c "echo $MONITOR_SERVICE_RESULT $MONITOR_EXIT_CODE $MONITOR_EXIT_STATUS $MONITOR_INVOCATION_ID $MONITOR_UNIT"
</programlisting>
</programlisting>
<para>If <filename index="false">myfailer.service</filename> were to run and exit in failure,
then <filename index="false">myhandler.service</filename> would be triggered and the
@ -4757,7 +4757,7 @@ MONITOR_EXIT_CODE=exited
MONITOR_EXIT_STATUS=1
MONITOR_INVOCATION_ID=cc8fdc149b2b4ca698d4f259f4054236
MONITOR_UNIT=myfailer.service
</programlisting>
</programlisting>
<para>If <filename index="false">mysuccess.service</filename> were to run and exit in success,
then <filename index="false">myhandler.service</filename> would be triggered and the
@ -4769,7 +4769,7 @@ MONITOR_EXIT_CODE=exited
MONITOR_EXIT_STATUS=0
MONITOR_INVOCATION_ID=6ab9af147b8c4a3ebe36e7a5f8611697
MONITOR_UNIT=mysuccess.service
</programlisting>
</programlisting>
</example>

4
man/systemd.net-naming-scheme.xml
View File

@ -606,7 +606,7 @@ ID_NET_NAME_PATH=enp0s31f6
<programlisting>ID_NET_NAME_ONBOARD=eno1
ID_NET_NAME_ONBOARD_LABEL=Ethernet Port 1
</programlisting>
</programlisting>
</example>
<example>
@ -699,7 +699,7 @@ net:naming:drvirtio_net:*
ID_NET_NAME_ALLOW=1
ID_NET_NAME_ALLOW_DEV_PORT=0
ID_NET_NAME_ALLOW_PHYS_PORT_NAME=0
</programlisting>
</programlisting>
</example>
</refsect1>

6
man/systemd.netdev.xml
View File

@ -2804,7 +2804,7 @@ Kind=fou
[FooOverUDP]
Port=5555
Protocol=4
</programlisting>
</programlisting>
</example>
<example>
<title>/etc/systemd/network/25-fou-ipip.netdev</title>
@ -2818,7 +2818,7 @@ Local=10.65.208.212
Remote=10.65.208.211
FooOverUDP=yes
FOUDestinationPort=5555
</programlisting>
</programlisting>
</example>
<example>
<title>/etc/systemd/network/25-tap.netdev</title>
@ -2937,7 +2937,7 @@ Table=42</programlisting>
<programlisting>[NetDev]
Name=macvtap-test
Kind=macvtap
</programlisting>
</programlisting>
</example>
<example>
<title>/etc/systemd/network/25-wireguard.netdev</title>

10
man/systemd.network.xml
View File

@ -6454,31 +6454,31 @@ Tunnel=ipip-tun
Tunnel=sit-tun
Tunnel=gre-tun
Tunnel=vti-tun
</programlisting>
</programlisting>
<programlisting>/etc/systemd/network/25-tunnel-ipip.netdev
[NetDev]
Name=ipip-tun
Kind=ipip
</programlisting>
</programlisting>
<programlisting>/etc/systemd/network/25-tunnel-sit.netdev
[NetDev]
Name=sit-tun
Kind=sit
</programlisting>
</programlisting>
<programlisting>/etc/systemd/network/25-tunnel-gre.netdev
[NetDev]
Name=gre-tun
Kind=gre
</programlisting>
</programlisting>
<programlisting>/etc/systemd/network/25-tunnel-vti.netdev
[NetDev]
Name=vti-tun
Kind=vti
</programlisting>
</programlisting>
<para>This will bring interface <literal>ens1</literal> up and create an IPIP tunnel,
a SIT tunnel, a GRE tunnel, and a VTI tunnel using it.</para>

2
man/systemd.resource-control.xml
View File

@ -105,7 +105,7 @@ CPUWeight=20 DisableControllers=cpu / \
/ \
b1.service b2.service
CPUWeight=1000
</programlisting>
</programlisting>
<para>In this hierarchy, the <option>cpu</option> controller is enabled for all units shown except
<filename>b1.service</filename> and <filename>b2.service</filename>. Because there is no explicit

2
man/systemd.time.xml
View File

@ -266,7 +266,7 @@ tomorrow Pacific/Auckland → Thu 2012-11-23 19:00:00
yearly → *-01-01 00:00:00
quarterly → *-01,04,07,10-01 00:00:00
semiannually → *-01,07-01 00:00:00
</programlisting>
</programlisting>
<para>Examples for valid timestamps and their
normalized form:</para>

6
man/systemd.unit.xml
View File

@ -2626,7 +2626,7 @@ Description=My failure handler for %i
Type=oneshot
# Perform some special action for when %i exits unexpectedly.
ExecStart=/usr/sbin/myfailurehandler %i
</programlisting>
</programlisting>
<para>We can then add an instance of
<filename index='false'>failure-handler@.service</filename> as an
@ -2637,7 +2637,7 @@ ExecStart=/usr/sbin/myfailurehandler %i
<programlisting>[Unit]
OnFailure=failure-handler@%N.service
</programlisting>
</programlisting>
<para>Now, after running <command>systemctl daemon-reload</command> all
services will have acquired an <varname>OnFailure=</varname> dependency on
@ -2655,7 +2655,7 @@ OnFailure=failure-handler@%N.service
<command>mkdir /etc/systemd/system/failure-handler@.service.d/</command>
<command>ln -s /dev/null /etc/systemd/system/failure-handler@.service.d/10-all.conf</command>
<command>systemctl daemon-reload</command>
</programlisting>
</programlisting>
<para>This ensures that if a <filename index='false'>failure-handler@.service</filename> instance fails it will not trigger an instance named
<filename index='false'>failure-handler@failure-handler.service</filename>.</para>

2
man/tmpfiles.d.xml
View File

@ -819,7 +819,7 @@ d /run/uscreens 0755 root screen 10d12h
<title>Create a directory with a SMACK attribute</title>
<programlisting>D /run/cups - - - -
t /run/cups - - - - security.SMACK64=printing user.attr-with-spaces="foo bar"
</programlisting>
</programlisting>
<para>The directory will be owned by root and have default mode. Its contents are
not subject to time-based cleanup, but will be obliterated when

16
man/ukify.xml
View File

@ -606,7 +606,7 @@
--linux=/lib/modules/6.0.9-300.fc37.x86_64/vmlinuz \
--initrd=/some/path/initramfs-6.0.9-300.fc37.x86_64.img \
--cmdline='quiet rw'
</programlisting>
</programlisting>
<para>This creates an unsigned UKI <filename>./vmlinuz.unsigned.efi</filename>.</para>
</example>
@ -632,7 +632,7 @@
--secureboot-certificate=sb.cert \
--sign-kernel \
--cmdline='quiet rw rhgb'
</programlisting>
</programlisting>
<para>This creates a signed UKI <filename index='false'>./vmlinuz.signed.efi</filename>.
The initrd section contains two concatenated parts, <filename index='false'>early_cpio</filename>
@ -676,7 +676,7 @@ Phases=enter-initrd:leave-initrd
$ ukify -c ukify.conf build \
--linux=/lib/modules/6.0.9-300.fc37.x86_64/vmlinuz \
--initrd=/some/path/initramfs-6.0.9-300.fc37.x86_64.img
</programlisting>
</programlisting>
<para>One "initrd" (<filename index='false'>early_cpio</filename>) is specified in the config file, and
the other initrd (<filename index='false'>initramfs-6.0.9-300.fc37.x86_64.img</filename>) is specified
@ -694,7 +694,7 @@ $ ukify -c ukify.conf build \
--sbat='sbat,1,SBAT Version,sbat,1,https://github.com/rhboot/shim/blob/main/SBAT.md
uki-addon.author,1,UKI Addon for System,uki-addon.author,1,https://www.freedesktop.org/software/systemd/man/systemd-stub.html'
--output=debug.addon.efi
</programlisting>
</programlisting>
<para>This creates a signed PE binary that contains the additional kernel command line parameter
<literal>debug</literal> with SBAT metadata referring to the owner of the addon.</para>
@ -738,7 +738,7 @@ Writing public key for PCR signing to /etc/systemd/tpm2-pcr-public-key-system.pe
<programlisting>$ ukify build \
--profile='TITLE=Base' \
--output=profile0.efi
</programlisting>
</programlisting>
<para>Add a second profile (@1):</para>
@ -747,7 +747,7 @@ Writing public key for PCR signing to /etc/systemd/tpm2-pcr-public-key-system.pe
ID=storagetm' \
--cmdline='quiet rw rd.systemd.unit=stroage-target-mode.target' \
--output=profile1.efi
</programlisting>
</programlisting>
<para>Add a third profile (@2):</para>
@ -756,7 +756,7 @@ ID=storagetm' \
ID=factory-reset' \
--cmdline='quiet rw systemd.unit=factory-reset.target' \
--output=profile2.efi
</programlisting>
</programlisting>
<para>Then, create a UKI and include all the generated profiles:</para>
@ -768,7 +768,7 @@ ID=factory-reset' \
--join-profile=profile1.efi \
--join-profile=profile2.efi \
--output=base.efi
</programlisting>
</programlisting>
<para>The resulting UKI <filename>base-with-profile-0-1-2.efi</filename> will now contain three profiles.</para>
</example>

2
tools/update-dbus-docs.py
View File

@ -228,7 +228,7 @@ def subst_output(document, programlisting, stats, missing_version):
xml = etree.fromstring(out, parser=xml_parser())
new_text, declarations, interfaces = xml_to_text(node, xml, only_interface=interface)
programlisting.text = '\n' + new_text + ' '
programlisting.text = '\n' + new_text
if declarations:
missing = check_documented(document, declarations, stats, interface, missing_version)