syscalls.2: ffix: Improve table formatting

Allow more text wrapping in the Notes column

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2021-01-06 15:28:02 +01:00
parent 0ab815e900
commit 30e3e116bb
1 changed files with 131 additions and 69 deletions

View File

@ -155,6 +155,7 @@ The list of system calls that are available as at kernel 5.11
.\" Looking at scripts/checksyscalls.sh in the kernel source is
.\" instructive about x86 specifics.
.\"
.nh
.ad l
.TS
l2 le l
@ -165,7 +166,9 @@ l l l.
\fB_llseek\fP(2) 1.2
\fB_newselect\fP(2) 2.0
\fB_sysctl\fP(2) 2.0 Removed in 5.5
\fBaccept\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBaccept\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBaccept4\fP(2) 2.6.28
\fBaccess\fP(2) 1.0
\fBacct\fP(2) 1.0
@ -179,21 +182,23 @@ l l l.
.\" 91e040a79df73d371f70792f30380d4e44805250
\fBarc_usr_cmpxchg\fP(2) 4.9 ARC only
.\" x86: 79170fda313ed5be2394f87aa2a00d597f8ed4a1
\fBarch_prctl\fP(2) 2.6 x86_64, x86 since 4.12
\fBarch_prctl\fP(2) 2.6 T{
x86_64, x86 since 4.12
T}
.\" 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}
\fBbind\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBbind\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\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
@ -203,7 +208,6 @@ T}
\fBchmod\fP(2) 1.0
\fBchown\fP(2) 2.2 T{
See \fBchown\fP(2) for
.br
version details
T}
\fBchown32\fP(2) 2.4
@ -223,16 +227,15 @@ T}
.\" .\" db695c0509d6ec9046ee5e4c520a19fa17d9fce2
.\" \fBcmpxchg\fP(2) 2.6.12 T{
.\" ARM, syscall constant never was
.\" .br
.\" exposed to user space, in-kernel
.\" .br
.\" definition had \fB__ARM_NR\fP prefix,
.\" .br
.\" removed in 4.4
.\" T}
.\" 867e359b97c970a60626d5d76bbe2a8fadbf38fb
.\" bb9d812643d8a121df7d614a2b9c60193a92deb0
\fBconnect\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBconnect\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBcopy_file_range\fP(2) 4.5
\fBcreat\fP(2) 1.0
\fBcreate_module\fP(2) 1.0 Removed in 2.6
@ -252,7 +255,6 @@ T}
\fBeventfd2\fP(2) 2.6.27
\fBexecv\fP(2) 2.0 T{
SPARC/SPARC64 only, for
.br
compatibility with SunOS
T}
\fBexecve\fP(2) 1.0
@ -307,7 +309,6 @@ T}
.\" 8fcd6c45f5a65621ec809b7866a3623e9a01d4ed
\fBget_tls\fP(2) 4.15 T{
ARM OABI only, has
.br
\fB__ARM_NR\fP prefix
T}
\fBgetcpu\fP(2) 2.6.19
@ -317,17 +318,13 @@ T}
.\" 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
.br
\fBosf_getdtablesize\fP(2)
T}
\fBgetegid\fP(2) 1.0
@ -341,11 +338,12 @@ T}
.\" SPARC removal: ec98c6b9b47df6df1c1fa6cf3d427414f8c2cf16
\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)
\fBgetpeername\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBgetpagesize\fP(2) 2.0 Not on x86
\fBgetpgid\fP(2) 1.0
\fBgetpgrp\fP(2) 1.0
@ -360,17 +358,29 @@ T}
\fBgetrlimit\fP(2) 1.0
\fBgetrusage\fP(2) 1.0
\fBgetsid\fP(2) 2.0
\fBgetsockname\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBgetsockopt\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBgetsockname\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBgetsockopt\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBgettid\fP(2) 2.4.11
\fBgettimeofday\fP(2) 1.0
\fBgetuid\fP(2) 1.0
\fBgetuid32\fP(2) 2.4
\fBgetunwind\fP(2) 2.4.8 IA-64 only; deprecated
\fBgetunwind\fP(2) 2.4.8 T{
IA-64 only; deprecated
T}
\fBgetxattr\fP(2) 2.6; 2.4.18
\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
\fBgetxgid\fP(2) 2.0 T{
Alpha only; see NOTES
T}
\fBgetxpid\fP(2) 2.0 T{
Alpha only; see NOTES
T}
\fBgetxuid\fP(2) 2.0 T{
Alpha only; see NOTES
T}
\fBinit_module\fP(2) 1.0
\fBinotify_add_watch\fP(2) 2.6.13
\fBinotify_init\fP(2) 2.6.13
@ -404,14 +414,15 @@ T}
\fBkill\fP(2) 1.0
\fBlchown\fP(2) 1.0 T{
See \fBchown\fP(2) for
.br
version details
T}
\fBlchown32\fP(2) 2.4
\fBlgetxattr\fP(2) 2.6; 2.4.18
\fBlink\fP(2) 1.0
\fBlinkat\fP(2) 2.6.16
\fBlisten\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBlisten\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBlistxattr\fP(2) 2.6; 2.4.18
\fBllistxattr\fP(2) 2.6; 2.4.18
\fBlookup_dcookie\fP(2) 2.6
@ -451,10 +462,18 @@ T}
\fBmq_timedsend\fP(2) 2.6.6
\fBmq_unlink\fP(2) 2.6.6
\fBmremap\fP(2) 2.0
\fBmsgctl\fP(2) 2.0 See notes on \fBipc\fP(2)
\fBmsgget\fP(2) 2.0 See notes on \fBipc\fP(2)
\fBmsgrcv\fP(2) 2.0 See notes on \fBipc\fP(2)
\fBmsgsnd\fP(2) 2.0 See notes on \fBipc\fP(2)
\fBmsgctl\fP(2) 2.0 T{
See notes on \fBipc\fP(2)
T}
\fBmsgget\fP(2) 2.0 T{
See notes on \fBipc\fP(2)
T}
\fBmsgrcv\fP(2) 2.0 T{
See notes on \fBipc\fP(2)
T}
\fBmsgsnd\fP(2) 2.0 T{
See notes on \fBipc\fP(2)
T}
\fBmsync\fP(2) 2.0
.\" \fBmultiplexer\fP(2) ?? __NR_multiplexer reserved on
.\" PowerPC, but unimplemented?
@ -467,12 +486,12 @@ 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 Alpha only; see NOTES
\fBold_adjtimex\fP(2) 2.0 T{
Alpha only; see NOTES
T}
\fBold_getrlimit\fP(2) 2.4 T{
Old variant of \fBgetrlimit\fP(2)
.br
that used a different value
.br
for \fBRLIM_INFINITY\fP
T}
\fBoldfstat\fP(2) 1.0
@ -481,7 +500,6 @@ T}
\fBoldstat\fP(2) 1.0
\fBoldumount\fP(2) 2.4.116 T{
Name of the old \fBumount\fP(2)
.br
syscall on Alpha
T}
\fBolduname\fP(2) 1.0
@ -491,7 +509,9 @@ T}
\fBopenat\fP(2) 2.6.16
\fBopenat2\fP(2) 5.6
.\" 9d02a4283e9ce4e9ca11ff00615bdacdb0515a1a
\fBor1k_atomic\fP(2) 3.1 OpenRISC 1000 only
\fBor1k_atomic\fP(2) 3.1 T{
OpenRISC 1000 only
T}
\fBpause\fP(2) 1.0
\fBpciconfig_iobase\fP(2) 2.2.15; 2.4 Not on x86
.\" Alpha, PowerPC, ARM; not x86
@ -501,11 +521,12 @@ T}
.\" , PowerPC, ARM; not x86
\fBperf_event_open\fP(2) 2.6.31 T{
Was perf_counter_open() in
.br
2.6.31; renamed in 2.6.32
T}
\fBpersonality\fP(2) 1.2
\fBperfctr\fP(2) 2.2 SPARC only; removed in 2.6.34
\fBperfctr\fP(2) 2.2 T{
SPARC only; removed in 2.6.34
T}
.\" commit c7d5a0050773e98d1094eaa9f2a1a793fafac300 removed perfctr()
\fBperfmonctl\fP(2) 2.4 IA-64 only
\fBpidfd_getfd\fP(2) 5.6
@ -522,7 +543,6 @@ T}
\fBprctl\fP(2) 2.2
\fBpread64\fP(2) T{
Added as "pread" in 2.2;
.br
renamed "pread64" in 2.6
T}
\fBpreadv\fP(2) 2.6.30
@ -536,7 +556,6 @@ T}
\fBptrace\fP(2) 1.0
\fBpwrite64\fP(2) T{
Added as "pwrite" in 2.2;
.br
renamed "pwrite64" in 2.6
T}
\fBpwritev\fP(2) 2.6.30
@ -551,11 +570,19 @@ T}
\fBreadlinkat\fP(2) 2.6.16
\fBreadv\fP(2) 2.0
\fBreboot\fP(2) 1.0
\fBrecv\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBrecvfrom\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBrecvmsg\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBrecv\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBrecvfrom\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBrecvmsg\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBrecvmmsg\fP(2) 2.6.33
\fBremap_file_pages\fP(2) 2.6 Deprecated since 3.16
\fBremap_file_pages\fP(2) 2.6 T{
Deprecated since 3.16
T}
\fBremovexattr\fP(2) 2.6; 2.4.18
\fBrename\fP(2) 1.0
\fBrenameat\fP(2) 2.6.16
@ -574,7 +601,9 @@ 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
\fBrtas\fP(2) 2.6.2 T{
PowerPC/PowerPC64 only
T}
\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
@ -582,7 +611,6 @@ T}
\fBs390_guarded_storage\fP(2) 4.12 s390 only
\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
@ -594,7 +622,6 @@ T}
\fBsched_rr_get_interval\fP(2) 2.0
\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
@ -604,23 +631,34 @@ T}
\fBsched_yield\fP(2) 2.0
\fBseccomp\fP(2) 3.17
\fBselect\fP(2) 1.0
\fBsemctl\fP(2) 2.0 See notes on \fBipc\fP(2)
\fBsemget\fP(2) 2.0 See notes on \fBipc\fP(2)
\fBsemop\fP(2) 2.0 See notes on \fBipc\fP(2)
\fBsemctl\fP(2) 2.0 T{
See notes on \fBipc\fP(2)
T}
\fBsemget\fP(2) 2.0 T{
See notes on \fBipc\fP(2)
T}
\fBsemop\fP(2) 2.0 T{
See notes on \fBipc\fP(2)
T}
\fBsemtimedop\fP(2) 2.6; 2.4.22
\fBsend\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBsend\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBsendfile\fP(2) 2.2
\fBsendfile64\fP(2) 2.6; 2.4.19
\fBsendmmsg\fP(2) 3.0
\fBsendmsg\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBsendto\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBsendmsg\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBsendto\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBset_mempolicy\fP(2) 2.6.6
\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 T{
ARM OABI/EABI only (constant
.br
has \fB__ARM_NR\fP prefix)
T}
.\" \fBsetaltroot\fP(2) 2.6.10 T{
@ -642,14 +680,15 @@ T}
\fBsetgroups\fP(2) 1.0
\fBsetgroups32\fP(2) 2.4
.\" arch/alpha/include/asm/core_lca.h
\fBsethae\fP(2) 2.0 Alpha only; see NOTES
\fBsethae\fP(2) 2.0 T{
Alpha only; see NOTES
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 T{
Alternative name for
.br
\fBsetpgid\fP(2) on Alpha
T}
\fBsetpriority\fP(2) 1.0
@ -663,18 +702,30 @@ T}
\fBsetreuid32\fP(2) 2.4
\fBsetrlimit\fP(2) 1.0
\fBsetsid\fP(2) 1.0
\fBsetsockopt\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBsetsockopt\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBsettimeofday\fP(2) 1.0
\fBsetuid\fP(2) 1.0
\fBsetuid32\fP(2) 2.4
\fBsetup\fP(2) 1.0 Removed in 2.2
\fBsetxattr\fP(2) 2.6; 2.4.18
\fBsgetmask\fP(2) 1.0
\fBshmat\fP(2) 2.0 See notes on \fBipc\fP(2)
\fBshmctl\fP(2) 2.0 See notes on \fBipc\fP(2)
\fBshmdt\fP(2) 2.0 See notes on \fBipc\fP(2)
\fBshmget\fP(2) 2.0 See notes on \fBipc\fP(2)
\fBshutdown\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBshmat\fP(2) 2.0 T{
See notes on \fBipc\fP(2)
T}
\fBshmctl\fP(2) 2.0 T{
See notes on \fBipc\fP(2)
T}
\fBshmdt\fP(2) 2.0 T{
See notes on \fBipc\fP(2)
T}
\fBshmget\fP(2) 2.0 T{
See notes on \fBipc\fP(2)
T}
\fBshutdown\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBsigaction\fP(2) 1.0
\fBsigaltstack\fP(2) 2.2
\fBsignal\fP(2) 1.0
@ -684,15 +735,23 @@ T}
\fBsigprocmask\fP(2) 1.0
\fBsigreturn\fP(2) 1.0
\fBsigsuspend\fP(2) 1.0
\fBsocket\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBsocket\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
\fBsocketcall\fP(2) 1.0
.\" Implements BSD socket calls
\fBsocketpair\fP(2) 2.0 See notes on \fBsocketcall\fP(2)
\fBsocketpair\fP(2) 2.0 T{
See notes on \fBsocketcall\fP(2)
T}
.\" 5a0015d62668e64c8b6e02e360fbbea121bfd5e6
\fBspill\fP(2) 2.6.13 Xtensa only
\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
\fBspu_create\fP(2) 2.6.16 T{
PowerPC/PowerPC64 only
T}
\fBspu_run\fP(2) 2.6.16 T{
PowerPC/PowerPC64 only
T}
\fBssetmask\fP(2) 1.0
\fBstat\fP(2) 1.0
\fBstat64\fP(2) 2.4
@ -700,8 +759,12 @@ T}
\fBstatfs64\fP(2) 2.6
\fBstatx\fP(2) 4.11
\fBstime\fP(2) 1.0
\fBsubpage_prot\fP(2) 2.6.25 PowerPC/PowerPC64 only
\fBswapcontext\fP(2) 2.6.3 PowerPC/PowerPC64 only
\fBsubpage_prot\fP(2) 2.6.25 T{
PowerPC/PowerPC64 only
T}
\fBswapcontext\fP(2) 2.6.3 T{
PowerPC/PowerPC64 only
T}
.\" 529d235a0e190ded1d21ccc80a73e625ebcad09b
\fBswitch_endian\fP(2) 4.1 PowerPC64 only
\fBswapoff\fP(2) 1.0
@ -718,7 +781,6 @@ T}
\fBsys_debug_setcontext\fP(2) 2.6.11 PowerPC only
\fBsyscall\fP(2) 1.0 T{
Still available on ARM OABI
.br
and MIPS O32 ABI
T}
\fBsysfs\fP(2) 1.2
@ -772,7 +834,6 @@ T}
\fBvhangup\fP(2) 1.0
\fBvm86old\fP(2) 1.0 T{
Was "vm86"; renamed in
.br
2.0.28/2.2
T}
\fBvm86\fP(2) 2.0.28; 2.2
@ -786,6 +847,7 @@ T}
\fBxtensa\fP(2) 2.6.13 Xtensa only
.TE
.ad
.hy
.PP
On many platforms, including x86-32, socket calls are all multiplexed
(via glibc wrapper functions) through