.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.5.
.TH CHROOT "8" "January 2024" "GNU coreutils 9.4" "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]...]
.br
.B chroot
\fI\,OPTION\/\fR
.SH DESCRIPTION
.\" Add any additional description here
.PP
Run COMMAND with root directory set to NEWROOT.
.TP
\fB\-\-groups\fR=\fI\,G_LIST\/\fR
specify supplementary groups as g1,g2,..,gN
.TP
\fB\-\-userspec\fR=\fI\,USER\/\fR:GROUP
specify user and group (ID or name) to use
.TP
\fB\-\-skip\-chdir\fR
do not change working directory to '/'
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
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"
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
.br
Report any translation bugs to <https://translationproject.org/team/>
.SH COPYRIGHT
Copyright \(co 2023 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
\fBchroot\fP(2)
.PP
.br
Full documentation <https://www.gnu.org/software/coreutils/chroot>
.br
or available locally via: info \(aq(coreutils) chroot invocation\(aq