glibc/sysdeps/unix/sysv/linux/kernel-features.h
Paul Eggert 581c785bf3 Update copyright dates with scripts/update-copyrights
I used these shell commands:

../glibc/scripts/update-copyrights $PWD/../gnulib/build-aux/update-copyright
(cd ../glibc && git commit -am"[this commit message]")

and then ignored the output, which consisted lines saying "FOO: warning:
copyright statement not found" for each of 7061 files FOO.

I then removed trailing white space from math/tgmath.h,
support/tst-support-open-dev-null-range.c, and
sysdeps/x86_64/multiarch/strlen-vec.S, to work around the following
obscure pre-commit check failure diagnostics from Savannah.  I don't
know why I run into these diagnostics whereas others evidently do not.

remote: *** 912-#endif
remote: *** 913:
remote: *** 914-
remote: *** error: lines with trailing whitespace found
...
remote: *** error: sysdeps/unix/sysv/linux/statx_cp.c: trailing lines
2022-01-01 11:40:24 -08:00

240 lines
8.6 KiB
C

/* Set flags signalling availability of kernel features based on given
kernel version number.
Copyright (C) 1999-2022 Free Software Foundation, Inc.
This file is part of the GNU C Library.
The GNU C Library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
The GNU C Library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with the GNU C Library; if not, see
<https://www.gnu.org/licenses/>. */
/* This file must not contain any C code. At least it must be protected
to allow using the file also in assembler files. */
#ifndef _LINUX_KERNEL_FEATURES_H
#define _LINUX_KERNEL_FEATURES_H 1
#include <bits/wordsize.h>
#ifndef __LINUX_KERNEL_VERSION
/* We assume the worst; all kernels should be supported. */
# define __LINUX_KERNEL_VERSION 0
#endif
/* We assume for __LINUX_KERNEL_VERSION the same encoding used in
linux/version.h. I.e., the major, minor, and subminor all get a
byte with the major number being in the highest byte. This means
we can do numeric comparisons.
In the following we will define certain symbols depending on
whether the describes kernel feature is available in the kernel
version given by __LINUX_KERNEL_VERSION. We are not always exactly
recording the correct versions in which the features were
introduced. If somebody cares these values can afterwards be
corrected. */
/* The statfs64 syscalls are available in 2.5.74 (but not for alpha). */
#define __ASSUME_STATFS64 1
/* pselect/ppoll were introduced just after 2.6.16-rc1. On x86_64 and
SH this appeared first in 2.6.19-rc1, on ia64 in 2.6.22-rc1. */
#define __ASSUME_PSELECT 1
/* Support for inter-process robust mutexes was added in 2.6.17 (but
some architectures lack futex_atomic_cmpxchg_inatomic in some
configurations). */
#define __ASSUME_SET_ROBUST_LIST 1
/* Support for various CLOEXEC and NONBLOCK flags was added in
2.6.27. */
#define __ASSUME_IN_NONBLOCK 1
/* Support for preadv and pwritev was added in 2.6.30. */
#define __ASSUME_PREADV 1
#define __ASSUME_PWRITEV 1
/* Support for sendmmsg functionality was added in 3.0. */
#define __ASSUME_SENDMMSG 1
/* On most architectures, most socket syscalls are supported for all
supported kernel versions, but on some socketcall architectures
separate syscalls were only added later. */
#define __ASSUME_SENDMSG_SYSCALL 1
#define __ASSUME_RECVMSG_SYSCALL 1
#define __ASSUME_ACCEPT_SYSCALL 1
#define __ASSUME_CONNECT_SYSCALL 1
#define __ASSUME_RECVFROM_SYSCALL 1
#define __ASSUME_SENDTO_SYSCALL 1
#define __ASSUME_ACCEPT4_SYSCALL 1
#define __ASSUME_RECVMMSG_SYSCALL 1
#define __ASSUME_SENDMMSG_SYSCALL 1
#define __ASSUME_GETSOCKOPT_SYSCALL 1
#define __ASSUME_SETSOCKOPT_SYSCALL 1
/* Support for SysV IPC through wired syscalls. All supported architectures
either support ipc syscall and/or all the ipc correspondent syscalls. */
#define __ASSUME_DIRECT_SYSVIPC_SYSCALLS 1
/* The generic default __IPC_64 value is 0x0, however some architectures
require a different value of 0x100. */
#define __ASSUME_SYSVIPC_DEFAULT_IPC_64 1
/* All supported architectures reserve a 32-bit for MODE field in sysvipc
ipc_perm. However, some kernel ABI interfaces still expect a 16-bit
field. This is only an issue if arch-defined IPC_PERM padding is on a
wrong position regarding endianness. In this case, the IPC control
routines (msgctl, semctl, and semtctl) requires to shift the value to
correct place.
The ABIs that requires it define __ASSUME_SYSVIPC_BROKEN_MODE_T. */
/* Support for p{read,write}v2 was added in 4.6. However Linux default
implementation does not assume the __ASSUME_* and instead use a fallback
implementation based on p{read,write}v and returning an error for
non supported flags. */
/* Support for the renameat2 system call was added in kernel 3.15. */
#if __LINUX_KERNEL_VERSION >= 0x030F00
# define __ASSUME_RENAMEAT2
#endif
/* Support for the execveat syscall was added in 3.19. */
#if __LINUX_KERNEL_VERSION >= 0x031300
# define __ASSUME_EXECVEAT 1
#endif
#if __LINUX_KERNEL_VERSION >= 0x040400
# define __ASSUME_MLOCK2 1
#endif
/* Support for statx was added in kernel 4.11. */
#if __LINUX_KERNEL_VERSION >= 0x040B00
# define __ASSUME_STATX 1
#endif
/* Support for clone call used on fork. The signature varies across the
architectures with current 4 different variants:
1. long int clone (unsigned long flags, unsigned long newsp,
int *parent_tidptr, unsigned long tls,
int *child_tidptr)
2. long int clone (unsigned long newsp, unsigned long clone_flags,
int *parent_tidptr, int * child_tidptr,
unsigned long tls)
3. long int clone (unsigned long flags, unsigned long newsp,
int stack_size, int *parent_tidptr,
int *child_tidptr, unsigned long tls)
4. long int clone (unsigned long flags, unsigned long newsp,
int *parent_tidptr, int *child_tidptr,
unsigned long tls)
The fourth variant is intended to be used as the default for newer ports,
Also IA64 uses the third variant but with __NR_clone2 instead of
__NR_clone.
The macros names to define the variant used for the architecture is
similar to kernel:
- __ASSUME_CLONE_BACKWARDS: for variant 1.
- __ASSUME_CLONE_BACKWARDS2: for variant 2 (s390).
- __ASSUME_CLONE_BACKWARDS3: for variant 3 (microblaze).
- __ASSUME_CLONE_DEFAULT: for variant 4.
- __ASSUME_CLONE2: for clone2 with variant 3 (ia64).
*/
#define __ASSUME_CLONE_DEFAULT 1
/* Support for 64-bit time_t in the system call interface. When this
flag is set, the kernel provides a version of each of these system
calls that accepts 64-bit time_t:
clock_adjtime(64)
clock_gettime(64)
clock_settime(64)
clock_getres(_time64)
clock_nanosleep(_time64)
futex(_time64)
mq_timedreceive(_time64)
mq_timedsend(_time64)
ppoll(_time64)
pselect6(_time64)
rt_sigtimedwait(_time64)
sched_rr_get_interval(_time64)
timer_gettime(64)
timer_settime(64)
timerfd_gettime(64)
timerfd_settime(64)
utimensat(_time64)
On architectures where time_t has historically been 64 bits,
only the 64-bit version of each system call exists, and there
are no suffixes on the __NR_ constants.
On architectures where time_t has historically been 32 bits,
both 32-bit and 64-bit versions of each system call may exist,
depending on the kernel version. When the 64-bit version exists,
there is a '64' or '_time64' suffix on the name of its __NR_
constant, as shown above.
This flag is always set for Linux 5.1 and later. Prior to that
version, it is set only for some CPU architectures and ABIs:
- __WORDSIZE == 64 - all supported architectures where pointers
are 64 bits also have always had 64-bit time_t.
- __WORDSIZE == 32 && __SYSCALL_WORDSIZE == 64 - this describes
only one supported configuration, x86's 'x32' subarchitecture,
where pointers are 32 bits but time_t has always been 64 bits.
__ASSUME_TIME64_SYSCALLS being set does not mean __TIMESIZE is 64,
and __TIMESIZE equal to 64 does not mean __ASSUME_TIME64_SYSCALLS
is set. All four cases are possible. */
#if __LINUX_KERNEL_VERSION >= 0x050100 \
|| __WORDSIZE == 64 \
|| (defined __SYSCALL_WORDSIZE && __SYSCALL_WORDSIZE == 64)
# define __ASSUME_TIME64_SYSCALLS 1
#endif
/* Linux waitid prior kernel 5.4 does not support waiting for the current
process group. */
#if __LINUX_KERNEL_VERSION >= 0x050400
# define __ASSUME_WAITID_PID0_P_PGID
#endif
/* The faccessat2 system call was introduced across all architectures
in Linux 5.8. */
#if __LINUX_KERNEL_VERSION >= 0x050800
# define __ASSUME_FACCESSAT2 1
#else
# define __ASSUME_FACCESSAT2 0
#endif
/* The close_range system call was introduced across all architectures
in Linux 5.9. */
#if __LINUX_KERNEL_VERSION >= 0x050900
# define __ASSUME_CLOSE_RANGE 1
#else
# define __ASSUME_CLOSE_RANGE 0
#endif
/* The FUTEX_LOCK_PI2 operation was introduced across all architectures in Linux
5.14. */
#if __LINUX_KERNEL_VERSION >= 0x050e00
# define __ASSUME_FUTEX_LOCK_PI2 1
#else
# define __ASSUME_FUTEX_LOCK_PI2 0
#endif
#endif /* kernel-features.h */