tree-wide: use html links for kernel docs

Instead of using "*.txt" as reference name, use the actual destination title.
2024-12-22 17:35:35 +03:00 · 2022-07-01 18:03:09 +02:00 · 2022-07-01 18:03:09 +02:00 · 2f8211c64a
commit 2f8211c64a
parent 12bdeb58a6
19 changed files with 38 additions and 43 deletions
--- a/2
+++ b/2
@ -5332,7 +5332,7 @@ CHANGES WITH 240:
          a client with a Wi-Fi and Ethernet both connected to the internet).

          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
          reverted.
--- a/man/sd_bus_creds_get_pid.xml
+++ b/man/sd_bus_creds_get_pid.xml
@ -342,7 +342,7 @@

    <para><function>sd_bus_creds_get_cgroup()</function> will retrieve
    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><function>sd_bus_creds_get_unit()</function> will retrieve
--- a/man/systemd-getty-generator.xml
+++ b/man/systemd-getty-generator.xml
@ -40,8 +40,8 @@
    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
    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>
-    for more information on the <varname>console=</varname> kernel parameter.</para>
+    url="https://www.kernel.org/doc/html/latest/admin-guide/kernel-parameters.html">The kernel's command-line
+    parameters</ulink> for more information on the <varname>console=</varname> kernel parameter.</para>

    <para><filename>systemd-getty-generator</filename> implements
    <citerefentry><refentrytitle>systemd.generator</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
--- a/man/systemd-hibernate-resume@.service.xml
+++ b/man/systemd-hibernate-resume@.service.xml
@ -34,8 +34,8 @@
    device to resume from as the template argument.</para>

    <para><filename>systemd-hibernate-resume</filename> only supports
-    the in-kernel hibernation implementation, known as
-    <ulink url="https://www.kernel.org/doc/Documentation/power/swsusp.txt">swsusp</ulink>.
+    the in-kernel hibernation implementation, see
+    <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
    device node to <filename>/sys/power/resume</filename>.</para>

--- a/man/systemd-nspawn.xml
+++ b/man/systemd-nspawn.xml
@ -1492,21 +1492,16 @@ After=sys-subsystem-net-devices-ens1.device</programlisting>
        temporary directory on a read-only <filename>/var/</filename> directory.</para>

        <para>For details about overlay file systems, see <ulink
-        url="https://www.kernel.org/doc/Documentation/filesystems/overlayfs.txt">overlayfs.txt</ulink>. Note
-        that the semantics of overlay file systems are substantially
-        different from normal file systems, in particular regarding
-        reported device and inode information. Device and inode
-        information may change for a file while it is being written
-        to, and processes might see out-of-date versions of files at
-        times. Note that this switch automatically derives the
-        <literal>workdir=</literal> mount option for the overlay file
-        system from the top-level directory tree, making it a sibling
-        of it. It is hence essential that the top-level directory tree
-        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>
+        url="https://www.kernel.org/doc/html/latest/filesystems/overlayfs.html">Overlay Filesystem</ulink>.
+        Note that the semantics of overlay file systems are substantially different from normal file systems,
+        in particular regarding reported device and inode information. Device and inode information may
+        change for a file while it is being written to, and processes might see out-of-date versions of files
+        at times. Note that this switch automatically derives the <literal>workdir=</literal> mount option
+        for the overlay file system from the top-level directory tree, making it a sibling of it. It is hence
+        essential that the top-level directory tree 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
        file system. However, the <option>--volatile=</option> option described above provides similar functionality,
--- a/man/systemd.exec.xml
+++ b/man/systemd.exec.xml
@ -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
        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
-        url="https://www.kernel.org/doc/Documentation/filesystems/proc.txt">proc.txt</ulink> for details. If
-        not specified defaults to the OOM score adjustment level of the service manager itself, which is
-        normally at 0.</para>
+        url="https://www.kernel.org/doc/html/latest/filesystems/proc.html">The /proc Filesystem</ulink> for
+        details. If not specified defaults to the OOM score adjustment level of the service manager itself,
+        which is normally at 0.</para>

        <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
