NAME

       dpm_accessr - check existence/accessibility of a file replica in the pools

SYNOPSIS

       #include <sys/types.h>
       #include <unistd.h>
       #include "dpm_api.h"

       int dpm_accessr (const char *pfn, int amode);

DESCRIPTION

       dpm_accessr checks 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 pfn is checked according to the bit pattern in amode

RETURN VALUE

       This routine returns 0 if the operation was successful or -1 if the operation  failed.  In
       the latter case, serrno is set appropriately.

ERRORS

       ENOENT       The named file does not exist.

       EACCES       Search  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).

       EFAULT       pfn is a NULL pointer.

       EINVAL       amode is invalid.

       ENAMETOOLONG The length of pfn exceeds CA_MAXSFNLEN.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

       EDPMNACT     Disk Pool Manager is not running or is being shutdown.

       ENSNACT      Name server is not running or is being shutdown.

SEE ALSO

       Cns_accessr(3)