NAME
chdir, fchdir - change working directory
SYNOPSIS
#include <unistd.h>
I int chdir(const char * path );
I int fchdir(int fd );
DESCRIPTION
R chdir ()
changes the current working directory pf the calling process to the
directory specified in
R path .
R fchdir ()
is identical to
R chdir ();
the only difference is that the directory is given as an
open file descriptor.
RETURN VALUE
On success, zero is returned.
On error, -1 is returned, and
errno
is set appropriately.
ERRORS
Depending on the file system, other errors can be returned.
The more
general errors for
R chdir ()
are listed below:
EACCES
Search permission is denied for one of the components of
R path .
(See also
path_resolution(7).)
EFAULT
path
points outside your accessible address space.
EIO
An I/O error occurred.
ELOOP
Too many symbolic links were encountered in resolving
R path .
ENAMETOOLONG
path
is too long.
ENOENT
The file does not exist.
ENOMEM
Insufficient kernel memory was available.
ENOTDIR
A component of
path
is not a directory.
The general errors for
R fchdir ()
are listed below:
EACCES
Search permission was denied on the directory open on
R fd .
EBADF
fd
is not a valid file descriptor.
CONFORMING TO
SVr4, 4.4BSD, POSIX.1-2001.
NOTES
The current working directory is the starting point for interpreting
relative pathnames (those not starting with '/').
A child process created via
fork(2)
inherits its parent's current working directory.
The current working directory is left unchanged by
execve(2).
The prototype for
R fchdir ()
is only available if
_BSD_SOURCE
is defined, or
_XOPEN_SOURCE
is defined with the value 500.
SEE ALSO