dpm_extendfilelife man page

DPM_EXTENDFILELIFE(3)        DPM Library Functions       DPM_EXTENDFILELIFE(3)

[1mNAME[0m
      dpm_extendfilelife - extend file lifetime

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

      [1mint  dpm_extendfilelife  (char  *[4m[22mr_token[24m[1m,  char *[4m[22msurl[24m[1m, time_t [4m[22mlifetime[24m[1m,[0m
      [1mtime_t *[4m[22mactual_lifetime[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpm_extendfilelife [22mextends file lifetime.

      [4mr_token[0m
             specifies the token returned by a  previous  get,  put  or  copy
             request.

      [4msurl[24m   specifies the name of the file.

      [4mlifetime[0m
             specifies the new lifetime relative to the current time.

      [4mactual_lifetime[0m
             will receive the actual lifetime assigned by the server.

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

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

      [1mEINVAL       [22mThe length of [4mr_token[24m  exceeds  [1mCA_MAXDPMTOKENLEN  [22mor  the
                   token is unknown.

      [1mENAMETOOLONG [22mThe length of the surl exceeds [1mCA_MAXSFNLEN[22m.

      [1mSENOSHOST    [22mHost unknown.

      [1mSEINTERNAL   [22mDatabase error.

      [1mSECOMERR     [22mCommunication error.

LCG                      $Date: 2006/12/20 15:28:25 $    DPM_EXTENDFILELIFE(3)