CHROOT(ADM)                        UNIX System V



     Name
          chroot - changes root directory for command


     Syntax
          chroot newroot command


     Description
          The given command is executed relative to the new root.  The
          meaning  of  any initial slashes (/) in pathnames 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

          creates the file x relative to the original  root,  not  the
          new one.

          This command is restricted to the super-user.

          The new root pathname 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.  Note that it is not possible to change directories
          to what was formerly the parent of the new  root  directory;
          i.e.,  the  chroot  command  supports  the  new  root  as an
          absolute root for the duration of the  command.  This  means
          that ``/..'' is always equivalent to ``/''.


     See Also
          chdir(S)


     Notes
          Exercise extreme caution when referencing special  files  in
          the new root file system.

          command must be under newroot or command is reported:

               command: not found


     Standards Conformance
          chroot is conformant with:

          AT&T SVID Issue 2, Select Code 307-127;
          and The X/Open Portability Guide II of January 1987.


     (printed 8/23/89)                                  CHROOT(ADM)