UTIMES(2)               COMMAND REFERENCE               UTIMES(2)



NAME
     utimes - set file times

SYNOPSIS
     #include <sys/time.h>

     utimes(path, tvp)
     char *path;
     struct timeval tvp[2];

DESCRIPTION
     The utimes call uses the values in the tvp array to set the
     "accessed" and "modified" times (in that order) for the file
     named by path. The timeval structure is defined in
     <sys/time.h> as:

          struct timeval {
               long tv_sec;        /* seconds */
               long tv_usec;  /* and microseconds */
          };

     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.

DIAGNOSTICS
     Utimes will fail if one or more of the following are true:

     [ENOASCII]     The pathname contains a character with the
                    high-order bit set.

     [ENAMETOOLONG] The pathname is too long.

     [ENOENT]       The named file does not exist.

     [ENOTDIR]      A component of the path prefix is not a
                    directory.

     [EIO]          An I/O error occurred while reading from or
                    writing to the file system.

     [EACCES]       A component of the path prefix denies search
                    permission.

     [EPERM]        The process is not super-user and not the
                    owner of the file.

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

     [EFAULT]       File or tvp points outside the process's
                    allocated address space.



Printed 5/12/88                                                 1

UTIMES(2)               COMMAND REFERENCE               UTIMES(2)



     [ELOOP]        Too many symbolic links were encountered in
                    translating the pathname.

RETURN VALUE
     Upon successful completion, a value of 0 is returned.
     Otherwise, a value of -1 is returned and errno is set to
     indicate the error.

SEE ALSO
     stat(2).













































Printed 5/12/88                                                 2

%%index%%
na:288,75;
sy:363,846;
de:1209,704;
di:1913,1074;3347,111;
rv:3458,280;
se:3738,145;
%%index%%000000000118