dpm_accessr man page

DPM_ACCESSR(3)               DPM Library Functions              DPM_ACCESSR(3)

[1mNAME[0m
      dpm_accessr  -  check  existence/accessibility of a file replica in the
      pools

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

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

[1mDESCRIPTION[0m
      [1mdpm_accessr [22mchecks the existence  or  the  accessibility  of  the  file
      replica  according to the dpm. The name server entry for the replica is
      taken into account and that of the associated pool  and,  if  relevant,
      the  status  of  an ongoing put request.  The physical file name [4mpfn[24m is
      checked according to the bit pattern in [4mamode[0m

[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 does not exist.

      [1mEACCES       [22mSearch  permission  is denied on a component of the parent
                   file prefix, the specified access to the  file  itself  is
                   denied  or W_OK is requested but the replica status is not
                   'P' (cannot modify an existing file).

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

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

      [1mENAMETOOLONG [22mThe length of [4mpfn[24m exceeds [1mCA_MAXSFNLEN[22m.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

      [1mEDPMNACT     [22mDisk Pool Manager is not running or is being shutdown.

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

[1mSEE ALSO[0m
      [1mCns_accessr(3)[0m

WLCG                     $Date: 2013/06/12 14:00:00 $           DPM_ACCESSR(3)