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. 8/20/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.

          [EINTR]        A signal was caught during the utime system
                         call.

          [ENOLINK]      Path points to a remote machine and the link
                         to that machine is no longer active.

          [EMULTIHOP]    Components of path require hopping to
                         multiple remote machines.

     SEE ALSO
          stat(2).

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

     ORIGIN
          AT&T V.3






























     Page 2                                        (last mod. 8/20/87)