dpns_readdirx man page

DPNS_READDIRX(3)            DPNS Library Functions            DPNS_READDIRX(3)

[1mNAME[0m
      dpns_readdirx  - read DPNS directory opened by [1mdpns_opendir [22min the name
      server

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

      [1mstruct dpns_direnstat *dpns_readdirx (dpns_DIR *[4m[22mdirp[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_readdirx [22mreads the DPNS directory opened by  [1mdpns_opendir  [22min  the
      name  server.  This routine returns a pointer to a structure containing
      the current directory entry including the [1mstat [22minformation.  [1mdpns_read-[0m
      [1mdirx  [22mcaches  a variable number of such entries, depending on the file-
      name size, to minimize the number of requests to the name server.

      [4mdirp[24m   specifies the pointer value returned by [1mdpns_opendir[22m.

[1mRETURN VALUE[0m
      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. When the  end  of
      the  directory  is encountered, serrno is not changed. If the operation
      failed, [1mserrno [22mis set appropriately.

      As dpns_readdirx returns a null pointer both at the end of  the  direc-
      tory and on error, an application wishing to check for error situations
      should set [1mserrno [22mto 0, then call dpns_readdirx, then check [1mserrno  [22mand
      if it is non-zero, assume an error has occurred.

[1mERRORS[0m
      [1mEBADF        [22mFile descriptor in DIR structure is invalid.

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

      [1mSECOMERR     [22mCommunication error.

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

[1mSEE ALSO[0m
      [1mdpns_closedir(3)[22m, [1mdpns_opendir(3)[22m, [1mdpns_rewinddir(3)[22m, [1mdirent[22m, [1mstat(2)[0m

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

DPNS         $Date: 2011-06-15 09:20:59 +0200 (Wed, 15 Jun 2011D)PN$S_READDIRX(3)

Referenced By

dpns_closedir(3), dpns_opendir(3), dpns_rewinddir(3).