.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
.TH CHROOT "8" "June 2025" "GNU coreutils 9.7" "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:
.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.7\-3)
.br
Copyright \(co 2025 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.