From refugee@hc6524a8b.dhcp.vt.edu  Sun Sep 14 10:10:29 2003
Return-Path: <refugee@hc6524a8b.dhcp.vt.edu>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 72ED616A4C1
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Sep 2003 10:10:29 -0700 (PDT)
Received: from lennier.cc.vt.edu (lennier.cc.vt.edu [198.82.162.213])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 7A9B743FBF
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Sep 2003 10:10:28 -0700 (PDT)
	(envelope-from refugee@hc6524a8b.dhcp.vt.edu)
Received: from steiner.cc.vt.edu (IDENT:mirapoint@evil-steiner [10.1.1.14])
	by lennier.cc.vt.edu (8.12.8/8.12.8) with ESMTP id h8EHARxM431900
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Sep 2003 13:10:27 -0400 (EDT)
Received: from hc6524a8b.dhcp.vt.edu (hc6524a8b.dhcp.vt.edu [198.82.74.139])
	by steiner.cc.vt.edu (Mirapoint Messaging Server MOS 3.3.6-GR)
	with ESMTP id BTY95012;
	Sun, 14 Sep 2003 13:10:27 -0400 (EDT)
Received: by zZzZ.vt.edu (Postfix, from userid 1001)
	id 7A07418; Sun, 14 Sep 2003 13:10:25 -0400 (EDT)
Message-Id: <20030914171025.7A07418@hc6524a8b.dhcp.vt.edu>
Date: Sun, 14 Sep 2003 13:10:25 -0400 (EDT)
From: Suleiman Souhlal <refugee@vt.edu>
Reply-To: Suleiman Souhlal <refugee@vt.edu>
To: FreeBSD-gnats-submit@freebsd.org
Subject: [Patch] Talk about EVFILT_NETDEV in kqueue(2)
X-Send-Pr-Version: 3.113

>Number:         56872
>Category:       docs
>Synopsis:       [Patch] Talk about EVFILT_NETDEV in kqueue(2)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Sep 14 10:20:15 PDT 2003
>Closed-Date:    Tue Nov 11 17:43:08 CET 2003
>Last-Modified:  Tue Nov 11 17:43:08 CET 2003
>Originator:     Suleiman Souhlal
>Release:        FreeBSD 5.1-CURRENT i386
>Organization:
>Environment:
System: FreeBSD zZzZ.vt.edu 5.1-CURRENT FreeBSD 5.1-CURRENT #8: Sun Aug 24 06:24:54 EDT 2003 refugee@zZzZ.vt.edu:/usr/obj/usr/src/sys/ZZZZ i386


	
>Description:
	
Talk about the EVFILT_NETDEV filter in the kqueue(2) manpage.

Please close ports/56758, as it is a duplicate of this pr that has been misfiled.
>How-To-Repeat:
	
>Fix:

	

--- kqueue.2.diff begins here ---
Index: lib/libc/sys/kqueue.2
===================================================================
RCS file: /home/ncvs/src/lib/libc/sys/kqueue.2,v
retrieving revision 1.34
diff -u -r1.34 kqueue.2
--- lib/libc/sys/kqueue.2	8 Sep 2003 19:57:16 -0000	1.34
+++ lib/libc/sys/kqueue.2	13 Sep 2003 23:44:15 -0000
@@ -404,6 +404,22 @@
 contains the number of times the timeout has expired since the last call to
 .Fn kevent .
 This filter automatically sets the EV_CLEAR flag internally.
+.It EVFILT_NETDEV
+Takes a descriptor to a network interface as the identifier and the events to watch for in 
+.Va fflags ,
+and returns when one or more of the requested events occurs on the descritor. The events to monitor are:
+.Bl -tag -width XXNOTE_TRACKERR
+.It NOTE_LINKUP
+The link is up.
+.It NOTE_LINKDOWN
+The link is down.
+.It NOTE_LINKINV
+The link state is invalid.
+.El
+.Pp
+On return,
+.Va fflags
+contains the events which triggered the filter.
 .El
 .Sh RETURN VALUES
 The
--- kqueue.2.diff ends here ---


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: brueffer 
State-Changed-When: Tue Nov 11 17:42:21 CET 2003 
State-Changed-Why:  
I committed an enhanced version of your patch, thanks for the 
submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=56872 
>Unformatted:
