*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Linux man pages -> chdir (2)              



NAME    [Toc]    [Back]

       chdir, fchdir - change working directory

SYNOPSIS    [Toc]    [Back]

       #include <unistd.h>

       int chdir(const char *path);
       int fchdir(int fd);

DESCRIPTION    [Toc]    [Back]

       chdir changes the current directory to that specified in path.

       fchdir  is  identical  to chdir, only that the directory is given as an
       open file descriptor.

RETURN VALUE    [Toc]    [Back]

       On success, zero is returned.  On error, -1 is returned, and  errno  is
       set appropriately.

ERRORS    [Toc]    [Back]

       Depending  on  the file system, other errors can be returned.  The more
       general errors for chdir are listed below:

       EFAULT path points outside your accessible address space.

       ENAMETOOLONG    [Toc]    [Back]
	      path is too long.

       ENOENT The file does not exist.

       ENOMEM Insufficient kernel memory was available.

       ENOTDIR    [Toc]    [Back]
	      A component of path is not a directory.

       EACCES Search permission is denied on a component of path.

       ELOOP  Too many symbolic links were encountered in resolving path.

       EIO    An I/O error occurred.

       The general errors for fchdir are listed below:

       EBADF  fd is not a valid file descriptor.

       EACCES Search permission was denied on the directory open on fd.

NOTES    [Toc]    [Back]

       The prototype for fchdir is only available if  _BSD_SOURCE  is  defined
       (either	explicitly,  or  implicitly,  by not defining _POSIX_SOURCE or
       compiling with the -ansi flag).

CONFORMING TO    [Toc]    [Back]

       The chdir call is compatible with SVr4, SVID,  POSIX,  X/OPEN,  4.4BSD.
       SVr4  documents	additional  EINTR, ENOLINK, and EMULTIHOP error conditions
 but has no ENOMEM.  POSIX.1 does not have ENOMEM or  ELOOP  error
       conditions.   X/OPEN  does  not have EFAULT, ENOMEM or EIO error conditions.

       The fchdir call is compatible with SVr4, 4.4BSD and X/OPEN.  SVr4 documents
 additional EIO, EINTR, and ENOLINK error conditions.  X/OPEN documents
 additional EINTR and EIO error conditions.

SEE ALSO    [Toc]    [Back]

       getcwd(3), chroot(2)

Linux 2.0.30			  1997-08-21			      CHDIR(2)
[ Back ]
 Similar pages
Name OS Title
chdir OpenBSD change current working directory
chdir NetBSD change current working directory
fchdir OpenBSD change current working directory
fchdir NetBSD change current working directory
chdir FreeBSD change current working directory
fchdir FreeBSD change current working directory
mcd Tru64 mtools utility to change or report the DOS working directory
pwd HP-UX working directory name
cd Tru64 Changes the current working directory
getcwd NetBSD get working directory pathname
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service