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