CHROOT(2)            INTERACTIVE UNIX System            CHROOT(2)



          NAME
               chroot - change root directory

          SYNOPSIS
               int chroot (path)
               char *path;

          DESCRIPTION
               The path argument points to a path name naming a directory.
               The chroot system call causes the named directory to become
               the root directory, the starting point for path searches for
               path names beginning with /.  The user's working directory
               is unaffected by the chroot system call.

               The effective user ID of the process must be super-user to
               change the root directory.

               The .. entry in the root directory is interpreted to mean
               the root directory itself.  Thus, .. cannot be used to
               access files outside the subtree rooted at the root direc-
               tory.

               The chroot system call will fail and the root directory will
               remain unchanged if one or more of the following is true:

               [ENOTDIR]      Any component of the path name is not a
                              directory.

               [ENOENT]       The named directory does not exist.

               [EPERM]        The effective user ID is not super-user.

               [EFAULT]       The path argument points outside the allo-
                              cated address space of the process.

               [EINTR]        A signal was caught during the chroot system
                              call.

               [ENOLINK]      The Path argument points to a remote machine
                              and the link to that machine is no longer
                              active.

               [EMULTIHOP]    Components of path require hopping to multi-
                              ple remote machines.

          SEE ALSO
               chdir(2).

          DIAGNOSTICS
               Upon successful completion, a value of 0 is returned.  Oth-
               erwise, a value of -1 is returned, and errno is set to indi-
               cate the error.



          Rev. C Software Development Set                            Page 1