compiler/posixc/dirfd.c

   1 /*
   2     Copyright © 1995-2003, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     POSIX.1-2008 function dirfd().
   6 */
   7
   8 #define DEBUG 0
   9 #include <aros/debug.h>
  10
  11 #include "__dirdesc.h"
  12
  13 /*****************************************************************************
  14
  15     NAME */
  16 #include <dirent.h>
  17
  18         int dirfd(
  19
  20 /*  SYNOPSIS */
  21         DIR *dir)
  22
  23 /*  FUNCTION
  24         get directory stream file descriptor
  25
  26     INPUTS
  27         dir - directory stream dir.
  28
  29     RESULT
  30         on error -1 is returned.
  31
  32     NOTES
  33        This descriptor is the one used internally by the directory stream.  As
  34        a  result,  it  is  only useful for functions which do not depend on or
  35        alter the file position, such as fstat(2) and fchdir(2).   It  will  be
  36        automatically closed when closedir(3) is called.
  37
  38     EXAMPLE
  39
  40     BUGS
  41
  42     SEE ALSO
  43         open(), readdir(), closedir(), rewinddir(), seekdir(),
  44         telldir()
  45
  46     INTERNALS
  47
  48 ******************************************************************************/
  49 {
  50   D(bug("dirfd()=%d\n", dir->fd));
  51   return dir->fd;
  52 }