chroot.1m (2010 09)

c
chroot(1M) chroot(1M)
NAME
chroot - change root directory for a command
SYNOPSIS
/usr/sbin/chroot
newroot command
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 work-
ing 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:
chroot newroot command >x
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
International Code Set Support
Single- and multibyte character code sets are supported.
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 environ-
ment.
SEE ALSO
chdir(2), chroot(2).
STANDARDS CONFORMANCE
chroot: SVID2, SVID3, XPG2, XPG3
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1