CHROOT(2)               COMMAND REFERENCE               CHROOT(2)



NAME
     chroot - change root directory

SYNOPSIS
     chroot(path)
     char *path;

DESCRIPTION
     Path is the pathname of a directory.  Chroot causes this
     directory to become the root directory, the starting point
     for path names beginning with ``/''.






     This call is restricted to the super-user.

DIAGNOSTICS
     Chroot will fail and the root directory will be unchanged if
     one or more of the following are true:

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

     [ENOTDIR]      A component of the pathname is not a
                    directory.

     [ENAMETOOLONG] The argument path is too long.

     [ENOASCII]     The argument path contains a byte with the
                    high-order bit set.

     [ENOENT]       The named directory does not exist.

     [EFAULT]       Path points outside the process's allocated
                    address space.

     [ELOOP]        Too many symbolic links were encountered in
                    translating the pathname.

RETURN VALUE
     Upon successful completion, a value of 0 is returned.
     Otherwise, a value of -1 is returned and errno is set to
     indicate an error.

SEE ALSO
     chdir(2).







Printed 5/12/88                                                 1

%%index%%
na:288,82;
sy:370,345;
de:715,413;
di:1128,896;
rv:2024,279;
se:2303,110;
%%index%%000000000107