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



NAME
     chdir - change current working directory

SYNOPSIS
     chdir(path)
     char *path;

DESCRIPTION
     path is the pathname of a directory.  chdir causes this
     directory to become the current working directory, the
     starting point for path names not beginning with ``/''.

     In order for a directory to become the current directory, a
     process must have execute (search) access to the directory.

RETURN VALUE
     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.

ERRORS
     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 prefix is
                              not a directory.

     [EINVAL]                 The pathname contains a character
                              with the high-order bit set.

     [ENAMETOOLONG]           A component of a pathname exceeded
                              255 characters, or an entire path
                              name exceeded 1023 characters.

     [ENOENT]                 The named directory does not exist.

     [ELOOP]                  Too many symbolic links were
                              encountered in translating the
                              pathname.

     [EACCES]                 Search permission is denied for any
                              component of the path name.

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

     [EIO]                    An I/O error occurred while reading
                              from or writing to the file system.

SEE ALSO
     chroot(2)




                         Printed 1/15/91                   Page 1