dpns_delreplica man page

DPNS_DELREPLICA(3)          DPNS Library Functions          DPNS_DELREPLICA(3)

[1mNAME[0m
      dpns_delreplica - delete a replica for a given file

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

      [1mint    dpns_delreplica    (const   char   *[4m[22mguid[24m[1m,   struct   dpns_fileid[0m
      [1m*[4m[22mfile_uniqueid[24m[1m, const char *[4m[22msfn[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_delreplica [22mdeletes a given replica. An extra check may be obtained
      by  specifying [4mguid[24m or [4mfile_uniqueid[24m.  If both are given, [4mfile_uniqueid[0m
      is used.

      [4mguid[24m   specifies the Grid Unique IDentifier.

      [4msfn[24m    is either the Site  URL  or  the  Physical  File  Name  for  the
             replica.

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

      [1mEACCES       [22mSearch 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.

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

      [1mEINVAL       [22mThe length of [4mguid[24m exceeds [1mCA_MAXGUIDLEN[22m.

      [1mENAMETOOLONG [22mThe length of [4msfn[24m exceeds [1mCA_MAXSFNLEN[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_addreplica(3)[22m, [1mdpns_listreplica(3)[0m

DPNS                     $Date: 2005/07/26 12:09:11 $       DPNS_DELREPLICA(3)