dup3 Linux system call

Duplicate onto a chosen descriptor number and optionally set close-on-exec.

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

Number on each ABI Linux 7.3

dup3 in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-642920x124sys_dup3syscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:304Open
i3863300x14asys_dup3int 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:345Open
AArch64240x18sys_dup3svc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:36Open
ARM EABI3580x166sys_dup3svc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:376Open
RISC-V 64240x18sys_dup3ecalla7a0, a1, a2, a3, a4, a5syscall.tbl:36Open
LoongArch 64240x18sys_dup3syscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:36Open
PowerPC 643160x13csys_dup3scr0r3, r4, r5, r6, r7, r8syscall.tbl:416Open
PowerPC 323160x13csys_dup3scr0r3, r4, r5, r6, r7, r8syscall.tbl:416Open
IBM Z (s390x)3260x146sys_dup3svc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:280Open
MIPS o3243270x10e7sys_dup3syscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:341Open
MIPS n3262900x1892sys_dup3syscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:301Open
MIPS n6452860x14a6sys_dup3syscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:297Open

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_dup3(unsigned int oldfd, unsigned int newfd, 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:400

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

Manual page

dup(2)

Bundled kernel releases

Bundled releases whose tables define dup3
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.155all 5
Linux 3.74all 4
Linux 3.03all 3
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.