summaryrefslogtreecommitdiffstats
path: root/lib/libc/sys/kqueue.2
diff options
context:
space:
mode:
authorbrueffer <brueffer@FreeBSD.org>2003-11-11 16:41:27 +0000
committerbrueffer <brueffer@FreeBSD.org>2003-11-11 16:41:27 +0000
commit8ffd3da8754be2635fb1bd8e42c87ecff2dd2ae9 (patch)
tree226805ed97e50722fe589f0ba8c3ee99d9ec980c /lib/libc/sys/kqueue.2
parente57672a655e52ef52e06f8c7d7097c0e039c8a9c (diff)
downloadFreeBSD-src-8ffd3da8754be2635fb1bd8e42c87ecff2dd2ae9.zip
FreeBSD-src-8ffd3da8754be2635fb1bd8e42c87ecff2dd2ae9.tar.gz
Add information about the EVFILT_NETDEV filter
PR: docs/56872 (based on) Submitted by: Suleiman Souhlal <refugee@vt.edu> Reviewed by: hmp, jmg
Diffstat (limited to 'lib/libc/sys/kqueue.2')
-rw-r--r--lib/libc/sys/kqueue.224
1 files changed, 24 insertions, 0 deletions
diff --git a/lib/libc/sys/kqueue.2 b/lib/libc/sys/kqueue.2
index 73a760e..a3acae4 100644
--- a/lib/libc/sys/kqueue.2
+++ b/lib/libc/sys/kqueue.2
@@ -412,6 +412,23 @@ On return,
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 Dv EVFILT_NETDEV
+Takes a descriptor to a network interface as the identifier, and the events to watch for in
+.Va fflags .
+It returns, when one or more of the requested events occur on the descriptor.
+The events to monitor are:
+.Bl -tag -width XXNOTE_LINKDOWN
+.It Dv NOTE_LINKUP
+The link is up.
+.It Dv NOTE_LINKDOWN
+The link is down.
+.It Dv 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
@@ -512,3 +529,10 @@ It is currently not possible to watch a
.Xr vnode 9
that resides on anything but
a UFS file system.
+.Pp
+The
+.Dv EVFILT_NETDEV
+filter is currently only implemented for devices that use the
+.Xr miibus 4
+driver for LINKUP and LINKDOWN operations.
+Therefore, it will not work with many non-ethernet devices.
OpenPOWER on IntegriCloud