mirror of
https://github.com/Dasharo/systemd.git
synced 2026-03-06 15:02:31 -08:00
doc: correct orthography, word forms and missing/extraneous words
This commit is contained in:
18
NEWS
18
NEWS
@@ -117,7 +117,7 @@ CHANGES WITH 227:
|
||||
|
||||
* File descriptors passed during socket activation may now be
|
||||
named. A new API sd_listen_fds_with_names() is added to
|
||||
access the names. The default names may be overriden,
|
||||
access the names. The default names may be overridden,
|
||||
either in the .socket file using the FileDescriptorName=
|
||||
parameter, or by passing FDNAME= when storing the file
|
||||
descriptors using sd_notify().
|
||||
@@ -1209,7 +1209,7 @@ CHANGES WITH 218:
|
||||
|
||||
* journalctl gained two new commands --vacuum-size= and
|
||||
--vacuum-time= to delete old journal files until the
|
||||
remaining ones take up no more the specified size on disk,
|
||||
remaining ones take up no more than the specified size on disk,
|
||||
or are not older than the specified time.
|
||||
|
||||
* A new, native PPPoE library has been added to sd-network,
|
||||
@@ -1303,7 +1303,7 @@ CHANGES WITH 218:
|
||||
a fixed machine ID for subsequent boots.
|
||||
|
||||
* networkd's .netdev files now provide a large set of
|
||||
configuration parameters for VXLAN devices. Similar, the
|
||||
configuration parameters for VXLAN devices. Similarly, the
|
||||
bridge port cost parameter is now configurable in .network
|
||||
files. There's also new support for configuring IP source
|
||||
routing. networkd .link files gained support for a new
|
||||
@@ -1636,7 +1636,7 @@ CHANGES WITH 216:
|
||||
|
||||
* .socket units gained a new DeferAcceptSec= setting that
|
||||
controls the kernels' TCP_DEFER_ACCEPT sockopt for
|
||||
TCP. Similar, support for controlling TCP keep-alive
|
||||
TCP. Similarly, support for controlling TCP keep-alive
|
||||
settings has been added (KeepAliveTimeSec=,
|
||||
KeepAliveIntervalSec=, KeepAliveProbes=). Also, support for
|
||||
turning off Nagle's algorithm on TCP has been added
|
||||
@@ -1852,7 +1852,7 @@ CHANGES WITH 215:
|
||||
* tmpfiles learnt a new "L+" directive which creates a symlink
|
||||
but (unlike "L") deletes a pre-existing file first, should
|
||||
it already exist and not already be the correct
|
||||
symlink. Similar, "b+", "c+" and "p+" directives have been
|
||||
symlink. Similarly, "b+", "c+" and "p+" directives have been
|
||||
added as well, which create block and character devices, as
|
||||
well as fifos in the filesystem, possibly removing any
|
||||
pre-existing files of different types.
|
||||
@@ -2035,14 +2035,14 @@ CHANGES WITH 214:
|
||||
CAP_NET_BROADCAST, CAP_NET_RAW capabilities though, but
|
||||
loses the ability to write to files owned by root this way.
|
||||
|
||||
* Similar, systemd-resolved now runs under its own
|
||||
* Similarly, systemd-resolved now runs under its own
|
||||
"systemd-resolve" user with no capabilities remaining.
|
||||
|
||||
* Similar, systemd-bus-proxyd now runs under its own
|
||||
* Similarly, systemd-bus-proxyd now runs under its own
|
||||
"systemd-bus-proxy" user with only CAP_IPC_OWNER remaining.
|
||||
|
||||
* systemd-networkd gained support for setting up "veth"
|
||||
virtual ethernet devices for container connectivity, as well
|
||||
virtual Ethernet devices for container connectivity, as well
|
||||
as GRE and VTI tunnels.
|
||||
|
||||
* systemd-networkd will no longer automatically attempt to
|
||||
@@ -2744,7 +2744,7 @@ CHANGES WITH 209:
|
||||
* The configuration of network interface naming rules for
|
||||
"permanent interface names" has changed: a new NamePolicy=
|
||||
setting in the [Link] section of .link files determines the
|
||||
priority of possible naming schemes (onboard, slot, mac,
|
||||
priority of possible naming schemes (onboard, slot, MAC,
|
||||
path). The default value of this setting is determined by
|
||||
/usr/lib/net/links/99-default.link. Old
|
||||
80-net-name-slot.rules udev configuration file has been
|
||||
|
||||
2
TODO
2
TODO
@@ -876,7 +876,7 @@ Features:
|
||||
- add Scope= parsing option for [Network]
|
||||
- properly handle routerless dhcp leases
|
||||
- add more attribute support for SIT tunnel
|
||||
- work with non-ethernet devices
|
||||
- work with non-Ethernet devices
|
||||
- add support for more bond options
|
||||
|
||||
* networkd-wait-online:
|
||||
|
||||
@@ -68,7 +68,7 @@
|
||||
system.</para>
|
||||
|
||||
<para><command>bootctl status</command> checks and prints the
|
||||
currently installed versions of the boot loader binaries and the
|
||||
currently installed versions of the boot loader binaries and
|
||||
all current EFI boot variables.</para>
|
||||
|
||||
<para><command>bootctl update</command> updates all installed
|
||||
|
||||
@@ -231,7 +231,7 @@
|
||||
be augmented with data from
|
||||
<filename>/proc</filename>. When this is turned on, the data
|
||||
shown is possibly inconsistent, as the data read from
|
||||
<filename>/proc</filename> might be more recent than rest of
|
||||
<filename>/proc</filename> might be more recent than the rest of
|
||||
the credential information. Defaults to <literal>yes</literal>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@@ -281,7 +281,7 @@
|
||||
<replaceable>SERVICE</replaceable> is specified, show messages
|
||||
to or from this peer, identified by its well-known or unique
|
||||
name. Otherwise, show all messages on the bus. Use Ctrl-C to
|
||||
terminate dump.</para></listitem>
|
||||
terminate the dump.</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
@@ -344,7 +344,7 @@
|
||||
<varlistentry>
|
||||
<term><command>set-property</command> <arg choice="plain"><replaceable>SERVICE</replaceable></arg> <arg choice="plain"><replaceable>OBJECT</replaceable></arg> <arg choice="plain"><replaceable>INTERFACE</replaceable></arg> <arg choice="plain"><replaceable>PROPERTY</replaceable></arg> <arg choice="plain"><replaceable>SIGNATURE</replaceable></arg> <arg choice="plain" rep="repeat"><replaceable>ARGUMENT</replaceable></arg></term>
|
||||
|
||||
<listitem><para>Set the current value an object
|
||||
<listitem><para>Set the current value of an object
|
||||
property. Takes a service name, object path, interface name,
|
||||
property name, property signature, followed by a list of
|
||||
parameters formatted as strings.</para></listitem>
|
||||
@@ -370,9 +370,9 @@
|
||||
types, each parameter following the signature should simply be the
|
||||
parameter's value formatted as string. Positive boolean values may
|
||||
be formatted as <literal>true</literal>, <literal>yes</literal>,
|
||||
<literal>on</literal>, <literal>1</literal>; negative boolean
|
||||
<literal>on</literal>, or <literal>1</literal>; negative boolean
|
||||
values may be specified as <literal>false</literal>,
|
||||
<literal>no</literal>, <literal>off</literal>,
|
||||
<literal>no</literal>, <literal>off</literal>, or
|
||||
<literal>0</literal>. For arrays, a numeric argument for the
|
||||
number of entries followed by the entries shall be specified. For
|
||||
variants, the signature of the contents shall be specified,
|
||||
@@ -456,7 +456,7 @@ ARRAY "s" {
|
||||
of the <literal>org.freedesktop.systemd1</literal>
|
||||
service, and passes it two strings
|
||||
<literal>cups.service</literal> and
|
||||
<literal>replace</literal>. As result of the method
|
||||
<literal>replace</literal>. As a result of the method
|
||||
call, a single object path parameter is received and
|
||||
shown:</para>
|
||||
|
||||
|
||||
@@ -98,7 +98,7 @@
|
||||
<term><varname>Compress=</varname></term>
|
||||
|
||||
<listitem><para>Controls compression for external
|
||||
storage. Takes a boolean argument, defaults to
|
||||
storage. Takes a boolean argument, which defaults to
|
||||
<literal>yes</literal>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
@@ -160,10 +160,10 @@
|
||||
at the beginning. This is different from the <option>--offset</option>
|
||||
option with respect to the sector numbers used in initialization vector
|
||||
(IV) calculation. Using <option>--offset</option> will shift the IV
|
||||
calculation by the same negative amount. Hence, if <option>--offset n</option>,
|
||||
calculation by the same negative amount. Hence, if <option>--offset n</option> is given,
|
||||
sector n will get a sector number of 0 for the IV calculation.
|
||||
Using <option>--skip</option> causes sector n to also be the first
|
||||
sector of the mapped device, but with its number for IV generation is n.</para>
|
||||
sector of the mapped device, but with its number for IV generation being n.</para>
|
||||
|
||||
<para>This option is only relevant for plain devices.</para>
|
||||
</listitem>
|
||||
|
||||
@@ -125,7 +125,7 @@
|
||||
|
||||
<!--
|
||||
- helper template to do conflict resolution between various headings with the same inferred ID attribute/tag from the headerlink template
|
||||
- this conflict resolution is necessary to prevent malformed HTML output (multiple id attributes with the same value)
|
||||
- this conflict resolution is necessary to prevent malformed HTML output (multiple ID attributes with the same value)
|
||||
- and it fixes xsltproc warnings during compilation of HTML man pages
|
||||
-
|
||||
- A simple top-to-bottom numbering scheme is implemented for nodes with the same ID value to derive unique ID values for HTML output.
|
||||
|
||||
@@ -245,7 +245,7 @@
|
||||
|
||||
<varlistentry>
|
||||
<term><filename>/usr/lib/<replaceable>arch-id</replaceable></filename></term>
|
||||
<listitem><para>Location for placing dynamic libraries, also
|
||||
<listitem><para>Location for placing dynamic libraries into, also
|
||||
called <varname>$libdir</varname>. The architecture identifier
|
||||
to use is defined on <ulink
|
||||
url="https://wiki.debian.org/Multiarch/Tuples">Multiarch
|
||||
@@ -405,7 +405,7 @@
|
||||
when the user logs out. Usually, it is a better idea to use
|
||||
memory mapped files in <filename>/run</filename> (for system
|
||||
programs) or <varname>$XDG_RUNTIME_DIR</varname> (for user
|
||||
programs) instead of POSIX shared memory segments, since those
|
||||
programs) instead of POSIX shared memory segments, since these
|
||||
directories are not world-writable and hence not vulnerable to
|
||||
security-sensitive name clashes.</para></listitem>
|
||||
</varlistentry>
|
||||
@@ -513,7 +513,7 @@
|
||||
directory should have no effect on operation of programs,
|
||||
except for increased runtimes necessary to rebuild these
|
||||
caches. If an application finds
|
||||
<varname>$XDG_CACHE_HOME</varname> set, is should use the
|
||||
<varname>$XDG_CACHE_HOME</varname> set, it should use the
|
||||
directory specified in it instead of this
|
||||
directory.</para></listitem>
|
||||
</varlistentry>
|
||||
@@ -525,7 +525,7 @@
|
||||
new user is created, this directory will be empty or not exist
|
||||
at all. Applications should fall back to defaults should their
|
||||
configuration or state in this directory be missing. If an
|
||||
application finds <varname>$XDG_CONFIG_HOME</varname> set, is
|
||||
application finds <varname>$XDG_CONFIG_HOME</varname> set, it
|
||||
should use the directory specified in it instead of this
|
||||
directory.</para></listitem>
|
||||
</varlistentry>
|
||||
@@ -568,7 +568,7 @@
|
||||
such as fonts or artwork. Usually, the precise location and
|
||||
format of files stored below this directory is subject to
|
||||
specifications that ensure interoperability. If an application
|
||||
finds <varname>$XDG_DATA_HOME</varname> set, is should use the
|
||||
finds <varname>$XDG_DATA_HOME</varname> set, it should use the
|
||||
directory specified in it instead of this
|
||||
directory.</para></listitem>
|
||||
</varlistentry>
|
||||
@@ -618,7 +618,7 @@
|
||||
|
||||
<para>It is strongly recommended that <filename>/dev</filename> is
|
||||
the only location below which device nodes shall be placed.
|
||||
Similar, <filename>/run</filename> shall be the only location to
|
||||
Similarly, <filename>/run</filename> shall be the only location to
|
||||
place sockets and FIFOs. Regular files, directories and symlinks
|
||||
may be used in all directories.</para>
|
||||
</refsect1>
|
||||
|
||||
@@ -34,7 +34,7 @@
|
||||
|
||||
<refsect1><title>Description</title>
|
||||
<para>The hardware database is a key-value store for associating modalias-like keys to
|
||||
udev-properties-like values. It is used primarily by udev to add the relevant properties
|
||||
udev-property-like values. It is used primarily by udev to add the relevant properties
|
||||
to matching devices, but it can also be queried directly.</para>
|
||||
</refsect1>
|
||||
|
||||
@@ -57,7 +57,7 @@
|
||||
associated key-value pairs. Every record in the hwdb starts with one or
|
||||
more match strings, specifying a shell glob to compare the database
|
||||
lookup string against. Multiple match lines are specified in additional
|
||||
consecutive lines. Every match line is compared individually, they are
|
||||
consecutive lines. Every match line is compared individually, and they are
|
||||
combined by OR. Every match line must start at the first character of
|
||||
the line.</para>
|
||||
|
||||
|
||||
@@ -82,7 +82,7 @@
|
||||
matches apply to the same field, then they are automatically
|
||||
matched as alternatives, i.e. the resulting output will show
|
||||
entries matching any of the specified matches for the same
|
||||
field. Finally, the character <literal>+</literal> may appears
|
||||
field. Finally, the character <literal>+</literal> may appear
|
||||
as a separate word between other terms on the command line. This
|
||||
causes all matches before and after to be combined in a
|
||||
disjunction (i.e. logical OR).</para>
|
||||
@@ -656,18 +656,18 @@
|
||||
<listitem><para>Removes archived journal files until the disk
|
||||
space they use falls below the specified size (specified with
|
||||
the usual <literal>K</literal>, <literal>M</literal>,
|
||||
<literal>G</literal>, <literal>T</literal> suffixes), or all
|
||||
<literal>G</literal> and <literal>T</literal> suffixes), or all
|
||||
journal files contain no data older than the specified
|
||||
timespan (specified with the usual <literal>s</literal>,
|
||||
<literal>min</literal>, <literal>h</literal>,
|
||||
<literal>days</literal>, <literal>months</literal>,
|
||||
<literal>weeks</literal>, <literal>years</literal> suffixes),
|
||||
<literal>weeks</literal> and <literal>years</literal> suffixes),
|
||||
or no more than the specified number of separate journal files
|
||||
remain. Note that running <option>--vacuum-size=</option> has
|
||||
only indirect effect on the output shown by
|
||||
only an indirect effect on the output shown by
|
||||
<option>--disk-usage</option>, as the latter includes active
|
||||
journal files, while the vacuuming operation only operates
|
||||
on archived journal files. Similar,
|
||||
on archived journal files. Similarly,
|
||||
<option>--vacuum-files=</option> might not actually reduce the
|
||||
number of journal files to below the specified number, as it
|
||||
will not remove active journal
|
||||
@@ -772,7 +772,7 @@
|
||||
<varlistentry>
|
||||
<term><option>--flush</option></term>
|
||||
|
||||
<listitem><para>Asks the Journal daemon to flush any log data
|
||||
<listitem><para>Asks the journal daemon to flush any log data
|
||||
stored in <filename>/run/log/journal</filename> into
|
||||
<filename>/var/log/journal</filename>, if persistent storage is
|
||||
enabled. This call does not return until the operation is
|
||||
@@ -782,7 +782,7 @@
|
||||
<varlistentry>
|
||||
<term><option>--rotate</option></term>
|
||||
|
||||
<listitem><para>Asks the Journal daemon to rotate journal files.
|
||||
<listitem><para>Asks the journal daemon to rotate journal files.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<xi:include href="standard-options.xml" xpointer="help" />
|
||||
|
||||
@@ -203,7 +203,7 @@
|
||||
|
||||
<para><varname>SystemMaxUse=</varname> and
|
||||
<varname>RuntimeMaxUse=</varname> control how much disk space
|
||||
the journal may use up at maximum.
|
||||
the journal may use up at most.
|
||||
<varname>SystemKeepFree=</varname> and
|
||||
<varname>RuntimeKeepFree=</varname> control how much disk
|
||||
space systemd-journald shall leave free for other uses.
|
||||
@@ -220,12 +220,12 @@
|
||||
enough free space before and journal files were created, and
|
||||
subsequently something else causes the file system to fill up,
|
||||
journald will stop using more space, but it will not be
|
||||
removing existing files to reduce footprint again
|
||||
removing existing files to reduce the footprint again,
|
||||
either.</para>
|
||||
|
||||
<para><varname>SystemMaxFileSize=</varname> and
|
||||
<varname>RuntimeMaxFileSize=</varname> control how large
|
||||
individual journal files may grow at maximum. This influences
|
||||
individual journal files may grow at most. This influences
|
||||
the granularity in which disk space is made available through
|
||||
rotation, i.e. deletion of historic data. Defaults to one
|
||||
eighth of the values configured with
|
||||
@@ -241,7 +241,7 @@
|
||||
|
||||
<para><varname>SystemMaxFiles=</varname> and
|
||||
<varname>RuntimeMaxFiles=</varname> control how many
|
||||
individual journal files to keep at maximum. Note that only
|
||||
individual journal files to keep at most. Note that only
|
||||
archived files are deleted to reduce the number of files until
|
||||
this limit is reached; active files will stay around. This
|
||||
means that, in effect, there might still be more journal files
|
||||
@@ -375,15 +375,15 @@
|
||||
|
||||
<para>
|
||||
Journal events can be transferred to a different logging daemon
|
||||
in two different ways. In the first method, messages are
|
||||
in two different ways. With the first method, messages are
|
||||
immediately forwarded to a socket
|
||||
(<filename>/run/systemd/journal/syslog</filename>), where the
|
||||
traditional syslog daemon can read them. This method is
|
||||
controlled by <varname>ForwardToSyslog=</varname> option. In a
|
||||
controlled by the <varname>ForwardToSyslog=</varname> option. With a
|
||||
second method, a syslog daemon behaves like a normal journal
|
||||
client, and reads messages from the journal files, similarly to
|
||||
<citerefentry><refentrytitle>journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
|
||||
In this method, messages do not have to be read immediately,
|
||||
With this, messages do not have to be read immediately,
|
||||
which allows a logging daemon which is only started late in boot
|
||||
to access all messages since the start of the system. In
|
||||
addition, full structured meta-data is available to it. This
|
||||
|
||||
@@ -75,7 +75,7 @@
|
||||
a udev context. Furthermore, multiple different udev contexts can
|
||||
be used in parallel by multiple threads. However, a single context
|
||||
must not be accessed by multiple threads in parallel. The caller
|
||||
is responsible of providing suitable locking if they intend to use
|
||||
is responsible for providing suitable locking if they intend to use
|
||||
it from multiple threads.</para>
|
||||
|
||||
<para>To introspect a local device on a system, a udev device
|
||||
|
||||
@@ -255,8 +255,8 @@
|
||||
|
||||
<listitem><para>Specifies the timeout after system startup or
|
||||
system resume in which systemd will hold off on reacting to
|
||||
LID events. This is required for the system to properly
|
||||
detect any hotplugged devices so systemd can ignore LID events
|
||||
lid events. This is required for the system to properly
|
||||
detect any hotplugged devices so systemd can ignore lid events
|
||||
if external monitors, or docks, are connected. If set to 0,
|
||||
systemd will always react immediately, possibly before the
|
||||
kernel fully probed all hotplugged devices. This is safe, as
|
||||
|
||||
@@ -245,7 +245,7 @@
|
||||
<literal>checksum</literal> and <literal>signature</literal>.
|
||||
If <literal>no</literal>, no verification is done. If
|
||||
<literal>checksum</literal> is specified, the download is
|
||||
checked for integrity after transfer is complete, but no
|
||||
checked for integrity after the transfer is complete, but no
|
||||
signatures are verified. If <literal>signature</literal> is
|
||||
specified, the checksum is verified and the images's signature
|
||||
is checked against a local keyring of trustable vendors. It is
|
||||
@@ -423,7 +423,7 @@
|
||||
|
||||
<para>When using the <command>shell</command> command without
|
||||
arguments, (thus invoking the executed shell or command on the
|
||||
local host), it is similar in many ways to a <citerefentry
|
||||
local host), it is in many ways similar to a <citerefentry
|
||||
project='die-net'><refentrytitle>su</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
session, but, unlike <command>su</command>, completely isolates
|
||||
the new session from the originating session, so that it
|
||||
@@ -433,7 +433,7 @@
|
||||
environment variables or resource limits, among other
|
||||
properties.</para>
|
||||
|
||||
<para>Note that the
|
||||
<para>Note that
|
||||
<citerefentry><refentrytitle>systemd-run</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
may be used in place of the <command>shell</command> command,
|
||||
and allows more detailed, low-level configuration of the
|
||||
@@ -633,7 +633,7 @@
|
||||
<varlistentry>
|
||||
<term><command>set-limit</command> [<replaceable>NAME</replaceable>] <replaceable>BYTES</replaceable></term>
|
||||
|
||||
<listitem><para>Sets the maximum size in bytes a specific
|
||||
<listitem><para>Sets the maximum size in bytes that a specific
|
||||
container or VM image, or all images, may grow up to on disk
|
||||
(disk quota). Takes either one or two parameters. The first,
|
||||
optional parameter refers to a container or VM image name. If
|
||||
@@ -646,7 +646,7 @@
|
||||
|
||||
<para>Note that per-container size limits are only supported
|
||||
on btrfs file systems. Also note that, if
|
||||
<command>set-limit</command> is invoked without image
|
||||
<command>set-limit</command> is invoked without an image
|
||||
parameter, and <filename>/var/lib/machines</filename> is
|
||||
empty, and the directory is not located on btrfs, a btrfs
|
||||
loopback file is implicitly created as
|
||||
@@ -656,7 +656,7 @@
|
||||
loopback may later be readjusted with
|
||||
<command>set-limit</command>, as well. If such a
|
||||
loopback-mounted <filename>/var/lib/machines</filename>
|
||||
directory is used, <command>set-limit</command> without image
|
||||
directory is used, <command>set-limit</command> without an image
|
||||
name alters both the quota setting within the file system as
|
||||
well as the loopback file and file system size
|
||||
itself.</para></listitem>
|
||||
@@ -802,7 +802,7 @@
|
||||
and places it under the specified name in
|
||||
<filename>/var/lib/machines/</filename>. When
|
||||
<command>import-tar</command> is used, the file specified as
|
||||
first argument should be a tar archive, possibly compressed
|
||||
the first argument should be a tar archive, possibly compressed
|
||||
with xz, gzip or bzip2. It will then be unpacked into its own
|
||||
subvolume in <filename>/var/lib/machines</filename>. When
|
||||
<command>import-raw</command> is used, the file should be a
|
||||
@@ -883,17 +883,17 @@
|
||||
semantics. Specifically, they must consist of one or more
|
||||
non-empty label strings, separated by dots. No leading or trailing
|
||||
dots are allowed. No sequences of multiple dots are allowed. The
|
||||
label strings may only consists of alphanumeric characters as well
|
||||
label strings may only consist of alphanumeric characters as well
|
||||
as the dash and underscore. The maximum length of a machine name
|
||||
is 64 characters.</para>
|
||||
|
||||
<para>A special machine with the name <literal>.host</literal>
|
||||
refers to the running host system itself. This is useful for execution
|
||||
operations or inspecting the host system as well. Not that
|
||||
operations or inspecting the host system as well. Note that
|
||||
<command>machinectl list</command> will not show this special
|
||||
machine unless the <option>--all</option> switch is specified.</para>
|
||||
|
||||
<para>Requirements on image names are less strict, however must be
|
||||
<para>Requirements on image names are less strict, however, they must be
|
||||
valid UTF-8, must be suitable as file names (hence not be the
|
||||
single or double dot, and not include a slash), and may not
|
||||
contain control characters. Since many operations search for an
|
||||
@@ -901,7 +901,7 @@
|
||||
images in the same strict fashion as machines.</para>
|
||||
|
||||
<para>A special image with the name <literal>.host</literal>
|
||||
refers to the image of the running host system. It is hence
|
||||
refers to the image of the running host system. It hence
|
||||
conceptually maps to the special <literal>.host</literal> machine
|
||||
name described above. Note that <command>machinectl
|
||||
list-images</command> won't show this special image either, unless
|
||||
@@ -943,7 +943,7 @@
|
||||
<listitem><para>A simple directory tree, containing the files
|
||||
and directories of the container to boot.</para></listitem>
|
||||
|
||||
<listitem><para>A subvolume (on btrfs file systems), which are
|
||||
<listitem><para>Subvolumes (on btrfs file systems), which are
|
||||
similar to the simple directories, described above. However,
|
||||
they have additional benefits, such as efficient cloning and
|
||||
quota reporting.</para></listitem>
|
||||
@@ -956,7 +956,7 @@
|
||||
|
||||
<para>See
|
||||
<citerefentry><refentrytitle>systemd-nspawn</refentrytitle><manvolnum>1</manvolnum></citerefentry>
|
||||
for more information on image formats, in particular it's
|
||||
for more information on image formats, in particular its
|
||||
<option>--directory=</option> and <option>--image=</option>
|
||||
options.</para>
|
||||
</refsect1>
|
||||
@@ -1010,8 +1010,8 @@
|
||||
|
||||
<programlisting># machinectl export-tar fedora myfedora.tar.xz</programlisting>
|
||||
|
||||
<para>Exports the container <literal>fedora</literal> in an
|
||||
xz-compress tar file <filename>myfedora.tar.xz</filename> in the
|
||||
<para>Exports the container <literal>fedora</literal> as an
|
||||
xz-compressed tar file <filename>myfedora.tar.xz</filename> into the
|
||||
current directory.</para>
|
||||
</example>
|
||||
|
||||
|
||||
@@ -129,7 +129,7 @@ IDX LINK TYPE OPERATIONAL SETUP
|
||||
configured DNS servers, etc.</para>
|
||||
|
||||
<para>When no links are specified, routable links are
|
||||
shown. See also option <option>--all</option>.</para>
|
||||
shown. Also see the option <option>--all</option>.</para>
|
||||
|
||||
<para>Produces output similar to
|
||||
<programlisting>
|
||||
|
||||
@@ -100,7 +100,7 @@
|
||||
|
||||
<para>It is recommended to place <literal>myhostname</literal>
|
||||
last in the <filename>nsswitch.conf</filename> line to make sure
|
||||
that this mapping is only used as fallback, and any DNS or
|
||||
that this mapping is only used as fallback, and that any DNS or
|
||||
<filename>/etc/hosts</filename> based mapping takes
|
||||
precedence.</para>
|
||||
</refsect1>
|
||||
|
||||
@@ -76,7 +76,7 @@
|
||||
|
||||
<para>It is recommended to place <literal>mymachines</literal>
|
||||
near the end of the <filename>nsswitch.conf</filename> lines to
|
||||
make sure that its mappings are only used as fallback, and any
|
||||
make sure that its mappings are only used as fallback, and that any
|
||||
other mappings, such as DNS or <filename>/etc/hosts</filename>
|
||||
based mappings, take precedence.</para>
|
||||
</refsect1>
|
||||
|
||||
@@ -59,7 +59,7 @@
|
||||
<title>Description</title>
|
||||
|
||||
<para>These configuration files control local DNS and LLMNR
|
||||
name resolving.</para>
|
||||
name resolution.</para>
|
||||
|
||||
</refsect1>
|
||||
|
||||
@@ -104,8 +104,8 @@
|
||||
Resolution support (<ulink
|
||||
url="https://tools.ietf.org/html/rfc4795">RFC 4794</ulink>) on
|
||||
the local host. If true, enables full LLMNR responder and
|
||||
resolver support. If false, disable both. If set to
|
||||
<literal>resolve</literal>, only resolving support is enabled,
|
||||
resolver support. If false, disables both. If set to
|
||||
<literal>resolve</literal>, only resolution support is enabled,
|
||||
but responding is disabled. Note that
|
||||
<citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
||||
also maintains per-interface LLMNR settings. LLMNR will be
|
||||
|
||||
@@ -224,7 +224,7 @@
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><varname>SD_BUS_ERROR_FILE_EXISTS</varname></term>
|
||||
<listitem><para>The requested file exists already.</para></listitem>
|
||||
<listitem><para>The requested file already exists.</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><varname>SD_BUS_ERROR_UNKNOWN_METHOD</varname></term>
|
||||
|
||||
@@ -317,7 +317,7 @@
|
||||
to determine the mask of fields available.</para>
|
||||
|
||||
<para><function>sd_bus_creds_get_pid()</function> will retrieve
|
||||
the PID (process identifier). Similar,
|
||||
the PID (process identifier). Similarly,
|
||||
<function>sd_bus_creds_get_ppid()</function> will retrieve the
|
||||
parent PID. Note that PID 1 has no parent process, in which case
|
||||
-ENXIO is returned.</para>
|
||||
@@ -326,14 +326,14 @@
|
||||
TID (thread identifier).</para>
|
||||
|
||||
<para><function>sd_bus_creds_get_uid()</function> will retrieve
|
||||
the numeric UID (user identifier). Similar,
|
||||
the numeric UID (user identifier). Similarly,
|
||||
<function>sd_bus_creds_get_euid()</function> returns the effective
|
||||
UID, <function>sd_bus_creds_get_suid()</function> the saved UID
|
||||
and <function>sd_bus_creds_get_fsuid()</function> the file system
|
||||
UID.</para>
|
||||
|
||||
<para><function>sd_bus_creds_get_gid()</function> will retrieve the
|
||||
numeric GID (group identifier). Similar,
|
||||
numeric GID (group identifier). Similarly,
|
||||
<function>sd_bus_creds_get_egid()</function> returns the effective
|
||||
GID, <function>sd_bus_creds_get_sgid()</function> the saved GID
|
||||
and <function>sd_bus_creds_get_fsgid()</function> the file system
|
||||
@@ -355,7 +355,7 @@
|
||||
<para><function>sd_bus_creds_get_exe()</function> will retrieve
|
||||
the path to the program executable (as stored in the
|
||||
<filename>/proc/<replaceable>pid</replaceable>/exe</filename>
|
||||
link, but with <literal> (deleted)</literal> suffix removed). Note
|
||||
link, but with the <literal> (deleted)</literal> suffix removed). Note
|
||||
that kernel threads do not have an executable path, in which case
|
||||
-ENXIO is returned.</para>
|
||||
|
||||
@@ -372,36 +372,36 @@
|
||||
|
||||
<para><function>sd_bus_creds_get_unit()</function> will retrieve
|
||||
the systemd unit name (in the system instance of systemd) that the
|
||||
process is part of. See
|
||||
process is a part of. See
|
||||
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>. For
|
||||
processes that are not part of a unit, returns -ENXIO.
|
||||
</para>
|
||||
|
||||
<para><function>sd_bus_creds_get_user_unit()</function> will
|
||||
retrieve the systemd unit name (in the user instance of systemd)
|
||||
that the process is part of. See
|
||||
that the process is a part of. See
|
||||
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>. For
|
||||
processes that are not part of a user unit, returns -ENXIO.
|
||||
</para>
|
||||
|
||||
<para><function>sd_bus_creds_get_slice()</function> will retrieve
|
||||
the systemd slice (a unit in the system instance of systemd) that
|
||||
the process is part of. See
|
||||
<citerefentry><refentrytitle>systemd.slice</refentrytitle><manvolnum>5</manvolnum></citerefentry>. Similar,
|
||||
the process is a part of. See
|
||||
<citerefentry><refentrytitle>systemd.slice</refentrytitle><manvolnum>5</manvolnum></citerefentry>. Similarly,
|
||||
<function>sd_bus_creds_get_user_slice()</function> retrieves the
|
||||
systemd slice of the process, in the user instance of systemd.
|
||||
</para>
|
||||
|
||||
<para><function>sd_bus_creds_get_session()</function> will
|
||||
retrieve the identifier of the login session that the process is
|
||||
part of. See
|
||||
a part of. See
|
||||
<citerefentry><refentrytitle>systemd-logind.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>. For
|
||||
processes that are not part of a session, returns -ENXIO.
|
||||
</para>
|
||||
|
||||
<para><function>sd_bus_creds_get_owner_uid()</function> will
|
||||
retrieve the numeric UID (user identifier) of the user who owns
|
||||
the login session that the process is part of. See
|
||||
the login session that the process is a part of. See
|
||||
<citerefentry><refentrytitle>systemd-logind.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
|
||||
For processes that are not part of a session, returns -ENXIO.
|
||||
</para>
|
||||
@@ -494,7 +494,7 @@
|
||||
<varlistentry>
|
||||
<term><constant>-ENODATA</constant></term>
|
||||
|
||||
<listitem><para>Given field is not available in the
|
||||
<listitem><para>The given field is not available in the
|
||||
credentials object <parameter>c</parameter>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@@ -502,7 +502,7 @@
|
||||
<varlistentry>
|
||||
<term><constant>-ENXIO</constant></term>
|
||||
|
||||
<listitem><para>Given field is not specified for the described
|
||||
<listitem><para>The given field is not specified for the described
|
||||
process or peer. This will be returned by
|
||||
<function>sd_bus_get_unit()</function>,
|
||||
<function>sd_bus_get_slice()</function>,
|
||||
@@ -514,8 +514,8 @@
|
||||
slice, or logind session. It will also be returned by
|
||||
<function>sd_bus_creds_get_exe()</function> and
|
||||
<function>sd_bus_creds_get_cmdline()</function> for kernel
|
||||
threads (since these aren't started from an executable binary
|
||||
or have a command line),
|
||||
threads (since these are not started from an executable binary,
|
||||
nor have a command line), and by
|
||||
<function>sd_bus_creds_get_audit_session_id()</function> and
|
||||
<function>sd_bus_creds_get_audit_login_uid()</function> when
|
||||
the process is not part of an audit session, and
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user