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.

AUTHOR

LCG Grid Deployment Team