xref: /original-bsd/lib/libcompat/4.1/ftime.3 (revision e66a5d85)
1.\" Copyright (c) 1980, 1991 Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)ftime.3	6.3 (Berkeley) 04/19/91
7.\"
8.Dd
9.Dt FTIME 3
10.Os BSD 4
11.Sh NAME
12.Nm ftime
13.Nd get date and time
14.Sh SYNOPSIS
15.Fd #include <sys/types.h>
16.Fd #include <sys/timeb.h>
17.Ft struct timeb *
18.Fn ftime "struct timeb *tp"
19.Sh DESCRIPTION
20.Bf -symbolic
21This interface is obsoleted by gettimeofday(2).
22.Pp
23It is available from the compatibility library, libcompat.
24.Ef
25.Pp
26The
27.Fn ftime
28routine fills in a structure pointed to by its argument,
29as defined by
30.Aq Pa sys/timeb.h :
31.Bd -literal -offset indent
32/*
33 * Structure returned by ftime system call
34 */
35struct timeb
36{
37	  time_t  time;
38	  unsigned short millitm;
39	  short   timezone;
40	  short   dstflag;
41};
42.Ed
43.Pp
44The structure contains the time since the epoch in seconds,
45up to 1000 milliseconds of more-precise interval,
46the local time zone (measured in minutes of time westward from Greenwich),
47and a flag that, if nonzero, indicates that
48Daylight Saving time applies locally during the appropriate part of the year.
49.Sh SEE ALSO
50.Xr gettimeofday 2 ,
51.Xr settimeofday 2 ,
52.Xr time 2 ,
53.Xr ctime 3
54.Sh HISTORY
55The
56.Nm
57function appeared in
58.Bx 4.2 .
59