chdir(2)                          SDK R4.11                         chdir(2)


NAME
       chdir - change the working directory of the calling process

SYNOPSIS
       #include <unistd.h>

       int  chdir (path)
       const char *  path;

   where:
       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.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       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
       chroot(2).


Licensed material--property of copyright holder(s)