int chdir(const char *path);
IEEE Std 1003.1-2017
The purpose is to change working directory. The
chdir() function shall cause the directory named by the pathname pointed to by the path argument to become the
current working directory, that is, the starting point for path searches for pathnames not beginning with
Upon successful completion,
0 shall be returned. Otherwise,
-1 shall be returned, the current working directory shall remain unchanged, and
errno shall be set to indicate the error.
chdir() function shall fail if:
EACCES- Search permission is denied for any component of the pathname.
ELOOP- A loop exists in symbolic links encountered during resolution of the path argument.
The length of a component of a pathname is longer than
ENOENT- A component of path does not name an existing directory or path is an empty string.
ENOTDIR- A component of the pathname names an existing file that is neither a directory nor a symbolic link to a directory.
chdir() function may fail if:
ELOOP- More than
SYMLOOP_MAXsymbolic links were encountered during resolution of the path argument.
The length of a pathname exceeds
PATH_MAX, or pathname resolution of a symbolic link produced an intermediate result with a
length that exceeds