From owner-cvs-all Sat May 6 3: 0:55 2000 Delivered-To: cvs-all@freebsd.org Received: from columbus.cris.net (columbus.cris.net [212.110.128.65]) by hub.freebsd.org (Postfix) with ESMTP id 784E437B7C8; Sat, 6 May 2000 03:00:34 -0700 (PDT) (envelope-from phantom@FreeBSD.org.ua) Received: from phantom.cris.net (phantom.cris.net [212.110.130.74]) by columbus.cris.net (8.9.3/8.9.3) with ESMTP id NAA18748; Sat, 6 May 2000 13:00:16 +0300 (EEST) Received: (from phantom@localhost) by phantom.cris.net (8.9.3/8.9.3) id NAA05476; Sat, 6 May 2000 13:01:09 +0300 (EEST) (envelope-from phantom) Date: Sat, 6 May 2000 13:01:09 +0300 From: Alexey Zelkin To: Jonathan Lemon Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/lib/libc/sys kqueue.2 Makefile.inc Message-ID: <20000506130109.A5339@phantom.cris.net> References: <200005042011.NAA23864@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <200005042011.NAA23864@freefall.freebsd.org>; from jlemon@FreeBSD.org on Thu, May 04, 2000 at 01:11:43PM -0700 X-Operating-System: FreeBSD 4.0-STABLE i386 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG hi, On Thu, May 04, 2000 at 01:11:43PM -0700, Jonathan Lemon wrote: > jlemon 2000/05/04 13:11:42 PDT > > Modified files: > lib/libc/sys Makefile.inc > Added files: > lib/libc/sys kqueue.2 > Log: > Add a kqueue(2) manual page. Some mdoc(7) tweaks on that page. -- /* Alexey Zelkin && phantom@cris.net */ /* Tavric National University && phantom@crimea.edu */ /* http://www.ccssu.crimea.ua/~phantom && phantom@FreeBSD.org */ Index: Makefile.inc =================================================================== RCS file: /home/ncvs/src/lib/libc/sys/Makefile.inc,v retrieving revision 1.77 diff -u -r1.77 Makefile.inc --- Makefile.inc 2000/05/04 20:11:37 1.77 +++ Makefile.inc 2000/05/06 09:51:58 @@ -126,6 +126,7 @@ MLINKS+=gettimeofday.2 settimeofday.2 MLINKS+=getuid.2 geteuid.2 MLINKS+=intro.2 errno.2 +MLINKS+=kqueue.2 kevent.2 MLINKS+=lseek.2 seek.2 MLINKS+=mlock.2 munlock.2 MLINKS+=mount.2 unmount.2 Index: kqueue.2 =================================================================== RCS file: /home/ncvs/src/lib/libc/sys/kqueue.2,v retrieving revision 1.1 diff -u -r1.1 kqueue.2 --- kqueue.2 2000/05/04 20:11:38 1.1 +++ kqueue.2 2000/05/06 09:55:13 @@ -28,8 +28,11 @@ .Dt KQUEUE 2 .Os .Sh NAME -.Nm kqueue, kevent +.Nm kqueue , +.Nm kevent .Nd kernel event notification mechanism +.Sh LIBRARY +.Lb libc .Sh SYNOPSIS .Fd #include .Ft int @@ -44,18 +47,18 @@ pieces of kernel code termed filters. An kevent is identified by the (ident, filter) pair; there may only be one unique kevent per kqueue. - +.Pp The filter is executed upon the initial registration of a kevent in order to detect a preexisting condition is present, and is also executed whenever an event is passed to the filter for evaluation. If the filter determines that the condition should be reported, then the kevent is placed on the kqueue for the user to retrieve. - +.Pp The filter is also run when the user attempts to retrieve the kevent from the kqueue, and if the filter indicates the condition that triggered the event no longer holds, the kevent is removed from the kqueue and is not returned. - +.Pp Multiple events which trigger the filter do not result in multiple kevents being placed on the kqueue; instead, the filter will aggregate the events into a single struct kevent. @@ -385,7 +388,7 @@ .Xr select 2 , .Xr signal 3 , .Xr sigaction 2 , -.Xr write 2 . +.Xr write 2 .Sh HISTORY The .Fn kqueue @@ -393,8 +396,8 @@ .Fn kevent functions first appeared in .Fx 5.0 . -.Sh AUTHOR +.Sh AUTHORS The .Fn kqueue system and this manual page were written by -.An Jonathan Lemon Aq jlemon@freebsd.org . +.An Jonathan Lemon Aq jlemon@FreeBSD.org . To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message