CHROOT
Section: Linux Programmer's Manual (2)
Updated: 21 August 1994
Index
Return to Main Contents
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(2)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- ERRORS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 12:25:14 GMT, March 22, 2025