NAME

       rfio_readdir - read directory opened by rfio_opendir

SYNOPSIS

       #include <sys/types.h>
       #include <dirent.h>
       #include "rfio_api.h"

       struct dirent *rfio_readdir (RDIR *dirp);

DESCRIPTION

       rfio_readdir  reads  the directory opened by rfio_opendir.  This routine returns a pointer
       to a structure containing the current directory entry.

       dirp   specifies the pointer value returned by rfio_opendir.

NOTES

       Only the fields d_name, d_reclen and on some  platforms  d_namlen  are  filled.   For  LCG
       directories,  a multi-threaded application will need to initialize itself the Cthread (LCG
       Thread Interface) library ; this is done by including  "shift/Cthread_api.h"  and  calling
       the function Cthread_init() at the beginning. Otherwise accessing LCG directories will not
       be thread-safe. See Cthread(3).

RETURN VALUE

       This routine returns a pointer to a structure containing the current  directory  entry  if
       the  operation  was  successful  or NULL if the end of the directory was reached or if the
       operation failed. In the latter case, serrno is set appropriately.

ERRORS

       EBADF        File descriptor in DIR structure is invalid.

       EFAULT       dirp is a NULL pointer.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

SEE ALSO

       rfio_closedir(3), rfio_opendir(3), rfio_rewinddir(3), dirent

AUTHOR

       LCG Grid Deployment Team