UTIME(3)                       Library Routines                       UTIME(3)

NAME

       utime - set file times

SYNOPSIS

       #include <sys/types.h>
       #include <utime.h>

       int utime (const char *file, const struct utimbuf *timep);

DESCRIPTION

       The  utime function sets the access and modification times of the named
       file from the structures in the argument array timep.

       If the times are specified (the timep argument is non-NULL) the  caller
       must be the owner of the file or be the super-user.

       If  the times are not specified (the timep argument is NULL) the caller
       must be the owner of the file, have permission to write the file, or be
       the super-user.

ERRORS

       The  utime function may fail and set errno for any of the errors speci‐
       fied for the library function utimes(2).

BUGS

       The restrictions on ownership listed above are not enforced  under  GNO
       since there is no concept of file ownership.

SEE ALSO

       utimes(2)

HISTORY

       A utime function appeared in Version 7 AT&T UNIX.

STANDARDS

       With  the  exception of the items listed under BUGS, the utime function
       conforms to POSIX 1003.1-88.



GNO                             6 January 1997                        UTIME(3)