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 */
        };


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

     The utime command 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



January 1992                                                    1

utime(2)                                                 utime(2)



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

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

     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 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 address
          space.

SEE ALSO
     stat(2)


















2                                                    January 1992