mirror of
https://github.com/systemd/systemd.git
synced 2025-01-11 09:18:07 +03:00
tree-wide: use html links for kernel docs
Instead of using "*.txt" as reference name, use the actual destination title.
This commit is contained in:
parent
12bdeb58a6
commit
2f8211c64a
2
NEWS
2
NEWS
@ -5332,7 +5332,7 @@ CHANGES WITH 240:
|
|||||||
a client with a Wi-Fi and Ethernet both connected to the internet).
|
a client with a Wi-Fi and Ethernet both connected to the internet).
|
||||||
|
|
||||||
Consult the kernel documentation for details on this sysctl:
|
Consult the kernel documentation for details on this sysctl:
|
||||||
https://www.kernel.org/doc/Documentation/networking/ip-sysctl.txt
|
https://www.kernel.org/doc/html/latest/networking/ip-sysctl.html
|
||||||
|
|
||||||
* The v239 change to turn on "net.ipv4.tcp_ecn" by default has been
|
* The v239 change to turn on "net.ipv4.tcp_ecn" by default has been
|
||||||
reverted.
|
reverted.
|
||||||
|
@ -342,7 +342,7 @@
|
|||||||
|
|
||||||
<para><function>sd_bus_creds_get_cgroup()</function> will retrieve
|
<para><function>sd_bus_creds_get_cgroup()</function> will retrieve
|
||||||
the control group path. See <ulink
|
the control group path. See <ulink
|
||||||
url="https://www.kernel.org/doc/Documentation/cgroup-v1/cgroups.txt">cgroups.txt</ulink>.
|
url="https://www.kernel.org/doc/html/latest/admin-guide/cgroup-v1/index.html">Control Groups version 1</ulink>.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para><function>sd_bus_creds_get_unit()</function> will retrieve
|
<para><function>sd_bus_creds_get_unit()</function> will retrieve
|
||||||
|
@ -40,8 +40,8 @@
|
|||||||
place, regardless of which environment the system is started in. For example, it is sufficient to
|
place, regardless of which environment the system is started in. For example, it is sufficient to
|
||||||
redirect the kernel console with a kernel command line argument such as <varname>console=</varname> to
|
redirect the kernel console with a kernel command line argument such as <varname>console=</varname> to
|
||||||
get both kernel messages and a getty prompt on a serial TTY. See <ulink
|
get both kernel messages and a getty prompt on a serial TTY. See <ulink
|
||||||
url="https://www.kernel.org/doc/Documentation/admin-guide/kernel-parameters.txt"><filename>kernel-parameters.txt</filename></ulink>
|
url="https://www.kernel.org/doc/html/latest/admin-guide/kernel-parameters.html">The kernel's command-line
|
||||||
for more information on the <varname>console=</varname> kernel parameter.</para>
|
parameters</ulink> for more information on the <varname>console=</varname> kernel parameter.</para>
|
||||||
|
|
||||||
<para><filename>systemd-getty-generator</filename> implements
|
<para><filename>systemd-getty-generator</filename> implements
|
||||||
<citerefentry><refentrytitle>systemd.generator</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
|
<citerefentry><refentrytitle>systemd.generator</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
|
||||||
|
@ -34,8 +34,8 @@
|
|||||||
device to resume from as the template argument.</para>
|
device to resume from as the template argument.</para>
|
||||||
|
|
||||||
<para><filename>systemd-hibernate-resume</filename> only supports
|
<para><filename>systemd-hibernate-resume</filename> only supports
|
||||||
the in-kernel hibernation implementation, known as
|
the in-kernel hibernation implementation, see
|
||||||
<ulink url="https://www.kernel.org/doc/Documentation/power/swsusp.txt">swsusp</ulink>.
|
<ulink url="https://www.kernel.org/doc/html/latest/power/swsusp.html">Swap suspend</ulink>.
|
||||||
Internally, it works by writing the major:minor of specified
|
Internally, it works by writing the major:minor of specified
|
||||||
device node to <filename>/sys/power/resume</filename>.</para>
|
device node to <filename>/sys/power/resume</filename>.</para>
|
||||||
|
|
||||||
|
@ -1492,21 +1492,16 @@ After=sys-subsystem-net-devices-ens1.device</programlisting>
|
|||||||
temporary directory on a read-only <filename>/var/</filename> directory.</para>
|
temporary directory on a read-only <filename>/var/</filename> directory.</para>
|
||||||
|
|
||||||
<para>For details about overlay file systems, see <ulink
|
<para>For details about overlay file systems, see <ulink
|
||||||
url="https://www.kernel.org/doc/Documentation/filesystems/overlayfs.txt">overlayfs.txt</ulink>. Note
|
url="https://www.kernel.org/doc/html/latest/filesystems/overlayfs.html">Overlay Filesystem</ulink>.
|
||||||
that the semantics of overlay file systems are substantially
|
Note that the semantics of overlay file systems are substantially different from normal file systems,
|
||||||
different from normal file systems, in particular regarding
|
in particular regarding reported device and inode information. Device and inode information may
|
||||||
reported device and inode information. Device and inode
|
change for a file while it is being written to, and processes might see out-of-date versions of files
|
||||||
information may change for a file while it is being written
|
at times. Note that this switch automatically derives the <literal>workdir=</literal> mount option
|
||||||
to, and processes might see out-of-date versions of files at
|
for the overlay file system from the top-level directory tree, making it a sibling of it. It is hence
|
||||||
times. Note that this switch automatically derives the
|
essential that the top-level directory tree is not a mount point itself (since the working directory
|
||||||
<literal>workdir=</literal> mount option for the overlay file
|
must be on the same file system as the top-most directory tree). Also note that the
|
||||||
system from the top-level directory tree, making it a sibling
|
<literal>lowerdir=</literal> mount option receives the paths to stack in the opposite order of this
|
||||||
of it. It is hence essential that the top-level directory tree
|
switch.</para>
|
||||||
is not a mount point itself (since the working directory must
|
|
||||||
be on the same file system as the top-most directory
|
|
||||||
tree). Also note that the <literal>lowerdir=</literal> mount
|
|
||||||
option receives the paths to stack in the opposite order of
|
|
||||||
this switch.</para>
|
|
||||||
|
|
||||||
<para>Note that this option cannot be used to replace the root file system of the container with an overlay
|
<para>Note that this option cannot be used to replace the root file system of the container with an overlay
|
||||||
file system. However, the <option>--volatile=</option> option described above provides similar functionality,
|
file system. However, the <option>--volatile=</option> option described above provides similar functionality,
|
||||||
|
@ -1042,9 +1042,9 @@ CapabilityBoundingSet=~CAP_B CAP_C</programlisting>
|
|||||||
<listitem><para>Sets the adjustment value for the Linux kernel's Out-Of-Memory (OOM) killer score for
|
<listitem><para>Sets the adjustment value for the Linux kernel's Out-Of-Memory (OOM) killer score for
|
||||||
executed processes. Takes an integer between -1000 (to disable OOM killing of processes of this unit)
|
executed processes. Takes an integer between -1000 (to disable OOM killing of processes of this unit)
|
||||||
and 1000 (to make killing of processes of this unit under memory pressure very likely). See <ulink
|
and 1000 (to make killing of processes of this unit under memory pressure very likely). See <ulink
|
||||||
url="https://www.kernel.org/doc/Documentation/filesystems/proc.txt">proc.txt</ulink> for details. If
|
url="https://www.kernel.org/doc/html/latest/filesystems/proc.html">The /proc Filesystem</ulink> for
|
||||||
not specified defaults to the OOM score adjustment level of the service manager itself, which is
|
details. If not specified defaults to the OOM score adjustment level of the service manager itself,
|
||||||
normally at 0.</para>
|
which is normally at 0.</para>
|
||||||
|
|
||||||
<para>Use the <varname>OOMPolicy=</varname> setting of service units to configure how the service
|
<para>Use the <varname>OOMPolicy=</varname> setting of service units to configure how the service
|
||||||
manager shall react to the kernel OOM killer or <command>systemd-oomd</command> terminating a process of the service. See
|
manager shall react to the kernel OOM killer or <command>systemd-oomd</command> terminating a process of the service. See
|
||||||
|
@ -90,7 +90,7 @@
|
|||||||
</row></thead>
|
</row></thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
<row><entry><varname>bond</varname></entry>
|
<row><entry><varname>bond</varname></entry>
|
||||||
<entry>A bond device is an aggregation of all its slave devices. See <ulink url="https://www.kernel.org/doc/Documentation/networking/bonding.txt">Linux Ethernet Bonding Driver HOWTO</ulink> for details.</entry></row>
|
<entry>A bond device is an aggregation of all its slave devices. See <ulink url="https://www.kernel.org/doc/html/latest/networking/bonding.html">Linux Ethernet Bonding Driver HOWTO</ulink> for details.</entry></row>
|
||||||
|
|
||||||
<row><entry><varname>bridge</varname></entry>
|
<row><entry><varname>bridge</varname></entry>
|
||||||
<entry>A bridge device is a software switch, and each of its slave devices and the bridge itself are ports of the switch.</entry></row>
|
<entry>A bridge device is a software switch, and each of its slave devices and the bridge itself are ports of the switch.</entry></row>
|
||||||
@ -165,7 +165,7 @@
|
|||||||
<entry>Media Access Control Security (MACsec) is an 802.1AE IEEE industry-standard security technology that provides secure communication for all traffic on Ethernet links. MACsec provides point-to-point security on Ethernet links between directly connected nodes and is capable of identifying and preventing most security threats.</entry></row>
|
<entry>Media Access Control Security (MACsec) is an 802.1AE IEEE industry-standard security technology that provides secure communication for all traffic on Ethernet links. MACsec provides point-to-point security on Ethernet links between directly connected nodes and is capable of identifying and preventing most security threats.</entry></row>
|
||||||
|
|
||||||
<row><entry><varname>vrf</varname></entry>
|
<row><entry><varname>vrf</varname></entry>
|
||||||
<entry>A Virtual Routing and Forwarding (<ulink url="https://www.kernel.org/doc/Documentation/networking/vrf.txt">VRF</ulink>) interface to create separate routing and forwarding domains.</entry></row>
|
<entry>A Virtual Routing and Forwarding (<ulink url="https://www.kernel.org/doc/html/latest/networking/vrf.html">VRF</ulink>) interface to create separate routing and forwarding domains.</entry></row>
|
||||||
|
|
||||||
<row><entry><varname>vcan</varname></entry>
|
<row><entry><varname>vcan</varname></entry>
|
||||||
<entry>The virtual CAN driver (vcan). Similar to the network loopback devices, vcan offers a virtual local CAN interface.</entry></row>
|
<entry>The virtual CAN driver (vcan). Similar to the network loopback devices, vcan offers a virtual local CAN interface.</entry></row>
|
||||||
@ -2021,7 +2021,7 @@
|
|||||||
</variablelist>
|
</variablelist>
|
||||||
|
|
||||||
<para>For more detail information see
|
<para>For more detail information see
|
||||||
<ulink url="https://www.kernel.org/doc/Documentation/networking/bonding.txt">
|
<ulink url="https://www.kernel.org/doc/html/latest/networking/bonding.html">
|
||||||
Linux Ethernet Bonding Driver HOWTO</ulink></para>
|
Linux Ethernet Bonding Driver HOWTO</ulink></para>
|
||||||
</refsect1>
|
</refsect1>
|
||||||
|
|
||||||
|
@ -670,7 +670,7 @@ Table=1234</programlisting></para>
|
|||||||
enable IP packet forwarding for the specified address family. This controls the
|
enable IP packet forwarding for the specified address family. This controls the
|
||||||
<filename>net.ipv4.ip_forward</filename> and <filename>net.ipv6.conf.all.forwarding</filename>
|
<filename>net.ipv4.ip_forward</filename> and <filename>net.ipv6.conf.all.forwarding</filename>
|
||||||
sysctl options of the network interface (see
|
sysctl options of the network interface (see
|
||||||
<ulink url="https://www.kernel.org/doc/Documentation/networking/ip-sysctl.txt">ip-sysctl.txt</ulink>
|
<ulink url="https://www.kernel.org/doc/html/latest/networking/ip-sysctl.html">IP Sysctl</ulink>
|
||||||
for details about sysctl options). Defaults to <literal>no</literal>.</para>
|
for details about sysctl options). Defaults to <literal>no</literal>.</para>
|
||||||
|
|
||||||
<para>Note: this setting controls a global kernel option, and does so one way only: if a
|
<para>Note: this setting controls a global kernel option, and does so one way only: if a
|
||||||
@ -726,7 +726,7 @@ Table=1234</programlisting></para>
|
|||||||
section, see below.</para>
|
section, see below.</para>
|
||||||
|
|
||||||
<para>Also see
|
<para>Also see
|
||||||
<ulink url="https://www.kernel.org/doc/Documentation/networking/ip-sysctl.txt">ip-sysctl.txt</ulink>
|
<ulink url="https://www.kernel.org/doc/html/latest/networking/ip-sysctl.html">IP Sysctl</ulink>
|
||||||
in the kernel documentation regarding <literal>accept_ra</literal>, but note that systemd's
|
in the kernel documentation regarding <literal>accept_ra</literal>, but note that systemd's
|
||||||
setting of <constant>1</constant> (i.e. true) corresponds to kernel's setting of
|
setting of <constant>1</constant> (i.e. true) corresponds to kernel's setting of
|
||||||
<constant>2</constant>.</para>
|
<constant>2</constant>.</para>
|
||||||
|
@ -208,7 +208,7 @@
|
|||||||
<literal>cpu.max</literal> attribute on the unified control group hierarchy and
|
<literal>cpu.max</literal> attribute on the unified control group hierarchy and
|
||||||
<literal>cpu.cfs_quota_us</literal> on legacy. For details about these control group attributes, see <ulink
|
<literal>cpu.cfs_quota_us</literal> on legacy. For details about these control group attributes, see <ulink
|
||||||
url="https://www.kernel.org/doc/html/latest/admin-guide/cgroup-v2.html">Control Groups v2</ulink> and <ulink
|
url="https://www.kernel.org/doc/html/latest/admin-guide/cgroup-v2.html">Control Groups v2</ulink> and <ulink
|
||||||
url="https://www.kernel.org/doc/Documentation/scheduler/sched-bwc.txt">sched-bwc.txt</ulink>.
|
url="https://www.kernel.org/doc/html/latest/scheduler/sched-bwc.html">CFS Bandwidth Control</ulink>.
|
||||||
Setting <varname>CPUQuota=</varname> to an empty value unsets the quota.</para>
|
Setting <varname>CPUQuota=</varname> to an empty value unsets the quota.</para>
|
||||||
|
|
||||||
<para>Example: <varname>CPUQuota=20%</varname> ensures that the executed processes will never get more than
|
<para>Example: <varname>CPUQuota=20%</varname> ensures that the executed processes will never get more than
|
||||||
|
@ -1103,7 +1103,7 @@
|
|||||||
<term><varname>USBFunctionDescriptors=</varname></term>
|
<term><varname>USBFunctionDescriptors=</varname></term>
|
||||||
<listitem><para>Configure the location of a file containing
|
<listitem><para>Configure the location of a file containing
|
||||||
<ulink
|
<ulink
|
||||||
url="https://www.kernel.org/doc/Documentation/usb/functionfs.txt">USB
|
url="https://www.kernel.org/doc/html/latest/usb/functionfs.html">USB
|
||||||
FunctionFS</ulink> descriptors, for implementation of USB
|
FunctionFS</ulink> descriptors, for implementation of USB
|
||||||
gadget functions. This is used only in conjunction with a
|
gadget functions. This is used only in conjunction with a
|
||||||
socket unit with <varname>ListenUSBFunction=</varname>
|
socket unit with <varname>ListenUSBFunction=</varname>
|
||||||
|
@ -299,7 +299,7 @@
|
|||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><varname>ListenUSBFunction=</varname></term>
|
<term><varname>ListenUSBFunction=</varname></term>
|
||||||
<listitem><para>Specifies a <ulink
|
<listitem><para>Specifies a <ulink
|
||||||
url="https://www.kernel.org/doc/Documentation/usb/functionfs.txt">USB
|
url="https://www.kernel.org/doc/html/latest/usb/functionfs.html">USB
|
||||||
FunctionFS</ulink> endpoints location to listen on, for
|
FunctionFS</ulink> endpoints location to listen on, for
|
||||||
implementation of USB gadget functions. This expects an
|
implementation of USB gadget functions. This expects an
|
||||||
absolute file system path of a FunctionFS mount point as the argument.
|
absolute file system path of a FunctionFS mount point as the argument.
|
||||||
@ -615,7 +615,7 @@
|
|||||||
the security label of the FIFO, or the security label for the
|
the security label of the FIFO, or the security label for the
|
||||||
incoming or outgoing connections of the socket, respectively.
|
incoming or outgoing connections of the socket, respectively.
|
||||||
See <ulink
|
See <ulink
|
||||||
url="https://www.kernel.org/doc/Documentation/security/Smack.txt">Smack.txt</ulink>
|
url="https://www.kernel.org/doc/html/latest/admin-guide/LSM/Smack.html">Smack</ulink>
|
||||||
for details.</para></listitem>
|
for details.</para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
@ -210,7 +210,7 @@
|
|||||||
<para>Processes systemd spawns are placed in individual Linux
|
<para>Processes systemd spawns are placed in individual Linux
|
||||||
control groups named after the unit which they belong to in the
|
control groups named after the unit which they belong to in the
|
||||||
private systemd hierarchy. (see <ulink
|
private systemd hierarchy. (see <ulink
|
||||||
url="https://www.kernel.org/doc/Documentation/cgroup-v1/cgroups.txt">cgroups.txt</ulink>
|
url="https://www.kernel.org/doc/html/latest/admin-guide/cgroup-v1/index.html">Control Groups version 1</ulink>
|
||||||
for more information about control groups, or short "cgroups").
|
for more information about control groups, or short "cgroups").
|
||||||
systemd uses this to effectively keep track of processes. Control
|
systemd uses this to effectively keep track of processes. Control
|
||||||
group information is maintained in the kernel, and is accessible
|
group information is maintained in the kernel, and is accessible
|
||||||
|
@ -71,7 +71,7 @@ static EFI_STATUS pack_cpio_one(
|
|||||||
|
|
||||||
/* Serializes one file in the cpio format understood by the kernel initrd logic.
|
/* Serializes one file in the cpio format understood by the kernel initrd logic.
|
||||||
*
|
*
|
||||||
* See: https://www.kernel.org/doc/Documentation/early-userspace/buffer-format.txt */
|
* See: https://www.kernel.org/doc/html/latest/driver-api/early-userspace/buffer-format.html */
|
||||||
|
|
||||||
if (contents_size > UINT32_MAX) /* cpio cannot deal with > 32bit file sizes */
|
if (contents_size > UINT32_MAX) /* cpio cannot deal with > 32bit file sizes */
|
||||||
return EFI_LOAD_ERROR;
|
return EFI_LOAD_ERROR;
|
||||||
|
@ -274,9 +274,9 @@ int user_record_authenticate(
|
|||||||
static void drop_caches_now(void) {
|
static void drop_caches_now(void) {
|
||||||
int r;
|
int r;
|
||||||
|
|
||||||
/* Drop file system caches now. See https://www.kernel.org/doc/Documentation/sysctl/vm.txt for
|
/* Drop file system caches now. See https://www.kernel.org/doc/html/latest/admin-guide/sysctl/vm.html
|
||||||
* details. We write "2" into /proc/sys/vm/drop_caches to ensure dentries/inodes are flushed, but not
|
* for details. We write "2" into /proc/sys/vm/drop_caches to ensure dentries/inodes are flushed, but
|
||||||
* more. */
|
* not more. */
|
||||||
|
|
||||||
r = write_string_file("/proc/sys/vm/drop_caches", "2\n", WRITE_STRING_FILE_DISABLE_BUFFER);
|
r = write_string_file("/proc/sys/vm/drop_caches", "2\n", WRITE_STRING_FILE_DISABLE_BUFFER);
|
||||||
if (r < 0)
|
if (r < 0)
|
||||||
|
@ -9,7 +9,7 @@
|
|||||||
|
|
||||||
[Unit]
|
[Unit]
|
||||||
Description=Huge Pages File System
|
Description=Huge Pages File System
|
||||||
Documentation=https://www.kernel.org/doc/Documentation/vm/hugetlbpage.txt
|
Documentation=https://www.kernel.org/doc/html/latest/admin-guide/mm/hugetlbpage.html
|
||||||
Documentation=https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems
|
Documentation=https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems
|
||||||
DefaultDependencies=no
|
DefaultDependencies=no
|
||||||
Before=sysinit.target
|
Before=sysinit.target
|
||||||
|
@ -9,7 +9,7 @@
|
|||||||
|
|
||||||
[Unit]
|
[Unit]
|
||||||
Description=FUSE Control File System
|
Description=FUSE Control File System
|
||||||
Documentation=https://www.kernel.org/doc/Documentation/filesystems/fuse.txt
|
Documentation=https://www.kernel.org/doc/html/latest/filesystems/fuse.html
|
||||||
Documentation=https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems
|
Documentation=https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems
|
||||||
DefaultDependencies=no
|
DefaultDependencies=no
|
||||||
ConditionPathExists=/sys/fs/fuse/connections
|
ConditionPathExists=/sys/fs/fuse/connections
|
||||||
|
@ -9,7 +9,7 @@
|
|||||||
|
|
||||||
[Unit]
|
[Unit]
|
||||||
Description=Kernel Configuration File System
|
Description=Kernel Configuration File System
|
||||||
Documentation=https://www.kernel.org/doc/Documentation/filesystems/configfs/configfs.txt
|
Documentation=https://www.kernel.org/doc/html/latest/filesystems/configfs.html
|
||||||
Documentation=https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems
|
Documentation=https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems
|
||||||
DefaultDependencies=no
|
DefaultDependencies=no
|
||||||
ConditionPathExists=/sys/kernel/config
|
ConditionPathExists=/sys/kernel/config
|
||||||
|
@ -9,7 +9,7 @@
|
|||||||
|
|
||||||
[Unit]
|
[Unit]
|
||||||
Description=Kernel Debug File System
|
Description=Kernel Debug File System
|
||||||
Documentation=https://www.kernel.org/doc/Documentation/filesystems/debugfs.txt
|
Documentation=https://www.kernel.org/doc/html/latest/filesystems/debugfs.html
|
||||||
Documentation=https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems
|
Documentation=https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems
|
||||||
DefaultDependencies=no
|
DefaultDependencies=no
|
||||||
ConditionPathExists=/sys/kernel/debug
|
ConditionPathExists=/sys/kernel/debug
|
||||||
|
@ -9,7 +9,7 @@
|
|||||||
|
|
||||||
[Unit]
|
[Unit]
|
||||||
Description=Kernel Trace File System
|
Description=Kernel Trace File System
|
||||||
Documentation=https://www.kernel.org/doc/Documentation/trace/ftrace.txt
|
Documentation=https://www.kernel.org/doc/html/latest/trace/ftrace.html
|
||||||
Documentation=https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems
|
Documentation=https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems
|
||||||
DefaultDependencies=no
|
DefaultDependencies=no
|
||||||
ConditionVirtualization=!lxc
|
ConditionVirtualization=!lxc
|
||||||
|
Loading…
Reference in New Issue
Block a user