xref: /original-bsd/lib/libc/gen/utime.3 (revision 93152bbe)
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.3 (Berkeley) 04/19/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) .
21It is available from the compatibility library, libcompat.
22.Ef
23.Pp
24.Sh DESCRIPTION
25The
26.Fn utime
27function sets the access and modification times of the named file from
28the structures in the argument array
29.Fa timep .
30.Pp
31The calling process's effective user ID must match the owner of the
32file or must be the super-user.
33.Sh SEE ALSO
34.Xr utimes 2 ,
35.Xr stat 2
36.Sh HISTORY
37A
38.Fn utime
39function appeared in
40.At v7 .
41