NAME

chroot − change root directory for a command

SYNOPSIS

/etc/chroot newroot command

DESCRIPTION

The specified 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.

Note that:

chroot newroot command >x

creates 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 users with appropriate privileges. 

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. 

EXTERNAL INFLUENCES

International Code Set Support

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

WARNINGS

command cannot be in a shell script. 

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. 

When using chroot to establish a new environment, all absolute pathname references to the file system are lost, rendering shared libraries inaccessible.  If continued access to shared libraries is needed for correct operation, the shared libraries and the dynamic loader must be copied into the new chrooted environment. 

SEE ALSO

chdir(2), chroot(2). 

STANDARDS CONFORMANCE

chroot: SVID2, XPG2, XPG3

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992