chroot(1M)

DESCRIPTION

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

Note that command suffixes that affect input or output for the chroot command use the original root, not the new root. For example, the command:

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

The command variable includes both the command name and any arguments.

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.

This command is restricted to users with appropriate privileges.

EXTERNAL INFLUENCES

WARNINGS

command cannot be in a shell script.

Exercise extreme caution when referring to special files in the new root file system.

chroot does not search the PATH environment variable 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 path name 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 root environment.

SEE ALSO

chdir(2), chroot(2).

STANDARDS CONFORMANCE

chroot: SVID2, SVID3, XPG2, XPG3