UTIME(2-SysV)       RISC/os Reference Manual        UTIME(2-SysV)



NAME
     utime - set file access and modification times

SYNOPSIS
     #include <sys/types.h>
     int utime (path, times)
     char *path;
     timet times[2];

DESCRIPTION
     path points to a path name naming a file.  utime sets the
     access and modification times of the named file.

     The utime call uses the ``acessed'' and ``updated'' times in
     that order from the times vector to set the corresponding
     recorded times for file.

     The caller must be the owner of the file or the super-user.
     The ``inode-changed'' time of the file is set to the current
     time.

ERRORS
     utime will fail if one or more of the following are 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 com-
                         ponent of the path prefix.

     [EPERM]             The effective user ID is not super-user
                         and not the owner of the file and times
                         is not NULL.

     [EACCES]            The effective user ID is not super-user
                         and not the owner of the file and times
                         is NULL and write access is denied.

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

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

     [EFAULT]            path points outside the process's allo-
                         cated address space.

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




                         Printed 1/15/91                   Page 1

UTIME(2-SysV)       RISC/os Reference Manual        UTIME(2-SysV)



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

     [EMULTIHOP]         Components of path require hopping to
                         multiple remote machines.

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.









































 Page 2                  Printed 1/15/91