chdir(2)
_________________________________________________________________
chdir System Call
Change the working directory of the calling process.
_________________________________________________________________
SYNTAX
int chdir (path)
char * path;
PARAMETERS
path Address of a pathname.
DESCRIPTION
<Path> points to a pathname naming a directory that is made the
current working directory of the calling process. If <path>
refers to a symbolic link, the target of the symbolic link is
made the current working directory. The current working
directory is the starting point of subsequent searches for
pathnames that do not begin with '/'.
If the call fails, the current working directory is not changed.
ACCESS CONTROL
The calling process must have execute permission to the named
directory.
The process must have permission to resolve <path>.
RETURN VALUE
0 The current directory was successfully changed.
-1 An error occurred. Errno is set to indicate the
error.
EXCEPTIONS
Errno may be set to one of the following error codes:
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
chdir(2)
EACCES Execute permission to the directory is denied.
ENOTDIR The named file is not a directory.
ENOENT The file the pathname resolved to does not exist.
ENOENT A non-terminal component of the pathname does not
exist.
ENOTDIR A non-terminal component of the pathname was not a
directory or symbolic link.
ENAMETOOLONG The pathname exceeds the length limit for
pathnames.
ENAMETOOLONG A component of the pathname exceeds the length
limit for filenames.
ENOMEM There are not enough system resources to resolve
the pathname or to expand a symbolic link.
ELOOP The number of symbolic links encountered during
pathname resolution exceeded MAXSYMLINKS. A
symbolic link cycle is suspected.
EPERM The pathname contains a character not in the
allowed character set.
EFAULT The pathname does not completely reside in the
process's address space or the pathname does not
terminate in the process's address space.
SEE ALSO
The related manual section: chroot(2).
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)