man/man5/proc*.5: Add references to other proc*.5 pages

Fixes: 0569afbbccd6 (2023-08-17; "proc*.5: Make sashimi")
Reported-by: "Michael T. Kerrisk" <mtk.manpages@gmail.com>
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

diff --git a/man/man5/proc.5 b/man/man5/proc.5
index e525439e61eac3124942d6bfc06999bc36449c1d..d29436d87935e122d7f89980f11225fea069cbd6 100644 (file)
--- a/man/man5/proc.5
+++ b/man/man5/proc.5
@@ -115,6 +115,9 @@ Underneath
 there are the following general groups of files and subdirectories:
 .TP
 .IR /proc/ "pid subdirectories"
+See
+.BR proc_pid (5).
+.IP
 Each one of these subdirectories contains files and subdirectories
 exposing information about the process with the corresponding process ID.
 .IP
@@ -141,6 +144,9 @@ to view the contents of
 .IR /proc ).
 .TP
 .IR /proc/ "tid subdirectories"
+See
+.BR proc_tid (5).
+.IP
 Each one of these subdirectories contains files and subdirectories
 exposing information about the thread with the corresponding thread ID.
 The contents of these directories are the same as the corresponding
@@ -163,21 +169,140 @@ to view the contents of
 .IR /proc ).
 .TP
 .I /proc/self
+See
+.BR proc_self (5).
+.IP
 When a process accesses this magic symbolic link,
 it resolves to the process's own
 .IR /proc/ pid
 directory.
 .TP
 .I /proc/thread\-self
+See
+.BR proc_thread-self (5).
+.IP
 When a thread accesses this magic symbolic link,
 it resolves to the process's own
 .IR /proc/self/task/ tid
 directory.
 .TP
 .I /proc/[a\-z]*
+.IP
 Various other files and subdirectories under
 .I /proc
 expose system-wide information.
+.IP
+See also:
+.RS
+.TP
+.BR proc_apm (5)
+.TQ
+.BR proc_buddyinfo (5)
+.TQ
+.BR proc_bus (5)
+.TQ
+.BR proc_cgroups (5)
+.TQ
+.BR proc_cmdline (5)
+.TQ
+.BR proc_config.gz (5)
+.TQ
+.BR proc_cpuinfo (5)
+.TQ
+.BR proc_crypto (5)
+.TQ
+.BR proc_devices (5)
+.TQ
+.BR proc_diskstats (5)
+.TQ
+.BR proc_dma (5)
+.TQ
+.BR proc_driver (5)
+.TQ
+.BR proc_execdomains (5)
+.TQ
+.BR proc_fb (5)
+.TQ
+.BR proc_filesystems (5)
+.TQ
+.BR proc_fs (5)
+.TQ
+.BR proc_ide (5)
+.TQ
+.BR proc_interrupts (5)
+.TQ
+.BR proc_iomem (5)
+.TQ
+.BR proc_ioports (5)
+.TQ
+.BR proc_kallsyms (5)
+.TQ
+.BR proc_kcore (5)
+.TQ
+.BR proc_key-users (5)
+.TQ
+.BR proc_keys (5)
+.TQ
+.BR proc_kmsg (5)
+.TQ
+.BR proc_kpagecgroup (5)
+.TQ
+.BR proc_kpagecount (5)
+.TQ
+.BR proc_kpageflags (5)
+.TQ
+.BR proc_ksyms (5)
+.TQ
+.BR proc_loadavg (5)
+.TQ
+.BR proc_locks (5)
+.TQ
+.BR proc_malloc (5)
+.TQ
+.BR proc_meminfo (5)
+.TQ
+.BR proc_modules (5)
+.TQ
+.BR proc_mounts (5)
+.TQ
+.BR proc_mtrr (5)
+.TQ
+.BR proc_net (5)
+.TQ
+.BR proc_partitions (5)
+.TQ
+.BR proc_pci (5)
+.TQ
+.BR proc_profile (5)
+.TQ
+.BR proc_scsi (5)
+.TQ
+.BR proc_slabinfo (5)
+.TQ
+.BR proc_stat (5)
+.TQ
+.BR proc_swaps (5)
+.TQ
+.BR proc_sys (5)
+.TQ
+.BR proc_sysrq-trigger (5)
+.TQ
+.BR proc_sysvipc (5)
+.TQ
+.BR proc_timer_list (5)
+.TQ
+.BR proc_timer_stats (5)
+.TQ
+.BR proc_tty (5)
+.TQ
+.BR proc_uptime (5)
+.TQ
+.BR proc_version (5)
+.TQ
+.BR proc_vmstat (5)
+.TQ
+.BR proc_zoneinfo (5)
+.RE
 .P
 All of the above are described in more detail in separate manpages
 whose names start with

diff --git a/man/man5/proc_pid.5 b/man/man5/proc_pid.5
index 9f60a3a1369c0a2a82023c0995d77671a746a912..fe9dd29860307e1b9e5e31588b0f247e6da59f4c 100644 (file)
--- a/man/man5/proc_pid.5
+++ b/man/man5/proc_pid.5
@@ -59,6 +59,102 @@ then the "dumpable" attribute may be reset, as described in
 Therefore, it may be desirable to reset the "dumpable" attribute
 .I after
 making any desired changes to the process's effective UID or GID.
