Debian Codegraph @

upstream/debian-trixie/man2/syscalls.2

raw
1 '\" t
2 .\" Copyright (C) 2007 Michael Kerrisk <[email protected]>
3 .\" with some input from Stepan Kasal <[email protected]>
4 .\"
5 .\" Some content retained from an earlier version of this page:
6 .\" Copyright (C) 1998 Andries Brouwer ([email protected])
7 .\" Modifications for 2.2 and 2.4 Copyright (C) 2002 Ian Redfern
8 .\" <[email protected]>
9 .\"
10 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
11 .\"
12 .TH syscalls 2 2024-05-02 "Linux man-pages 6.9.1"
13 .SH NAME
14 syscalls \- Linux system calls
15 .SH SYNOPSIS
16 .nf
17 Linux system calls.
18 .fi
19 .SH DESCRIPTION
20 The system call is the fundamental interface between an application
21 and the Linux kernel.
22 .SS System calls and library wrapper functions
23 System calls are generally not invoked directly,
24 but rather via wrapper functions in glibc (or perhaps some other library).
25 For details of direct invocation of a system call, see
26 .BR intro (2).
27 Often, but not always, the name of the wrapper function is the same
28 as the name of the system call that it invokes.
29 For example, glibc contains a function
30 .BR chdir ()
31 which invokes the underlying "chdir" system call.
32 .P
33 Often the glibc wrapper function is quite thin, doing little work
34 other than copying arguments to the right registers
35 before invoking the system call,
36 and then setting
37 .I errno
38 appropriately after the system call has returned.
39 (These are the same steps that are performed by
40 .BR syscall (2),
41 which can be used to invoke system calls
42 for which no wrapper function is provided.)
43 Note: system calls indicate a failure by returning a negative error
44 number to the caller on architectures without a separate error register/flag,
45 as noted in
46 .BR syscall (2);
47 when this happens,
48 the wrapper function negates the returned error number
49 (to make it positive), copies it to
50 .IR errno ,
51 and returns \-1 to the caller of the wrapper.
52 .P
53 Sometimes, however, the wrapper function does some extra work
54 before invoking the system call.
55 For example, nowadays there are (for reasons described below) two
56 related system calls,
57 .BR truncate (2)
58 and
59 .BR truncate64 (2),
60 and the glibc
61 .BR truncate ()
62 wrapper function checks which of those system calls
63 are provided by the kernel and determines which should be employed.
64 .SS System call list
65 Below is a list of the Linux system calls.
66 In the list, the
67 .I Kernel
68 column indicates the kernel version
69 for those system calls that were new in Linux 2.2,
70 or have appeared since that kernel version.
71 Note the following points:
72 .IP \[bu] 3
73 Where no kernel version is indicated,
74 the system call appeared in Linux 1.0 or earlier.
75 .IP \[bu]
76 Where a system call is marked "1.2"
77 this means the system call probably appeared in a Linux 1.1.x kernel version,
78 and first appeared in a stable kernel with 1.2.
79 (Development of the Linux 1.2 kernel was initiated from a branch of
80 Linux 1.0.6 via the Linux 1.1.x unstable kernel series.)
81 .IP \[bu]
82 Where a system call is marked "2.0"
83 this means the system call probably appeared in a Linux 1.3.x kernel version,
84 and first appeared in a stable kernel with Linux 2.0.
85 (Development of the Linux 2.0 kernel was initiated from a branch of
86 Linux 1.2.x, somewhere around Linux 1.2.10,
87 via the Linux 1.3.x unstable kernel series.)
88 .\" Was Linux 2.0 started from a branch of Linux 1.2.10?
89 .\" At least from the timestamps of the tarballs of
90 .\" of Linux 1.2.10 and Linux 1.3.0, that's how it looks, but in
91 .\" fact the diff doesn't seem very clear, the
92 .\" Linux 1.3.0 .tar.bz is much bigger (2.0 MB) than the
93 .\" Linux 1.2.10 .tar.bz2 (1.8 MB), and AEB points out the
94 .\" timestamps of some files in Linux 1.3.0 seem to be older
95 .\" than those in Linux 1.2.10. All of this suggests
96 .\" that there might not have been a clean branch point.
97 .IP \[bu]
98 Where a system call is marked "2.2"
99 this means the system call probably appeared in a Linux 2.1.x kernel version,
100 and first appeared in a stable kernel with Linux 2.2.0.
101 (Development of the Linux 2.2 kernel was initiated from a branch of
102 Linux 2.0.21 via the Linux 2.1.x unstable kernel series.)
103 .IP \[bu]
104 Where a system call is marked "2.4"
105 this means the system call probably appeared in a Linux 2.3.x kernel version,
106 and first appeared in a stable kernel with Linux 2.4.0.
107 (Development of the Linux 2.4 kernel was initiated from a branch of
108 Linux 2.2.8 via the Linux 2.3.x unstable kernel series.)
109 .IP \[bu]
110 Where a system call is marked "2.6"
111 this means the system call probably appeared in a Linux 2.5.x kernel version,
112 and first appeared in a stable kernel with Linux 2.6.0.
113 (Development of Linux 2.6 was initiated from a branch
114 of Linux 2.4.15 via the Linux 2.5.x unstable kernel series.)
115 .IP \[bu]
116 Starting with Linux 2.6.0, the development model changed,
117 and new system calls may appear in each Linux 2.6.x release.
118 In this case, the exact version number where the system call appeared
119 is shown.
120 This convention continues with the Linux 3.x kernel series,
121 which followed on from Linux 2.6.39; and the Linux 4.x kernel series,
122 which followed on from Linux 3.19; and the Linux 5.x kernel series,
123 which followed on from Linux 4.20; and the Linux 6.x kernel series,
124 which followed on from Linux 5.19.
125 .IP \[bu]
126 In some cases, a system call was added to a stable kernel
127 series after it branched from the previous stable kernel
128 series, and then backported into the earlier stable kernel series.
129 For example some system calls that appeared in Linux 2.6.x were also backported
130 into a Linux 2.4.x release after Linux 2.4.15.
131 When this is so, the version where the system call appeared
132 in both of the major kernel series is listed.
133 .P
134 The list of system calls that are available as at Linux 5.14
135 (or in a few cases only on older kernels) is as follows:
136 .P
137 .\"
138 .\" Looking at scripts/checksyscalls.sh in the kernel source is
139 .\" instructive about x86 specifics.
140 .\"
141 .TS
142 Lb Lb Lb
143 L2 L L.
144 System call Kernel Notes
145 _
146 \fB_llseek\fP(2) 1.2
147 \fB_newselect\fP(2) 2.0
148 \fB_sysctl\fP(2) 2.0 Removed in 5.5
149 \fBaccept\fP(2) 2.0 T{
150 See notes on \fBsocketcall\fP(2)
151 T}
152 \fBaccept4\fP(2) 2.6.28
153 \fBaccess\fP(2) 1.0
154 \fBacct\fP(2) 1.0
155 \fBadd_key\fP(2) 2.6.10
156 \fBadjtimex\fP(2) 1.0
157 \fBalarm\fP(2) 1.0
158 \fBalloc_hugepages\fP(2) 2.5.36 Removed in 2.5.44
159 .\" 4adeefe161a74369e44cc8e663f240ece0470dc3
160 \fBarc_gettls\fP(2) 3.9 ARC only
161 \fBarc_settls\fP(2) 3.9 ARC only
162 .\" 91e040a79df73d371f70792f30380d4e44805250
163 \fBarc_usr_cmpxchg\fP(2) 4.9 ARC only
164 .\" x86: 79170fda313ed5be2394f87aa2a00d597f8ed4a1
165 \fBarch_prctl\fP(2) 2.6 T{
166 x86_64, x86 since 4.12
167 T}
168 .\" 9674cdc74d63f346870943ef966a034f8c71ee57
169 \fBatomic_barrier\fP(2) 2.6.34 m68k only
170 \fBatomic_cmpxchg_32\fP(2) 2.6.34 m68k only
171 \fBbdflush\fP(2) 1.2 T{
172 Deprecated (does nothing)
173 since 2.6
174 T}
175 \fBbind\fP(2) 2.0 T{
176 See notes on \fBsocketcall\fP(2)
177 T}
178 \fBbpf\fP(2) 3.18
179 \fBbrk\fP(2) 1.0
180 \fBbreakpoint\fP(2) 2.2 T{
181 ARM OABI only, defined with
182 \fB__ARM_NR\fP prefix
183 T}
184 \fBcacheflush\fP(2) 1.2 Not on x86
185 \fBcapget\fP(2) 2.2
186 \fBcapset\fP(2) 2.2
187 \fBchdir\fP(2) 1.0
188 \fBchmod\fP(2) 1.0
189 \fBchown\fP(2) 2.2 T{
190 See \fBchown\fP(2) for
191 version details
192 T}
193 \fBchown32\fP(2) 2.4
194 \fBchroot\fP(2) 1.0
195 \fBclock_adjtime\fP(2) 2.6.39
196 \fBclock_getres\fP(2) 2.6
197 \fBclock_gettime\fP(2) 2.6
198 \fBclock_nanosleep\fP(2) 2.6
199 \fBclock_settime\fP(2) 2.6
200 \fBclone2\fP(2) 2.4 IA-64 only
201 \fBclone\fP(2) 1.0
202 \fBclone3\fP(2) 5.3
203 \fBclose\fP(2) 1.0
204 \fBclose_range\fP(2) 5.9
205 .\" .\" dcef1f634657dabe7905af3ccda12cf7f0b6fcc1
206 .\" .\" cc20d42986d5807cbe4f5c7c8e3dab2e59ea0db3
207 .\" .\" db695c0509d6ec9046ee5e4c520a19fa17d9fce2
208 .\" \fBcmpxchg\fP(2) 2.6.12 T{
209 .\" ARM, syscall constant never was
210 .\" exposed to user space, in-kernel
211 .\" definition had \fB__ARM_NR\fP prefix,
212 .\" removed in 4.4
213 .\" T}
214 .\" 867e359b97c970a60626d5d76bbe2a8fadbf38fb
215 .\" bb9d812643d8a121df7d614a2b9c60193a92deb0
216 \fBconnect\fP(2) 2.0 T{
217 See notes on \fBsocketcall\fP(2)
218 T}
219 \fBcopy_file_range\fP(2) 4.5
220 \fBcreat\fP(2) 1.0
221 \fBcreate_module\fP(2) 1.0 Removed in 2.6
222 \fBdelete_module\fP(2) 1.0
223 .\" 1394f03221790a988afc3e4b3cb79f2e477246a9
224 .\" 4ba66a9760722ccbb691b8f7116cad2f791cca7b
225 \fBdup\fP(2) 1.0
226 \fBdup2\fP(2) 1.0
227 \fBdup3\fP(2) 2.6.27
228 \fBepoll_create\fP(2) 2.6
229 \fBepoll_create1\fP(2) 2.6.27
230 \fBepoll_ctl\fP(2) 2.6
231 \fBepoll_pwait\fP(2) 2.6.19
232 \fBepoll_pwait2\fP(2) 5.11
233 \fBepoll_wait\fP(2) 2.6
234 \fBeventfd\fP(2) 2.6.22
235 \fBeventfd2\fP(2) 2.6.27
236 \fBexecv\fP(2) 2.0 T{
237 SPARC/SPARC64 only, for
238 compatibility with SunOS
239 T}
240 \fBexecve\fP(2) 1.0
241 \fBexecveat\fP(2) 3.19
242 \fBexit\fP(2) 1.0
243 \fBexit_group\fP(2) 2.6
244 \fBfaccessat\fP(2) 2.6.16
245 \fBfaccessat2\fP(2) 5.8
246 \fBfadvise64\fP(2) 2.6
247 .\" Implements \fBposix_fadvise\fP(2)
248 \fBfadvise64_64\fP(2) 2.6
249 \fBfallocate\fP(2) 2.6.23
250 \fBfanotify_init\fP(2) 2.6.37
251 \fBfanotify_mark\fP(2) 2.6.37
252 .\" The fanotify calls were added in Linux 2.6.36,
253 .\" but disabled while the API was finalized.
254 \fBfchdir\fP(2) 1.0
255 \fBfchmod\fP(2) 1.0
256 \fBfchmodat\fP(2) 2.6.16
257 \fBfchown\fP(2) 1.0
258 \fBfchown32\fP(2) 2.4
259 \fBfchownat\fP(2) 2.6.16
260 \fBfcntl\fP(2) 1.0
261 \fBfcntl64\fP(2) 2.4
262 \fBfdatasync\fP(2) 2.0
263 \fBfgetxattr\fP(2) 2.6; 2.4.18
264 \fBfinit_module\fP(2) 3.8
265 \fBflistxattr\fP(2) 2.6; 2.4.18
266 \fBflock\fP(2) 2.0
267 \fBfork\fP(2) 1.0
268 \fBfree_hugepages\fP(2) 2.5.36 Removed in 2.5.44
269 \fBfremovexattr\fP(2) 2.6; 2.4.18
270 \fBfsconfig\fP(2) 5.2
271 \fBfsetxattr\fP(2) 2.6; 2.4.18
272 \fBfsmount\fP(2) 5.2
273 \fBfsopen\fP(2) 5.2
274 \fBfspick\fP(2) 5.2
275 \fBfstat\fP(2) 1.0
276 \fBfstat64\fP(2) 2.4
277 \fBfstatat64\fP(2) 2.6.16
278 \fBfstatfs\fP(2) 1.0
279 \fBfstatfs64\fP(2) 2.6
280 \fBfsync\fP(2) 1.0
281 \fBftruncate\fP(2) 1.0
282 \fBftruncate64\fP(2) 2.4
283 \fBfutex\fP(2) 2.6
284 \fBfutimesat\fP(2) 2.6.16
285 \fBget_kernel_syms\fP(2) 1.0 Removed in 2.6
286 \fBget_mempolicy\fP(2) 2.6.6
287 \fBget_robust_list\fP(2) 2.6.17
288 \fBget_thread_area\fP(2) 2.6
289 .\" 8fcd6c45f5a65621ec809b7866a3623e9a01d4ed
290 \fBget_tls\fP(2) 4.15 T{
291 ARM OABI only, has
292 \fB__ARM_NR\fP prefix
293 T}
294 \fBgetcpu\fP(2) 2.6.19
295 \fBgetcwd\fP(2) 2.2
296 \fBgetdents\fP(2) 2.0
297 \fBgetdents64\fP(2) 2.4
298 .\" parisc: 863722e856e64dae0e252b6bb546737c6c5626ce
299 \fBgetdomainname\fP(2) 2.2 T{
300 SPARC, SPARC64; available
301 as \fBosf_getdomainname\fP(2)
302 on Alpha since Linux 2.0
303 T}
304 .\" ec98c6b9b47df6df1c1fa6cf3d427414f8c2cf16
305 \fBgetdtablesize\fP(2) 2.0 T{
306 SPARC (removed in 2.6.26),
307 available on Alpha as
308 \fBosf_getdtablesize\fP(2)
309 T}
310 \fBgetegid\fP(2) 1.0
311 \fBgetegid32\fP(2) 2.4
312 \fBgeteuid\fP(2) 1.0
313 \fBgeteuid32\fP(2) 2.4
314 \fBgetgid\fP(2) 1.0
315 \fBgetgid32\fP(2) 2.4
316 \fBgetgroups\fP(2) 1.0
317 \fBgetgroups32\fP(2) 2.4
318 .\" SPARC removal: ec98c6b9b47df6df1c1fa6cf3d427414f8c2cf16
319 \fBgethostname\fP(2) 2.0 T{
320 Alpha, was available on
321 SPARC up to Linux 2.6.26
322 T}
323 \fBgetitimer\fP(2) 1.0
324 \fBgetpeername\fP(2) 2.0 T{
325 See notes on \fBsocketcall\fP(2)
326 T}
327 \fBgetpagesize\fP(2) 2.0 T{
328 Alpha, SPARC/SPARC64 only
329 T}
330 \fBgetpgid\fP(2) 1.0
331 \fBgetpgrp\fP(2) 1.0
332 \fBgetpid\fP(2) 1.0
333 \fBgetppid\fP(2) 1.0
334 \fBgetpriority\fP(2) 1.0
335 \fBgetrandom\fP(2) 3.17
336 \fBgetresgid\fP(2) 2.2
337 \fBgetresgid32\fP(2) 2.4
338 \fBgetresuid\fP(2) 2.2
339 \fBgetresuid32\fP(2) 2.4
340 \fBgetrlimit\fP(2) 1.0
341 \fBgetrusage\fP(2) 1.0
342 \fBgetsid\fP(2) 2.0
343 \fBgetsockname\fP(2) 2.0 T{
344 See notes on \fBsocketcall\fP(2)
345 T}
346 \fBgetsockopt\fP(2) 2.0 T{
347 See notes on \fBsocketcall\fP(2)
348 T}
349 \fBgettid\fP(2) 2.4.11
350 \fBgettimeofday\fP(2) 1.0
351 \fBgetuid\fP(2) 1.0
352 \fBgetuid32\fP(2) 2.4
353 \fBgetunwind\fP(2) 2.4.8 T{
354 IA-64 only; deprecated
355 T}
356 \fBgetxattr\fP(2) 2.6; 2.4.18
357 \fBgetxgid\fP(2) 2.0 T{
358 Alpha only; see NOTES
359 T}
360 \fBgetxpid\fP(2) 2.0 T{
361 Alpha only; see NOTES
362 T}
363 \fBgetxuid\fP(2) 2.0 T{
364 Alpha only; see NOTES
365 T}
366 \fBinit_module\fP(2) 1.0
367 \fBinotify_add_watch\fP(2) 2.6.13
368 \fBinotify_init\fP(2) 2.6.13
369 \fBinotify_init1\fP(2) 2.6.27
370 \fBinotify_rm_watch\fP(2) 2.6.13
371 \fBio_cancel\fP(2) 2.6
372 \fBio_destroy\fP(2) 2.6
373 \fBio_getevents\fP(2) 2.6
374 \fBio_pgetevents\fP(2) 4.18
375 \fBio_setup\fP(2) 2.6
376 \fBio_submit\fP(2) 2.6
377 \fBio_uring_enter\fP(2) 5.1
378 \fBio_uring_register\fP(2) 5.1
379 \fBio_uring_setup\fP(2) 5.1
380 \fBioctl\fP(2) 1.0
381 \fBioperm\fP(2) 1.0
382 \fBiopl\fP(2) 1.0
383 \fBioprio_get\fP(2) 2.6.13
384 \fBioprio_set\fP(2) 2.6.13
385 \fBipc\fP(2) 1.0
386 .\" Implements System V IPC calls
387 \fBkcmp\fP(2) 3.5
388 \fBkern_features\fP(2) 3.7 SPARC64 only
389 .\" FIXME . document kern_features():
390 .\" commit 517ffce4e1a03aea979fe3a18a3dd1761a24fafb
391 \fBkexec_file_load\fP(2) 3.17
392 \fBkexec_load\fP(2) 2.6.13
393 .\" The entry in the syscall table was reserved starting in 2.6.7
394 .\" Was named sys_kexec_load() from 2.6.7 to 2.6.16
395 \fBkeyctl\fP(2) 2.6.10
396 \fBkill\fP(2) 1.0
397 \fBlandlock_add_rule\fP(2) 5.13
398 \fBlandlock_create_ruleset\fP(2) 5.13
399 \fBlandlock_restrict_self\fP(2) 5.13
400 \fBlchown\fP(2) 1.0 T{
401 See \fBchown\fP(2) for
402 version details
403 T}
404 \fBlchown32\fP(2) 2.4
405 \fBlgetxattr\fP(2) 2.6; 2.4.18
406 \fBlink\fP(2) 1.0
407 \fBlinkat\fP(2) 2.6.16
408 \fBlisten\fP(2) 2.0 T{
409 See notes on \fBsocketcall\fP(2)
410 T}
411 \fBlistxattr\fP(2) 2.6; 2.4.18
412 \fBllistxattr\fP(2) 2.6; 2.4.18
413 \fBlookup_dcookie\fP(2) 2.6
414 \fBlremovexattr\fP(2) 2.6; 2.4.18
415 \fBlseek\fP(2) 1.0
416 \fBlsetxattr\fP(2) 2.6; 2.4.18
417 \fBlstat\fP(2) 1.0
418 \fBlstat64\fP(2) 2.4
419 \fBmadvise\fP(2) 2.4
420 \fBmbind\fP(2) 2.6.6
421 \fBmemory_ordering\fP(2) 2.2 SPARC64 only
422 .\" 26025bbfbba33a9425be1b89eccb4664ea4c17b6
423 .\" bb6fb6dfcc17cddac11ac295861f7608194447a7
424 \fBmembarrier\fP(2) 3.17
425 \fBmemfd_create\fP(2) 3.17
426 \fBmemfd_secret\fP(2) 5.14
427 \fBmigrate_pages\fP(2) 2.6.16
428 \fBmincore\fP(2) 2.4
429 \fBmkdir\fP(2) 1.0
430 \fBmkdirat\fP(2) 2.6.16
431 \fBmknod\fP(2) 1.0
432 \fBmknodat\fP(2) 2.6.16
433 \fBmlock\fP(2) 2.0
434 \fBmlock2\fP(2) 4.4
435 \fBmlockall\fP(2) 2.0
436 \fBmmap\fP(2) 1.0
437 \fBmmap2\fP(2) 2.4
438 \fBmodify_ldt\fP(2) 1.0
439 \fBmount\fP(2) 1.0
440 \fBmove_mount\fP(2) 5.2
441 \fBmove_pages\fP(2) 2.6.18
442 \fBmprotect\fP(2) 1.0
443 \fBmq_getsetattr\fP(2) 2.6.6
444 .\" Implements \fBmq_getattr\fP(3) and \fBmq_setattr\fP(3)
445 \fBmq_notify\fP(2) 2.6.6
446 \fBmq_open\fP(2) 2.6.6
447 \fBmq_timedreceive\fP(2) 2.6.6
448 \fBmq_timedsend\fP(2) 2.6.6
449 \fBmq_unlink\fP(2) 2.6.6
450 \fBmremap\fP(2) 2.0
451 \fBmsgctl\fP(2) 2.0 T{
452 See notes on \fBipc\fP(2)
453 T}
454 \fBmsgget\fP(2) 2.0 T{
455 See notes on \fBipc\fP(2)
456 T}
457 \fBmsgrcv\fP(2) 2.0 T{
458 See notes on \fBipc\fP(2)
459 T}
460 \fBmsgsnd\fP(2) 2.0 T{
461 See notes on \fBipc\fP(2)
462 T}
463 \fBmsync\fP(2) 2.0
464 .\" \fBmultiplexer\fP(2) ?? __NR_multiplexer reserved on
465 .\" PowerPC, but unimplemented?
466 \fBmunlock\fP(2) 2.0
467 \fBmunlockall\fP(2) 2.0
468 \fBmunmap\fP(2) 1.0
469 \fBname_to_handle_at\fP(2) 2.6.39
470 \fBnanosleep\fP(2) 2.0
471 .\" 5590ff0d5528b60153c0b4e7b771472b5a95e297
472 \fBnewfstatat\fP(2) 2.6.16 T{
473 See \fBstat\fP(2)
474 T}
475 \fBnfsservctl\fP(2) 2.2 Removed in 3.1
476 \fBnice\fP(2) 1.0
477 \fBold_adjtimex\fP(2) 2.0 T{
478 Alpha only; see NOTES
479 T}
480 \fBold_getrlimit\fP(2) 2.4 T{
481 Old variant of \fBgetrlimit\fP(2)
482 that used a different value
483 for \fBRLIM_INFINITY\fP
484 T}
485 \fBoldfstat\fP(2) 1.0
486 \fBoldlstat\fP(2) 1.0
487 \fBoldolduname\fP(2) 1.0
488 \fBoldstat\fP(2) 1.0
489 \fBoldumount\fP(2) 2.4.116 T{
490 Name of the old \fBumount\fP(2)
491 syscall on Alpha
492 T}
493 \fBolduname\fP(2) 1.0
494 \fBopen\fP(2) 1.0
495 \fBopen_by_handle_at\fP(2) 2.6.39
496 \fBopen_tree\fP(2) 5.2
497 \fBopenat\fP(2) 2.6.16
498 \fBopenat2\fP(2) 5.6
499 .\" 9d02a4283e9ce4e9ca11ff00615bdacdb0515a1a
500 \fBor1k_atomic\fP(2) 3.1 T{
501 OpenRISC 1000 only
502 T}
503 \fBpause\fP(2) 1.0
504 \fBpciconfig_iobase\fP(2) 2.2.15; 2.4 Not on x86
505 .\" Alpha, PowerPC, ARM; not x86
506 \fBpciconfig_read\fP(2) 2.0.26; 2.2 Not on x86
507 .\" , PowerPC, ARM; not x86
508 \fBpciconfig_write\fP(2) 2.0.26; 2.2 Not on x86
509 .\" , PowerPC, ARM; not x86
510 \fBperf_event_open\fP(2) 2.6.31 T{
511 Was perf_counter_open() in
512 2.6.31; renamed in 2.6.32
513 T}
514 \fBpersonality\fP(2) 1.2
515 \fBperfctr\fP(2) 2.2 T{
516 SPARC only; removed in 2.6.34
517 T}
518 .\" commit c7d5a0050773e98d1094eaa9f2a1a793fafac300 removed perfctr()
519 \fBperfmonctl\fP(2) 2.4 IA-64 only; removed in 5.10
520 \fBpidfd_getfd\fP(2) 5.6
521 \fBpidfd_send_signal\fP(2) 5.1
522 \fBpidfd_open\fP(2) 5.3
523 \fBpipe\fP(2) 1.0
524 \fBpipe2\fP(2) 2.6.27
525 \fBpivot_root\fP(2) 2.4
526 \fBpkey_alloc\fP(2) 4.8
527 \fBpkey_free\fP(2) 4.8
528 \fBpkey_mprotect\fP(2) 4.8
529 \fBpoll\fP(2) 2.0.36; 2.2
530 \fBppoll\fP(2) 2.6.16
531 \fBprctl\fP(2) 2.2
532 \fBpread64\fP(2) T{
533 Added as "pread" in 2.2;
534 renamed "pread64" in 2.6
535 T}
536 \fBpreadv\fP(2) 2.6.30
537 \fBpreadv2\fP(2) 4.6
538 \fBprlimit64\fP(2) 2.6.36
539 \fBprocess_madvise\fP(2) 5.10
540 \fBprocess_vm_readv\fP(2) 3.2
541 \fBprocess_vm_writev\fP(2) 3.2
542 \fBpselect6\fP(2) 2.6.16
543 .\" Implements \fBpselect\fP(2)
544 \fBptrace\fP(2) 1.0
545 \fBpwrite64\fP(2) T{
546 Added as "pwrite" in 2.2;
547 renamed "pwrite64" in 2.6
548 T}
549 \fBpwritev\fP(2) 2.6.30
550 \fBpwritev2\fP(2) 4.6
551 \fBquery_module\fP(2) 2.2 Removed in 2.6
552 \fBquotactl\fP(2) 1.0
553 \fBquotactl_fd\fP(2) 5.14
554 \fBread\fP(2) 1.0
555 \fBreadahead\fP(2) 2.4.13
556 \fBreaddir\fP(2) 1.0
557 .\" Supersedes \fBgetdents\fP(2)
558 \fBreadlink\fP(2) 1.0
559 \fBreadlinkat\fP(2) 2.6.16
560 \fBreadv\fP(2) 2.0
561 \fBreboot\fP(2) 1.0
562 \fBrecv\fP(2) 2.0 T{
563 See notes on \fBsocketcall\fP(2)
564 T}
565 \fBrecvfrom\fP(2) 2.0 T{
566 See notes on \fBsocketcall\fP(2)
567 T}
568 \fBrecvmsg\fP(2) 2.0 T{
569 See notes on \fBsocketcall\fP(2)
570 T}
571 \fBrecvmmsg\fP(2) 2.6.33
572 \fBremap_file_pages\fP(2) 2.6 T{
573 Deprecated since 3.16
574 T}
575 \fBremovexattr\fP(2) 2.6; 2.4.18
576 \fBrename\fP(2) 1.0
577 \fBrenameat\fP(2) 2.6.16
578 \fBrenameat2\fP(2) 3.15
579 \fBrequest_key\fP(2) 2.6.10
580 \fBrestart_syscall\fP(2) 2.6
581 .\" 921ebd8f2c081b3cf6c3b29ef4103eef3ff26054
582 \fBriscv_flush_icache\fP(2) 4.15 RISC-V only
583 \fBrmdir\fP(2) 1.0
584 \fBrseq\fP(2) 4.18
585 \fBrt_sigaction\fP(2) 2.2
586 \fBrt_sigpending\fP(2) 2.2
587 \fBrt_sigprocmask\fP(2) 2.2
588 \fBrt_sigqueueinfo\fP(2) 2.2
589 \fBrt_sigreturn\fP(2) 2.2
590 \fBrt_sigsuspend\fP(2) 2.2
591 \fBrt_sigtimedwait\fP(2) 2.2
592 \fBrt_tgsigqueueinfo\fP(2) 2.6.31
593 \fBrtas\fP(2) 2.6.2 T{
594 PowerPC/PowerPC64 only
595 T}
596 \fBs390_runtime_instr\fP(2) 3.7 s390 only
597 \fBs390_pci_mmio_read\fP(2) 3.19 s390 only
598 \fBs390_pci_mmio_write\fP(2) 3.19 s390 only
599 \fBs390_sthyi\fP(2) 4.15 s390 only
600 \fBs390_guarded_storage\fP(2) 4.12 s390 only
601 \fBsched_get_affinity\fP(2) 2.6 T{
602 Name of
603 .BR \%sched_getaffinity (2)
604 on SPARC and SPARC64
605 T}
606 \fBsched_get_priority_max\fP(2) 2.0
607 \fBsched_get_priority_min\fP(2) 2.0
608 \fBsched_getaffinity\fP(2) 2.6
609 \fBsched_getattr\fP(2) 3.14
610 \fBsched_getparam\fP(2) 2.0
611 \fBsched_getscheduler\fP(2) 2.0
612 \fBsched_rr_get_interval\fP(2) 2.0
613 \fBsched_set_affinity\fP(2) 2.6 T{
614 Name of
615 .BR \%sched_setaffinity (2)
616 on SPARC and SPARC64
617 T}
618 \fBsched_setaffinity\fP(2) 2.6
619 \fBsched_setattr\fP(2) 3.14
620 \fBsched_setparam\fP(2) 2.0
621 \fBsched_setscheduler\fP(2) 2.0
622 \fBsched_yield\fP(2) 2.0
623 \fBseccomp\fP(2) 3.17
624 \fBselect\fP(2) 1.0
625 \fBsemctl\fP(2) 2.0 T{
626 See notes on \fBipc\fP(2)
627 T}
628 \fBsemget\fP(2) 2.0 T{
629 See notes on \fBipc\fP(2)
630 T}
631 \fBsemop\fP(2) 2.0 T{
632 See notes on \fBipc\fP(2)
633 T}
634 \fBsemtimedop\fP(2) 2.6; 2.4.22
635 \fBsend\fP(2) 2.0 T{
636 See notes on \fBsocketcall\fP(2)
637 T}
638 \fBsendfile\fP(2) 2.2
639 \fBsendfile64\fP(2) 2.6; 2.4.19
640 \fBsendmmsg\fP(2) 3.0
641 \fBsendmsg\fP(2) 2.0 T{
642 See notes on \fBsocketcall\fP(2)
643 T}
644 \fBsendto\fP(2) 2.0 T{
645 See notes on \fBsocketcall\fP(2)
646 T}
647 \fBset_mempolicy\fP(2) 2.6.6
648 \fBset_robust_list\fP(2) 2.6.17
649 \fBset_thread_area\fP(2) 2.6
650 \fBset_tid_address\fP(2) 2.6
651 \fBset_tls\fP(2) 2.6.11 T{
652 ARM OABI/EABI only (constant
653 has \fB__ARM_NR\fP prefix)
654 T}
655 .\" \fBsetaltroot\fP(2) 2.6.10 T{
656 .\" Removed in 2.6.11, exposed one
657 .\" of implementation details of
658 .\" \fBpersonality\fP(2) (creating an
659 .\" alternative root, precursor of
660 .\" mount namespaces) to user space.
661 .\" T}
662 .\" See http://lkml.org/lkml/2005/8/1/83
663 .\" "[PATCH] remove sys_set_zone_reclaim()"
664 \fBsetdomainname\fP(2) 1.0
665 \fBsetfsgid\fP(2) 1.2
666 \fBsetfsgid32\fP(2) 2.4
667 \fBsetfsuid\fP(2) 1.2
668 \fBsetfsuid32\fP(2) 2.4
669 \fBsetgid\fP(2) 1.0
670 \fBsetgid32\fP(2) 2.4
671 \fBsetgroups\fP(2) 1.0
672 \fBsetgroups32\fP(2) 2.4
673 .\" arch/alpha/include/asm/core_lca.h
674 \fBsethae\fP(2) 2.0 T{
675 Alpha only; see NOTES
676 T}
677 \fBsethostname\fP(2) 1.0
678 \fBsetitimer\fP(2) 1.0
679 \fBsetns\fP(2) 3.0
680 \fBsetpgid\fP(2) 1.0
681 \fBsetpgrp\fP(2) 2.0 T{
682 Alternative name for \fBsetpgid\fP(2) on Alpha
683 T}
684 \fBsetpriority\fP(2) 1.0
685 \fBsetregid\fP(2) 1.0
686 \fBsetregid32\fP(2) 2.4
687 \fBsetresgid\fP(2) 2.2
688 \fBsetresgid32\fP(2) 2.4
689 \fBsetresuid\fP(2) 2.2
690 \fBsetresuid32\fP(2) 2.4
691 \fBsetreuid\fP(2) 1.0
692 \fBsetreuid32\fP(2) 2.4
693 \fBsetrlimit\fP(2) 1.0
694 \fBsetsid\fP(2) 1.0
695 \fBsetsockopt\fP(2) 2.0 T{
696 See notes on \fBsocketcall\fP(2)
697 T}
698 \fBsettimeofday\fP(2) 1.0
699 \fBsetuid\fP(2) 1.0
700 \fBsetuid32\fP(2) 2.4
701 \fBsetup\fP(2) 1.0 Removed in 2.2
702 \fBsetxattr\fP(2) 2.6; 2.4.18
703 \fBsgetmask\fP(2) 1.0
704 \fBshmat\fP(2) 2.0 T{
705 See notes on \fBipc\fP(2)
706 T}
707 \fBshmctl\fP(2) 2.0 T{
708 See notes on \fBipc\fP(2)
709 T}
710 \fBshmdt\fP(2) 2.0 T{
711 See notes on \fBipc\fP(2)
712 T}
713 \fBshmget\fP(2) 2.0 T{
714 See notes on \fBipc\fP(2)
715 T}
716 \fBshutdown\fP(2) 2.0 T{
717 See notes on \fBsocketcall\fP(2)
718 T}
719 \fBsigaction\fP(2) 1.0
720 \fBsigaltstack\fP(2) 2.2
721 \fBsignal\fP(2) 1.0
722 \fBsignalfd\fP(2) 2.6.22
723 \fBsignalfd4\fP(2) 2.6.27
724 \fBsigpending\fP(2) 1.0
725 \fBsigprocmask\fP(2) 1.0
726 \fBsigreturn\fP(2) 1.0
727 \fBsigsuspend\fP(2) 1.0
728 \fBsocket\fP(2) 2.0 T{
729 See notes on \fBsocketcall\fP(2)
730 T}
731 \fBsocketcall\fP(2) 1.0
732 .\" Implements BSD socket calls
733 \fBsocketpair\fP(2) 2.0 T{
734 See notes on \fBsocketcall\fP(2)
735 T}
736 .\" 5a0015d62668e64c8b6e02e360fbbea121bfd5e6
737 \fBspill\fP(2) 2.6.13 Xtensa only
738 \fBsplice\fP(2) 2.6.17
739 \fBspu_create\fP(2) 2.6.16 T{
740 PowerPC/PowerPC64 only
741 T}
742 \fBspu_run\fP(2) 2.6.16 T{
743 PowerPC/PowerPC64 only
744 T}
745 \fBssetmask\fP(2) 1.0
746 \fBstat\fP(2) 1.0
747 \fBstat64\fP(2) 2.4
748 \fBstatfs\fP(2) 1.0
749 \fBstatfs64\fP(2) 2.6
750 \fBstatx\fP(2) 4.11
751 \fBstime\fP(2) 1.0
752 \fBsubpage_prot\fP(2) 2.6.25 T{
753 PowerPC/PowerPC64 only
754 T}
755 \fBswapcontext\fP(2) 2.6.3 T{
756 PowerPC/PowerPC64 only
757 T}
758 .\" 529d235a0e190ded1d21ccc80a73e625ebcad09b
759 \fBswitch_endian\fP(2) 4.1 PowerPC64 only
760 \fBswapoff\fP(2) 1.0
761 \fBswapon\fP(2) 1.0
762 \fBsymlink\fP(2) 1.0
763 \fBsymlinkat\fP(2) 2.6.16
764 \fBsync\fP(2) 1.0
765 \fBsync_file_range\fP(2) 2.6.17
766 \fBsync_file_range2\fP(2) 2.6.22
767 .\" PowerPC, ARM, tile
768 .\" First appeared on ARM, as arm_sync_file_range(), but later renamed
769 .\" \fBsys_debug_setcontext\fP(2) ??? PowerPC if CONFIG_PPC32
770 \fBsyncfs\fP(2) 2.6.39
771 \fBsys_debug_setcontext\fP(2) 2.6.11 PowerPC only
772 \fBsyscall\fP(2) 1.0 T{
773 Still available on ARM OABI
774 and MIPS O32 ABI
775 T}
776 \fBsysfs\fP(2) 1.2
777 \fBsysinfo\fP(2) 1.0
778 \fBsyslog\fP(2) 1.0
779 .\" glibc interface is \fBklogctl\fP(3)
780 \fBsysmips\fP(2) 2.6.0 MIPS only
781 \fBtee\fP(2) 2.6.17
782 \fBtgkill\fP(2) 2.6
783 \fBtime\fP(2) 1.0
784 \fBtimer_create\fP(2) 2.6
785 \fBtimer_delete\fP(2) 2.6
786 \fBtimer_getoverrun\fP(2) 2.6
787 \fBtimer_gettime\fP(2) 2.6
788 \fBtimer_settime\fP(2) 2.6
789 .\" .\" b215e283992899650c4271e7385c79e26fb9a88e
790 .\" .\" 4d672e7ac79b5ec5cdc90e450823441e20464691
791 .\" \fBtimerfd\fP(2) 2.6.22 T{
792 .\" Old timerfd interface,
793 .\" removed in 2.6.25
794 .\" T}
795 \fBtimerfd_create\fP(2) 2.6.25
796 \fBtimerfd_gettime\fP(2) 2.6.25
797 \fBtimerfd_settime\fP(2) 2.6.25
798 \fBtimes\fP(2) 1.0
799 \fBtkill\fP(2) 2.6; 2.4.22
800 \fBtruncate\fP(2) 1.0
801 \fBtruncate64\fP(2) 2.4
802 \fBugetrlimit\fP(2) 2.4
803 \fBumask\fP(2) 1.0
804 \fBumount\fP(2) 1.0
805 .\" sys_oldumount() -- __NR_umount
806 \fBumount2\fP(2) 2.2
807 .\" sys_umount() -- __NR_umount2
808 \fBuname\fP(2) 1.0
809 \fBunlink\fP(2) 1.0
810 \fBunlinkat\fP(2) 2.6.16
811 \fBunshare\fP(2) 2.6.16
812 \fBuselib\fP(2) 1.0
813 \fBustat\fP(2) 1.0
814 \fBuserfaultfd\fP(2) 4.3
815 \fBusr26\fP(2) 2.4.8.1 ARM OABI only
816 \fBusr32\fP(2) 2.4.8.1 ARM OABI only
817 \fButime\fP(2) 1.0
818 \fButimensat\fP(2) 2.6.22
819 \fButimes\fP(2) 2.2
820 \fButrap_install\fP(2) 2.2 SPARC64 only
821 .\" FIXME . document utrap_install()
822 .\" There's a man page for Solaris 5.11
823 \fBvfork\fP(2) 2.2
824 \fBvhangup\fP(2) 1.0
825 \fBvm86old\fP(2) 1.0 T{
826 Was "vm86"; renamed in
827 2.0.28/2.2
828 T}
829 \fBvm86\fP(2) 2.0.28; 2.2
830 \fBvmsplice\fP(2) 2.6.17
831 \fBwait4\fP(2) 1.0
832 \fBwaitid\fP(2) 2.6.10
833 \fBwaitpid\fP(2) 1.0
834 \fBwrite\fP(2) 1.0
835 \fBwritev\fP(2) 2.0
836 .\" 5a0015d62668e64c8b6e02e360fbbea121bfd5e6
837 \fBxtensa\fP(2) 2.6.13 Xtensa only
838 .TE
839 .P
840 On many platforms, including x86-32, socket calls are all multiplexed
841 (via glibc wrapper functions) through
842 .BR socketcall (2)
843 and similarly System\ V IPC calls are multiplexed through
844 .BR ipc (2).
845 .P
846 Although slots are reserved for them in the system call table,
847 the following system calls are not implemented in the standard kernel:
848 .BR afs_syscall (2), \" __NR_afs_syscall is 53 on Linux 2.6.22/i386
849 .BR break (2), \" __NR_break is 17 on Linux 2.6.22/i386
850 .BR ftime (2), \" __NR_ftime is 35 on Linux 2.6.22/i386
851 .BR getpmsg (2), \" __NR_getpmsg is 188 on Linux 2.6.22/i386
852 .BR gtty (2), \" __NR_gtty is 32 on Linux 2.6.22/i386
853 .BR idle (2), \" __NR_idle is 112 on Linux 2.6.22/i386
854 .BR lock (2), \" __NR_lock is 53 on Linux 2.6.22/i386
855 .BR madvise1 (2), \" __NR_madvise1 is 219 on Linux 2.6.22/i386
856 .BR mpx (2), \" __NR_mpx is 66 on Linux 2.6.22/i386
857 .BR phys (2), \" Slot has been reused
858 .BR prof (2), \" __NR_prof is 44 on Linux 2.6.22/i386
859 .BR profil (2), \" __NR_profil is 98 on Linux 2.6.22/i386
860 .BR putpmsg (2), \" __NR_putpmsg is 189 on Linux 2.6.22/i386
861 .\" __NR_security is 223 on Linux 2.4/i386; absent on 2.6/i386, present
862 .\" on a couple of 2.6 architectures
863 .BR security (2), \" __NR_security is 223 on Linux 2.4/i386
864 .\" The security call is for future use.
865 .BR stty (2), \" __NR_stty is 31 on Linux 2.6.22/i386
866 .BR tuxcall (2), \" __NR_tuxcall is 184 on x86_64, also on PPC and alpha
867 .BR ulimit (2), \" __NR_ulimit is 58 on Linux 2.6.22/i386
868 and
869 .BR vserver (2) \" __NR_vserver is 273 on Linux 2.6.22/i386
870 (see also
871 .BR unimplemented (2)).
872 However,
873 .BR ftime (3),
874 .BR profil (3),
875 and
876 .BR ulimit (3)
877 exist as library routines.
878 The slot for
879 .BR phys (2)
880 is in use since Linux 2.1.116 for
881 .BR umount (2);
882 .BR phys (2)
883 will never be implemented.
884 The
885 .BR getpmsg (2)
886 and
887 .BR putpmsg (2)
888 calls are for kernels patched to support STREAMS,
889 and may never be in the standard kernel.
890 .P
891 There was briefly
892 .BR set_zone_reclaim (2),
893 added in Linux 2.6.13, and removed in Linux 2.6.16;
894 this system call was never available to user space.
895 .\"
896 .SS System calls on removed ports
897 Some system calls only ever existed on Linux architectures that have
898 since been removed from the kernel:
899 .TP
900 AVR32 (port removed in Linux 4.12)
901 .RS
902 .PD 0
903 .IP \[bu] 3
904 .BR pread (2)
905 .IP \[bu]
906 .BR pwrite (2)
907 .PD
908 .RE
909 .TP
910 Blackfin (port removed in Linux 4.17)
911 .RS
912 .PD 0
913 .IP \[bu] 3
914 .BR bfin_spinlock (2)
915 (added in Linux 2.6.22)
916 .IP \[bu]
917 .BR dma_memcpy (2)
918 (added in Linux 2.6.22)
919 .IP \[bu]
920 .BR pread (2)
921 (added in Linux 2.6.22)
922 .IP \[bu]
923 .BR pwrite (2)
924 (added in Linux 2.6.22)
925 .IP \[bu]
926 .BR sram_alloc (2)
927 (added in Linux 2.6.22)
928 .IP \[bu]
929 .BR sram_free (2)
930 (added in Linux 2.6.22)
931 .PD
932 .RE
933 .TP
934 Metag (port removed in Linux 4.17)
935 .RS
936 .PD 0
937 .IP \[bu] 3
938 .BR metag_get_tls (2)
939 (add in Linux 3.9)
940 .IP \[bu]
941 .BR metag_set_fpu_flags (2)
942 (add in Linux 3.9)
943 .IP \[bu]
944 .BR metag_set_tls (2)
945 (add in Linux 3.9)
946 .IP \[bu]
947 .BR metag_setglobalbit (2)
948 (add in Linux 3.9)
949 .PD
950 .RE
951 .TP
952 Tile (port removed in Linux 4.17)
953 .RS
954 .PD 0
955 .IP \[bu] 3
956 .BR cmpxchg_badaddr (2)
957 (added in Linux 2.6.36)
958 .PD
959 .RE
960 .SH NOTES
961 Roughly speaking, the code belonging to the system call
962 with number __NR_xxx defined in
963 .I /usr/include/asm/unistd.h
964 can be found in the Linux kernel source in the routine
965 .IR sys_xxx ().
966 There are many exceptions, however, mostly because
967 older system calls were superseded by newer ones,
968 and this has been treated somewhat unsystematically.
969 On platforms with
970 proprietary operating-system emulation,
971 such as sparc, sparc64, and alpha,
972 there are many additional system calls; mips64 also contains a full
973 set of 32-bit system calls.
974 .P
975 Over time, changes to the interfaces of some system calls have been
976 necessary.
977 One reason for such changes was the need to increase the size of
978 structures or scalar values passed to the system call.
979 Because of these changes, certain architectures
980 (notably, longstanding 32-bit architectures such as i386)
981 now have various groups of related system calls (e.g.,
982 .BR truncate (2)
983 and
984 .BR truncate64 (2))
985 which perform similar tasks, but which vary in
986 details such as the size of their arguments.
987 (As noted earlier, applications are generally unaware of this:
988 the glibc wrapper functions do some work to ensure that the right
989 system call is invoked, and that ABI compatibility is
990 preserved for old binaries.)
991 Examples of system calls that exist in multiple versions are
992 the following:
993 .IP \[bu] 3
994 By now there are three different versions of
995 .BR stat (2):
996 .IR sys_stat ()
997 (slot
998 .IR __NR_oldstat ),
999 .IR sys_newstat ()
1000 (slot
1001 .IR __NR_stat ),
1002 and
1003 .IR sys_stat64 ()
1004 (slot
1005 .IR __NR_stat64 ),
1006 with the last being the most current.
1007 .\" e.g., on 2.6.22/i386: __NR_oldstat 18, __NR_stat 106, __NR_stat64 195
1008 .\" The stat system calls deal with three different data structures,
1009 .\" defined in include/asm-i386/stat.h: __old_kernel_stat, stat, stat64
1010 A similar story applies for
1011 .BR lstat (2)
1012 and
1013 .BR fstat (2).
1014 .IP \[bu]
1015 Similarly, the defines
1016 .IR __NR_oldolduname ,
1017 .IR __NR_olduname ,
1018 and
1019 .I __NR_uname
1020 refer to the routines
1021 .IR sys_olduname (),
1022 .IR sys_uname (),
1023 and
1024 .IR sys_newuname ().
1025 .IP \[bu]
1026 In Linux 2.0, a new version of
1027 .BR vm86 (2)
1028 appeared, with the old and the new kernel routines being named
1029 .IR sys_vm86old ()
1030 and
1031 .IR sys_vm86 ().
1032 .IP \[bu]
1033 In Linux 2.4, a new version of
1034 .BR getrlimit (2)
1035 appeared, with the old and the new kernel routines being named
1036 .IR sys_old_getrlimit ()
1037 (slot
1038 .IR __NR_getrlimit )
1039 and
1040 .IR sys_getrlimit ()
1041 (slot
1042 .IR __NR_ugetrlimit ).
1043 .IP \[bu]
1044 Linux 2.4 increased the size of user and group IDs from 16 to 32 bits.
1045 .\" 64-bit off_t changes: ftruncate64, *stat64,
1046 .\" fcntl64 (because of the flock structure), getdents64, *statfs64
1047 To support this change, a range of system calls were added
1048 (e.g.,
1049 .BR chown32 (2),
1050 .BR getuid32 (2),
1051 .BR getgroups32 (2),
1052 .BR setresuid32 (2)),
1053 superseding earlier calls of the same name without the
1054 "32" suffix.
1055 .IP \[bu]
1056 Linux 2.4 added support for applications on 32-bit architectures
1057 to access large files (i.e., files for which the sizes and
1058 file offsets can't be represented in 32 bits.)
1059 To support this change, replacements were required for system calls
1060 that deal with file offsets and sizes.
1061 Thus the following system calls were added:
1062 .BR fcntl64 (2),
1063 .BR getdents64 (2),
1064 .BR stat64 (2),
1065 .BR statfs64 (2),
1066 .BR truncate64 (2),
1067 and their analogs that work with file descriptors or
1068 symbolic links.
1069 These system calls supersede the older system calls
1070 which, except in the case of the "stat" calls,
1071 have the same name without the "64" suffix.
1072 .IP
1073 On newer platforms that only have 64-bit file access and 32-bit UIDs/GIDs
1074 (e.g., alpha, ia64, s390x, x86-64), there is just a single version of
1075 the UID/GID and file access system calls.
1076 On platforms (typically, 32-bit platforms) where the *64 and *32 calls exist,
1077 the other versions are obsolete.
1078 .IP \[bu]
1079 The
1080 .I rt_sig*
1081 calls were added in Linux 2.2 to support the addition
1082 of real-time signals (see
1083 .BR signal (7)).
1084 These system calls supersede the older system calls of the same
1085 name without the "rt_" prefix.
1086 .IP \[bu]
1087 The
1088 .BR select (2)
1089 and
1090 .BR mmap (2)
1091 system calls use five or more arguments,
1092 which caused problems in the way
1093 argument passing on the i386 used to be set up.
1094 Thus, while other architectures have
1095 .IR sys_select ()
1096 and
1097 .IR sys_mmap ()
1098 corresponding to
1099 .I __NR_select
1100 and
1101 .IR __NR_mmap ,
1102 on i386 one finds
1103 .IR old_select ()
1104 and
1105 .IR old_mmap ()
1106 (routines that use a pointer to an
1107 argument block) instead.
1108 These days passing five arguments
1109 is not a problem any more, and there is a
1110 .I __NR__newselect
1111 .\" (used by libc 6)
1112 that corresponds directly to
1113 .IR sys_select ()
1114 and similarly
1115 .IR __NR_mmap2 .
1116 s390x is the only 64-bit architecture that has
1117 .IR old_mmap ().
1118 .\" .P
1119 .\" Two system call numbers,
1120 .\" .IR __NR__llseek
1121 .\" and
1122 .\" .IR __NR__sysctl
1123 .\" have an additional underscore absent in
1124 .\" .IR sys_llseek ()
1125 .\" and
1126 .\" .IR sys_sysctl ().
1127 .\"
1128 .\" In Linux 2.1.81,
1129 .\" .BR lchown (2)
1130 .\" and
1131 .\" .BR chown (2)
1132 .\" were swapped; that is,
1133 .\" .BR lchown (2)
1134 .\" was added with the semantics that were then current for
1135 .\" .BR chown (2),
1136 .\" and the semantics of the latter call were changed to what
1137 .\" they are today.
1138 .\"
1139 .\"
1140 .SS "Architecture-specific details: Alpha"
1141 .TP
1142 .BR getxgid (2)
1143 returns a pair of GID and effective GID via registers
1144 \fBr0\fP and \fBr20\fP; it is provided
1145 instead of
1146 \fBgetgid\fP(2) and \fBgetegid\fP(2).
1147 .TP
1148 .BR getxpid (2)
1149 returns a pair of PID and parent PID via registers
1150 \fBr0\fP and \fBr20\fP; it is provided instead of
1151 \fBgetpid\fP(2) and \fBgetppid\fP(2).
1152 .TP
1153 .BR old_adjtimex (2)
1154 is a variant of \fBadjtimex\fP(2) that uses \fIstruct timeval32\fP,
1155 for compatibility with OSF/1.
1156 .TP
1157 .BR getxuid (2)
1158 returns a pair of GID and effective GID via registers
1159 \fBr0\fP and \fBr20\fP; it is provided instead of
1160 \fBgetuid\fP(2) and \fBgeteuid\fP(2).
1161 .TP
1162 .BR sethae (2)
1163 is used for configuring the Host Address Extension register on
1164 low-cost Alphas in order to access address space beyond first 27 bits.
1165 .SH SEE ALSO
1166 .BR ausyscall (1),
1167 .BR intro (2),
1168 .BR syscall (2),
1169 .BR unimplemented (2),
1170 .BR errno (3),
1171 .BR libc (7),
1172 .BR vdso (7)