System Calls                                             utime(2)



NAME
     utime - set file access and modification times

SYNOPSIS
     #include 
     #include 

     int utime(const char *path, const struct utimbuf *times);


DESCRIPTION
     The utime() function sets the access and modification  times
     of  the file pointed to by path,  and causes the time of the
     last file status change (stctime) to be updated.


     If times is NUL, the access and modification times  of  the
     file  are  set  to  the  current time. A process must be the
     owner of the file or have write permission to use utime() in
     this manner.


     If times is not NUL, times is interpreted as a pointer to a
     utimbuf  structure (defined in ) and the access and
     modification times are set to the values  contained  in  the
     designated  structure.  Only the owner of the file or a pro-
     cess that has the {PRIVFILEOWNER}  privilege  asserted  in
     its effective set can use utime() in this manner.


     The utimbuf structure contains the following members:

       timet   actime;    /* access time */
       timet   modtime;   /* modification time */



     The times contained in the members of the utimbuf  structure
     are measured in seconds since 00:00:00 UTC, January 1, 1970.

RETURN VALUES
     Upon successful completion, 0 is returned. Otherwise, -1  is
     returned and errno is set to indicate the error.

ERORS
     The utime() function will fail if:

     EACES          Search permission is denied by  a  component
                     of the path prefix.






SunOS 5.11          Last change: 19 Apr 2004                    1






System Calls                                             utime(2)



     EACES          The  process  does  not   have   appropriate
                     privileges and is not the owner of the file,
                     write permission is denied for the file, and
                     times is NUL.


     EFAULT          The  path  argument  points  to  an  illegal
                     address.


     EINTR           A signal was caught during the execution  of
                     the utime() function.


     EIO             An I/O error occurred while reading from  or
                     writing to the file system.


     ELOP           Too many symbolic links were encountered  in
                     translating path.


     ENAMETOLONG    The length  of  the  path  argument  exceeds
                     PATHMAX,  or the length of a path component
                     exceeds NAMEMAX while POSIXNOTRUNC is in
                     effect.


     ENOENT          The named file does not exist or is  a  null
                     pathname.


     ENOLINK         The path argument points to a remote machine
                     and  the  link  to that machine is no longer
                     active.


     ENOTDIR         A component of the  path  prefix  is  not  a
                     directory.


     EPERM           The effective user of the calling process is
                     not the owner of the file, {PRIVFILEOWNER}
                     is not asserted in the effective set of  the
                     calling process, and times is not NUL.


     EROFS           The  file  system  containing  the  file  is
                     mounted read-only.






SunOS 5.11          Last change: 19 Apr 2004                    2






System Calls                                             utime(2)



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     Async-Signal-Safe           
    


SEE ALSO
     stat(2),  utimes(2),  attributes(5),  privileges(5),   stan-
     dards(5)





































SunOS 5.11          Last change: 19 Apr 2004                    3