chroot(2) System Calls Manual chroot(2) NAME chroot() - change root directory SYNOPSIS DESCRIPTION causes the named directory to become the root directory, the starting point for path searches for path names beginning with path points to a path name naming a directory. The user's working directory is unaffected by the system call. The entry in the root directory is interpreted to mean the root directory itself. Thus, cannot be used to access files outside the subtree rooted at the root directory. Security Restrictions The effective user ID of the process must be a user with the privilege to change the root directory. See privileges(5) for more information about privileged access on systems that support fine-grained privileges. RETURN VALUE returns the following values: Successful completion. Failure. is set to indicate the error. ERRORS fails and the root directory remains unchanged if one or more of the following is true: Any component of the path name is not a directory. The named directory does not exist or a component of the path does not exist. The effective user ID is not a user who has the privilege. path points outside the allocated address space of the process. The reliable detection of this error is implementation dependent. The length of the specified path name exceeds bytes, or the length of a component of the path name exceeds bytes while is in effect. Too many symbolic links were encountered in translating the path name. WARNINGS Obsolescent Interfaces is to be obsoleted at a future date. SEE ALSO chroot(1M), chdir(2), privileges(5). STANDARDS CONFORMANCE TO BE OBSOLETED chroot(2)