Debian Codegraph @

upstream/debian-unstable/man8/chroot.8

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH CHROOT "8" "February 2026" "GNU coreutils 9.10" "User Commands"
3 .SH NAME
4 chroot \- run command or interactive shell with special root directory
5 .SH SYNOPSIS
6 .B chroot
7 [\fI\,OPTION\/\fR]... \fI\,NEWROOT \/\fR[\fI\,COMMAND \/\fR[\fI\,ARG\/\fR]...]
8 .SH DESCRIPTION
9 .\" Add any additional description here
10 .PP
11 Run COMMAND with root directory set to NEWROOT.
12 .TP
13 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chroot--groups'\fB\-\-groups=G_LIST\fP\X'tty: link'
14 specify supplementary groups as g1,g2,..,gN
15 .TP
16 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chroot--userspec'\fB\-\-userspec=USER:GROUP\fP\X'tty: link'
17 specify user and group (ID or name) to use
18 .TP
19 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#chroot--skip-chdir'\fB\-\-skip\-chdir\fP\X'tty: link'
20 do not change working directory to '/'
21 .TP
22 \X'tty: link https://www.gnu.org/software/coreutils/chroot#chroot--help'\fB\-\-help\fP\X'tty: link'
23 display this help and exit
24 .TP
25 \X'tty: link https://www.gnu.org/software/coreutils/chroot#chroot--version'\fB\-\-version\fP\X'tty: link'
26 output version information and exit
27 .PP
28 If no command is given, run '"$SHELL" \fB\-i\fR' (default: '/bin/sh \fB\-i\fR').
29 .SS "Exit status:"
30 .TP
31 125
32 if the chroot command itself fails
33 .TP
34 126
35 if COMMAND is found but cannot be invoked
36 .TP
37 127
38 if COMMAND cannot be found
39 .TP
40 \-
41 the exit status of COMMAND otherwise
42 .SH AUTHOR
43 Written by Roland McGrath.
44 .SH "REPORTING BUGS"
45 Report bugs to: bug\[email protected]
46 .br
47 GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
48 .br
49 General help using GNU software: <https://www.gnu.org/gethelp/>
50 .br
51 Report any translation bugs to <https://translationproject.org/team/>
52 .SH "SEE ALSO"
53 \fBchroot\fP(2)
54 .PP
55 .br
56 Full documentation <https://www.gnu.org/software/coreutils/chroot>
57 .br
58 or available locally via: info \(aq(coreutils) chroot invocation\(aq
59 .PP
60 .br
61 Packaged by Debian (9.10\-1)
62 .br
63 Copyright \(co 2026 Free Software Foundation, Inc.
64 .br
65 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
66 .br
67 This is free software: you are free to change and redistribute it.
68 .br
69 There is NO WARRANTY, to the extent permitted by law.