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. 

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. 

EXAMPLE

chroot /users/asa ls /src

will cause the command "ls /src" to list the directory "/users/asa/src" since "/users/asa" is now effectively "/". 

SEE ALSO

chdir(2). 

BUGS

One should exercise extreme caution when referencing special files in the new root file system. 

Version 2.4  —  May 08, 1986