manpagez: man pages & more
man utime(3)
Home | html | info | man
utime(3)                 BSD Library Functions Manual                 utime(3)


NAME

     utime -- set file times


LIBRARY

     Standard C Library (libc, -lc)


SYNOPSIS

     #include <utime.h>

     int
     utime(const char *path, const struct utimbuf *times);


DESCRIPTION

     This interface is obsoleted by utimes(2).

     The utime() function sets the access and modification times of the named
     file, based on the actime and modtime fields of the struct utimbuf
     pointed at by times.

     If the times are specified (the times 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 times 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)


STANDARDS

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


HISTORY

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

BSD                              June 4, 1993                              BSD

Mac OS X 10.8 - Generated Fri Aug 31 18:17:35 CDT 2012
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.