FreeBSD Man Pages

utime(3)

NAME

     utime -- set file times

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <utime.h>

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

DESCRIPTION

     This interface is obsoleted by utimes(2).

     The utime() function sets the access and modification times of the named
     file from the actime and modtime fields of the struct utimbuf pointed at
     by 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).

SEE ALSO

     stat(2), utimes(2)

HISTORY

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

STANDARDS

     The utime() function conforms to IEEE Std 1003.1-1988 (``POSIX.1'').

FreeBSD 5.4			 June 4, 1993			   FreeBSD 5.4

SPONSORED LINKS