syscalls.2: Various edits of Eugene Syromyatnikov's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/syscalls.2 b/man2/syscalls.2
index e89f85be0815a754063bf01b1063b19580614d5f..5a18267d5723f59b995599e4a9154750dcac5c15 100644 (file)
--- a/man2/syscalls.2
+++ b/man2/syscalls.2
@@ -185,12 +185,17 @@ Deprecated (does nothing)
 .br
 since 2.6
 T}
-\fBbfin_spinlock\fP(2) 2.6.22  Blackfin only (port removed in Linux 4.17)
+\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
 \fBbreakpoint\fP(2)    2.2     T{
 ARM OABI only, defined with
+.br
 \fB__ARM_NR\fP prefix
 T}
 \fBcacheflush\fP(2)    1.2     Not on x86
@@ -227,7 +232,11 @@ T}
 .\" T}
 .\" 867e359b97c970a60626d5d76bbe2a8fadbf38fb
 .\" bb9d812643d8a121df7d614a2b9c60193a92deb0
-\fBcmpxchg_badaddr\fP(2)       2.6.36  Tile only (port removed in Linux 4.17)
+\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
@@ -235,7 +244,11 @@ T}
 \fBdelete_module\fP(2) 1.0
 .\" 1394f03221790a988afc3e4b3cb79f2e477246a9
 .\" 4ba66a9760722ccbb691b8f7116cad2f791cca7b
-\fBdma_memcpy\fP(2)    2.6.22  Blackfin only (port removed in Linux 4.17)
+\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
@@ -247,9 +260,9 @@ T}
 \fBeventfd\fP(2)       2.6.22
 \fBeventfd2\fP(2)      2.6.27
 \fBexecv\fP(2) 2.0     T{
-SPARC/SPARC64 only, for compatibility
+SPARC/SPARC64 only, for
 .br
-with SunOS
+compatability with SunOS
 T}
 \fBexecve\fP(2)        1.0
 \fBexecveat\fP(2)      3.19
@@ -296,7 +309,11 @@ T}
 \fBget_robust_list\fP(2)       2.6.17
 \fBget_thread_area\fP(2)       2.6
 .\" 8fcd6c45f5a65621ec809b7866a3623e9a01d4ed
-\fBget_tls\fP(2)       4.15    ARM OABI only, has \fB__ARM_NR\fP prefix
+\fBget_tls\fP(2)       4.15    T{
+ARM OABI only, has
+.br
+\fB__ARM_NR\fP prefix
+T}
 \fBgetcpu\fP(2)        2.6.19
 \fBgetcwd\fP(2)        2.2
 \fBgetdents\fP(2)      2.0
@@ -309,13 +326,12 @@ as \fBosf_getdomainname\fP(2)
 .br
 on Alpha since Linux 2.0
 T}
-,\" ec98c6b9b47df6df1c1fa6cf3d427414f8c2cf16
+.\" ec98c6b9b47df6df1c1fa6cf3d427414f8c2cf16
 \fBgetdtablesize\fP(2) 2.0     T{
 SPARC (removed in 2.6.26),
 .br
-available on Alpha as \fBosf_getdtablesize\fP(2)
-.br
-since Linux 2.0
+available since Linux 2.0 on Alpha as
+\fBosf_getdtablesize\fP(2)
 T}
 \fBgetegid\fP(2)       1.0
 \fBgetegid32\fP(2)     2.4
@@ -326,7 +342,11 @@ T}
 \fBgetgroups\fP(2)     1.0
 \fBgetgroups32\fP(2)   2.4
 .\" SPARC removal: ec98c6b9b47df6df1c1fa6cf3d427414f8c2cf16
-\fBgethostname\fP(2)   2.0     Alpha, was available on SPARC up to Linux 2.6.26
+\fBgethostname\fP(2)   2.0     T{
+Alpha, was available on
+.br
+SPARC up to Linux 2.6.26
+T}
 \fBgetitimer\fP(2)     1.0
 \fBgetpeername\fP(2)   2.0     See notes on \fBsocketcall\fP(2)
 \fBgetpagesize\fP(2)   2.0     Not on x86
@@ -351,27 +371,9 @@ T}
 \fBgetuid32\fP(2)      2.4
 \fBgetunwind\fP(2)     2.4.8   IA-64 only; deprecated
 \fBgetxattr\fP(2)      2.6; 2.4.18
-\fBgetxgid\fP(2)       2.0     T{
-Alpha only, returns a pair of GID and effective GID
-.br
-via registers \fBr0\fP and \fBr20\fP, provided instead
-.br
-of \fBgetgid\fP(2) and \fBgetegid\fP(2) syscalls
-T}
-\fBgetxpid\fP(2)       2.0     T{
-Alpha onlt, returns a pair of PID and parent PID
-.br
-via registers \fBr0\fP and \fBr20\fP, provided instead
-.br
-of \fBgetpid\fP(2) and \fBgetppid\fP(2) syscalls
-T}
-\fBgetxuid\fP(2)       2.0     T{
-Alpha only, returns a pair of GID and effective GID
-.br
-via registers \fBr0\fP and \fBr20\fP, provided instead
-.br
-of \fBgetuid\fP(2) and \fBgeteuid\fP(2) syscalls
-T}
+\fBgetxgid\fP(2)       2.0     Alpha only; see NOTES
+\fBgetxpid\fP(2)       2.0     Alpha only; see NOTES
+\fBgetxuid\fP(2)       2.0     Alpha only; see NOTES
 \fBinit_module\fP(2)   1.0
 \fBinotify_add_watch\fP(2)     2.6.13
 \fBinotify_init\fP(2)  2.6.13
@@ -423,10 +425,26 @@ T}
 \fBmemory_ordering\fP(2)       2.2     SPARC64 only
 .\" 26025bbfbba33a9425be1b89eccb4664ea4c17b6
 .\" bb6fb6dfcc17cddac11ac295861f7608194447a7
-\fBmetag_get_tls\fP(2) 3.9     Metag only (port removed in Linux 4.17)
-\fBmetag_set_fpu_flags\fP(2)   3.9     Metag only (port removed in Linux 4.17)
-\fBmetag_set_tls\fP(2) 3.9     Metag only (port removed in Linux 4.17)
-\fBmetag_setglobalbit\fP(2)    3.9     Metag only (port removed in Linux 4.17)
+\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
@@ -468,23 +486,23 @@ T}
 \fBnewfstatat\fP(2)    2.6.16  See \fBstat\fP(2)
 \fBnfsservctl\fP(2)    2.2     Removed in 3.1
 \fBnice\fP(2)  1.0
-\fBold_adjtimex\fP(2)  2.0     T{
-Alpha only, variant of \fBadjtimex\fP(2)
-.br
-that uses \fBstruct timeval32\fP,
-.br
-for compatibility with OSF/1
-T}
+\fBold_adjtimex\fP(2)  2.0     ALPA only; see NOTES
 \fBold_getrlimit\fP(2) 2.4     T{
-Old variant of \fBgetrlimit\fP(2) syscall
+Old variant of \fBgetrlimit\fP(2)
+.br
+that used a different value
 .br
-that used a different value for \fBRLIM_INFINITY\fP
+for \fBRLIM_INFINITY\fP
 T}
 \fBoldfstat\fP(2)      1.0
 \fBoldlstat\fP(2)      1.0
 \fBoldolduname\fP(2)   1.0
 \fBoldstat\fP(2)       1.0
-\fBoldumount\fP(2)     2.4.116 Name of the old \fBumount\fP(2) syscall on Alpha
+\fBoldumount\fP(2)     2.4.116 T{
+Name of the old \fBumount\fP(2)
+.br
+syscall on Alpha
+T}
 \fBolduname\fP(2)      1.0
 \fBopen\fP(2)  1.0
 \fBopen_by_handle_at\fP(2)     2.6.39
@@ -519,9 +537,11 @@ T}
 \fBpread\fP(2)         T{
 Used for \fBpread64\fP(2) on AVR32
 .br
-(port was removed in Linux 4.12)
+(port removed in Linux 4.12)
+.br
+and Blackfin (port removed
 .br
-and Blackfin (port was removed in Linux 4.17)
+in Linux 4.17)
 T}
 \fBpread64\fP(2)               T{
 Added as "pread" in 2.2;
@@ -538,10 +558,9 @@ T}
 \fBptrace\fP(2)        1.0
 \fBpwrite\fP(2)                T{
 Used for \fBpwrite64\fP(2) on AVR32
-.br
-(port was removed in Linux 4.12)
-.br
-and Blackfin (port was removed in Linux 4.17)
+(port removed in Linux 4.12)
+and Blackfin (port removed
+in Linux 4.17)
 T}
 \fBpwrite64\fP(2)              T{
 Added as "pwrite" in 2.2;
@@ -589,7 +608,11 @@ T}
 \fBs390_pci_mmio_write\fP(2)   3.19    s390 only
 \fBs390_sthyi\fP(2)    4.15    s390 only
 \fBs390_guarded_storage\fP(2)  4.12    s390 only
-\fBsched_get_affinity\fP(2)    2.6     Name of \fBsched_getaffinity\fP(2) on SPARC and SPARC64
+\fBsched_get_affinity\fP(2)    2.6     T{
+Name of \fBsched_getaffinity\fP(2)
+.br
+on SPARC and SPARC64
+T}
 \fBsched_get_priority_max\fP(2)        2.0
 \fBsched_get_priority_min\fP(2)        2.0
 \fBsched_getaffinity\fP(2)     2.6
@@ -597,7 +620,11 @@ T}
 \fBsched_getparam\fP(2)        2.0
 \fBsched_getscheduler\fP(2)    2.0
 \fBsched_rr_get_interval\fP(2) 2.0
-\fBsched_set_affinity\fP(2)    2.6     Name of \fBsched_setaffinity\fP(2) 0n SPARC and SPARC64
+\fBsched_set_affinity\fP(2)    2.6     T{
+Name of \fBsched_setaffinity\fP(2)
+.br
+on SPARC and SPARC64
+T}
 \fBsched_setaffinity\fP(2)     2.6
 \fBsched_setattr\fP(2) 3.14
 \fBsched_setparam\fP(2)        2.0
@@ -619,15 +646,17 @@ T}
 \fBset_robust_list\fP(2)       2.6.17
 \fBset_thread_area\fP(2)       2.6
 \fBset_tid_address\fP(2)       2.6
-\fBset_tls\fP(2)       2.6.11  ARM OABI/EABI only (constant has \fB__ARM_NR\fP prefix)
-\fBsetaltroot\fP(2)    2.6.10  T{
-Removed in 2.6.11, exposed one of implementation
-.br
-details of the \fBpersonality\fP(2) syscall
+\fBset_tls\fP(2)       2.6.11  T{
+ARM OABI/EABI only (constant
 .br
-(creating an alternative root, precursor
-.br
-of mount namespaces) to user space.
+has \fB__ARM_NR\fP prefix)
+T}
+\fBsetaltroot\fP(2)    2.6.10  T{
+Removed in 2.6.11, exposed one
+of implementation details of
+\fBpersonality\fP(2) (creating an
+alternative root, precursor of
+mount namespaces) to user space.
 T}
 .\" See http://lkml.org/lkml/2005/8/1/83
 .\" "[PATCH] remove sys_set_zone_reclaim()"
@@ -641,18 +670,16 @@ T}
 \fBsetgroups\fP(2)     1.0
 \fBsetgroups32\fP(2)   2.4
 .\" arch/alpha/include/asm/core_lca.h
-\fBsethae\fP(2)        2.0     T{
-Alpha only, used for configuring Host Address
-.br
-Extension register on low-cost Alphas in order
-.br
-to access address space beyond first 27 bits
-T}
+\fBsethae\fP(2)        2.0     Alph only; see NOTES
 \fBsethostname\fP(2)   1.0
 \fBsetitimer\fP(2)     1.0
 \fBsetns\fP(2) 3.0
 \fBsetpgid\fP(2)       1.0
-\fBsetpgrp\fP(2)       2.0     Alternative name for \fBsetpgid\fP(2) on Alpha
+\fBsetpgrp\fP(2)       2.0     T{
+Alternative name for
+.br
+\fBsetpgid\fP(2) on Alpha
+T}
 \fBsetpriority\fP(2)   1.0
 \fBsetregid\fP(2)      1.0
 \fBsetregid32\fP(2)    2.4
@@ -694,8 +721,16 @@ 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  Blackfin (port removed in Linux 4.17)
-\fBsram_free\fP(2)     2.6.22  Blackfin (port removed in Linux 4.17)
+\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
@@ -720,7 +755,11 @@ T}
 .\" \fBsys_debug_setcontext\fP(2)      ???     PowerPC if CONFIG_PPC32
 \fBsyncfs\fP(2)        2.6.39
 \fBsys_debug_setcontext\fP(2)  2.6.11  PowerPC only
-\fBsyscall\fP(2)       1.0     Still available on ARM OABI and MIPS O32 ABI
+\fBsyscall\fP(2)       1.0     T{
+Still available on ARM OABI
+.br
+and MIPS O32 ABI
+T}
 \fBsysfs\fP(2) 1.2
 \fBsysinfo\fP(2)       1.0
 \fBsyslog\fP(2)        1.0
@@ -736,7 +775,10 @@ T}
 \fBtimer_settime\fP(2) 2.6
 .\" b215e283992899650c4271e7385c79e26fb9a88e
 .\" 4d672e7ac79b5ec5cdc90e450823441e20464691
-\fBtimerfd\fP(2)       2.6.22  Old timerfd interface, removed in 2.6.25
+\fBtimerfd\fP(2)       2.6.22  T{
+Old timerfd interface,
+removed in 2.6.25
+T}
 \fBtimerfd_create\fP(2)        2.6.25
 \fBtimerfd_gettime\fP(2)       2.6.25
 \fBtimerfd_settime\fP(2)       2.6.25
@@ -1019,6 +1061,33 @@ s390x is the only 64-bit architecture that has
 .\" .BR chown (2),
 .\" and the semantics of the latter call were changed to what
 .\" they are today.
+.\"
+.\"
+.SS "Architecture-specific details: Alpha"
+.IP * 3
+.BR getxgid (2)
+returns a pair of GID and effective GID via registers
+\fBr0\fP and \fBr20\fP; it is provided
+instead of
+\fBgetgid\fP(2) and \fBgetegid\fP(2).
+.IP *
+.BR getxpid (2)
+returns a pair of PID and parent PID via registers
+\fBr0\fP and \fBr20\fP; it is provided instead of
+\fBgetpid\fP(2) and \fBgetppid\fP(2).
+.IP *
+.BR old_adjtimex (2)
+is a variant of \fBadjtimex\fP(2) that uses \fIstruct timeval32\fP,
+for compatibility with OSF/1.
+.IP *
+.BR getxuid (2)
+returns a pair of GID and effective GID via registers
+\fBr0\fP and \fBr20\fP; it is provided instead of
+\fBgetuid\fP(2) and \fBgeteuid\fP(2).
+.IP *
+.BR sethae (2)
+is used for configuring the Host Address Extension register on
+low-cost Alphas in order to access address space beyond first 27 bits.
 .SH SEE ALSO
 .BR intro (2),
 .BR syscall (2),