chdir(2) -- Linux man page
NAMEchdir, fchdir - change working directory
DESCRIPTIONchdir changes the current directory to that specified in path.
RETURN VALUEOn success, zero is returned. On error, -1 is returned, and errno is set appropriately.
ERRORSDepending on the file system, other errors can be returned. The more general errors for chdir are listed below:
- path points outside your accessible address space.
- path is too long.
- The file does not exist.
- Insufficient kernel memory was available.
- A component of path is not a directory.
- Search permission is denied on a component of path.
- Too many symbolic links were encountered in resolving path.
- An I/O error occurred.
The general errors for fchdir are listed below:
- fd is not a valid file descriptor.
- Search permission was denied on the directory open on fd.
NOTESThe prototype for fchdir is only available if _BSD_SOURCE is defined (either explicitly, or implicitly, by not defining _POSIX_SOURCE or compiling with the -ansi flag).
CONFORMING TOThe chdir call is compatible with SVr4, SVID, POSIX, X/OPEN, 4.4BSD. SVr4 documents additional EINTR, ENOLINK, and EMULTIHOP error conditions but has no ENOMEM. POSIX.1 does not have ENOMEM or ELOOP error conditions. X/OPEN does not have EFAULT, ENOMEM or EIO error conditions.
SEE ALSOgetcwd(3), chroot(2)