dpns_setatime man page


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)