xref: /original-bsd/lib/libc/gen/utime.3 (revision a8414ee1)
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.5 (Berkeley) 03/29/92
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.Fd #include <utime.h>
17.Ft int
18.Fn utime "const char *file" "const struct utimbuf *timep"
19.Sh DESCRIPTION
20.Bf -symbolic
21This interface is obsoleted by utimes(2) .
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