chroot(2)                      DG/UX R4.11MU05                     chroot(2)


NAME
       chroot - change the root directory of the calling process

SYNOPSIS
       #include <unistd.h>

       int  chroot (path)
       const char * path;

   where:
       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 calling process must have appropriate privilege to successfully
       execute this system call.  For systems supporting the DG/UX
       Capability Option, appropriate privilege is defined as having one or
       more specific capabilities enabled in the effective capability set of
       the calling process.  See capdefaults(5) for the default capability
       for this system call.

       On systems without the DG/UX Capability Option, appropriate privilege
       means that the process has an effective UID of root.  See the
       appropriateprivilege(5) man page for more information.

RETURN VALUE
       0      The root was successfully changed.

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

DIAGNOSTICS
       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.

       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
       chdir(2), appropriateprivilege(5).
       capdefaults(5).


Licensed material--property of copyright holder(s)