xref: /original-bsd/lib/libc/gen/utime.3 (revision 817cfbae)
1.\" Copyright (c) 1980, 1991 Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)utime.3	6.4 (Berkeley) 10/11/91
7.\"
8.Dd
9.Dt UTIME 3
10.Os BSD 4
11.Sh NAME
12.Nm utime
13.Nd set file times
14.Sh SYNOPSIS
15.Fd #include <sys/types.h>
16.Ft int
17.Fn utime "const char *file" "const struct utimbuf *timep"
18.Sh DESCRIPTION
19.Bf -symbolic
20This interface is obsoleted by utimes(2) .
21.Ef
22.Pp
23.Sh DESCRIPTION
24The
25.Fn utime
26function sets the access and modification times of the named file from
27the structures in the argument array
28.Fa timep .
29.Pp
30The calling process's effective user ID must match the owner of the
31file or must be the super-user.
32.Sh SEE ALSO
33.Xr utimes 2 ,
34.Xr stat 2
35.Sh HISTORY
36A
37.Fn utime
38function appeared in
39.At v7 .
40