rfio_opendir man page

RFIO_OPENDIR(3)             Rfio Library Functions             RFIO_OPENDIR(3)

[1mNAME[0m
      rfio_opendir - open a directory

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

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

[1mDESCRIPTION[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.

[1mNOTES[0m
      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).

[1mRETURN VALUE[0m
      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.

[1mERRORS[0m
      [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

[1mAUTHOR[0m
      [1mLCG Grid Deployment [22mTeam

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