pivot_root Linux system call

Swap the root mount in the caller’s mount namespace, moving the old root aside.

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

Number on each ABI Linux 7.3

pivot_root in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-641550x9bsys_pivot_rootsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:167Open
i3862170xd9sys_pivot_rootint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:232Open
AArch64410x29sys_pivot_rootsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:55Open
ARM EABI2180xdasys_pivot_rootsvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:236Open
RISC-V 64410x29sys_pivot_rootecalla7a0, a1, a2, a3, a4, a5syscall.tbl:55Open
LoongArch 64410x29sys_pivot_rootsyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:55Open
PowerPC 642030xcbsys_pivot_rootscr0r3, r4, r5, r6, r7, r8syscall.tbl:263Open
PowerPC 322030xcbsys_pivot_rootscr0r3, r4, r5, r6, r7, r8syscall.tbl:263Open
IBM Z (s390x)2170xd9sys_pivot_rootsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:176Open
MIPS o3242160x1078sys_pivot_rootsyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:230Open
MIPS n3261510x1807sys_pivot_rootsyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:161Open
MIPS n6451510x141fsys_pivot_rootsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:161Open

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_pivot_root(const char __user *new_root, const char __user *put_old);

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

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

Manual page

pivot_root(2)

Bundled kernel releases

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