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


Top Master Index Keywords Functions


This manual page was brought to you by mjl_man V-2.0