NDIS_EVENTS(8) BSD System Manager's Manual NDIS_EVENTS(8)NAMEndis_events — relay events from ndis(4) drivers to wpa_supplicant(8)SYNOPSISndis_events [-a] [-d] [-v]
DESCRIPTION
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 presumeably listening. The stan‐
dard wpa_supplicant(8) distribution includes its own version of this
utility for use with Windows®. The FreeBSD version performs the same
functions as the Windows® one, except that it uses an ioctl(4) and rout‐
ing 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.
OPTIONS
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.
SEE ALSOndis(4), wpa_supplicant(8)HISTORY
The ndis_events utility first appeared in FreeBSD 6.0.
AUTHORS
The ndis_events utility was written by Bill Paul ⟨wpaul@windriver.com⟩.
BSD August 30, 2007 BSD