Table of Contents
is the
address of the pathname of a directory, terminated by an ASCII NUL. causes
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.
It should be noted that has no effect on the process’s current directory.
This call is restricted to the super-user.
Upon successful
completion, a value of 0 is returned. Otherwise, a value of -1 is returned
and is set to indicate an error.
will fail and the root directory
will be unchanged if: A component of the path name is not a directory.
A component of a pathname exceeded characters, or an entire path name
exceeded characters. The named directory does not exist. Search permission
is denied for any component of the path name. Too many symbolic links were
encountered in translating the pathname. points outside the process’s allocated
address space. An I/O error occurred while reading from or writing to the
file system.
The function call appeared in
Table of Contents