utimes(2)                  DG/UX 4.30                   utimes(2)



     NAME
          utimes - set file access and modification times

     SYNOPSIS
          #include <sys/time.h>

          int   utimes  (path, times)
          char *         path;
          struct timeval times[2];

     PARAMETERS
          path           Address of a pathname.

          times          Address of an initialized array of two time
                         values giving the access and modification
                         times.

     DESCRIPTION
          Path points to a pathname naming a file, which must reside
          on a file system device mounted read-write.  If path refers
          to a symbolic link, the target of the symbolic link is
          affected.  Utimes sets the `time-last-accessed' and `time-
          last-modified' attributes of the subject file to times[0]
          and times[1] respectively.

          If utimes fails, the file is left unchanged.  Otherwise, the
          `time-last-changed' attribute of the subject file is set to
          the current time.

     ACCESS CONTROL
          The calling process must have permission to resolve path.

          The calling process's effective user id must be superuser or
          the user id of the subject file.

     RETURN VALUE
          0              The file's access and modification times were
                         changed successfully.

          -1             An error occurred.  Errno is set to indicate
                         the error.

     EXCEPTIONS
          Errno may be set to one of the following error codes:

          EFAULT         Some part of the array pointed to by times
                         lies outside the process's readable address
                         space.

          EPERM          Permission to set the access and modification
                         times to an arbitrary value is denied to the
                         calling process.



     Licensed material--property of copyright holder(s)         Page 1

     utimes(2)                  DG/UX 4.30                   utimes(2)



          EROFS          The file system device containing the subject
                         file is mounted read-only.

          ENOENT         The file the pathname resolved to does not
                         exist.

          ENOENT         A non-terminal component of the pathname does
                         not exist.

          ENOTDIR        A non-terminal component of the pathname was
                         not a directory or symbolic link.

          ENAMETOOLONG   The pathname exceeds the length limit for
                         pathnames.

          ENAMETOOLONG   A component of the pathname exceeds the
                         length limit for filenames.

          ENOMEM         There are not enough system resources to
                         resolve the pathname or to expand a symbolic
                         link.

          ELOOP          The number of symbolic links encountered
                         during pathname resolution exceeded
                         MAXSYMLINKS.  A symbolic link cycle is
                         suspected.

          EPERM          The pathname contains a character not in the
                         allowed character set.

          EFAULT         The pathname does not completely reside in
                         the process's address space or the pathname
                         does not terminate in the process's address
                         space.

     SEE ALSO
          dg_mstat(2), lstat(2), stat(2), ustat(2), utime(2), stat(5).


















     Licensed material--property of copyright holder(s)         Page 2