NAME

       dpm_delreplica - delete a given replica

SYNOPSIS

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

       int dpm_delreplica (char *pfn)

DESCRIPTION

       dpm_delreplica  deletes  a given replica.  It removes the file from disk, updates the pool
       free space and removes the replica entry from the DPNS.

       pfn    is the Physical File Name for the replica.

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

       EACCES       Search  permission  is  denied  on a component of the parent directory or the
                    effective user ID does not match the owner of the file or write permission on
                    the file entry itself is denied.

       EFAULT       pfn is a NULL pointer.

       ENAMETOOLONG The length of pfn exceeds CA_MAXSFNLEN.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

SEE ALSO

       Castor_limits(4), dpns_addreplica(3), dpns_listreplica(3)