renameat Linux system call

Rename a path using directory descriptors to resolve relative names.

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

Number on each ABI Linux 7.3

renameat in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-642640x108sys_renameatsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:276Open
i3863020x12esys_renameatint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:317Open
AArch64380x26sys_renameatsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:52Open
ARM EABI3290x149sys_renameatsvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:347Open
RISC-V 64Not in the Linux 7.3 table for this ABI.
LoongArch 64Not in the Linux 7.3 table for this ABI.
PowerPC 642930x125sys_renameatscr0r3, r4, r5, r6, r7, r8syscall.tbl:384Open
PowerPC 322930x125sys_renameatscr0r3, r4, r5, r6, r7, r8syscall.tbl:384Open
IBM Z (s390x)2950x127sys_renameatsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:249Open
MIPS o3242950x10c7sys_renameatsyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:309Open
MIPS n3262580x1872sys_renameatsyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:269Open
MIPS n6452540x1486sys_renameatsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:265Open

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_renameat(int olddfd, const char __user * oldname, int newdfd, const char __user * newname);

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

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

Manual page

rename(2)

Bundled kernel releases

Bundled releases whose tables define renameat
ReleaseABIs bundledDefined in the table of
Linux 7.312x86-64 · i386 · AArch64 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64
Linux 6.1812x86-64 · i386 · AArch64 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64
Linux 6.1212x86-64 · i386 · AArch64 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64
Linux 6.612x86-64 · i386 · AArch64 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64
Linux 5.1912x86-64 · i386 · AArch64 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64
Linux 4.155x86-64 · i386 · AArch64 · ARM EABI
Linux 3.74all 4
Linux 3.03all 3
Linux 2.6.243all 3
Linux 2.6.163x86-64 · i386
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.