CHDIR(2) SysV CHDIR(2)
NAME
chdir - change working directory
SYNOPSIS
int chdir (path)
char *path;
DESCRIPTION
path points to the pathname of a directory. chdir causes the named
directory to become the current working directory, the starting point for
path searches for pathnames not beginning with a slash (/).
DIAGNOSTICS
Upon successful completion, a value of 0 is returned. Otherwise, a value
of -1 is returned and errno is set to indicate the error.
ERRORS
chdir will fail and the current working directory will be unchanged if
one or more of the following are true:
[ENOTDIR] A component of the pathname is not a directory.
[ENOENT] The named directory does not exist.
[EACCES] Search permission is denied for any component of the
pathname.
[EFAULT] path points outside the allocated address space of the
process.
[EINTR] A signal was caught during the chdir system call.
NOTES
Under other implementations, chdir fails if either of the following is
true:
[ENOLINK] path points to a remote machine and the link to that
machine is no longer active.
[EMULTIHOP] Components of path require hopping to multiple remote
machines.