UTIME(S)                 XENIX System V                  UTIME(S)



     Name
          utime - Sets file access and modification times.

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

     Description
          path points to a pathname 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:

               The named file does not exist.  [ENOENT]

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

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

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

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

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




     Page 1                                           (printed 8/7/87)

     UTIME(S)                 XENIX System V                  UTIME(S)



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

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

     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(S)










































     Page 2                                           (printed 8/7/87)