chdir(2)
NAME
chdir, fchdir - change working directory
SYNOPSIS
#include <unistd.h>
int chdir(const char *path);
int fchdir(int fildes);
DESCRIPTION
The chdir() and fchdir() functions cause a directory pointed
to by path or fildes to become the current working direc-
tory. The starting point for path searches for path names
not beginning with / (slash). The path argument points to
the path name of a directory. The fildes argument is an open
file descriptor of a directory.
For a directory to become the current directory, a process
must have execute (search) access to the directory.
RETURN VALUES
Upon successful completion, 0 is returned. Otherwise, -1 is
returned, the current working directory is unchanged, and
errno is set to indicate the error.
ERRORS
The chdir() function will fail if:
EACCES
Search permission is denied for any component of the
path name.
EFAULT
The path argument points to an illegal address.
EINTR A signal was caught during the execution of the
chdir() function.
EIO An I/O error occurred while reading from or writing to
the file system.
ELOOP Too many symbolic links were encountered in translat-
ing path.
ENAMETOOLONG
The length of the path argument exceeds PATH_MAX, or
the length of a path component exceeds NAME_MAX while
_POSIX_NO_TRUNC is in effect.
ENOENT
Either a component of the path prefix or the directory
named by path does not exist or is a null pathname.
ENOLINK
The path argument points to a remote machine and the
link to that machine is no longer active.
ENOTDIR
A component of the path name is not a directory.
The fchdir() function will fail if:
EACCES
Search permission is denied for fildes.
EBADF The fildes argument is not an open file descriptor.
EINTR A signal was caught during the execution of the
fchdir() function.
EIO An I/O error occurred while reading from or writing to
the file system.
ENOLINK
The fildes argument points to a remote machine and the
link to that machine is no longer active.
ENOTDIR
The open file descriptor fildes does not refer to a
directory.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| MT-Level | chdir() is Async-Signal-Safe|
|_____________________________|_____________________________|
SEE ALSO
chroot(2), attributes(5)
Man(1) output converted with
man2html