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

You are viewing an old revision of this page. View the current version.

CHDIR
!!!CHDIR
NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
NOTES
CONFORMING TO
SEE ALSO
----
!!NAME


chdir, fchdir - change working directory
!!SYNOPSIS


__#include __


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


__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


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.


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


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


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


getcwd(3), chroot(2)
----

3 pages link to fchdir(2):

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

Version 1, saved on Tuesday, June 4, 2002 12:23:40 am by "perry"

Edit PageHistory Diff Info LikePages