chroot(2) [redhat man page]

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 names beginning with /.  The root direc-
       tory is inherited by all children of the current process.

       Only the super-user may change the root directory.

       Note that this call does not change the current working directory, so that `.' can be outside the tree rooted at `/'.  In  particular,  the
       super-user can escape from a `chroot jail' by doing `mkdir foo; chroot foo; cd ..'.

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 is not zero.

       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 path is not a directory.

       EACCES Search permission is denied on a component of the path prefix.

       ELOOP  Too many symbolic links were encountered in resolving path.

       EIO    An I/O error occurred.

CONFORMING TO

       SVr4,  SVID,  4.4BSD,  X/OPEN.	This function is not part of POSIX.1.  SVr4 documents additional EINTR, ENOLINK and EMULTIHOP error condi-
       tions.  X/OPEN does not document EIO, ENOMEM or EFAULT error conditions.  This interface is marked as legacy by X/OPEN.

SEE ALSO

       chdir(2)

Linux 2.0.30							    1997-08-21								 CHROOT(2)

CHDIR(2)						     Linux Programmer's Manual							  CHDIR(2)

NAME

       chdir, fchdir - change working directory

SYNOPSIS

       #include <unistd.h>

       int chdir(const char *path);
       int fchdir(int fd);

DESCRIPTION

       chdir changes the current directory to that specified in path.

       fchdir is identical to chdir, only that the directory is given as an open file descriptor.

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 for chdir are listed below:

       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 path is not a directory.

       EACCES Search permission is denied on a component of path.

       ELOOP  Too many symbolic links were encountered in resolving path.

       EIO    An I/O error occurred.

       The general errors for fchdir are listed below:

       EBADF  fd is not a valid file descriptor.

       EACCES Search permission was denied on the directory open on fd.

NOTES

       The  prototype  for  fchdir is only available if _BSD_SOURCE is defined (either explicitly, or implicitly, by not defining _POSIX_SOURCE or
       compiling with the -ansi flag).

CONFORMING TO

       The chdir call is compatible with SVr4, SVID, POSIX, X/OPEN, 4.4BSD.  SVr4 documents additional EINTR, ENOLINK, and EMULTIHOP error  condi-
       tions  but has no ENOMEM.  POSIX.1 does not have ENOMEM or ELOOP error conditions.  X/OPEN does not have EFAULT, ENOMEM or EIO error condi-
       tions.

       The fchdir call is compatible with SVr4, 4.4BSD and X/OPEN.  SVr4 documents additional EIO, EINTR, and ENOLINK  error  conditions.   X/OPEN
       documents additional EINTR and EIO error conditions.

SEE ALSO

       getcwd(3), chroot(2)

Linux 2.0.30							    1997-08-21								  CHDIR(2)