--- a/man/systemd.netdev.xml
+++ b/man/systemd.netdev.xml
@ -90,7 +90,7 @@
        </row></thead>
        <tbody>
          <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>
          <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>

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

    <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>
  </refsect1>

--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@ -670,7 +670,7 @@ Table=1234</programlisting></para>
          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>
          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>

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

          <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
          setting of <constant>1</constant> (i.e. true) corresponds to kernel's setting of
          <constant>2</constant>.</para>
--- a/man/systemd.resource-control.xml
+++ b/man/systemd.resource-control.xml
@ -208,7 +208,7 @@
          <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
          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>

          <para>Example: <varname>CPUQuota=20%</varname> ensures that the executed processes will never get more than
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@ -1103,7 +1103,7 @@
        <term><varname>USBFunctionDescriptors=</varname></term>
        <listitem><para>Configure the location of a file containing
        <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
        gadget functions. This is used only in conjunction with a
        socket unit with <varname>ListenUSBFunction=</varname>
--- a/man/systemd.socket.xml
+++ b/man/systemd.socket.xml
@ -299,7 +299,7 @@
      <varlistentry>
        <term><varname>ListenUSBFunction=</varname></term>
        <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
        implementation of USB gadget functions. This expects an
        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
        incoming or outgoing connections of the socket, respectively.
        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>
      </varlistentry>

--- a/man/systemd.xml
+++ b/man/systemd.xml
@ -210,7 +210,7 @@
    <para>Processes systemd spawns are placed in individual Linux
    control groups named after the unit which they belong to in the
    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").
    systemd uses this to effectively keep track of processes. Control
    group information is maintained in the kernel, and is accessible
--- a/src/boot/efi/cpio.c
+++ b/src/boot/efi/cpio.c
@ -71,7 +71,7 @@ static EFI_STATUS pack_cpio_one(

        /* 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 */
                return EFI_LOAD_ERROR;
--- a/src/home/homework.c
+++ b/src/home/homework.c
@ -274,9 +274,9 @@ int user_record_authenticate(
 static void drop_caches_now(void) {
        int r;

-        /* Drop file system caches now. See https://www.kernel.org/doc/Documentation/sysctl/vm.txt for
-         * details. We write "2" into /proc/sys/vm/drop_caches to ensure dentries/inodes are flushed, but not
-         * more. */
+        /* Drop file system caches now. See https://www.kernel.org/doc/html/latest/admin-guide/sysctl/vm.html
+         * for details. We write "2" into /proc/sys/vm/drop_caches to ensure dentries/inodes are flushed, but
+         * not more. */

        r = write_string_file("/proc/sys/vm/drop_caches", "2\n", WRITE_STRING_FILE_DISABLE_BUFFER);
        if (r < 0)
--- a/units/dev-hugepages.mount
+++ b/units/dev-hugepages.mount
@ -9,7 +9,7 @@

 [Unit]
 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
 DefaultDependencies=no
 Before=sysinit.target
--- a/units/sys-fs-fuse-connections.mount
+++ b/units/sys-fs-fuse-connections.mount
@ -9,7 +9,7 @@

 [Unit]
 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
 DefaultDependencies=no
 ConditionPathExists=/sys/fs/fuse/connections
--- a/units/sys-kernel-config.mount
+++ b/units/sys-kernel-config.mount
@ -9,7 +9,7 @@

 [Unit]
 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
 DefaultDependencies=no
 ConditionPathExists=/sys/kernel/config
--- a/units/sys-kernel-debug.mount
+++ b/units/sys-kernel-debug.mount
@ -9,7 +9,7 @@

 [Unit]
 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
 DefaultDependencies=no
 ConditionPathExists=/sys/kernel/debug
--- a/units/sys-kernel-tracing.mount
+++ b/units/sys-kernel-tracing.mount
@ -9,7 +9,7 @@

 [Unit]
 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
 DefaultDependencies=no
 ConditionVirtualization=!lxc