From 14dd128c7cb432cb9a3c6bbe5659a9b3715f3b97 Mon Sep 17 00:00:00 2001
From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Sun, 20 Sep 2020 14:17:54 +0200
Subject: [PATCH] syscalls.2: Move system calls from discontinued ports out of
 main syscall list

Various ports that had their own indigenous system calls have
been discontinued. Remove those system calls (none of which had
manual pages!) to a separate part of the page, to avoid
cluttering the main list of system calls.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
---
 man2/syscalls.2 | 130 ++++++++++++++++++++++++------------------------
 1 file changed, 65 insertions(+), 65 deletions(-)

diff --git a/man2/syscalls.2 b/man2/syscalls.2
index e84cf80d6..193cd98e4 100644
--- a/man2/syscalls.2
+++ b/man2/syscalls.2
@@ -186,11 +186,6 @@ Deprecated (does nothing)
 .br
 since 2.6
 T}
-\fBbfin_spinlock\fP(2)	2.6.22	T{
-Blackfin only (port removed
-.br
-in Linux 4.17)
-T}
 \fBbind\fP(2)	2.0	See notes on \fBsocketcall\fP(2)
 \fBbpf\fP(2)	3.18
 \fBbrk\fP(2)	1.0
@@ -235,11 +230,6 @@ T}
 .\" T}
 .\" 867e359b97c970a60626d5d76bbe2a8fadbf38fb
 .\" bb9d812643d8a121df7d614a2b9c60193a92deb0
-\fBcmpxchg_badaddr\fP(2)	2.6.36	T{
-Tile only (port removed
-.br
-in Linux 4.17)
-T}
 \fBconnect\fP(2)	2.0	See notes on \fBsocketcall\fP(2)
 \fBcopy_file_range\fP(2)	4.5
 \fBcreat\fP(2)	1.0
@@ -247,11 +237,6 @@ T}
 \fBdelete_module\fP(2)	1.0
 .\" 1394f03221790a988afc3e4b3cb79f2e477246a9
 .\" 4ba66a9760722ccbb691b8f7116cad2f791cca7b
-\fBdma_memcpy\fP(2)	2.6.22	T{
-Blackfin only (port removed
-.br
-in Linux 4.17)
-T}
 \fBdup\fP(2)	1.0
 \fBdup2\fP(2)	1.0
 \fBdup3\fP(2)	2.6.27
@@ -437,26 +422,6 @@ T}
 \fBmemory_ordering\fP(2)	2.2	SPARC64 only
 .\" 26025bbfbba33a9425be1b89eccb4664ea4c17b6
 .\" bb6fb6dfcc17cddac11ac295861f7608194447a7
-\fBmetag_get_tls\fP(2)	3.9	T{
-Metag only (port removed
-.br
-in Linux 4.17)
-T}
-\fBmetag_set_fpu_flags\fP(2)	3.9	T{
-Metag only (port removed
-.br
-in Linux 4.17)
-T}
-\fBmetag_set_tls\fP(2)	3.9	T{
-Metag only (port removed
-.br
-in Linux 4.17)
-T}
-\fBmetag_setglobalbit\fP(2)	3.9	T{
-Metag only (port removed
-.br
-in Linux 4.17)
-T}
 \fBmembarrier\fP(2)	3.17
 \fBmemfd_create\fP(2)	3.17
 \fBmigrate_pages\fP(2)	2.6.16
@@ -552,15 +517,6 @@ T}
 \fBpoll\fP(2)	2.0.36; 2.2
 \fBppoll\fP(2)	2.6.16
 \fBprctl\fP(2)	2.2
-\fBpread\fP(2)		T{
-Used for \fBpread64\fP(2) on AVR32
-.br
-(port removed in Linux 4.12)
-.br
-and Blackfin (port removed
-.br
-in Linux 4.17)
-T}
 \fBpread64\fP(2)		T{
 Added as "pread" in 2.2;
 .br
@@ -574,17 +530,6 @@ T}
 \fBpselect6\fP(2)	2.6.16
 .\" Implements \fBpselect\fP(2)
 \fBptrace\fP(2)	1.0
-\fBpwrite\fP(2)		T{
-Used for \fBpwrite64\fP(2)
-.br
-on AVR32
-(port removed
-.br
-in Linux 4.12)
-and Blackfin
-.br
-(port removed in Linux 4.17)
-T}
 \fBpwrite64\fP(2)		T{
 Added as "pwrite" in 2.2;
 .br
@@ -744,16 +689,6 @@ T}
 \fBsplice\fP(2)	2.6.17
 \fBspu_create\fP(2)	2.6.16	PowerPC/PowerPC64 only
 \fBspu_run\fP(2)	2.6.16	PowerPC/PowerPC64 only
-\fBsram_alloc\fP(2)	2.6.22	T{
-Blackfin (port removed
-.br
-in Linux 4.17)
-T}
-\fBsram_free\fP(2)	2.6.22	T{
-Blackfin (port removed
-.br
-in Linux 4.17)
-T}
 \fBssetmask\fP(2)	1.0
 \fBstat\fP(2)	1.0
 \fBstat64\fP(2)	2.4
@@ -903,6 +838,71 @@ There was briefly
 .BR set_zone_reclaim (2),
 added in Linux 2.6.13, and removed in 2.6.16;
 this system call was never available to user space.
+.\"
+.SS System calls on removed ports
+Some system calls only ever existed on Linux architectures that have
+since been removed from the kernel:
+.TP
+AVR32 (port removed in Linux 4.12)
+.RS
+.PD 0
+.IP * 2
+.BR pread (2)
+.IP *
+.BR pwrite (2)
+.PD
+.RE
+.TP
+Blackfin (port removed in Linux 4.17)
+.RS
+.PD 0
+.IP * 2
+.BR bfin_spinlock (2)
+(added in Linux 2.6.22)
+.IP *
+.BR dma_memcpy (2)
+(added in Linux 2.6.22)
+.IP *
+.BR pread (2)
+(added in Linux 2.6.22)
+.IP *
+.BR pwrite (2)
+(added in Linux 2.6.22)
+.IP *
+.BR sram_alloc (2)
+(added in Linux 2.6.22)
+.IP *
+.BR sram_free (2)
+(added in Linux 2.6.22)
+.PD
+.RE
+.TP
+Metag (port removed in Linux 4.17)
+.RS
+.PD 0
+.IP * 2
+.BR metag_get_tls (2)
+(add in Linux 3.9)
+.IP *
+.BR metag_set_fpu_flags (2)
+(add in Linux 3.9)
+.IP *
+.BR metag_set_tls (2)
+(add in Linux 3.9)
+.IP *
+.BR metag_setglobalbit (2)
+(add in Linux 3.9)
+.PD
+.RE
+.TP
+Tile (port removed in Linux 4.17)
+.RS
+.PD 0
+.IP * 2
+.BR cmpxchg_badaddr (2)
+(added in Linux 2.6.36)
+.PD
+.RE
 .SH NOTES
 Roughly speaking, the code belonging to the system call
 with number __NR_xxx defined in