rfio_opendir man page

RFIO_OPENDIR(3) Rfio Library Functions RFIO_OPENDIR(3)

rfio_opendir - open a directory

[1m#include <sys/types.h>[0m
[1m#include "rfio_api.h"[0m

[1mRDIR *rfio_opendir (const char *[4m[22mpath[24m[1m);[0m

[1mrfio_opendir [22mopens a directory to be used in subsequent [1mrfio_readdir[0m
operations. A [1mRDIR [22mstructure and a buffer to cache the directory
entries are allocated in the client API.

[4mpath[24m specifies the logical pathname relative to the current directory
or the full pathname.

For LCG directories, a multi-threaded application will need to initial-
ize 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 [1mCthread[22m(3).

This routine returns a pointer to be used in the subsequent directory
function calls if the operation was successful or NULL if the operation
failed. In the latter case, [1mserrno [22mis set appropriately.

[1mENOENT [22mA component of [4mpath[24m prefix does not exist or [4mpath[24m is a
null pathname.

[1mEACCES [22mSearch permission is denied on a component of the [4mpath[0m
prefix or read permission is denied on [4mpath[24m.

[1mEFAULT [4m[22mpath[24m is a NULL pointer.

[1mENOTDIR [22mA component of [4mpath[24m prefix is not a directory.

[1mENAMETOOLONG [22mThe length of [4mpath[24m exceeds [1mCA_MAXPATHLEN [22mor the length of
a [4mpath[24m component exceeds [1mCA_MAXNAMELEN[22m.

[1mSENOSHOST [22mHost unknown.

[1mSENOSSERV [22mService unknown.

[1mSECOMERR [22mCommunication error.

[1mSEE ALSO[0m
[1mCastor_limits(4)[22m, [1mrfio_closedir(3)[22m, [1mrfio_readdir(3)[22m, [1mrfio_rewinddir(3)[0m

[1mLCG Grid Deployment [22mTeam

LCG $Date: 2005/03/31 13:13:03 $ RFIO_OPENDIR(3)