UTIME(2)                 DOMAIN/IX SYS5                  UTIME(2)



NAME
     utime - set file access and modification times

USAGE
     #include <sys/types.h>
     int utime(path, times)
     char *path;
     struct utimbuf *times;


DESCRIPTION
     Utime sets the access and modification times of the file
     named by path.

     If times is NULL, 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 NULL, times is interpreted as a pointer to a
     utimbuf structure and the access and modification times are
     set to the values contained therein.  Only the owner of the
     file or the super-user may use utime this way.

     The times in the following structure are measured in seconds
     since 00:00:00 GMT, Jan. 1, 1970.

       struct    utimbuf        {
            time_t      actime; /* access time */
            time_t      modtime;/* modification time */
       };


RETURN VALUE
     A successful call returns zero.  A failed call returns -1
     and sets errno as indicated below.

ERRORS
     Utime will fail if one or more of the following is true:

     [ENOENT]  The file named does not exist.

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

     [EACCES]  Search permission is denied by a component of the
               path prefix.

     [EPERM]   The effective user ID is not super-user and not
               the owner of the file and times is not NULL.




Printed 12/4/86                                           UTIME-1

UTIME(2)                 DOMAIN/IX SYS5                  UTIME(2)



     [EACCES]  The effective user ID is not super-user and not
               the owner of the file and times is NULL and write
               access is denied.

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

     [EFAULT]  Times is not NULL and points outside the process's
               allocated address space.

     [EFAULT]  Path points outside the process's allocated
               address space.

RELATED INFORMATION
     stat(2)






































UTIME-2                                           Printed 12/4/86