From owner-freebsd-doc Thu Aug 12 0:30:48 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 6677B14E69 for ; Thu, 12 Aug 1999 00:30:45 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id AAA48559; Thu, 12 Aug 1999 00:30:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Thu, 12 Aug 1999 00:30:02 -0700 (PDT) Message-Id: <199908120730.AAA48559@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: kbyanc@posi.net Subject: docs/13079: new man page describing timeradd() family of macros Reply-To: kbyanc@posi.net Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/13079; it has been noted by GNATS. From: kbyanc@posi.net To: FreeBSD-gnats-submit@freebsd.org Cc: Subject: docs/13079: new man page describing timeradd() family of macros Date: Wed, 11 Aug 1999 11:34:01 -0400 (EDT) >Number: 13079 >Category: docs >Synopsis: new man page describing timeradd() family of macros >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Wed Aug 11 08:40:00 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Kelly Yancey >Release: FreeBSD 3.2-STABLE i386 >Organization: >Environment: >Description: Below is a brief man page for the timeradd() family of macros found in . Also included is a simple patch to the gettimeofday(2) man page to include a reference to this page. .\" Copyright (c) 1999 Kelly Yancey .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" $Id:$ .\" .Dd Aug 11, 1999 .Dt TIMERADD 2 .Os BSD 4 .Sh NAME .Nm timeradd , .Nm timersub , .Nm timerclear , .Nm timerisset , .Nm timercmp .Nd operations on timevals .Sh SYNOPSIS .Fd #include .Fn timeradd "&tvp" "&uvp" "&vvp" .Fn timersub "&tvp" "&uvp" "&vvp" .Fn timerclear "&tvp" .Fn timerisset "&tvp" .Fn timercmp "&tvp" "&uvp" "cmp" .Sh DESCRIPTION .Pp These macros are provided for manipulating .Fa timeval structures for use with the .Fn gettimeofday and .Fn settimeofday calls. The structures pointed to by .Fa tvp , .Fa uvp , and .Fa vvp are defined in .Ao Pa sys/time.h Ac as: .Pp .Bd -literal struct timeval { long tv_sec; /* seconds since Jan. 1, 1970 */ long tv_usec; /* and microseconds */ }; .Ed .Pp .Fn timeradd adds the time information stored in .Fa uvp to .Fa tvp and stores the resulting .Fa timeval in .Fa vvp . The results are simplified such that the value of .Fa vvp->tv_usec is always less than 1,000,000 (1 second). .Pp .Fn timersub subtracts the time information stored in .Fa uvp from .Fa tvp and stores the resulting .Fa timeval in .Fa vvp . .Pp .Fn timerclear initializes .Fa tvp to midnight (0 hour) January 1st, 1970 (the Epoch). .Pp .Fn timerisset returns true if .Fa tvp is set to any time value other than the Epoch. .Pp .Fn timercmp compares .Fa tvp to .Fa uvp using the comparison operator given in .Fa cmp and returns the result of that comparison. .Sh SEE ALSO .Xr gettimeofday 2 , .Sh HISTORY The .Fn timeradd family of macros appeared in NetBSD. And here is the simple patch for gettimeofday(2): --- gettimeofday.2.orig Wed Aug 11 11:32:45 1999 +++ gettimeofday.2 Wed Aug 11 11:33:08 1999 @@ -120,6 +120,7 @@ .Sh SEE ALSO .Xr date 1 , .Xr adjtime 2 , +.Xr timeradd 2 , .Xr ctime 3 , .Xr clocks 7 , .Xr timed 8 >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message