int dpns_setrstatus (const char *sfn,const char status)
DESCRIPTION
dpns_setrstatus
sets the replica status.
This function should be called for example when a replica becomes available,
i.e. fully populated.
sfn
is the Physical File Name for the replica.
status
specifies the new status.
Valid statuses are:
-
replica is available.
P
replica is being populated.
D
replica is going to be deleted.
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 replica does not exist.
EACCES
Search permission is denied on a component of the file prefix or
the caller effective user ID does not match the owner ID of the file
or read permission on the file itself is denied.