Standardize on a single definition of auth_alg bitfield values
[hostap-gosc2009.git] / wpa_supplicant / ChangeLog
blob593826dfeab58be23c470dcef1485111656b29b8
1 ChangeLog for wpa_supplicant
3 2009-11-21 - v0.7.0
4         * increased wpa_cli ping interval to 5 seconds and made this
5           configurable with a new command line options (-G<seconds>)
6         * fixed scan buffer processing with WEXT to handle up to 65535
7           byte result buffer (previously, limited to 32768 bytes)
8         * allow multiple driver wrappers to be specified on command line
9           (e.g., -Dnl80211,wext); the first one that is able to initialize the
10           interface will be used
11         * added support for multiple SSIDs per scan request to optimize
12           scan_ssid=1 operations in ap_scan=1 mode (i.e., search for hidden
13           SSIDs); this requires driver support and can currently be used only
14           with nl80211
15         * added support for WPS USBA out-of-band mechanism with USB Flash
16           Drives (UFD) (CONFIG_WPS_UFD=y)
17         * driver_ndis: add PAE group address to the multicast address list to
18           fix wired IEEE 802.1X authentication
19         * fixed IEEE 802.11r key derivation function to match with the standard
20           (note: this breaks interoperability with previous version) [Bug 303]
21         * added better support for drivers that allow separate authentication
22           and association commands (e.g., mac80211-based Linux drivers with
23           nl80211; SME in wpa_supplicant); this allows over-the-air FT protocol
24           to be used (IEEE 802.11r)
25         * fixed SHA-256 based key derivation function to match with the
26           standard when using CCMP (for IEEE 802.11r and IEEE 802.11w)
27           (note: this breaks interoperability with previous version) [Bug 307]
28         * use shared driver wrapper files with hostapd
29         * added AP mode functionality (CONFIG_AP=y) with mode=2 in the network
30           block; this can be used for open and WPA2-Personal networks
31           (optionally, with WPS); this links in parts of hostapd functionality
32           into wpa_supplicant
33         * wpa_gui-qt4: added new Peers dialog to show information about peers
34           (other devices, including APs and stations, etc. in the neighborhood)
35         * added support for WPS External Registrar functionality (configure APs
36           and enroll new devices); can be used with wpa_gui-qt4 Peers dialog
37           and wpa_cli commands wps_er_start, wps_er_stop, wps_er_pin,
38           wps_er_pbc, wps_er_learn
39           (this can also be used with a new 'none' driver wrapper if no
40           wireless device or IEEE 802.1X on wired is needed)
41         * driver_nl80211: multiple updates to provide support for new Linux
42           nl80211/mac80211 functionality
43         * updated management frame protection to use IEEE Std 802.11w-2009
44         * fixed number of small WPS issues and added workarounds to
45           interoperate with common deployed broken implementations
46         * added support for NFC out-of-band mechanism with WPS
47         * driver_ndis: fixed wired IEEE 802.1X authentication with PAE group
48           address frames
49         * added preliminary support for IEEE 802.11r RIC processing
50         * added support for specifying subset of enabled frequencies to scan
51           (scan_freq option in the network configuration block); this can speed
52           up scanning process considerably if it is known that only a small
53           subset of channels is actually used in the network (this is currently
54           supported only with -Dnl80211)
55         * added a workaround for race condition between receiving the
56           association event and the following EAPOL-Key
57         * added background scan and roaming infrastructure to allow
58           network-specific optimizations to be used to improve roaming within
59           an ESS (same SSID)
60         * added new DBus interface (fi.w1.wpa_supplicant1)
62 2009-01-06 - v0.6.7
63         * added support for Wi-Fi Protected Setup (WPS)
64           (wpa_supplicant can now be configured to act as a WPS Enrollee to
65           enroll credentials for a network using PIN and PBC methods; in
66           addition, wpa_supplicant can act as a wireless WPS Registrar to
67           configure an AP); WPS support can be enabled by adding CONFIG_WPS=y
68           into .config and setting the runtime configuration variables in
69           wpa_supplicant.conf (see WPS section in the example configuration
70           file); new wpa_cli commands wps_pin, wps_pbc, and wps_reg are used to
71           manage WPS negotiation; see README-WPS for more details
72         * added support for EAP-AKA' (draft-arkko-eap-aka-kdf)
73         * added support for using driver_test over UDP socket
74         * fixed PEAPv0 Cryptobinding interoperability issue with Windows Server
75           2008 NPS; optional cryptobinding is now enabled (again) by default
76         * fixed PSK editing in wpa_gui
77         * changed EAP-GPSK to use the IANA assigned EAP method type 51
78         * added a Windows installer that includes WinPcap and all the needed
79           DLLs; in addition, it set up the registry automatically so that user
80           will only need start wpa_gui to get prompted to start the wpasvc
81           servide and add a new interface if needed through wpa_gui dialog
82         * updated management frame protection to use IEEE 802.11w/D7.0
84 2008-11-23 - v0.6.6
85         * added Milenage SIM/USIM emulator for EAP-SIM/EAP-AKA
86           (can be used to simulate test SIM/USIM card with a known private key;
87           enable with CONFIG_SIM_SIMULATOR=y/CONFIG_USIM_SIMULATOR=y in .config
88           and password="Ki:OPc"/password="Ki:OPc:SQN" in network configuration)
89         * added a new network configuration option, wpa_ptk_rekey, that can be
90           used to enforce frequent PTK rekeying, e.g., to mitigate some attacks
91           against TKIP deficiencies
92         * added an optional mitigation mechanism for certain attacks against
93           TKIP by delaying Michael MIC error reports by a random amount of time
94           between 0 and 60 seconds; this can be enabled with a build option
95           CONFIG_DELAYED_MIC_ERROR_REPORT=y in .config
96         * fixed EAP-AKA to use RES Length field in AT_RES as length in bits,
97           not bytes
98         * updated OpenSSL code for EAP-FAST to use an updated version of the
99           session ticket overriding API that was included into the upstream
100           OpenSSL 0.9.9 tree on 2008-11-15 (no additional OpenSSL patch is
101           needed with that version anymore)
102         * updated userspace MLME instructions to match with the current Linux
103           mac80211 implementation; please also note that this can only be used
104           with driver_nl80211.c (the old code from driver_wext.c was removed)
105         * added support (Linux only) for RoboSwitch chipsets (often found in
106           consumer grade routers); driver interface 'roboswitch'
107         * fixed canceling of PMKSA caching when using drivers that generate
108           RSN IE and refuse to drop PMKIDs that wpa_supplicant does not know
109           about
111 2008-11-01 - v0.6.5
112         * added support for SHA-256 as X.509 certificate digest when using the
113           internal X.509/TLSv1 implementation
114         * updated management frame protection to use IEEE 802.11w/D6.0
115         * added support for using SHA256-based stronger key derivation for WPA2
116           (IEEE 802.11w)
117         * fixed FT (IEEE 802.11r) authentication after a failed association to
118           use correct FTIE
119         * added support for configuring Phase 2 (inner/tunneled) authentication
120           method with wpa_gui-qt4
122 2008-08-10 - v0.6.4
123         * added support for EAP Sequences in EAP-FAST Phase 2
124         * added support for using TNC with EAP-FAST
125         * added driver_ps3 for the PS3 Linux wireless driver
126         * added support for optional cryptobinding with PEAPv0
127         * fixed the OpenSSL patches (0.9.8g and 0.9.9) for EAP-FAST to
128           allow fallback to full handshake if server rejects PAC-Opaque
129         * added fragmentation support for EAP-TNC
130         * added support for parsing PKCS #8 formatted private keys into the
131           internal TLS implementation (both PKCS #1 RSA key and PKCS #8
132           encapsulated RSA key can now be used)
133         * added option of using faster, but larger, routines in the internal
134           LibTomMath (for internal TLS implementation) to speed up DH and RSA
135           calculations (CONFIG_INTERNAL_LIBTOMMATH_FAST=y)
136         * fixed race condition between disassociation event and group key
137           handshake to avoid getting stuck in incorrect state [Bug 261]
138         * fixed opportunistic key caching (proactive_key_caching)
140 2008-02-22 - v0.6.3
141         * removed 'nai' and 'eappsk' network configuration variables that were
142           previously used for configuring user identity and key for EAP-PSK,
143           EAP-PAX, EAP-SAKE, and EAP-GPSK. 'identity' field is now used as the
144           replacement for 'nai' (if old configuration used a separate
145           'identity' value, that would now be configured as
146           'anonymous_identity'). 'password' field is now used as the
147           replacement for 'eappsk' (it can also be set using hexstring to
148           present random binary data)
149         * removed '-w' command line parameter (wait for interface to be added,
150           if needed); cleaner way of handling this functionality is to use an
151           external mechanism (e.g., hotplug scripts) that start wpa_supplicant
152           when an interface is added
153         * updated FT support to use the latest draft, IEEE 802.11r/D9.0
154         * added ctrl_iface monitor event (CTRL-EVENT-SCAN-RESULTS) for
155           indicating when new scan results become available
156         * added new ctrl_iface command, BSS, to allow scan results to be
157           fetched without hitting the message size limits (this command
158           can be used to iterate through the scan results one BSS at the time)
159         * fixed EAP-SIM not to include AT_NONCE_MT and AT_SELECTED_VERSION
160           attributes in EAP-SIM Start/Response when using fast reauthentication
161         * fixed EAPOL not to end up in infinite loop when processing dynamic
162           WEP keys with IEEE 802.1X
163         * fixed problems in getting NDIS events from WMI on Windows 2000
165 2008-01-01 - v0.6.2
166         * added support for Makefile builds to include debug-log-to-a-file
167           functionality (CONFIG_DEBUG_FILE=y and -f<path> on command line)
168         * fixed EAP-SIM and EAP-AKA message parser to validate attribute
169           lengths properly to avoid potential crash caused by invalid messages
170         * added data structure for storing allocated buffers (struct wpabuf);
171           this does not affect wpa_supplicant usage, but many of the APIs
172           changed and various interfaces (e.g., EAP) is not compatible with old
173           versions
174         * added support for protecting EAP-AKA/Identity messages with
175           AT_CHECKCODE (optional feature in RFC 4187)
176         * added support for protected result indication with AT_RESULT_IND for
177           EAP-SIM and EAP-AKA (phase1="result_ind=1")
178         * added driver_wext workaround for race condition between scanning and
179           association with drivers that take very long time to scan all
180           channels (e.g., madwifi with dual-band cards); wpa_supplicant is now
181           using a longer hardcoded timeout for the scan if the driver supports
182           notifications for scan completion (SIOCGIWSCAN event); this helps,
183           e.g., in cases where wpa_supplicant and madwifi driver ended up in
184           loop where the driver did not even try to associate
185         * stop EAPOL timer tick when no timers are in use in order to reduce
186           power consumption (no need to wake up the process once per second)
187           [Bug 237]
188         * added support for privilege separation (run only minimal part of
189           wpa_supplicant functionality as root and rest as unprivileged,
190           non-root process); see 'Privilege separation' in README for details;
191           this is disabled by default and can be enabled with CONFIG_PRIVSEP=y
192           in .config
193         * changed scan results data structure to include all information
194           elements to make it easier to support new IEs; old get_scan_result()
195           driver_ops is still supported for backwards compatibility (results
196           are converted internally to the new format), but all drivers should
197           start using the new get_scan_results2() to make them more likely to
198           work with new features
199         * Qt4 version of wpa_gui (wpa_gui-qt4 subdirectory) is now native Qt4
200           application, i.e., it does not require Qt3Support anymore; Windows
201           binary of wpa_gui.exe is now from this directory and only requires
202           QtCore4.dll and QtGui4.dll libraries
203         * updated Windows binary build to use Qt 4.3.3 and made Qt DLLs
204           available as a separate package to make wpa_gui installation easier:
205           http://w1.fi/wpa_supplicant/qt4/wpa_gui-qt433-windows-dll.zip
206         * added support for EAP-IKEv2 (draft-tschofenig-eap-ikev2-15.txt);
207           only shared key/password authentication is supported in this version
209 2007-11-24 - v0.6.1
210         * added support for configuring password as NtPasswordHash
211           (16-byte MD4 hash of password) in hash:<32 hex digits> format
212         * added support for fallback from abbreviated TLS handshake to
213           full handshake when using EAP-FAST (e.g., due to an expired
214           PAC-Opaque)
215         * updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
216           draft (draft-ietf-emu-eap-gpsk-07.txt)
217         * added support for drivers that take care of RSN 4-way handshake
218           internally (WPA_DRIVER_FLAGS_4WAY_HANDSHAKE in get_capa flags and
219           WPA_ALG_PMK in set_key)
220         * added an experimental port for Mac OS X (CONFIG_DRIVER_OSX=y in
221           .config); this version supports only ap_scan=2 mode and allow the
222           driver to take care of the 4-way handshake
223         * fixed a buffer overflow in parsing TSF from scan results when using
224           driver_wext.c with a driver that includes the TSF (e.g., iwl4965)
225           [Bug 232]
226         * updated FT support to use the latest draft, IEEE 802.11r/D8.0
227         * fixed an integer overflow issue in the ASN.1 parser used by the
228           (experimental) internal TLS implementation to avoid a potential
229           buffer read overflow
230         * fixed a race condition with -W option (wait for a control interface
231           monitor before starting) that could have caused the first messages to
232           be lost
233         * added support for processing TNCC-TNCS-Messages to report
234           recommendation (allow/none/isolate) when using TNC [Bug 243]
236 2007-05-28 - v0.6.0
237         * added network configuration parameter 'frequency' for setting
238           initial channel for IBSS (adhoc) networks
239         * added experimental IEEE 802.11r/D6.0 support
240         * updated EAP-SAKE to RFC 4763 and the IANA-allocated EAP type 48
241         * updated EAP-PSK to use the IANA-allocated EAP type 47
242         * fixed EAP-PAX key derivation
243         * fixed EAP-PSK bit ordering of the Flags field
244         * fixed EAP-PEAP/TTLS/FAST to use the correct EAP identifier in
245           tunnelled identity request (previously, the identifier from the outer
246           method was used, not the tunnelled identifier which could be
247           different)
248         * added support for fragmentation of outer TLS packets during Phase 2
249           of EAP-PEAP/TTLS/FAST
250         * fixed EAP-TTLS AVP parser processing for too short AVP lengths
251         * added support for EAP-FAST authentication with inner methods that
252           generate MSK (e.g., EAP-MSCHAPv2 that was previously only supported
253           for PAC provisioning)
254         * added support for authenticated EAP-FAST provisioning
255         * added support for configuring maximum number of EAP-FAST PACs to
256           store in a PAC list (fast_max_pac_list_len=<max> in phase1 string)
257         * added support for storing EAP-FAST PACs in binary format
258           (fast_pac_format=binary in phase1 string)
259         * fixed dbus ctrl_iface to validate message interface before
260           dispatching to avoid a possible segfault [Bug 190]
261         * fixed PeerKey key derivation to use the correct PRF label
262         * updated Windows binary build to link against OpenSSL 0.9.8d and
263           added support for EAP-FAST
264         * updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
265           draft (draft-ietf-emu-eap-gpsk-04.txt)
266         * fixed EAP-AKA Notification processing to allow Notification to be
267           processed after AKA Challenge response has been sent
268         * updated to use IEEE 802.11w/D2.0 for management frame protection
269           (still experimental)
270         * fixed EAP-TTLS implementation not to crash on use of freed memory
271           if TLS library initialization fails
272         * added support for EAP-TNC (Trusted Network Connect)
273           (this version implements the EAP-TNC method and EAP-TTLS changes
274           needed to run two methods in sequence (IF-T) and the IF-IMC and
275           IF-TNCCS interfaces from TNCC)
277 2006-11-24 - v0.5.6
278         * added experimental, integrated TLSv1 client implementation with the
279           needed X.509/ASN.1/RSA/bignum processing (this can be enabled by
280           setting CONFIG_TLS=internal and CONFIG_INTERNAL_LIBTOMMATH=y in
281           .config); this can be useful, e.g., if the target system does not
282           have a suitable TLS library and a minimal code size is required
283           (total size of this internal TLS/crypto code is bit under 50 kB on
284           x86 and the crypto code is shared by rest of the supplicant so some
285           of it was already required; TLSv1/X.509/ASN.1/RSA added about 25 kB)
286         * removed STAKey handshake since PeerKey handshake has replaced it in
287           IEEE 802.11ma and there are no known deployments of STAKey
288         * updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
289           draft (draft-ietf-emu-eap-gpsk-01.txt)
290         * added preliminary implementation of IEEE 802.11w/D1.0 (management
291           frame protection)
292           (Note: this requires driver support to work properly.)
293           (Note2: IEEE 802.11w is an unapproved draft and subject to change.)
294         * fixed Windows named pipes ctrl_iface to not stop listening for
295           commands if client program opens a named pipe and closes it
296           immediately without sending a command
297         * fixed USIM PIN status determination for the case that PIN is not
298           needed (this allows EAP-AKA to be used with USIM cards that do not
299           use PIN)
300         * added support for reading 3G USIM AID from EF_DIR to allow EAP-AKA to
301           be used with cards that do not support file selection based on
302           partial AID
303         * added support for matching the subjectAltName of the authentication
304           server certificate against multiple name components (e.g.,
305           altsubject_match="DNS:server.example.com;DNS:server2.example.com")
306         * fixed EAP-SIM/AKA key derivation for re-authentication case (only
307           affects IEEE 802.1X with dynamic WEP keys)
308         * changed ctrl_iface network configuration 'get' operations to not
309           return password/key material; if these fields are requested, "*"
310           will be returned if the password/key is set, but the value of the
311           parameter is not exposed
313 2006-08-27 - v0.5.5
314         * added support for building Windows version with UNICODE defined
315           (wide-char functions)
316         * driver_ndis: fixed static WEP configuration to avoid race condition
317           issues with some NDIS drivers between association and setting WEP
318           keys
319         * driver_ndis: added validation for IELength value in scan results to
320           avoid crashes when using buggy NDIS drivers [Bug 165]
321         * fixed Release|Win32 target in the Visual Studio project files
322           (previously, only Debug|Win32 target was set properly)
323         * changed control interface API call wpa_ctrl_pending() to allow it to
324           return -1 on error (e.g., connection lost); control interface clients
325           will need to make sure that they verify that the value is indeed >0
326           when determining whether there are pending messages
327         * added an alternative control interface backend for Windows targets:
328           Named Pipe (CONFIG_CTRL_IFACE=named_pipe); this is now the default
329           control interface mechanism for Windows builds (previously, UDP to
330           localhost was used)
331         * changed ctrl_interface configuration for UNIX domain sockets:
332           - deprecated ctrl_interface_group variable (it may be removed in
333             future versions)
334           - allow both directory and group be configured with ctrl_interface
335             in following format: DIR=/var/run/wpa_supplicant GROUP=wheel
336           - ctrl_interface=/var/run/wpa_supplicant is still supported for the
337             case when group is not changed
338         * added support for controlling more than one interface per process in
339           Windows version
340         * added a workaround for a case where the AP is using unknown address
341           (e.g., MAC address of the wired interface) as the source address for
342           EAPOL-Key frames; previously, that source address was used as the
343           destination for EAPOL-Key frames and in key derivation; now, BSSID is
344           used even if the source address does not match with it
345           (this resolves an interoperability issue with Thomson SpeedTouch 580)
346         * added a workaround for UDP-based control interface (which was used in
347           Windows builds before this release) to prevent packets with forged
348           addresses from being accepted as local control requests
349         * removed ndis_events.cpp and possibility of using external
350           ndis_events.exe; C version (ndis_events.c) is fully functional and
351           there is no desire to maintain two separate versions of this
352           implementation
353         * ndis_events: Changed NDIS event notification design to use WMI to
354           learn the adapter description through Win32_PnPEntity class; this
355           should fix some cases where the adapter name was not recognized
356           correctly (e.g., with some USB WLAN adapters, e.g., Ralink RT2500
357           USB) [Bug 113]
358         * fixed selection of the first network in ap_scan=2 mode; previously,
359           wpa_supplicant could get stuck in SCANNING state when only the first
360           network for enabled (e.g., after 'wpa_cli select_network 0')
361         * winsvc: added support for configuring ctrl_interface parameters in
362           registry (ctrl_interface string value in
363           HKLM\SOFTWARE\wpa_supplicant\interfaces\0000 key); this new value is
364           required to enable control interface (previously, this was hardcoded
365           to be enabled)
366         * allow wpa_gui subdirectory to be built with both Qt3 and Qt4
367         * converted wpa_gui-qt4 subdirectory to use Qt4 specific project format
369 2006-06-20 - v0.5.4
370         * fixed build with CONFIG_STAKEY=y [Bug 143]
371         * added support for doing MLME (IEEE 802.11 management frame
372           processing) in wpa_supplicant when using Devicescape IEEE 802.11
373           stack (wireless-dev.git tree)
374         * added a new network block configuration option, fragment_size, to
375           configure the maximum EAP fragment size
376         * driver_ndis: Disable WZC automatically for the selected interface to
377           avoid conflicts with two programs trying to control the radio; WZC
378           will be re-enabled (if it was enabled originally) when wpa_supplicant
379           is terminated
380         * added an experimental TLSv1 client implementation
381           (CONFIG_TLS=internal) that can be used instead of an external TLS
382           library, e.g., to reduce total size requirement on systems that do
383           not include any TLS library by default (this is not yet complete;
384           basic functionality is there, but certificate validation is not yet
385           included)
386         * added PeerKey handshake implementation for IEEE 802.11e
387           direct link setup (DLS) to replace STAKey handshake
388         * fixed WPA PSK update through ctrl_iface for the case where the old
389           PSK was derived from an ASCII passphrase and the new PSK is set as
390           a raw PSK (hex string)
391         * added new configuration option for identifying which network block
392           was used (id_str in wpa_supplicant.conf; included on
393           WPA_EVENT_CONNECT monitor event and as WPA_ID_STR environmental
394           variable in wpa_cli action scripts; in addition WPA_ID variable is
395           set to the current unique identifier that wpa_supplicant assigned
396           automatically for the network and that can be used with
397           GET_NETWORK/SET_NETWORK ctrl_iface commands)
398         * wpa_cli action script is now called only when the connect/disconnect
399           status changes or when associating with a different network
400         * fixed configuration parser not to remove CCMP from group cipher list
401           if WPA-None (adhoc) is used (pairwise=NONE in that case)
402         * fixed integrated NDIS events processing not to hang the process due
403           to a missed change in eloop_win.c API in v0.5.3 [Bug 155]
404         * added support for EAP Generalized Pre-Shared Key (EAP-GPSK,
405           draft-clancy-emu-eap-shared-secret-00.txt)
406         * added Microsoft Visual Studio 2005 solution and project files for
407           build wpa_supplicant for Windows (see vs2005 subdirectory)
408         * eloop_win: fixed unregistration of Windows events
409         * l2_packet_winpcap: fixed a deadlock in deinitializing l2_packet
410           at the end of RSN pre-authentication and added unregistration of
411           a Windows event to avoid getting eloop_win stuck with an invalid
412           handle
413         * driver_ndis: added support for selecting AP based on BSSID
414         * added new environmental variable for wpa_cli action scripts:
415           WPA_CTRL_DIR is the current control interface directory
416         * driver_ndis: added support for using NDISUIO instead of WinPcap for
417           OID set/query operations (CONFIG_USE_NDISUIO=y in .config); with new
418           l2_packet_ndis (CONFIG_L2_PACKET=ndis), this can be used to build
419           wpa_supplicant without requiring WinPcap; note that using NDISUIO
420           requires that WZC is disabled (net stop wzcsvc) since NDISUIO allows
421           only one application to open the device
422         * changed NDIS driver naming to only include device GUID, e.g.,
423           {7EE3EFE5-C165-472F-986D-F6FBEDFE8C8D}, instead of including WinPcap
424           specific \Device\NPF_ prefix before the GUID; the prefix is still
425           allowed for backwards compatibility, but it is not required anymore
426           when specifying the interface
427         * driver_ndis: re-initialize driver interface is the adapter is removed
428           and re-inserted [Bug 159]
429         * driver_madwifi: fixed TKIP and CCMP sequence number configuration on
430           big endian hosts [Bug 146]
432 2006-04-27 - v0.5.3
433         * fixed EAP-GTC response to include correct user identity when run as
434           phase 2 method of EAP-FAST (i.e., EAP-FAST did not work in v0.5.2)
435         * driver_ndis: Fixed encryption mode configuration for unencrypted
436           networks (some NDIS drivers ignored this, but others, e.g., Broadcom,
437           refused to associate with open networks) [Bug 106]
438         * driver_ndis: use BSSID OID polling to detect when IBSS network is
439           formed even when ndis_events code is included since some NDIS drivers
440           do not generate media connect events in IBSS mode
441         * config_winreg: allow global ctrl_interface parameter to be configured
442           in Windows registry
443         * config_winreg: added support for saving configuration data into
444           Windows registry
445         * added support for controlling network device operational state
446           (dormant/up) for Linux 2.6.17 to improve DHCP processing (see
447           http://www.flamewarmaster.de/software/dhcpclient/ for a DHCP client
448           that can use this information)
449         * driver_wext: added support for WE-21 change to SSID configuration
450         * driver_wext: fixed privacy configuration for static WEP keys mode
451           [Bug 140]
452         * added an optional driver_ops callback for MLME-SETPROTECTION.request
453           primitive
454         * added support for EAP-SAKE (no EAP method number allocated yet, so
455           this is using the same experimental type 255 as EAP-PSK)
456         * added support for dynamically loading EAP methods (.so files) instead
457           of requiring them to be statically linked in; this is disabled by
458           default (see CONFIG_DYNAMIC_EAP_METHODS in defconfig for information
459           on how to use this)
461 2006-03-19 - v0.5.2
462         * do not try to use USIM APDUs when initializing PC/SC for SIM card
463           access for a network that has not enabled EAP-AKA
464         * fixed EAP phase 2 Nak for EAP-{PEAP,TTLS,FAST} (this was broken in
465           v0.5.1 due to the new support for expanded EAP types)
466         * added support for generating EAP Expanded Nak
467         * try to fetch scan results once before requesting new scan when
468           starting up in ap_scan=1 mode (this can speed up initial association
469           a lot with, e.g., madwifi-ng driver)
470         * added support for receiving EAPOL frames from a Linux bridge
471           interface (-bbr0 on command line)
472         * fixed EAPOL re-authentication for sessions that used PMKSA caching
473         * changed EAP method registration to use a dynamic list of methods
474           instead of a static list generated at build time
475         * fixed PMKSA cache deinitialization not to use freed memory when
476           removing PMKSA entries
477         * fixed a memory leak in EAP-TTLS re-authentication
478         * reject WPA/WPA2 message 3/4 if it does not include any valid
479           WPA/RSN IE
480         * driver_wext: added fallback to use SIOCSIWENCODE for setting auth_alg
481           if the driver does not support SIOCSIWAUTH
483 2006-01-29 - v0.5.1
484         * driver_test: added better support for multiple APs and STAs by using
485           a directory with sockets that include MAC address for each device in
486           the name (driver_param=test_dir=/tmp/test)
487         * added support for EAP expanded type (vendor specific EAP methods)
488         * added AP_SCAN command into ctrl_iface so that ap_scan configuration
489           option can be changed if needed
490         * wpa_cli/wpa_gui: skip non-socket files in control directory when
491           using UNIX domain sockets; this avoids selecting an incorrect
492           interface (e.g., a PID file could be in this directory, even though
493           use of this directory for something else than socket files is not
494           recommended)
495         * fixed TLS library deinitialization after RSN pre-authentication not
496           to disable TLS library for normal authentication
497         * driver_wext: Remove null-termination from SSID length if the driver
498           used it; some Linux drivers do this and they were causing problems in
499           wpa_supplicant not finding matching configuration block. This change
500           would break a case where the SSID actually ends in '\0', but that is
501           not likely to happen in real use.
502         * fixed PMKSA cache processing not to trigger deauthentication if the
503           current PMKSA cache entry is replaced with a valid new entry
504         * fixed PC/SC initialization for ap_scan != 1 modes (this fixes
505           EAP-SIM and EAP-AKA with real SIM/USIM card when using ap_scan=0 or
506           ap_scan=2)
508 2005-12-18 - v0.5.0 (beginning of 0.5.x development releases)
509         * added experimental STAKey handshake implementation for IEEE 802.11e
510           direct link setup (DLS); note: this is disabled by default in both
511           build and runtime configuration (can be enabled with CONFIG_STAKEY=y
512           and stakey=1)
513         * fixed EAP-SIM and EAP-AKA pseudonym and fast re-authentication to
514           decrypt AT_ENCR_DATA attributes correctly
515         * fixed EAP-AKA to allow resynchronization within the same session
516         * made code closer to ANSI C89 standard to make it easier to port to
517           other C libraries and compilers
518         * started moving operating system or C library specific functions into
519           wrapper functions defined in os.h and implemented in os_*.c to make
520           code more portable
521         * wpa_supplicant can now be built with Microsoft Visual C++
522           (e.g., with the freely available Toolkit 2003 version or Visual
523           C++ 2005 Express Edition and Platform SDK); see nmake.mak for an
524           example makefile for nmake
525         * added support for using Windows registry for command line parameters
526           (CONFIG_MAIN=main_winsvc) and configuration data
527           (CONFIG_BACKEND=winreg); see win_example.reg for an example registry
528           contents; this version can be run both as a Windows service and as a
529           normal application; 'wpasvc.exe app' to start as applicant,
530           'wpasvc.exe reg <full path to wpasvc.exe>' to register a service,
531           'net start wpasvc' to start the service, 'wpasvc.exe unreg' to
532           unregister a service
533         * made it possible to link ndis_events.exe functionality into
534           wpa_supplicant.exe by defining CONFIG_NDIS_EVENTS_INTEGRATED
535         * added better support for multiple control interface backends
536           (CONFIG_CTRL_IFACE option); currently, 'unix' and 'udp' are supported
537         * fixed PC/SC code to use correct length for GSM AUTH command buffer
538           and to not use pioRecvPci with SCardTransmit() calls; these were not
539           causing visible problems with pcsc-lite, but Windows Winscard.dll
540           refused the previously used parameters; this fixes EAP-SIM and
541           EAP-AKA authentication using SIM/USIM card under Windows
542         * added new event loop implementation for Windows using
543           WaitForMultipleObject() instead of select() in order to allow waiting
544           for non-socket objects; this can be selected with
545           CONFIG_ELOOP=eloop_win in .config
546         * added support for selecting l2_packet implementation in .config
547           (CONFIG_L2_PACKET; following options are available now: linux, pcap,
548           winpcap, freebsd, none)
549         * added new l2_packet implementation for WinPcap
550           (CONFIG_L2_PACKET=winpcap) that uses a separate receive thread to
551           reduce latency in EAPOL receive processing from about 100 ms to about
552           3 ms
553         * added support for EAP-FAST key derivation using other ciphers than
554           RC4-128-SHA for authentication and AES128-SHA for provisioning
555         * added support for configuring CA certificate as DER file and as a
556           configuration blob
557         * fixed private key configuration as configuration blob and added
558           support for using PKCS#12 as a blob
559         * tls_gnutls: added support for using PKCS#12 files; added support for
560           session resumption
561         * added support for loading trusted CA certificates from Windows
562           certificate store: ca_cert="cert_store://<name>", where <name> is
563           likely CA (Intermediate CA certificates) or ROOT (root certificates)
564         * added C version of ndis_events.cpp and made it possible to build this
565           with MinGW so that CONFIG_NDIS_EVENTS_INTEGRATED can be used more
566           easily on cross-compilation builds
567         * added wpasvc.exe into Windows binary release; this is an alternative
568           version of wpa_supplicant.exe with configuration backend using
569           Windows registry and with the entry point designed to run as a
570           Windows service
571         * integrated ndis_events.exe functionality into wpa_supplicant.exe and
572           wpasvc.exe and removed this additional tool from the Windows binary
573           release since it is not needed anymore
574         * load winscard.dll functions dynamically when building with MinGW
575           since MinGW does not yet include winscard library
577 2005-11-20 - v0.4.7 (beginning of 0.4.x stable releases)
578         * l2_packet_pcap: fixed wired IEEE 802.1X authentication with libpcap
579           and WinPcap to receive frames sent to PAE group address
580         * disable EAP state machine when IEEE 802.1X authentication is not used
581           in order to get rid of bogus "EAP failed" messages
582         * fixed OpenSSL error reporting to go through all pending errors to
583           avoid confusing reports of old errors being reported at later point
584           during handshake
585         * fixed configuration file updating to not write empty variables
586           (e.g., proto or key_mgmt) that the file parser would not accept
587         * fixed ADD_NETWORK ctrl_iface command to use the same default values
588           for variables as empty network definitions read from config file
589           would get
590         * fixed EAP state machine to not discard EAP-Failure messages in many
591           cases (e.g., during TLS handshake)
592         * fixed a infinite loop in private key reading if the configured file
593           cannot be parsed successfully
594         * driver_madwifi: added support for madwifi-ng
595         * wpa_gui: do not display password/PSK field contents
596         * wpa_gui: added CA certificate configuration
597         * driver_ndis: fixed scan request in ap_scan=2 mode not to change SSID
598         * driver_ndis: include Beacon IEs in AssocInfo in order to notice if
599           the new AP is using different WPA/RSN IE
600         * use longer timeout for IEEE 802.11 association to avoid problems with
601           drivers that may take more than five second to associate
603 2005-10-27 - v0.4.6
604         * allow fallback to WPA, if mixed WPA+WPA2 networks have mismatch in
605           RSN IE, but WPA IE would match with wpa_supplicant configuration
606         * added support for named configuration blobs in order to avoid having
607           to use file system for external files (e.g., certificates);
608           variables can be set to "blob://<blob name>" instead of file path to
609           use a named blob; supported fields: pac_file, client_cert,
610           private_key
611         * fixed RSN pre-authentication (it was broken in the clean up of WPA
612           state machine interface in v0.4.5)
613         * driver_madwifi: set IEEE80211_KEY_GROUP flag for group keys to make
614           sure the driver configures broadcast decryption correctly
615         * added ca_path (and ca_path2) configuration variables that can be used
616           to configure OpenSSL CA path, e.g., /etc/ssl/certs, for using the
617           system-wide trusted CA list
618         * added support for starting wpa_supplicant without a configuration
619           file (-C argument must be used to set ctrl_interface parameter for
620           this case; in addition, -p argument can be used to provide
621           driver_param; these new arguments can also be used with a
622           configuration to override the values from the configuration)
623         * added global control interface that can be optionally used for adding
624           and removing network interfaces dynamically (-g command line argument
625           for both wpa_supplicant and wpa_cli) without having to restart
626           wpa_supplicant process
627         * wpa_gui:
628           - try to save configuration whenever something is modified
629           - added WEP key configuration
630           - added possibility to edit the current network configuration
631         * driver_ndis: fixed driver polling not to increase frequency on each
632           received EAPOL frame due to incorrectly cancelled timeout
633         * added simple configuration file examples (in examples subdirectory)
634         * fixed driver_wext.c to filter wireless events based on ifindex to
635           avoid interfaces receiving events from other interfaces
636         * delay sending initial EAPOL-Start couple of seconds to speed up
637           authentication for the most common case of Authenticator starting
638           EAP authentication immediately after association
640 2005-09-25 - v0.4.5
641         * added a workaround for clearing keys with ndiswrapper to allow
642           roaming from WPA enabled AP to plaintext one
643         * added docbook documentation (doc/docbook) that can be used to
644           generate, e.g., man pages
645         * l2_packet_linux: use socket type SOCK_DGRAM instead of SOCK_RAW for
646           PF_PACKET in order to prepare for network devices that do not use
647           Ethernet headers (e.g., network stack with native IEEE 802.11 frames)
648         * use receipt of EAPOL-Key frame as a lower layer success indication
649           for EAP state machine to allow recovery from dropped EAP-Success
650           frame
651         * cleaned up internal EAPOL frame processing by not including link
652           layer (Ethernet) header during WPA and EAPOL/EAP processing; this
653           header is added only when transmitted the frame; this makes it easier
654           to use wpa_supplicant on link layers that use different header than
655           Ethernet
656         * updated EAP-PSK to use draft 9 by default since this can now be
657           tested with hostapd; removed support for draft 3, including
658           server_nai configuration option from network blocks
659         * driver_wired: add PAE address to the multicast address list in order
660           to be able to receive EAPOL frames with drivers that do not include
661           these multicast addresses by default
662         * driver_wext: add support for WE-19
663         * added support for multiple configuration backends (CONFIG_BACKEND
664           option); currently, only 'file' is supported (i.e., the format used
665           in wpa_supplicant.conf)
666         * added support for updating configuration ('wpa_cli save_config');
667           this is disabled by default and can be enabled with global
668           update_config=1 variable in wpa_supplicant.conf; this allows wpa_cli
669           and wpa_gui to store the configuration changes in a permanent store
670         * added GET_NETWORK ctrl_iface command
671           (e.g., 'wpa_cli get_network 0 ssid')
673 2005-08-21 - v0.4.4
674         * replaced OpenSSL patch for EAP-FAST support
675           (openssl-tls-extensions.patch) with a more generic and correct
676           patch (the new patch is not compatible with the previous one, so the
677           OpenSSL library will need to be patched with the new patch in order
678           to be able to build wpa_supplicant with EAP-FAST support)
679         * added support for using Windows certificate store (through CryptoAPI)
680           for client certificate and private key operations (EAP-TLS)
681           (see wpa_supplicant.conf for more information on how to configure
682           this with private_key)
683         * ported wpa_gui to Windows
684         * added Qt4 version of wpa_gui (wpa_gui-qt4 directory); this can be
685           built with the open source version of the Qt4 for Windows
686         * allow non-WPA modes (e.g., IEEE 802.1X with dynamic WEP) to be used
687           with drivers that do not support WPA
688         * ndis_events: fixed Windows 2000 support
689         * added support for enabling/disabling networks from the list of all
690           configured networks ('wpa_cli enable_network <network id>' and
691           'wpa_cli disable_network <network id>')
692         * added support for adding and removing network from the current
693           configuration ('wpa_cli add_network' and 'wpa_cli remove_network
694           <network id>'); added networks are disabled by default and they can
695           be enabled with enable_network command once the configuration is done
696           for the new network; note: configuration file is not yet updated, so
697           these new networks are lost when wpa_supplicant is restarted
698         * added support for setting network configuration parameters through
699           the control interface, for example:
700           wpa_cli set_network 0 ssid "\"my network\""
701         * fixed parsing of strings that include both " and # within double
702           quoted area (e.g., "start"#end")
703         * added EAP workaround for PEAP session resumption: allow outer,
704           i.e., not tunneled, EAP-Success to terminate session since; this can
705           be disabled with eap_workaround=0
706           (this was allowed for PEAPv1 before, but now it is also allowed for
707           PEAPv0 since at least one RADIUS authentication server seems to be
708           doing this for PEAPv0, too)
709         * wpa_gui: added preliminary support for adding new networks to the
710           wpa_supplicant configuration (double click on the scan results to
711           open network configuration)
713 2005-06-26 - v0.4.3
714         * removed interface for external EAPOL/EAP supplicant (e.g.,
715           Xsupplicant), (CONFIG_XSUPPLICANT_IFACE) since it is not required
716           anymore and is unlikely to be used by anyone
717         * driver_ndis: fixed WinPcap 3.0 support
718         * fixed build with CONFIG_DNET_PCAP=y on Linux
719         * l2_packet: moved different implementations into separate files
720           (l2_packet_*.c)
722 2005-06-12 - v0.4.2
723         * driver_ipw: updated driver structures to match with ipw2200-1.0.4
724           (note: ipw2100-1.1.0 is likely to require an update to work with
725           this)
726         * added support for using ap_scan=2 mode with multiple network blocks;
727           wpa_supplicant will go through the networks one by one until the
728           driver reports a successful association; this uses the same order for
729           networks as scan_ssid=1 scans, i.e., the priority field is ignored
730           and the network block order in the file is used instead
731         * fixed a potential issue in RSN pre-authentication ending up using
732           freed memory if pre-authentication times out
733         * added support for matching alternative subject name extensions of the
734           authentication server certificate; new configuration variables
735           altsubject_match and altsubject_match2
736         * driver_ndis: added support for IEEE 802.1X authentication with wired
737           NDIS drivers
738         * added support for querying private key password (EAP-TLS) through the
739           control interface (wpa_cli/wpa_gui) if one is not included in the
740           configuration file
741         * driver_broadcom: fixed couple of memory leaks in scan result
742           processing
743         * EAP-PAX is now registered as EAP type 46
744         * fixed EAP-PAX MAC calculation
745         * fixed EAP-PAX CK and ICK key derivation
746         * added support for using password with EAP-PAX (as an alternative to
747           entering key with eappsk); SHA-1 hash of the password will be used as
748           the key in this case
749         * added support for arbitrary driver interface parameters through the
750           configuration file with a new driver_param field; this adds a new
751           driver_ops function set_param()
752         * added possibility to override l2_packet module with driver interface
753           API (new send_eapol handler); this can be used to implement driver
754           specific TX/RX functions for EAPOL frames
755         * fixed ctrl_interface_group processing for the case where gid is
756           entered as a number, not group name
757         * driver_test: added support for testing hostapd with wpa_supplicant
758           by using test driver interface without any kernel drivers or network
759           cards
761 2005-05-22 - v0.4.1
762         * driver_madwifi: fixed WPA/WPA2 mode configuration to allow EAPOL
763           packets to be encrypted; this was apparently broken by the changed
764           ioctl order in v0.4.0
765         * driver_madwifi: added preliminary support for compiling against 'BSD'
766           branch of madwifi CVS tree
767         * added support for EAP-MSCHAPv2 password retries within the same EAP
768           authentication session
769         * added support for password changes with EAP-MSCHAPv2 (used when the
770           password has expired)
771         * added support for reading additional certificates from PKCS#12 files
772           and adding them to the certificate chain
773         * fixed association with IEEE 802.1X (no WPA) when dynamic WEP keys
774           were used
775         * fixed a possible double free in EAP-TTLS fast-reauthentication when
776           identity or password is entered through control interface
777         * display EAP Notification messages to user through control interface
778           with "CTRL-EVENT-EAP-NOTIFICATION" prefix
779         * added GUI version of wpa_cli, wpa_gui; this is not build
780           automatically with 'make'; use 'make wpa_gui' to build (this requires
781           Qt development tools)
782         * added 'disconnect' command to control interface for setting
783           wpa_supplicant in state where it will not associate before
784           'reassociate' command has been used
785         * added support for selecting a network from the list of all configured
786           networks ('wpa_cli select_network <network id>'; this disabled all
787           other networks; to re-enable, 'wpa_cli select_network any')
788         * added support for getting scan results through control interface
789         * added EAP workaround for PEAPv1 session resumption: allow outer,
790           i.e., not tunneled, EAP-Success to terminate session since; this can
791           be disabled with eap_workaround=0
793 2005-04-25 - v0.4.0 (beginning of 0.4.x development releases)
794         * added a new build time option, CONFIG_NO_STDOUT_DEBUG, that can be
795           used to reduce the size of the wpa_supplicant considerably if
796           debugging code is not needed
797         * fixed EAPOL-Key validation to drop packets with invalid Key Data
798           Length; such frames could have crashed wpa_supplicant due to buffer
799           overflow
800         * added support for wired authentication (IEEE 802.1X on wired
801           Ethernet); driver interface 'wired'
802         * obsoleted set_wpa() handler in the driver interface API (it can be
803           replaced by moving enable/disable functionality into init()/deinit())
804           (calls to set_wpa() are still present for backwards compatibility,
805           but they may be removed in the future)
806         * driver_madwifi: fixed association in plaintext mode
807         * modified the EAP workaround that accepts EAP-Success with incorrect
808           Identifier to be even less strict about verification in order to
809           interoperate with some authentication servers
810         * added support for sending TLS alerts
811         * added support for 'any' SSID wildcard; if ssid is not configured or
812           is set to an empty string, any SSID will be accepted for non-WPA AP
813         * added support for asking PIN (for SIM) from frontends (e.g.,
814           wpa_cli); if a PIN is needed, but not included in the configuration
815           file, a control interface request is sent and EAP processing is
816           delayed until the PIN is available
817         * added support for using external devices (e.g., a smartcard) for
818           private key operations in EAP-TLS (CONFIG_SMARTCARD=y in .config);
819           new wpa_supplicant.conf variables:
820           - global: opensc_engine_path, pkcs11_engine_path, pkcs11_module_path
821           - network: engine, engine_id, key_id
822         * added experimental support for EAP-PAX
823         * added monitor mode for wpa_cli (-a<path to a program to run>) that
824           allows external commands (e.g., shell scripts) to be run based on
825           wpa_supplicant events, e.g., when authentication has been completed
826           and data connection is ready; other related wpa_cli arguments:
827           -B (run in background), -P (write PID file); wpa_supplicant has a new
828           command line argument (-W) that can be used to make it wait until a
829           control interface command is received in order to avoid missing
830           events
831         * added support for opportunistic WPA2 PMKSA key caching (disabled by
832           default, can be enabled with proactive_key_caching=1)
833         * fixed RSN IE in 4-Way Handshake message 2/4 for the case where
834           Authenticator rejects PMKSA caching attempt and the driver is not
835           using assoc_info events
836         * added -P<pid file> argument for wpa_supplicant to write the current
837           process id into a file
839 2005-02-12 - v0.3.7 (beginning of 0.3.x stable releases)
840         * added new phase1 option parameter, include_tls_length=1, to force
841           wpa_supplicant to add TLS Message Length field to all TLS messages
842           even if the packet is not fragmented; this may be needed with some
843           authentication servers
844         * fixed WPA/RSN IE verification in message 3 of 4-Way Handshake when
845           using drivers that take care of AP selection (e.g., when using
846           ap_scan=2)
847         * fixed reprocessing of pending request after ctrl_iface requests for
848           identity/password/otp
849         * fixed ctrl_iface requests for identity/password/otp in Phase 2 of
850           EAP-PEAP and EAP-TTLS
851         * all drivers using driver_wext: set interface up and select Managed
852           mode when starting wpa_supplicant; set interface down when exiting
853         * renamed driver_ipw2100.c to driver_ipw.c since it now supports both
854           ipw2100 and ipw2200; please note that this also changed the
855           configuration variable in .config to CONFIG_DRIVER_IPW
857 2005-01-24 - v0.3.6
858         * fixed a busy loop introduced in v0.3.5 for scan result processing
859           when no matching AP is found
861 2005-01-23 - v0.3.5
862         * added a workaround for an interoperability issue with a Cisco AP
863           when using WPA2-PSK
864         * fixed non-WPA IEEE 802.1X to use the same authentication timeout as
865           WPA with IEEE 802.1X (i.e., timeout 10 -> 70 sec to allow
866           retransmission of dropped frames)
867         * fixed issues with 64-bit CPUs and SHA1 cleanup in previous version
868           (e.g., segfault when processing EAPOL-Key frames)
869         * fixed EAP workaround and fast reauthentication configuration for
870           RSN pre-authentication; previously these were disabled and
871           pre-authentication would fail if the used authentication server
872           requires EAP workarounds
873         * added support for blacklisting APs that fail or timeout
874           authentication in ap_scan=1 mode so that all APs are tried in cases
875           where the ones with strongest signal level are failing authentication
876         * fixed CA certificate loading after a failed EAP-TLS/PEAP/TTLS
877           authentication attempt
878         * allow EAP-PEAP/TTLS fast reauthentication only if Phase 2 succeeded
879           in the previous authentication (previously, only Phase 1 success was
880           verified)
882 2005-01-09 - v0.3.4
883         * added preliminary support for IBSS (ad-hoc) mode configuration
884           (mode=1 in network block); this included a new key_mgmt mode
885           WPA-NONE, i.e., TKIP or CCMP with a fixed key (based on psk) and no
886           key management; see wpa_supplicant.conf for more details and an
887           example on how to configure this (note: this is currently implemented
888           only for driver_hostapd.c, but the changes should be trivial to add
889           in associate() handler for other drivers, too (assuming the driver
890           supports WPA-None)
891         * added preliminary port for native Windows (i.e., no cygwin) using
892           mingw
894 2005-01-02 - v0.3.3
895         * added optional support for GNU Readline and History Libraries for
896           wpa_cli (CONFIG_READLINE)
897         * cleaned up EAP state machine <-> method interface and number of
898           small problems with error case processing not terminating on
899           EAP-Failure but waiting for timeout
900         * added couple of workarounds for interoperability issues with a
901           Cisco AP when using WPA2
902         * added support for EAP-FAST (draft-cam-winget-eap-fast-00.txt);
903           Note: This requires a patch for openssl to add support for TLS
904           extensions and number of workarounds for operations without
905           certificates. Proof of concept type of experimental patch is
906           included in openssl-tls-extensions.patch.
908 2004-12-19 - v0.3.2
909         * fixed private key loading for cases where passphrase is not set
910         * fixed Windows/cygwin L2 packet handler freeing; previous version
911           could cause a segfault when RSN pre-authentication was completed
912         * added support for PMKSA caching with drivers that generate RSN IEs
913           (e.g., NDIS); currently, this is only implemented in driver_ndis.c,
914           but similar code can be easily added to driver_ndiswrapper.c once
915           ndiswrapper gets full support for RSN PMKSA caching
916         * improved recovery from PMKID mismatches by requesting full EAP
917           authentication in case of failed PMKSA caching attempt
918         * driver_ndis: added support for NDIS NdisMIncidateStatus() events
919           (this requires that ndis_events is ran while wpa_supplicant is
920           running)
921         * driver_ndis: use ADD_WEP/REMOVE_WEP when configuring WEP keys
922         * added support for driver interfaces to replace the interface name
923           based on driver/OS specific mapping, e.g., in case of driver_ndis,
924           this allows the beginning of the adapter description to be used as
925           the interface name
926         * added support for CR+LF (Windows-style) line ends in configuration
927           file
928         * driver_ndis: enable radio before starting scanning, disable radio
929           when exiting
930         * modified association event handler to set portEnabled = FALSE before
931           clearing port Valid in order to reset EAP state machine and avoid
932           problems with new authentication getting ignored because of state
933           machines ending up in AUTHENTICATED/SUCCESS state based on old
934           information
935         * added support for driver events to add PMKID candidates in order to
936           allow drivers to give priority to most likely roaming candidates
937         * driver_hostap: moved PrivacyInvoked configuration to associate()
938           function so that this will not be set for plaintext connections
939         * added KEY_MGMT_802_1X_NO_WPA as a new key_mgmt type so that driver
940           interface can distinguish plaintext and IEEE 802.1X (no WPA)
941           authentication
942         * fixed static WEP key configuration to use broadcast/default type for
943           all keys (previously, the default TX key was configured as pairwise/
944           unicast key)
945         * driver_ndis: added legacy WPA capability detection for non-WPA2
946           drivers
947         * added support for setting static WEP keys for IEEE 802.1X without
948           dynamic WEP keying (eapol_flags=0)
950 2004-12-12 - v0.3.1
951         * added support for reading PKCS#12 (PFX) files (as a replacement for
952           PEM/DER) to get certificate and private key (CONFIG_PKCS12)
953         * fixed compilation with CONFIG_PCSC=y
954         * added new ap_scan mode, ap_scan=2, for drivers that take care of
955           association, but need to be configured with security policy and SSID,
956           e.g., ndiswrapper and NDIS driver; this mode should allow such
957           drivers to work with hidden SSIDs and optimized roaming; when
958           ap_scan=2 is used, only the first network block in the configuration
959           file is used and this configuration should have explicit security
960           policy (i.e., only one option in the lists) for key_mgmt, pairwise,
961           group, proto variables
962         * added experimental port of wpa_supplicant for Windows
963           - driver_ndis.c driver interface (NDIS OIDs)
964           - currently, this requires cygwin and WinPcap
965           - small utility, win_if_list, can be used to get interface name
966         * control interface can now be removed at build time; add
967           CONFIG_CTRL_IFACE=y to .config to maintain old functionality
968         * optional Xsupplicant interface can now be removed at build time;
969           (CONFIG_XSUPPLICANT_IFACE=y in .config to bring it back)
970         * added auth_alg to driver interface associate() parameters to make it
971           easier for drivers to configure authentication algorithm as part of
972           the association
974 2004-12-05 - v0.3.0 (beginning of 0.3.x development releases)
975         * driver_broadcom: added new driver interface for Broadcom wl.o driver
976           (a generic driver for Broadcom IEEE 802.11a/g cards)
977         * wpa_cli: fixed parsing of -p <path> command line argument
978         * PEAPv1: fixed tunneled EAP-Success reply handling to reply with TLS
979           ACK, not tunneled EAP-Success (of which only the first byte was
980           actually send due to a bug in previous code); this seems to
981           interoperate with most RADIUS servers that implements PEAPv1
982         * PEAPv1: added support for terminating PEAP authentication on tunneled
983           EAP-Success message; this can be configured by adding
984           peap_outer_success=0 on phase1 parameters in wpa_supplicant.conf
985           (some RADIUS servers require this whereas others require a tunneled
986           reply
987         * PEAPv1: changed phase1 option peaplabel to use default to 0, i.e., to
988           the old label for key derivation; previously, the default was 1,
989           but it looks like most existing PEAPv1 implementations use the old
990           label which is thus more suitable default option
991         * added support for EAP-PSK (draft-bersani-eap-psk-03.txt)
992         * fixed parsing of wep_tx_keyidx
993         * added support for configuring list of allowed Phase 2 EAP types
994           (for both EAP-PEAP and EAP-TTLS) instead of only one type
995         * added support for configuring IEEE 802.11 authentication algorithm
996           (auth_alg; mainly for using Shared Key authentication with static
997           WEP keys)
998         * added support for EAP-AKA (with UMTS SIM)
999         * fixed couple of errors in PCSC handling that could have caused
1000           random-looking errors for EAP-SIM
1001         * added support for EAP-SIM pseudonyms and fast re-authentication
1002         * added support for EAP-TLS/PEAP/TTLS fast re-authentication (TLS
1003           session resumption)
1004         * added support for EAP-SIM with two challanges
1005           (phase1="sim_min_num_chal=3" can be used to require three challenges)
1006         * added support for configuring DH/DSA parameters for an ephemeral DH
1007           key exchange (EAP-TLS/PEAP/TTLS) using new configuration parameters
1008           dh_file and dh_file2 (phase 2); this adds support for using DSA keys
1009           and optional DH key exchange to achieve forward secracy with RSA keys
1010         * added support for matching subject of the authentication server
1011           certificate with a substring when using EAP-TLS/PEAP/TTLS; new
1012           configuration variables subject_match and subject_match2
1013         * changed SSID configuration in driver_wext.c (used by many driver
1014           interfaces) to use ssid_len+1 as the length for SSID since some Linux
1015           drivers expect this
1016         * fixed couple of unaligned reads in scan result parsing to fix WPA
1017           connection on some platforms (e.g., ARM)
1018         * added driver interface for Intel ipw2100 driver
1019         * added support for LEAP with WPA
1020         * added support for larger scan results report (old limit was 4 kB of
1021           data, i.e., about 35 or so APs) when using Linux wireless extensions
1022           v17 or newer
1023         * fixed a bug in PMKSA cache processing: skip sending of EAPOL-Start
1024           only if there is a PMKSA cache entry for the current AP
1025         * fixed error handling for case where reading of scan results fails:
1026           must schedule a new scan or wpa_supplicant will remain waiting
1027           forever
1028         * changed debug output to remove shared password/key material by
1029           default; all key information can be included with -K command line
1030           argument to match the previous behavior
1031         * added support for timestamping debug log messages (disabled by
1032           default, can be enabled with -t command line argument)
1033         * set pairwise/group cipher suite for non-WPA IEEE 802.1X to WEP-104
1034           if keys are not configured to be used; this fixes IEEE 802.1X mode
1035           with drivers that use this information to configure whether Privacy
1036           bit can be in Beacon frames (e.g., ndiswrapper)
1037         * avoid clearing driver keys if no keys have been configured since last
1038           key clear request; this seems to improve reliability of group key
1039           handshake for ndiswrapper & NDIS driver which seems to be suffering
1040           of some kind of timing issue when the keys are cleared again after
1041           association
1042         * changed driver interface API:
1043           - WPA_SUPPLICANT_DRIVER_VERSION define can be used to determine which
1044             version is being used (now, this is set to 2; previously, it was
1045             not defined)
1046           - pass pointer to private data structure to all calls
1047           - the new API is not backwards compatible; all in-tree driver
1048             interfaces has been converted to the new API
1049         * added support for controlling multiple interfaces (radios) per
1050           wpa_supplicant process; each interface needs to be listed on the
1051           command line (-c, -i, -D arguments) with -N as a separator
1052           (-cwpa1.conf -iwlan0 -Dhostap -N -cwpa2.conf -iath0 -Dmadwifi)
1053         * added a workaround for EAP servers that incorrectly use same Id for
1054           sequential EAP packets
1055         * changed libpcap/libdnet configuration to use .config variable,
1056           CONFIG_DNET_PCAP, instead of requiring Makefile modification
1057         * improved downgrade attack detection in IE verification of msg 3/4:
1058           verify both WPA and RSN IEs, if present, not only the selected one;
1059           reject the AP if an RSN IE is found in msg 3/4, but not in Beacon or
1060           Probe Response frame, and RSN is enabled in wpa_supplicant
1061           configuration
1062         * fixed WPA msg 3/4 processing to allow Key Data field contain other
1063           IEs than just one WPA IE
1064         * added support for FreeBSD and driver interface for the BSD net80211
1065           layer (CONFIG_DRIVER_BSD=y in .config); please note that some of the
1066           required kernel mods have not yet been committed
1067         * made EAP workarounds configurable; enabled by default, can be
1068           disabled with network block option eap_workaround=0
1070 2004-07-17 - v0.2.4 (beginning of 0.2.x stable releases)
1071         * resolved couple of interoperability issues with EAP-PEAPv1 and
1072           Phase 2 (inner EAP) fragment reassembly
1073         * driver_madwifi: fixed WEP key configuration for IEEE 802.1X when the
1074           AP is using non-zero key index for the unicast key and key index zero
1075           for the broadcast key
1076         * driver_hostap: fixed IEEE 802.1X WEP key updates and
1077           re-authentication by allowing unencrypted EAPOL frames when not using
1078           WPA
1079         * added a new driver interface, 'wext', which uses only standard,
1080           driver independent functionality in Linux wireless extensions;
1081           currently, this can be used only for non-WPA IEEE 802.1X mode, but
1082           eventually, this is to be extended to support full WPA/WPA2 once
1083           Linux wireless extensions get support for this
1084         * added support for mode in which the driver is responsible for AP
1085           scanning and selection; this is disabled by default and can be
1086           enabled with global ap_scan=0 variable in wpa_supplicant.conf;
1087           this mode can be used, e.g., with generic 'wext' driver interface to
1088           use wpa_supplicant as IEEE 802.1X Supplicant with any Linux driver
1089           supporting wireless extensions.
1090         * driver_madwifi: fixed WPA2 configuration and scan_ssid=1 (e.g.,
1091           operation with an AP that does not include SSID in the Beacon frames)
1092         * added support for new EAP authentication methods:
1093           EAP-TTLS/EAP-OTP, EAP-PEAPv0/OTP, EAP-PEAPv1/OTP, EAP-OTP
1094         * added support for asking one-time-passwords from frontends (e.g.,
1095           wpa_cli); this 'otp' command works otherwise like 'password' command,
1096           but the password is used only once and the frontend will be asked for
1097           a new password whenever a request from authenticator requires a
1098           password; this can be used with both EAP-OTP and EAP-GTC
1099         * changed wpa_cli to automatically re-establish connection so that it
1100           does not need to be re-started when wpa_supplicant is terminated and
1101           started again
1102         * improved user data (identity/password/otp) requests through
1103           frontends: process pending EAPOL packets after getting new
1104           information so that full authentication does not need to be
1105           restarted; in addition, send pending requests again whenever a new
1106           frontend is attached
1107         * changed control frontends to use a new directory for socket files to
1108           make it easier for wpa_cli to automatically select between interfaces
1109           and to provide access control for the control interface;
1110           wpa_supplicant.conf: ctrl_interface is now a path
1111           (/var/run/wpa_supplicant is the recommended path) and
1112           ctrl_interface_group can be used to select which group gets access to
1113           the control interface;
1114           wpa_cli: by default, try to connect to the first interface available
1115           in /var/run/wpa_supplicant; this path can be overriden with -p option
1116           and an interface can be selected with -i option (i.e., in most common
1117           cases, wpa_cli does not need to get any arguments)
1118         * added support for LEAP
1119         * added driver interface for Linux ndiswrapper
1120         * added priority option for network blocks in the configuration file;
1121           this allows networks to be grouped based on priority (the scan
1122           results are searched for matches with network blocks in this order)
1124 2004-06-20 - v0.2.3
1125         * sort scan results to improve AP selection
1126         * fixed control interface socket removal for some error cases
1127         * improved scan requesting and authentication timeout
1128         * small improvements/bug fixes for EAP-MSCHAPv2, EAP-PEAP, and
1129           TLS processing
1130         * PEAP version can now be forced with phase1="peapver=<ver>"
1131           (mostly for testing; by default, the highest version supported by
1132           both the Supplicant and Authentication Server is selected
1133           automatically)
1134         * added support for madwifi driver (Atheros ar521x)
1135         * added a workaround for cases where AP sets Install Tx/Rx bit for
1136           WPA Group Key messages when pairwise keys are used (without this,
1137           the Group Key would be used for Tx and the AP would drop frames
1138           from the station)
1139         * added GSM SIM/USIM interface for GSM authentication algorithm for
1140           EAP-SIM; this requires pcsc-lite
1141         * added support for ATMEL AT76C5XXx driver
1142         * fixed IEEE 802.1X WEP key derivation in the case where Authenticator
1143           does not include key data in the EAPOL-Key frame (i.e., part of
1144           EAP keying material is used as data encryption key)
1145         * added support for using plaintext and static WEP networks
1146           (key_mgmt=NONE)
1148 2004-05-31 - v0.2.2
1149         * added support for new EAP authentication methods:
1150           EAP-TTLS/EAP-MD5-Challenge
1151           EAP-TTLS/EAP-GTC
1152           EAP-TTLS/EAP-MSCHAPv2
1153           EAP-TTLS/EAP-TLS
1154           EAP-TTLS/MSCHAPv2
1155           EAP-TTLS/MSCHAP
1156           EAP-TTLS/PAP
1157           EAP-TTLS/CHAP
1158           EAP-PEAP/TLS
1159           EAP-PEAP/GTC
1160           EAP-PEAP/MD5-Challenge
1161           EAP-GTC
1162           EAP-SIM (not yet complete; needs GSM/SIM authentication interface)
1163         * added support for anonymous identity (to be used when identity is
1164           sent in plaintext; real identity will be used within TLS protected
1165           tunnel (e.g., with EAP-TTLS)
1166         * added event messages from wpa_supplicant to frontends, e.g., wpa_cli
1167         * added support for requesting identity and password information using
1168           control interface; in other words, the password for EAP-PEAP or
1169           EAP-TTLS does not need to be included in the configuration file since
1170           a frontand (e.g., wpa_cli) can ask it from the user
1171         * improved RSN pre-authentication to use a candidate list and process
1172           all candidates from each scan; not only one per scan
1173         * fixed RSN IE and WPA IE capabilities field parsing
1174         * ignore Tx bit in GTK IE when Pairwise keys are used
1175         * avoid making new scan requests during IEEE 802.1X negotiation
1176         * use openssl/libcrypto for MD5 and SHA-1 when compiling wpa_supplicant
1177           with TLS support (this replaces the included implementation with
1178           library code to save about 8 kB since the library code is needed
1179           anyway for TLS)
1180         * fixed WPA-PSK only mode when compiled without IEEE 802.1X support
1181           (i.e., without CONFIG_IEEE8021X_EAPOL=y in .config)
1183 2004-05-06 - v0.2.1
1184         * added support for internal IEEE 802.1X (actually, IEEE 802.1aa/D6.1)
1185           Supplicant
1186           - EAPOL state machines for Supplicant [IEEE 802.1aa/D6.1]
1187           - EAP peer state machine [draft-ietf-eap-statemachine-02.pdf]
1188           - EAP-MD5 (cannot be used with WPA-RADIUS)
1189             [draft-ietf-eap-rfc2284bis-09.txt]
1190           - EAP-TLS [RFC 2716]
1191           - EAP-MSCHAPv2 (currently used only with EAP-PEAP)
1192           - EAP-PEAP/MSCHAPv2 [draft-josefsson-pppext-eap-tls-eap-07.txt]
1193             [draft-kamath-pppext-eap-mschapv2-00.txt]
1194             (PEAP version 0, 1, and parts of 2; only 0 and 1 are enabled by
1195             default; tested with FreeRADIUS, Microsoft IAS, and Funk Odyssey)
1196           - new configuration file options: eap, identity, password, ca_cert,
1197             client_cert, privatekey, private_key_passwd
1198           - Xsupplicant is not required anymore, but it can be used by
1199             disabling the internal IEEE 802.1X Supplicant with -e command line
1200             option
1201           - this code is not included in the default build; Makefile need to
1202             be edited for this (uncomment lines for selected functionality)
1203           - EAP-TLS and EAP-PEAP require openssl libraries
1204         * use module prefix in debug messages (WPA, EAP, EAP-TLS, ..)
1205         * added support for non-WPA IEEE 802.1X mode with dynamic WEP keys
1206           (i.e., complete IEEE 802.1X/EAP authentication and use IEEE 802.1X
1207            EAPOL-Key frames instead of WPA key handshakes)
1208         * added support for IEEE 802.11i/RSN (WPA2)
1209           - improved PTK Key Handshake
1210           - PMKSA caching, pre-authentication
1211         * fixed wpa_supplicant to ignore possible extra data after WPA
1212           EAPOL-Key packets (this fixes 'Invalid EAPOL-Key MIC when using
1213           TPTK' error from message 3 of 4-Way Handshake in case the AP
1214           includes extra data after the EAPOL-Key)
1215         * added interface for external programs (frontends) to control
1216           wpa_supplicant
1217           - CLI example (wpa_cli) with interactive mode and command line
1218             mode
1219           - replaced SIGUSR1 status/statistics with the new control interface
1220         * made some feature compile time configurable
1221           - .config file for make
1222           - driver interfaces (hostap, hermes, ..)
1223           - EAPOL/EAP functions
1225 2004-02-15 - v0.2.0
1226         * Initial version of wpa_supplicant