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
| ABI | No. | Hex | Entry point | Instruction | NR | Argument locations | Kernel table | Interactive view |
|---|---|---|---|---|---|---|---|---|
| x86-64 | 155 | 0x9b | sys_pivot_root | syscall | rax | rdi, rsi, rdx, r10, r8, r9 | syscall_64.tbl:167 | Open |
| i386 | 217 | 0xd9 | sys_pivot_root | int 0x80 | eax | ebx, ecx, edx, esi, edi, ebp | syscall_32.tbl:232 | Open |
| AArch64 | 41 | 0x29 | sys_pivot_root | svc #0 | x8 | x0, x1, x2, x3, x4, x5 | syscall.tbl:55 | Open |
| ARM EABI | 218 | 0xda | sys_pivot_root | svc #0 | r7 | r0, r1, r2, r3, r4, r5 | syscall.tbl:236 | Open |
| RISC-V 64 | 41 | 0x29 | sys_pivot_root | ecall | a7 | a0, a1, a2, a3, a4, a5 | syscall.tbl:55 | Open |
| LoongArch 64 | 41 | 0x29 | sys_pivot_root | syscall 0 | a7 | a0, a1, a2, a3, a4, a5 | syscall.tbl:55 | Open |
| PowerPC 64 | 203 | 0xcb | sys_pivot_root | sc | r0 | r3, r4, r5, r6, r7, r8 | syscall.tbl:263 | Open |
| PowerPC 32 | 203 | 0xcb | sys_pivot_root | sc | r0 | r3, r4, r5, r6, r7, r8 | syscall.tbl:263 | Open |
| IBM Z (s390x) | 217 | 0xd9 | sys_pivot_root | svc 0 | r1 | r2, r3, r4, r5, r6, r7 | syscall.tbl:176 | Open |
| MIPS o32 | 4216 | 0x1078 | sys_pivot_root | syscall | v0 | a0, a1, a2, a3, Stack (5), Stack (6) | syscall_o32.tbl:230 | Open |
| MIPS n32 | 6151 | 0x1807 | sys_pivot_root | syscall | v0 | a0, a1, a2, a3, a4, a5 | syscall_n32.tbl:161 | Open |
| MIPS n64 | 5151 | 0x141f | sys_pivot_root | syscall | v0 | a0, a1, a2, a3, a4, a5 | syscall_n64.tbl:161 | Open |
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
Bundled kernel releases
| Release | ABIs bundled | Defined in the table of |
|---|---|---|
| Linux 7.3 | 12 | all 12 |
| Linux 6.18 | 12 | all 12 |
| Linux 6.12 | 12 | all 12 |
| Linux 6.6 | 12 | all 12 |
| Linux 5.19 | 12 | all 12 |
| Linux 4.15 | 5 | all 5 |
| Linux 3.7 | 4 | all 4 |
| Linux 3.0 | 3 | all 3 |
| Linux 2.6.24 | 3 | all 3 |
| Linux 2.6.16 | 3 | all 3 |
| Linux 2.6.12 | 2 | all 2 |
| Linux 1.0 | 1 | none |
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.