mirror of
https://github.com/systemd/systemd.git
synced 2024-12-22 17:35:35 +03:00
doc: comma placement corrections and word order
Set commas where there should be some. Some improvements to word order.
This commit is contained in:
parent
dca348bcbb
commit
b8bde11658
38
NEWS
38
NEWS
@ -60,9 +60,9 @@ CHANGES WITH 212:
|
||||
users who are logged out cannot continue to consume IPC
|
||||
resources. This covers SysV memory, semaphores and message
|
||||
queues as well as POSIX shared memory and message
|
||||
queues. Traditionally SysV and POSIX IPC had no life-cycle
|
||||
limits, with this functionality this is corrected. This may
|
||||
be turned off using the RemoveIPC= switch of logind.conf.
|
||||
queues. Traditionally, SysV and POSIX IPC had no life-cycle
|
||||
limits. With this functionality, that is corrected. This may
|
||||
be turned off by using the RemoveIPC= switch of logind.conf.
|
||||
|
||||
* The systemd-machine-id-setup and tmpfiles tools gained a
|
||||
--root= switch to operate on a specific root directory,
|
||||
@ -95,7 +95,7 @@ CHANGES WITH 212:
|
||||
this is appropriate.
|
||||
|
||||
* systemd-udevd will now run in a disassociated mount
|
||||
namespace. To mount directories from udev rules make sure to
|
||||
namespace. To mount directories from udev rules, make sure to
|
||||
pull in mount units via SYSTEMD_WANTS properties.
|
||||
|
||||
* The kdbus support gained support for uploading policy into
|
||||
@ -118,12 +118,12 @@ CHANGES WITH 212:
|
||||
DefaultTimerAccuracySec= has been added that controls the
|
||||
default AccuracySec= setting of .timer units.
|
||||
|
||||
* Timer units gained a new WakeSystem= switch. If enabled
|
||||
* Timer units gained a new WakeSystem= switch. If enabled,
|
||||
timers configured this way will cause the system to resume
|
||||
from system suspend (if the system supports that, which most
|
||||
do these days).
|
||||
|
||||
* Timer units gained a new Persistent= switch. If enabled
|
||||
* Timer units gained a new Persistent= switch. If enabled,
|
||||
timers configured this way will save to disk when they have
|
||||
been last triggered. This information is then used on next
|
||||
reboot to possible execute overdue timer events, that
|
||||
@ -181,12 +181,12 @@ CHANGES WITH 211:
|
||||
* systemd-gpt-auto-generator is now able to discover /srv and
|
||||
root partitions in addition to /home and swap partitions. It
|
||||
also supports LUKS-encrypted partitions now. With this in
|
||||
place automatic discovery of partitions to mount following
|
||||
place, automatic discovery of partitions to mount following
|
||||
the Discoverable Partitions Specification
|
||||
(http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec)
|
||||
is now a lot more complete. This allows booting without
|
||||
/etc/fstab and without root= on the kernel command line on
|
||||
appropriately prepared systems.
|
||||
systems prepared appropriately.
|
||||
|
||||
* systemd-nspawn gained a new --image= switch which allows
|
||||
booting up disk images and Linux installations on any block
|
||||
@ -291,11 +291,11 @@ CHANGES WITH 210:
|
||||
|
||||
* logind is now a lot more aggressive when suspending the
|
||||
machine due to a closed laptop lid. Instead of acting only
|
||||
on the lid close action it will continuously watch the lid
|
||||
on the lid close action, it will continuously watch the lid
|
||||
status and act on it. This is useful for laptops where the
|
||||
power button is on the outside of the chassis so that it can
|
||||
be reached without opening the lid (such as the Lenovo
|
||||
Yoga). On those machines logind will now immediately
|
||||
Yoga). On those machines, logind will now immediately
|
||||
re-suspend the machine if the power button has been
|
||||
accidentally pressed while the laptop was suspended and in a
|
||||
backpack or similar.
|
||||
@ -332,7 +332,7 @@ CHANGES WITH 210:
|
||||
* The DeviceAllow= setting in unit files now supports a syntax
|
||||
to whitelist an entire group of devices node majors at once,
|
||||
based on the /proc/devices listing. For example, with the
|
||||
string "char-pts" it is now possible to whitelist all
|
||||
string "char-pts", it is now possible to whitelist all
|
||||
current and future pseudo-TTYs at once.
|
||||
|
||||
* sd-event learned a new "post" event source. Event sources of
|
||||
@ -346,20 +346,20 @@ CHANGES WITH 210:
|
||||
enabled/disabled using systemctl. It still is enabled by
|
||||
default however.
|
||||
|
||||
* When creating a veth interface pair with systemd-nspawn the
|
||||
* When creating a veth interface pair with systemd-nspawn, the
|
||||
host side will now be prefixed with "vb-" if
|
||||
--network-bridge= is used, and with "ve-" if --network-veth
|
||||
is used. This way it is easy to distinguish these cases on
|
||||
is used. This way, it is easy to distinguish these cases on
|
||||
the host, for example to apply different configuration to
|
||||
them with systemd-networkd.
|
||||
|
||||
* The compatibility libraries for libsystemd-journal.so,
|
||||
libsystem-id128.so, libsystemd-login.so and
|
||||
libsystemd-daemon.so do not make use of IFUNC
|
||||
anymore. Instead we now build libsystemd.so multiple times
|
||||
anymore. Instead, we now build libsystemd.so multiple times
|
||||
under these alternative names. This means that the footprint
|
||||
is drastically increased, but given that these are
|
||||
transitional compatibility libraries this should not matter
|
||||
transitional compatibility libraries, this should not matter
|
||||
much. This change has been made necessary to support the ARM
|
||||
platform for these compatibility libraries, as the ARM
|
||||
toolchain is not really at the same level as the toolchain
|
||||
@ -770,8 +770,8 @@ CHANGES WITH 209:
|
||||
* systemd-nspawn gained a new --personality= switch for
|
||||
setting the kernel personality for the container. This is
|
||||
useful when running a 32-bit container on a 64-bit host. A
|
||||
similar option Personality= is now also available in service
|
||||
units.
|
||||
similar option Personality= is now also available for service
|
||||
units to use.
|
||||
|
||||
* logind will now also track a "Desktop" identifier for each
|
||||
session which encodes the desktop environment of it. This is
|
||||
@ -795,8 +795,8 @@ CHANGES WITH 209:
|
||||
|
||||
* For usage together with SystemCallFilter=, a new
|
||||
SystemCallErrorNumber= setting has been introduced that
|
||||
allows configuration of a system error number to return on
|
||||
filtered system calls, instead of immediately killing the
|
||||
allows configuration of a system error number to be returned
|
||||
on filtered system calls, instead of immediately killing the
|
||||
process. Also, SystemCallArchitectures= has been added to
|
||||
limit access to system calls of a particular architecture
|
||||
(in order to turn off support for unused secondary
|
||||
|
2
README
2
README
@ -200,7 +200,7 @@ WARNINGS:
|
||||
supported anymore by the basic set of Linux OS components.
|
||||
|
||||
systemd requires that the /run mount point exists. systemd also
|
||||
requires that /var/run is a a symlink → /run.
|
||||
requires that /var/run is a a symlink to /run.
|
||||
|
||||
For more information on this issue consult
|
||||
http://freedesktop.org/wiki/Software/systemd/separate-usr-is-broken
|
||||
|
@ -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
|
||||
|
@ -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
|
||||
|
@ -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>
|
||||
|
@ -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>
|
||||
|
||||
|
@ -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>
|
||||
|
@ -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>
|
||||
|
@ -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>
|
||||
|
@ -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
|
||||
|
@ -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
|
||||
|
@ -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>
|
||||
|
||||
|
@ -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>
|
||||
|
@ -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>
|
||||
|
@ -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>
|
||||
|
||||
|
@ -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>
|
||||
|
@ -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>
|
||||
|
@ -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
|
||||
|
@ -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>
|
||||
|
@ -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>,
|
||||
|
@ -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>
|
||||
|
@ -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>
|
||||
|
@ -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
|
||||
|
@ -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>
|
||||
|
@ -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),
|
||||
|
Loading…
Reference in New Issue
Block a user