unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

chdir(2)                         System Calls                         chdir(2)



NAME
       chdir, fchdir - change working directory

SYNOPSIS
       #include <unistd.h>

       int chdir(const char *path);

       int fchdir(int fildes);

DESCRIPTION
       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.

RETURN VALUES
       Upon successful completion, 0 is returned. Otherwise, -1  is  returned,
       the  current  working directory is unchanged, and errno is set to indi-
       cate the error.

ERRORS
       The chdir() function will fail if:

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



       EFAULT                  The path argument points to an illegal address.



       EINTR                   A signal was caught during the execution of the
                               chdir() function.



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



       ELOOP                   Too  many  symbolic  links  were encountered in
                               translating path.



       ENAMETOOLONG            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.



       ENOENT                  Either  a  component  of the path prefix or the
                               directory named by path does not exist or is  a
                               null pathname.



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



       ENOTDIR                 A  component  of  the path name is not a direc-
                               tory.



       The fchdir() function will fail if:

       EACCES                  Search permission is denied for fildes.



       EBADF                   The  fildes  argument  is  not  an  open   file
                               descriptor.



       EINTR                   A signal was caught during the execution of the
                               fchdir() function.



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



       ENOLINK                 The  fildes argument points to a remote machine
                               and the link  to  that  machine  is  no  longer
                               active.



       ENOTDIR                 The  open file descriptor fildes does not refer
                               to a directory.



ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).   ATTRIBUTE TYPEATTRIBUTE VALUE Interface StabilityStan-
       dard MT-LevelAsync-Signal-Safe


SEE ALSO
       chroot(2), attributes(5), standards(5)




SunOS 5.10                        28 Dec 1996                         chdir(2)