hpux 10.20 - chroot (1)

 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
      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.

 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 environment.

 SEE ALSO
      chdir(2), chroot(2).



 STANDARDS CONFORMANCE
      chroot: SVID2, SVID3, XPG2, XPG3