renameat2 Linux system call

Rename relative to directory descriptors, with options such as exchange or no replacement.

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

Number on each ABI Linux 7.3

renameat2 in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-643160x13csys_renameat2syscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:328Open
i3863530x161sys_renameat2int 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:368Open
AArch642760x114sys_renameat2svc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:326Open
ARM EABI3820x17esys_renameat2svc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:400Open
RISC-V 642760x114sys_renameat2ecalla7a0, a1, a2, a3, a4, a5syscall.tbl:326Open
LoongArch 642760x114sys_renameat2syscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:326Open
PowerPC 643570x165sys_renameat2scr0r3, r4, r5, r6, r7, r8syscall.tbl:461Open
PowerPC 323570x165sys_renameat2scr0r3, r4, r5, r6, r7, r8syscall.tbl:461Open
IBM Z (s390x)3470x15bsys_renameat2svc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:301Open
MIPS o3243510x10ffsys_renameat2syscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:365Open
MIPS n3263150x18absys_renameat2syscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:326Open
MIPS n6453110x14bfsys_renameat2syscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:322Open

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_renameat2(int olddfd, const char __user *oldname, int newdfd, const char __user *newname, 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:936

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

Manual page

rename(2)

Bundled kernel releases

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