1.\" Copyright (c) 2005 2.\" Bill Paul <wpaul@windriver.com> All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 3. All advertising materials mentioning features or use of this software 13.\" must display the following acknowledgement: 14.\" This product includes software developed by Bill Paul. 15.\" 4. Neither the name of the author nor the names of any co-contributors 16.\" may be used to endorse or promote products derived from this software 17.\" without specific prior written permission. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD 23.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 29.\" THE POSSIBILITY OF SUCH DAMAGE. 30.\"
|
31.\" $FreeBSD: head/usr.sbin/wpa/ndis_events/ndis_events.8 151214 2005-10-10 17:51:12Z wpaul $
|
31.\" $FreeBSD: head/usr.sbin/wpa/ndis_events/ndis_events.8 151223 2005-10-10 20:40:28Z wpaul $ |
32.\" 33.Dd October 10, 2005 34.Dt NDIS_EVENTS 8 35.Os 36.Sh NAME 37.Nm ndis_events 38.Nd relay events from 39.Xr ndis 4 40drivers to 41.Xr wpa_supplicant 8 42.Sh SYNOPSIS 43.Nm
|
44.Op Fl a |
45.Op Fl d 46.Op Fl v 47.Sh DESCRIPTION 48The 49.Nm 50utility listens for events generated by an 51.Xr ndis 4 52wireless network driver and relays them to 53.Xr wpa_supplicant 8 54for possible processing. The three event types that can occur 55are media connect and disconnect events, such as when a wireless 56interface joins or leaves a network, and media-specific events. 57In particular, 58.Xr ndis 4 59drivers that support WPA2 will generate media-specific events 60containing PMKID candidate information which 61.Xr wpa_supplicant 8 62needs in order to properly associate with WPA2-capable access points. 63.Pp 64The 65.Nm 66daemon works by listening for interface information events via 67a routing socket. When it detects an event that was generated by an 68.Xr ndis 4 69interface, it transmits it via UDP packet on the loopback interface, 70where 71.Xr wpa_supplicant 8 72is presumeably listening. The standard 73.Xr wpa_supplicant 8 74distribution includes its own version of this utility for use with 75.Tn Windows\[rg] . 76The 77.Fx 78version performs the same functions as the 79.Tn Windows\[rg] 80except that it uses an 81.Xr ioctl 4 82and routing socket interface instead of WMI. 83.Pp 84Note that a single instance of 85.Nm 86is sufficient to scan for events for any number of 87.Xr ndis 4 88interfaces in a system. 89.Sh OPTIONS 90The 91.Nm 92daemon supports the following options: 93.Bl -tag -width indent
|
94.It Fl a 95Process all events. By default, 96.Nm 97will only process and forward media-specific events, which contain 98PMKID candidate information, and not bother forwarding connect and 99disconnect events, since 100.Xr wpa_supplicant 8 101normally can determine the current link state on its own. In some 102cases, the additional connect and disconnect events only confuse it 103and make the association and authentication process take longer. |
104.It Fl d 105Run in debug mode. This causes 106.Nm 107to run in the foreground and generate any output to the standard 108error instead of using the 109.Xr syslog 3 110facility. 111.It Fl v 112Run in verbose mode. This causes 113.Nm 114to emit notifications when it receives events. 115.El 116.Sh SEE ALSO 117.Xr ndis 4 , 118.Xr ndisapi 9 , 119.Xr wpa_supplicant 8 120.Sh HISTORY 121The 122.Nm 123utility first appeared in 124.Fx 7.0 . 125.Sh AUTHORS 126The 127.Nm 128utility was written by 129.An Bill Paul Aq wpaul@windriver.com .
|