diff options
Diffstat (limited to 'man')
-rw-r--r-- | man/logind.conf.xml | 4 | ||||
-rw-r--r-- | man/sd_bus_error.xml | 4 | ||||
-rw-r--r-- | man/sd_bus_message_append.xml | 2 | ||||
-rw-r--r-- | man/sd_bus_message_append_array.xml | 22 | ||||
-rw-r--r-- | man/sd_bus_message_append_basic.xml | 4 | ||||
-rw-r--r-- | man/sd_bus_message_append_string_memfd.xml | 18 | ||||
-rw-r--r-- | man/sd_bus_message_append_strv.xml | 8 | ||||
-rw-r--r-- | man/sd_bus_negotiate_fds.xml | 22 | ||||
-rw-r--r-- | man/sd_bus_path_encode.xml | 18 | ||||
-rw-r--r-- | man/sd_event_add_time.xml | 6 | ||||
-rw-r--r-- | man/sd_event_new.xml | 16 | ||||
-rw-r--r-- | man/systemctl.xml | 10 | ||||
-rw-r--r-- | man/systemd-gpt-auto-generator.xml | 10 | ||||
-rw-r--r-- | man/systemd-journal-remote.xml | 20 | ||||
-rw-r--r-- | man/systemd-networkd-wait-online.service.xml | 4 | ||||
-rw-r--r-- | man/systemd-nspawn.xml | 4 | ||||
-rw-r--r-- | man/systemd-run.xml | 4 | ||||
-rw-r--r-- | man/systemd.exec.xml | 14 | ||||
-rw-r--r-- | man/systemd.link.xml | 2 | ||||
-rw-r--r-- | man/systemd.network.xml | 2 | ||||
-rw-r--r-- | man/systemd.timer.xml | 2 | ||||
-rw-r--r-- | man/systemd.unit.xml | 2 | ||||
-rw-r--r-- | man/tmpfiles.d.xml | 2 |
23 files changed, 100 insertions, 100 deletions
diff --git a/man/logind.conf.xml b/man/logind.conf.xml index 99140917ac..1293e71aa2 100644 --- a/man/logind.conf.xml +++ b/man/logind.conf.xml @@ -312,7 +312,7 @@ 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> @@ -324,7 +324,7 @@ 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 diff --git a/man/sd_bus_error.xml b/man/sd_bus_error.xml index 68f1d7b47d..9be474764b 100644 --- a/man/sd_bus_error.xml +++ b/man/sd_bus_error.xml @@ -232,8 +232,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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 diff --git a/man/sd_bus_message_append.xml b/man/sd_bus_message_append.xml index 2a1e95aa35..b14a6c985c 100644 --- a/man/sd_bus_message_append.xml +++ b/man/sd_bus_message_append.xml @@ -65,7 +65,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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> diff --git a/man/sd_bus_message_append_array.xml b/man/sd_bus_message_append_array.xml index fe84671f3e..455e1bb3af 100644 --- a/man/sd_bus_message_append_array.xml +++ b/man/sd_bus_message_append_array.xml @@ -91,7 +91,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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 @@ -116,19 +116,19 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. 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 @@ -136,7 +136,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. 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 @@ -146,8 +146,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. 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 @@ -159,7 +159,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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> diff --git a/man/sd_bus_message_append_basic.xml b/man/sd_bus_message_append_basic.xml index a8e91f9e97..68e1191602 100644 --- a/man/sd_bus_message_append_basic.xml +++ b/man/sd_bus_message_append_basic.xml @@ -198,7 +198,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. 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> @@ -257,7 +257,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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> diff --git a/man/sd_bus_message_append_string_memfd.xml b/man/sd_bus_message_append_string_memfd.xml index bf185ef6d4..b44c482f28 100644 --- a/man/sd_bus_message_append_string_memfd.xml +++ b/man/sd_bus_message_append_string_memfd.xml @@ -80,27 +80,27 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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 @@ -110,10 +110,10 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. 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 @@ -133,7 +133,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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> diff --git a/man/sd_bus_message_append_strv.xml b/man/sd_bus_message_append_strv.xml index 4fb1390df4..a4e8350f32 100644 --- a/man/sd_bus_message_append_strv.xml +++ b/man/sd_bus_message_append_strv.xml @@ -64,10 +64,10 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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 @@ -94,7 +94,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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> diff --git a/man/sd_bus_negotiate_fds.xml b/man/sd_bus_negotiate_fds.xml index c2061941ab..09563f8f7f 100644 --- a/man/sd_bus_negotiate_fds.xml +++ b/man/sd_bus_negotiate_fds.xml @@ -79,35 +79,35 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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 @@ -119,9 +119,9 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. 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 diff --git a/man/sd_bus_path_encode.xml b/man/sd_bus_path_encode.xml index 7e11906872..5849127bed 100644 --- a/man/sd_bus_path_encode.xml +++ b/man/sd_bus_path_encode.xml @@ -82,16 +82,16 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. 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> @@ -101,12 +101,12 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. 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> @@ -118,8 +118,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. 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 diff --git a/man/sd_event_add_time.xml b/man/sd_event_add_time.xml index 9af8bb9c45..983e486562 100644 --- a/man/sd_event_add_time.xml +++ b/man/sd_event_add_time.xml @@ -121,7 +121,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. 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 @@ -132,10 +132,10 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. 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> diff --git a/man/sd_event_new.xml b/man/sd_event_new.xml index f25631f9ca..35e58ea755 100644 --- a/man/sd_event_new.xml +++ b/man/sd_event_new.xml @@ -83,24 +83,24 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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 @@ -108,13 +108,13 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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> diff --git a/man/systemctl.xml b/man/systemctl.xml index 28a7cca0ed..181de4fcd9 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -385,17 +385,17 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. 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 @@ -724,7 +724,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service <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> diff --git a/man/systemd-gpt-auto-generator.xml b/man/systemd-gpt-auto-generator.xml index 41b83dd383..68fe2705fa 100644 --- a/man/systemd-gpt-auto-generator.xml +++ b/man/systemd-gpt-auto-generator.xml @@ -106,22 +106,22 @@ <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> @@ -158,7 +158,7 @@ <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> diff --git a/man/systemd-journal-remote.xml b/man/systemd-journal-remote.xml index 1f0d93e2f3..972c3227e4 100644 --- a/man/systemd-journal-remote.xml +++ b/man/systemd-journal-remote.xml @@ -86,7 +86,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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). @@ -153,7 +153,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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> @@ -171,7 +171,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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> @@ -193,8 +193,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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> @@ -203,15 +203,15 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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 @@ -223,7 +223,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. 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 @@ -272,7 +272,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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> diff --git a/man/systemd-networkd-wait-online.service.xml b/man/systemd-networkd-wait-online.service.xml index 1d368a23f9..3083588a37 100644 --- a/man/systemd-networkd-wait-online.service.xml +++ b/man/systemd-networkd-wait-online.service.xml @@ -58,8 +58,8 @@ <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> diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml index 1ad8e6ec05..ccd3436d42 100644 --- a/man/systemd-nspawn.xml +++ b/man/systemd-nspawn.xml @@ -358,7 +358,7 @@ <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> @@ -601,7 +601,7 @@ <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 diff --git a/man/systemd-run.xml b/man/systemd-run.xml index 9ca17df55a..e3c006a2e2 100644 --- a/man/systemd-run.xml +++ b/man/systemd-run.xml @@ -123,7 +123,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <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> @@ -244,7 +244,7 @@ Sep 08 07:37:21 bupkis env[19948]: BOOT_IMAGE=/vmlinuz-3.11.0-0.rc5.git6.2.fc20. <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> diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index f794894947..22f076870f 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -845,7 +845,7 @@ 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 @@ -1208,18 +1208,18 @@ 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 @@ -1240,7 +1240,7 @@ <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 @@ -1252,14 +1252,14 @@ <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>, diff --git a/man/systemd.link.xml b/man/systemd.link.xml index 1bee07cf1d..f73182aca9 100644 --- a/man/systemd.link.xml +++ b/man/systemd.link.xml @@ -101,7 +101,7 @@ <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> diff --git a/man/systemd.network.xml b/man/systemd.network.xml index c4e5055d9e..efe6ce755f 100644 --- a/man/systemd.network.xml +++ b/man/systemd.network.xml @@ -299,7 +299,7 @@ <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> diff --git a/man/systemd.timer.xml b/man/systemd.timer.xml index 44f55e05e3..d82b9bdc97 100644 --- a/man/systemd.timer.xml +++ b/man/systemd.timer.xml @@ -274,7 +274,7 @@ <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 diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index 30b6ea16ea..157530be38 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -1019,7 +1019,7 @@ 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> diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index 343fad163c..e54f1ba5c3 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -73,7 +73,7 @@ <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), |