Copyright Digital Equipment Corp. All rights reserved.

Return_Values

   0                  Successful execution.
   -1                 Indicates an error. The file times do not
                      change and the function sets errno to one of
                      the following values:

                      The utimes function will fail if:

                      o  EACCES - Search permission is denied by
                         a component of the path prefix; or the
                         times argument is a NULL pointer and the
                         effective user ID of the process does
                         not match the owner of the file and write
                         access is denied.

                      o  ELOOP - Too many symbolic links were
                         encountered in resolving path.

                      o  ENAMETOOLONG - The length of the path
                         argument exceeds PATH_MAX, a pathname
                         component is longer than NAME_MAX, or a
                         pathname resolution of a symbolic link
                         produced an intermediate result whose
                         length exceeds PATH_MAX.

                      o  ENOENT - A component of path does not
                         name an existing file, or path is an empty
                         string.


                      o  ENOTDIR - A component of the path prefix is
                         not a directory.

                      o  EPERM -The times argument is not a NULL
                         pointer and the calling process's effective
                         user ID has write-access to the file but
                         does not match the owner of the file and
                         the calling process does not have the
                         appropriate privileges.

                      o  EROFS - The file system containing the file
                         is read-only.