Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > C


HP-UX 11i Version 3: February 2007

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index


chroot — change root directory for a command


/usr/sbin/chroot newroot command


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:

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.


International Code Set Support

Single- and multibyte character code sets are supported.


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.


chroot: SVID2, SVID3, XPG2, XPG3

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.