Finds entries in a directory.

    Format

      #include  <dirent.h>

      struct dirent *readdir  (DIR *dir_pointer);

      int readdir_r  (DIR *dir_pointer, struct dirent *entry, struct
                     dirent **result);