CHDIR(2-POSIX)      RISC/os Reference Manual       CHDIR(2-POSIX)



NAME
     chdir - change working directory

SYNOPSIS
     int chdir (path)
     char *path;

DESCRIPTION
     path points to the path name of a directory.  chdir causes
     the named directory to become the current working directory,
     the starting point for path searches for path names not
     beginning with a slash (/).

     chdir will fail and the current working directory will be
     unchanged if one or more of the following are true:

     [ENOTDIR]           A component of the path name is not a
                         directory.

     [ENOENT]            The named directory does not exist, or
                         path is an empty string.

     [EACCES]            Search permission is denied for any com-
                         ponent of the path name.

     [EFAULT]            path points outside the allocated
                         address space of the process.

     [EINTR]             A signal was caught during the chdir
                         system call.

     [ENOLINK]           path points to a remote machine and the
                         link to that machine is no longer
                         active.

     [EMULTIHOP]         Components of path require hopping to
                         multiple remote machines.

     [ENAMETOOLONG]      path exceeds {PATH_MAX} in length, or a
                         pathname component is longer than
                         {NAME_MAX} while {_POSIX_NO_TRUNC} is in
                         effect.

SEE ALSO
     getcwd(3C).

DIAGNOSTICS
     Upon successful completion, a value of 0 is returned.  Oth-
     erwise, a value of -1 is returned and errno is set to indi-
     cate the error.





                         Printed 1/15/91                   Page 1