.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1. .TH CHROOT "8" "February 2026" "GNU coreutils 9.10" "User Commands" .SH NAME chroot \- run command or interactive shell with special root directory .SH SYNOPSIS .B chroot [\fI\,OPTION\/\fR]... \fI\,NEWROOT \/\fR[\fI\,COMMAND \/\fR[\fI\,ARG\/\fR]...] .SH DESCRIPTION .\" Add any additional description here .PP Run COMMAND with root directory set to NEWROOT. .TP \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chroot--groups'\fB\-\-groups=G_LIST\fP\X'tty: link' specify supplementary groups as g1,g2,..,gN .TP \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chroot--userspec'\fB\-\-userspec=USER:GROUP\fP\X'tty: link' specify user and group (ID or name) to use .TP \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chroot--skip-chdir'\fB\-\-skip\-chdir\fP\X'tty: link' do not change working directory to '/' .TP \X'tty: link https://www.gnu.org/software/coreutils/chroot#chroot--help'\fB\-\-help\fP\X'tty: link' display this help and exit .TP \X'tty: link https://www.gnu.org/software/coreutils/chroot#chroot--version'\fB\-\-version\fP\X'tty: link' output version information and exit .PP If no command is given, run '"$SHELL" \fB\-i\fR' (default: '/bin/sh \fB\-i\fR'). .SS "Exit status:" .TP 125 if the chroot command itself fails .TP 126 if COMMAND is found but cannot be invoked .TP 127 if COMMAND cannot be found .TP \- the exit status of COMMAND otherwise .SH AUTHOR Written by Roland McGrath. .SH "REPORTING BUGS" Report bugs to: bug\-coreutils@gnu.org .br GNU coreutils home page: .br General help using GNU software: .br Report any translation bugs to .SH "SEE ALSO" \fBchroot\fP(2) .PP .br Full documentation .br or available locally via: info \(aq(coreutils) chroot invocation\(aq .PP .br Packaged by Debian (9.10\-1) .br Copyright \(co 2026 Free Software Foundation, Inc. .br License GPLv3+: GNU GPL version 3 or later . .br This is free software: you are free to change and redistribute it. .br There is NO WARRANTY, to the extent permitted by law.