*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Linux man pages -> chroot (2)              



NAME    [Toc]    [Back]

       chroot - change root directory

SYNOPSIS    [Toc]    [Back]

       #include <unistd.h>

       int chroot(const char *path);

DESCRIPTION    [Toc]    [Back]

       chroot  changes	the  root  directory  to that specified in path.  This
       directory will be used for path	names  beginning  with	/.   The  root
       directory 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    [Toc]    [Back]

       On success, zero is returned.  On error, -1 is returned, and  errno  is
       set appropriately.

ERRORS    [Toc]    [Back]

       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    [Toc]    [Back]
	      path is too long.

       ENOENT The file does not exist.

       ENOMEM Insufficient kernel memory was available.

       ENOTDIR    [Toc]    [Back]
	      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    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]


Linux 2.0.30			  1997-08-21			     CHROOT(2)
[ Back ]
 Similar pages
Name OS Title
chroot HP-UX change root directory for a command
chroot IRIX change root directory for a command
chroot Tru64 Change the effective root directory
pivot_root Linux change the root file system
pivot_root Linux change the root file system
chroot Tru64 Changes the root directory of a command
pxfchroot IRIX Changes the root directory to a specified directory
chroot Linux run command or interactive shell with special root directory
fchdir HP-UX change working directory
chdir Linux change working directory
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service