picnoir/Systemd
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

man: wording and grammar updates

Browse source 
This is a recurring submission and includes corrections to various
issue spotted. I guess I can just skip over reporting ubiquitous
comma placement fixes…

Highligts in this particular commit:
- the "unsigned" type qualifier is completed to form a full type
  "unsigned int"
- alphabetic -> lexicographic (that way we automatically define how
  numbers get sorted)
This commit is contained in:
Jan Engelhardt 2013-09-12 21:12:49 +02:00 committed by Lennart Poettering
parent 982e44dbc3
commit 7964042405
62 changed files with 289 additions and 289 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
man/binfmt.d.xml
View file

@ -88,10 +88,10 @@
administrator, who may use this logic to override the administrator, who may use this logic to override the
configuration files installed from vendor configuration files installed from vendor
packages. All files are sorted by their filename in packages. All files are sorted by their filename in
alphabetical order, regardless in which of the lexicographic order, regardless in which of the
directories they reside. If multiple files specify directories they reside. If multiple files specify
the same binary type name, the entry in the file with the same binary type name, the entry in the file with
the alphabetically latest name will be applied.</para> the lexicographically latest name will be applied.</para>
<para>If the administrator wants to disable a <para>If the administrator wants to disable a
configuration file supplied by the vendor, the configuration file supplied by the vendor, the

2
man/localectl.xml
View file

@ -136,7 +136,7 @@
<listitem><para>If <listitem><para>If
<command>set-keymap</command> or <command>set-keymap</command> or
<command>set-x11-keymap</command> is <command>set-x11-keymap</command> is
invoked and this option is passed then invoked and this option is passed, then
the keymap will not be converted from the keymap will not be converted from
the console to X11, or X11 to console, the console to X11, or X11 to console,
respectively.</para></listitem> respectively.</para></listitem>

8
man/machine-info.xml
View file

@ -94,13 +94,13 @@
<term><varname>PRETTY_HOSTNAME=</varname></term> <term><varname>PRETTY_HOSTNAME=</varname></term>
<listitem><para>A pretty <listitem><para>A pretty
human-readable UTF8 machine identifier human-readable UTF-8 machine identifier
string. This should contain a name string. This should contain a name
like <literal>Lennart's like <literal>Lennart's
Laptop</literal> which is useful to Laptop</literal> which is useful to
present to the user and does not present to the user and does not
suffer by the syntax limitations of suffer by the syntax limitations of
internet domain names. If possible the internet domain names. If possible, the
internet hostname as configured in internet hostname as configured in
<filename>/etc/hostname</filename> <filename>/etc/hostname</filename>
should be kept similar to this should be kept similar to this
@ -109,7 +109,7 @@
an Internet hostname of an Internet hostname of
<literal>lennarts-computer</literal> <literal>lennarts-computer</literal>
might be a good choice. If this might be a good choice. If this
parameter is not set an application parameter is not set, an application
should fall back to the Internet host should fall back to the Internet host
name for presentation name for presentation
purposes.</para></listitem> purposes.</para></listitem>
@ -122,7 +122,7 @@
this machine according to the <ulink this machine according to the <ulink
url="http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html">XDG url="http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html">XDG
Icon Naming Specification</ulink>. If Icon Naming Specification</ulink>. If
this parameter is not set an this parameter is not set, an
application should fall back to application should fall back to
<literal>computer</literal> or a <literal>computer</literal> or a
similar icon name.</para></listitem> similar icon name.</para></listitem>

2
man/modules-load.d.xml
View file

@ -90,7 +90,7 @@
packages.</para> packages.</para>
<para>If the administrator wants to disable a <para>If the administrator wants to disable a
configuration file supplied by the vendor the configuration file supplied by the vendor, the
recommended way is to place a symlink to recommended way is to place a symlink to
<filename>/dev/null</filename> in <filename>/dev/null</filename> in
<filename>/etc/modules-load.d/</filename> bearing the <filename>/etc/modules-load.d/</filename> bearing the

24
man/os-release.xml
View file

@ -62,7 +62,7 @@
list of environment-like shell-compatible variable list of environment-like shell-compatible variable
assignments. It is possible to source the assignments. It is possible to source the
configuration from shell scripts, however, beyond mere configuration from shell scripts, however, beyond mere
variable assignments no shell features are supported variable assignments, no shell features are supported
(this means variable expansion is explicitly not (this means variable expansion is explicitly not
supported), allowing applications to read the file supported), allowing applications to read the file
without implementing a shell compatible execution without implementing a shell compatible execution
@ -72,7 +72,7 @@
a-z, 0-9. All strings should be in UTF-8 format, and a-z, 0-9. All strings should be in UTF-8 format, and
non-printable characters should not be used. If double non-printable characters should not be used. If double
or single quotes or backslashes are to be used within or single quotes or backslashes are to be used within
variable assignments they should be escaped with variable assignments, they should be escaped with
backslashes, following shell style. It is not backslashes, following shell style. It is not
supported to concatenate multiple individually quoted supported to concatenate multiple individually quoted
strings. Lines beginning with "#" shall be ignored as strings. Lines beginning with "#" shall be ignored as
@ -110,7 +110,7 @@
<listitem><para>A string identifying <listitem><para>A string identifying
the operating system, without a the operating system, without a
version component, and suitable for version component, and suitable for
presentation to the user. If not set presentation to the user. If not set,
defaults to defaults to
<literal>NAME=Linux</literal>. Example: <literal>NAME=Linux</literal>. Example:
<literal>NAME=Fedora</literal> or <literal>NAME=Fedora</literal> or
@ -143,7 +143,7 @@
excluding any version information and excluding any version information and
suitable for processing by scripts or suitable for processing by scripts or
usage in generated filenames. If not usage in generated filenames. If not
set defaults to set, defaults to
<literal>ID=linux</literal>. Example: <literal>ID=linux</literal>. Example:
<literal>ID=fedora</literal> or <literal>ID=fedora</literal> or
<literal>ID=debian</literal>.</para></listitem> <literal>ID=debian</literal>.</para></listitem>
@ -155,7 +155,7 @@
<listitem><para>A space-separated list <listitem><para>A space-separated list
of operating system identifiers in the of operating system identifiers in the
same syntax as the same syntax as the
<varname>ID=</varname> setting. Should <varname>ID=</varname> setting. It should
list identifiers of operating systems list identifiers of operating systems
that are closely related to the local that are closely related to the local
operating system in regards to operating system in regards to
@ -165,8 +165,8 @@
OS is a derivative from. An OS is a derivative from. An
OS should generally only list other OS OS should generally only list other OS
identifiers it itself is a derivative identifiers it itself is a derivative
from, and not any OSes that of, and not any OSes that
are derived from it, but symmetric are derived from it, though symmetric
relationships are possible. Build relationships are possible. Build
scripts and similar should check this scripts and similar should check this
variable if they need to identify the variable if they need to identify the
@ -179,11 +179,11 @@
closest. This field is closest. This field is
optional. Example: for an operating optional. Example: for an operating
system with system with
<literal>ID=centos</literal> an <literal>ID=centos</literal>, an
assignment of <literal>ID_LIKE="rhel assignment of <literal>ID_LIKE="rhel
fedora"</literal> would be fedora"</literal> would be
appropriate. For an operating system appropriate. For an operating system
with <literal>ID=ubuntu</literal> an with <literal>ID=ubuntu</literal>, an
assignment of assignment of
<literal>ID_LIKE=debian</literal> is <literal>ID_LIKE=debian</literal> is
appropriate.</para></listitem> appropriate.</para></listitem>
@ -213,7 +213,7 @@
presentation to the user. May or may presentation to the user. May or may
not contain a release code name or OS not contain a release code name or OS
version of some kind, as suitable. If version of some kind, as suitable. If
not set defaults to not set, defaults to
<literal>PRETTY_NAME="Linux"</literal>. Example: <literal>PRETTY_NAME="Linux"</literal>. Example:
<literal>PRETTY_NAME="Fedora 17 (Beefy <literal>PRETTY_NAME="Fedora 17 (Beefy
Miracle)"</literal>.</para></listitem> Miracle)"</literal>.</para></listitem>
@ -290,7 +290,7 @@
<literal>tel:</literal>. Only one URL <literal>tel:</literal>. Only one URL
shall be listed in each setting. If shall be listed in each setting. If
multiple resources need to be multiple resources need to be
referenced it is recommended to referenced, it is recommended to
provide an online landing page linking provide an online landing page linking
all available resources. Examples: all available resources. Examples:
<literal>HOME_URL="https://fedoraproject.org/"</literal> <literal>HOME_URL="https://fedoraproject.org/"</literal>
@ -332,7 +332,7 @@
<para>Note that operating system vendors may choose <para>Note that operating system vendors may choose
not to provide version information, for example to not to provide version information, for example to
accommodate for rolling releases. In this case VERSION accommodate for rolling releases. In this case, VERSION
and VERSION_ID may be unset. Applications should not and VERSION_ID may be unset. Applications should not
rely on these fields to be set.</para> rely on these fields to be set.</para>

2
man/runlevel.xml
View file

@ -111,7 +111,7 @@
<term><varname>$PREVLEVEL</varname></term> <term><varname>$PREVLEVEL</varname></term>
<listitem><para>If <listitem><para>If
<varname>$PREVLEVEL</varname> is set <varname>$PREVLEVEL</varname> is set,
<command>runlevel</command> will print <command>runlevel</command> will print
this value as previous runlevel and this value as previous runlevel and
ignore utmp.</para></listitem> ignore utmp.</para></listitem>

2
man/sd-daemon.xml
View file

@ -99,7 +99,7 @@
conjunction with STDERR-based logging as implemented conjunction with STDERR-based logging as implemented
by systemd. If a systemd service definition file is by systemd. If a systemd service definition file is
configured with <varname>StandardError=syslog</varname> configured with <varname>StandardError=syslog</varname>
or <varname>StandardError=kmsg</varname> these or <varname>StandardError=kmsg</varname>, these
prefixes can be used to encode a log level in lines prefixes can be used to encode a log level in lines
printed. This is similar to the kernel printed. This is similar to the kernel
<function>printk()</function>-style logging. See <function>printk()</function>-style logging. See

2
man/sd_booted.xml
View file

@ -111,7 +111,7 @@
<para>If the reference implementation is used as <para>If the reference implementation is used as
drop-in files and -DDISABLE_SYSTEMD is set during drop-in files and -DDISABLE_SYSTEMD is set during
compilation this function will always return 0 and compilation, this function will always return 0 and
otherwise become a NOP.</para> otherwise become a NOP.</para>
</refsect1> </refsect1>

2
man/sd_is_fifo.xml
View file

@ -160,7 +160,7 @@
<para>On failure, these calls return a negative <para>On failure, these calls return a negative
errno-style error code. If the file descriptor is of errno-style error code. If the file descriptor is of
the specified type and bound to the specified address the specified type and bound to the specified address,
a positive return value is returned, otherwise a positive return value is returned, otherwise
zero.</para> zero.</para>
</refsect1> </refsect1>

12
man/sd_journal_add_match.xml
View file

@ -94,11 +94,11 @@
only of 0-9, A-Z and the underscore. It may not begin only of 0-9, A-Z and the underscore. It may not begin
with two underscores or be the empty string. The value with two underscores or be the empty string. The value
part may be any value, including binary. If a match is part may be any value, including binary. If a match is
applied only entries with this field set will be applied, only entries with this field set will be
iterated. Multiple matches may be active at the same iterated. Multiple matches may be active at the same
time: if they apply to different fields only entries time: If they apply to different fields, only entries
with both fields set like this will be iterated, if with both fields set like this will be iterated. If
they apply to the same fields only entries where the they apply to the same fields, only entries where the
field takes one of the specified values will be field takes one of the specified values will be
iterated. Well known fields are documented in iterated. Well known fields are documented in
<citerefentry><refentrytitle>systemd.journal-fields</refentrytitle><manvolnum>7</manvolnum></citerefentry>. Whenever <citerefentry><refentrytitle>systemd.journal-fields</refentrytitle><manvolnum>7</manvolnum></citerefentry>. Whenever
@ -110,7 +110,7 @@
<para><function>sd_journal_add_disjunction()</function> <para><function>sd_journal_add_disjunction()</function>
may be used to insert a disjunction (i.e. logical OR) may be used to insert a disjunction (i.e. logical OR)
in the match list. If this call is invoked all in the match list. If this call is invoked, all
previously added matches since the last invocation of previously added matches since the last invocation of
<function>sd_journal_add_disjunction()</function> or <function>sd_journal_add_disjunction()</function> or
<function>sd_journal_add_conjunction()</function> are <function>sd_journal_add_conjunction()</function> are
@ -123,7 +123,7 @@
<para><function>sd_journal_add_conjunction()</function> <para><function>sd_journal_add_conjunction()</function>
may be used to insert a conjunction (i.e. logical AND) may be used to insert a conjunction (i.e. logical AND)
in the match list. If this call is invoked all in the match list. If this call is invoked, all
previously added matches since the last invocation of previously added matches since the last invocation of
<function>sd_journal_add_conjunction()</function> are <function>sd_journal_add_conjunction()</function> are
combined in an AND with all matches added afterwards, combined in an AND with all matches added afterwards,

6
man/sd_journal_get_catalog.xml
View file

@ -80,8 +80,8 @@
field names in the catalog entry text enclosed in "@" field names in the catalog entry text enclosed in "@"
will be replaced by the respective field values of the will be replaced by the respective field values of the
current entry. If a field name referenced in the current entry. If a field name referenced in the
message catalog entry does not exist it the current message catalog entry does not exist, in the current
journal entry the "@" will be removed but the field journal entry, the "@" will be removed, but the field
name otherwise left untouched.</para> name otherwise left untouched.</para>
<para><function>sd_journal_get_catalog_for_message_id()</function> <para><function>sd_journal_get_catalog_for_message_id()</function>
@ -104,7 +104,7 @@
and and
<function>sd_journal_get_catalog_for_message_id()</function> <function>sd_journal_get_catalog_for_message_id()</function>
return 0 on success or a negative errno-style error return 0 on success or a negative errno-style error
code. If no matching message catalog entry is found code. If no matching message catalog entry is found,
-ENOENT is returned.</para> -ENOENT is returned.</para>
<para>On successful return, <parameter>ret</parameter> <para>On successful return, <parameter>ret</parameter>

