dirfd man page on Debian

Man page or keyword search:  
man Server   8174 pages
apropos Keyword Search (all sections)
Output format
Debian logo
[printable version]

DIRFD(3)		   Linux Programmer's Manual		      DIRFD(3)

NAME
       dirfd - get directory stream file descriptor

SYNOPSIS
       #include <sys/types.h>
       #include <dirent.h>

       int dirfd(DIR *dirp);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       dirfd():
	   Since glibc 2.10:
	       _BSD_SOURCE || _SVID_SOURCE || _POSIX_C_SOURCE >= 200809L ||
	       _XOPEN_SOURCE >= 700
	   Before glibc 2.10:
	       _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION
       The function dirfd() returns the file descriptor	 associated  with  the
       directory stream dirp.

       This descriptor is the one used internally by the directory stream.  As
       a result, it is only useful for functions which do  not	depend	on  or
       alter  the  file	 position, such as fstat(2) and fchdir(2).  It will be
       automatically closed when closedir(3) is called.

RETURN VALUE
       On success, a nonnegative file descriptor is returned.  On error, -1 is
       returned.

ERRORS
       POSIX.1-2008  specifies two errors, neither of which is returned by the
       current implementation.

       EINVAL dirp does not refer to a valid directory stream.

       ENOTSUP
	      The implementation does not support the association  of  a  file
	      descriptor with a directory.

CONFORMING TO
       POSIX.1-2008.   This  function  was a BSD extension, present in 4.3BSD-
       Reno, not in 4.2BSD.

NOTES
       The  prototype  for  dirfd()  is	 only  available  if  _BSD_SOURCE   or
       _SVID_SOURCE is defined.

SEE ALSO
       open(2), closedir(3), opendir(3), readdir(3), rewinddir(3), scandir(3),
       seekdir(3), telldir(3)

COLOPHON
       This page is part of release 3.27 of the Linux  man-pages  project.   A
       description  of	the project, and information about reporting bugs, can
       be found at http://www.kernel.org/doc/man-pages/.

Linux				  2010-09-20			      DIRFD(3)
[top]

List of man pages available for Debian

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net