+.IP
+See also:
+.RS
+.TP
+.BR proc_pid_attr (5)
+.TQ
+.BR proc_pid_autogroup (5)
+.TQ
+.BR proc_pid_auxv (5)
+.TQ
+.BR proc_pid_cgroup (5)
+.TQ
+.BR proc_pid_clear_refs (5)
+.TQ
+.BR proc_pid_cmdline (5)
+.TQ
+.BR proc_pid_comm (5)
+.TQ
+.BR proc_pid_coredump_filter (5)
+.TQ
+.BR proc_pid_cpuset (5)
+.TQ
+.BR proc_pid_cwd (5)
+.TQ
+.BR proc_pid_environ (5)
+.TQ
+.BR proc_pid_exe (5)
+.TQ
+.BR proc_pid_fd (5)
+.TQ
+.BR proc_pid_fdinfo (5)
+.TQ
+.BR proc_pid_gid_map (5)
+.TQ
+.BR proc_pid_io (5)
+.TQ
+.BR proc_pid_limits (5)
+.TQ
+.BR proc_pid_map_files (5)
+.TQ
+.BR proc_pid_maps (5)
+.TQ
+.BR proc_pid_mem (5)
+.TQ
+.BR proc_pid_mountinfo (5)
+.TQ
+.BR proc_pid_mounts (5)
+.TQ
+.BR proc_pid_mountstats (5)
+.TQ
+.BR proc_pid_net (5)
+.TQ
+.BR proc_pid_ns (5)
+.TQ
+.BR proc_pid_numa_maps (5)
+.TQ
+.BR proc_pid_oom_adj (5)
+.TQ
+.BR proc_pid_oom_score (5)
+.TQ
+.BR proc_pid_oom_score_adj (5)
+.TQ
+.BR proc_pid_pagemap (5)
+.TQ
+.BR proc_pid_personality (5)
+.TQ
+.BR proc_pid_projid_map (5)
+.TQ
+.BR proc_pid_root (5)
+.TQ
+.BR proc_pid_seccomp (5)
+.TQ
+.BR proc_pid_setgroups (5)
+.TQ
+.BR proc_pid_smaps (5)
+.TQ
+.BR proc_pid_stack (5)
+.TQ
+.BR proc_pid_stat (5)
+.TQ
+.BR proc_pid_statm (5)
+.TQ
+.BR proc_pid_status (5)
+.TQ
+.BR proc_pid_syscall (5)
+.TQ
+.BR proc_pid_task (5)
+.TQ
+.BR proc_pid_timers (5)
+.TQ
+.BR proc_pid_timerslack_ns (5)
+.TQ
+.BR proc_pid_uid_map (5)
+.TQ
+.BR proc_pid_wchan (5)
+.RE
 .TP
 .I /proc/self/
 This directory refers to the process accessing the

diff --git a/man/man5/proc_pid_task.5 b/man/man5/proc_pid_task.5
index ee477e5a233a243fb4f385505ef3ff3078e34867..e77e42d43b8e3794e0091fd5f4dbfbd74a19cc3c 100644 (file)
--- a/man/man5/proc_pid_task.5
+++ b/man/man5/proc_pid_task.5
@@ -50,6 +50,12 @@ In a multithreaded process, the contents of the
 directory are not available if the main thread has already terminated
 (typically by calling
 .BR pthread_exit (3)).
+.IP
+See also:
+.RS
+.TP
+.BR proc_tid_children (5).
+.RE
 .TP
 .IR /proc/ tid /
 There is a numerical subdirectory for each running thread

diff --git a/man/man5/proc_sys.5 b/man/man5/proc_sys.5
index a820e3f056a581bafb2c27bb67fbd517b21b2b56..af24ca9875e241dfab3a2f92a8fdfd3358c28b42 100644 (file)
--- a/man/man5/proc_sys.5
+++ b/man/man5/proc_sys.5
@@ -26,5 +26,31 @@ by any of the following whitespace characters:
 \[aq]\ \[aq], \[aq]\[rs]t\[aq], or \[aq]\[rs]n\[aq].
 Using other separators leads to the error
 .BR EINVAL .
+.IP
+See also:
+.RS
+.TP
+.BR proc_sys_abi (5)
+.TQ
+.BR proc_sys_debug (5)
+.TQ
+.BR proc_sys_dev (5)
+.TQ
+.BR proc_sys_fs (5)
+.TQ
+.BR proc_sys_kernel (5)
+.TQ
+.BR proc_sys_net (5)
+.TQ
+.BR proc_sys_net_ipv4 (5)
+.TQ
+.BR proc_sys_proc (5)
+.TQ
+.BR proc_sys_sunrpc (5)
+.TQ
+.BR proc_sys_user (5)
+.TQ
+.BR proc_sys_vm (5)
+.RE
 .SH SEE ALSO
 .BR proc (5)