From owner-freebsd-doc@FreeBSD.ORG Sun Sep 14 10:20:17 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 823D916A4BF for ; Sun, 14 Sep 2003 10:20:17 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id D73F843FBF for ; Sun, 14 Sep 2003 10:20:15 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h8EHKFUp043187 for ; Sun, 14 Sep 2003 10:20:15 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h8EHKF3r043186; Sun, 14 Sep 2003 10:20:15 -0700 (PDT) Resent-Date: Sun, 14 Sep 2003 10:20:15 -0700 (PDT) Resent-Message-Id: <200309141720.h8EHKF3r043186@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Suleiman Souhlal Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 72ED616A4C1 for ; 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 ; 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 ; 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 To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/56872: [Patch] Talk about EVFILT_NETDEV in kqueue(2) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Suleiman Souhlal List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 14 Sep 2003 17:20:17 -0000 >Number: 56872 >Category: docs >Synopsis: [Patch] Talk about EVFILT_NETDEV in kqueue(2) >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Sep 14 10:20:15 PDT 2003 >Closed-Date: >Last-Modified: >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: >Unformatted: