syscalls.2: Update syscall table

Added: arc_gettls, arc_settls, arc_usr_cmpxchg, arch_prctl,
atomic_barrier, atomic_cmpxchg_32, bfin_spinlock, breakpoint,
clone2, cmpxchg, cmpxchg_badaddr, dma_memcpy, execv, get_tls,
getdomainname, getdtablesize, gethostname, getxgid, getxpid,
getxuid, metag_get_tls, metag_set_fpu_flags,metag_set_tls,
metag_set_global_bit, newfstatat, old_adjtimex, oldumount,
or1k_atomic, pread, pwrite, riscv_flush_icache,
sched_get_affinity, sched_set_affinity, set_tls, setaltroot,
sethae, setpgrp, spill, sram_alloc, sram_free, swapcontext,
switch_endian, sys_debug_setcontext, syscall, sysmips, timerfd,
usr26, usr32, xtensa.

Uncommented: memory_ordering

Renamed: ppc_rtas to rtas (__NR_rtas), ppc_swapcontext to
swapcontext (__NR_swacontext).

Typo: s/remaed/renamed to/

Other: s/ia64/IA-64/, s/Sparc/SPARC/

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

diff --git a/man2/syscalls.2 b/man2/syscalls.2
index 2badb24025c054efbf0de7d18568a82bba3e4743..e89f85be0815a754063bf01b1063b19580614d5f 100644 (file)
--- a/man2/syscalls.2
+++ b/man2/syscalls.2
@@ -170,14 +170,29 @@ l l l.
 \fBadjtimex\fP(2)      1.0
 \fBalarm\fP(2) 1.0
 \fBalloc_hugepages\fP(2)       2.5.36  Removed in 2.5.44
+.\" 4adeefe161a74369e44cc8e663f240ece0470dc3
+\fBarc_gettls\fP(2)    3.9     ARC only
+\fBarc_settls\fP(2)    3.9     ARC only
+.\" 91e040a79df73d371f70792f30380d4e44805250
+\fBarc_usr_cmpxchg\fP(2)       4.9     ARC onlt
+.\" x86: 79170fda313ed5be2394f87aa2a00d597f8ed4a1
+\fBarch_prctl\fP(2)    2.6     x86_64, x86 since 4.12
+.\" 9674cdc74d63f346870943ef966a034f8c71ee57
+\fBatomic_barrier\fP(2)        2.6.34  m68k only
+\fBatomic_cmpxchg_32\fP(2)     2.6.34  m68k only
 \fBbdflush\fP(2)       1.2     T{
 Deprecated (does nothing)
 .br
 since 2.6
 T}
+\fBbfin_spinlock\fP(2) 2.6.22  Blackfin only (port removed in Linux 4.17)
 \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
+\fB__ARM_NR\fP prefix
+T}
 \fBcacheflush\fP(2)    1.2     Not on x86
 \fBcapget\fP(2)        2.2
 \fBcapset\fP(2)        2.2
@@ -195,13 +210,32 @@ T}
 \fBclock_gettime\fP(2) 2.6
 \fBclock_nanosleep\fP(2)       2.6
 \fBclock_settime\fP(2) 2.6
+\fBclone2\fP(2)        2.4     IA-64 only
 \fBclone\fP(2) 1.0
 \fBclose\fP(2) 1.0
+.\" .\" dcef1f634657dabe7905af3ccda12cf7f0b6fcc1
+.\" .\" cc20d42986d5807cbe4f5c7c8e3dab2e59ea0db3
+.\" .\" db695c0509d6ec9046ee5e4c520a19fa17d9fce2
+.\" \fBcmpxchg\fP(2)   2.6.12  T{
+.\" ARM, syscall constant never was
+.\" .br
+.\" exposed to userspace, in-kernel
+.\" .br
+.\" definition had \fB__ARM_NR\fP prefix,
+.\" .br
+.\" removed in 4.4
+.\" T}
+.\" 867e359b97c970a60626d5d76bbe2a8fadbf38fb
+.\" bb9d812643d8a121df7d614a2b9c60193a92deb0
+\fBcmpxchg_badaddr\fP(2)       2.6.36  Tile only (port removed in Linux 4.17)
 \fBconnect\fP(2)       2.0     See notes on \fBsocketcall\fP(2)
 \fBcopy_file_range\fP(2)       4.5
 \fBcreat\fP(2) 1.0
 \fBcreate_module\fP(2) 1.0     Removed in 2.6
 \fBdelete_module\fP(2) 1.0
+.\" 1394f03221790a988afc3e4b3cb79f2e477246a9
+.\" 4ba66a9760722ccbb691b8f7116cad2f791cca7b
+\fBdma_memcpy\fP(2)    2.6.22  Blackfin only (port removed in Linux 4.17)
 \fBdup\fP(2)   1.0
 \fBdup2\fP(2)  1.0
 \fBdup3\fP(2)  2.6.27
@@ -212,6 +246,11 @@ T}
 \fBepoll_wait\fP(2)    2.6
 \fBeventfd\fP(2)       2.6.22
 \fBeventfd2\fP(2)      2.6.27
+\fBexecv\fP(2) 2.0     T{
+SPARC/SPARC64 only, for compatibility
+.br
+with SunOS
+T}
 \fBexecve\fP(2)        1.0
 \fBexecveat\fP(2)      3.19
 \fBexit\fP(2)  1.0
@@ -256,10 +295,28 @@ T}
 \fBget_mempolicy\fP(2) 2.6.6
 \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
 \fBgetcpu\fP(2)        2.6.19
 \fBgetcwd\fP(2)        2.2
 \fBgetdents\fP(2)      2.0
 \fBgetdents64\fP(2)    2.4
+.\" parisc: 863722e856e64dae0e252b6bb546737c6c5626ce
+\fBgetdomainname\fP(2) 2.2     T{
+SPARC, SPARC64; available
+.br
+as \fBosf_getdomainname\fP(2)
+.br
+on Alpha since Linux 2.0
+T}
+,\" 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
+T}
 \fBgetegid\fP(2)       1.0
 \fBgetegid32\fP(2)     2.4
 \fBgeteuid\fP(2)       1.0
@@ -268,6 +325,8 @@ T}
 \fBgetgid32\fP(2)      2.4
 \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
 \fBgetitimer\fP(2)     1.0
 \fBgetpeername\fP(2)   2.0     See notes on \fBsocketcall\fP(2)
 \fBgetpagesize\fP(2)   2.0     Not on x86
@@ -290,8 +349,29 @@ T}
 \fBgettimeofday\fP(2)  1.0
 \fBgetuid\fP(2)        1.0
 \fBgetuid32\fP(2)      2.4
-\fBgetunwind\fP(2)     2.4.8   ia64; deprecated
+\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}
 \fBinit_module\fP(2)   1.0
 \fBinotify_add_watch\fP(2)     2.6.13
 \fBinotify_init\fP(2)  2.6.13
@@ -311,7 +391,7 @@ T}
 \fBipc\fP(2)   1.0
 .\" Implements System V IPC calls
 \fBkcmp\fP(2)  3.5
-\fBkern_features\fP(2) 3.7     Sparc64
+\fBkern_features\fP(2) 3.7     SPARC64 only
 .\" FIXME . document kern_features():
 .\" commit 517ffce4e1a03aea979fe3a18a3dd1761a24fafb
 \fBkexec_file_load\fP(2)       3.17
@@ -340,7 +420,13 @@ T}
 \fBlstat64\fP(2)       2.4
 \fBmadvise\fP(2)       2.4
 \fBmbind\fP(2) 2.6.6
-.\" \fBmemory_ordering\fP(2)   ???     Sparc64
+\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)
 \fBmembarrier\fP(2)    3.17
 \fBmemfd_create\fP(2)  3.17
 \fBmigrate_pages\fP(2) 2.6.16
@@ -378,16 +464,33 @@ T}
 \fBmunmap\fP(2)        1.0
 \fBname_to_handle_at\fP(2)     2.6.39
 \fBnanosleep\fP(2)     2.0
+.\" 5590ff0d5528b60153c0b4e7b771472b5a95e297
+\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_getrlimit\fP(2) 2.4     T{
+Old variant of \fBgetrlimit\fP(2) syscall
+.br
+that used a different value 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
 \fBolduname\fP(2)      1.0
 \fBopen\fP(2)  1.0
 \fBopen_by_handle_at\fP(2)     2.6.39
 \fBopenat\fP(2)        2.6.16
+.\" 9d02a4283e9ce4e9ca11ff00615bdacdb0515a1a
+\fBor1k_atomic\fP(2)   3.1     OpenRISC 1000 only
 \fBpause\fP(2) 1.0
 \fBpciconfig_iobase\fP(2)      2.2.15; 2.4     Not on x86
 .\" Alpha, PowerPC, ARM; not x86
@@ -401,9 +504,9 @@ Was perf_counter_open() in
 2.6.31; renamed in 2.6.32
 T}
 \fBpersonality\fP(2)   1.2
-\fBperfctr\fP(2)       2.2     Sparc; removed in 2.6.34
+\fBperfctr\fP(2)       2.2     SPARC only; removed in 2.6.34
 .\"    commit c7d5a0050773e98d1094eaa9f2a1a793fafac300 removed perfctr()
-\fBperfmonctl\fP(2)    2.4     ia64
+\fBperfmonctl\fP(2)    2.4     IA-64 only
 \fBpipe\fP(2)  1.0
 \fBpipe2\fP(2) 2.6.27
 \fBpivot_root\fP(2)    2.4
@@ -411,10 +514,15 @@ T}
 \fBpkey_free\fP(2)     4.8
 \fBpkey_mprotect\fP(2) 4.8
 \fBpoll\fP(2)  2.0.36; 2.2
-\fBppc_rtas\fP(2)      2.6.2   PowerPC only
-\fBppc_swapcontext\fP(2)       2.6.3   PowerPC only
 \fBppoll\fP(2) 2.6.16
 \fBprctl\fP(2) 2.2
+\fBpread\fP(2)         T{
+Used for \fBpread64\fP(2) on AVR32
+.br
+(port was removed in Linux 4.12)
+.br
+and Blackfin (port was removed in Linux 4.17)
+T}
 \fBpread64\fP(2)               T{
 Added as "pread" in 2.2;
 .br
@@ -428,6 +536,13 @@ 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) on AVR32
+.br
+(port was removed in Linux 4.12)
+.br
+and Blackfin (port was removed in Linux 4.17)
+T}
 \fBpwrite64\fP(2)              T{
 Added as "pwrite" in 2.2;
 .br
@@ -456,6 +571,8 @@ T}
 \fBrenameat2\fP(2)     3.15
 \fBrequest_key\fP(2)   2.6.10
 \fBrestart_syscall\fP(2)       2.6
+.\" 921ebd8f2c081b3cf6c3b29ef4103eef3ff26054
+\fBriscv_flush_icache\fP(2)    4.15    RISC-V only
 \fBrmdir\fP(2) 1.0
 \fBrseq\fP(2)  4.18
 \fBrt_sigaction\fP(2)  2.2
@@ -466,11 +583,13 @@ T}
 \fBrt_sigsuspend\fP(2) 2.2
 \fBrt_sigtimedwait\fP(2)       2.2
 \fBrt_tgsigqueueinfo\fP(2)     2.6.31
+\fBrtas\fP(2)  2.6.2   PowerPC/PowerPC64 only
 \fBs390_runtime_instr\fP(2)    3.7     s390 only
 \fBs390_pci_mmio_read\fP(2)    3.19    s390 only
 \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_priority_max\fP(2)        2.0
 \fBsched_get_priority_min\fP(2)        2.0
 \fBsched_getaffinity\fP(2)     2.6
@@ -478,6 +597,7 @@ 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_setaffinity\fP(2)     2.6
 \fBsched_setattr\fP(2) 3.14
 \fBsched_setparam\fP(2)        2.0
@@ -499,6 +619,16 @@ 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
+.br
+(creating an alternative root, precursor
+.br
+of mount namespaces) to user space.
+T}
 .\" See http://lkml.org/lkml/2005/8/1/83
 .\" "[PATCH] remove sys_set_zone_reclaim()"
 \fBsetdomainname\fP(2) 1.0
@@ -510,10 +640,19 @@ T}
 \fBsetgid32\fP(2)      2.4
 \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}
 \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
 \fBsetpriority\fP(2)   1.0
 \fBsetregid\fP(2)      1.0
 \fBsetregid32\fP(2)    2.4
@@ -550,9 +689,13 @@ T}
 \fBsocketcall\fP(2)    1.0
 .\" Implements BSD socket calls
 \fBsocketpair\fP(2)    2.0     See notes on \fBsocketcall\fP(2)
+.\" 5a0015d62668e64c8b6e02e360fbbea121bfd5e6
+\fBspill\fP(2) 2.6.13  Xtensa only
 \fBsplice\fP(2)        2.6.17
-\fBspu_create\fP(2)    2.6.16  PowerPC only
-\fBspu_run\fP(2)       2.6.16  PowerPC only
+\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)
 \fBssetmask\fP(2)      1.0
 \fBstat\fP(2)  1.0
 \fBstat64\fP(2)        2.4
@@ -560,7 +703,11 @@ T}
 \fBstatfs64\fP(2)      2.6
 \fBstatx\fP(2) 4.11
 \fBstime\fP(2) 1.0
-\fBsubpage_prot\fP(2)  2.6.25  PowerPC only
+\fBsubpage_prot\fP(2)  2.6.25  PowerPC/PowerPC64 only
+\fBswapcontext\fP(2)   2.6.3   PowerPC/PowerPC64 only
+.\" 529d235a0e190ded1d21ccc80a73e625ebcad09b
+\fBswitch_endian\fP(2) 4.1     PowerPC64 only
+\fBswapcontext\fP(2)   2.6.3   PowerPC only
 \fBswapoff\fP(2)       1.0
 \fBswapon\fP(2)        1.0
 \fBsymlink\fP(2)       1.0
@@ -572,10 +719,13 @@ T}
 .\" First appeared on ARM, as arm_sync_file_range(), but later renamed
 .\" \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
 \fBsysfs\fP(2) 1.2
 \fBsysinfo\fP(2)       1.0
 \fBsyslog\fP(2)        1.0
 .\" glibc interface is \fBklogctl\fP(3)
+\fBsysmips\fP(2)       2.6.0   MIPS only
 \fBtee\fP(2)   2.6.17
 \fBtgkill\fP(2)        2.6
 \fBtime\fP(2)  1.0
@@ -584,6 +734,9 @@ T}
 \fBtimer_getoverrun\fP(2)      2.6
 \fBtimer_gettime\fP(2) 2.6
 \fBtimer_settime\fP(2) 2.6
+.\" b215e283992899650c4271e7385c79e26fb9a88e
+.\" 4d672e7ac79b5ec5cdc90e450823441e20464691
+\fBtimerfd\fP(2)       2.6.22  Old timerfd interface, removed in 2.6.25
 \fBtimerfd_create\fP(2)        2.6.25
 \fBtimerfd_gettime\fP(2)       2.6.25
 \fBtimerfd_settime\fP(2)       2.6.25
@@ -604,10 +757,12 @@ T}
 \fBuselib\fP(2)        1.0
 \fBustat\fP(2) 1.0
 \fBuserfaultfd\fP(2)   4.3
+\fBusr26\fP(2) 2.4.8.1 ARM OABI only
+\fBusr32\fP(2) 2.4.8.1 ARM OABI only
 \fButime\fP(2) 1.0
 \fButimensat\fP(2)     2.6.22
 \fButimes\fP(2)        2.2
-\fButrap_install\fP(2) 2.2     Sparc only
+\fButrap_install\fP(2) 2.2     SPARC64 only
 .\" FIXME . document utrap_install()
 .\" There's a man page for Solaris 5.11
 \fBvfork\fP(2) 2.2
@@ -623,6 +778,8 @@ T}
 \fBwaitpid\fP(2)       1.0
 \fBwrite\fP(2) 1.0
 \fBwritev\fP(2)        2.0
+.\" 5a0015d62668e64c8b6e02e360fbbea121bfd5e6
+\fBxtensa\fP(2)        2.6.13  Xtensa only
 .TE
 .ad
 .PP