dpns_utime man page

DPNS_UTIME(3)               DPNS Library Functions               DPNS_UTIME(3)

[1mNAME[0m
      dpns_utime - set last access and modification times

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

      [1mint dpns_utime (const char *[4m[22mpath[24m[1m, struct utimbuf *[4m[22mtimes[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_utime [22msets last access and modification times.

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

      If [4mtimes[24m is NULL, the access and modification times are set to the cur-
      rent  time  else  they  are set to the [1mutimbuf [22mstructure member values.
      ctime is set to current time.

[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
      [1mEPERM        [4m[22mtimes[24m  is  not  NULL and the caller effective user ID does
                   not match the owner ID of the file and the caller does not
                   have ADMIN privilege in the Cupv database.

      [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 and [4mtimes[24m is NULL.

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

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

      [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_stat(3), dpns_statg(3)[22m,
      [1mCupvlist(1)[0m

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

DPNS                     $Date: 2002/10/16 06:25:40 $            DPNS_UTIME(3)