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.

     [EDFSREF]
         Reference is to remote directory which is not supported
         for this system call.





Printed 10/17/86                                                1

CHROOT(2)               COMMAND REFERENCE               CHROOT(2)



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 10/17/86                                                2

%%index%%
na:72,66;
sy:138,225;
de:363,345;
di:708,916;
rv:1768,235;
se:2003,123;
%%index%%000000000105