RFIO_READDIR

Section: Rfio Library Functions (3)
Updated: $Date: 2010-04-05 09:51:26 +0200 (Mon, 05 Apr 2010) $
Index Return to Main Contents
 

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