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