DragonFly On-Line Manual Pages
NDIS_EVENTS(8) DragonFly System Manager's Manual NDIS_EVENTS(8)
ndis_events -- relay events from ndis(4) drivers to wpa_supplicant(8)
ndis_events [-a] [-d] [-v]
The ndis_events utility listens for events generated by an ndis(4) wire-
less network driver and relays them to wpa_supplicant(8) for possible
processing. The three event types that can occur are media connect and
disconnect events, such as when a wireless interface joins or leaves a
network, and media-specific events. In particular, ndis(4) drivers that
support WPA2 will generate media-specific events containing PMKID candi-
date information which wpa_supplicant(8) needs in order to properly asso-
ciate with WPA2-capable access points.
The ndis_events daemon works by listening for interface information
events via a routing socket. When it detects an event that was generated
by an ndis(4) interface, it transmits it via UDP packet on the loopback
interface, where wpa_supplicant(8) is presumably listening. The standard
wpa_supplicant(8) distribution includes its own version of this utility
for use with Windows(R). The DragonFly version performs the same func-
tions as the Windows(R) one, except that it uses an ioctl(2) and routing
socket interface instead of WMI.
Note that a single instance of ndis_events is sufficient to scan for
events for any number of ndis(4) interfaces in a system.
The ndis_events daemon supports the following options:
-a Process all events. By default, ndis_events will only process
and forward media-specific events, which contain PMKID candidate
information, and not bother forwarding connect and disconnect
events, since wpa_supplicant(8) normally can determine the cur-
rent link state on its own. In some cases, the additional con-
nect and disconnect events only confuse it and make the associa-
tion and authentication process take longer.
-d Run in debug mode. This causes ndis_events to run in the fore-
ground and generate any output to the standard error instead of
using the syslog(3) facility.
-v Run in verbose mode. This causes ndis_events to emit notifica-
tions when it receives events.
The ndis_events utility first appeared in FreeBSD 6.0.
The ndis_events utility was written by Bill Paul <email@example.com>.
DragonFly 4.1 August 30, 2007 DragonFly 4.1