chroot(2)                  DG/UX 4.30                   chroot(2)



     NAME
          chroot - Changes the root directory of the calling process.

     SYNOPSIS
          int   chroot  (path)
          char *          path;

     PARAMETERS
          path           Address of a pathname.

     DESCRIPTION
          <Path> points to the pathname of a directory.  Chroot makes
          that directory the root directory of the calling process,
          the starting point of searches for pathnames beginning with
          '/'.  If <path> refers to a symbolic link, the target of the
          symbolic link is made the root directory.  The process's
          working directory is unaffected by the chroot system call.

          The '..' entry in the root directory means the root
          directory itself; the root is treated as having no parent
          directory.  Thus, the process cannot access files outside
          the subtree whose topmost node is the root directory, unless
          the process's current working directory is located outside
          of that subtree.

          If chroot fails, the root directory remains unchanged.

     ACCESS CONTROL
          The effective user id of the calling process must be
          superuser.

     RETURN VALUE
          0              The root was successfully changed.


          -1             An error occurred.  Errno is set to indicate
                         the error.

     EXCEPTIONS
          Errno may be set to one of the following error codes:


          ENOENT         The named directory does not exist.


          EPERM          Permission to change the root directory is
                         denied.


          ENOENT         The file the pathname resolved to does not
                         exist.




     Licensed material--property of copyright holder(s)         Page 1

     chroot(2)                  DG/UX 4.30                   chroot(2)



          ENOENT         A non-terminal component of the pathname does
                         not exist.


          ENOTDIR        A non-terminal component of the pathname was
                         not a directory or symbolic link.


          ENAMETOOLONG   The pathname exceeds the length limit for
                         pathnames.


          ENAMETOOLONG   A component of the pathname exceeds the
                         length limit for filenames.


          ENOMEM         There are not enough system resources to
                         resolve the pathname or to expand a symbolic
                         link.


          ELOOP          The number of symbolic links encountered
                         during pathname resolution exceeded
                         MAXSYMLINKS.  A symbolic link cycle is
                         suspected.


          EPERM          The pathname contains a character not in the
                         allowed character set.


          EFAULT         The pathname does not completely reside in
                         the process's address space or the pathname
                         does not terminate in the process's address
                         space.

     SEE ALSO
          The related manual section:  chdir(2).

















     Licensed material--property of copyright holder(s)         Page 2