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.

RELATED TO rfio_readdir…

AUTHOR

LCG Grid Deployment Team