4
man/sd_journal_get_data.xml
View file

@ -179,9 +179,9 @@
<para><function>sd_journal_get_data()</function> <para><function>sd_journal_get_data()</function>
returns 0 on success or a negative errno-style error returns 0 on success or a negative errno-style error
code. If the current entry does not include the code. If the current entry does not include the
specified field -ENOENT is returned. If specified field, -ENOENT is returned. If
<citerefentry><refentrytitle>sd_journal_next</refentrytitle><manvolnum>3</manvolnum></citerefentry> <citerefentry><refentrytitle>sd_journal_next</refentrytitle><manvolnum>3</manvolnum></citerefentry>
has not been called at least once -EADDRNOTAVAIL is has not been called at least once, -EADDRNOTAVAIL is
returned. <function>sd_journal_enumerate_data()</function> returned. <function>sd_journal_enumerate_data()</function>
returns a positive integer if the next field has been returns a positive integer if the next field has been
read, 0 when no more fields are known, or a negative read, 0 when no more fields are known, or a negative

4
man/sd_journal_get_fd.xml
View file

@ -137,8 +137,8 @@
<varname>timeout_usec</varname>. See <varname>timeout_usec</varname>. See
<citerefentry><refentrytitle>clock_gettime</refentrytitle><manvolnum>2</manvolnum></citerefentry> <citerefentry><refentrytitle>clock_gettime</refentrytitle><manvolnum>2</manvolnum></citerefentry>
for details about for details about
<constant>CLOCK_MONOTONIC</constant>. If there's no <constant>CLOCK_MONOTONIC</constant>. If there is no
timeout to wait for this will fill in timeout to wait for, this will fill in
<constant>(uint64_t) -1</constant> instead. Note that <constant>(uint64_t) -1</constant> instead. Note that
<function>poll()</function> takes a relative timeout <function>poll()</function> takes a relative timeout
in milliseconds rather than an absolute timeout in in milliseconds rather than an absolute timeout in

2
man/sd_journal_get_usage.xml
View file

@ -67,7 +67,7 @@
determines the total disk space currently used by determines the total disk space currently used by
journal files (in bytes). If journal files (in bytes). If
<constant>SD_JOURNAL_LOCAL_ONLY</constant> was passed <constant>SD_JOURNAL_LOCAL_ONLY</constant> was passed
when opening the journal this value will only reflect when opening the journal, this value will only reflect
the size of journal files of the local host, otherwise the size of journal files of the local host, otherwise
of all hosts.</para> of all hosts.</para>
</refsect1> </refsect1>

2
man/sd_journal_open.xml
View file

@ -146,7 +146,7 @@
<para>When opening the journal only journal files <para>When opening the journal only journal files
accessible to the calling user will be opened. If accessible to the calling user will be opened. If
journal files are not accessible to the caller this journal files are not accessible to the caller, this
will be silently ignored.</para> will be silently ignored.</para>
<para>See <para>See

4
man/sd_journal_print.xml
View file

@ -166,7 +166,7 @@
readable representation of the current error code readable representation of the current error code
stored in stored in
<citerefentry><refentrytitle>errno</refentrytitle><manvolnum>3</manvolnum></citerefentry>. If <citerefentry><refentrytitle>errno</refentrytitle><manvolnum>3</manvolnum></citerefentry>. If
the message string is passed as <constant>NULL</constant> or empty string the message string is passed as <constant>NULL</constant> or empty string,
only the error string representation will be written, only the error string representation will be written,
prefixed with nothing. An additional journal field prefixed with nothing. An additional journal field
ERRNO= is included in the entry containing the numeric ERRNO= is included in the entry containing the numeric
@ -189,7 +189,7 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
<para>Note that these calls implicitly add fields for <para>Note that these calls implicitly add fields for
the source file, function name and code line where the source file, function name and code line where
invoked. This is implemented with macros. If this is invoked. This is implemented with macros. If this is
not desired it can be turned off by defining not desired, it can be turned off by defining
SD_JOURNAL_SUPPRESS_LOCATION before including SD_JOURNAL_SUPPRESS_LOCATION before including
<filename>sd-journal.h</filename>.</para> <filename>sd-journal.h</filename>.</para>

12
man/sd_journal_seek_head.xml
View file

@ -111,30 +111,30 @@
(wallclock) timestamp, (wallclock) timestamp,
i.e. <constant>CLOCK_REALTIME</constant>. Note that i.e. <constant>CLOCK_REALTIME</constant>. Note that
the realtime clock is not necessarily monotonic. If a the realtime clock is not necessarily monotonic. If a
realtime timestamp is ambiguous it is not defined realtime timestamp is ambiguous, it is not defined
which position is sought to.</para> which position is sought to.</para>
<para><function>sd_journal_seek_cursor()</function> <para><function>sd_journal_seek_cursor()</function>
seeks to the entry located at the specified cursor seeks to the entry located at the specified cursor
string. For details on cursors see string. For details on cursors, see
<citerefentry><refentrytitle>sd_journal_get_cursor</refentrytitle><manvolnum>3</manvolnum></citerefentry>. If <citerefentry><refentrytitle>sd_journal_get_cursor</refentrytitle><manvolnum>3</manvolnum></citerefentry>. If
no entry matching the specified cursor is found the no entry matching the specified cursor is found the
call will seek to the next closest entry (in terms of call will seek to the next closest entry (in terms of
time) instead. To verify whether the newly selected time) instead. To verify whether the newly selected
entry actually matches the cursor use entry actually matches the cursor, use
<citerefentry><refentrytitle>sd_journal_test_cursor</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para> <citerefentry><refentrytitle>sd_journal_test_cursor</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
<para>Note that these calls do not actually make any <para>Note that these calls do not actually make any
entry the new current entry, this needs to be done in entry the new current entry, this needs to be done in
a separate step with a subsequent a separate step with a subsequent
<citerefentry><refentrytitle>sd_journal_next</refentrytitle><manvolnum>3</manvolnum></citerefentry> <citerefentry><refentrytitle>sd_journal_next</refentrytitle><manvolnum>3</manvolnum></citerefentry>
invocation (or a similar call). Only then entry data invocation (or a similar call). Only then, entry data
may be retrieved via may be retrieved via
<citerefentry><refentrytitle>sd_journal_get_data</refentrytitle><manvolnum>3</manvolnum></citerefentry>. If <citerefentry><refentrytitle>sd_journal_get_data</refentrytitle><manvolnum>3</manvolnum></citerefentry>. If
no entry exists that matches exactly the specified no entry exists that matches exactly the specified
seek address the next closest is sought to. If seek address, the next closest is sought to. If
<citerefentry><refentrytitle>sd_journal_next</refentrytitle><manvolnum>3</manvolnum></citerefentry> <citerefentry><refentrytitle>sd_journal_next</refentrytitle><manvolnum>3</manvolnum></citerefentry>
is used the closest following entry will be sought to, is used, the closest following entry will be sought to,
if if
<citerefentry><refentrytitle>sd_journal_previous</refentrytitle><manvolnum>3</manvolnum></citerefentry> <citerefentry><refentrytitle>sd_journal_previous</refentrytitle><manvolnum>3</manvolnum></citerefentry>
is used the closest preceding entry is sought is used the closest preceding entry is sought

18
man/sd_listen_fds.xml
View file

@ -70,7 +70,7 @@
activation logic.</para> activation logic.</para>
<para>If the <parameter>unset_environment</parameter> <para>If the <parameter>unset_environment</parameter>
parameter is non-zero parameter is non-zero,
<function>sd_listen_fds()</function> will unset the <function>sd_listen_fds()</function> will unset the
<varname>$LISTEN_FDS</varname>/<varname>$LISTEN_PID</varname> <varname>$LISTEN_FDS</varname>/<varname>$LISTEN_PID</varname>
environment variables before returning (regardless environment variables before returning (regardless
@ -83,16 +83,16 @@
<para>If a daemon receives more than one file <para>If a daemon receives more than one file
descriptor, they will be passed in the same order as descriptor, they will be passed in the same order as
configured in the systemd socket definition configured in the systemd socket definition
file. Nonetheless it is recommended to verify the file. Nonetheless, it is recommended to verify the
correct socket types before using them. To simplify correct socket types before using them. To simplify
this checking the functions this checking, the functions
<citerefentry><refentrytitle>sd_is_fifo</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>sd_is_fifo</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>sd_is_socket</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>sd_is_socket</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>sd_is_socket_inet</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>sd_is_socket_inet</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>sd_is_socket_unix</refentrytitle><manvolnum>3</manvolnum></citerefentry> <citerefentry><refentrytitle>sd_is_socket_unix</refentrytitle><manvolnum>3</manvolnum></citerefentry>
are provided. In order to maximize flexibility it is are provided. In order to maximize flexibility, it is
recommended to make these checks as loose as possible recommended to make these checks as loose as possible
without allowing incorrect setups. i.e. often the without allowing incorrect setups. i.e. often, the
actual port number a socket is bound to matters little actual port number a socket is bound to matters little
for the service to work, hence it should not be for the service to work, hence it should not be
verified. On the other hand, whether a socket is a verified. On the other hand, whether a socket is a
@ -112,7 +112,7 @@
<varname>$LISTEN_FDS</varname>/<varname>$LISTEN_PID</varname> <varname>$LISTEN_FDS</varname>/<varname>$LISTEN_PID</varname>
was not set or was not correctly set for this daemon and was not set or was not correctly set for this daemon and
hence no file descriptors were received, 0 is hence no file descriptors were received, 0 is
returned. Otherwise the number of file descriptors returned. Otherwise, the number of file descriptors
passed is returned. The application may find them passed is returned. The application may find them
starting with file descriptor SD_LISTEN_FDS_START, starting with file descriptor SD_LISTEN_FDS_START,
i.e. file descriptor 3.</para> i.e. file descriptor 3.</para>
@ -132,11 +132,11 @@
<para>Internally, this function checks whether the <para>Internally, this function checks whether the
<varname>$LISTEN_PID</varname> environment variable <varname>$LISTEN_PID</varname> environment variable
equals the daemon PID. If not, it returns equals the daemon PID. If not, it returns
immediately. Otherwise it parses the number passed in immediately. Otherwise, it parses the number passed in
the <varname>$LISTEN_FDS</varname> environment the <varname>$LISTEN_FDS</varname> environment
variable, then sets the FD_CLOEXEC flag for the parsed variable, then sets the FD_CLOEXEC flag for the parsed
number of file descriptors starting from number of file descriptors starting from
SD_LISTEN_FDS_START. Finally it returns the parsed SD_LISTEN_FDS_START. Finally, it returns the parsed
number.</para> number.</para>
<para>For details about the algorithm check the <para>For details about the algorithm check the
@ -160,7 +160,7 @@
<para>If the reference implementation is used as <para>If the reference implementation is used as
drop-in files and -DDISABLE_SYSTEMD is set during drop-in files and -DDISABLE_SYSTEMD is set during
compilation this function will always return 0 and compilation, this function will always return 0 and
otherwise become a NOP.</para> otherwise become a NOP.</para>
</refsect1> </refsect1>

4
man/sd_login_monitor_new.xml
View file

@ -129,7 +129,7 @@
object. Whenever an event causes the monitor to wake object. Whenever an event causes the monitor to wake
up the event loop via the file descriptor this up the event loop via the file descriptor this
function needs to be called to reset the wake-up function needs to be called to reset the wake-up
state. If this call is not invoked the file descriptor state. If this call is not invoked, the file descriptor
will immediately wake up the event loop again.</para> will immediately wake up the event loop again.</para>
<para><function>sd_login_monitor_get_fd()</function> <para><function>sd_login_monitor_get_fd()</function>
@ -167,7 +167,7 @@
<varname>timeout_usec</varname>. See <varname>timeout_usec</varname>. See
<citerefentry><refentrytitle>clock_gettime</refentrytitle><manvolnum>2</manvolnum></citerefentry> <citerefentry><refentrytitle>clock_gettime</refentrytitle><manvolnum>2</manvolnum></citerefentry>
for details about for details about
<constant>CLOCK_MONOTONIC</constant>. If there's no <constant>CLOCK_MONOTONIC</constant>. If there is no
timeout to wait for this will fill in timeout to wait for this will fill in
<constant>(uint64_t) -1</constant> instead. Note that <constant>(uint64_t) -1</constant> instead. Note that
<function>poll()</function> takes a relative timeout <function>poll()</function> takes a relative timeout

8
man/sd_notify.xml
View file

@ -77,7 +77,7 @@
notification.</para> notification.</para>
<para>If the <parameter>unset_environment</parameter> <para>If the <parameter>unset_environment</parameter>
parameter is non-zero <function>sd_notify()</function> parameter is non-zero, <function>sd_notify()</function>
will unset the <varname>$NOTIFY_SOCKET</varname> will unset the <varname>$NOTIFY_SOCKET</varname>
environment variable before returning (regardless environment variable before returning (regardless
whether the function call itself succeeded or whether the function call itself succeeded or
@ -197,7 +197,7 @@
errno-style error code. If errno-style error code. If
<varname>$NOTIFY_SOCKET</varname> was not set and <varname>$NOTIFY_SOCKET</varname> was not set and
hence no status data could be sent, 0 is returned. If hence no status data could be sent, 0 is returned. If
the status was sent these functions return with a the status was sent, these functions return with a
positive return value. In order to support both, init positive return value. In order to support both, init
systems that implement this scheme and those which systems that implement this scheme and those which
do not, it is generally recommended to ignore the return do not, it is generally recommended to ignore the return
@ -220,7 +220,7 @@
<constant>AF_UNIX</constant> socket referenced in the <constant>AF_UNIX</constant> socket referenced in the
<varname>$NOTIFY_SOCKET</varname> environment <varname>$NOTIFY_SOCKET</varname> environment
variable. If the first character of variable. If the first character of
<varname>$NOTIFY_SOCKET</varname> is <literal>@</literal> the string is <varname>$NOTIFY_SOCKET</varname> is <literal>@</literal>, the string is
understood as Linux abstract namespace socket. The understood as Linux abstract namespace socket. The
datagram is accompanied by the process credentials of datagram is accompanied by the process credentials of
the sending daemon, using SCM_CREDENTIALS.</para> the sending daemon, using SCM_CREDENTIALS.</para>
@ -246,7 +246,7 @@
<para>If the reference implementation is used as <para>If the reference implementation is used as
drop-in files and -DDISABLE_SYSTEMD is set during drop-in files and -DDISABLE_SYSTEMD is set during
compilation these functions will always return 0 and compilation, these functions will always return 0 and
otherwise become a NOP.</para> otherwise become a NOP.</para>
</refsect1> </refsect1>

4
man/sd_pid_get_session.xml
View file

@ -165,14 +165,14 @@
call after use.</para> call after use.</para>
<para>If the <varname>pid</varname> parameter of any <para>If the <varname>pid</varname> parameter of any
of these functions is passed as 0 the operation is of these functions is passed as 0, the operation is
executed for the calling process.</para> executed for the calling process.</para>
</refsect1> </refsect1>
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>On success these calls return 0 or a positive <para>On success, these calls return 0 or a positive
integer. On failure, these calls return a negative integer. On failure, these calls return a negative
errno-style error code.</para> errno-style error code.</para>
</refsect1> </refsect1>

2
man/sd_readahead.xml
View file

@ -142,7 +142,7 @@
details about the reference implementation see details about the reference implementation see
<citerefentry><refentrytitle>sd-readahead</refentrytitle><manvolnum>3</manvolnum></citerefentry></para> <citerefentry><refentrytitle>sd-readahead</refentrytitle><manvolnum>3</manvolnum></citerefentry></para>
<para>If -DDISABLE_SYSTEMD is set during compilation <para>If -DDISABLE_SYSTEMD is set during compilation,
this function will always return 0 and otherwise this function will always return 0 and otherwise
become a NOP.</para> become a NOP.</para>
</refsect1> </refsect1>

6
man/sd_seat_get_active.xml
View file

@ -65,7 +65,7 @@
<paramdef>const char* <parameter>seat</parameter></paramdef> <paramdef>const char* <parameter>seat</parameter></paramdef>
<paramdef>char*** <parameter>sessions</parameter></paramdef> <paramdef>char*** <parameter>sessions</parameter></paramdef>
<paramdef>uid_t** <parameter>uid</parameter></paramdef> <paramdef>uid_t** <parameter>uid</parameter></paramdef>
<paramdef>unsigned* <parameter>n_uids</parameter></paramdef> <paramdef>unsigned int* <parameter>n_uids</parameter></paramdef>
</funcprototype> </funcprototype>
<funcprototype> <funcprototype>
@ -133,7 +133,7 @@
<para>If the <varname>seat</varname> parameter of any <para>If the <varname>seat</varname> parameter of any
of these functions is passed as of these functions is passed as
<constant>NULL</constant> the operation is executed <constant>NULL</constant>, the operation is executed
for the seat of the session of the calling process, if for the seat of the session of the calling process, if
there is any.</para> there is any.</para>
</refsect1> </refsect1>
@ -146,7 +146,7 @@
returns 0 or a positive integer. On success returns 0 or a positive integer. On success
<function>sd_seat_get_sessions()</function> returns <function>sd_seat_get_sessions()</function> returns
the number of entries in the session identifier the number of entries in the session identifier
array. If the test succeeds array. If the test succeeds,
<function>sd_seat_can_multi_session</function>, <function>sd_seat_can_multi_session</function>,
<function>sd_seat_can_tty</function> and <function>sd_seat_can_tty</function> and
<function>sd_seat_can_graphical</function> return a <function>sd_seat_can_graphical</function> return a

6
man/sd_session_is_active.xml
View file

@ -116,7 +116,7 @@
<funcprototype> <funcprototype>
<funcdef>int <function>sd_session_get_vt</function></funcdef> <funcdef>int <function>sd_session_get_vt</function></funcdef>
<paramdef>const char* <parameter>session</parameter></paramdef> <paramdef>const char* <parameter>session</parameter></paramdef>
<paramdef>unsigned* <parameter>vt</parameter></paramdef> <paramdef>unsigned int* <parameter>vt</parameter></paramdef>
</funcprototype> </funcprototype>
</funcsynopsis> </funcsynopsis>
</refsynopsisdiv> </refsynopsisdiv>
@ -217,7 +217,7 @@
<para>If the <varname>session</varname> parameter of <para>If the <varname>session</varname> parameter of
any of these functions is passed as any of these functions is passed as
<constant>NULL</constant> the operation is executed <constant>NULL</constant>, the operation is executed
for the session the calling process is a member of, if for the session the calling process is a member of, if
there is any.</para> there is any.</para>
</refsect1> </refsect1>
@ -225,7 +225,7 @@
<refsect1> <refsect1>
<title>Return Value</title> <title>Return Value</title>
<para>If the test succeeds <para>If the test succeeds,
<function>sd_session_is_active()</function> returns a <function>sd_session_is_active()</function> returns a
positive integer, if it fails 0. On success positive integer, if it fails 0. On success
<function>sd_session_get_state()</function>, <function>sd_session_get_state()</function>,

6
man/sd_uid_get_state.xml
View file

@ -111,7 +111,7 @@
or active on a specific seat. Accepts a Unix user or active on a specific seat. Accepts a Unix user
identifier and a seat identifier string as identifier and a seat identifier string as
parameters. The <parameter>require_active</parameter> parameters. The <parameter>require_active</parameter>
parameter is a boolean value. If non-zero (true) this parameter is a boolean value. If non-zero (true), this
function will test if the user is active (i.e. has a function will test if the user is active (i.e. has a
session that is in the foreground and accepting user session that is in the foreground and accepting user
input) on the specified seat, otherwise (false) only input) on the specified seat, otherwise (false) only
@ -133,7 +133,7 @@
<citerefentry><refentrytitle>free</refentrytitle><manvolnum>3</manvolnum></citerefentry> <citerefentry><refentrytitle>free</refentrytitle><manvolnum>3</manvolnum></citerefentry>
call after use, including all the strings call after use, including all the strings
referenced. If the string array parameter is passed as referenced. If the string array parameter is passed as
<constant>NULL</constant> the array will not be filled in, but the return <constant>NULL</constant>, the array will not be filled in, but the return
code still indicates the number of current code still indicates the number of current
sessions. Note that instead of an empty array <constant>NULL</constant> may sessions. Note that instead of an empty array <constant>NULL</constant> may
be returned and should be considered equivalent to an be returned and should be considered equivalent to an
@ -154,7 +154,7 @@
<para>On success <para>On success
<function>sd_uid_get_state()</function> returns 0 or a <function>sd_uid_get_state()</function> returns 0 or a
positive integer. If the test succeeds positive integer. If the test succeeds,
<function>sd_uid_is_on_seat()</function> returns a <function>sd_uid_is_on_seat()</function> returns a
positive integer, if it fails positive integer, if it fails
0. <function>sd_uid_get_sessions()</function> and 0. <function>sd_uid_get_sessions()</function> and

4
man/sysctl.d.xml
View file

@ -89,10 +89,10 @@
administrator, who may use this logic to override the administrator, who may use this logic to override the
configuration files installed by vendor packages. All configuration files installed by vendor packages. All
configuration files are sorted by their filename in configuration files are sorted by their filename in
alphabetical order, regardless in which of the lexicographic order, regardless in which of the
directories they reside. If multiple files specify the directories they reside. If multiple files specify the
same variable name, the entry in the file with the same variable name, the entry in the file with the
alphabetically latest name will be applied. It is lexicographically latest name will be applied. It is
recommended to prefix all filenames with a two-digit recommended to prefix all filenames with a two-digit
number and a dash, to simplify the ordering of the number and a dash, to simplify the ordering of the
files.</para> files.</para>

16
man/systemctl.xml
View file

@ -566,7 +566,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
their configuration. Note that this will reload the their configuration. Note that this will reload the
service-specific configuration, not the unit configuration service-specific configuration, not the unit configuration
file of systemd. If you want systemd to reload the file of systemd. If you want systemd to reload the
configuration file of a unit use the configuration file of a unit, use the
<command>daemon-reload</command> command. In other words: <command>daemon-reload</command> command. In other words:
for the example case of Apache, this will reload Apache's for the example case of Apache, this will reload Apache's
<filename>httpd.conf</filename> in the web server, not the <filename>httpd.conf</filename> in the web server, not the
@ -692,12 +692,12 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
<listitem> <listitem>
<para>Show properties of one or more units, jobs, or the <para>Show properties of one or more units, jobs, or the
manager itself. If no argument is specified properties of manager itself. If no argument is specified, properties of
the manager will be shown. If a unit name is specified the manager will be shown. If a unit name is specified,
properties of the unit is shown, and if a job id is properties of the unit is shown, and if a job id is
specified properties of the job is shown. By default, empty specified, properties of the job is shown. By default, empty
properties are suppressed. Use <option>--all</option> to properties are suppressed. Use <option>--all</option> to
show those too. To select specific properties to show use show those too. To select specific properties to show, use
<option>--property=</option>. This command is intended to be <option>--property=</option>. This command is intended to be
used whenever computer-parsable output is required. Use used whenever computer-parsable output is required. Use
<command>status</command> if you are looking for formatted <command>status</command> if you are looking for formatted
@ -1075,7 +1075,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
<listitem> <listitem>
<para>Reload systemd manager configuration. This will reload <para>Reload systemd manager configuration. This will reload
all unit files and recreate the entire dependency all unit files and recreate the entire dependency
tree. While the daemon is reloaded, all sockets systemd tree. While the daemon is being reloaded, all sockets systemd
listens on on behalf of user configuration will stay listens on on behalf of user configuration will stay
accessible.</para> <para>This command should not be confused accessible.</para> <para>This command should not be confused
with the <command>load</command> or with the <command>load</command> or
@ -1089,9 +1089,9 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
<para>Reexecute the systemd manager. This will serialize the <para>Reexecute the systemd manager. This will serialize the
manager state, reexecute the process and deserialize the manager state, reexecute the process and deserialize the
state again. This command is of little use except for state again. This command is of little use except for
debugging and package upgrades. Sometimes it might be debugging and package upgrades. Sometimes, it might be
helpful as a heavy-weight <command>daemon-reload</command>. helpful as a heavy-weight <command>daemon-reload</command>.
While the daemon is reexecuted, all sockets systemd listening While the daemon is being reexecuted, all sockets systemd listening
on behalf of user configuration will stay accessible. on behalf of user configuration will stay accessible.
</para> </para>
</listitem> </listitem>

4
man/systemd-activate.xml
View file

@ -123,8 +123,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
<listitem><para>Add this variable to the environment of the <listitem><para>Add this variable to the environment of the
launched process. If <replaceable>VAR</replaceable> is launched process. If <replaceable>VAR</replaceable> is
followed by <literal>=</literal> assume that it is a followed by <literal>=</literal>, assume that it is a
variable–value pair. Otherwise obtain the value from the variable–value pair. Otherwise, obtain the value from the
environment of <command>systemd-activate</command> itself. environment of <command>systemd-activate</command> itself.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>

4
man/systemd-analyze.xml
View file

@ -206,12 +206,12 @@
<command>dot</command> command (see <command>dot</command> command (see
above), selects which dependencies are above), selects which dependencies are
shown in the dependency graph. If shown in the dependency graph. If
<option>--order</option> is passed <option>--order</option> is passed,
only dependencies of type only dependencies of type
<varname>After=</varname> or <varname>After=</varname> or
<varname>Before=</varname> are <varname>Before=</varname> are
shown. If <option>--require</option> shown. If <option>--require</option>
is passed only dependencies of type is passed, only dependencies of type
<varname>Requires=</varname>, <varname>Requires=</varname>,
<varname>RequiresOverridable=</varname>, <varname>RequiresOverridable=</varname>,
<varname>Requisite=</varname>, <varname>Requisite=</varname>,

4
man/systemd-ask-password.xml
View file

@ -90,7 +90,7 @@
url="http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents">systemd url="http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents">systemd
Password Agent Specification</ulink>.</para> Password Agent Specification</ulink>.</para>
<para>If a password is queried on a TTY the user may <para>If a password is queried on a TTY, the user may
press TAB to hide the asterisks normally shown for press TAB to hide the asterisks normally shown for
each character typed. Pressing Backspace as first key each character typed. Pressing Backspace as first key
achieves the same effect.</para> achieves the same effect.</para>
@ -145,7 +145,7 @@
<varlistentry> <varlistentry>
<term><option>--accept-cached</option></term> <term><option>--accept-cached</option></term>
<listitem><para>If passed accept <listitem><para>If passed, accept
cached passwords, i.e. passwords cached passwords, i.e. passwords
previously typed in.</para></listitem> previously typed in.</para></listitem>
</varlistentry> </varlistentry>

8
man/systemd-cat.xml
View file

@ -65,11 +65,11 @@
pass the output the previous pipeline element pass the output the previous pipeline element
generates to the journal.</para> generates to the journal.</para>
<para>If no parameter is passed <para>If no parameter is passed,
<command>systemd-cat</command> will write <command>systemd-cat</command> will write
everything it reads from standard input (STDIN) to the journal.</para> everything it reads from standard input (STDIN) to the journal.</para>
<para>If parameters are passed they are executed as <para>If parameters are passed, they are executed as
command line with standard output (STDOUT) and standard command line with standard output (STDOUT) and standard
error output (STDERR) connected to the journal, so error output (STDERR) connected to the journal, so
that all it writes is stored in the journal.</para> that all it writes is stored in the journal.</para>
@ -102,7 +102,7 @@
<listitem><para>Specify a short string <listitem><para>Specify a short string
that is used to identify the logging that is used to identify the logging
tool. If not specified no identifying tool. If not specified, no identification
string is written to the journal.</para></listitem> string is written to the journal.</para></listitem>
</varlistentry> </varlistentry>
@ -141,7 +141,7 @@
<listitem><para>Controls whether lines <listitem><para>Controls whether lines
read are parsed for syslog priority read are parsed for syslog priority
level prefixes. If enabled (the level prefixes. If enabled (the
default) a line prefixed with a default), a line prefixed with a
priority prefix such as priority prefix such as
<literal>&lt;5&gt;</literal> is logged <literal>&lt;5&gt;</literal> is logged
at priority 5 at priority 5

8
man/systemd-cgls.xml
View file

@ -60,19 +60,19 @@
<para><command>systemd-cgls</command> recursively <para><command>systemd-cgls</command> recursively
shows the contents of the selected Linux control group shows the contents of the selected Linux control group
hierarchy in a tree. If arguments are specified shows hierarchy in a tree. If arguments are specified, shows
all member processes of the specified control groups all member processes of the specified control groups
plus all their subgroups and their members. The plus all their subgroups and their members. The
control groups may either be specified by their full control groups may either be specified by their full
file paths or are assumed in the systemd control group file paths or are assumed in the systemd control group
hierarchy. If no argument is specified and the current hierarchy. If no argument is specified and the current
working directory is beneath the control group mount working directory is beneath the control group mount
point <filename>/sys/fs/cgroup</filename> shows the contents point <filename>/sys/fs/cgroup</filename>, shows the contents
of the control group the working directory refers of the control group the working directory refers
to. Otherwise the full systemd control group hierarchy to. Otherwise, the full systemd control group hierarchy
is shown.</para> is shown.</para>
<para>By default empty control groups are not <para>By default, empty control groups are not
shown.</para> shown.</para>
</refsect1> </refsect1>

6
man/systemd-cgtop.xml
View file

@ -79,7 +79,7 @@
group in the <literal>cpuacct</literal> hierarchy, but group in the <literal>cpuacct</literal> hierarchy, but
not in <literal>memory</literal> nor not in <literal>memory</literal> nor
<literal>blkio</literal>. If resource monitoring for <literal>blkio</literal>. If resource monitoring for
these resources is required it is recommended to add these resources is required, it is recommended to add
<literal>blkio</literal> and <literal>memory</literal> <literal>blkio</literal> and <literal>memory</literal>
to the <varname>DefaultControllers=</varname> setting to the <varname>DefaultControllers=</varname> setting
in <filename>/etc/systemd/system.conf</filename> (see in <filename>/etc/systemd/system.conf</filename> (see
@ -197,8 +197,8 @@
tree traversal depth. Specifies how tree traversal depth. Specifies how
deep <command>systemd-cgtop</command> deep <command>systemd-cgtop</command>
shall traverse the control group shall traverse the control group
hierarchies. If 0 is specified only hierarchies. If 0 is specified, only
the root group is monitored, for 1 the root group is monitored. For 1,
only the first level of control groups only the first level of control groups
is monitored, and so on. Defaults to is monitored, and so on. Defaults to
3.</para></listitem> 3.</para></listitem>

4
man/systemd-cryptsetup-generator.xml
View file

@ -80,7 +80,7 @@
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. Defaults to argument. Defaults to
<literal>yes</literal>. If <literal>yes</literal>. If
<literal>no</literal> disables the <literal>no</literal>, disables the
generator generator
entirely. <varname>rd.luks=</varname> entirely. <varname>rd.luks=</varname>
is honored only by initial RAM disk is honored only by initial RAM disk
@ -97,7 +97,7 @@
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. Defaults to argument. Defaults to
<literal>yes</literal>. If <literal>yes</literal>. If
<literal>no</literal> causes the <literal>no</literal>, causes the
generator to ignore any devices generator to ignore any devices
configured in configured in
<filename>/etc/crypttab</filename> <filename>/etc/crypttab</filename>

2
man/systemd-delta.xml
View file

@ -163,7 +163,7 @@
<listitem><para>When showing modified <listitem><para>When showing modified
files, when a file is overridden show a files, when a file is overridden show a
diff as well. This option takes a diff as well. This option takes a
boolean argument. If omitted it defaults boolean argument. If omitted, it defaults
to <option>true</option>.</para></listitem> to <option>true</option>.</para></listitem>
</varlistentry> </varlistentry>

6
man/systemd-detect-virt.xml
View file

@ -75,10 +75,10 @@
<varname>lxc-libvirt</varname>, <varname>lxc-libvirt</varname>,
<varname>systemd-nspawn</varname>.</para> <varname>systemd-nspawn</varname>.</para>
<para>If multiple virtualization solutions are used <para>If multiple virtualization solutions are used,
only the "innermost" is detected and identified. That only the "innermost" is detected and identified. That
means if both VM virtualization and container means if both VM virtualization and container
virtualization are used in conjunction only the latter virtualization are used in conjunction, only the latter
will be identified (unless <option>--vm</option> is will be identified (unless <option>--vm</option> is
passed).</para> passed).</para>
</refsect1> </refsect1>
@ -138,7 +138,7 @@
<refsect1> <refsect1>
<title>Exit status</title> <title>Exit status</title>
<para>If a virtualization technology is detected 0 is <para>If a virtualization technology is detected, 0 is
returned, a non-zero code otherwise.</para> returned, a non-zero code otherwise.</para>
</refsect1> </refsect1>

2
man/systemd-fsck@.service.xml
View file

@ -66,7 +66,7 @@
<para><filename>systemd-fsck</filename> will <para><filename>systemd-fsck</filename> will
forward file system checking progress to the forward file system checking progress to the
console. If a file system check fails emergency mode console. If a file system check fails, emergency mode
is activated, by isolating to is activated, by isolating to
<filename>emergency.target</filename>.</para> <filename>emergency.target</filename>.</para>
</refsect1> </refsect1>

2
man/systemd-fstab-generator.xml
View file

@ -90,7 +90,7 @@
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. Defaults to argument. Defaults to
<literal>yes</literal>. If <literal>yes</literal>. If
<literal>no</literal> causes the <literal>no</literal>, causes the
generator to ignore any mounts or swaps generator to ignore any mounts or swaps
configured in configured in
<filename>/etc/fstab</filename>. <varname>rd.fstab=</varname> <filename>/etc/fstab</filename>. <varname>rd.fstab=</varname>

2
man/systemd-journald.service.xml
View file

@ -77,7 +77,7 @@
necessary. All objects stored in the journal can be up necessary. All objects stored in the journal can be up
to 2^64-1 bytes in size.</para> to 2^64-1 bytes in size.</para>
<para>By default the journal stores log data in <para>By default, the journal stores log data in
<filename>/run/log/journal/</filename>. Since <filename>/run/log/journal/</filename>. Since
<filename>/run/</filename> is volatile, log data is <filename>/run/</filename> is volatile, log data is
lost at reboot. To make the data persistent, it lost at reboot. To make the data persistent, it

4
man/systemd-machine-id-setup.xml
View file

@ -69,12 +69,12 @@
initialized.</para> initialized.</para>
<para>If a valid D-Bus machine ID is already <para>If a valid D-Bus machine ID is already
configured for the system the D-Bus machine ID is configured for the system, the D-Bus machine ID is
copied and used to initialize the machine ID in copied and used to initialize the machine ID in
<filename>/etc/machine-id</filename>.</para> <filename>/etc/machine-id</filename>.</para>
<para>If run inside a KVM virtual machine and a UUID <para>If run inside a KVM virtual machine and a UUID
is passed via the <option>-uuid</option> option this is passed via the <option>-uuid</option> option, this
UUID is used to initialize the machine ID instead of a UUID is used to initialize the machine ID instead of a
randomly generated one. The caller must ensure that the randomly generated one. The caller must ensure that the
UUID passed is sufficiently unique and is different UUID passed is sufficiently unique and is different

6
man/systemd-notify.xml
View file

@ -119,7 +119,7 @@
<listitem><para>Inform the init system <listitem><para>Inform the init system
about the main PID of the about the main PID of the
daemon. Takes a PID as argument. If daemon. Takes a PID as argument. If
the argument is omitted the PID of the the argument is omitted, the PID of the
process that invoked process that invoked
<command>systemd-notify</command> is <command>systemd-notify</command> is
used. This is equivalent to used. This is equivalent to
@ -148,10 +148,10 @@
<listitem><para>Returns 0 if the <listitem><para>Returns 0 if the
system was booted up with systemd, system was booted up with systemd,
non-zero otherwise. If this option is non-zero otherwise. If this option is
passed no message is sent. This option passed, no message is sent. This option
is hence unrelated to the other is hence unrelated to the other
options. For details about the options. For details about the
semantics of this option see semantics of this option, see
<citerefentry><refentrytitle>sd_booted</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para></listitem> <citerefentry><refentrytitle>sd_booted</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para></listitem>
</varlistentry> </varlistentry>

8
man/systemd-nspawn.xml
View file

@ -151,7 +151,7 @@
containers. We hence recommend turning it off entirely containers. We hence recommend turning it off entirely
by booting with <literal>audit=0</literal> on the by booting with <literal>audit=0</literal> on the
kernel command line, or by turning it off at kernel kernel command line, or by turning it off at kernel
build time. If auditing is enabled in the kernel build time. If auditing is enabled in the kernel,
operating systems booted in an nspawn container might operating systems booted in an nspawn container might
refuse log-in attempts.</para> refuse log-in attempts.</para>
</refsect1> </refsect1>
@ -192,7 +192,7 @@
<listitem><para>Directory to use as <listitem><para>Directory to use as
file system root for the namespace file system root for the namespace
container. If omitted the current container. If omitted, the current
directory will be directory will be
used.</para></listitem> used.</para></listitem>
</varlistentry> </varlistentry>
@ -233,7 +233,7 @@
host, and is used to initialize the host, and is used to initialize the
container's hostname (which the container's hostname (which the
container can choose to override, container can choose to override,
however). If not specified the last however). If not specified, the last
component of the root directory of the component of the root directory of the
container is used.</para></listitem> container is used.</para></listitem>
</varlistentry> </varlistentry>
@ -308,7 +308,7 @@
<listitem><para>Control whether the <listitem><para>Control whether the
container's journal shall be made container's journal shall be made
visible to the host system. If enabled visible to the host system. If enabled,
allows viewing the container's journal allows viewing the container's journal
files from the host (but not vice files from the host (but not vice
versa). Takes one of versa). Takes one of

2
man/systemd-suspend.service.xml
View file

@ -96,7 +96,7 @@
<filename>/usr/lib/systemd/system-sleep/</filename> <filename>/usr/lib/systemd/system-sleep/</filename>
are intended for local use only and should be are intended for local use only and should be
considered hacks. If applications want to be notified considered hacks. If applications want to be notified
of system suspend/hibernation and resume there are of system suspend/hibernation and resume, there are
much nicer interfaces available.</para> much nicer interfaces available.</para>
<para>Note that <para>Note that

8
man/systemd-system.conf.xml
View file

@ -133,7 +133,7 @@
<listitem><para>Configures controllers <listitem><para>Configures controllers
that shall be mounted in a single that shall be mounted in a single
hierarchy. By default systemd will hierarchy. By default, systemd will
mount all controllers which are mount all controllers which are
enabled in the kernel in individual enabled in the kernel in individual
hierarchies, with the exception of hierarchies, with the exception of
@ -154,7 +154,7 @@
necessary to rebuild the initrd if necessary to rebuild the initrd if
this option is changed, and make sure this option is changed, and make sure
the new configuration file is included the new configuration file is included
in it. Otherwise the initrd might in it. Otherwise, the initrd might
mount the controller hierarchies in a mount the controller hierarchies in a
different configuration than intended, different configuration than intended,
and the main system cannot remount and the main system cannot remount
@ -175,7 +175,7 @@
<literal>d</literal>, <literal>d</literal>,
<literal>w</literal>). If <literal>w</literal>). If
<varname>RuntimeWatchdogSec=</varname> <varname>RuntimeWatchdogSec=</varname>
is set to a non-zero value the is set to a non-zero value, the
watchdog hardware watchdog hardware
(<filename>/dev/watchdog</filename>) (<filename>/dev/watchdog</filename>)
will be programmed to automatically will be programmed to automatically
@ -220,7 +220,7 @@
Capabilities listed will be included Capabilities listed will be included
in the bounding set, all others are in the bounding set, all others are
removed. If the list of capabilities removed. If the list of capabilities
is prefixed with ~ all but the listed is prefixed with ~, all but the listed
capabilities will be included, the capabilities will be included, the
effect of the assignment effect of the assignment
inverted. Note that this option also inverted. Note that this option also

6
man/systemd-tmpfiles.xml
View file

@ -94,7 +94,7 @@
<varlistentry> <varlistentry>
<term><option>--create</option></term> <term><option>--create</option></term>
<listitem><para>If this option is passed all <listitem><para>If this option is passed, all
files and directories marked with f, files and directories marked with f,
F, d, D in the configuration files are F, d, D in the configuration files are
created. Files and directories marked with z, created. Files and directories marked with z,
@ -105,7 +105,7 @@
<varlistentry> <varlistentry>
<term><option>--clean</option></term> <term><option>--clean</option></term>
<listitem><para>If this option is <listitem><para>If this option is
passed all files and directories with passed, all files and directories with
an age parameter configured will be an age parameter configured will be
cleaned up.</para></listitem> cleaned up.</para></listitem>
</varlistentry> </varlistentry>
@ -113,7 +113,7 @@
<varlistentry> <varlistentry>
<term><option>--remove</option></term> <term><option>--remove</option></term>
<listitem><para>If this option is <listitem><para>If this option is
passed all files and directories marked passed, all files and directories marked
with r, R in the configuration files with r, R in the configuration files
are removed.</para></listitem> are removed.</para></listitem>
</varlistentry> </varlistentry>

10
man/systemd.automount.xml
View file

@ -93,7 +93,7 @@
file systems.</para> file systems.</para>
<para>If an automount point is beneath another mount <para>If an automount point is beneath another mount
point in the file system hierarchy a dependency point in the file system hierarchy, a dependency
between both units is created automatically.</para> between both units is created automatically.</para>
</refsect1> </refsect1>
@ -110,7 +110,7 @@
<citerefentry><refentrytitle>systemd.mount</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para> <citerefentry><refentrytitle>systemd.mount</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
<para>If an automount point is configured in both <para>If an automount point is configured in both
<filename>/etc/fstab</filename> and a unit file the <filename>/etc/fstab</filename> and a unit file, the
configuration in the latter takes precedence.</para> configuration in the latter takes precedence.</para>
</refsect1> </refsect1>
@ -129,9 +129,9 @@
<term><varname>Where=</varname></term> <term><varname>Where=</varname></term>
<listitem><para>Takes an absolute path <listitem><para>Takes an absolute path
of a directory of the automount of a directory of the automount
point. If the automount point is not point. If the automount point does not
existing at time that the automount exist at time that the automount
point is installed it is created. This point is installed, it is created. This
string must be reflected in the unit string must be reflected in the unit
filename. (See above.) This option is filename. (See above.) This option is
mandatory.</para></listitem> mandatory.</para></listitem>

4
man/systemd.device.xml
View file

@ -124,11 +124,11 @@
<varlistentry> <varlistentry>
<term><varname>SYSTEMD_READY=</varname></term> <term><varname>SYSTEMD_READY=</varname></term>
<listitem><para>If set to 0 systemd <listitem><para>If set to 0, systemd
will consider this device unplugged will consider this device unplugged
even if it shows up in the udev even if it shows up in the udev
tree. If this property is unset or set tree. If this property is unset or set
to 1 the device will be considered to 1, the device will be considered
plugged the moment it shows up in the plugged the moment it shows up in the
udev tree. This property has no udev tree. This property has no
influence on the behavior when a influence on the behavior when a

70
man/systemd.exec.xml
View file

@ -110,7 +110,7 @@
<listitem><para>Takes an absolute <listitem><para>Takes an absolute
directory path. Sets the working directory path. Sets the working
directory for executed processes. If directory for executed processes. If
not set defaults to the root directory not set, defaults to the root directory
when systemd is running as a system when systemd is running as a system
instance and the respective user's instance and the respective user's
home directory if run as home directory if run as
@ -125,7 +125,7 @@
directory for executed processes, with directory for executed processes, with
the the
<citerefentry><refentrytitle>chroot</refentrytitle><manvolnum>2</manvolnum></citerefentry> <citerefentry><refentrytitle>chroot</refentrytitle><manvolnum>2</manvolnum></citerefentry>
system call. If this is used it must system call. If this is used, it must
be ensured that the process and all be ensured that the process and all
its auxiliary files are available in its auxiliary files are available in
the <function>chroot()</function> the <function>chroot()</function>
@ -254,7 +254,7 @@
<term><varname>CPUSchedulingResetOnFork=</varname></term> <term><varname>CPUSchedulingResetOnFork=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If true elevated CPU argument. If true, elevated CPU
scheduling priorities and policies scheduling priorities and policies
will be reset when the executed will be reset when the executed
processes fork, and can hence not leak processes fork, and can hence not leak
@ -273,7 +273,7 @@
be specified more than once in which be specified more than once in which
case the specificed CPU affinity masks case the specificed CPU affinity masks
are merged. If the empty string is are merged. If the empty string is
assigned the mask is reset, all assigned, the mask is reset, all
assignments prior to this will have no assignments prior to this will have no
effect. See effect. See
<citerefentry><refentrytitle>sched_setaffinity</refentrytitle><manvolnum>2</manvolnum></citerefentry> <citerefentry><refentrytitle>sched_setaffinity</refentrytitle><manvolnum>2</manvolnum></citerefentry>
@ -301,15 +301,15 @@
option may be specified more than once option may be specified more than once
in which case all listed variables in which case all listed variables
will be set. If the same variable is will be set. If the same variable is
set twice the later setting will set twice, the later setting will
override the earlier setting. If the override the earlier setting. If the
empty string is assigned to this empty string is assigned to this
option the list of environment option, the list of environment
variables is reset, all prior variables is reset, all prior
assignments have no effect. assignments have no effect.
Variable expansion is not performed Variable expansion is not performed
inside the strings, however, specifier inside the strings, however, specifier
expansion is possible. $ character has expansion is possible. The $ character has
no special meaning. no special meaning.
If you need to assign a value containing spaces If you need to assign a value containing spaces
to a variable, use double quotes (") to a variable, use double quotes (")
@ -353,7 +353,7 @@
specified more than once in which case specified more than once in which case
all specified files are read. If the all specified files are read. If the
empty string is assigned to this empty string is assigned to this
option the list of file to read is option, the list of file to read is
reset, all prior assignments have no reset, all prior assignments have no
effect.</para> effect.</para>
@ -364,7 +364,7 @@
with with
<varname>Environment=</varname>. If <varname>Environment=</varname>. If
the same variable is set twice from the same variable is set twice from
these files the files will be read in these files, the files will be read in
the order they are specified and the the order they are specified and the
later setting will override the later setting will override the
earlier setting.</para></listitem> earlier setting.</para></listitem>
@ -380,19 +380,19 @@
<option>tty-force</option>, <option>tty-force</option>,
<option>tty-fail</option> or <option>tty-fail</option> or
<option>socket</option>. If <option>socket</option>. If
<option>null</option> is selected <option>null</option> is selected,
standard input will be connected to standard input will be connected to
<filename>/dev/null</filename>, <filename>/dev/null</filename>,
i.e. all read attempts by the process i.e. all read attempts by the process
will result in immediate EOF. If will result in immediate EOF. If
<option>tty</option> is selected <option>tty</option> is selected,
standard input is connected to a TTY standard input is connected to a TTY
(as configured by (as configured by
<varname>TTYPath=</varname>, see <varname>TTYPath=</varname>, see
below) and the executed process below) and the executed process
becomes the controlling process of the becomes the controlling process of the
terminal. If the terminal is already terminal. If the terminal is already
being controlled by another process the being controlled by another process, the
executed process waits until the current executed process waits until the current
controlling process releases the controlling process releases the
terminal. terminal.
@ -414,7 +414,7 @@
file (see file (see
<citerefentry><refentrytitle>systemd.socket</refentrytitle><manvolnum>5</manvolnum></citerefentry> <citerefentry><refentrytitle>systemd.socket</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for details) specifies a single socket for details) specifies a single socket
only. If this option is set standard only. If this option is set, standard
input will be connected to the socket input will be connected to the socket
the service was activated from, which the service was activated from, which
is primarily useful for compatibility is primarily useful for compatibility
@ -439,19 +439,19 @@
<option>kmsg+console</option>, <option>kmsg+console</option>,
<option>journal+console</option> or <option>journal+console</option> or
<option>socket</option>. If set to <option>socket</option>. If set to
<option>inherit</option> the file <option>inherit</option>, the file
descriptor of standard input is descriptor of standard input is
duplicated for standard output. If set duplicated for standard output. If set
to <option>null</option> standard to <option>null</option>, standard
output will be connected to output will be connected to
<filename>/dev/null</filename>, <filename>/dev/null</filename>,
i.e. everything written to it will be i.e. everything written to it will be
lost. If set to <option>tty</option> lost. If set to <option>tty</option>,
standard output will be connected to a standard output will be connected to a
tty (as configured via tty (as configured via
<varname>TTYPath=</varname>, see <varname>TTYPath=</varname>, see
below). If the TTY is used for output below). If the TTY is used for output
only the executed process will not only, the executed process will not
become the controlling process of the become the controlling process of the
terminal, and will not fail or wait terminal, and will not fail or wait
for other processes to release the for other processes to release the
@ -538,7 +538,7 @@
<listitem><para>If the terminal <listitem><para>If the terminal
device specified with device specified with
<varname>TTYPath=</varname> is a <varname>TTYPath=</varname> is a
virtual console terminal try to virtual console terminal, try to
deallocate the TTY before and after deallocate the TTY before and after
execution. This ensures that the execution. This ensures that the
screen and scrollback buffer is screen and scrollback buffer is
@ -549,7 +549,7 @@
<term><varname>SyslogIdentifier=</varname></term> <term><varname>SyslogIdentifier=</varname></term>
<listitem><para>Sets the process name <listitem><para>Sets the process name
to prefix log lines sent to syslog or to prefix log lines sent to syslog or
the kernel log buffer with. If not set the kernel log buffer with. If not set,
defaults to the process name of the defaults to the process name of the
executed process. This option is only executed process. This option is only
useful when useful when
@ -693,13 +693,13 @@
<varlistentry> <varlistentry>
<term><varname>PAMName=</varname></term> <term><varname>PAMName=</varname></term>
<listitem><para>Sets the PAM service <listitem><para>Sets the PAM service
name to set up a session as. If set name to set up a session as. If set,
the executed process will be the executed process will be
registered as a PAM session under the registered as a PAM session under the
specified service name. This is only specified service name. This is only
useful in conjunction with the useful in conjunction with the
<varname>User=</varname> setting. If <varname>User=</varname> setting. If
not set no PAM session will be opened not set, no PAM session will be opened
for the executed processes. See for the executed processes. See
<citerefentry><refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum></citerefentry> <citerefentry><refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum></citerefentry>
for details.</para></listitem> for details.</para></listitem>
@ -708,7 +708,7 @@
<varlistentry> <varlistentry>
<term><varname>TCPWrapName=</varname></term> <term><varname>TCPWrapName=</varname></term>
<listitem><para>If this is a <listitem><para>If this is a
socket-activated service this sets the socket-activated service, this sets the
tcpwrap service name to check the tcpwrap service name to check the
permission for the current connection permission for the current connection
with. This is only useful in with. This is only useful in
@ -718,7 +718,7 @@
socket types (e.g. datagram/UDP) and socket types (e.g. datagram/UDP) and
on processes unrelated to socket-based on processes unrelated to socket-based
activation. If the tcpwrap activation. If the tcpwrap
verification fails daemon start-up verification fails, daemon start-up
will fail and the connection is will fail and the connection is
terminated. See terminated. See
<citerefentry><refentrytitle>tcpd</refentrytitle><manvolnum>8</manvolnum></citerefentry> <citerefentry><refentrytitle>tcpd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
@ -747,7 +747,7 @@
Capabilities listed will be included Capabilities listed will be included
in the bounding set, all others are in the bounding set, all others are
removed. If the list of capabilities removed. If the list of capabilities
is prefixed with <literal>~</literal> is prefixed with <literal>~</literal>,
all but the listed capabilities will all but the listed capabilities will
be included, the effect of the be included, the effect of the
assignment inverted. Note that this assignment inverted. Note that this
@ -756,7 +756,7 @@
permitted and inheritable capability permitted and inheritable capability
sets, on top of what sets, on top of what
<varname>Capabilities=</varname> <varname>Capabilities=</varname>
does. If this option is not used the does. If this option is not used, the
capability bounding set is not capability bounding set is not
modified on process execution, hence modified on process execution, hence
no limits on the capabilities of the no limits on the capabilities of the
@ -764,11 +764,11 @@
appear more than once in which case appear more than once in which case
the bounding sets are merged. If the the bounding sets are merged. If the
empty string is assigned to this empty string is assigned to this
option the bounding set is reset to option, the bounding set is reset to
the empty capability set, and all the empty capability set, and all
prior settings have no effect. If set prior settings have no effect. If set
to <literal>~</literal> (without any to <literal>~</literal> (without any
further argument) the bounding set is further argument), the bounding set is
reset to the full set of available reset to the full set of available
capabilities, also undoing any capabilities, also undoing any
previous settings.</para></listitem> previous settings.</para></listitem>
@ -789,7 +789,7 @@
option may appear more than once in option may appear more than once in
which case the secure bits are which case the secure bits are
ORed. If the empty string is assigned ORed. If the empty string is assigned
to this option the bits are reset to to this option, the bits are reset to
0.</para></listitem> 0.</para></listitem>
</varlistentry> </varlistentry>
@ -846,7 +846,7 @@
directories listed will have limited directories listed will have limited
access from within the namespace. If access from within the namespace. If
the empty string is assigned to this the empty string is assigned to this
option the specific list is reset, and option, the specific list is reset, and
all prior assignments have no all prior assignments have no
effect.</para> effect.</para>
<para>Paths in <para>Paths in
@ -863,7 +863,7 @@
<term><varname>PrivateTmp=</varname></term> <term><varname>PrivateTmp=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If true sets up a new file argument. If true, sets up a new file
system namespace for the executed system namespace for the executed
processes and mounts private processes and mounts private
<filename>/tmp</filename> and <filename>/tmp</filename> and
@ -886,7 +886,7 @@
<term><varname>PrivateNetwork=</varname></term> <term><varname>PrivateNetwork=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If true sets up a new argument. If true, sets up a new
network namespace for the executed network namespace for the executed
processes and configures only the processes and configures only the
loopback network device loopback network device
@ -928,7 +928,7 @@
entries must be created and cleared entries must be created and cleared
before and after execution. If the before and after execution. If the
configured string is longer than four configured string is longer than four
characters it is truncated and the characters, it is truncated and the
terminal four characters are terminal four characters are
used. This setting interprets %I style used. This setting interprets %I style
string replacements. This setting is string replacements. This setting is
@ -976,11 +976,11 @@
termination with the termination with the
<constant>SIGSYS</constant> signal <constant>SIGSYS</constant> signal
(whitelisting). If the first character (whitelisting). If the first character
of the list is <literal>~</literal> of the list is <literal>~</literal>,
the effect is inverted: only the the effect is inverted: only the
listed system calls will result in listed system calls will result in
immediate process termination immediate process termination
(blacklisting). If this option is used (blacklisting). If this option is used,
<varname>NoNewPrivileges=yes</varname> <varname>NoNewPrivileges=yes</varname>
is implied. This feature makes use of is implied. This feature makes use of
the Secure Computing Mode 2 interfaces the Secure Computing Mode 2 interfaces
@ -997,7 +997,7 @@
option may be specified more than once option may be specified more than once
in which case the filter masks are in which case the filter masks are
merged. If the empty string is merged. If the empty string is
assigned the filter is reset, all assigned, the filter is reset, all
prior assignments will have no prior assignments will have no
effect.</para></listitem> effect.</para></listitem>
</varlistentry> </varlistentry>

6
man/systemd.kill.xml
View file

@ -94,16 +94,16 @@
<option>none</option>.</para> <option>none</option>.</para>
<para>If set to <para>If set to
<option>control-group</option> all <option>control-group</option>, all
remaining processes in the control remaining processes in the control
group of this unit will be terminated group of this unit will be terminated
on unit stop (for services: after the on unit stop (for services: after the
stop command is executed, as stop command is executed, as
configured with configured with
<varname>ExecStop=</varname>). If set <varname>ExecStop=</varname>). If set
to <option>process</option> only the to <option>process</option>, only the
main process itself is killed. If set main process itself is killed. If set
to <option>none</option> no process is to <option>none</option>, no process is
killed. In this case only the stop killed. In this case only the stop
command will be executed on unit command will be executed on unit
stop, but no process be killed stop, but no process be killed

6
man/systemd.mount.xml
View file

@ -151,7 +151,7 @@
<citerefentry><refentrytitle>systemd.automount</refentrytitle><manvolnum>5</manvolnum></citerefentry> <citerefentry><refentrytitle>systemd.automount</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for details. If for details. If
<option>x-systemd.device-timeout=</option> is <option>x-systemd.device-timeout=</option> is
specified it may be used to configure how long systemd specified, it may be used to configure how long systemd
should wait for a device to show up before giving up should wait for a device to show up before giving up
on an entry from on an entry from
<filename>/etc/fstab</filename>. Specify a time in <filename>/etc/fstab</filename>. Specify a time in
@ -161,9 +161,9 @@
<para>If a mount point is configured in both <para>If a mount point is configured in both
<filename>/etc/fstab</filename> and a unit file that <filename>/etc/fstab</filename> and a unit file that
is stored below <filename>/usr</filename> the former is stored below <filename>/usr</filename>, the former
will take precedence. If the unit file is stored below will take precedence. If the unit file is stored below
<filename>/etc</filename> it will take <filename>/etc</filename>, it will take
precedence. This means: native unit files take precedence. This means: native unit files take
precedence over traditional configuration files, but precedence over traditional configuration files, but
this is superseded by the rule that configuration in this is superseded by the rule that configuration in

8
man/systemd.path.xml
View file

@ -120,7 +120,7 @@
<varname>PathExists=</varname> may be <varname>PathExists=</varname> may be
used to watch the mere existence of a used to watch the mere existence of a
file or directory. If the file file or directory. If the file
specified exists the configured unit specified exists, the configured unit
is is
activated. <varname>PathExistsGlob=</varname> activated. <varname>PathExistsGlob=</varname>
works similar, but checks for the works similar, but checks for the
@ -151,7 +151,7 @@
combined, of the same and of different combined, of the same and of different
types, to watch multiple paths. If the types, to watch multiple paths. If the
empty string is assigned to any of empty string is assigned to any of
these options the list of paths to these options, the list of paths to
watch is reset, and any prior watch is reset, and any prior
assignments of these options will not assignments of these options will not
have any effect.</para> have any effect.</para>
@ -199,7 +199,7 @@
<term><varname>MakeDirectory=</varname></term> <term><varname>MakeDirectory=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If true the directories to argument. If true, the directories to
watch are created before watch are created before
watching. This option is ignored for watching. This option is ignored for
<varname>PathExists=</varname> <varname>PathExists=</varname>
@ -211,7 +211,7 @@
<listitem><para>If <listitem><para>If
<varname>MakeDirectory=</varname> is <varname>MakeDirectory=</varname> is
enabled use the mode specified here to enabled, use the mode specified here to
create the directories in create the directories in
question. Takes an access mode in question. Takes an access mode in
octal notation. Defaults to octal notation. Defaults to

6
man/systemd.preset.xml
View file

@ -86,7 +86,7 @@
<para>If no preset files exist, <command>systemctl <para>If no preset files exist, <command>systemctl
preset</command> will enable all units that are preset</command> will enable all units that are
installed by default. If this is not desired and all installed by default. If this is not desired and all
units shall rather be disabled it is necessary to ship units shall rather be disabled, it is necessary to ship
a preset file with a single, catchall a preset file with a single, catchall
"<filename>disable *</filename>" line. (See example 1, "<filename>disable *</filename>" line. (See example 1,
below.)</para> below.)</para>
@ -125,10 +125,10 @@
<filename>/etc/</filename> are reserved for the local <filename>/etc/</filename> are reserved for the local
administrator, who may use this logic to override the administrator, who may use this logic to override the
preset files installed by vendor packages. All preset preset files installed by vendor packages. All preset
files are sorted by their filename in alphabetical files are sorted by their filename in lexicographic
order, regardless in which of the directories they order, regardless in which of the directories they
reside. If multiple files specify the same unit name, reside. If multiple files specify the same unit name,
the entry in the file with the alphabetically earliest the entry in the file with the lexicographically earliest
name will be applied. It is recommended to prefix all name will be applied. It is recommended to prefix all
filenames with a two-digit number and a dash, to simplify filenames with a two-digit number and a dash, to simplify
the ordering of the files.</para> the ordering of the files.</para>

62
man/systemd.service.xml
View file

@ -140,13 +140,13 @@
<para>If set to <para>If set to
<option>simple</option> (the default <option>simple</option> (the default
value if <varname>BusName=</varname> value if <varname>BusName=</varname>
is not specified) it is expected that is not specified), it is expected that
the process configured with the process configured with
<varname>ExecStart=</varname> is the <varname>ExecStart=</varname> is the
main process of the service. In this main process of the service. In this
mode, if the process offers mode, if the process offers
functionality to other processes on functionality to other processes on
the system its communication channels the system, its communication channels
should be installed before the daemon should be installed before the daemon
is started up (e.g. sockets set up by is started up (e.g. sockets set up by
systemd, via socket activation), as systemd, via socket activation), as
@ -154,14 +154,14 @@
starting follow-up units.</para> starting follow-up units.</para>
<para>If set to <para>If set to
<option>forking</option> it is <option>forking</option>, it is
expected that the process configured expected that the process configured
with <varname>ExecStart=</varname> with <varname>ExecStart=</varname>
will call <function>fork()</function> will call <function>fork()</function>
as part of its start-up. The parent process is as part of its start-up. The parent process is
expected to exit when start-up is expected to exit when start-up is
complete and all communication complete and all communication
channels set up. The child continues channels are set up. The child continues
to run as the main daemon to run as the main daemon
process. This is the behavior of process. This is the behavior of
traditional UNIX daemons. If this traditional UNIX daemons. If this
@ -210,7 +210,7 @@
starting up. systemd will proceed starting up. systemd will proceed
starting follow-up units after this starting follow-up units after this
notification message has been sent. If notification message has been sent. If
this option is used this option is used,
<varname>NotifyAccess=</varname> (see <varname>NotifyAccess=</varname> (see
below) should be set to open access to below) should be set to open access to
the notification socket provided by the notification socket provided by
@ -220,7 +220,7 @@
<option>main</option>. Note that <option>main</option>. Note that
currently currently
<varname>Type=</varname><option>notify</option> <varname>Type=</varname><option>notify</option>
won't work if used in combination with will not work if used in combination with
<varname>PrivateNetwork=</varname><option>yes</option>.</para> <varname>PrivateNetwork=</varname><option>yes</option>.</para>
<para>Behavior of <para>Behavior of
@ -262,7 +262,7 @@
guessing algorithm might come to guessing algorithm might come to
incorrect conclusions if a daemon incorrect conclusions if a daemon
consists of more than one process. If consists of more than one process. If
the main PID cannot be determined the main PID cannot be determined,
failure detection and automatic failure detection and automatic
restarting of a service will not work restarting of a service will not work
reliably. Defaults to reliably. Defaults to
@ -327,7 +327,7 @@
<filename>.desktop</filename> files. <filename>.desktop</filename> files.
Lone semicolons may be escaped as Lone semicolons may be escaped as
<literal>\;</literal>. If the empty <literal>\;</literal>. If the empty
string is assigned to this option the string is assigned to this option, the
list of commands to start is reset, list of commands to start is reset,
prior assignments of this option will prior assignments of this option will
have no effect.</para> have no effect.</para>
@ -383,19 +383,19 @@
executed process, followed by the executed process, followed by the
further arguments specified. If the further arguments specified. If the
absolute filename is prefixed with absolute filename is prefixed with
<literal>-</literal> an exit code of <literal>-</literal>, an exit code of
the command normally considered a the command normally considered a
failure (i.e. non-zero exit status or failure (i.e. non-zero exit status or
abnormal exit due to signal) is ignored abnormal exit due to signal) is ignored
and considered success. If both and considered success. If both
<literal>-</literal> and <literal>-</literal> and
<literal>@</literal> are used they <literal>@</literal> are used, they
can appear in either order.</para> can appear in either order.</para>
<para>Note that this setting does not <para>Note that this setting does not
directly support shell command directly support shell command
lines. If shell command lines are to lines. If shell command lines are to
be used they need to be passed be used, they need to be passed
explicitly to a shell implementation explicitly to a shell implementation
of some kind. Example:</para> of some kind. Example:</para>
<programlisting>ExecStart=/bin/sh -c 'dmesg | tac' <programlisting>ExecStart=/bin/sh -c 'dmesg | tac'
@ -471,7 +471,7 @@
<varname>KillMode=</varname> setting <varname>KillMode=</varname> setting
(see (see
<citerefentry><refentrytitle>systemd.kill</refentrytitle><manvolnum>5</manvolnum></citerefentry>). If <citerefentry><refentrytitle>systemd.kill</refentrytitle><manvolnum>5</manvolnum></citerefentry>). If
this option is not specified the this option is not specified, the
process is terminated right-away when process is terminated right-away when
service stop is requested. Specifier service stop is requested. Specifier
and environment variable substitution and environment variable substitution
@ -567,11 +567,11 @@
regularly with "WATCHDOG=1" (i.e. the regularly with "WATCHDOG=1" (i.e. the
"keep-alive ping"). If the time "keep-alive ping"). If the time
between two such calls is larger than between two such calls is larger than
the configured time then the service the configured time, then the service
is placed in a failure state. By is placed in a failure state. By
setting <varname>Restart=</varname> to setting <varname>Restart=</varname> to
<option>on-failure</option> or <option>on-failure</option> or
<option>always</option> the service <option>always</option>, the service
will be automatically restarted. The will be automatically restarted. The
time configured here will be passed to time configured here will be passed to
the executed service process in the the executed service process in the
@ -580,7 +580,7 @@
daemons to automatically enable the daemons to automatically enable the
keep-alive pinging logic if watchdog keep-alive pinging logic if watchdog
support is enabled for the service. If support is enabled for the service. If
this option is used this option is used,
<varname>NotifyAccess=</varname> (see <varname>NotifyAccess=</varname> (see
below) should be set to open access to below) should be set to open access to
the notification socket provided by the notification socket provided by
@ -621,9 +621,9 @@
<option>on-watchdog</option>, <option>on-watchdog</option>,
<option>on-abort</option>, or <option>on-abort</option>, or
<option>always</option>. If set to <option>always</option>. If set to
<option>no</option> (the default) the <option>no</option> (the default), the
service will not be restarted. If set to service will not be restarted. If set to
<option>on-success</option> it will be <option>on-success</option>, it will be
restarted only when the service process restarted only when the service process
exits cleanly. exits cleanly.
In this context, a clean exit means In this context, a clean exit means
@ -631,7 +631,7 @@
<constant>SIGHUP</constant>, <constant>SIGINT</constant>, <constant>SIGTERM</constant>, or <constant>SIGPIPE</constant>, and <constant>SIGHUP</constant>, <constant>SIGINT</constant>, <constant>SIGTERM</constant>, or <constant>SIGPIPE</constant>, and
additionally, exit statuses and signals additionally, exit statuses and signals
specified in <varname>SuccessExitStatus=</varname>. specified in <varname>SuccessExitStatus=</varname>.
If set to <option>on-failure</option> If set to <option>on-failure</option>,
the service will be restarted when the the service will be restarted when the
process exits with an nonzero exit code, process exits with an nonzero exit code,
is terminated by a signal (including on is terminated by a signal (including on
@ -639,17 +639,17 @@
service reload) times out, and when the service reload) times out, and when the
configured watchdog timeout is triggered. configured watchdog timeout is triggered.
If set to If set to
<option>on-abort</option> the service <option>on-abort</option>, the service
will be restarted only if the service will be restarted only if the service
process exits due to an uncaught process exits due to an uncaught
signal not specified as a clean exit signal not specified as a clean exit
status. status.
If set to If set to
<option>on-watchdog</option> the service <option>on-watchdog</option>, the service
will be restarted only if the watchdog will be restarted only if the watchdog
timeout for the service expires. timeout for the service expires.
If set to If set to
<option>always</option> the service <option>always</option>, the service
will be restarted regardless whether will be restarted regardless whether
it exited cleanly or not, got it exited cleanly or not, got
terminated abnormally by a signal or terminated abnormally by a signal or
@ -682,7 +682,7 @@
appear more than once in which case appear more than once in which case
the list of successful exit statuses the list of successful exit statuses
is merged. If the empty string is is merged. If the empty string is
assigned to this option the list is assigned to this option, the list is
reset, all prior assignments of this reset, all prior assignments of this
option will have no option will have no
effect.</para></listitem> effect.</para></listitem>
@ -712,7 +712,7 @@
option may appear more than once in option may appear more than once in
which case the list of restart preventing which case the list of restart preventing
statuses is merged. If the empty statuses is merged. If the empty
string is assigned to this option the string is assigned to this option, the
list is reset, all prior assignments list is reset, all prior assignments
of this option will have no of this option will have no
effect.</para></listitem> effect.</para></listitem>
@ -790,13 +790,13 @@
<option>none</option> (the default), <option>none</option> (the default),
<option>main</option> or <option>main</option> or
<option>all</option>. If <option>all</option>. If
<option>none</option> no daemon status <option>none</option>, no daemon status
updates are accepted from the service updates are accepted from the service
processes, all status update messages processes, all status update messages
are ignored. If <option>main</option> are ignored. If <option>main</option>,
only service updates sent from the only service updates sent from the
main process of the service are main process of the service are
accepted. If <option>all</option> all accepted. If <option>all</option>, all
services updates from all members of services updates from all members of
the service's control group are the service's control group are
accepted. This option should be set to accepted. This option should be set to
@ -805,8 +805,8 @@
<varname>Type=notify</varname> or <varname>Type=notify</varname> or
<varname>WatchdogSec=</varname> (see <varname>WatchdogSec=</varname> (see
above). If those options are used but above). If those options are used but
<varname>NotifyAccess=</varname> not <varname>NotifyAccess=</varname> is not
configured it will be implicitly set configured, it will be implicitly set
to to
<option>main</option>.</para></listitem> <option>main</option>.</para></listitem>
</varlistentry> </varlistentry>
@ -841,7 +841,7 @@
<para>This option may appear more than <para>This option may appear more than
once, in which case the list of socket once, in which case the list of socket
units is merged. If the empty string units is merged. If the empty string
is assigned to this option the list of is assigned to this option, the list of
sockets is reset, all prior uses of sockets is reset, all prior uses of
this setting will have no this setting will have no
effect.</para></listitem> effect.</para></listitem>
@ -852,12 +852,12 @@
<term><varname>StartLimitBurst=</varname></term> <term><varname>StartLimitBurst=</varname></term>
<listitem><para>Configure service <listitem><para>Configure service
start rate limiting. By default start rate limiting. By default,
services which are started more often services which are started more often
than 5 times within 10s are not than 5 times within 10s are not
permitted to start any more times permitted to start any more times
until the 10s interval ends. With until the 10s interval ends. With
these two options this rate limiting these two options, this rate limiting
may be modified. Use may be modified. Use
<varname>StartLimitInterval=</varname> <varname>StartLimitInterval=</varname>
to configure the checking interval to configure the checking interval

16
man/systemd.socket.xml
View file

@ -96,7 +96,7 @@
<filename>foo.socket</filename> needs a matching <filename>foo.socket</filename> needs a matching
service <filename>foo.service</filename> if service <filename>foo.service</filename> if
<option>Accept=false</option> is set. If <option>Accept=false</option> is set. If
<option>Accept=true</option> is set a service template <option>Accept=true</option> is set, a service template
file <filename>foo@.service</filename> must exist from file <filename>foo@.service</filename> must exist from
which services are instantiated for each incoming which services are instantiated for each incoming
connection.</para> connection.</para>
@ -164,17 +164,17 @@
family.</para> family.</para>
<para>If the address starts with an at <para>If the address starts with an at
symbol (<literal>@</literal>) it is read as abstract symbol (<literal>@</literal>), it is read as abstract
namespace socket in the namespace socket in the
<constant>AF_UNIX</constant> <constant>AF_UNIX</constant>
family. The <literal>@</literal> is family. The <literal>@</literal> is
replaced with a replaced with a
<constant>NUL</constant> character <constant>NUL</constant> character
before binding. For details see before binding. For details, see
<citerefentry><refentrytitle>unix</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para> <citerefentry><refentrytitle>unix</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
<para>If the address string is a <para>If the address string is a
single number it is read as port single number, it is read as port
number to listen on via number to listen on via
IPv6. Depending on the value of IPv6. Depending on the value of
<varname>BindIPv6Only=</varname> (see below) this <varname>BindIPv6Only=</varname> (see below) this
@ -184,13 +184,13 @@
</para> </para>
<para>If the address string is a <para>If the address string is a
string in the format v.w.x.y:z it is string in the format v.w.x.y:z, it is
read as IPv4 specifier for listening read as IPv4 specifier for listening
on an address v.w.x.y on a port on an address v.w.x.y on a port
z.</para> z.</para>
<para>If the address string is a <para>If the address string is a
string in the format [x]:y it is read string in the format [x]:y, it is read
as IPv6 address x on a port y. Note as IPv6 address x on a port y. Note
that this might make the service that this might make the service
available via IPv4, too, depending on available via IPv4, too, depending on
@ -303,7 +303,7 @@
<option>ipv6-only</option>, they will <option>ipv6-only</option>, they will
be accessible via IPv6 only. If be accessible via IPv6 only. If
<option>default</option> (which is the <option>default</option> (which is the
default, surprise!) the system wide default, surprise!), the system wide
default setting is used, as controlled default setting is used, as controlled
by by
<filename>/proc/sys/net/ipv6/bindv6only</filename>, <filename>/proc/sys/net/ipv6/bindv6only</filename>,
@ -330,7 +330,7 @@
<term><varname>BindToDevice=</varname></term> <term><varname>BindToDevice=</varname></term>
<listitem><para>Specifies a network <listitem><para>Specifies a network
interface name to bind this socket interface name to bind this socket
to. If set traffic will only be to. If set, traffic will only be
accepted from the specified network accepted from the specified network
interfaces. This controls the interfaces. This controls the
SO_BINDTODEVICE socket option (see SO_BINDTODEVICE socket option (see

4
man/systemd.special.xml
View file

@ -939,7 +939,7 @@
<varname>Wants=</varname> type <varname>Wants=</varname> type
dependency. If the unit wants dependency. If the unit wants
to be pulled in by the first to be pulled in by the first
remote mount showing up it remote mount showing up, it
should use should use
<filename>network-online.target</filename> <filename>network-online.target</filename>
(see above).</para> (see above).</para>
@ -1012,7 +1012,7 @@
manager should start this manager should start this
unit. If systemd receives unit. If systemd receives
<constant>SIGTERM</constant> or <constant>SIGINT</constant> when running <constant>SIGTERM</constant> or <constant>SIGINT</constant> when running
as user service daemon it will as user service daemon, it will
start this unit.</para> start this unit.</para>
<para>Normally, this pulls in <para>Normally, this pulls in

4
man/systemd.swap.xml
View file

@ -114,7 +114,7 @@
for details about the conversion.</para> for details about the conversion.</para>
<para>If a swap device or file is configured in both <para>If a swap device or file is configured in both
<filename>/etc/fstab</filename> and a unit file the <filename>/etc/fstab</filename> and a unit file, the
configuration in the latter takes precedence.</para> configuration in the latter takes precedence.</para>
<para>Unless the <option>noauto</option> option is set <para>Unless the <option>noauto</option> option is set
@ -175,7 +175,7 @@
<listitem><para>Configures the time to <listitem><para>Configures the time to
wait for the swapon command to wait for the swapon command to
finish. If a command does not exit finish. If a command does not exit
within the configured time the swap within the configured time, the swap
will be considered failed and be shut will be considered failed and be shut
down again. All commands still running down again. All commands still running
will be terminated forcibly via will be terminated forcibly via

4
man/systemd.time.xml
View file

@ -157,7 +157,7 @@
time span. Correspondingly, a time span that is prefixed time span. Correspondingly, a time span that is prefixed
with <literal>-</literal> is evaluated to the current with <literal>-</literal> is evaluated to the current
time minus the specified time span. Instead of time minus the specified time span. Instead of
prefixing the time span with <literal>-</literal> it prefixing the time span with <literal>-</literal>, it
may also be suffixed with a space and the word may also be suffixed with a space and the word
<literal>ago</literal>.</para> <literal>ago</literal>.</para>
@ -231,7 +231,7 @@
<para>Either time or date specification may be <para>Either time or date specification may be
omitted, in which case the current day and 00:00:00 is omitted, in which case the current day and 00:00:00 is
implied, respectively. If the second component is not implied, respectively. If the second component is not
specified <literal>:00</literal> is assumed.</para> specified, <literal>:00</literal> is assumed.</para>
<para>Timezone names may not be specified.</para> <para>Timezone names may not be specified.</para>

2
man/systemd.timer.xml
View file

@ -128,7 +128,7 @@
combined of the same and of different combined of the same and of different
types. For example, by combining types. For example, by combining
<varname>OnBootSec=</varname> and <varname>OnBootSec=</varname> and
<varname>OnUnitActiveSec=</varname> it is <varname>OnUnitActiveSec=</varname>, it is
possible to define a timer that possible to define a timer that
elapses in regular intervals and elapses in regular intervals and
activates a specific service each activates a specific service each

64
man/systemd.unit.xml
View file

@ -126,9 +126,9 @@
<para>Unit files may contain additional options on top <para>Unit files may contain additional options on top
of those listed here. If systemd encounters an unknown of those listed here. If systemd encounters an unknown
option it will write a warning log message but option, it will write a warning log message but
continue loading the unit. If an option is prefixed continue loading the unit. If an option is prefixed
with <option>X-</option> it is ignored completely by with <option>X-</option>, it is ignored completely by
systemd. Applications may use this to include systemd. Applications may use this to include
additional information in the unit files.</para> additional information in the unit files.</para>
@ -136,7 +136,7 @@
written in various formats. For positive settings the written in various formats. For positive settings the
strings <option>1</option>, <option>yes</option>, strings <option>1</option>, <option>yes</option>,
<option>true</option> and <option>on</option> are <option>true</option> and <option>on</option> are
equivalent. For negative settings the strings equivalent. For negative settings, the strings
<option>0</option>, <option>no</option>, <option>0</option>, <option>no</option>,
<option>false</option> and <option>off</option> are <option>false</option> and <option>off</option> are
equivalent.</para> equivalent.</para>
@ -160,14 +160,14 @@
space character. This may be used to wrap long lines.</para> space character. This may be used to wrap long lines.</para>
<para>Along with a unit file <para>Along with a unit file
<filename>foo.service</filename> the directory <filename>foo.service</filename>, the directory
<filename>foo.service.wants/</filename> may exist. All <filename>foo.service.wants/</filename> may exist. All
unit files symlinked from such a directory are unit files symlinked from such a directory are
implicitly added as dependencies of type implicitly added as dependencies of type
<varname>Wanted=</varname> to the unit. This is useful <varname>Wanted=</varname> to the unit. This is useful
to hook units into the start-up of other units, to hook units into the start-up of other units,
without having to modify their unit files. For details without having to modify their unit files. For details
about the semantics of <varname>Wanted=</varname> see about the semantics of <varname>Wanted=</varname>, see
below. The preferred way to create symlinks in the below. The preferred way to create symlinks in the
<filename>.wants/</filename> directory of a unit file <filename>.wants/</filename> directory of a unit file
is with the <command>enable</command> command of the is with the <command>enable</command> command of the
@ -179,7 +179,7 @@
<filename>.requires/</filename> in this case.</para> <filename>.requires/</filename> in this case.</para>
<para>Along with a unit file <para>Along with a unit file
<filename>foo.service</filename> a directory <filename>foo.service</filename>, a directory
<filename>foo.service.d/</filename> may exist. All <filename>foo.service.d/</filename> may exist. All
files with the suffix <literal>.conf</literal> from files with the suffix <literal>.conf</literal> from
this directory will be parsed after the file itself is this directory will be parsed after the file itself is
@ -206,7 +206,7 @@
file system namespace. Example: a device unit file system namespace. Example: a device unit
<filename>dev-sda.device</filename> refers to a device <filename>dev-sda.device</filename> refers to a device
with the device node <filename noindex='true'>/dev/sda</filename> in with the device node <filename noindex='true'>/dev/sda</filename> in
the file system namespace. If this applies a special the file system namespace. If this applies, a special
way to escape the path name is used, so that the way to escape the path name is used, so that the
result is usable as part of a filename. Basically, result is usable as part of a filename. Basically,
given a path, "/" is replaced by "-", and all given a path, "/" is replaced by "-", and all
@ -219,7 +219,7 @@
<para>Optionally, units may be instantiated from a <para>Optionally, units may be instantiated from a
template file at runtime. This allows creation of template file at runtime. This allows creation of
multiple units from a single configuration file. If multiple units from a single configuration file. If
systemd looks for a unit configuration file it will systemd looks for a unit configuration file, it will
first search for the literal unit name in the first search for the literal unit name in the
filesystem. If that yields no success and the unit filesystem. If that yields no success and the unit
name contains an <literal>@</literal> character, systemd will look for a name contains an <literal>@</literal> character, systemd will look for a
@ -238,7 +238,7 @@
configuration options. See below for details.</para> configuration options. See below for details.</para>
<para>If a unit file is empty (i.e. has the file size <para>If a unit file is empty (i.e. has the file size
0) or is symlinked to <filename>/dev/null</filename> 0) or is symlinked to <filename>/dev/null</filename>,
its configuration will not be loaded and it appears its configuration will not be loaded and it appears
with a load state of <literal>masked</literal>, and with a load state of <literal>masked</literal>, and
cannot be activated. Use this as an effective way to cannot be activated. Use this as an effective way to
@ -461,7 +461,7 @@
the start-up was pulled in indirectly the start-up was pulled in indirectly
by some dependency or automatic by some dependency or automatic
start-up of units that is not start-up of units that is not
requested by the user this dependency requested by the user, this dependency
must be fulfilled and otherwise the must be fulfilled and otherwise the
transaction fails. Hence, this option transaction fails. Hence, this option
may be used to configure dependencies may be used to configure dependencies
@ -624,7 +624,7 @@
type <varname>After=</varname> or type <varname>After=</varname> or
<varname>Before=</varname>. If two <varname>Before=</varname>. If two
units have no ordering dependencies units have no ordering dependencies
between them they are shut down between them, they are shut down
or started up simultaneously, and or started up simultaneously, and
no ordering takes no ordering takes
place. </para></listitem> place. </para></listitem>
@ -672,12 +672,12 @@
<term><varname>OnFailureIsolate=</varname></term> <term><varname>OnFailureIsolate=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If <option>true</option> the argument. If <option>true</option>, the
unit listed in unit listed in
<varname>OnFailure=</varname> will be <varname>OnFailure=</varname> will be
enqueued in isolation mode, i.e. all enqueued in isolation mode, i.e. all
units that are not its dependency will units that are not its dependency will
be stopped. If this is set only a be stopped. If this is set, only a
single unit may be listed in single unit may be listed in
<varname>OnFailure=</varname>. Defaults <varname>OnFailure=</varname>. Defaults
to to
@ -688,7 +688,7 @@
<term><varname>IgnoreOnIsolate=</varname></term> <term><varname>IgnoreOnIsolate=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If <option>true</option> argument. If <option>true</option>,
this unit will not be stopped when this unit will not be stopped when
isolating another unit. Defaults to isolating another unit. Defaults to
<option>false</option>.</para></listitem> <option>false</option>.</para></listitem>
@ -698,7 +698,7 @@
<term><varname>IgnoreOnSnapshot=</varname></term> <term><varname>IgnoreOnSnapshot=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If <option>true</option> argument. If <option>true</option>,
this unit will not be included in this unit will not be included in
snapshots. Defaults to snapshots. Defaults to
<option>true</option> for device and <option>true</option> for device and
@ -710,7 +710,7 @@
<term><varname>StopWhenUnneeded=</varname></term> <term><varname>StopWhenUnneeded=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If <option>true</option> argument. If <option>true</option>,
this unit will be stopped when it is this unit will be stopped when it is
no longer used. Note that in order to no longer used. Note that in order to
minimize the work to be executed, minimize the work to be executed,
@ -729,10 +729,10 @@
<term><varname>RefuseManualStop=</varname></term> <term><varname>RefuseManualStop=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If <option>true</option> argument. If <option>true</option>,
this unit can only be activated this unit can only be activated
or deactivated indirectly. In or deactivated indirectly. In
this case explicit start-up this case, explicit start-up
or termination requested by the or termination requested by the
user is denied, however if it is user is denied, however if it is
started or stopped as a started or stopped as a
@ -752,10 +752,10 @@
<term><varname>AllowIsolate=</varname></term> <term><varname>AllowIsolate=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If <option>true</option> argument. If <option>true</option>,
this unit may be used with the this unit may be used with the
<command>systemctl isolate</command> <command>systemctl isolate</command>
command. Otherwise this will be command. Otherwise, this will be
refused. It probably is a good idea to refused. It probably is a good idea to
leave this disabled except for target leave this disabled except for target
units that shall be used similar to units that shall be used similar to
@ -769,7 +769,7 @@
<term><varname>DefaultDependencies=</varname></term> <term><varname>DefaultDependencies=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If <option>true</option> argument. If <option>true</option>,
(the default), a few default (the default), a few default
dependencies will implicitly be dependencies will implicitly be
created for the unit. The actual created for the unit. The actual
@ -799,7 +799,7 @@
<listitem><para>When clients are <listitem><para>When clients are
waiting for a job of this unit to waiting for a job of this unit to
complete, time out after the specified complete, time out after the specified
time. If this time limit is reached time. If this time limit is reached,
the job will be cancelled, the unit the job will be cancelled, the unit
however will not change state or even however will not change state or even
enter the <literal>failed</literal> enter the <literal>failed</literal>
@ -841,7 +841,7 @@
<listitem><para>Before starting a unit <listitem><para>Before starting a unit
verify that the specified condition is verify that the specified condition is
true. If it is not true the starting true. If it is not true, the starting
of the unit will be skipped, however of the unit will be skipped, however
all ordering dependencies of it are all ordering dependencies of it are
still respected. A failing condition still respected. A failing condition
@ -856,7 +856,7 @@
a file existence condition is a file existence condition is
checked before a unit is started. If checked before a unit is started. If
the specified absolute path name does the specified absolute path name does
not exist the condition will not exist, the condition will
fail. If the absolute path name passed fail. If the absolute path name passed
to to
<varname>ConditionPathExists=</varname> <varname>ConditionPathExists=</varname>
@ -966,7 +966,7 @@
<varname>systemd-nspawn</varname> to <varname>systemd-nspawn</varname> to
test against a specific test against a specific
implementation. If multiple implementation. If multiple
virtualization technologies are nested virtualization technologies are nested,
only the innermost is considered. The only the innermost is considered. The
test may be negated by prepending an test may be negated by prepending an
exclamation mark.</para> exclamation mark.</para>
@ -1016,12 +1016,12 @@
battery powered at the time of battery powered at the time of
activation of the unit. This takes a activation of the unit. This takes a
boolean argument. If set to boolean argument. If set to
<varname>true</varname> the condition <varname>true</varname>, the condition
will hold only if at least one AC will hold only if at least one AC
connector of the system is connected connector of the system is connected
to a power source, or if no AC to a power source, or if no AC
connectors are known. Conversely, if connectors are known. Conversely, if
set to <varname>false</varname> the set to <varname>false</varname>, the
condition will hold only if there is condition will hold only if there is
at least one AC connector known and at least one AC connector known and
all AC connectors are disconnected all AC connectors are disconnected
@ -1032,30 +1032,30 @@
be used to add a constant condition be used to add a constant condition
check value to the unit. It takes a check value to the unit. It takes a
boolean argument. If set to boolean argument. If set to
<varname>false</varname> the condition <varname>false</varname>, the condition
will always fail, otherwise will always fail, otherwise
succeed.</para> succeed.</para>
<para>If multiple conditions are <para>If multiple conditions are
specified the unit will be executed if specified, the unit will be executed if
all of them apply (i.e. a logical AND all of them apply (i.e. a logical AND
is applied). Condition checks can be is applied). Condition checks can be
prefixed with a pipe symbol (|) in prefixed with a pipe symbol (|) in
which case a condition becomes a which case a condition becomes a
triggering condition. If at least one triggering condition. If at least one
triggering condition is defined for a triggering condition is defined for a
unit then the unit will be executed if unit, then the unit will be executed if
at least one of the triggering at least one of the triggering
conditions apply and all of the conditions apply and all of the
non-triggering conditions. If you non-triggering conditions. If you
prefix an argument with the pipe prefix an argument with the pipe
symbol and an exclamation mark the symbol and an exclamation mark, the
pipe symbol must be passed first, the pipe symbol must be passed first, the
exclamation second. Except for exclamation second. Except for
<varname>ConditionPathIsSymbolicLink=</varname>, <varname>ConditionPathIsSymbolicLink=</varname>,
all path checks follow symlinks. If all path checks follow symlinks. If
any of these options is assigned the any of these options is assigned the
empty string the list of conditions is empty string, the list of conditions is
reset completely, all previous reset completely, all previous
condition settings (of any kind) will condition settings (of any kind) will
have no effect.</para></listitem> have no effect.</para></listitem>

18
man/systemd.xml
View file

@ -136,7 +136,7 @@
<term><option>--unit=</option></term> <term><option>--unit=</option></term>
<listitem><para>Set default unit to <listitem><para>Set default unit to
activate on startup. If not specified activate on startup. If not specified,
defaults to defaults to
<filename>default.target</filename>.</para></listitem> <filename>default.target</filename>.</para></listitem>
</varlistentry> </varlistentry>
@ -233,7 +233,7 @@
<listitem><para>Highlight important <listitem><para>Highlight important
log messages. Argument is a boolean log messages. Argument is a boolean
value. If the argument is omitted it value. If the argument is omitted, it
defaults to defaults to
<option>true</option>.</para></listitem> <option>true</option>.</para></listitem>
</varlistentry> </varlistentry>
@ -429,7 +429,7 @@
<filename>multi-user.target</filename> (for limited <filename>multi-user.target</filename> (for limited
console-only boots for use in embedded or server console-only boots for use in embedded or server
environments, or similar; a subset of environments, or similar; a subset of
graphical.target). However it is at the discretion of graphical.target). However, it is at the discretion of
the administrator to configure it as an alias to any the administrator to configure it as an alias to any
other target unit. See other target unit. See
<citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry> <citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>
@ -1030,9 +1030,9 @@
<term><varname>systemd.dump_core=</varname></term> <term><varname>systemd.dump_core=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If <option>true</option> argument. If <option>true</option>,
systemd dumps core when it systemd dumps core when it
crashes. Otherwise no core dump is crashes. Otherwise, no core dump is
created. Defaults to created. Defaults to
<option>true</option>.</para></listitem> <option>true</option>.</para></listitem>
</varlistentry> </varlistentry>
@ -1041,9 +1041,9 @@
<term><varname>systemd.crash_shell=</varname></term> <term><varname>systemd.crash_shell=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If <option>true</option> argument. If <option>true</option>,
systemd spawns a shell when it systemd spawns a shell when it
crashes. Otherwise no shell is crashes. Otherwise, no shell is
spawned. Defaults to spawned. Defaults to
<option>false</option>, for security <option>false</option>, for security
reasons, as the shell is not protected reasons, as the shell is not protected
@ -1065,7 +1065,7 @@
<term><varname>systemd.confirm_spawn=</varname></term> <term><varname>systemd.confirm_spawn=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If <option>true</option> argument. If <option>true</option>,
asks for confirmation when spawning asks for confirmation when spawning
processes. Defaults to processes. Defaults to
<option>false</option>.</para></listitem> <option>false</option>.</para></listitem>
@ -1075,7 +1075,7 @@
<term><varname>systemd.show_status=</varname></term> <term><varname>systemd.show_status=</varname></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If <option>true</option> argument. If <option>true</option>,
shows terse service status updates on shows terse service status updates on
the console during bootup. Defaults to the console during bootup. Defaults to
<option>true</option>, unless <option>true</option>, unless

16
man/timedatectl.xml
View file

@ -122,10 +122,10 @@
<listitem><para>If <listitem><para>If
<command>set-local-rtc</command> is <command>set-local-rtc</command> is
invoked and this option is passed the invoked and this option is passed, the
system clock is synchronized from the system clock is synchronized from the
RTC again, taking the new setting into RTC again, taking the new setting into
account. Otherwise the RTC is account. Otherwise, the RTC is
synchronized from the system synchronized from the system
clock.</para></listitem> clock.</para></listitem>
</varlistentry> </varlistentry>
@ -161,7 +161,7 @@
timezones can be listed with timezones can be listed with
<command>list-timezones</command>. If <command>list-timezones</command>. If
the RTC is configured to be in the the RTC is configured to be in the
local time this will also update the local time, this will also update the
RTC time. This call will alter the RTC time. This call will alter the
<filename>/etc/localtime</filename> <filename>/etc/localtime</filename>
symlink. See symlink. See
@ -184,17 +184,17 @@
<term><command>set-local-rtc [BOOL]</command></term> <term><command>set-local-rtc [BOOL]</command></term>
<listitem><para>Takes a boolean <listitem><para>Takes a boolean
argument. If <literal>0</literal> the argument. If <literal>0</literal>, the
system is configured to maintain the system is configured to maintain the
RTC in universal time, if RTC in universal time. If
<literal>1</literal> it will maintain <literal>1</literal>, it will maintain
the RTC in local time instead. Note the RTC in local time instead. Note
that maintaining the RTC in the local that maintaining the RTC in the local
timezone is not fully supported and timezone is not fully supported and
will create various problems with time will create various problems with time
zone changes and daylight saving zone changes and daylight saving
adjustments. If at all possible use adjustments. If at all possible, keep the
RTC in UTC. Note that invoking this RTC in UTC mode. Note that invoking this
will also synchronize the RTC from the will also synchronize the RTC from the
system clock, unless system clock, unless
<option>--adjust-system-clock</option> is <option>--adjust-system-clock</option> is

24
man/tmpfiles.d.xml
View file

@ -79,14 +79,14 @@
administrator, who may use this logic to override the administrator, who may use this logic to override the
configuration files installed by vendor packages. All configuration files installed by vendor packages. All
configuration files are sorted by their filename in configuration files are sorted by their filename in
alphabetical order, regardless in which of the lexicographic order, regardless in which of the
directories they reside. If multiple files specify the directories they reside. If multiple files specify the
same path, the entry in the file with the alphabetically same path, the entry in the file with the lexicographically
earliest name will be applied, all all other conflicting earliest name will be applied, all all other conflicting
entries logged as errors.</para> entries logged as errors.</para>
<para>If the administrator wants to disable a <para>If the administrator wants to disable a
configuration file supplied by the vendor the configuration file supplied by the vendor, the
recommended way is to place a symlink to recommended way is to place a symlink to
<filename>/dev/null</filename> in <filename>/dev/null</filename> in
<filename>/etc/tmpfiles.d/</filename> bearing the <filename>/etc/tmpfiles.d/</filename> bearing the
@ -238,10 +238,10 @@ L /tmp/foobar - - - - /dev/null</programlisting>
<para>The file access mode to use when <para>The file access mode to use when
creating this file or directory. If omitted or creating this file or directory. If omitted or
when set to - the default is used: 0755 for when set to -, the default is used: 0755 for
directories, 0644 for all other file directories, 0644 for all other file
objects. For z, Z lines if omitted or when set objects. For z, Z lines, if omitted or when set
to - the file access mode will not be to -, the file access mode will not be
modified. This parameter is ignored for x, r, modified. This parameter is ignored for x, r,
R, L lines.</para> R, L lines.</para>
</refsect2> </refsect2>
@ -252,8 +252,8 @@ L /tmp/foobar - - - - /dev/null</programlisting>
<para>The user and group to use for this file <para>The user and group to use for this file
or directory. This may either be a numeric or directory. This may either be a numeric
user/group ID or a user or group name. If user/group ID or a user or group name. If
omitted or when set to - the default 0 (root) omitted or when set to -, the default 0 (root)
is used. For z, Z lines when omitted or when set to - is used. For z, Z lines, when omitted or when set to -,
the file ownership will not be modified. the file ownership will not be modified.
These parameters are ignored for x, r, R, L lines.</para> These parameters are ignored for x, r, R, L lines.</para>
</refsect2> </refsect2>
@ -263,7 +263,7 @@ L /tmp/foobar - - - - /dev/null</programlisting>
<para>The date field, when set, is used to <para>The date field, when set, is used to
decide what files to delete when cleaning. If decide what files to delete when cleaning. If
a file or directory is older than the current a file or directory is older than the current
time minus the age field it is deleted. The time minus the age field, it is deleted. The
field format is a series of integers each field format is a series of integers each
followed by one of the following followed by one of the following
postfixes for the respective time units:</para> postfixes for the respective time units:</para>
@ -280,7 +280,7 @@ L /tmp/foobar - - - - /dev/null</programlisting>
<term><varname>us</varname></term></varlistentry> <term><varname>us</varname></term></varlistentry>
</variablelist> </variablelist>
<para>If multiple integers and units are specified the time <para>If multiple integers and units are specified, the time
values are summed up. If an integer is given without a unit, values are summed up. If an integer is given without a unit,
s is assumed. s is assumed.
</para> </para>
@ -289,11 +289,11 @@ L /tmp/foobar - - - - /dev/null</programlisting>
unconditionally.</para> unconditionally.</para>
<para>The age field only applies to lines starting with <para>The age field only applies to lines starting with
d, D and x. If omitted or set to - no automatic clean-up d, D and x. If omitted or set to -, no automatic clean-up
is done.</para> is done.</para>
<para>If the age field starts with a tilde <para>If the age field starts with a tilde
character (~) the clean-up is only applied to character (~), the clean-up is only applied to
files and directories one level inside the files and directories one level inside the
directory specified, but not the files and directory specified, but not the files and
directories immediately inside it.</para> directories immediately inside it.</para>