chroot Linux system call

Change the root directory used to resolve paths beginning with a slash.

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

Number on each ABI Linux 7.3

chroot in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-641610xa1sys_chrootsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:173Open
i386610x3dsys_chrootint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:76Open
AArch64510x33sys_chrootsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:69Open
ARM EABI610x3dsys_chrootsvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:76Open
RISC-V 64510x33sys_chrootecalla7a0, a1, a2, a3, a4, a5syscall.tbl:69Open
LoongArch 64510x33sys_chrootsyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:69Open
PowerPC 64610x3dsys_chrootscr0r3, r4, r5, r6, r7, r8syscall.tbl:84Open
PowerPC 32610x3dsys_chrootscr0r3, r4, r5, r6, r7, r8syscall.tbl:84Open
IBM Z (s390x)610x3dsys_chrootsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:50Open
MIPS o3240610xfddsys_chrootsyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:73Open
MIPS n3261560x180csys_chrootsyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:166Open
MIPS n6451560x1424sys_chrootsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:166Open

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_chroot(const char __user *filename);

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

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

Manual page

chroot(2)

Bundled kernel releases

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