utime(2)                                                 utime(2)



     NAME
          utime - set file access and modification times

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

     DESCRIPTION
          path points to a path name naming a file.  utime sets the
          access and modification times of the named file.

          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 in the designated structure.
          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 */
          };

          utime will fail if one or more of the following are true:

          [ENOENT]       The named file 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.

          [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.



     Page 1                                        (last mod. 1/14/87)

     utime(2)                                                 utime(2)



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

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

     RETURN VALUE
          Upon successful completion, a value of 0 is returned.
          Otherwise, a value of -1 is returned and errno is set to
          indicate the error.

     SEE ALSO
          stat(2).










































     Page 2                                        (last mod. 1/14/87)