Add <sys/auxv.h> and getauxval.
[glibc.git] / sysdeps / unix / sysv / linux / kernel-features.h
blob1090f8a809d7d14986722f796f96a75df4f7074d
1 /* Set flags signalling availability of kernel features based on given
2 kernel version number.
3 Copyright (C) 1999-2009, 2010, 2011, 2012 Free Software Foundation, Inc.
4 This file is part of the GNU C Library.
6 The GNU C Library is free software; you can redistribute it and/or
7 modify it under the terms of the GNU Lesser General Public
8 License as published by the Free Software Foundation; either
9 version 2.1 of the License, or (at your option) any later version.
11 The GNU C Library is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 Lesser General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public
17 License along with the GNU C Library; if not, see
18 <http://www.gnu.org/licenses/>. */
20 /* This file must not contain any C code. At least it must be protected
21 to allow using the file also in assembler files. */
23 #ifndef __LINUX_KERNEL_VERSION
24 /* We assume the worst; all kernels should be supported. */
25 # define __LINUX_KERNEL_VERSION 0
26 #endif
28 /* We assume for __LINUX_KERNEL_VERSION the same encoding used in
29 linux/version.h. I.e., the major, minor, and subminor all get a
30 byte with the major number being in the highest byte. This means
31 we can do numeric comparisons.
33 In the following we will define certain symbols depending on
34 whether the describes kernel feature is available in the kernel
35 version given by __LINUX_KERNEL_VERSION. We are not always exactly
36 recording the correct versions in which the features were
37 introduced. If somebody cares these values can afterwards be
38 corrected. */
40 /* When did the `setresuid' syscall became available? By 2.2.0 except
41 on SPARC. */
42 #if !defined __sparc__
43 # define __ASSUME_SETRESUID_SYSCALL 1
44 #endif
46 /* The sendfile syscall was introduced in 2.2.0. */
47 #define __ASSUME_SENDFILE 1
49 /* On x86 another `getrlimit' syscall was added in 2.3.25. */
50 #if __LINUX_KERNEL_VERSION >= 131865 && defined __i386__
51 # define __ASSUME_NEW_GETRLIMIT_SYSCALL 1
52 #endif
54 /* On x86 the truncate64/ftruncate64 syscalls were introduced in 2.3.31. */
55 #if __LINUX_KERNEL_VERSION >= 131871 && defined __i386__
56 # define __ASSUME_TRUNCATE64_SYSCALL 1
57 #endif
59 /* On x86 the mmap2 syscall was introduced in 2.3.31. */
60 #if __LINUX_KERNEL_VERSION >= 131871 && defined __i386__
61 # define __ASSUME_MMAP2_SYSCALL 1
62 #endif
64 /* On x86 the stat64/lstat64/fstat64 syscalls were introduced in 2.3.34. */
65 #if __LINUX_KERNEL_VERSION >= 131874 && defined __i386__
66 # define __ASSUME_STAT64_SYSCALL 1
67 #endif
69 /* On sparc the truncate64/ftruncate64/mmap2/stat64/lstat64/fstat64
70 syscalls were introduced in 2.3.35. */
71 #if __LINUX_KERNEL_VERSION >= 131875 \
72 && (defined __sparc__ && !defined __arch64__)
73 # define __ASSUME_TRUNCATE64_SYSCALL 1
74 # define __ASSUME_MMAP2_SYSCALL 1
75 # define __ASSUME_STAT64_SYSCALL 1
76 #endif
78 /* I know for sure that getrlimit are in 2.3.35 on powerpc. */
79 #if __LINUX_KERNEL_VERSION >= 131875 && defined __powerpc__
80 # define __ASSUME_NEW_GETRLIMIT_SYSCALL 1
81 #endif
83 /* I know for sure that these are in 2.3.35 on powerpc. But PowerPC64 does not
84 support separate 64-bit syscalls, already 64-bit. */
85 #if __LINUX_KERNEL_VERSION >= 131875 && defined __powerpc__ \
86 && !defined __powerpc64__
87 # define __ASSUME_TRUNCATE64_SYSCALL 1
88 # define __ASSUME_STAT64_SYSCALL 1
89 #endif
91 /* Linux 2.3.39 introduced 32bit UID/GIDs. Some platforms had 32
92 bit type all along. */
93 #if __LINUX_KERNEL_VERSION >= 131879 || defined __powerpc__
94 # define __ASSUME_32BITUIDS 1
95 #endif
97 /* Linux 2.3.39 sparc added setresuid. */
98 #if __LINUX_KERNEL_VERSION >= 131879 && defined __sparc__
99 # define __ASSUME_SETRESUID_SYSCALL 1
100 #endif
102 #if __LINUX_KERNEL_VERSION >= 131879
103 # define __ASSUME_SETRESGID_SYSCALL 1
104 #endif
106 /* Linux 2.3.39 introduced IPC64. Except for powerpc. */
107 #if __LINUX_KERNEL_VERSION >= 131879 && !defined __powerpc__
108 # define __ASSUME_IPC64 1
109 #endif
111 /* We can use the LDTs for threading with Linux 2.3.99 and newer. */
112 #if __LINUX_KERNEL_VERSION >= 131939
113 # define __ASSUME_LDT_WORKS 1
114 #endif
116 /* Linux 2.4.0 on PPC introduced a correct IPC64. But PowerPC64 does not
117 support a separate 64-bit syscall, already 64-bit. */
118 #if __LINUX_KERNEL_VERSION >= 132096 && defined __powerpc__ \
119 && !defined __powerpc64__
120 # define __ASSUME_IPC64 1
121 #endif
123 /* SH kernels got stat64, mmap2, and truncate64 during 2.4.0-test. */
124 #if __LINUX_KERNEL_VERSION >= 132096 && defined __sh__
125 # define __ASSUME_TRUNCATE64_SYSCALL 1
126 # define __ASSUME_MMAP2_SYSCALL 1
127 # define __ASSUME_STAT64_SYSCALL 1
128 #endif
130 /* The changed st_ino field appeared in 2.4.0-test6. But we cannot
131 distinguish this version from other 2.4.0 releases. Therefore play
132 save and assume it available is for 2.4.1 and up. However, SH is lame,
133 and still does not have a 64-bit inode field. */
134 #if __LINUX_KERNEL_VERSION >= 132097 && !defined __sh__
135 # define __ASSUME_ST_INO_64_BIT 1
136 #endif
138 /* To support locking of large files a new fcntl() syscall was introduced
139 in 2.4.0-test7. We test for 2.4.1 for the earliest version we know
140 the syscall is available. */
141 #if __LINUX_KERNEL_VERSION >= 132097 && (defined __i386__ || defined __sparc__)
142 # define __ASSUME_FCNTL64 1
143 #endif
145 /* The AT_CLKTCK auxiliary vector entry was introduction in the 2.4.0
146 series. */
147 #if __LINUX_KERNEL_VERSION >= 132097
148 # define __ASSUME_AT_CLKTCK 1
149 #endif
151 /* Arm got fcntl64 in 2.4.4, PowerPC and SH have it also in 2.4.4 (I
152 don't know when it got introduced). But PowerPC64 does not support
153 separate FCNTL64 call, FCNTL is already 64-bit */
154 #if __LINUX_KERNEL_VERSION >= 132100 \
155 && (defined __powerpc__ || defined __sh__) \
156 && !defined __powerpc64__
157 # define __ASSUME_FCNTL64 1
158 #endif
160 /* The getdents64 syscall was introduced in 2.4.0-test7. We test for
161 2.4.1 for the earliest version we know the syscall is available. */
162 #if __LINUX_KERNEL_VERSION >= 132097
163 # define __ASSUME_GETDENTS64_SYSCALL 1
164 #endif
166 /* When did O_DIRECTORY become available? Early in 2.3 but when?
167 Be safe, use 2.3.99. */
168 #if __LINUX_KERNEL_VERSION >= 131939
169 # define __ASSUME_O_DIRECTORY 1
170 #endif
172 /* Starting with one of the 2.4.0 pre-releases the Linux kernel passes
173 up the page size information. */
174 #if __LINUX_KERNEL_VERSION >= 132097
175 # define __ASSUME_AT_PAGESIZE 1
176 #endif
178 /* Starting with at least 2.4.0 the kernel passes the uid/gid unconditionally
179 up to the child. */
180 #if __LINUX_KERNEL_VERSION >= 132097
181 # define __ASSUME_AT_XID 1
182 #endif
184 /* Starting with 2.4.5 kernels PPC passes the AUXV in the standard way
185 and the vfork syscall made it into the official kernel. */
186 #if __LINUX_KERNEL_VERSION >= (132096+5) && defined __powerpc__
187 # define __ASSUME_STD_AUXV 1
188 # define __ASSUME_VFORK_SYSCALL 1
189 #endif
191 /* Starting with 2.4.5 kernels the mmap2 syscall made it into the official
192 kernel. But PowerPC64 does not support a separate MMAP2 call. */
193 #if __LINUX_KERNEL_VERSION >= (132096+5) && defined __powerpc__ \
194 && !defined __powerpc64__
195 # define __ASSUME_MMAP2_SYSCALL 1
196 #endif
198 /* Starting with 2.4.21 PowerPC implements the new prctl syscall.
199 This allows applications to get/set the Floating Point Exception Mode. */
200 #if __LINUX_KERNEL_VERSION >= (132096+21) && defined __powerpc__
201 # define __ASSUME_NEW_PRCTL_SYSCALL 1
202 #endif
204 /* Starting with 2.4.21 the PowerPC32 clone syscall works as expected. */
205 #if __LINUX_KERNEL_VERSION >= (132096+21) && defined __powerpc__ \
206 && !defined __powerpc64__
207 # define __ASSUME_FIXED_CLONE_SYSCALL 1
208 #endif
210 /* Starting with 2.4.21 PowerPC64 implements the new rt_sigreturn syscall.
211 The new rt_sigreturn takes an ucontext pointer allowing rt_sigreturn
212 to be used in the set/swapcontext implementation. */
213 #if __LINUX_KERNEL_VERSION >= (132096+21) && defined __powerpc64__
214 # define __ASSUME_NEW_RT_SIGRETURN_SYSCALL 1
215 #endif
217 /* On x86, the set_thread_area syscall was introduced in 2.5.29, but its
218 semantics was changed in 2.5.30, and again after 2.5.31. */
219 #if __LINUX_KERNEL_VERSION >= 132384 && defined __i386__
220 # define __ASSUME_SET_THREAD_AREA_SYSCALL 1
221 #endif
223 /* The vfork syscall on x86 and arm was definitely available in 2.4. */
224 #if __LINUX_KERNEL_VERSION >= 132097 && defined __i386__
225 # define __ASSUME_VFORK_SYSCALL 1
226 #endif
228 /* The late 2.5 kernels saw a lot of new CLONE_* flags. Summarize
229 their availability with one define. The changes were made first
230 for i386 and the have to be done separately for the other archs.
231 For i386 we pick 2.5.50 as the first version with support.
232 For s390*, SPARC, PPC, x86-64, and SH we pick 2.5.64 as the first
233 version with support. */
234 #if ((__LINUX_KERNEL_VERSION >= 132402 && defined __i386__) \
235 || (__LINUX_KERNEL_VERSION >= 132416 \
236 && (defined __s390__ || defined __sparc__ \
237 || defined __powerpc__ || defined __x86_64__ || defined __sh__)))
238 # define __ASSUME_CLONE_THREAD_FLAGS 1
239 #endif
241 /* Beginning with 2.5.63 support for realtime and monotonic clocks and
242 timers based on them is available. */
243 #if __LINUX_KERNEL_VERSION >= 132415
244 # define __ASSUME_POSIX_TIMERS 1
245 #endif
247 /* Beginning with 2.6.12 the clock and timer supports CPU clocks. */
248 #if __LINUX_KERNEL_VERSION >= 0x2060c
249 # define __ASSUME_POSIX_CPU_TIMERS 1
250 #endif
252 /* With kernel 2.4.17 we always have netlink support. */
253 #if __LINUX_KERNEL_VERSION >= (132096+17)
254 # define __ASSUME_NETLINK_SUPPORT 1
255 #endif
257 /* The requeue futex functionality was introduced in 2.5.70. */
258 #if __LINUX_KERNEL_VERSION >= 132422
259 # define __ASSUME_FUTEX_REQUEUE 1
260 #endif
262 /* The statfs64 syscalls are available in 2.5.74. */
263 #if __LINUX_KERNEL_VERSION >= 132426
264 # define __ASSUME_STATFS64 1
265 #endif
267 /* Starting with at least 2.5.74 the kernel passes the setuid-like exec
268 flag unconditionally up to the child. */
269 #if __LINUX_KERNEL_VERSION >= 132426
270 # define __ASSUME_AT_SECURE 1
271 #endif
273 /* Starting with the 2.5.75 kernel the kernel fills in the correct value
274 in the si_pid field passed as part of the siginfo_t struct to signal
275 handlers. */
276 #if __LINUX_KERNEL_VERSION >= 132427
277 # define __ASSUME_CORRECT_SI_PID 1
278 #endif
280 /* The tgkill syscall was instroduced for i386 in 2.5.75. On x86-64,
281 sparc, SH, ppc, and ppc64 it was introduced in 2.6.0-test3. */
282 #if (__LINUX_KERNEL_VERSION >= 132427 && defined __i386__) \
283 || (__LINUX_KERNEL_VERSION >= 132609 \
284 && (defined __x86_64__ || defined __powerpc__ \
285 || defined __sh__ || defined __sparc__))
286 # define __ASSUME_TGKILL 1
287 #endif
289 /* The utimes syscall has been available for some architectures
290 forever. For x86 it was introduced after 2.5.75, for x86-64,
291 ppc, and ppc64 it was introduced in 2.6.0-test3. */
292 #if defined __sparc__ \
293 || (__LINUX_KERNEL_VERSION > 132427 && defined __i386__) \
294 || (__LINUX_KERNEL_VERSION > 132609 && defined __x86_64__) \
295 || (__LINUX_KERNEL_VERSION >= 132609 && defined __powerpc__) \
296 || (__LINUX_KERNEL_VERSION >= 132609 && defined __sh__)
297 # define __ASSUME_UTIMES 1
298 #endif
300 // XXX Disabled for now since the semantics we want is not achieved.
301 #if 0
302 /* The CLONE_STOPPED flag was introduced in the 2.6.0-test1 series. */
303 #if __LINUX_KERNEL_VERSION >= 132609
304 # define __ASSUME_CLONE_STOPPED 1
305 #endif
306 #endif
308 /* The fixed version of the posix_fadvise64 syscall appeared in
309 2.6.0-test3. At least for x86 and sparc. Powerpc support appeared
310 in 2.6.2, but for 32-bit userspace only. */
311 #if (__LINUX_KERNEL_VERSION >= 132609 \
312 && (defined __i386__ || defined __sparc__)) \
313 || (__LINUX_KERNEL_VERSION >= 132610 && defined __powerpc__ \
314 && !defined __powerpc64__)
315 # define __ASSUME_FADVISE64_64_SYSCALL 1
316 #endif
318 /* The PROT_GROWSDOWN/PROT_GROWSUP flags were introduced in the 2.6.0-test
319 series. */
320 #if __LINUX_KERNEL_VERSION >= 132609
321 # define __ASSUME_PROT_GROWSUPDOWN 1
322 #endif
324 /* Starting with 2.6.0 PowerPC adds signal/swapcontext support for Vector
325 SIMD (AKA Altivec, VMX) instructions and register state. This changes
326 the overall size of the sigcontext and adds the swapcontext syscall. */
327 #if __LINUX_KERNEL_VERSION >= 132608 && defined __powerpc__
328 # define __ASSUME_SWAPCONTEXT_SYSCALL 1
329 #endif
331 /* The CLONE_DETACHED flag is not necessary in 2.6.2 kernels, it is
332 implied. */
333 #if __LINUX_KERNEL_VERSION >= 132610
334 # define __ASSUME_NO_CLONE_DETACHED 1
335 #endif
337 /* Starting with version 2.6.4-rc1 the getdents syscall returns d_type
338 information as well and in between 2.6.5 and 2.6.8 most compat wrappers
339 were fixed too. Except s390{,x} which was fixed in 2.6.11. */
340 #if (__LINUX_KERNEL_VERSION >= 0x020608 && !defined __s390__) \
341 || (__LINUX_KERNEL_VERSION >= 0x02060b && defined __s390__)
342 # define __ASSUME_GETDENTS32_D_TYPE 1
343 #endif
345 /* Starting with version 2.5.3, the initial location returned by `brk'
346 after exec is always rounded up to the next page. */
347 #if __LINUX_KERNEL_VERSION >= 132355
348 # define __ASSUME_BRK_PAGE_ROUNDED 1
349 #endif
351 /* Starting with version 2.6.9, the waitid system call is available.
352 Except for powerpc{,64} and s390{,x}, where it is available in 2.6.12. */
353 #if (__LINUX_KERNEL_VERSION >= 0x020609 \
354 && !defined __powerpc__ && !defined __s390__) \
355 || (__LINUX_KERNEL_VERSION >= 0x02060c \
356 && (defined __powerpc__ || defined __s390__))
357 # define __ASSUME_WAITID_SYSCALL 1
358 #endif
360 /* On sparc64 stat64/lstat64/fstat64 syscalls were introduced in 2.6.12. */
361 #if __LINUX_KERNEL_VERSION >= 0x02060c && defined __sparc__ \
362 && defined __arch64__
363 # define __ASSUME_STAT64_SYSCALL 1
364 #endif
366 /* Early kernel used "shm" as the filesystem name for the filesystem used
367 for shm_open etc. Later it is "tmpfs". 2.4.20 is a safe bet for the
368 cutover. */
369 #if __LINUX_KERNEL_VERSION >= 0x02041a
370 # define __ASSUME_TMPFS_NAME 1
371 #endif
373 /* pselect/ppoll were introduced just after 2.6.16-rc1. Due to the way
374 the kernel versions are advertised we can only rely on 2.6.17 to have
375 the code. On x86_64 and SH this appeared first in 2.6.19-rc1,
376 on ia64 in 2.6.22-rc1. */
377 #if __LINUX_KERNEL_VERSION >= 0x020611 \
378 && ((!defined __x86_64__ && !defined __sh__) \
379 || (__LINUX_KERNEL_VERSION >= 0x020613 \
380 && (defined __x86_64__ || defined __sh__)))
381 # define __ASSUME_PSELECT 1
382 # define __ASSUME_PPOLL 1
383 #endif
385 /* The *at syscalls were introduced just after 2.6.16-rc1. Due to the way the
386 kernel versions are advertised we can only rely on 2.6.17 to have
387 the code. On PPC they were introduced in 2.6.17-rc1,
388 on SH in 2.6.19-rc1. */
389 #if __LINUX_KERNEL_VERSION >= 0x020611 \
390 && (!defined __sh__ || __LINUX_KERNEL_VERSION >= 0x020613)
391 # define __ASSUME_ATFCTS 1
392 #endif
394 /* Support for inter-process robust mutexes was added in 2.6.17. */
395 #if __LINUX_KERNEL_VERSION >= 0x020611 \
396 && (!defined __sh__ || __LINUX_KERNEL_VERSION >= 0x020613)
397 # define __ASSUME_SET_ROBUST_LIST 1
398 #endif
400 /* Pessimistically assume that 2.6.18 introduced real handling of
401 large numbers of requests to readv and writev and that we don't
402 need a fallback. It likely worked for much longer. */
403 #if __LINUX_KERNEL_VERSION >= 0x020612
404 # define __ASSUME_COMPLETE_READV_WRITEV 1
405 #endif
407 /* Support for PI futexes was added in 2.6.18. */
408 #if __LINUX_KERNEL_VERSION >= 0x020612
409 # define __ASSUME_FUTEX_LOCK_PI 1
410 #endif
412 /* Support for utimensat syscall was added in 2.6.22, on SH
413 only after 2.6.22-rc1. */
414 #if __LINUX_KERNEL_VERSION >= 0x020616 \
415 && (!defined __sh__ || __LINUX_KERNEL_VERSION >= 0x020617)
416 # define __ASSUME_UTIMENSAT 1
417 #endif
419 /* Support for private futexes was added in 2.6.22. */
420 #if __LINUX_KERNEL_VERSION >= 0x020616
421 # define __ASSUME_PRIVATE_FUTEX 1
422 #endif
424 /* Support for fallocate was added in 2.6.23, on s390
425 only after 2.6.23-rc1. */
426 #if __LINUX_KERNEL_VERSION >= 0x020617 \
427 && (!defined __s390__ || __LINUX_KERNEL_VERSION >= 0x020618)
428 # define __ASSUME_FALLOCATE 1
429 #endif
431 /* Support for various CLOEXEC and NONBLOCK flags was added for x86,
432 x86-64, PPC, IA-64, SPARC< and S390 in 2.6.23. */
433 #if __LINUX_KERNEL_VERSION >= 0x020617 \
434 && (defined __i386__ || defined __x86_64__ || defined __powerpc__ \
435 || defined __sparc__ || defined __s390__)
436 # define __ASSUME_O_CLOEXEC 1
437 #endif
439 /* Support for ADJ_OFFSET_SS_READ was added in 2.6.24. */
440 #if __LINUX_KERNEL_VERSION >= 0x020618
441 # define __ASSUME_ADJ_OFFSET_SS_READ 1
442 #endif
444 /* Support for various CLOEXEC and NONBLOCK flags was added for x86,
445 x86-64, PPC, IA-64, and SPARC in 2.6.27. */
446 #if __LINUX_KERNEL_VERSION >= 0x02061b \
447 && (defined __i386__ || defined __x86_64__ || defined __powerpc__ \
448 || defined __sparc__ || defined __s390__)
449 # define __ASSUME_SOCK_CLOEXEC 1
450 # define __ASSUME_IN_NONBLOCK 1
451 # define __ASSUME_PIPE2 1
452 # define __ASSUME_EVENTFD2 1
453 # define __ASSUME_SIGNALFD4 1
454 # define __ASSUME_DUP3 1
455 #endif
457 /* Support for the accept4 syscall was added in 2.6.28. */
458 #if __LINUX_KERNEL_VERSION >= 0x02061c \
459 && (defined __i386__ || defined __x86_64__ || defined __powerpc__ \
460 || defined __sparc__ || defined __s390__)
461 # define __ASSUME_ACCEPT4 1
462 #endif
464 /* Support for the FUTEX_CLOCK_REALTIME flag was added in 2.6.29. */
465 #if __LINUX_KERNEL_VERSION >= 0x02061d
466 # define __ASSUME_FUTEX_CLOCK_REALTIME 1
467 #endif
469 /* Support for the AT_RANDOM auxiliary vector entry was added in 2.6.29. */
470 #if __LINUX_KERNEL_VERSION >= 0x02061d
471 # define __ASSUME_AT_RANDOM 1
472 #endif
474 /* Support for preadv and pwritev was added in 2.6.30. */
475 #if __LINUX_KERNEL_VERSION >= 0x02061e
476 # define __ASSUME_PREADV 1
477 # define __ASSUME_PWRITEV 1
478 #endif
480 /* Support for F_GETOWN_EX was introduced in 2.6.32. */
481 #if __LINUX_KERNEL_VERSION >= 0x020620
482 # define __ASSUME_F_GETOWN_EX 1
483 #endif
485 /* Support for the recvmmsg syscall was added in 2.6.33. */
486 #if __LINUX_KERNEL_VERSION >= 0x020621
487 # define __ASSUME_RECVMMSG 1
488 #endif
490 /* statfs fills in f_flags since 2.6.36. */
491 #if __LINUX_KERNEL_VERSION >= 0x020624
492 # define __ASSUME_STATFS_F_FLAGS 1
493 #endif
495 /* prlimit64 is available in 2.6.36. */
496 #if __LINUX_KERNEL_VERSION >= 0x020624
497 # define __ASSUME_PRLIMIT64 1
498 #endif
500 /* sendmmsg is available in 2.6.39. */
501 #if __LINUX_KERNEL_VERSION >= 0x020627
502 # define __ASSUME_SENDMMSG 1
503 #endif
505 /* getcpu is a syscall for x86-64 since 3.1. */
506 #if defined __x86_64__ && __LINUX_KERNEL_VERSION >= 0x030100
507 # define __ASSUME_GETCPU_SYSCALL 1
508 #endif