From 79640424059328268b9fb6c5fa8eb777b27a177e Mon Sep 17 00:00:00 2001 From: Jan Engelhardt Date: Thu, 12 Sep 2013 21:12:49 +0200 Subject: [PATCH] man: wording and grammar updates MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit 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) --- man/binfmt.d.xml | 4 +- man/localectl.xml | 2 +- man/machine-info.xml | 8 ++-- man/modules-load.d.xml | 2 +- man/os-release.xml | 24 +++++----- man/runlevel.xml | 2 +- man/sd-daemon.xml | 2 +- man/sd_booted.xml | 2 +- man/sd_is_fifo.xml | 2 +- man/sd_journal_add_match.xml | 12 ++--- man/sd_journal_get_catalog.xml | 6 +-- man/sd_journal_get_data.xml | 4 +- man/sd_journal_get_fd.xml | 4 +- man/sd_journal_get_usage.xml | 2 +- man/sd_journal_open.xml | 2 +- man/sd_journal_print.xml | 4 +- man/sd_journal_seek_head.xml | 12 ++--- man/sd_listen_fds.xml | 18 +++---- man/sd_login_monitor_new.xml | 4 +- man/sd_notify.xml | 8 ++-- man/sd_pid_get_session.xml | 4 +- man/sd_readahead.xml | 2 +- man/sd_seat_get_active.xml | 6 +-- man/sd_session_is_active.xml | 6 +-- man/sd_uid_get_state.xml | 6 +-- man/sysctl.d.xml | 4 +- man/systemctl.xml | 16 +++---- man/systemd-activate.xml | 4 +- man/systemd-analyze.xml | 4 +- man/systemd-ask-password.xml | 4 +- man/systemd-cat.xml | 8 ++-- man/systemd-cgls.xml | 8 ++-- man/systemd-cgtop.xml | 6 +-- man/systemd-cryptsetup-generator.xml | 4 +- man/systemd-delta.xml | 2 +- man/systemd-detect-virt.xml | 6 +-- man/systemd-fsck@.service.xml | 2 +- man/systemd-fstab-generator.xml | 2 +- man/systemd-journald.service.xml | 2 +- man/systemd-machine-id-setup.xml | 4 +- man/systemd-notify.xml | 6 +-- man/systemd-nspawn.xml | 8 ++-- man/systemd-suspend.service.xml | 2 +- man/systemd-system.conf.xml | 8 ++-- man/systemd-tmpfiles.xml | 6 +-- man/systemd.automount.xml | 10 ++-- man/systemd.device.xml | 4 +- man/systemd.exec.xml | 70 ++++++++++++++-------------- man/systemd.kill.xml | 6 +-- man/systemd.mount.xml | 6 +-- man/systemd.path.xml | 8 ++-- man/systemd.preset.xml | 6 +-- man/systemd.service.xml | 62 ++++++++++++------------ man/systemd.socket.xml | 16 +++---- man/systemd.special.xml | 4 +- man/systemd.swap.xml | 4 +- man/systemd.time.xml | 4 +- man/systemd.timer.xml | 2 +- man/systemd.unit.xml | 64 ++++++++++++------------- man/systemd.xml | 18 +++---- man/timedatectl.xml | 16 +++---- man/tmpfiles.d.xml | 24 +++++----- 62 files changed, 289 insertions(+), 289 deletions(-) diff --git a/man/binfmt.d.xml b/man/binfmt.d.xml index 165a8a97b..94f97e0ed 100644 --- a/man/binfmt.d.xml +++ b/man/binfmt.d.xml @@ -88,10 +88,10 @@ administrator, who may use this logic to override the configuration files installed from vendor 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 the same binary type name, the entry in the file with - the alphabetically latest name will be applied. + the lexicographically latest name will be applied. If the administrator wants to disable a configuration file supplied by the vendor, the diff --git a/man/localectl.xml b/man/localectl.xml index a3e07f650..ad4f3d41f 100644 --- a/man/localectl.xml +++ b/man/localectl.xml @@ -136,7 +136,7 @@ If set-keymap or set-x11-keymap is - invoked and this option is passed then + invoked and this option is passed, then the keymap will not be converted from the console to X11, or X11 to console, respectively. diff --git a/man/machine-info.xml b/man/machine-info.xml index 7f396aafd..ddf8f8b3d 100644 --- a/man/machine-info.xml +++ b/man/machine-info.xml @@ -94,13 +94,13 @@ PRETTY_HOSTNAME= A pretty - human-readable UTF8 machine identifier + human-readable UTF-8 machine identifier string. This should contain a name like Lennart's Laptop which is useful to present to the user and does not suffer by the syntax limitations of - internet domain names. If possible the + internet domain names. If possible, the internet hostname as configured in /etc/hostname should be kept similar to this @@ -109,7 +109,7 @@ an Internet hostname of lennarts-computer 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 name for presentation purposes. @@ -122,7 +122,7 @@ this machine according to the XDG Icon Naming Specification. If - this parameter is not set an + this parameter is not set, an application should fall back to computer or a similar icon name. diff --git a/man/modules-load.d.xml b/man/modules-load.d.xml index 0d104c563..33c466f92 100644 --- a/man/modules-load.d.xml +++ b/man/modules-load.d.xml @@ -90,7 +90,7 @@ packages. 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 /dev/null in /etc/modules-load.d/ bearing the diff --git a/man/os-release.xml b/man/os-release.xml index 045dd08f1..c1dd62f71 100644 --- a/man/os-release.xml +++ b/man/os-release.xml @@ -62,7 +62,7 @@ list of environment-like shell-compatible variable assignments. It is possible to source the 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 supported), allowing applications to read the file without implementing a shell compatible execution @@ -72,7 +72,7 @@ a-z, 0-9. All strings should be in UTF-8 format, and non-printable characters should not be used. If double 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 supported to concatenate multiple individually quoted strings. Lines beginning with "#" shall be ignored as @@ -110,7 +110,7 @@ A string identifying the operating system, without a version component, and suitable for - presentation to the user. If not set + presentation to the user. If not set, defaults to NAME=Linux. Example: NAME=Fedora or @@ -143,7 +143,7 @@ excluding any version information and suitable for processing by scripts or usage in generated filenames. If not - set defaults to + set, defaults to ID=linux. Example: ID=fedora or ID=debian. @@ -155,7 +155,7 @@ A space-separated list of operating system identifiers in the same syntax as the - ID= setting. Should + ID= setting. It should list identifiers of operating systems that are closely related to the local operating system in regards to @@ -165,8 +165,8 @@ OS is a derivative from. An OS should generally only list other OS identifiers it itself is a derivative - from, and not any OSes that - are derived from it, but symmetric + of, and not any OSes that + are derived from it, though symmetric relationships are possible. Build scripts and similar should check this variable if they need to identify the @@ -179,11 +179,11 @@ closest. This field is optional. Example: for an operating system with - ID=centos an + ID=centos, an assignment of ID_LIKE="rhel fedora" would be appropriate. For an operating system - with ID=ubuntu an + with ID=ubuntu, an assignment of ID_LIKE=debian is appropriate. @@ -213,7 +213,7 @@ presentation to the user. May or may not contain a release code name or OS version of some kind, as suitable. If - not set defaults to + not set, defaults to PRETTY_NAME="Linux". Example: PRETTY_NAME="Fedora 17 (Beefy Miracle)". @@ -290,7 +290,7 @@ tel:. Only one URL shall be listed in each setting. If multiple resources need to be - referenced it is recommended to + referenced, it is recommended to provide an online landing page linking all available resources. Examples: HOME_URL="https://fedoraproject.org/" @@ -332,7 +332,7 @@ Note that operating system vendors may choose 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 rely on these fields to be set. diff --git a/man/runlevel.xml b/man/runlevel.xml index 6d9fe8572..5efb340df 100644 --- a/man/runlevel.xml +++ b/man/runlevel.xml @@ -111,7 +111,7 @@ $PREVLEVEL If - $PREVLEVEL is set + $PREVLEVEL is set, runlevel will print this value as previous runlevel and ignore utmp. diff --git a/man/sd-daemon.xml b/man/sd-daemon.xml index 136415f0a..6e804e1a6 100644 --- a/man/sd-daemon.xml +++ b/man/sd-daemon.xml @@ -99,7 +99,7 @@ conjunction with STDERR-based logging as implemented by systemd. If a systemd service definition file is configured with StandardError=syslog - or StandardError=kmsg these + or StandardError=kmsg, these prefixes can be used to encode a log level in lines printed. This is similar to the kernel printk()-style logging. See diff --git a/man/sd_booted.xml b/man/sd_booted.xml index 84af8fbd9..64c0cd9d3 100644 --- a/man/sd_booted.xml +++ b/man/sd_booted.xml @@ -111,7 +111,7 @@ If the reference implementation is used as 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. diff --git a/man/sd_is_fifo.xml b/man/sd_is_fifo.xml index a790c370e..2bc860c37 100644 --- a/man/sd_is_fifo.xml +++ b/man/sd_is_fifo.xml @@ -160,7 +160,7 @@ On failure, these calls return a negative 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 zero. diff --git a/man/sd_journal_add_match.xml b/man/sd_journal_add_match.xml index d02285f20..b6c7b06f2 100644 --- a/man/sd_journal_add_match.xml +++ b/man/sd_journal_add_match.xml @@ -94,11 +94,11 @@ only of 0-9, A-Z and the underscore. It may not begin with two underscores or be the empty string. The value 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 - time: if they apply to different fields only entries - with both fields set like this will be iterated, if - they apply to the same fields only entries where the + time: If they apply to different fields, only entries + with both fields set like this will be iterated. If + they apply to the same fields, only entries where the field takes one of the specified values will be iterated. Well known fields are documented in systemd.journal-fields7. Whenever @@ -110,7 +110,7 @@ sd_journal_add_disjunction() 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 sd_journal_add_disjunction() or sd_journal_add_conjunction() are @@ -123,7 +123,7 @@ sd_journal_add_conjunction() 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 sd_journal_add_conjunction() are combined in an AND with all matches added afterwards, diff --git a/man/sd_journal_get_catalog.xml b/man/sd_journal_get_catalog.xml index 53ca3083b..4a7e0a1f8 100644 --- a/man/sd_journal_get_catalog.xml +++ b/man/sd_journal_get_catalog.xml @@ -80,8 +80,8 @@ field names in the catalog entry text enclosed in "@" will be replaced by the respective field values of the current entry. If a field name referenced in the - message catalog entry does not exist it the current - journal entry the "@" will be removed but the field + message catalog entry does not exist, in the current + journal entry, the "@" will be removed, but the field name otherwise left untouched. sd_journal_get_catalog_for_message_id() @@ -104,7 +104,7 @@ and sd_journal_get_catalog_for_message_id() 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. On successful return, ret diff --git a/man/sd_journal_get_data.xml b/man/sd_journal_get_data.xml index 460b709db..0e1111e05 100644 --- a/man/sd_journal_get_data.xml +++ b/man/sd_journal_get_data.xml @@ -179,9 +179,9 @@ sd_journal_get_data() returns 0 on success or a negative errno-style error code. If the current entry does not include the - specified field -ENOENT is returned. If + specified field, -ENOENT is returned. If sd_journal_next3 - has not been called at least once -EADDRNOTAVAIL is + has not been called at least once, -EADDRNOTAVAIL is returned. sd_journal_enumerate_data() returns a positive integer if the next field has been read, 0 when no more fields are known, or a negative diff --git a/man/sd_journal_get_fd.xml b/man/sd_journal_get_fd.xml index c4387b085..764f716a1 100644 --- a/man/sd_journal_get_fd.xml +++ b/man/sd_journal_get_fd.xml @@ -137,8 +137,8 @@ timeout_usec. See clock_gettime2 for details about - CLOCK_MONOTONIC. If there's no - timeout to wait for this will fill in + CLOCK_MONOTONIC. If there is no + timeout to wait for, this will fill in (uint64_t) -1 instead. Note that poll() takes a relative timeout in milliseconds rather than an absolute timeout in diff --git a/man/sd_journal_get_usage.xml b/man/sd_journal_get_usage.xml index 50953f506..180d8b2ff 100644 --- a/man/sd_journal_get_usage.xml +++ b/man/sd_journal_get_usage.xml @@ -67,7 +67,7 @@ determines the total disk space currently used by journal files (in bytes). If SD_JOURNAL_LOCAL_ONLY 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 of all hosts. diff --git a/man/sd_journal_open.xml b/man/sd_journal_open.xml index 28d164add..bb3703d01 100644 --- a/man/sd_journal_open.xml +++ b/man/sd_journal_open.xml @@ -146,7 +146,7 @@ When opening the journal only journal files 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. See diff --git a/man/sd_journal_print.xml b/man/sd_journal_print.xml index 1437342a5..e61a64870 100644 --- a/man/sd_journal_print.xml +++ b/man/sd_journal_print.xml @@ -166,7 +166,7 @@ readable representation of the current error code stored in errno3. If - the message string is passed as NULL or empty string + the message string is passed as NULL or empty string, only the error string representation will be written, prefixed with nothing. An additional journal field 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( Note that these calls implicitly add fields for the source file, function name and code line where 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.h. diff --git a/man/sd_journal_seek_head.xml b/man/sd_journal_seek_head.xml index c4e64096e..03de30a38 100644 --- a/man/sd_journal_seek_head.xml +++ b/man/sd_journal_seek_head.xml @@ -111,30 +111,30 @@ (wallclock) timestamp, i.e. CLOCK_REALTIME. Note that 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. sd_journal_seek_cursor() seeks to the entry located at the specified cursor - string. For details on cursors see + string. For details on cursors, see sd_journal_get_cursor3. If no entry matching the specified cursor is found the call will seek to the next closest entry (in terms of time) instead. To verify whether the newly selected - entry actually matches the cursor use + entry actually matches the cursor, use sd_journal_test_cursor3. Note that these calls do not actually make any entry the new current entry, this needs to be done in a separate step with a subsequent sd_journal_next3 - invocation (or a similar call). Only then entry data + invocation (or a similar call). Only then, entry data may be retrieved via sd_journal_get_data3. If 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 sd_journal_next3 - is used the closest following entry will be sought to, + is used, the closest following entry will be sought to, if sd_journal_previous3 is used the closest preceding entry is sought diff --git a/man/sd_listen_fds.xml b/man/sd_listen_fds.xml index c9b399701..240300dcb 100644 --- a/man/sd_listen_fds.xml +++ b/man/sd_listen_fds.xml @@ -70,7 +70,7 @@ activation logic. If the unset_environment - parameter is non-zero + parameter is non-zero, sd_listen_fds() will unset the $LISTEN_FDS/$LISTEN_PID environment variables before returning (regardless @@ -83,16 +83,16 @@ If a daemon receives more than one file descriptor, they will be passed in the same order as 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 - this checking the functions + this checking, the functions sd_is_fifo3, sd_is_socket3, sd_is_socket_inet3, sd_is_socket_unix3 - 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 - 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 for the service to work, hence it should not be verified. On the other hand, whether a socket is a @@ -112,7 +112,7 @@ $LISTEN_FDS/$LISTEN_PID was not set or was not correctly set for this daemon and 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 starting with file descriptor SD_LISTEN_FDS_START, i.e. file descriptor 3. @@ -132,11 +132,11 @@ Internally, this function checks whether the $LISTEN_PID environment variable 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 $LISTEN_FDS environment variable, then sets the FD_CLOEXEC flag for the parsed 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. For details about the algorithm check the @@ -160,7 +160,7 @@ If the reference implementation is used as 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. diff --git a/man/sd_login_monitor_new.xml b/man/sd_login_monitor_new.xml index e93f93f9c..909a3d9bf 100644 --- a/man/sd_login_monitor_new.xml +++ b/man/sd_login_monitor_new.xml @@ -129,7 +129,7 @@ object. Whenever an event causes the monitor to wake up the event loop via the file descriptor this 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. sd_login_monitor_get_fd() @@ -167,7 +167,7 @@ timeout_usec. See clock_gettime2 for details about - CLOCK_MONOTONIC. If there's no + CLOCK_MONOTONIC. If there is no timeout to wait for this will fill in (uint64_t) -1 instead. Note that poll() takes a relative timeout diff --git a/man/sd_notify.xml b/man/sd_notify.xml index fc0f2f692..55965ffce 100644 --- a/man/sd_notify.xml +++ b/man/sd_notify.xml @@ -77,7 +77,7 @@ notification. If the unset_environment - parameter is non-zero sd_notify() + parameter is non-zero, sd_notify() will unset the $NOTIFY_SOCKET environment variable before returning (regardless whether the function call itself succeeded or @@ -197,7 +197,7 @@ errno-style error code. If $NOTIFY_SOCKET was not set and 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 systems that implement this scheme and those which do not, it is generally recommended to ignore the return @@ -220,7 +220,7 @@ AF_UNIX socket referenced in the $NOTIFY_SOCKET environment variable. If the first character of - $NOTIFY_SOCKET is @ the string is + $NOTIFY_SOCKET is @, the string is understood as Linux abstract namespace socket. The datagram is accompanied by the process credentials of the sending daemon, using SCM_CREDENTIALS. @@ -246,7 +246,7 @@ If the reference implementation is used as 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. diff --git a/man/sd_pid_get_session.xml b/man/sd_pid_get_session.xml index ecd22f7bf..e5c77090d 100644 --- a/man/sd_pid_get_session.xml +++ b/man/sd_pid_get_session.xml @@ -165,14 +165,14 @@ call after use. If the pid 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. Return Value - On success these calls return 0 or a positive + On success, these calls return 0 or a positive integer. On failure, these calls return a negative errno-style error code. diff --git a/man/sd_readahead.xml b/man/sd_readahead.xml index c26d5c63e..bb01bcfd8 100644 --- a/man/sd_readahead.xml +++ b/man/sd_readahead.xml @@ -142,7 +142,7 @@ details about the reference implementation see sd-readahead3 - If -DDISABLE_SYSTEMD is set during compilation + If -DDISABLE_SYSTEMD is set during compilation, this function will always return 0 and otherwise become a NOP. diff --git a/man/sd_seat_get_active.xml b/man/sd_seat_get_active.xml index 3c26fb1e2..1610d3efe 100644 --- a/man/sd_seat_get_active.xml +++ b/man/sd_seat_get_active.xml @@ -65,7 +65,7 @@ const char* seat char*** sessions uid_t** uid - unsigned* n_uids + unsigned int* n_uids @@ -133,7 +133,7 @@ If the seat parameter of any of these functions is passed as - NULL the operation is executed + NULL, the operation is executed for the seat of the session of the calling process, if there is any. @@ -146,7 +146,7 @@ returns 0 or a positive integer. On success sd_seat_get_sessions() returns the number of entries in the session identifier - array. If the test succeeds + array. If the test succeeds, sd_seat_can_multi_session, sd_seat_can_tty and sd_seat_can_graphical return a diff --git a/man/sd_session_is_active.xml b/man/sd_session_is_active.xml index 9362fbcc5..293ce7164 100644 --- a/man/sd_session_is_active.xml +++ b/man/sd_session_is_active.xml @@ -116,7 +116,7 @@ int sd_session_get_vt const char* session - unsigned* vt + unsigned int* vt @@ -217,7 +217,7 @@ If the session parameter of any of these functions is passed as - NULL the operation is executed + NULL, the operation is executed for the session the calling process is a member of, if there is any. @@ -225,7 +225,7 @@ Return Value - If the test succeeds + If the test succeeds, sd_session_is_active() returns a positive integer, if it fails 0. On success sd_session_get_state(), diff --git a/man/sd_uid_get_state.xml b/man/sd_uid_get_state.xml index ba614f932..d4d23f4f1 100644 --- a/man/sd_uid_get_state.xml +++ b/man/sd_uid_get_state.xml @@ -111,7 +111,7 @@ or active on a specific seat. Accepts a Unix user identifier and a seat identifier string as parameters. The require_active - 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 session that is in the foreground and accepting user input) on the specified seat, otherwise (false) only @@ -133,7 +133,7 @@ free3 call after use, including all the strings referenced. If the string array parameter is passed as - NULL the array will not be filled in, but the return + NULL, the array will not be filled in, but the return code still indicates the number of current sessions. Note that instead of an empty array NULL may be returned and should be considered equivalent to an @@ -154,7 +154,7 @@ On success sd_uid_get_state() returns 0 or a - positive integer. If the test succeeds + positive integer. If the test succeeds, sd_uid_is_on_seat() returns a positive integer, if it fails 0. sd_uid_get_sessions() and diff --git a/man/sysctl.d.xml b/man/sysctl.d.xml index 155427cec..854864cff 100644 --- a/man/sysctl.d.xml +++ b/man/sysctl.d.xml @@ -89,10 +89,10 @@ administrator, who may use this logic to override the configuration files installed by vendor packages. All 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 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 number and a dash, to simplify the ordering of the files. diff --git a/man/systemctl.xml b/man/systemctl.xml index 1642a4727..b043581be 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -566,7 +566,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service their configuration. Note that this will reload the service-specific configuration, not the unit configuration file of systemd. If you want systemd to reload the - configuration file of a unit use the + configuration file of a unit, use the daemon-reload command. In other words: for the example case of Apache, this will reload Apache's httpd.conf in the web server, not the @@ -692,12 +692,12 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service Show properties of one or more units, jobs, or the - manager itself. If no argument is specified properties of - the manager will be shown. If a unit name is specified + manager itself. If no argument is specified, properties of + the manager will be shown. If a unit name is specified, 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 to - show those too. To select specific properties to show use + show those too. To select specific properties to show, use . This command is intended to be used whenever computer-parsable output is required. Use status if you are looking for formatted @@ -1075,7 +1075,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service Reload systemd manager configuration. This will reload 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 accessible. This command should not be confused with the load or @@ -1089,9 +1089,9 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service Reexecute the systemd manager. This will serialize the manager state, reexecute the process and deserialize the 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 daemon-reload. - 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. diff --git a/man/systemd-activate.xml b/man/systemd-activate.xml index b62cf44ec..d48774d9d 100644 --- a/man/systemd-activate.xml +++ b/man/systemd-activate.xml @@ -123,8 +123,8 @@ along with systemd; If not, see . Add this variable to the environment of the launched process. If VAR is - followed by = assume that it is a - variable–value pair. Otherwise obtain the value from the + followed by =, assume that it is a + variable–value pair. Otherwise, obtain the value from the environment of systemd-activate itself. diff --git a/man/systemd-analyze.xml b/man/systemd-analyze.xml index 60377093d..aefbfc8af 100644 --- a/man/systemd-analyze.xml +++ b/man/systemd-analyze.xml @@ -206,12 +206,12 @@ dot command (see above), selects which dependencies are shown in the dependency graph. If - is passed + is passed, only dependencies of type After= or Before= are shown. If - is passed only dependencies of type + is passed, only dependencies of type Requires=, RequiresOverridable=, Requisite=, diff --git a/man/systemd-ask-password.xml b/man/systemd-ask-password.xml index 563f9d5d6..8af328dcf 100644 --- a/man/systemd-ask-password.xml +++ b/man/systemd-ask-password.xml @@ -90,7 +90,7 @@ url="http://www.freedesktop.org/wiki/Software/systemd/PasswordAgents">systemd Password Agent Specification. - If a password is queried on a TTY the user may + If a password is queried on a TTY, the user may press TAB to hide the asterisks normally shown for each character typed. Pressing Backspace as first key achieves the same effect. @@ -145,7 +145,7 @@ - If passed accept + If passed, accept cached passwords, i.e. passwords previously typed in. diff --git a/man/systemd-cat.xml b/man/systemd-cat.xml index 876ebfa3c..ffb1dfd50 100644 --- a/man/systemd-cat.xml +++ b/man/systemd-cat.xml @@ -65,11 +65,11 @@ pass the output the previous pipeline element generates to the journal. - If no parameter is passed + If no parameter is passed, systemd-cat will write everything it reads from standard input (STDIN) to the journal. - If parameters are passed they are executed as + If parameters are passed, they are executed as command line with standard output (STDOUT) and standard error output (STDERR) connected to the journal, so that all it writes is stored in the journal. @@ -102,7 +102,7 @@ Specify a short string 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. @@ -141,7 +141,7 @@ Controls whether lines read are parsed for syslog priority level prefixes. If enabled (the - default) a line prefixed with a + default), a line prefixed with a priority prefix such as <5> is logged at priority 5 diff --git a/man/systemd-cgls.xml b/man/systemd-cgls.xml index 2877f2212..fcaf89413 100644 --- a/man/systemd-cgls.xml +++ b/man/systemd-cgls.xml @@ -60,19 +60,19 @@ systemd-cgls recursively 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 plus all their subgroups and their members. The control groups may either be specified by their full file paths or are assumed in the systemd control group hierarchy. If no argument is specified and the current working directory is beneath the control group mount - point /sys/fs/cgroup shows the contents + point /sys/fs/cgroup, shows the contents 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. - By default empty control groups are not + By default, empty control groups are not shown. diff --git a/man/systemd-cgtop.xml b/man/systemd-cgtop.xml index e76517223..0e9e5e611 100644 --- a/man/systemd-cgtop.xml +++ b/man/systemd-cgtop.xml @@ -79,7 +79,7 @@ group in the cpuacct hierarchy, but not in memory nor blkio. If resource monitoring for - these resources is required it is recommended to add + these resources is required, it is recommended to add blkio and memory to the DefaultControllers= setting in /etc/systemd/system.conf (see @@ -197,8 +197,8 @@ tree traversal depth. Specifies how deep systemd-cgtop shall traverse the control group - hierarchies. If 0 is specified only - the root group is monitored, for 1 + hierarchies. If 0 is specified, only + the root group is monitored. For 1, only the first level of control groups is monitored, and so on. Defaults to 3. diff --git a/man/systemd-cryptsetup-generator.xml b/man/systemd-cryptsetup-generator.xml index 795003294..215ac2d12 100644 --- a/man/systemd-cryptsetup-generator.xml +++ b/man/systemd-cryptsetup-generator.xml @@ -80,7 +80,7 @@ Takes a boolean argument. Defaults to yes. If - no disables the + no, disables the generator entirely. rd.luks= is honored only by initial RAM disk @@ -97,7 +97,7 @@ Takes a boolean argument. Defaults to yes. If - no causes the + no, causes the generator to ignore any devices configured in /etc/crypttab diff --git a/man/systemd-delta.xml b/man/systemd-delta.xml index 0c7a54a09..413ebd8de 100644 --- a/man/systemd-delta.xml +++ b/man/systemd-delta.xml @@ -163,7 +163,7 @@ When showing modified files, when a file is overridden show a diff as well. This option takes a - boolean argument. If omitted it defaults + boolean argument. If omitted, it defaults to . diff --git a/man/systemd-detect-virt.xml b/man/systemd-detect-virt.xml index f21493df6..69785ceff 100644 --- a/man/systemd-detect-virt.xml +++ b/man/systemd-detect-virt.xml @@ -75,10 +75,10 @@ lxc-libvirt, systemd-nspawn. - If multiple virtualization solutions are used + If multiple virtualization solutions are used, only the "innermost" is detected and identified. That 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 is passed). @@ -138,7 +138,7 @@ Exit status - If a virtualization technology is detected 0 is + If a virtualization technology is detected, 0 is returned, a non-zero code otherwise. diff --git a/man/systemd-fsck@.service.xml b/man/systemd-fsck@.service.xml index 4d6464c2b..e934352f1 100644 --- a/man/systemd-fsck@.service.xml +++ b/man/systemd-fsck@.service.xml @@ -66,7 +66,7 @@ systemd-fsck will 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 emergency.target. diff --git a/man/systemd-fstab-generator.xml b/man/systemd-fstab-generator.xml index 4bd25bfa8..9ca16c7ea 100644 --- a/man/systemd-fstab-generator.xml +++ b/man/systemd-fstab-generator.xml @@ -90,7 +90,7 @@ Takes a boolean argument. Defaults to yes. If - no causes the + no, causes the generator to ignore any mounts or swaps configured in /etc/fstab. rd.fstab= diff --git a/man/systemd-journald.service.xml b/man/systemd-journald.service.xml index 5634dd0a2..2f877f565 100644 --- a/man/systemd-journald.service.xml +++ b/man/systemd-journald.service.xml @@ -77,7 +77,7 @@ necessary. All objects stored in the journal can be up to 2^64-1 bytes in size. - By default the journal stores log data in + By default, the journal stores log data in /run/log/journal/. Since /run/ is volatile, log data is lost at reboot. To make the data persistent, it diff --git a/man/systemd-machine-id-setup.xml b/man/systemd-machine-id-setup.xml index 25fb63af2..fef76bcfc 100644 --- a/man/systemd-machine-id-setup.xml +++ b/man/systemd-machine-id-setup.xml @@ -69,12 +69,12 @@ initialized. 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 /etc/machine-id. If run inside a KVM virtual machine and a UUID - is passed via the option this + is passed via the option, this UUID is used to initialize the machine ID instead of a randomly generated one. The caller must ensure that the UUID passed is sufficiently unique and is different diff --git a/man/systemd-notify.xml b/man/systemd-notify.xml index b03492c5c..a76934649 100644 --- a/man/systemd-notify.xml +++ b/man/systemd-notify.xml @@ -119,7 +119,7 @@ Inform the init system about the main PID of the 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 systemd-notify is used. This is equivalent to @@ -148,10 +148,10 @@ Returns 0 if the system was booted up with systemd, 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 options. For details about the - semantics of this option see + semantics of this option, see sd_booted3. diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml index 6264e48db..7d450f912 100644 --- a/man/systemd-nspawn.xml +++ b/man/systemd-nspawn.xml @@ -151,7 +151,7 @@ containers. We hence recommend turning it off entirely by booting with audit=0 on the 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 refuse log-in attempts. @@ -192,7 +192,7 @@ Directory to use as file system root for the namespace - container. If omitted the current + container. If omitted, the current directory will be used. @@ -233,7 +233,7 @@ host, and is used to initialize the container's hostname (which the container can choose to override, - however). If not specified the last + however). If not specified, the last component of the root directory of the container is used. @@ -308,7 +308,7 @@ Control whether the 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 files from the host (but not vice versa). Takes one of diff --git a/man/systemd-suspend.service.xml b/man/systemd-suspend.service.xml index 9b08f0493..4abc27819 100644 --- a/man/systemd-suspend.service.xml +++ b/man/systemd-suspend.service.xml @@ -96,7 +96,7 @@ /usr/lib/systemd/system-sleep/ are intended for local use only and should be 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. Note that diff --git a/man/systemd-system.conf.xml b/man/systemd-system.conf.xml index a67b15899..c52e59096 100644 --- a/man/systemd-system.conf.xml +++ b/man/systemd-system.conf.xml @@ -133,7 +133,7 @@ Configures controllers that shall be mounted in a single - hierarchy. By default systemd will + hierarchy. By default, systemd will mount all controllers which are enabled in the kernel in individual hierarchies, with the exception of @@ -154,7 +154,7 @@ necessary to rebuild the initrd if this option is changed, and make sure the new configuration file is included - in it. Otherwise the initrd might + in it. Otherwise, the initrd might mount the controller hierarchies in a different configuration than intended, and the main system cannot remount @@ -175,7 +175,7 @@ d, w). If RuntimeWatchdogSec= - is set to a non-zero value the + is set to a non-zero value, the watchdog hardware (/dev/watchdog) will be programmed to automatically @@ -220,7 +220,7 @@ Capabilities listed will be included in the bounding set, all others are 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 effect of the assignment inverted. Note that this option also diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml index 403592dd7..281ab3ca2 100644 --- a/man/systemd-tmpfiles.xml +++ b/man/systemd-tmpfiles.xml @@ -94,7 +94,7 @@ - If this option is passed all + If this option is passed, all files and directories marked with f, F, d, D in the configuration files are created. Files and directories marked with z, @@ -105,7 +105,7 @@ If this option is - passed all files and directories with + passed, all files and directories with an age parameter configured will be cleaned up. @@ -113,7 +113,7 @@ If this option is - passed all files and directories marked + passed, all files and directories marked with r, R in the configuration files are removed. diff --git a/man/systemd.automount.xml b/man/systemd.automount.xml index adba75a71..34105126c 100644 --- a/man/systemd.automount.xml +++ b/man/systemd.automount.xml @@ -93,7 +93,7 @@ file systems. 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. @@ -110,7 +110,7 @@ systemd.mount5. If an automount point is configured in both - /etc/fstab and a unit file the + /etc/fstab and a unit file, the configuration in the latter takes precedence. @@ -129,9 +129,9 @@ Where= Takes an absolute path of a directory of the automount - point. If the automount point is not - existing at time that the automount - point is installed it is created. This + point. If the automount point does not + exist at time that the automount + point is installed, it is created. This string must be reflected in the unit filename. (See above.) This option is mandatory. diff --git a/man/systemd.device.xml b/man/systemd.device.xml index e3cf071bc..96ebe8909 100644 --- a/man/systemd.device.xml +++ b/man/systemd.device.xml @@ -124,11 +124,11 @@ SYSTEMD_READY= - If set to 0 systemd + If set to 0, systemd will consider this device unplugged even if it shows up in the udev 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 udev tree. This property has no influence on the behavior when a diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index ff8b812ef..5721dc155 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -110,7 +110,7 @@ Takes an absolute directory path. Sets the working 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 instance and the respective user's home directory if run as @@ -125,7 +125,7 @@ directory for executed processes, with the chroot2 - system call. If this is used it must + system call. If this is used, it must be ensured that the process and all its auxiliary files are available in the chroot() @@ -254,7 +254,7 @@ CPUSchedulingResetOnFork= Takes a boolean - argument. If true elevated CPU + argument. If true, elevated CPU scheduling priorities and policies will be reset when the executed processes fork, and can hence not leak @@ -273,7 +273,7 @@ be specified more than once in which case the specificed CPU affinity masks 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 effect. See sched_setaffinity2 @@ -301,15 +301,15 @@ option may be specified more than once in which case all listed variables 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 empty string is assigned to this - option the list of environment + option, the list of environment variables is reset, all prior assignments have no effect. Variable expansion is not performed inside the strings, however, specifier - expansion is possible. $ character has + expansion is possible. The $ character has no special meaning. If you need to assign a value containing spaces to a variable, use double quotes (") @@ -353,7 +353,7 @@ specified more than once in which case all specified files are read. If the 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 effect. @@ -364,7 +364,7 @@ with Environment=. If 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 later setting will override the earlier setting. @@ -380,19 +380,19 @@ , or . If - is selected + is selected, standard input will be connected to /dev/null, i.e. all read attempts by the process will result in immediate EOF. If - is selected + is selected, standard input is connected to a TTY (as configured by TTYPath=, see below) and the executed process becomes the controlling process of the terminal. If the terminal is already - being controlled by another process the + being controlled by another process, the executed process waits until the current controlling process releases the terminal. @@ -414,7 +414,7 @@ file (see systemd.socket5 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 the service was activated from, which is primarily useful for compatibility @@ -439,19 +439,19 @@ , or . If set to - the file + , the file descriptor of standard input is duplicated for standard output. If set - to standard + to , standard output will be connected to /dev/null, i.e. everything written to it will be - lost. If set to + lost. If set to , standard output will be connected to a tty (as configured via TTYPath=, see 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 terminal, and will not fail or wait for other processes to release the @@ -538,7 +538,7 @@ If the terminal device specified with TTYPath= is a - virtual console terminal try to + virtual console terminal, try to deallocate the TTY before and after execution. This ensures that the screen and scrollback buffer is @@ -549,7 +549,7 @@ SyslogIdentifier= Sets the process name 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 executed process. This option is only useful when @@ -693,13 +693,13 @@ PAMName= 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 registered as a PAM session under the specified service name. This is only useful in conjunction with the User= setting. If - not set no PAM session will be opened + not set, no PAM session will be opened for the executed processes. See pam8 for details. @@ -708,7 +708,7 @@ TCPWrapName= If this is a - socket-activated service this sets the + socket-activated service, this sets the tcpwrap service name to check the permission for the current connection with. This is only useful in @@ -718,7 +718,7 @@ socket types (e.g. datagram/UDP) and on processes unrelated to socket-based activation. If the tcpwrap - verification fails daemon start-up + verification fails, daemon start-up will fail and the connection is terminated. See tcpd8 @@ -747,7 +747,7 @@ Capabilities listed will be included in the bounding set, all others are removed. If the list of capabilities - is prefixed with ~ + is prefixed with ~, all but the listed capabilities will be included, the effect of the assignment inverted. Note that this @@ -756,7 +756,7 @@ permitted and inheritable capability sets, on top of what Capabilities= - does. If this option is not used the + does. If this option is not used, the capability bounding set is not modified on process execution, hence no limits on the capabilities of the @@ -764,11 +764,11 @@ appear more than once in which case the bounding sets are merged. If the 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 prior settings have no effect. If set to ~ (without any - further argument) the bounding set is + further argument), the bounding set is reset to the full set of available capabilities, also undoing any previous settings. @@ -789,7 +789,7 @@ option may appear more than once in which case the secure bits are ORed. If the empty string is assigned - to this option the bits are reset to + to this option, the bits are reset to 0. @@ -846,7 +846,7 @@ directories listed will have limited access from within the namespace. If 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 effect. Paths in @@ -863,7 +863,7 @@ PrivateTmp= Takes a boolean - argument. If true sets up a new file + argument. If true, sets up a new file system namespace for the executed processes and mounts private /tmp and @@ -886,7 +886,7 @@ PrivateNetwork= Takes a boolean - argument. If true sets up a new + argument. If true, sets up a new network namespace for the executed processes and configures only the loopback network device @@ -928,7 +928,7 @@ entries must be created and cleared before and after execution. If the configured string is longer than four - characters it is truncated and the + characters, it is truncated and the terminal four characters are used. This setting interprets %I style string replacements. This setting is @@ -976,11 +976,11 @@ termination with the SIGSYS signal (whitelisting). If the first character - of the list is ~ + of the list is ~, the effect is inverted: only the listed system calls will result in immediate process termination - (blacklisting). If this option is used + (blacklisting). If this option is used, NoNewPrivileges=yes is implied. This feature makes use of the Secure Computing Mode 2 interfaces @@ -997,7 +997,7 @@ option may be specified more than once in which case the filter masks are merged. If the empty string is - assigned the filter is reset, all + assigned, the filter is reset, all prior assignments will have no effect. diff --git a/man/systemd.kill.xml b/man/systemd.kill.xml index ab3d28f23..1b10fba9d 100644 --- a/man/systemd.kill.xml +++ b/man/systemd.kill.xml @@ -94,16 +94,16 @@ . If set to - all + , all remaining processes in the control group of this unit will be terminated on unit stop (for services: after the stop command is executed, as configured with ExecStop=). If set - to only the + to , only the main process itself is killed. If set - to no process is + to , no process is killed. In this case only the stop command will be executed on unit stop, but no process be killed diff --git a/man/systemd.mount.xml b/man/systemd.mount.xml index 9aac94e1a..e5b5c3c7c 100644 --- a/man/systemd.mount.xml +++ b/man/systemd.mount.xml @@ -151,7 +151,7 @@ systemd.automount5 for details. If 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 on an entry from /etc/fstab. Specify a time in @@ -161,9 +161,9 @@ If a mount point is configured in both /etc/fstab and a unit file that - is stored below /usr the former + is stored below /usr, the former will take precedence. If the unit file is stored below - /etc it will take + /etc, it will take precedence. This means: native unit files take precedence over traditional configuration files, but this is superseded by the rule that configuration in diff --git a/man/systemd.path.xml b/man/systemd.path.xml index 8c782b853..8d86fca5d 100644 --- a/man/systemd.path.xml +++ b/man/systemd.path.xml @@ -120,7 +120,7 @@ PathExists= may be used to watch the mere existence of a file or directory. If the file - specified exists the configured unit + specified exists, the configured unit is activated. PathExistsGlob= works similar, but checks for the @@ -151,7 +151,7 @@ combined, of the same and of different types, to watch multiple paths. If the 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 assignments of these options will not have any effect. @@ -199,7 +199,7 @@ MakeDirectory= Takes a boolean - argument. If true the directories to + argument. If true, the directories to watch are created before watching. This option is ignored for PathExists= @@ -211,7 +211,7 @@ If MakeDirectory= is - enabled use the mode specified here to + enabled, use the mode specified here to create the directories in question. Takes an access mode in octal notation. Defaults to diff --git a/man/systemd.preset.xml b/man/systemd.preset.xml index 8af7d4058..16db8cd85 100644 --- a/man/systemd.preset.xml +++ b/man/systemd.preset.xml @@ -86,7 +86,7 @@ If no preset files exist, systemctl preset will enable all units that are 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 "disable *" line. (See example 1, below.) @@ -125,10 +125,10 @@ /etc/ are reserved for the local administrator, who may use this logic to override the 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 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 filenames with a two-digit number and a dash, to simplify the ordering of the files. diff --git a/man/systemd.service.xml b/man/systemd.service.xml index 1eb5f3962..8eda85f62 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -140,13 +140,13 @@ If set to (the default value if BusName= - is not specified) it is expected that + is not specified), it is expected that the process configured with ExecStart= is the main process of the service. In this mode, if the process offers functionality to other processes on - the system its communication channels + the system, its communication channels should be installed before the daemon is started up (e.g. sockets set up by systemd, via socket activation), as @@ -154,14 +154,14 @@ starting follow-up units. If set to - it is + , it is expected that the process configured with ExecStart= will call fork() as part of its start-up. The parent process is expected to exit when start-up is complete and all communication - channels set up. The child continues + channels are set up. The child continues to run as the main daemon process. This is the behavior of traditional UNIX daemons. If this @@ -210,7 +210,7 @@ starting up. systemd will proceed starting follow-up units after this notification message has been sent. If - this option is used + this option is used, NotifyAccess= (see below) should be set to open access to the notification socket provided by @@ -220,7 +220,7 @@ . Note that currently Type= - won't work if used in combination with + will not work if used in combination with PrivateNetwork=. Behavior of @@ -262,7 +262,7 @@ guessing algorithm might come to incorrect conclusions if a daemon consists of more than one process. If - the main PID cannot be determined + the main PID cannot be determined, failure detection and automatic restarting of a service will not work reliably. Defaults to @@ -327,7 +327,7 @@ .desktop files. Lone semicolons may be escaped as \;. If the empty - string is assigned to this option the + string is assigned to this option, the list of commands to start is reset, prior assignments of this option will have no effect. @@ -383,19 +383,19 @@ executed process, followed by the further arguments specified. If the absolute filename is prefixed with - - an exit code of + -, an exit code of the command normally considered a failure (i.e. non-zero exit status or abnormal exit due to signal) is ignored and considered success. If both - and - @ are used they + @ are used, they can appear in either order. Note that this setting does not directly support shell command 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 of some kind. Example: ExecStart=/bin/sh -c 'dmesg | tac' @@ -471,7 +471,7 @@ KillMode= setting (see systemd.kill5). If - this option is not specified the + this option is not specified, the process is terminated right-away when service stop is requested. Specifier and environment variable substitution @@ -567,11 +567,11 @@ regularly with "WATCHDOG=1" (i.e. the "keep-alive ping"). If the time 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 setting Restart= to or - the service + , the service will be automatically restarted. The time configured here will be passed to the executed service process in the @@ -580,7 +580,7 @@ daemons to automatically enable the keep-alive pinging logic if watchdog support is enabled for the service. If - this option is used + this option is used, NotifyAccess= (see below) should be set to open access to the notification socket provided by @@ -621,9 +621,9 @@ , , or . If set to - (the default) the + (the default), the service will not be restarted. If set to - it will be + , it will be restarted only when the service process exits cleanly. In this context, a clean exit means @@ -631,7 +631,7 @@ SIGHUP, SIGINT, SIGTERM, or SIGPIPE, and additionally, exit statuses and signals specified in SuccessExitStatus=. - If set to + If set to , the service will be restarted when the process exits with an nonzero exit code, is terminated by a signal (including on @@ -639,17 +639,17 @@ service reload) times out, and when the configured watchdog timeout is triggered. If set to - the service + , the service will be restarted only if the service process exits due to an uncaught signal not specified as a clean exit status. If set to - the service + , the service will be restarted only if the watchdog timeout for the service expires. If set to - the service + , the service will be restarted regardless whether it exited cleanly or not, got terminated abnormally by a signal or @@ -682,7 +682,7 @@ appear more than once in which case the list of successful exit statuses 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 option will have no effect. @@ -712,7 +712,7 @@ option may appear more than once in which case the list of restart preventing 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 of this option will have no effect. @@ -790,13 +790,13 @@ (the default), or . If - no daemon status + , no daemon status updates are accepted from the service processes, all status update messages - are ignored. If + are ignored. If , only service updates sent from the main process of the service are - accepted. If all + accepted. If , all services updates from all members of the service's control group are accepted. This option should be set to @@ -805,8 +805,8 @@ Type=notify or WatchdogSec= (see above). If those options are used but - NotifyAccess= not - configured it will be implicitly set + NotifyAccess= is not + configured, it will be implicitly set to . @@ -841,7 +841,7 @@ This option may appear more than once, in which case the list of socket 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 this setting will have no effect. @@ -852,12 +852,12 @@ StartLimitBurst= Configure service - start rate limiting. By default + start rate limiting. By default, services which are started more often than 5 times within 10s are not permitted to start any more times until the 10s interval ends. With - these two options this rate limiting + these two options, this rate limiting may be modified. Use StartLimitInterval= to configure the checking interval diff --git a/man/systemd.socket.xml b/man/systemd.socket.xml index 1fc28c54e..419a38caa 100644 --- a/man/systemd.socket.xml +++ b/man/systemd.socket.xml @@ -96,7 +96,7 @@ foo.socket needs a matching service foo.service if is set. If - is set a service template + is set, a service template file foo@.service must exist from which services are instantiated for each incoming connection. @@ -164,17 +164,17 @@ family. If the address starts with an at - symbol (@) it is read as abstract + symbol (@), it is read as abstract namespace socket in the AF_UNIX family. The @ is replaced with a NUL character - before binding. For details see + before binding. For details, see unix7. 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 IPv6. Depending on the value of BindIPv6Only= (see below) this @@ -184,13 +184,13 @@ 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 on an address v.w.x.y on a port z. 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 that this might make the service available via IPv4, too, depending on @@ -303,7 +303,7 @@ , they will be accessible via IPv6 only. If (which is the - default, surprise!) the system wide + default, surprise!), the system wide default setting is used, as controlled by /proc/sys/net/ipv6/bindv6only, @@ -330,7 +330,7 @@ BindToDevice= Specifies a network 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 interfaces. This controls the SO_BINDTODEVICE socket option (see diff --git a/man/systemd.special.xml b/man/systemd.special.xml index 4d0660714..863a029fe 100644 --- a/man/systemd.special.xml +++ b/man/systemd.special.xml @@ -939,7 +939,7 @@ Wants= type dependency. If the unit wants to be pulled in by the first - remote mount showing up it + remote mount showing up, it should use network-online.target (see above). @@ -1012,7 +1012,7 @@ manager should start this unit. If systemd receives SIGTERM or SIGINT when running - as user service daemon it will + as user service daemon, it will start this unit. Normally, this pulls in diff --git a/man/systemd.swap.xml b/man/systemd.swap.xml index 5e339ea18..18ef5b0f5 100644 --- a/man/systemd.swap.xml +++ b/man/systemd.swap.xml @@ -114,7 +114,7 @@ for details about the conversion. If a swap device or file is configured in both - /etc/fstab and a unit file the + /etc/fstab and a unit file, the configuration in the latter takes precedence. Unless the option is set @@ -175,7 +175,7 @@ Configures the time to wait for the swapon command to 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 down again. All commands still running will be terminated forcibly via diff --git a/man/systemd.time.xml b/man/systemd.time.xml index 3d13b573f..f438fa5bb 100644 --- a/man/systemd.time.xml +++ b/man/systemd.time.xml @@ -157,7 +157,7 @@ time span. Correspondingly, a time span that is prefixed with - is evaluated to the current time minus the specified time span. Instead of - prefixing the time span with - it + prefixing the time span with -, it may also be suffixed with a space and the word ago. @@ -231,7 +231,7 @@ Either time or date specification may be omitted, in which case the current day and 00:00:00 is implied, respectively. If the second component is not - specified :00 is assumed. + specified, :00 is assumed. Timezone names may not be specified. diff --git a/man/systemd.timer.xml b/man/systemd.timer.xml index fa67d59a2..659bc81cc 100644 --- a/man/systemd.timer.xml +++ b/man/systemd.timer.xml @@ -128,7 +128,7 @@ combined of the same and of different types. For example, by combining OnBootSec= and - OnUnitActiveSec= it is + OnUnitActiveSec=, it is possible to define a timer that elapses in regular intervals and activates a specific service each diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index 17141576d..d61426a84 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -126,9 +126,9 @@ Unit files may contain additional options on top 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 - with it is ignored completely by + with , it is ignored completely by systemd. Applications may use this to include additional information in the unit files. @@ -136,7 +136,7 @@ written in various formats. For positive settings the strings , , and are - equivalent. For negative settings the strings + equivalent. For negative settings, the strings , , and are equivalent. @@ -160,14 +160,14 @@ space character. This may be used to wrap long lines. Along with a unit file - foo.service the directory + foo.service, the directory foo.service.wants/ may exist. All unit files symlinked from such a directory are implicitly added as dependencies of type Wanted= to the unit. This is useful to hook units into the start-up of other units, without having to modify their unit files. For details - about the semantics of Wanted= see + about the semantics of Wanted=, see below. The preferred way to create symlinks in the .wants/ directory of a unit file is with the enable command of the @@ -179,7 +179,7 @@ .requires/ in this case. Along with a unit file - foo.service a directory + foo.service, a directory foo.service.d/ may exist. All files with the suffix .conf from this directory will be parsed after the file itself is @@ -206,7 +206,7 @@ file system namespace. Example: a device unit dev-sda.device refers to a device with the device node /dev/sda 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 result is usable as part of a filename. Basically, given a path, "/" is replaced by "-", and all @@ -219,7 +219,7 @@ Optionally, units may be instantiated from a template file at runtime. This allows creation of 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 filesystem. If that yields no success and the unit name contains an @ character, systemd will look for a @@ -238,7 +238,7 @@ configuration options. See below for details. If a unit file is empty (i.e. has the file size - 0) or is symlinked to /dev/null + 0) or is symlinked to /dev/null, its configuration will not be loaded and it appears with a load state of masked, and cannot be activated. Use this as an effective way to @@ -461,7 +461,7 @@ the start-up was pulled in indirectly by some dependency or automatic 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 transaction fails. Hence, this option may be used to configure dependencies @@ -624,7 +624,7 @@ type After= or Before=. If two units have no ordering dependencies - between them they are shut down + between them, they are shut down or started up simultaneously, and no ordering takes place. @@ -672,12 +672,12 @@ OnFailureIsolate= Takes a boolean - argument. If the + argument. If , the unit listed in OnFailure= will be enqueued in isolation mode, i.e. all 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 OnFailure=. Defaults to @@ -688,7 +688,7 @@ IgnoreOnIsolate= Takes a boolean - argument. If + argument. If , this unit will not be stopped when isolating another unit. Defaults to . @@ -698,7 +698,7 @@ IgnoreOnSnapshot= Takes a boolean - argument. If + argument. If , this unit will not be included in snapshots. Defaults to for device and @@ -710,7 +710,7 @@ StopWhenUnneeded= Takes a boolean - argument. If + argument. If , this unit will be stopped when it is no longer used. Note that in order to minimize the work to be executed, @@ -729,10 +729,10 @@ RefuseManualStop= Takes a boolean - argument. If + argument. If , this unit can only be activated or deactivated indirectly. In - this case explicit start-up + this case, explicit start-up or termination requested by the user is denied, however if it is started or stopped as a @@ -752,10 +752,10 @@ AllowIsolate= Takes a boolean - argument. If + argument. If , this unit may be used with the systemctl isolate - command. Otherwise this will be + command. Otherwise, this will be refused. It probably is a good idea to leave this disabled except for target units that shall be used similar to @@ -769,7 +769,7 @@ DefaultDependencies= Takes a boolean - argument. If + argument. If , (the default), a few default dependencies will implicitly be created for the unit. The actual @@ -799,7 +799,7 @@ When clients are waiting for a job of this unit to 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 however will not change state or even enter the failed @@ -841,7 +841,7 @@ Before starting a unit 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 all ordering dependencies of it are still respected. A failing condition @@ -856,7 +856,7 @@ a file existence condition is checked before a unit is started. If the specified absolute path name does - not exist the condition will + not exist, the condition will fail. If the absolute path name passed to ConditionPathExists= @@ -966,7 +966,7 @@ systemd-nspawn to test against a specific implementation. If multiple - virtualization technologies are nested + virtualization technologies are nested, only the innermost is considered. The test may be negated by prepending an exclamation mark. @@ -1016,12 +1016,12 @@ battery powered at the time of activation of the unit. This takes a boolean argument. If set to - true the condition + true, the condition will hold only if at least one AC connector of the system is connected to a power source, or if no AC connectors are known. Conversely, if - set to false the + set to false, the condition will hold only if there is at least one AC connector known and all AC connectors are disconnected @@ -1032,30 +1032,30 @@ be used to add a constant condition check value to the unit. It takes a boolean argument. If set to - false the condition + false, the condition will always fail, otherwise succeed. 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 is applied). Condition checks can be prefixed with a pipe symbol (|) in which case a condition becomes a triggering condition. If at least one 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 conditions apply and all of the non-triggering conditions. If you 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 exclamation second. Except for ConditionPathIsSymbolicLink=, all path checks follow symlinks. If 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 condition settings (of any kind) will have no effect. diff --git a/man/systemd.xml b/man/systemd.xml index 47d643893..97ef76860 100644 --- a/man/systemd.xml +++ b/man/systemd.xml @@ -136,7 +136,7 @@ Set default unit to - activate on startup. If not specified + activate on startup. If not specified, defaults to default.target. @@ -233,7 +233,7 @@ Highlight important log messages. Argument is a boolean - value. If the argument is omitted it + value. If the argument is omitted, it defaults to . @@ -429,7 +429,7 @@ multi-user.target (for limited console-only boots for use in embedded or server 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 other target unit. See systemd.special7 @@ -1030,9 +1030,9 @@ systemd.dump_core= Takes a boolean - argument. If + argument. If , systemd dumps core when it - crashes. Otherwise no core dump is + crashes. Otherwise, no core dump is created. Defaults to . @@ -1041,9 +1041,9 @@ systemd.crash_shell= Takes a boolean - argument. If + argument. If , systemd spawns a shell when it - crashes. Otherwise no shell is + crashes. Otherwise, no shell is spawned. Defaults to , for security reasons, as the shell is not protected @@ -1065,7 +1065,7 @@ systemd.confirm_spawn= Takes a boolean - argument. If + argument. If , asks for confirmation when spawning processes. Defaults to . @@ -1075,7 +1075,7 @@ systemd.show_status= Takes a boolean - argument. If + argument. If , shows terse service status updates on the console during bootup. Defaults to , unless diff --git a/man/timedatectl.xml b/man/timedatectl.xml index 9aade29a7..be0ad3f01 100644 --- a/man/timedatectl.xml +++ b/man/timedatectl.xml @@ -122,10 +122,10 @@ If set-local-rtc is - invoked and this option is passed the + invoked and this option is passed, the system clock is synchronized from the RTC again, taking the new setting into - account. Otherwise the RTC is + account. Otherwise, the RTC is synchronized from the system clock. @@ -161,7 +161,7 @@ timezones can be listed with list-timezones. If 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 /etc/localtime symlink. See @@ -184,17 +184,17 @@ set-local-rtc [BOOL] Takes a boolean - argument. If 0 the + argument. If 0, the system is configured to maintain the - RTC in universal time, if - 1 it will maintain + RTC in universal time. If + 1, it will maintain the RTC in local time instead. Note that maintaining the RTC in the local timezone is not fully supported and will create various problems with time zone changes and daylight saving - adjustments. If at all possible use - RTC in UTC. Note that invoking this + adjustments. If at all possible, keep the + RTC in UTC mode. Note that invoking this will also synchronize the RTC from the system clock, unless is diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index 2872cc0ad..cdc87c919 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -79,14 +79,14 @@ administrator, who may use this logic to override the configuration files installed by vendor packages. All 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 - 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 entries logged as errors. 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 /dev/null in /etc/tmpfiles.d/ bearing the @@ -238,10 +238,10 @@ L /tmp/foobar - - - - /dev/null The file access mode to use when 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 - objects. For z, Z lines if omitted or when set - to - the file access mode will not be + objects. For z, Z lines, if omitted or when set + to -, the file access mode will not be modified. This parameter is ignored for x, r, R, L lines. @@ -252,8 +252,8 @@ L /tmp/foobar - - - - /dev/null The user and group to use for this file or directory. This may either be a numeric user/group ID or a user or group name. If - omitted or when set to - the default 0 (root) - is used. For z, Z lines when omitted or when set to - + omitted or when set to -, the default 0 (root) + is used. For z, Z lines, when omitted or when set to -, the file ownership will not be modified. These parameters are ignored for x, r, R, L lines. @@ -263,7 +263,7 @@ L /tmp/foobar - - - - /dev/null The date field, when set, is used to decide what files to delete when cleaning. If 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 followed by one of the following postfixes for the respective time units: @@ -280,7 +280,7 @@ L /tmp/foobar - - - - /dev/null us - If multiple integers and units are specified the time + If multiple integers and units are specified, the time values are summed up. If an integer is given without a unit, s is assumed. @@ -289,11 +289,11 @@ L /tmp/foobar - - - - /dev/null unconditionally. 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. 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 directory specified, but not the files and directories immediately inside it. -- 2.30.2