Debian Codegraph @

upstream/debian-trixie/man8/chroot.8

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