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