Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
NDIS_EVENTS(8)		  BSD 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 FreeBSD version performs the	same functions
     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.

     ndis(4), wpa_supplicant(8)

     The ndis_events utility first appeared in FreeBSD 6.0.

     The ndis_events utility was written by Bill Paul <>.

BSD				August 30, 2007				   BSD


Want to link to this manual page? Use this URL:

home | help