chroot(1)

chroot1

Run command or interactive shell with special root directory

Usage

chroot [OPTION] ... NEWROOT [COMMAND [ARG] ...]

Overview

Run COMMAND with root directory set to NEWROOT.

--groups=G_LIST

specify supplementary groups as g1,g2,..,gN

--userspec=USER:GROUP

specify user and group (ID or name) to use

--skip-chdir

do not change working directory to '/'

--help

display this help and exit

--version

output version information and exit

If no command is given, run '"$SHELL" -i' (default: '/bin/sh -i').

Exit status:

125

if the chroot command itself fails

126

if COMMAND is found but cannot be invoked

127

if COMMAND cannot be found

-

the exit status of COMMAND otherwise

Author

Written by Roland McGrath.

Reporting bugs

Report bugs to: <[email protected]>.
Report any translation bugs to: <https://translationproject.org/team/>.
GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
General help using GNU software: <https://www.gnu.org/gethelp/>

From coreutils 9.12-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.