.TH utime() "" "" "System Call (libc)"
.PC "Change file access and modification times"
.B "#include <sys/types.h>"
.B "#include <utime.h>"
\fBint utime(\fIfile, times\^\fB)\fR
\fBchar *\fIfile\^\fB;\fR
\fBtime_t \fItimes\^\fB[2];\fR
.PP
.B utime()
sets the access and modification times associated with the given
.I file
to times obtained from
.IB times [0]
and
\fBtimes\fB[1]\fR, respectively.
The time of last change to the attributes is set to the time of the
.B utime()
call.
.PP
This call must be made by the owner of
.I file
or by the superuser.
.SH Files
.B <sys/types.h>
.SH "See Also"
.Xr "libc," libc
.Xr "restor," restor
.Xr "stat()," stat
.Xr "utime.h" utime.h
.br
\*(PX Standard, \(sc5.6.6
.SH Diagnostics
.B utime()
returns \-1 on errors, such as if
.I file
does not exist or the invoker not the owner.
