macro and text revision (-mdoc version 3)
[unix-history] / usr / src / lib / libc / gen / utime.3
CommitLineData
ae59e04c
CL
1.\" Copyright (c) 1980, 1991 Regents of the University of California.
2.\" All rights reserved.
280f9990 3.\"
ae59e04c 4.\" %sccs.include.redist.man%
280f9990 5.\"
ae59e04c
CL
6.\" @(#)utime.3 6.3 (Berkeley) %G%
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) .
79e6b3c8 21It is available from the compatibility library, libcompat.
ae59e04c
CL
22.Ef
23.Pp
24.Sh DESCRIPTION
280f9990 25The
ae59e04c
CL
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 .