1
0
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:
Zbigniew Jędrzejewski-Szmek 2022-07-01 18:03:09 +02:00
parent 12bdeb58a6
commit 2f8211c64a
19 changed files with 38 additions and 43 deletions

2
NEWS
View File

@ -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.

View File

@ -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

View File

@ -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>

View File

@ -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>

View File

@ -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,

View File

@ -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

View File

@ -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>

View File

@ -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>

View File

@ -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

View File

@ -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>

View File

@ -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>

View File

@ -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

View File

@ -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;

View File

@ -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)

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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