1LFC_SETATIME(3)              LFC Library Functions             LFC_SETATIME(3)
2
3
4

NAME

6       lfc_setatime  -  set last access time for a regular file to the current
7       time
8

SYNOPSIS

10       #include <sys/types.h>
11       #include "lfc_api.h"
12
13       int lfc_setatime (const char *path, struct lfc_fileid *file_uniqueid)
14

DESCRIPTION

16       lfc_setatime sets the last access time for a regular file to  the  cur‐
17       rent time.  This function should only be called by the stager after the
18       file has been successfully recalled and every time a  stagein  requests
19       this file, even if the file already resides in the disk pool.  The file
20       can be identified by path name or by file_uniqueid.  If both are speci‐
21       fied, file_uniqueid is used.
22
23       path   specifies  the  logical  pathname  relative  to  the current LFC
24              directory or the full LFC pathname.
25

RETURN VALUE

27       This routine returns 0 if the operation was successful  or  -1  if  the
28       operation failed. In the latter case, serrno is set appropriately.
29

ERRORS

31       ENOENT       The named file does not exist or is a null pathname.
32
33       EACCES       Search  permission  is  denied  on a component of the path
34                    prefix or the caller effective user ID does not match  the
35                    owner ID of the file or read permission on the file itself
36                    is denied.
37
38       EFAULT       path and file_uniqueid are NULL pointers.
39
40       ENOTDIR      A component of path prefix is not a directory.
41
42       EISDIR       The file is not a regular file.
43
44       ENAMETOOLONG The length of path exceeds CA_MAXPATHLEN or the length  of
45                    a path component exceeds CA_MAXNAMELEN.
46
47       SENOSHOST    Host unknown.
48
49       SENOSSERV    Service unknown.
50
51       SECOMERR     Communication error.
52
53       ENSNACT      Name server is not running or is being shutdown.
54

SEE ALSO

56       Castor_limits(4), lfc_chdir(3), lfc_statg(3)
57

AUTHOR

59       LCG Grid Deployment Team
60
61
62
63LFC                      $Date: 2001/10/04 12:12:50 $          LFC_SETATIME(3)