chroot(1M)                                             chroot(1M)



NAME
     chroot - changes the root directory for a command

SYNOPSIS
     chroot newroot command

ARGUMENTS
     command
          Specifies the command to be executed on the new root
          directory.

     newroot
          Specifies the name of the new root directory.

DESCRIPTION
     chroot executes the command relative to the new root and
     changes initial slashes (/) in pathnames to newroot for a
     command and any of its children.  It also changes the
     initial working directory to newroot.

     The command:

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

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

        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.

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

FILES
     /etc/chroot
          Executable file



January 1992                                                    1

chroot(1M)                                             chroot(1M)



SEE ALSO
     chdir(2) in A/UX Programmer's Reference





















































2                                                    January 1992