close_range Linux system call

Close or mark close-on-exec for a range of file descriptors in one call.

In Linux 7.3, close_range is defined in the system call table of 12 of the 12 bundled ABIs.

Number on each ABI Linux 7.3

close_range in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-644360x1b4sys_close_rangesyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:363Open
i3864360x1b4sys_close_rangeint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:444Open
AArch644360x1b4sys_close_rangesvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:379Open
ARM EABI4360x1b4sys_close_rangesvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:453Open
RISC-V 644360x1b4sys_close_rangeecalla7a0, a1, a2, a3, a4, a5syscall.tbl:379Open
LoongArch 644360x1b4sys_close_rangesyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:379Open
PowerPC 644360x1b4sys_close_rangescr0r3, r4, r5, r6, r7, r8syscall.tbl:529Open
PowerPC 324360x1b4sys_close_rangescr0r3, r4, r5, r6, r7, r8syscall.tbl:529Open
IBM Z (s390x)4360x1b4sys_close_rangesvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:365Open
MIPS o3244360x1154sys_close_rangesyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:426Open
MIPS n3264360x1924sys_close_rangesyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:377Open
MIPS n6454360x153csys_close_rangesyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:353Open

Argument locations are the ABI’s calling convention for ARG1–ARG6 in order, not an assignment made for this call. On 32-bit ABIs, 64-bit values may occupy multiple registers and require alignment; assembly wrappers may reorder them. See syscall(2). A table entry does not mean the call exists in every kernel: most optional calls return ENOSYS when the matching configuration option or architecture support is not built.

Kernel declaration

asmlinkage long sys_close_range(unsigned int fd, unsigned int max_fd, unsigned int flags);

x86-64, i386, AArch64, ARM EABI, RISC-V 64, LoongArch 64, PowerPC 64, PowerPC 32, IBM Z (s390x), MIPS o32, MIPS n32, MIPS n64 · Declaration: include/linux/syscalls.h:474

Signatures are kernel declarations and may differ from the C library wrappers.

Manual page

close_range(2)

Bundled kernel releases

Bundled releases whose tables define close_range
ReleaseABIs bundledDefined in the table of
Linux 7.312all 12
Linux 6.1812all 12
Linux 6.1212all 12
Linux 6.612all 12
Linux 5.1912all 12
Linux 4.155none
Linux 3.74none
Linux 3.03none
Linux 2.6.243none
Linux 2.6.163none
Linux 2.6.122none
Linux 1.01none

Each release is a separate snapshot, and older releases bundle fewer ABIs. This table does not claim the release in which the call first appeared. Numbers are listed where a release differs from Linux 7.3.