readdir(3)                 Library Functions Manual                 readdir(3)

<?><?><?><?><?><?><?><?><?><?><?><?>
       readdir - <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>

<?><?><?><?><?><?><?><?><?><?>
       Standard C library (libc, -lc)

<?><?><?><?><?>
       #include <dirent.h>

       struct dirent *readdir(DIR *dirp);

<?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> readdir() <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> dirent,
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>, <?><?><?><?><?><?><?><?><?><?> <?> dirp.
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> NULL <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?> <?><?><?><?><?><?><?><?><?><?> glibc <?><?><?><?><?><?><?><?><?>
       dirent <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>:

           struct dirent {
               ino_t          d_ino;       /* <?><?><?><?><?> <?><?><?><?><?> */
               off_t          d_off;       /* <?><?> <?><?><?><?><?><?><?><?>, <?><?><?><?><?><?><?><?> <?><?><?><?> */
               unsigned short d_reclen;    /* <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> */
               unsigned char  d_type;      /* <?><?><?> <?><?><?><?><?>; <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
                                              <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> */
               char           d_name[256]; /* <?><?><?> <?><?><?><?><?> <?> null <?> <?><?><?><?><?> */
           };

       The only fields in the dirent structure that are mandated by POSIX.1
       are d_name and d_ino.  The other fields are unstandardized, and not
       present on all systems; see VERSIONS.

       <?><?><?><?> <?><?><?><?><?><?><?><?><?> dirent:

       d_ino  <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.

       d_off  <?><?><?><?><?><?><?><?>, <?><?><?><?><?><?><?><?><?><?><?><?>
              <?> d_off, <?><?><?><?> <?><?><?><?><?> <?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?><?> telldir(3) <?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?>, <?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?> <?> <?><?><?>, <?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> d_off <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>, <?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?>(<?><?><?><?><?><?> <?><?><?><?><?><?>) <?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> <?>
              <?><?><?> <?><?><?><?><?><?><?><?><?><?>;
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> telldir(3).

       d_reclen
              This is the size (in bytes) of the returned record.  This may
              not match the size of the structure definition shown above; see
              VERSIONS.

       d_type <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>, <?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              lstat(2), <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?>.

              When a suitable feature test macro is defined (_DEFAULT_SOURCE
              since glibc 2.19, or _BSD_SOURCE on glibc 2.19 and earlier),
              glibc defines the following macro constants for the value
              returned in d_type:

              DT_BLK      <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>

              DT_CHR      <?><?><?><?><?><?><?><?><?><?>
                          <?><?><?><?><?><?><?><?><?><?>

              DT_DIR      <?><?><?><?><?><?><?>

              DT_FIFO     <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
                          (FIFO)

              DT_LNK      <?><?><?><?><?><?><?><?><?><?><?><?><?>
                          <?><?><?><?><?><?>

              DT_REG      <?><?><?><?><?><?><?> <?><?><?><?>

              DT_SOCK     <?><?><?><?><?><?><?><?> <?><?><?><?><?> UNIX

              DT_UNKNOWN  <?><?><?> <?><?><?><?><?>
                          <?><?><?><?><?><?><?><?><?><?>
                          <?><?><?><?><?><?><?><?><?><?>.

              <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>,
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> (<?><?><?><?><?> <?><?><?><?><?><?><?>:
              Btrfs, ext2, ext3 <?> ext4) <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?> d_type.
              <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              DT_UNKNOWN.

       d_name This field contains the null terminated filename; see VERSIONS.

       <?><?><?><?><?><?>, <?><?><?><?><?><?><?><?><?><?><?><?> readdir(),
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> readdir()
       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       readdir() <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> dirent (<?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>; <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?>
       <?><?><?><?><?><?><?> free(3)).

       If the end of the directory stream is reached, NULL is returned and
       errno is not changed.  If an error occurs, NULL is returned and errno
       is set to indicate the error.  To distinguish end of stream from an
       error, set errno to zero before calling readdir()  and then check the
       value of errno if NULL is returned.

<?><?><?><?><?><?>
       EBADF  <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> dirp.

