VMS Help  —  CRTL  utimes  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.
Close Help