utime(2)             INTERACTIVE UNIX System             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
               The path variable points to a path name naming a file.  The
               utime system call 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 superuser may use utime
               this way.

               The times in the following structure are measured in seconds
               since 00:00:00 Greenwich Mean Time (GMT), Jan. 1, 1970.

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

               The utime system call will fail if one or more of the fol-
               lowing is 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 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, and times is NULL
                              and write access is denied.



          Rev. 1.2                                                   Page 1

          utime(2)             INTERACTIVE UNIX System             utime(2)



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

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

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

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

               [ENOLINK]      The path variable points to a remote machine,
                              and the link to that machine is no longer
                              active.

               [EMULTIHOP]    Components of path require hopping to multi-
                              ple remote machines.

               [ENAMETOOLONG] (POSIX Only)  The length of the path argument
                              exceeds {PATH_MAX}, or a path name component
                              is longer than {NAME_MAX} while
                              {_POSIX_NO_TRUNC} is in effect.

          SEE ALSO
               stat(2).

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























          Rev. 1.2                                                   Page 2