NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO
#include <unistd.h>int chdir(const char *path);
The chdir() and fchdir() functions cause a directory pointed to by path or fildes to become the current working directory. 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.
The chdir() function will fail if:
Search permission is denied for some component of path. To override this restriction, the calling process may assert one or both of these privileges: PRIV_FILE_DAC_SEARCH
and PRIV_FILE_MAC_SEARCH
.
The path argument points to an illegal address.
A signal was caught during the execution of the chdir() function.
An I/O error occurred while reading from or writing to the file system.
Too many symbolic links were encountered in translating path.
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.
Either a component of the path prefix or the directory named by path does not exist or is a null pathname.
The path argument points to a remote machine and the link to that machine is no longer active.
A component of the path name is not a directory.
The fchdir() function will fail if:
Search permission is denied for fildes. To override this restriction, the calling process may assert one or both of these privileges: PRIV_FILE_DAC_SEARCH
and PRIV_FILE_MAC_SEARCH
.
The fildes argument is not an open file descriptor.
A signal was caught during the execution of the fchdir() function.
An I/O error occurred while reading from or writing to the file system.
The fildes argument points to a remote machine and the link to that machine is no longer active.
The open file descriptor fildes does not refer to a directory.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
MT-Level | chdir() is Async-Signal-Safe |
Appropriate privilege is required to override access checks.
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO