chdir(2)
Name
chdir − change working directory
Syntax
chdir(path)
char *path;
Description
The path is the pathname of a directory. The chdir system call causes this directory to become the current working directory, which is the starting point for pathnames that do not begin at the root directory (/).
For a directory to become the current directory, the process must have execute (search) access to the directory.
Return Value
Upon successful completion, a value of 0 is returned. Otherwise, a value of −1 is returned and errno is set to indicate the error.
Environment
Differs from the System V definition in that ELOOP is a possible error condition.
Diagnostics
The chdir system call fails and the current working directory is unchanged under the following conditions:
[ENOTDIR] A component of the pathname is not a directory.
[ENAMETOOLONG]
A component of a pathname exceeds 255 characters, or an entire path name exceeds 1023 characters.
[ENOENT] The named directory does not exist or the path points to an empty string and the environment defined is POSIX or SYSTEM_FIVE.
[EACCES] Search permission is denied for any component of the path name.
[EFAULT] The path points outside the process’s allocated address space.
[ELOOP] Too many symbolic links were encountered in translating the pathname.
[EIO] An I/O error occurred while reading from or writing to the file system.
[ESTALE] The file handle given in the argument was invalid. The file referred to by that file handle no longer exists or has been revoked.
[ETIMEDOUT] A connect request or remote file operation failed because the connected party did not properly respond after a period of time that is dependent on the communications protocol.