From owner-freebsd-doc  Mon Oct  2 13:20: 7 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id B763E37B66D
	for <freebsd-doc@freebsd.org>; Mon,  2 Oct 2000 13:20:00 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id NAA83504;
	Mon, 2 Oct 2000 13:20:00 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: from monkeys.com (236.dsl9226.rcsis.com [63.92.26.236])
	by hub.freebsd.org (Postfix) with ESMTP id 4919F37B679
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  2 Oct 2000 13:11:10 -0700 (PDT)
Received: (from rfg@localhost)
	by monkeys.com (8.11.1/8.9.3) id e92KB4o79506;
	Mon, 2 Oct 2000 13:11:04 -0700 (PDT)
Message-Id: <200010022011.e92KB4o79506@monkeys.com>
Date: Mon, 2 Oct 2000 13:11:04 -0700 (PDT)
From: "Ronald F. Guilmette" <rfg@monkeys.com>
Reply-To: rfg@monkeys.com (Ronald F. Guilmette)
To: FreeBSD-gnats-submit@freebsd.org
Cc: rfg@monkeys.com
X-Send-Pr-Version: 3.2
Subject: docs/21708: kqueue/kevent man pages isn't specific about `timeout'
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         21708
>Category:       docs
>Synopsis:       kqueue/kevent man pages isn't specific about `timeout'
>Confidential:   no
>Severity:       serious
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Oct 02 13:20:00 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Ronald F. Guilmette
>Release:        FreeBSD 4.1-RELEASE i386
>Organization:
Infinite Monkeys & Co.
>Environment:

>Description:

	The man page for kqueue/kevent doesn't explicitly say what the
	semantics of the `timeout' parameter for the kqueue(2) function
	are.  Will a call to kqueue() timeout and return to the caller
	(with a return value of zero) when no currently-monitored events
	have occured for the amount of _elapsed_ time specified by the
	`timeout' parameter?  Or will a call to kqueue() timeout and return
	to the caller (with a return value of zero) if no monitored events
	have occured by the time the system's own clock says that we have
	reached the time specified by the `timeout' parameter?

	In short, is the `timeout' parameter for kevent(2) interpreted (by
	the kernel) as a _relative_ time period, or as an _absolute_ time
	specification?

	The kevent(2) man page does not make this clear.

>How-To-Repeat:

	RTFManpage

>Fix:

	Specify in the manpage that `timeout' is either (a) relative or else
	(b) absolute.

>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message