dup2 Linux system call

Duplicate a descriptor onto a chosen number, replacing the target if needed.

In Linux 7.3, dup2 is defined in the system call table of 9 of the 12 bundled ABIs. It has no table entry on: AArch64, RISC-V 64, LoongArch 64.

Number on each ABI Linux 7.3

dup2 in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-64330x21sys_dup2syscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:45Open
i386630x3fsys_dup2int 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:78Open
AArch64Not in the Linux 7.3 table for this ABI.
ARM EABI630x3fsys_dup2svc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:78Open
RISC-V 64Not in the Linux 7.3 table for this ABI.
LoongArch 64Not in the Linux 7.3 table for this ABI.
PowerPC 64630x3fsys_dup2scr0r3, r4, r5, r6, r7, r8syscall.tbl:86Open
PowerPC 32630x3fsys_dup2scr0r3, r4, r5, r6, r7, r8syscall.tbl:86Open
IBM Z (s390x)630x3fsys_dup2svc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:52Open
MIPS o3240630xfdfsys_dup2syscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:75Open
MIPS n3260320x1790sys_dup2syscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:42Open
MIPS n6450320x13a8sys_dup2syscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:42Open

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_dup2(unsigned int oldfd, unsigned int newfd);

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

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

Manual page

dup(2)

Bundled kernel releases

Bundled releases whose tables define dup2
ReleaseABIs bundledDefined in the table of
Linux 7.312x86-64 · i386 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64
Linux 6.1812x86-64 · i386 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64
Linux 6.1212x86-64 · i386 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64
Linux 6.612x86-64 · i386 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64
Linux 5.1912x86-64 · i386 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64
Linux 4.155x86-64 · i386 · ARM EABI
Linux 3.74x86-64 · i386 · ARM EABI
Linux 3.03all 3
Linux 2.6.243all 3
Linux 2.6.163all 3
Linux 2.6.122all 2
Linux 1.01all 1

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.