View Source: chdir(2) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

CHDIR
!!!CHDIR
!!NAME
chdir - change working directory
!!SYNOPSIS

 __#include <unistd.h>__

 __int chdir(const char *__''path''__);__
 __int fchdir(int__ ''fd''__);__
!!DESCRIPTION

__chdir__ changes the current directory to that specified in ''path''.

!!RETURN VALUE

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

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]: ''path'' is too long.
;[ENOENT]: The file does not exist.
;[ENOMEM]: Insufficient kernel memory was available.
;[ENOTDIR]: 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.

!!CONFORMING TO

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

!!SEE ALSO
getcwd(3), chroot(2), fchdir(2)
----

17 pages link to chdir(2):

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Last edited on Tuesday, October 29, 2002 11:44:05 pm by PerryLorier

Edit PageHistory Diff Info LikePages