dpns_setfsize man page

DPNS_SETFSIZE(3)            DPNS Library Functions            DPNS_SETFSIZE(3)

[1mNAME[0m
      dpns_setfsize  - set filesize for a regular file; set also last modifi-
      cation time to the current time

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

      [1mint dpns_setfsize (const char *[4m[22mpath[24m[1m, struct dpns_fileid *[4m[22mfile_uniqueid[24m[1m,[0m
      [1mu_signed64 [4m[22mfilesize[24m[1m)[0m

      [1mint    dpns_setfsizec    (const    char   *[4m[22mpath[24m[1m,   struct   dpns_fileid[0m
      [1m*[4m[22mfile_uniqueid[24m[1m, u_signed64 [4m[22mfilesize[24m[1m, const char *[4m[22mcsumtype[24m[1m, char  *[4m[22mcsum-[0m
      [4mvalue[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_setfsize  [22msets  the filesize for a regular file; set also the last
      modification time to the current time.  This function  should  only  be
      called  by the stager after the last write operation has been performed
      on  the  file.   The  file  can  be  identified  by  [4mpath[24m  name  or  by
      [4mfile_uniqueid[24m.  If both are specified, [4mfile_uniqueid[24m is used.

      [4mpath[24m   specifies  the  logical  pathname  relative  to the current DPNS
             directory or the full DPNS pathname.

      [4mcsumtype[0m
             specifies the type of checksum. Valid types are:

             [1mCS     [22mstandard 32 bits checksum

             [1mAD     [22mAdler 32 bits checksum

             [1mMD     [22mMD5 128 bits checksum

[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       [22mA  component  of  [4mpath[24m  prefix does not exist or [4mpath[24m is a
                   null pathname.

      [1mEACCES       [22mSearch permission is denied on a  component  of  the  [4mpath[0m
                   prefix  or the caller effective user ID does not match the
                   owner ID of the file  or  write  permission  on  the  file
                   itself is denied.

      [1mEFAULT       [4m[22mpath[24m and [4mfile_uniqueid[24m are NULL pointers.

      [1mENOTDIR      [22mA component of [4mpath[24m prefix is not a directory.

      [1mEISDIR       [22mThe file is not a regular file.

      [1mEINVAL       [22mThe  length  of  the  [4mcsumtype[24m exceeds 2 or [4mcsumtype[24m is an
                   unknown type or the length of the [4mcsumvalue[24m exceeds 32.

      [1mENAMETOOLONG [22mThe length of [4mpath[24m exceeds [1mCA_MAXPATHLEN [22mor the length  of
                   a [4mpath[24m component exceeds [1mCA_MAXNAMELEN[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_chdir(3)[22m, [1mdpns_statg(3)[0m

[1mAUTHOR[0m
      [1mLCG Grid Deployment [22mTeam

DPNS                     $Date: 2008/09/19 11:32:26 $         DPNS_SETFSIZE(3)

Referenced By

dpns_setfsizec(3) is an alias of dpns_setfsize(3).