Changes the current directory.
Standard C Library (libc.a)
#include <unistd.h>
int chdir ( Path)
const char *Path;
The chdir subroutine changes the current directory to the directory indicated by the Path parameter.
The current directory, also called the current working directory, is the starting point of searches for path names that do not begin with a / (slash). The calling process must have search access to the directory specified by the Path parameter.
Upon successful completion, the chdir subroutine returns a value of 0. Otherwise, a value of -1 is returned and the errno global variable is set to identify the error.
The chdir subroutine fails and the current directory remains unchanged if one or more of the following are true:
| EACCES | Search access is denied for the named directory. |
| ENOENT | The named directory does not exist. |
| ENOTDIR | The path name is not a directory. |
The chdir subroutine can also be unsuccessful for other reasons. See Appendix A. Base Operating System Error Codes for Services That Require Path-Name Resolution (Appendix A. Base Operating System Error Codes for Services That Require Path-Name Resolution) for a list of additional error codes.
If NFS is installed on the system, the chdir subroutine can also fail if the following is true:
| ETIMEDOUT | The connection timed out. |
The chroot (chroot Subroutine) subroutine.
The cd command.
Appendix A. Base Operating System Error Codes for Services That Require Path-Name Resolution .
Files, Directories, and File Systems for Programmers in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.