CHDIR(S) UNIX System V CHDIR(S)
Name
chdir - change working directory
Syntax
int chdir (path)
char *path;
Description
path points to the path name of a directory. chdir causes
the named directory to become the current working directory,
the starting point for path searches for path names not
beginning with /.
chdir will fail and the current working directory will be
unchanged if one or more of the following is true:
[ENOTDIR] A component of the path name is not a
directory.
[ENOENT] The named directory does not exist.
[EACCES] Search permission is denied for any component
of the path name.
[EFAULT] path points outside the allocated address
space of the process.
[EINTR] A signal was caught during the chdir system
call.
[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.
See Also
chroot(S).
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.
Standards Conformance
chdir is conformant with:
AT&T SVID Issue 2, Select Code 307-127;
The X/Open Portability Guide II of January 1987;
IEEE POSIX Std 1003.1-1988 with C Standard Language-
Dependent System Support;
and NIST FIPS 151-1.
(printed 6/20/89)