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

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



NAME    [Toc]    [Back]

     chroot - change root directory

SYNOPSIS    [Toc]    [Back]

     #include <unistd.h>

     chroot(const char *dirname);

DESCRIPTION    [Toc]    [Back]

     dirname is the address of the pathname of a directory,  terminated by an
     ASCII  NUL.   chroot() causes dirname to become the root directory, that
     is, the starting point for path searches of pathnames beginning with `/'.

     In order for a directory to become the root directory a process must have
     execute (search) access for that directory.

     If the program is not currently running with an altered root
     it  should  be noted that chroot() has no effect on the process's current

     If the program is already running with an altered  root  directory, the
     process's  current directory is changed to the same new root
     This prevents the current directory from  being  further  up
the directory
     tree than the altered root directory.

     This call is restricted to the superuser.

RETURN VALUES    [Toc]    [Back]

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

ERRORS    [Toc]    [Back]

     chroot() will fail and the root directory will be  unchanged

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

                   A component of a pathname exceeded  {NAME_MAX}
                   or  an  entire  path  name exceeded {PATH_MAX}

     [ENOENT]      The named directory does not exist.

     [EACCES]      Search permission is denied for any  component
of the path

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

     [EFAULT]      dirname points outside the process's allocated

     [EIO]          An  I/O  error occurred while reading from or
writing to the
                   file system.

     [EPERM]       The caller is not the superuser.

SEE ALSO    [Toc]    [Back]


WARNINGS    [Toc]    [Back]

     There are ways for a root process to escape from the  chroot

HISTORY    [Toc]    [Back]

     The chroot() function call appeared in 4.2BSD.

OpenBSD      3.6                           June      4,      1993
[ 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