NAME

chroot − change root directory for a command

SYNOPSIS

/etc/chroot newroot command

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: System V

Remarks: Not supported on the Integral PC. 

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. 

SEE ALSO

chdir(2). 

BUGS

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. 

Hewlett-Packard  —  last mod. May 11, 2021