Set commas where there should be some.
Some improvements to word order.
users who are logged out cannot continue to consume IPC
resources. This covers SysV memory, semaphores and message
queues as well as POSIX shared memory and message
- queues. Traditionally SysV and POSIX IPC had no life-cycle
- limits, with this functionality this is corrected. This may
- be turned off using the RemoveIPC= switch of logind.conf.
+ queues. Traditionally, SysV and POSIX IPC had no life-cycle
+ limits. With this functionality, that is corrected. This may
+ be turned off by using the RemoveIPC= switch of logind.conf.
* The systemd-machine-id-setup and tmpfiles tools gained a
--root= switch to operate on a specific root directory,
this is appropriate.
* systemd-udevd will now run in a disassociated mount
- namespace. To mount directories from udev rules make sure to
+ namespace. To mount directories from udev rules, make sure to
pull in mount units via SYSTEMD_WANTS properties.
* The kdbus support gained support for uploading policy into
DefaultTimerAccuracySec= has been added that controls the
default AccuracySec= setting of .timer units.
- * Timer units gained a new WakeSystem= switch. If enabled
+ * Timer units gained a new WakeSystem= switch. If enabled,
timers configured this way will cause the system to resume
from system suspend (if the system supports that, which most
do these days).
- * Timer units gained a new Persistent= switch. If enabled
+ * Timer units gained a new Persistent= switch. If enabled,
timers configured this way will save to disk when they have
been last triggered. This information is then used on next
reboot to possible execute overdue timer events, that
* systemd-gpt-auto-generator is now able to discover /srv and
root partitions in addition to /home and swap partitions. It
also supports LUKS-encrypted partitions now. With this in
- place automatic discovery of partitions to mount following
+ place, automatic discovery of partitions to mount following
the Discoverable Partitions Specification
(http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec)
is now a lot more complete. This allows booting without
/etc/fstab and without root= on the kernel command line on
- appropriately prepared systems.
+ systems prepared appropriately.
* systemd-nspawn gained a new --image= switch which allows
booting up disk images and Linux installations on any block
* logind is now a lot more aggressive when suspending the
machine due to a closed laptop lid. Instead of acting only
- on the lid close action it will continuously watch the lid
+ on the lid close action, it will continuously watch the lid
status and act on it. This is useful for laptops where the
power button is on the outside of the chassis so that it can
be reached without opening the lid (such as the Lenovo
- Yoga). On those machines logind will now immediately
+ Yoga). On those machines, logind will now immediately
re-suspend the machine if the power button has been
accidentally pressed while the laptop was suspended and in a
backpack or similar.
* The DeviceAllow= setting in unit files now supports a syntax
to whitelist an entire group of devices node majors at once,
based on the /proc/devices listing. For example, with the
- string "char-pts" it is now possible to whitelist all
+ string "char-pts", it is now possible to whitelist all
current and future pseudo-TTYs at once.
* sd-event learned a new "post" event source. Event sources of
enabled/disabled using systemctl. It still is enabled by
default however.
- * When creating a veth interface pair with systemd-nspawn the
+ * When creating a veth interface pair with systemd-nspawn, the
host side will now be prefixed with "vb-" if
--network-bridge= is used, and with "ve-" if --network-veth
- is used. This way it is easy to distinguish these cases on
+ is used. This way, it is easy to distinguish these cases on
the host, for example to apply different configuration to
them with systemd-networkd.
* The compatibility libraries for libsystemd-journal.so,
libsystem-id128.so, libsystemd-login.so and
libsystemd-daemon.so do not make use of IFUNC
- anymore. Instead we now build libsystemd.so multiple times
+ anymore. Instead, we now build libsystemd.so multiple times
under these alternative names. This means that the footprint
is drastically increased, but given that these are
- transitional compatibility libraries this should not matter
+ transitional compatibility libraries, this should not matter
much. This change has been made necessary to support the ARM
platform for these compatibility libraries, as the ARM
toolchain is not really at the same level as the toolchain
* systemd-nspawn gained a new --personality= switch for
setting the kernel personality for the container. This is
useful when running a 32-bit container on a 64-bit host. A
- similar option Personality= is now also available in service
- units.
+ similar option Personality= is now also available for service
+ units to use.
* logind will now also track a "Desktop" identifier for each
session which encodes the desktop environment of it. This is
* For usage together with SystemCallFilter=, a new
SystemCallErrorNumber= setting has been introduced that
- allows configuration of a system error number to return on
- filtered system calls, instead of immediately killing the
+ allows configuration of a system error number to be returned
+ on filtered system calls, instead of immediately killing the
process. Also, SystemCallArchitectures= has been added to
limit access to system calls of a particular architecture
(in order to turn off support for unused secondary
supported anymore by the basic set of Linux OS components.
systemd requires that the /run mount point exists. systemd also
- requires that /var/run is a a symlink → /run.
+ requires that /var/run is a a symlink to /run.
For more information on this issue consult
http://freedesktop.org/wiki/Software/systemd/separate-usr-is-broken
physical RAM. Defaults to 10%. Note
that this size is a safety limit
only. As each runtime directory is a
- tmpfs file system it will only consume
+ tmpfs file system, it will only consume
as much memory as it is filled up
to.</para></listitem>
</varlistentry>
System V and POSIX IPC objects
belonging to the user shall be removed
when she or he fully logs out. Takes a
- boolean argument. If enabled the user
+ boolean argument. If enabled, the user
may not consume IPC resources after
the last of his sessions
terminated. This covers System V
<title>Description</title>
<para>The <structname>sd_bus_error</structname> structure carries
- information for a <filename>sd-bus</filename> error.
- Functions described below can be used to set and query fields in
+ information for a <filename>sd-bus</filename> error. The
+ functions described below can be used to set and query fields in
this structure. The <structfield>name</structfield> field contains a
short identifier of an error. It should follow the rules for error
names described in the D-Bus specification, subsection <ulink
<refsect1>
<title>Description</title>
- <para>Function <function>sd_bus_message_append</function> appends
+ <para>The <function>sd_bus_message_append</function> function appends
a sequence of items to message <parameter>m</parameter>. The
format string <parameter>types</parameter> describes the types of
arguments that follow.</para>
<refsect1>
<title>Description</title>
- <para>Function <function>sd_bus_message_append_array</function>
+ <para>The <function>sd_bus_message_append_array</function> functionc
appends items to message <parameter>m</parameter> as the single
array. A container will be opened, items appended, and the
container closed. Parameter <parameter>type</parameter> determines
into the memory area containing the message and may be changed
after this call.</para>
- <para>Function
- <function>sd_bus_message_append_array_memfd</function> appends
+ <para>The
+ <function>sd_bus_message_append_array_memfd</function> function appends
items to message <parameter>m</parameter>, similarly to
<function>sd_bus_message_append_array</function>. Contents of the
memory file descriptor <parameter>memfd</parameter> are used as
the contents of the array. Their size must be a multiple of the
size of the type <parameter>type</parameter>.</para>
- <para>Descriptor <parameter>memfd</parameter> will be sealed
- and cannot be modified after this call.</para>
+ <para>The descriptor specified with <parameter>memfd</parameter>
+ will be sealed and cannot be modified after this call.</para>
- <para>Function
- <function>sd_bus_message_append_array_iovec</function> appends
+ <para>The
+ <function>sd_bus_message_append_array_iovec</function> function appends
items to message <parameter>m</parameter>, similarly to
<function>sd_bus_message_append_array</function>. Contents of the
iovec <parameter>iov</parameter> are used as the contents of the
sum of <structfield>iov_len</structfield> fields) must be a multiple
of the size of the type <parameter>type</parameter>.</para>
- <para>Pointer <parameter>iov</parameter> must point to
+ <para>The <parameter>iov</parameter> argument must point to
<parameter>n</parameter> <structname>struct iovec</structname>
structures. Each structure may have the
<structname>iov_base</structname> field set, in which case the
memory pointed at by <parameter>iov</parameter> may be changed
after this call.</para>
- <para>Function
- <function>sd_bus_message_append_array_space</function> appends
+ <para>The
+ <function>sd_bus_message_append_array_space</function> function appends
space for an array of items to message <parameter>m</parameter>.
It behaves the same as
<function>sd_bus_message_append_array</function>, but instead
<refsect1>
<title>Return Value</title>
- <para>On success, those calls return 0 or a positive integer. On
+ <para>On success, these calls return 0 or a positive integer. On
failure, they returns a negative errno-style error code.</para>
</refsect1>
character sequence. As a special case, a <constant>NULL</constant>
pointer is interpreted as an empty string. The string should be
valid Unicode string encoded as UTF-8. In case of the two latter
- types, additionally the requirements for a D-Bus object path or
+ types, the additional requirements for a D-Bus object path or
type signature should be satisfied. Those requirements should be
verified by the recepient of the message.
</para>
<refsect1>
<title>Notes</title>
- <para><function>sd_bus_append_basic()</function> function
+ <para>The <function>sd_bus_append_basic()</function> function
described here is available as a shared library, which can be
compiled and linked to with the
<constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
<refsect1>
<title>Description</title>
- <para>Functions
+ <para>The functions
<function>sd_bus_message_append_string_memfd</function> and
<function>sd_bus_message_append_string_iovec</function> can be
used to append a single string (item of type <literal>s</literal>)
to message <parameter>m</parameter>.</para>
<para>In case of
- <function>sd_bus_message_append_string_memfd</function> the
+ <function>sd_bus_message_append_string_memfd</function>, the
contents of <parameter>memfd</parameter> are the string. They must
satisfy the same constraints as described for the
<literal>s</literal> type in
<citerefentry><refentrytitle>sd_bus_message_append_basic</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
<para>In case of
- <function>sd_bus_message_append_string_iovec</function> the
+ <function>sd_bus_message_append_string_iovec</function>, the
payload of <parameter>iov</parameter> is the string. It must
satisfy the same constraints as described for the
<literal>s</literal> type in
<citerefentry><refentrytitle>sd_bus_message_append_basic</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
- <para>Pointer <parameter>iov</parameter> must point to
+ <para>The <parameter>iov</parameter> argument must point to
<parameter>n</parameter> <structname>struct iovec</structname>
structures. Each structure may have the
<structname>iov_base</structname> field set, in which case the
memory pointed at by <parameter>iov</parameter> may be changed
after this call.</para>
- <para>Function
- <function>sd_bus_message_append_string_space</function> appends
- space for a string to message <parameter>m</parameter>. If behaves
- similarly to <function>sd_bus_message_append_basic</function> with
+ <para>The
+ <function>sd_bus_message_append_string_space</function> function appends
+ space for a string to message <parameter>m</parameter>. It behaves
+ similar to <function>sd_bus_message_append_basic</function> with
type <literal>s</literal>, but instead of copying a string into
the message, it returns a pointer to the destination area to
the caller in pointer <parameter>p</parameter>. Space for the string
<refsect1>
<title>Notes</title>
- <para>Functions described here are available as a shared library,
+ <para>The functions described here are available as a shared library,
which can be compiled and linked to with the
<constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
file.</para>
<refsect1>
<title>Description</title>
- <para>Function <function>sd_bus_message_append</function> can be
+ <para>The <function>sd_bus_message_append</function> function can be
used to append an array of strings to message
- <parameter>m</parameter>.
Parameter <parameter>l</parameter>
- points to a <constant>NULL</constant>-terminated array of pointers
+ <parameter>m</parameter>.
The parameter <parameter>l</parameter>
+ shall point to a <constant>NULL</constant>-terminated array of pointers
to <constant>NUL</constant>-terminated strings. Each string must
satisfy the same constraints as described for the
<literal>s</literal> type in
<refsect1>
<title>Notes</title>
- <para><function>sd_bus_append_append_strv()</function> function
+ <para>The <function>sd_bus_append_append_strv()</function> function
described here is available as a shared library, which can be
compiled and linked to with the
<constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
<para><function>sd_bus_negotiate_fds()</function> controls whether
file descriptor passing shall be negotiated for the specified bus
- connection. Takes a bus object and a boolean, which when true
- enables file descriptor passing, and when false disables it. Note
+ connection. It takes a bus object and a boolean, which, when true,
+ enables file descriptor passing, and, when false, disables it. Note
that not all transports and servers support file descriptor
passing. To find out whether file descriptor passing is available
- after negotiation use
+ after negotiation, use
<citerefentry><refentrytitle>sd_bus_can_send</refentrytitle><manvolnum>3</manvolnum></citerefentry>
and pass <constant>SD_BUS_TYPE_UNIX_FD</constant>. Note that file
descriptor passing is always enabled for both sending and
receiving or for neither, but never only in one direction. By
- default file descriptor passing is negotiated for all
+ default, file descriptor passing is negotiated for all
connections.</para>
- <para>Note that when bus activation is used it is highly
+ <para>Note that when bus activation is used, it is highly
recommended to set the <option>AcceptFileDescriptors=</option>
setting in the <filename>.busname</filename> unit file to the same
setting as negotiated by the program ultimately activated. By
- default file descriptor passing is enabled for both.</para>
+ default, file descriptor passing is enabled for both.</para>
<para><function>sd_bus_negotiate_timestamps()</function> controls
whether implicit sender timestamps shall be attached automatically
- to all incoming messages. Takes a bus object and a boolean, which
- when true enables timestamping, and when false disables it. If
+ to all incoming messages. Takes a bus object and a boolean, which,
+ when true, enables timestamping, and, when false, disables it. If
this is disabled,
<citerefentry><refentrytitle>sd_bus_message_get_monotonic_usec</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>sd_bus_message_get_realtime_usec</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>sd_bus_message_get_seqno</refentrytitle><manvolnum>3</manvolnum></citerefentry>
fail with <constant>-ENODATA</constant> on incoming messages. Note
that not all transports support timestamping of messages. On local
- transports the timestamping is applied by the kernel and cannot be
+ transports, the timestamping is applied by the kernel and cannot be
manipulated by userspace.</para>
<para><function>sd_bus_negotiate_creds()</function> controls
fails with <constant>-ENODATA</constant> on incoming
messages. Note that not all transports support attaching sender
credentials to messages, or do not support all types of sender
- credential parameters. On local transports the sender credentials
+ credential parameters. On local transports, the sender credentials
are attached by the kernel and cannot be manipulated by
- userspace. By default no sender credentials are attached.</para>
+ userspace. By default, no sender credentials are attached.</para>
<para>These functions may be called only before the connection has
been started with
prefix and an external identifier string as arguments, plus a
place to store the returned bus path string. The bus path prefix
must be a valid bus path, starting with a slash
- <literal>/</literal>, but not ending in one. The external
- identifier string may be in any format, may be the empty string
- and no restrictions on the charset are made - however it must
+ <literal>/</literal>, and not ending in one. The external
+ identifier string may be in any format, may be the empty string,
+ and has no restrictions on the charset — however, it must
always be <constant>NUL</constant>-terminated. The returned string
will be the concatenation of the bus path prefix plus an escaped
version of the external identifier string. This operation may be
reversed with <function>sd_bus_decode()</function>. It is
- recommended to only use external identifiers here that generally
+ recommended to only use external identifiers that generally
require little escaping to be turned into valid bus path
- identifiers (for example by sticking to a 7-bit ASCII character
+ identifiers (for example, by sticking to a 7-bit ASCII character
set), in order to ensure the resulting bus path is still short and
easily processed.</para>
takes a bus path and a prefix string, plus a place to store the
returned external identifier string. If the bus path does not
start with the specified prefix, 0 is returned and the returned
- string is set to <constant>NULL</constant>. Otherwise the
+ string is set to <constant>NULL</constant>. Otherwise, the
string following the prefix is unescaped and returned in the
external identifier string.</para>
<para>The escaping used will replace all characters which are
- invalid in a bus object path by <literal>_</literal> followed by a
+ invalid in a bus object path by <literal>_</literal>, followed by a
hexadecimal value. As a special case, the empty string will be
replaced by a lone <literal>_</literal>.</para>
</refsect1>
returns positive or 0, and a valid bus path in the return
argument. On success, <function>sd_bus_path_decode()</function>
returns a positive value if the prefixed matched, or 0 if it
- did not. If the prefix matched the external identifier is returned
- in the return parameter. If it did not match NULL is returned in
+ did not. If the prefix matched, the external identifier is returned
+ in the return parameter. If it did not match, NULL is returned in
the return parameter. On failure, a negative errno-style error
number is returned by either function. The returned strings must
be
accuracy value in microseconds specifying a time the timer event
may be delayed. Specify 0 for selecting the default accuracy
(250ms). Specify 1 for most accurate timers. Consider specifying
- 60000000 or larger (1h) for long running events that may be
+ 60000000 or larger (1h) for long-running events that may be
delayed substantially. Picking higher accuracy values allows the
system to coalesce timer events more aggressively, thus improving
power efficiency. The <parameter>handler</parameter> shall
actually have been called at a slightly later time, subject to the
specified accuracy value, the kernel timer slack (see
<citerefentry><refentrytitle>prctl</refentrytitle><manvolnum>2</manvolnum></citerefentry>)
- and additional scheduling latencies. By default the timer will
+ and additional scheduling latencies. By default, the timer will
elapse once (SD_EVENT_ONESHOT), but this may be changed with
<citerefentry><refentrytitle>sd_event_source_set_enabled</refentrytitle><manvolnum>3</manvolnum></citerefentry>. If
- the handler function returns a negative error code it will be
+ the handler function returns a negative error code, it will be
disabled after the invocation, even if SD_EVENT_ON mode is set.
</para>
<para><function>sd_event_new()</function> allocates a new event
loop object. The event loop object is returned in the
- <parameter>event</parameter> parameter. After use drop
+ <parameter>event</parameter> parameter. After use, drop
the returned reference with
<function>sd_event_unref()</function>. When the last reference is
- dropped the event loop is freed.</para>
+ dropped, the event loop is freed.</para>
<para><function>sd_event_default()</function> acquires a reference
to the default event loop object of the calling thread, possibly
allocating a new object if no default event loop object has been
- allocated yet for the thread. After use drop the returned
+ allocated yet for the thread. After use, drop the returned
reference with <function>sd_event_unref()</function>. When the
- last reference is dropped the event loop is freed. If this
+ last reference is dropped, the event loop is freed. If this
function is called while the object returned from a previous call
from the same thread is still referenced, the same object is
returned again, but the reference is increased by one. It is
recommended to use this call instead of
<function>sd_event_new()</function> in order to share event loop
objects between various components that are dispatched in the same
- thread. All threads either have no or one default event loops
+ thread. All threads either have exactly zero or one default event loop
associated, but never more.</para>
<para><function>sd_event_ref()</function> increases the reference
<para><function>sd_event_unref()</function> decreases the
reference counter of the specified event loop object by one. If
- the counter hits zero the event loop object is freed. Note that it
+ the counter hits zero, the event loop object is freed. Note that it
is freed regardless of whether it is the default event loop object for a
thread or not. This means that allocating an event loop with
- <function>sd_event_default()</function>, then releasing it and
+ <function>sd_event_default()</function>, then releasing it, and
then acquiring a new one with
<function>sd_event_default()</function> will result in two
- distinct objects. Note that in order to free an event loop object
+ distinct objects. Note that, in order to free an event loop object,
all remaining event sources of the event loop also need to be
freed as they each keep a reference to it.</para>
</refsect1>
control processes. Note that there is only one control
process per unit at a time, as only one state change is
executed at a time. For services of type
- <varname>Type=forking</varname> the initial process started
+ <varname>Type=forking</varname>, the initial process started
by the manager for <varname>ExecStart=</varname> is a
control process, while the process ultimately forked off by
that one is then considered the main process of the unit (if
it can be determined). This is different for service units
of other types, where the process forked off by the manager
for <varname>ExecStart=</varname> is always the main process
- itself. A service unit consists of no or one main process,
- no or one control process plus any number of additional
+ itself. A service unit consists of zero or one main process,
+ zero or one control process plus any number of additional
processes. Not all unit types manage processes of these
- types however. For example for mount units control processes
+ types however. For example, for mount units, control processes
are defined (which are the invocations of
<filename>/usr/bin/mount</filename> and
<filename>/usr/bin/umount</filename>), but no main process
<para>Show terse runtime status information about one or
more units, followed by most recent log data from the
journal. If no units are specified, show system status. If
- combined with <option>--all</option> also show the status of
+ combined with <option>--all</option>, also show the status of
all units (subject to limitations specified with
<option>-t</option>). If a PID is passed, show information
about the unit the process belongs to.</para>
<row>
<entry>44479540-f297-41b2-9af7-d131d5f0458a</entry>
<entry><filename>Root Partition (x86)</filename></entry>
- <entry>On 32-bit x86 systems the first x86 root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
+ <entry>On 32-bit x86 systems, the first x86 root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
</row>
<row>
<entry>4f68bce3-e8cd-4db1-96e7-fbcaf984b709</entry>
<entry><filename>Root Partition (x86-64)</filename></entry>
- <entry>On 64-bit x86 systems the first x86-64 root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
+ <entry>On 64-bit x86 systems, the first x86-64 root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
</row>
<row>
<entry>69dad710-2ce4-4e3c-b16c-21a1d49abed3</entry>
<entry><filename>Root Partition (32-bit ARM)</filename></entry>
- <entry>On 32-bit ARM systems the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
+ <entry>On 32-bit ARM systems, the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
</row>
<row>
<entry>b921b045-1df0-41c3-af44-4c6f280d3fae</entry>
<entry><filename>Root Partition (64-bit ARM)</filename></entry>
- <entry>On 64-bit ARM systems the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
+ <entry>On 64-bit ARM systems, the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
</row>
<row>
<entry>933ac7e1-2eb4-4f13-b844-0e14e2aef915</entry>
<filename>/boot</filename> if not otherwise mounted.</para>
<para>When using this generator in conjunction with
- btrfs file systems make sure to set the correct
+ btrfs file systems, make sure to set the correct
default subvolumes on them, using <command>btrfs
subvolume set-default</command>.</para>
<command>systemd-journal-remote</command> can read more than one
event stream at a time. They will be interleaved in the output
file. In case of "active" connections, each "source" is one
- stream, and in case of "passive" connections each connection can
+ stream, and in case of "passive" connections, each connection can
result in a separate stream. Sockets can be configured in
"accept" mode (i.e. only one connection), or "listen" mode (i.e.
multiple connections, each resulting in a stream).
<varname>$LISTEN_FDS</varname>/<varname>$LISTEN_PID</varname>.
In the second case, an HTTP or HTTPS server will be spawned on
this port, respectively for <option>--listen-http</option> and
- <option>--listen-https</option>. Currenntly Only POST requests
+ <option>--listen-https</option>. Currenntly, only POST requests
to <filename>/upload</filename> with <literal>Content-Type:
application/vnd.fdo.journal</literal> are supported.</para>
</listitem>
<option>--listen-http=-<replaceable>n</replaceable></option>
or
<option>--listen-https=-<replaceable>n</replaceable></option>
- above. In this later case, an HTTP or HTTPS server will be
+ above. In the latter case, an HTTP or HTTPS server will be
spawned using this descriptor and connections must be made
over the HTTP protocol.</para>
</listitem>
<listitem><para>Will write to this journal. The filename must
end with <filename>.journal</filename>. The file will be
- created if it does not exist. When necessary (journal file
- full, or corrupted) the file will be renamed following normal
+ created if it does not exist. If necessary (journal file
+ full, or corrupted), the file will be renamed following normal
journald rules and a new journal file will be created in its
stead.</para></listitem>
</varlistentry>
<term><option>--output=<replaceable>DIR</replaceable></option></term>
<listitem><para>Will create journal files underneath directory
- <replaceable>DIR</replaceable>. The directory must exist. When
- necessary (journal files over size, or corrupted) journal
+ <replaceable>DIR</replaceable>. The directory must exist. If
+ necessary (journal files over size, or corrupted), journal
files will be rotated following normal journald rules. Names
of files underneath <replaceable>DIR</replaceable> will be
generated using the rules described below.</para></listitem>
</varlistentry>
</variablelist>
- <para>If <option>--output=</option> is not used, output directory
+ <para>If <option>--output=</option> is not used, the output directory
<filename>/var/log/journal/<replaceable>machine-id</replaceable>/</filename>
will be used, where <replaceable>machine-id</replaceable> is the
identifier of the current system (see
based on what passive and active sources are specified. It is
recommended to give a full output filename.</para>
- <para>In case of "active" sources, if the hostname is known it
+ <para>In case of "active" sources, if the hostname is known, it
will be used in the <replaceable>variable</replaceable> part.
Otherwise, local address and port number will be used, or
<literal>stdin</literal> for events passed over standard
<varlistentry>
<term><option>--getter=<replaceable>PROG --option1 --option2</replaceable></option></term>
- <listitem><para>Program to invoke to retrieve data. Journal
+ <listitem><para>Program to invoke to retrieve data. The journal
event stream must be generated on standard output.</para>
<para>Examples:</para>
<para><command>systemd-networkd-wait-online</command> is a
one-shot system service that waits for the network to be configured.
- By default it will wait for all links it is aware of that are managed by
- <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
+ By default, it will wait for all links it is aware of and which are managed by
+ <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
to be fully configured or failed, and for at least one link to gain a
carrier.</para>
</refsect1>
<option>--network-bridge=</option>
implies
<option>--network-veth</option>. If
- this option is used the host side of
+ this option is used, the host side of
the Ethernet link will use the
<literal>vb-</literal> prefix instead
of <literal>ve-</literal>.</para></listitem>
<literal>x86-64</literal> are
supported. This is useful when running
a 32-bit container on a 64-bit
- host. If this setting is not used
+ host. If this setting is not used,
the personality reported in the
container is the same as the one
reported on the
<listitem><para>Provide a description for the service or scope
unit. If not specified, the command itself will be used as a
- description. See <varname>Description=</varname> in
+ description. See <varname>Description=</varname> in
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
</para></listitem>
</varlistentry>
<para>The following command invokes the
<citerefentry><refentrytitle>updatedb</refentrytitle><manvolnum>8</manvolnum></citerefentry>
- tool but lowers the block IO weight for it to 10. See
+ tool, but lowers the block IO weight for it to 10. See
<citerefentry><refentrytitle>systemd.resource-control</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for more information on the <varname>BlockIOWeight=</varname>
property.</para>
processes via
<filename>/tmp</filename> or
<filename>/var/tmp</filename>
- impossible. If this is enabled all
+ impossible. If this is enabled, all
temporary files created by a service
in these directories will be removed
after the service is stopped. Defaults
correctly on x86-64). If running in user
mode and this option is used,
<varname>NoNewPrivileges=yes</varname>
- is implied. By default no
+ is implied. By default, no
restriction applies, all address
families are accessible to
processes. If assigned the empty
- string any previous list changes are
+ string, any previous list changes are
undone.</para>
<para>Use this option to limit
exposure of processes to remote
systems, in particular via exotic
network protocols. Note that in most
- cases the local
+ cases, the local
<constant>AF_UNIX</constant> address
family should be included in the
configured whitelist as it is
<constant>x86</constant> and
<constant>x86-64</constant>. This is
useful when running 32-bit services on
- a 64-bit host system. If not specified
+ a 64-bit host system. If not specified,
the personality is left unmodified and
thus reflects the personality of the
host system's
<term><varname>RuntimeDirectoryMode=</varname></term>
<listitem><para>Takes a list of
- directory names. If set one or more
+ directory names. If set, one or more
directories by the specified names
will be created below
<filename>/run</filename> (for system
services) or below
<varname>$XDG_RUNTIME_DIR</varname>
(for user services) when the unit is
- started and removed when the unit is
+ started, and removed when the unit is
stopped. The directories will have the
access mode specified in
<varname>RuntimeDirectoryMode=</varname>,
<listitem>
<para>The driver currently bound to the device,
as exposed by the udev property <literal>DRIVER</literal>
- of its parent device, or if that is not set the
+ of its parent device, or if that is not set, the
driver as exposed by <literal>ethtool -i</literal>
of the device itself.</para>
</listitem>
<term><varname>Destination=</varname></term>
<listitem>
<para>The destination prefix of the route. Possibly followed by a slash and the
- prefixlength, if ommitted a full-length host route is assumed.</para>
+ prefixlength. If ommitted, a full-length host route is assumed.</para>
</listitem>
</varlistentry>
</variablelist>
<term><varname>WakeSystem=</varname></term>
<listitem><para>Takes a boolean
- argument. If true an elapsing timer
+ argument. If true, an elapsing timer
will cause the system to resume from
suspend, should it be suspended and if
the system supports this. Note that
case the kernel command line is
searched for the word appearing as is,
or as left hand side of an
- assignment. In the latter case the
+ assignment. In the latter case, the
exact assignment is looked for with
right and left hand side
matching.</para>
<para>System daemons frequently require private
runtime directories below <filename>/run</filename> to
- place communication sockets and similar in. For these
+ place communication sockets and similar in. For these,
consider declaring them in their unit files using
<varname>RuntimeDirectory=</varname>
(see <citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry> for details),
~ianmdlvl / elogind.git / commitdiff