CHROOT(2) 1989 CHROOT(2) NNAAMMEE chroot - change root directory SSYYNNOOPPSSIISS cchhrroooott((ddiirrnnaammee)) cchhaarr **ddiirrnnaammee;; DDEESSCCRRIIPPTTIIOONN _D_i_r_n_a_m_e is the address of the pathname of a directory, ter- minated by a null byte. _C_h_r_o_o_t causes this directory to become the root directory, the starting point for path names beginning with ``/''. In order for a directory to become the root directory a pro- cess must have execute (search) access to the directory. It should be noted that _c_h_r_o_o_t has no effect on the process's current directory. This call is restricted to the super-user. RREETTUURRNN VVAALLUUEE Upon successful completion, a value of 0 is returned. Oth- erwise, a value of -1 is returned and _e_r_r_n_o is set to indi- cate an error. EERRRROORRSS _C_h_r_o_o_t will fail and the root directory will be unchanged if one or more of the following are true: [ENOTDIR] A component of the path name is not a direc- tory. [EINVAL] The pathname contains a character with the high-order bit set. [ENAMETOOLONG] A component of a pathname exceeded 255 char- acters, or an entire path name exceeded 1023 characters. [ENOENT] The named directory does not exist. [EACCES] Search permission is denied for any component of the path name. [ELOOP] Too many symbolic links were encountered in translating the pathname. [EFAULT] _P_a_t_h points outside the process's allocated address space. [EIO] An I/O error occurred while reading from or Printed 7/27/90 January 1 CHROOT(2) 1989 CHROOT(2) writing to the file system. SSEEEE AALLSSOO chdir(2) Printed 7/27/90 January 2