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



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.

     If times is NULL, the access and modification times of the
     file are set to the current time.  A process must be the
     owner of the file or have write permission to use utime in
     this manner.

     If times is not NULL, times is interpreted as a vector with
     two time_t elements, the ``accessed'' and ``updated'' times
     for path in that order.  Only the owner of the file or the
     super-user may use utime in this manner.

     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



                        Printed 11/19/92                   Page 1

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



                         allocated address space.

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

     [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 11/19/92