int
chdir(const char *path)
int
fchdir(int fd)
path
argument points to the pathname of a directory.
The
chdir()
function
causes the named directory
to become the current working directory, that is,
the starting point for path searches of pathnames not beginning with
a slash,
`/'.
The
fchdir()
function
causes the directory referenced by
fd
to become the current working directory,
the starting point for path searches of pathnames not beginning with
a slash,
`/'.
In order for a directory to become the current directory, a process must have execute (search) access to the directory.
)
will fail and the current working directory will be unchanged if
one or more of the following are true:
ENOTDIR]ENAMETOOLONG]{NAME_MAX}
characters, or an entire path name exceeded
{PATH_MAX}
characters.
ENOENT]ELOOP]EACCES]EFAULT]path
points outside the process's allocated address space.
EIO]
fchdir()
will fail and the current working directory will be unchanged if
one or more of the following are true:
EACCES]ENOTDIR]EBADF]fd
is not a valid file descriptor.
EPERM]fd
references a directory which is not at or below the current process's
root directory.
)
function conforms to
ISO/IEC 9945-1:1990 (``POSIX.1'') .
)
function call
appeared in
4.2BSD.