Merge pull request #15009 from keszybz/version-and-doc-updates
Version and doc updates
This commit is contained in:
Zbigniew Jędrzejewski-Szmek
GitHub
commit
fbd6ac2601
|
|
@ -10,7 +10,6 @@ Release=31
|
|||
[Output]
|
||||
Format=gpt_ext4
|
||||
Bootable=yes
|
||||
KernelCommandLine=printk.devkmsg=on
|
||||
|
||||
[Partitions]
|
||||
RootSize=3G
|
||||
|
|
@ -27,6 +26,7 @@ BuildPackages=
|
|||
gcc
|
||||
gettext
|
||||
git
|
||||
glibc-minimal-langpack
|
||||
gnu-efi
|
||||
gnu-efi-devel
|
||||
gnutls-devel
|
||||
|
|
|
|||
|
|
@ -96,6 +96,8 @@ And now, here's the list of (hopefully) all APIs that we have introduced with sy
|
|||
| [$NOTIFY_SOCKET Daemon Notifications](https://www.freedesktop.org/software/systemd/man/sd_notify.html) | Environment | yes | yes | a few, including udev | yes | - | no |
|
||||
| [argv[0][0]='@' Logic](https://www.freedesktop.org/wiki/Software/systemd/RootStorageDaemons) | `/proc` marking | yes | yes | mdadm | yes | - | no |
|
||||
| [Unit file format](https://www.freedesktop.org/software/systemd/man/systemd.unit.html) | File format | yes | yes | numerous | no | - | no |
|
||||
| [Network](https://www.freedesktop.org/software/systemd/man/systemd.network.html) & [Netdev file format](https://www.freedesktop.org/software/systemd/man/systemd.netdev.html) | File format | yes | yes | no | no | - | no |
|
||||
| [Link file format](https://www.freedesktop.org/software/systemd/man/systemd.link.html) | File format | yes | yes | no | no | - | no |
|
||||
| [Journal File Format](https://www.freedesktop.org/wiki/Software/systemd/journal-files) | File format | yes | yes | - | maybe | - | no |
|
||||
| [Journal Export Format](https://www.freedesktop.org/wiki/Software/systemd/export) | File format | yes | yes | - | yes | - | no |
|
||||
| [Cooperation in cgroup tree](https://www.freedesktop.org/wiki/Software/systemd/PaxControlGroups) | Treaty | yes | yes | libvirt | yes | libvirt | no |
|
||||
|
|
|
|||
|
|
@ -350,9 +350,9 @@
|
|||
<varname>TTYPath=</varname>, described below.</para>
|
||||
|
||||
<para>When forwarding to the kernel log buffer (kmsg), make sure to select a suitably large size for
|
||||
the log buffer, and ensure the kernel's rate-limiting applied to userspace processes is turned
|
||||
off. Specifically, add <literal>log_buf_len=8M</literal> and <literal>printk.devkmsg=on</literal> (or
|
||||
similar) to the kernel command line.</para></listitem>
|
||||
the log buffer, for example by adding <literal>log_buf_len=8M</literal> to the kernel command line.
|
||||
<command>systemd</command> will automatically disable kernel's rate-limiting applied to userspace
|
||||
processes (equivalent to setting <literal>printk.devkmsg=on</literal>).</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
|
|
|
|||
|
|
@ -1,8 +1,8 @@
|
|||
<?xml version='1.0'?>
|
||||
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
||||
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
|
||||
<!ENTITY fedora_latest_version "30">
|
||||
<!ENTITY fedora_cloud_release "1.2">
|
||||
<!ENTITY fedora_latest_version "31">
|
||||
<!ENTITY fedora_cloud_release "1.9">
|
||||
]>
|
||||
<!-- SPDX-License-Identifier: LGPL-2.1+ -->
|
||||
|
||||
|
|
@ -1378,7 +1378,7 @@
|
|||
|
||||
<programlisting># dnf -y --releasever=&fedora_latest_version; --installroot=/var/lib/machines/f&fedora_latest_version; \
|
||||
--disablerepo='*' --enablerepo=fedora --enablerepo=updates install \
|
||||
systemd passwd dnf fedora-release vim-minimal
|
||||
systemd passwd dnf fedora-release vim-minimal glibc-minimal-langpack
|
||||
# systemd-nspawn -bD /var/lib/machines/f&fedora_latest_version;</programlisting>
|
||||
|
||||
<para>This installs a minimal Fedora distribution into the
|
||||
|
|
|
|||
|
|
@ -26,8 +26,11 @@
|
|||
<refsect1>
|
||||
<title>Description</title>
|
||||
|
||||
<para>Network link configuration is performed by the
|
||||
<command>net_setup_link</command> udev builtin.</para>
|
||||
<para>A plain ini-style text file that encodes configuration for matching network devices, used by
|
||||
<citerefentry><refentrytitle>systemd-udev</refentrytitle><manvolnum>8</manvolnum></citerefentry> and in
|
||||
particular its <command>net_setup_link</command> builtin. See
|
||||
<citerefentry><refentrytitle>systemd.syntax</refentrytitle><manvolnum>5</manvolnum></citerefentry> for a
|
||||
general description of the syntax.</para>
|
||||
|
||||
<para>The link files are read from the files located in the system
|
||||
network directory <filename>/usr/lib/systemd/network</filename>,
|
||||
|
|
|
|||
|
|
@ -27,9 +27,10 @@
|
|||
<refsect1>
|
||||
<title>Description</title>
|
||||
|
||||
<para>Network setup is performed by
|
||||
<para>A plain ini-style text file that encodes configuration about a virtual network device, used by
|
||||
<citerefentry><refentrytitle>systemd-networkd</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
|
||||
</para>
|
||||
See <citerefentry><refentrytitle>systemd.syntax</refentrytitle><manvolnum>5</manvolnum></citerefentry>
|
||||
for a general description of the syntax.</para>
|
||||
|
||||
<para>The main Virtual Network Device file must have the extension <filename>.netdev</filename>;
|
||||
other extensions are ignored. Virtual network devices are created as soon as networkd is
|
||||
|
|
|
|||
|
|
@ -28,9 +28,11 @@
|
|||
<refsect1>
|
||||
<title>Description</title>
|
||||
|
||||
<para>Network setup is performed by
|
||||
<para>A plain ini-style text file that encodes network configuration for matching network interfaces,
|
||||
used by
|
||||
<citerefentry><refentrytitle>systemd-networkd</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
|
||||
</para>
|
||||
See <citerefentry><refentrytitle>systemd.syntax</refentrytitle><manvolnum>5</manvolnum></citerefentry>
|
||||
for a general description of the syntax.</para>
|
||||
|
||||
<para>The main network file must have the extension <filename>.network</filename>; other
|
||||
extensions are ignored. Networks are applied to links whenever the links appear.</para>
|
||||
|
|
@ -514,13 +516,14 @@
|
|||
<varlistentry>
|
||||
<term><varname>Domains=</varname></term>
|
||||
<listitem>
|
||||
<para>A list of domains which should be resolved using the DNS servers on this link. Each item in the list
|
||||
should be a domain name, optionally prefixed with a tilde (<literal>~</literal>). The domains with the
|
||||
prefix are called "routing-only domains". The domains without the prefix are called "search domains" and
|
||||
are first used as search suffixes for extending single-label host names (host names containing no dots) to
|
||||
become fully qualified domain names (FQDNs). If a single-label host name is resolved on this interface,
|
||||
each of the specified search domains are appended to it in turn, converting it into a fully qualified
|
||||
domain name, until one of them may be successfully resolved.</para>
|
||||
<para>A whitespace-separated list of domains which should be resolved using the DNS servers on
|
||||
this link. Each item in the list should be a domain name, optionally prefixed with a tilde
|
||||
(<literal>~</literal>). The domains with the prefix are called "routing-only domains". The
|
||||
domains without the prefix are called "search domains" and are first used as search suffixes for
|
||||
extending single-label host names (host names containing no dots) to become fully qualified
|
||||
domain names (FQDNs). If a single-label host name is resolved on this interface, each of the
|
||||
specified search domains are appended to it in turn, converting it into a fully qualified domain
|
||||
name, until one of them may be successfully resolved.</para>
|
||||
|
||||
<para>Both "search" and "routing-only" domains are used for routing of DNS queries: look-ups for host names
|
||||
ending in those domains (hence also single label names, if any "search domains" are listed), are routed to
|
||||
|
|
@ -613,10 +616,12 @@
|
|||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><varname>IPv6AcceptRA=</varname></term>
|
||||
<listitem><para>Takes a boolean. Controls IPv6 Router Advertisement (RA) reception support
|
||||
for the interface. If true, RAs are accepted; if false, RAs are ignored, independently of the
|
||||
local forwarding state. When RAs are accepted, they may trigger the start of the DHCPv6
|
||||
client if the relevant flags are set in the RA data, or if no routers are found on the link.</para>
|
||||
<listitem><para>Takes a boolean. Controls IPv6 Router Advertisement (RA) reception support for the
|
||||
interface. If true, RAs are accepted; if false, RAs are ignored. When RAs are accepted, they may
|
||||
trigger the start of the DHCPv6 client if the relevant flags are set in the RA data, or if no
|
||||
routers are found on the link. The default is to disable RA reception for bridge devices or when IP
|
||||
forwarding is enabled, and to enable it otherwise. Cannot be enabled on bond devices and when link
|
||||
local adressing is disabled.</para>
|
||||
|
||||
<para>Further settings for the IPv6 RA support may be configured in the
|
||||
<literal>[IPv6AcceptRA]</literal> section, see below.</para>
|
||||
|
|
|
|||
|
|
@ -46,6 +46,15 @@
|
|||
<citerefentry><refentrytitle>systemd.nspawn</refentrytitle><manvolnum>5</manvolnum></citerefentry>
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>link files, see
|
||||
<citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>netdev and network files, see
|
||||
<citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>daemon config files, see
|
||||
<citerefentry><refentrytitle>systemd-system.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>systemd-user.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
|
|
|
|||
|
|
@ -1713,7 +1713,7 @@ static int method_get_dynamic_users(sd_bus_message *message, void *userdata, sd_
|
|||
if (r == -EAGAIN) /* not realized yet? */
|
||||
continue;
|
||||
if (r < 0)
|
||||
return sd_bus_error_setf(error, SD_BUS_ERROR_FAILED, "Failed to lookup a dynamic user.");
|
||||
return sd_bus_error_setf(error, SD_BUS_ERROR_FAILED, "Failed to look up a dynamic user.");
|
||||
|
||||
r = sd_bus_message_append(reply, "(us)", uid, d->name);
|
||||
if (r < 0)
|
||||
|
|
|
|||
|
|
@ -749,7 +749,7 @@ static int mount_private_dev(MountEntry *m) {
|
|||
|
||||
r = dev_setup(temporary_mount, UID_INVALID, GID_INVALID);
|
||||
if (r < 0)
|
||||
log_debug_errno(r, "Failed to setup basic device tree at '%s', ignoring: %m", temporary_mount);
|
||||
log_debug_errno(r, "Failed to set up basic device tree at '%s', ignoring: %m", temporary_mount);
|
||||
|
||||
/* Create the /dev directory if missing. It is more likely to be
|
||||
* missing when the service is started with RootDirectory. This is
|
||||
|
|
|
|||
|
|
@ -3020,7 +3020,7 @@ static int inner_child(
|
|||
|
||||
r = setup_dev_console(console);
|
||||
if (r < 0)
|
||||
return log_error_errno(r, "Failed to setup /dev/console: %m");
|
||||
return log_error_errno(r, "Failed to set up /dev/console: %m");
|
||||
|
||||
r = send_one_fd(master_pty_socket, master, 0);
|
||||
if (r < 0)
|
||||
|
|
|
|||
|
|
@ -863,7 +863,7 @@ void dns_scope_process_query(DnsScope *s, DnsStream *stream, DnsPacket *p) {
|
|||
|
||||
r = dns_zone_lookup(&s->zone, key, 0, &answer, &soa, &tentative);
|
||||
if (r < 0) {
|
||||
log_debug_errno(r, "Failed to lookup key: %m");
|
||||
log_debug_errno(r, "Failed to look up key: %m");
|
||||
return;
|
||||
}
|
||||
if (r == 0)
|
||||
|
|
|
|||
|
|
@ -195,7 +195,7 @@ static int mdns_scope_process_query(DnsScope *s, DnsPacket *p) {
|
|||
|
||||
r = dns_zone_lookup(&s->zone, key, 0, &answer, &soa, &tentative);
|
||||
if (r < 0)
|
||||
return log_debug_errno(r, "Failed to lookup key: %m");
|
||||
return log_debug_errno(r, "Failed to look up key: %m");
|
||||
|
||||
if (tentative && DNS_PACKET_NSCOUNT(p) > 0) {
|
||||
/*
|
||||
|
|
|
|||
|
|
@ -18,7 +18,7 @@ int module_load_and_warn(struct kmod_ctx *ctx, const char *module, bool verbose)
|
|||
r = kmod_module_new_from_lookup(ctx, module, &modlist);
|
||||
if (r < 0)
|
||||
return log_full_errno(verbose ? LOG_ERR : LOG_DEBUG, r,
|
||||
"Failed to lookup module alias '%s': %m", module);
|
||||
"Failed to look up module alias '%s': %m", module);
|
||||
|
||||
if (!modlist) {
|
||||
log_full_errno(verbose ? LOG_ERR : LOG_DEBUG, r,
|
||||
|
|
|
|||
|
|
@ -6590,7 +6590,7 @@ static int enable_sysv_units(const char *verb, char **args) {
|
|||
|
||||
j = unit_file_exists(arg_scope, &paths, name);
|
||||
if (j < 0 && !IN_SET(j, -ELOOP, -ERFKILL, -EADDRNOTAVAIL))
|
||||
return log_error_errno(j, "Failed to lookup unit file state: %m");
|
||||
return log_error_errno(j, "Failed to look up unit file state: %m");
|
||||
found_native = j != 0;
|
||||
|
||||
/* If we have both a native unit and a SysV script, enable/disable them both (below); for is-enabled,
|
||||
|
|
|
|||
|
|
@ -155,7 +155,7 @@ int main(int argc, char *argv[]) {
|
|||
|
||||
r = btrfs_subvol_snapshot("/xxxquotatest", "/xxxquotatest2", BTRFS_SNAPSHOT_RECURSIVE|BTRFS_SNAPSHOT_QUOTA);
|
||||
if (r < 0)
|
||||
log_error_errno(r, "Failed to setup snapshot: %m");
|
||||
log_error_errno(r, "Failed to set up snapshot: %m");
|
||||
|
||||
r = btrfs_qgroup_get_quota("/xxxquotatest2/beneath", 0, "a);
|
||||
if (r < 0)
|
||||
|
|
|
|||
|
|
@ -79,7 +79,7 @@ int main(int argc, char *argv[]) {
|
|||
0,
|
||||
NULL);
|
||||
if (r < 0) {
|
||||
log_error_errno(r, "Failed to setup namespace: %m");
|
||||
log_error_errno(r, "Failed to set up namespace: %m");
|
||||
|
||||
log_info("Usage:\n"
|
||||
" sudo TEST_NS_PROJECTS=/home/lennart/projects ./test-ns\n"
|
||||
|
|
|
|||
|
|
@ -110,7 +110,7 @@ static int manager_send_request(Manager *m) {
|
|||
|
||||
r = manager_listen_setup(m);
|
||||
if (r < 0)
|
||||
return log_warning_errno(r, "Failed to setup connection socket: %m");
|
||||
return log_warning_errno(r, "Failed to set up connection socket: %m");
|
||||
|
||||
/*
|
||||
* Set transmit timestamp, remember it; the server will send that back
|
||||
|
|
|
|||
|
|
@ -163,7 +163,7 @@ static int builtin_hwdb(sd_device *dev, int argc, char *argv[], bool test) {
|
|||
if (argv[optind]) {
|
||||
r = udev_builtin_hwdb_lookup(dev, prefix, argv[optind], filter, test);
|
||||
if (r < 0)
|
||||
return log_device_debug_errno(dev, r, "Failed to lookup hwdb: %m");
|
||||
return log_device_debug_errno(dev, r, "Failed to look up hwdb: %m");
|
||||
if (r == 0)
|
||||
return log_device_debug_errno(dev, SYNTHETIC_ERRNO(ENODATA), "No entry found from hwdb.");
|
||||
return r;
|
||||
|
|
@ -178,7 +178,7 @@ static int builtin_hwdb(sd_device *dev, int argc, char *argv[], bool test) {
|
|||
|
||||
r = udev_builtin_hwdb_search(dev, srcdev, subsystem, prefix, filter, test);
|
||||
if (r < 0)
|
||||
return log_device_debug_errno(dev, r, "Failed to lookup hwdb: %m");
|
||||
return log_device_debug_errno(dev, r, "Failed to look up hwdb: %m");
|
||||
if (r == 0)
|
||||
return log_device_debug_errno(dev, SYNTHETIC_ERRNO(ENODATA), "No entry found from hwdb.");
|
||||
return r;
|
||||
|
|
|
|||
|
|
@ -10,7 +10,6 @@ Release=29
|
|||
[Output]
|
||||
Format=raw_btrfs
|
||||
Bootable=yes
|
||||
KernelCommandLine=printk.devkmsg=on
|
||||
OutputDirectory=../mkosi.output
|
||||
Output=networkd-test.raw
|
||||
|
||||
|
|
|
|||
|
|
@ -212,7 +212,6 @@ loglevel=2 \
|
|||
init=$PATH_TO_INIT \
|
||||
console=$CONSOLE \
|
||||
selinux=0 \
|
||||
printk.devkmsg=on \
|
||||
$_cgroup_args \
|
||||
$KERNEL_APPEND \
|
||||
"
|
||||
|
|
|
|||
Loading…
Reference in New Issue