usr/src/lib/libc/gen/utime.3

.\" Copyright (c) 1980, 1991 Regents of the University of California.
.\" All rights reserved.
.\"
.\" %sccs.include.redist.man%
.\"
.\"     @(#)utime.3     6.7 (Berkeley) %G%
.\"
.Dd
.Dt UTIME 3
.Os BSD 4
.Sh NAME
.Nm utime
.Nd set file times
.Sh SYNOPSIS
.Fd #include <sys/types.h>
.Fd #include <utime.h>
.Ft int
.Fn utime "const char *file" "const struct utimbuf *timep"
.Sh DESCRIPTION
.Bf -symbolic
This interface is obsoleted by utimes(2) .
.Ef
.Pp
The
.Fn utime
function sets the access and modification times of the named file from
the structures in the argument array
.Fa timep .
.Pp
If the times are specified (the
.Fa timep
argument is
.Pf non- Dv NULL )
the caller must be the owner of the file or be the super-user.
.Pp
If the times are not specified (the
.Fa timep
argument is
.Dv NULL )
the caller must be the owner of the file, have permission to write
the file, or be the super-user.
.Sh ERRORS
The
.Fn utime
function may fail and set
.Va errno
for any of the errors specified for the library function
.Xr utimes 2 .
.Sh SEE ALSO
.Xr utimes 2 ,
.Xr stat 2
.Sh HISTORY
A
.Fn utime
function appeared in
.At v7 .
Sh STANDARDS
The
.Nm utime
function conforms to
.St -p1003.1 .