dpns_setatime man page

DPNS_SETATIME(3)            DPNS Library Functions            DPNS_SETATIME(3)

      dpns_setatime  - set last access time for a regular file to the current

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

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

      [1mdpns_setatime [22msets the last access time for a regular file to the  cur-
      rent time.  This function should only be called by the stager after the
      file has been successfully recalled and every time a  stagein  requests
      this file, even if the file already resides in the disk pool.  The file
      can be identified by [4mpath[24m name or by [4mfile_uniqueid[24m.  If both are speci-
      fied, [4mfile_uniqueid[24m is used.

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

      This routine returns 0 if the operation was successful  or  -1  if  the
      operation failed. In the latter case, [1mserrno [22mis set appropriately.

      [1mENOENT       [22mThe named file does not exist or 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 read 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.

      [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)[0m

      [1mLCG Grid Deployment [22mTeam

DPNS                     $Date: 2001/10/04 12:12:50 $         DPNS_SETATIME(3)