NAME

chroot − change root directory for a command

SYNOPSIS

/etc/chroot newroot command

DESCRIPTION

The given command is executed relative to the new root. The meaning of any initial slashes (/) in path names is changed for a command and any of its children to newroot. Furthermore, the initial working directory is newroot.

Notice that:

chroot newroot command >x

will create the file x relative to the original root, not the new one. 

Command includes both the command name and any arguments. 

This command is restricted to the super-user. 

The new root path name is always relative to the current root.  Even if a chroot is currently in effect, the newroot argument is relative to the current root of the running process. 

WARNINGS

Command cannot be in a shell script. 
One should exercise extreme caution when referencing special files in the new root file system.
Chroot does not search PATH for the location of command, so the absolute path name of command must be given. 

SEE ALSO

chdir(2), chroot(2). 

EXTERNAL INFLUENCES

International Code Set Support

Single- and multi-byte character code sets are supported. 

STANDARDS CONFORMANCE

chroot: SVID2, XPG2, XPG3

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989