dpns_setrltime man page

DPNS_SETRLTIME(3)           DPNS Library Functions           DPNS_SETRLTIME(3)

[1mNAME[0m
      dpns_setrltime - set replica lifetime

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

      [1mint dpns_setrltime (const char *[4m[22msfn[24m[1m, time_t [4m[22mltime[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_setrltime  [22msets  the  lifetime for a file replica to a given time.
      This function should be called everytime a file replica is  created  or
      when its lifetime is extended.

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

      [4mltime[24m  specifies the new lifetime.

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

DPNS                     $Date: 2006/12/01 09:19:37 $        DPNS_SETRLTIME(3)