home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / unix / armlinux / alpha / PARTITIONS / USR_GZ / usr / include / dirent.h < prev    next >
Encoding:
C/C++ Source or Header  |  1995-05-14  |  4.1 KB  |  138 lines

  1. /* Copyright (C) 1991, 1992 Free Software Foundation, Inc.
  2. This file is part of the GNU C Library.
  3.  
  4. The GNU C Library is free software; you can redistribute it and/or
  5. modify it under the terms of the GNU Library General Public License as
  6. published by the Free Software Foundation; either version 2 of the
  7. License, or (at your option) any later version.
  8.  
  9. The GNU C Library is distributed in the hope that it will be useful,
  10. but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12. Library General Public License for more details.
  13.  
  14. You should have received a copy of the GNU Library General Public
  15. License along with the GNU C Library; see the file COPYING.LIB.  If
  16. not, write to the, 1992 Free Software Foundation, Inc., 675 Mass Ave,
  17. Cambridge, MA 02139, USA.  */
  18.  
  19. /*
  20.  *    POSIX Standard: 5.1.2 Directory Operations    <dirent.h>
  21.  */
  22.  
  23. #ifndef    _DIRENT_H
  24.  
  25. #define    _DIRENT_H    1
  26. #include <features.h>
  27.  
  28. __BEGIN_DECLS
  29.  
  30. #include <gnu/types.h>
  31.  
  32. #define    __need_size_t
  33. #include <stddef.h>
  34.  
  35. #include <sys/types.h>
  36. #include <linux/limits.h>
  37. #include <linux/dirent.h>
  38.  
  39. #if defined(__USE_GNU)
  40. #define    d_fileno    d_ino        /* glibc compatibility.  */
  41. #define    d_namlen    d_reclen    /* glibc compatibility.  */
  42. #endif
  43.  
  44. /* For now, syscall readdir () only supports one entry at a time. It
  45.  * will be changed in the future.
  46. #define NUMENT        3
  47. */
  48. #ifndef NUMENT
  49. #define NUMENT        1
  50. #endif
  51.  
  52. /* Directory stream type.  */
  53. typedef struct {
  54.   int dd_fd;            /* file descriptor */
  55.   int dd_loc;            /* offset in buffer */
  56.   int dd_size;            /* # of valid entries in buffer */
  57.   struct dirent *dd_buf;    /* -> directory buffer */
  58. } DIR;                /* stream data from opendir() */
  59.  
  60.  
  61. /* Open a directory stream on NAME.
  62.    Return a DIR stream on the directory, or NULL if it could not be opened.  */
  63. extern DIR *opendir __P ((__const char *__name));
  64.  
  65. /* Close the directory stream DIRP.
  66.    Return 0 if successful, -1 if not.  */
  67. extern int closedir __P ((DIR * __dirp));
  68.  
  69. /* Read a directory entry from DIRP.
  70.    Return a pointer to a `struct dirent' describing the entry,
  71.    or NULL for EOF or error.  The storage returned may be overwritten
  72.    by a later readdir call on the same DIR stream.  */
  73. extern struct dirent *readdir __P ((DIR * __dirp));
  74.  
  75. /* Rewind DIRP to the beginning of the directory.  */
  76. extern void rewinddir __P ((DIR * __dirp));
  77.  
  78. #if defined(__USE_BSD) || defined(__USE_MISC)
  79.  
  80. #ifndef    MAXNAMLEN
  81. /* Get the definitions of the POSIX.1 limits.  */
  82. #include <posix1_lim.h>
  83.  
  84. /* `MAXNAMLEN' is the BSD name for what POSIX calls `NAME_MAX'.  */
  85. #ifdef    NAME_MAX
  86. #define    MAXNAMLEN    NAME_MAX
  87. #else
  88. #define    MAXNAMLEN    255
  89. #endif
  90. #endif
  91.  
  92. #include <gnu/types.h>
  93.  
  94. /* Seek to position POS on DIRP.  */
  95. extern void seekdir __P ((DIR * __dirp, __off_t __pos));
  96.  
  97. /* Return the current position of DIRP.  */
  98. extern __off_t telldir __P ((DIR * __dirp));
  99.  
  100. typedef int (*__dir_select_fn_t) __P ((__const struct dirent *));
  101.  
  102. typedef int (*__dir_compar_fn_t) __P ((
  103.         __const struct dirent * __const *,
  104.         __const struct dirent * __const *
  105.         ));
  106.  
  107. /* Scan the directory DIR, calling SELECT on each directory entry.
  108.    Entries for which SELECT returns nonzero are individually malloc'd,
  109.    sorted using qsort with CMP, and collected in a malloc'd array in
  110.    *NAMELIST.  Returns the number of entries selected, or -1 on error.  */
  111. extern int scandir __P ((__const char *__dir,
  112.              struct dirent ***__namelist,
  113.              __dir_select_fn_t __select,
  114.              __dir_compar_fn_t __compar));
  115.  
  116. /* Function to compare two `struct dirent's alphabetically.  */
  117. extern int alphasort __P ((
  118.         __const struct dirent * __const *,
  119.         __const struct dirent * __const *
  120.         ));
  121.  
  122.  
  123. /* Read directory entries from FD into BUF, reading at most NBYTES.
  124.    Reading starts at offset *BASEP, and *BASEP is updated with the new
  125.    position after reading.  Returns the number of bytes read; zero when at
  126.    end of directory; or -1 for errors.  */
  127. extern __ssize_t __getdirentries __P ((int __fd, char *__buf,
  128.                        size_t __nbytes, __off_t *__basep));
  129. extern __ssize_t getdirentries __P ((int __fd, char *__buf,
  130.                      size_t __nbytes, __off_t *__basep));
  131.  
  132.  
  133. #endif /* Use BSD or misc.  */
  134.  
  135. __END_DECLS
  136.  
  137. #endif /* dirent.h  */
  138.