utime(2)                         DG/UX 5.4.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;

   where:
       path      Address of a pathname

       times     NULL or address of an initialized structure 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.  Utime sets the `time-
       last-accessed' and `time-last-modified' attributes of the subject
       file.  If times is NULL, `time-last-accessed' and `time-last-
       modified' are set to the current time.  Otherwise, the `time-last-
       accessed' is set to (*times).actime and `time-last-modified' is set
       to (*times).modtime.

       If utime 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.

       If times is NULL, either the calling process must have write
       permission to the subject file or the calling process's effective
       user id must be equal to the user id of the subject file.

       Otherwise, 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.

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

       EACCES         Permission to set the access and modification times to
                      the current time is denied to the calling process.

       EFAULT         Times is not NULL and some part of the utimbuf



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

utime(2)                         DG/UX 5.4.2                        utime(2)


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

       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.

SEE ALSO
       touch(1), dgmstat(2), lstat(2), stat(2), ustat(2), utimes(2),
       stat(5).






















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