NAME [Toc] [Back]
chroot - change root directory for a command
SYNOPSIS [Toc] [Back]
/usr/sbin/chroot newroot command
DESCRIPTION [Toc] [Back]
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
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 [Toc] [Back]
International Code Set Support
Single- and multibyte character code sets are supported.
WARNINGS [Toc] [Back]
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 [Toc] [Back]
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
STANDARDS CONFORMANCE [Toc] [Back]
chroot: SVID2, SVID3, XPG2, XPG3
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003 [ Back ]