utime(2)                                                 utime(2)



     NAME
          utime - set file access and modification times

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

     DESCRIPTION
          utime sets the access and modification times of the named
          file.  The pointer path points to a pathname for naming a
          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 superuser may use utime
          this way.

          The times in the following structure, defined in <utime.h>
          are measured in seconds since 00:00:00 GMT, January 1, 1970.

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


     RETURN VALUE
          Upon successful completion, a value of 0 is returned.  Oth-
          erwise, a value of -1 is returned and errno is set to indi-
          cate the error.

     ERRORS
          utime will fail if one or more of the following is true.

          [ENOENT]     The named file does not exist.

          [EPERM]      A pathname contains a character with the high-
                       order bit set.

          [ENAMETOOLONG]
                       A component of a pathname exceeded NAME_MAX
                       characters, or an entire pathname exceeded
                       PATH_MAX.



     April, 1990                                                     1

     utime(2)                                                 utime(2)



          [ELOOP]      Too many symbolic links were encountered in
                       translating a pathname.

          [ENOTDIR]    A component of the path prefix is not a direc-
                       tory.

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

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

          [EACCES]     The effective user ID is not superuser and not
                       the owner of the file, 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 ad-
                       dress space.

     SEE ALSO
          stat(2).




























     2                                                     April, 1990