[src/trunk]: src/share/man Briefly describe and note also struct bintime.

[jruoho <jruoho%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/71c6d4af38e7
branches:  trunk
changeset: 754959:71c6d4af38e7
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Mon May 17 20:25:19 2010 +0000

description:
Briefly describe and note also struct bintime.

diffstat:

 share/man/man3/timeval.3     |  22 ++++++++++++++++++++--
 share/man/man9/microtime.9   |   6 ++++--
 share/man/man9/microuptime.9 |   6 ++++--
 3 files changed, 28 insertions(+), 6 deletions(-)

diffs (91 lines):

diff -r 2dec8eed57b0 -r 71c6d4af38e7 share/man/man3/timeval.3
--- a/share/man/man3/timeval.3  Mon May 17 20:18:30 2010 +0000
+++ b/share/man/man3/timeval.3  Mon May 17 20:25:19 2010 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: timeval.3,v 1.3 2010/05/17 12:27:13 jruoho Exp $
+.\" $NetBSD: timeval.3,v 1.4 2010/05/17 20:25:19 jruoho Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -129,8 +129,26 @@
 .Va it_value
 is non-zero, it indicates the time left to the next timer expiration.
 A value zero implies that the timer is disabled.
+.It
+The following structure is used by
+.Xr microtime 9 ,
+among others:
+.Bd -literal -offset indent
+struct bintime {
+       time_t          sec;
+       uint64_t        frac;
+};
+.Ed
+.Pp
+The
+.Va sec
+member specifies the time in seconds and the
+.Va frac
+represents 64-bit fraction of seconds.
+The
+.Va struct bintime
+is meant to be used in the kernel only.
 .El
-.Pp
 .Sh STANDARDS
 These structures conform to
 .St -p1003.1-2004 .
diff -r 2dec8eed57b0 -r 71c6d4af38e7 share/man/man9/microtime.9
--- a/share/man/man9/microtime.9        Mon May 17 20:18:30 2010 +0000
+++ b/share/man/man9/microtime.9        Mon May 17 20:25:19 2010 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: microtime.9,v 1.15 2008/11/28 10:55:41 tsutsui Exp $
+.\"     $NetBSD: microtime.9,v 1.16 2010/05/17 20:25:19 jruoho Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -53,7 +53,7 @@
 .\"
 .\" $FreeBSD: src/share/man/man9/microtime.9,v 1.11 2005/10/13 16:01:28 jhb Exp $
 .\"
-.Dd November 24, 2008
+.Dd May 17, 2010
 .Dt MICROTIME 9
 .Os
 .Sh NAME
@@ -112,6 +112,8 @@
 .Fn getnanotime
 functions store the time as a
 .Vt "struct timespec" .
+The structures are described in
+.Xr timeval 3 .
 .Pp
 The
 .Fn bintime ,
diff -r 2dec8eed57b0 -r 71c6d4af38e7 share/man/man9/microuptime.9
--- a/share/man/man9/microuptime.9      Mon May 17 20:18:30 2010 +0000
+++ b/share/man/man9/microuptime.9      Mon May 17 20:25:19 2010 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: microuptime.9,v 1.8 2008/11/28 10:52:22 tsutsui Exp $
+.\" $NetBSD: microuptime.9,v 1.9 2010/05/17 20:25:19 jruoho Exp $
 .\"
 .\" Copyright (c) 2000 Kelly Yancey
 .\" All rights reserved.
@@ -26,7 +26,7 @@
 .\"
 .\" $FreeBSD: src/share/man/man9/microuptime.9,v 1.7 2005/01/12 21:48:25 ru Exp $
 .\"
-.Dd November 24, 2008
+.Dd May 17, 2010
 .Dt MICROUPTIME 9
 .Os
 .Sh NAME
@@ -73,6 +73,8 @@
 .Fn getnanouptime
 functions store the elapsed time as a
 .Vt "struct timespec" .
+These structures are described in
+.Xr timeval 3 .
 .Pp
 The
 .Fn binuptime ,