lfc_setrstatus man page

LFC_SETRSTATUS(3)            LFC Library Functions           LFC_SETRSTATUS(3)

[1mNAME[0m
      lfc_setrstatus - set replica status

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

      [1mint lfc_setrstatus (const char *[4m[22msfn[24m[1m, const char [4m[22mstatus[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mlfc_setrstatus [22msets the replica status.  This function should be called
      for example when a replica becomes available, i.e. fully populated.

      [4msfn[24m    is the Physical File Name for the replica.

      [4mstatus[24m specifies the new status.  Valid statuses are:

             [1m-      [22mreplica is available.

             [1mP      [22mreplica is being populated.

             [1mD      [22mreplica is going to be deleted.

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

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

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

      [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, [1mlfc_listreplica(3)[0m

LFC                      $Date: 2005/04/27 09:11:24 $        LFC_SETRSTATUS(3)