dup Linux system call

Make a new descriptor that shares the same open file, including its current position.

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

Number on each ABI Linux 7.3

dup in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-64320x20sys_dupsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:44Open
i386410x29sys_dupint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:56Open
AArch64230x17sys_dupsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:35Open
ARM EABI410x29sys_dupsvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:56Open
RISC-V 64230x17sys_dupecalla7a0, a1, a2, a3, a4, a5syscall.tbl:35Open
LoongArch 64230x17sys_dupsyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:35Open
PowerPC 64410x29sys_dupscr0r3, r4, r5, r6, r7, r8syscall.tbl:62Open
PowerPC 32410x29sys_dupscr0r3, r4, r5, r6, r7, r8syscall.tbl:62Open
IBM Z (s390x)410x29sys_dupsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:39Open
MIPS o3240410xfc9sys_dupsyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:53Open
MIPS n3260310x178fsys_dupsyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:41Open
MIPS n6450310x13a7sys_dupsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:41Open

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_dup(unsigned int fildes);

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:399

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

Manual page

dup(2)

Bundled kernel releases

Bundled releases whose tables define dup
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.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.