dpns_opendirxg man page

DPNS_OPENDIRG(3)            DPNS Library Functions            DPNS_OPENDIRG(3)

[1mNAME[0m
      dpns_opendir - open a DPNS directory, having the specified GUID, in the
      name server

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

      [1mdpns_DIR *dpns_opendir (const char *[4m[22mpath[24m[1m, const char *[4m[22mguid[24m[1m)[0m

      [1mdpns_DIR *dpns_opendirxg (char *[4m[22mserver[24m[1m, const char  *[4m[22mpath[24m[1m,  const  char[0m
      [1m*[4m[22mguid[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_opendir  [22mopens a DPNS directory, having the specified GUID, in the
      name server to  be  used  in  subsequent  [1mdpns_readdir  [22moperations.   A
      [1mdpns_DIR  [22mstructure  and  a  buffer  to cache the directory entries are
      allocated in the client API.

      [4mguid[24m   specifies the Grid Unique IDentifier.

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

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

      [1mEINVAL       [22mThe length of the [4mguid[24m component exceeds [1mCA_MAXGUIDLEN.[0m

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

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

      [1mENSNACT      [22mName server is not running or is being shutdown.

[1mSEE ALSO[0m
      [1mCastor_limits(4)[22m,  [1mdpns_chdir(3)[22m,  [1mdpns_closedir(3)[22m,   [1mdpns_readdir(3)[22m,
      [1mdpns_rewinddir(3)[0m

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

DPNS                     $Date: 2005/11/22 15:59:39 $         DPNS_OPENDIRG(3)