chroot(1M)                                             chroot(1M)



     NAME
          chroot - change root directory for a command

     SYNOPSIS
          /etc/chroot newroot command

     DESCRIPTION
          Execute command relative to the new root.  Change initial
          slashes (/) in path names to newroot for a command and any
          of its children.  Also, change the initial working directory
          to newroot.

               chroot newroot command > x

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

          Only the superuser can use this command.

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

     EXAMPLE
          If you have a floppy-based A/UX system disk in
          /dev/dsk/c8d[01]s[07] then:

               mkdir /t
               mount /dev/dsk/c8d[01]s[07]/t
               chroot /t /bin/sh

          leaves you running programs off of the floppy.  To return to
          your original shell, exit your shell.

     FILES
          /etc/chroot

     SEE ALSO
          chdir(2).

     BUGS
          Be very careful when referencing special files in the new
          root file system.











     April, 1990                                                     1