chroot (1)

Quick Reference

Run command or interactive shell with special root directory.

  • Run command as new root directory:

chroot {{/path/to/new/root}} {{command}}

  • Specify user and group (ID or name) to use:

chroot --userspec={{user:group}}

NAME

chroot - run command or interactive shell with special root directory

SYNOPSIS

chroot [ OPTION] NEWROOT [COMMAND [ARG]...]
 
chroot OPTION

DESCRIPTION

Run COMMAND with root directory set to NEWROOT.
--groups=G_LIST
specify supplementary groups as g1,g2,..,gN
--userspec=USER:GROUP
specify user and group (ID or name) to use
--skip-chdir
do not change working directory to '/'
--help
display this help and exit
--version
output version information and exit
If no command is given, run '"$SHELL" -i' (default: '/bin/sh -i').

AUTHOR

Written by Roland McGrath.

REPORTING BUGS

GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
 
Report chroot translation bugs to <https://translationproject.org/team/>

SEE ALSO

chroot(2)
Full documentation at: <https://www.gnu.org/software/coreutils/chroot>
 
or available locally via: info '(coreutils) chroot invocation'

Information

Source
Coreutils
OS/version
GNU coreutils 8.29.13-0a854
Source updated
December 2, 2018
Page created
February 9, 2018
Page generated
December 2, 2018