CHROOT(2)           Linux Programmer's Manual           CHROOT(2)
NAME
       chroot - change root directory
SYNOPSIS
       #include <unistd.h>
       int chroot(const char *path);
DESCRIPTION
       chroot  changes  the  root  directory to that specified in
       path.  This directory will be used for path name beginning
       with  /.   The root directory is inherited by all children
       of the current process.
       Only the super-user may change the root directory.
RETURN VALUE
       On success, zero is returned.  On error, -1  is  returned,
       and errno is set appropriately.
ERRORS
       Depending   on  the  file  system,  other  errors  can  be
       returned.  The more general errors are listed below:
       EPERM   The effective UID does not match the owner of  the
               file,  and is not zero; or the owner or group were
               specified incorrectly.
       EROFS   The named file resides on a read-only file system.
       EFAULT  path points outside your accessible address space.
       ENAMETOOLONG
               path is too long.
       ENOENT  The file does not exist.
       ENOMEM  Insufficient kernel memory was available.
       ENOTDIR A component of the path prefix is not a directory.
       EACCES  Search  permission is denied on a component of the
               path prefix.
       ELOOP   path contains a circular reference  (i.e.,  via  a
               symbolic link)
SEE ALSO
chdir, 
Linux 1.1.46              21 August 1994                        1
This manual page was brought to you by mjl_man V-2.0