<?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?> attributes(7).

       +----------------------------+----------------------------------------------------------+--------------------------+
       |<?><?><?><?><?><?><?><?><?> | <?><?><?><?><?><?><?>                                    | <?><?><?><?><?><?><?><?> |
       +----------------------------+----------------------------------------------------------+--------------------------+
       |readdir()                   | <?><?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> | MT-Unsafe race:dirstream |
       +----------------------------+----------------------------------------------------------+--------------------------+
       <?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> POSIX.1
       (POSIX.1-2008), <?><?> readdir() <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>.
       <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?><?><?> glibc)
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> readdir()
       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>. <?>
       <?><?><?><?><?><?><?>, <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?>, <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> readdir() <?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>, <?>
       <?><?> <?><?><?><?><?><?><?><?><?><?> readdir_r(3).
       <?><?><?><?><?><?><?><?><?>, <?><?><?> <?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> POSIX.1 <?><?><?> readdir() <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?>
       <?> POSIX.1 <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> d_name <?> d_ino (<?><?><?><?><?><?><?><?><?><?> XSI).
       <?><?><?><?><?> Linux, <?><?><?><?> d_type <?><?><?><?><?><?><?><?>,
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?> BSD. <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>, <?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>. <?> glibc
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?>, <?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?>
       POSIX.1, <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       _DIRENT_HAVE_D_NAMLEN, _DIRENT_HAVE_D_RECLEN, _DIRENT_HAVE_D_OFF
       <?><?><?> _DIRENT_HAVE_D_TYPE.

   <?><?><?><?> d_name
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> dirent,
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>, <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> glibc <?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> d_name <?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       Warning: applications should avoid any dependence on the size of the
       d_name field.  POSIX defines it as char d_name[], a character array of
       unspecified size, with at most NAME_MAX characters preceding the
       terminating null byte ('\0').

       POSIX.1 explicitly notes that this field should not be used as an
       lvalue.  The standard also notes that the use of sizeof(d_name) is
       incorrect; use strlen(d_name) instead.  (On some systems, this field is
       defined as char d_name[1]!)  By implication, the use sizeof(struct
       dirent) to capture the size of the record including the size of d_name
       is also incorrect.

       <?><?><?><?><?><?><?>, <?><?><?> <?><?><?><?> <?><?><?><?><?>

           fpathconf(fd, _PC_NAME_MAX)

       <?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> 255 <?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>, <?><?> <?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       (<?><?><?><?><?><?><?><?>, CIFS, <?><?><?><?><?><?><?> Windows SMB)
       <?><?><?> <?><?><?><?><?> <?> null <?><?><?><?><?>,
       <?><?><?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?><?><?><?><?>) <?>
       d_name, <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>. <?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> d_reclen <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>, <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> glibc dirent,
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?><?>
       POSIX.1-2008.

<?><?><?><?><?><?><?>
       POSIX.1-2001, SVr4, 4.3BSD.

<?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> opendir(3).

       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> readdir() <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>; <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>,
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> <?><?><?><?><?>
       getdents(2), read(2), closedir(3), dirfd(3), ftw(3), offsetof(3),
       opendir(3), readdir_r(3), rewinddir(3), scandir(3), seekdir(3),
       telldir(3)

<?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?>(<?>) aereiae <aereiae@gmail.com>, Azamat
       Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin
       <dseregin@59.ru>, Katrin Kutepova <blackkatelv@gmail.com>, Lockal
       <lockalsash@gmail.com>, Yuri Kozlov <yuray@komyakino.ru>,
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>, <?><?><?><?>
       <?><?><?><?><?><?> <pavia00@gmail.com> <?> Kirill Rekhov
       <krekhov.dev@gmail.com>

       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?>; <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> GNU (GNU General Public License - GPL,
       <https://www.gnu.org/licenses/gpl-3.0.html> <?><?><?><?><?><?> 3
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>) <?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?>, <?><?> <?><?><?> <?><?><?><?><?>-<?><?><?><?>
       <?><?><?><?><?><?><?><?>.

       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?>-<?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?>, <?><?><?><?><?><?><?><?><?><?>,
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?>(<?><?>) <?><?> <?><?><?>(<?><?>)
       <?><?><?><?><?><?>(<?><?>) <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?>
       <<debian-l10n-russian@lists.debian.org>>.

Linux man-pages 6.12       23 <?><?><?><?> 2024 <?>.                readdir(3)