dpns_access man page

DPNS_ACCESS(3)              DPNS Library Functions              DPNS_ACCESS(3)

[1mNAME[0m
      dpns_access - check existence/accessibility of a file/directory

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

      Under Windows/NT:
      [1m#include <sys/types.h>[0m
      [1m#define R_OK 4[0m
      [1m#define W_OK 2[0m
      [1m#define X_OK 1[0m
      [1m#define F_OK 0[0m
      [1m#include "dpns_api.h"[0m

      [1mint dpns_access (const char *[4m[22mpath[24m[1m, int [4m[22mamode[24m[1m);[0m

[1mDESCRIPTION[0m
      [1mdpns_access  [22mchecks  in  the  name server database the existence or the
      accessibility of the file/directory [4mpath[24m according to the  bit  pattern
      in [4mamode[24m using the real user ID.

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

      [4mamode[24m  the bit pattern is built by an OR of the  constants  defined  in
             <[1munistd.h[22m>  under  Unix  or  to be explicitly defined under Win-
             dows/NT:

             [1mR_OK   [22mtest for read permission

             [1mW_OK   [22mtest for write permission

             [1mX_OK   [22mtest for search/execute permission

             [1mF_OK   [22mtest for existence of the directory/file.

[1mRETURN VALUE[0m
      This routine returns 0 if the operation was successful  or  -1  if  the
      operation failed. In the latter case, [1mserrno [22mis set appropriately.

[1mERRORS[0m
      [1mENOENT       [22mThe  named  file/directory does not exist or is a dangling
                   symbolic link.

      [1mEACCES       [22mSearch permission is denied on a  component  of  the  [4mpath[0m
                   prefix or specified access to the file itself is denied.

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

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

      [1mEINVAL       [4m[22mamode[24m is invalid.

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

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

[1mSEE ALSO[0m
      [1mCastor_limits(4)[22m,             [1mdpns_chdir(3)[22m,             [1mdpns_chmod(3)[22m,
      [1mdpns_stat(3), dpns_statg(3)[0m

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

DPNS         $Date: 2011-02-18 08:03:13 +0100 (Fri, 18 Feb 2011)D$PNS_ACCESS(3)