tree: docparse: Use links to man and kselftest

Add new configuration for extlinks for kselftest.

Signed-off-by: Petr Vorel <[email protected]>

Author: pevik

doc/conf.py

@@ -41,6 +41,7 @@
     # TODO: allow 2nd parameter to show page description instead of plain URL
     'kernel_doc': ('https://docs.kernel.org/%s.html', 'https://docs.kernel.org/%s.html'),
     'kernel_tree': ('https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/%s', '%s'),
+    'kselftest': ('https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/tools/testing/selftests/%s', '%s (kselftest)'),
 }
 
 spelling_lang = "en_US"

testcases/kernel/syscalls/ioctl/ioctl10.c

@@ -6,7 +6,7 @@
 /*\
  * Test PROCMAP_QUERY ioctl() for /proc/$PID/maps.
  *
- * Test based on kernel selftests proc-pid-vm.c.
+ * Test based on :kselftest:`proc/proc-pid-vm.c`.
  *
  * - ioctl with exact match query_addr
  * - ioctl without match query_addr

testcases/kernel/syscalls/memfd_create/memfd_create01.c

@@ -2,13 +2,11 @@
 /*
  * Copyright (c) Linux Test Project, 2017-2020
  * Copyright (C) 2017  Red Hat, Inc.
+ * Port to LTP <[email protected]>
  */
 
-/*
- *  Based on Linux/tools/testing/selftests/memfd/memfd_test.c
- *  by David Herrmann <[email protected]>
- *
- *  24/02/2017   Port to LTP    <[email protected]>
+/*\
+ * Test based on :kselftest:`memfd/memfd_test.c`.
  */
 
 #define _GNU_SOURCE

testcases/kernel/syscalls/memfd_create/memfd_create02.c

@@ -1,14 +1,12 @@
 // SPDX-License-Identifier: GPL-2.0-or-later
 /*
  * Copyright (C) 2017  Red Hat, Inc.
+ * Port to LTP <[email protected]>
  */
 
- /*
-  *  Based on Linux/tools/testing/selftests/memfd/memfd_test.c
-  *  by David Herrmann <[email protected]>
-  *
-  *  24/02/2017   Port to LTP    <[email protected]>
-  */
+/*\
+ * Test based on :kselftest:`memfd/memfd_test.c`.
+ */
 
 #define _GNU_SOURCE
 

testcases/kernel/syscalls/mmap/mmap22.c

@@ -4,9 +4,9 @@
  */
 
 /*\
- * Test mmap(2) with MAP_DROPPABLE flag.
+ * Test :man2:`mmap` with MAP_DROPPABLE flag.
  *
- * Test base on kernel selftests/mm/droppable.c
+ * Test based on :kselftest:`mm/droppable.c`.
  *
  * Ensure that memory allocated with MAP_DROPPABLE can be reclaimed
  * under memory pressure within a cgroup.

testcases/kernel/syscalls/mount/mount07.c

@@ -6,12 +6,12 @@
 
 /*\
  * It is a basic test for MS_NOSYMFOLLOW mount option and is copied
- * from kernel selftests nosymfollow-test.c.
+ * from :kselftest:`mount/nosymfollow-test.c`.
  *
  * It tests to make sure that symlink traversal fails with ELOOP when
  * 'nosymfollow' is set, but symbolic links can still be created, and
- * readlink(2) and realpath(3) still work properly. It also verifies
- * that statfs(2) correctly returns ST_NOSYMFOLLOW.
+ * :man2:`readlink` and :man3:`realpath` still work properly. It also verifies
+ * that :man2:`statfs` correctly returns ST_NOSYMFOLLOW.
  */
 
 #include <limits.h>

testcases/kernel/syscalls/umount/umount01.c

@@ -6,7 +6,7 @@
  */
 
 /*\
- * Check the basic functionality of the umount(2) system call.
+ * Check the basic functionality of the :man2:`umount` system call.
  */
 
 #include <sys/mount.h>

testcases/kernel/syscalls/umount/umount02.c

@@ -7,9 +7,9 @@
  */
 
 /*\
- * Check for basic errors returned by umount(2) system call.
+ * Check for basic errors returned by :man2:`umount` system call.
  *
- * Verify that umount(2) returns -1 and sets errno to
+ * Verify that :man2:`umount` returns -1 and sets errno to
  *
  * 1. EBUSY if it cannot be umounted, because dir is still busy.
  * 2. EFAULT if specialfile or device file points to invalid address space.

testcases/kernel/syscalls/umount/umount03.c

@@ -6,7 +6,7 @@
  */
 
 /*\
- * Verify that umount(2) returns -1 and sets errno to EPERM if the user
+ * Verify that :man2:`umount` returns -1 and sets errno to EPERM if the user
  * is not the super-user.
  */
 

testcases/kernel/syscalls/umount2/umount2_02.c

@@ -5,14 +5,14 @@
  */
 
 /*\
- * Test for feature MNT_EXPIRE of umount2():
+ * Test for feature MNT_EXPIRE of :man2:`umount2`:
  *
  * - EINVAL when flag is specified with either MNT_FORCE or MNT_DETACH
- * - EAGAIN when initial call to umount2(2) with MNT_EXPIRE
- * - EAGAIN when umount2(2) with MNT_EXPIRE after access(2)
- * - succeed when second call to umount2(2) with MNT_EXPIRE
+ * - EAGAIN when initial call to :man2:`umount2` with MNT_EXPIRE
+ * - EAGAIN when :man2:`umount2` with MNT_EXPIRE after :man2:`access`
+ * - succeed when second call to :man2:`umount2` with MNT_EXPIRE
  *
- * Test for feature UMOUNT_NOFOLLOW of umount2():
+ * Test for feature UMOUNT_NOFOLLOW of :man2:`umount2`:
  *
  * - EINVAL when target is a symbolic link
  * - succeed when target is a mount point