1 ChangeLog for wpa_supplicant
4 * fixed PC/SC code to use correct length for GSM AUTH command buffer
5 and to not use pioRecvPci with SCardTransmit() calls; these were not
6 causing visible problems with pcsc-lite, but Windows Winscard.dll
7 refused the previously used parameters; this fixes EAP-SIM and
8 EAP-AKA authentication using SIM/USIM card under Windows
9 * added support for EAP-FAST key derivation using other ciphers than
10 RC4-128-SHA for authentication and AES128-SHA for provisioning
11 * fixed EAP-SIM and EAP-AKA pseudonym and fast re-authentication to
12 decrypt AT_ENCR_DATA attributes correctly
13 * added support for configuring CA certificate as DER file and as a
15 * fixed private key configuration as configuration blob and added
16 support for using PKCS#12 as a blob
18 * added support for loading trusted CA certificates from Windows
19 certificate store: ca_cert="cert_store://<name>", where <name> is
20 likely CA (Intermediate CA certificates) or ROOT (root certificates)
21 * fixed TLS library deinitialization after RSN pre-authentication not
22 to disable TLS library for normal authentication
23 * fixed PMKSA cache processing not to trigger deauthentication if the
24 current PMKSA cache entry is replaced with a valid new entry
25 * fixed PC/SC initialization for ap_scan != 1 modes (this fixes
26 EAP-SIM and EAP-AKA with real SIM/USIM card when using ap_scan=0 or
28 * do not try to use USIM APDUs when initializing PC/SC for SIM card
29 access for a network that has not enabled EAP-AKA
31 2005-11-20 - v0.4.7 (beginning of 0.4.x stable releases)
32 * l2_packet_pcap: fixed wired IEEE 802.1X authentication with libpcap
33 and WinPcap to receive frames sent to PAE group address
34 * disable EAP state machine when IEEE 802.1X authentication is not used
35 in order to get rid of bogus "EAP failed" messages
36 * fixed OpenSSL error reporting to go through all pending errors to
37 avoid confusing reports of old errors being reported at later point
39 * fixed configuration file updating to not write empty variables
40 (e.g., proto or key_mgmt) that the file parser would not accept
41 * fixed ADD_NETWORK ctrl_iface command to use the same default values
42 for variables as empty network definitions read from config file
44 * fixed EAP state machine to not discard EAP-Failure messages in many
45 cases (e.g., during TLS handshake)
46 * fixed a infinite loop in private key reading if the configured file
47 cannot be parsed successfully
48 * driver_madwifi: added support for madwifi-ng
49 * wpa_gui: do not display password/PSK field contents
50 * wpa_gui: added CA certificate configuration
51 * driver_ndis: fixed scan request in ap_scan=2 mode not to change SSID
52 * driver_ndis: include Beacon IEs in AssocInfo in order to notice if
53 the new AP is using different WPA/RSN IE
54 * use longer timeout for IEEE 802.11 association to avoid problems with
55 drivers that may take more than five second to associate
58 * allow fallback to WPA, if mixed WPA+WPA2 networks have mismatch in
59 RSN IE, but WPA IE would match with wpa_supplicant configuration
60 * added support for named configuration blobs in order to avoid having
61 to use file system for external files (e.g., certificates);
62 variables can be set to "blob://<blob name>" instead of file path to
63 use a named blob; supported fields: pac_file, client_cert,
65 * fixed RSN pre-authentication (it was broken in the clean up of WPA
66 state machine interface in v0.4.5)
67 * driver_madwifi: set IEEE80211_KEY_GROUP flag for group keys to make
68 sure the driver configures broadcast decryption correctly
69 * added ca_path (and ca_path2) configuration variables that can be used
70 to configure OpenSSL CA path, e.g., /etc/ssl/certs, for using the
71 system-wide trusted CA list
72 * added support for starting wpa_supplicant without a configuration
73 file (-C argument must be used to set ctrl_interface parameter for
74 this case; in addition, -p argument can be used to provide
75 driver_param; these new arguments can also be used with a
76 configuration to override the values from the configuration)
77 * added global control interface that can be optionally used for adding
78 and removing network interfaces dynamically (-g command line argument
79 for both wpa_supplicant and wpa_cli) without having to restart
80 wpa_supplicant process
82 - try to save configuration whenever something is modified
83 - added WEP key configuration
84 - added possibility to edit the current network configuration
85 * driver_ndis: fixed driver polling not to increase frequency on each
86 received EAPOL frame due to incorrectly cancelled timeout
87 * added simple configuration file examples (in examples subdirectory)
88 * fixed driver_wext.c to filter wireless events based on ifindex to
89 avoid interfaces receiving events from other interfaces
90 * delay sending initial EAPOL-Start couple of seconds to speed up
91 authentication for the most common case of Authenticator starting
92 EAP authentication immediately after association
95 * added a workaround for clearing keys with ndiswrapper to allow
96 roaming from WPA enabled AP to plaintext one
97 * added docbook documentation (doc/docbook) that can be used to
98 generate, e.g., man pages
99 * l2_packet_linux: use socket type SOCK_DGRAM instead of SOCK_RAW for
100 PF_PACKET in order to prepare for network devices that do not use
101 Ethernet headers (e.g., network stack with native IEEE 802.11 frames)
102 * use receipt of EAPOL-Key frame as a lower layer success indication
103 for EAP state machine to allow recovery from dropped EAP-Success
105 * cleaned up internal EAPOL frame processing by not including link
106 layer (Ethernet) header during WPA and EAPOL/EAP processing; this
107 header is added only when transmitted the frame; this makes it easier
108 to use wpa_supplicant on link layers that use different header than
110 * updated EAP-PSK to use draft 9 by default since this can now be
111 tested with hostapd; removed support for draft 3, including
112 server_nai configuration option from network blocks
113 * driver_wired: add PAE address to the multicast address list in order
114 to be able to receive EAPOL frames with drivers that do not include
115 these multicast addresses by default
116 * driver_wext: add support for WE-19
117 * added support for multiple configuration backends (CONFIG_BACKEND
118 option); currently, only 'file' is supported (i.e., the format used
119 in wpa_supplicant.conf)
120 * added support for updating configuration ('wpa_cli save_config');
121 this is disabled by default and can be enabled with global
122 update_config=1 variable in wpa_supplicant.conf; this allows wpa_cli
123 and wpa_gui to store the configuration changes in a permanent store
124 * added GET_NETWORK ctrl_iface command
125 (e.g., 'wpa_cli get_network 0 ssid')
128 * replaced OpenSSL patch for EAP-FAST support
129 (openssl-tls-extensions.patch) with a more generic and correct
130 patch (the new patch is not compatible with the previous one, so the
131 OpenSSL library will need to be patched with the new patch in order
132 to be able to build wpa_supplicant with EAP-FAST support)
133 * added support for using Windows certificate store (through CryptoAPI)
134 for client certificate and private key operations (EAP-TLS)
135 (see wpa_supplicant.conf for more information on how to configure
136 this with private_key)
137 * ported wpa_gui to Windows
138 * added Qt4 version of wpa_gui (wpa_gui-qt4 directory); this can be
139 built with the open source version of the Qt4 for Windows
140 * allow non-WPA modes (e.g., IEEE 802.1X with dynamic WEP) to be used
141 with drivers that do not support WPA
142 * ndis_events: fixed Windows 2000 support
143 * added support for enabling/disabling networks from the list of all
144 configured networks ('wpa_cli enable_network <network id>' and
145 'wpa_cli disable_network <network id>')
146 * added support for adding and removing network from the current
147 configuration ('wpa_cli add_network' and 'wpa_cli remove_network
148 <network id>'); added networks are disabled by default and they can
149 be enabled with enable_network command once the configuration is done
150 for the new network; note: configuration file is not yet updated, so
151 these new networks are lost when wpa_supplicant is restarted
152 * added support for setting network configuration parameters through
153 the control interface, for example:
154 wpa_cli set_network 0 ssid "\"my network\""
155 * fixed parsing of strings that include both " and # within double
156 quoted area (e.g., "start"#end")
157 * added EAP workaround for PEAP session resumption: allow outer,
158 i.e., not tunneled, EAP-Success to terminate session since; this can
159 be disabled with eap_workaround=0
160 (this was allowed for PEAPv1 before, but now it is also allowed for
161 PEAPv0 since at least one RADIUS authentication server seems to be
162 doing this for PEAPv0, too)
163 * wpa_gui: added preliminary support for adding new networks to the
164 wpa_supplicant configuration (double click on the scan results to
165 open network configuration)
168 * removed interface for external EAPOL/EAP supplicant (e.g.,
169 Xsupplicant), (CONFIG_XSUPPLICANT_IFACE) since it is not required
170 anymore and is unlikely to be used by anyone
171 * driver_ndis: fixed WinPcap 3.0 support
172 * fixed build with CONFIG_DNET_PCAP=y on Linux
173 * l2_packet: moved different implementations into separate files
177 * driver_ipw: updated driver structures to match with ipw2200-1.0.4
178 (note: ipw2100-1.1.0 is likely to require an update to work with
180 * added support for using ap_scan=2 mode with multiple network blocks;
181 wpa_supplicant will go through the networks one by one until the
182 driver reports a successful association; this uses the same order for
183 networks as scan_ssid=1 scans, i.e., the priority field is ignored
184 and the network block order in the file is used instead
185 * fixed a potential issue in RSN pre-authentication ending up using
186 freed memory if pre-authentication times out
187 * added support for matching alternative subject name extensions of the
188 authentication server certificate; new configuration variables
189 altsubject_match and altsubject_match2
190 * driver_ndis: added support for IEEE 802.1X authentication with wired
192 * added support for querying private key password (EAP-TLS) through the
193 control interface (wpa_cli/wpa_gui) if one is not included in the
195 * driver_broadcom: fixed couple of memory leaks in scan result
197 * EAP-PAX is now registered as EAP type 46
198 * fixed EAP-PAX MAC calculation
199 * fixed EAP-PAX CK and ICK key derivation
200 * added support for using password with EAP-PAX (as an alternative to
201 entering key with eappsk); SHA-1 hash of the password will be used as
203 * added support for arbitrary driver interface parameters through the
204 configuration file with a new driver_param field; this adds a new
205 driver_ops function set_param()
206 * added possibility to override l2_packet module with driver interface
207 API (new send_eapol handler); this can be used to implement driver
208 specific TX/RX functions for EAPOL frames
209 * fixed ctrl_interface_group processing for the case where gid is
210 entered as a number, not group name
211 * driver_test: added support for testing hostapd with wpa_supplicant
212 by using test driver interface without any kernel drivers or network
216 * driver_madwifi: fixed WPA/WPA2 mode configuration to allow EAPOL
217 packets to be encrypted; this was apparently broken by the changed
218 ioctl order in v0.4.0
219 * driver_madwifi: added preliminary support for compiling against 'BSD'
220 branch of madwifi CVS tree
221 * added support for EAP-MSCHAPv2 password retries within the same EAP
222 authentication session
223 * added support for password changes with EAP-MSCHAPv2 (used when the
224 password has expired)
225 * added support for reading additional certificates from PKCS#12 files
226 and adding them to the certificate chain
227 * fixed association with IEEE 802.1X (no WPA) when dynamic WEP keys
229 * fixed a possible double free in EAP-TTLS fast-reauthentication when
230 identity or password is entered through control interface
231 * display EAP Notification messages to user through control interface
232 with "CTRL-EVENT-EAP-NOTIFICATION" prefix
233 * added GUI version of wpa_cli, wpa_gui; this is not build
234 automatically with 'make'; use 'make wpa_gui' to build (this requires
235 Qt development tools)
236 * added 'disconnect' command to control interface for setting
237 wpa_supplicant in state where it will not associate before
238 'reassociate' command has been used
239 * added support for selecting a network from the list of all configured
240 networks ('wpa_cli select_network <network id>'; this disabled all
241 other networks; to re-enable, 'wpa_cli select_network any')
242 * added support for getting scan results through control interface
243 * added EAP workaround for PEAPv1 session resumption: allow outer,
244 i.e., not tunneled, EAP-Success to terminate session since; this can
245 be disabled with eap_workaround=0
247 2005-04-25 - v0.4.0 (beginning of 0.4.x development releases)
248 * added a new build time option, CONFIG_NO_STDOUT_DEBUG, that can be
249 used to reduce the size of the wpa_supplicant considerably if
250 debugging code is not needed
251 * fixed EAPOL-Key validation to drop packets with invalid Key Data
252 Length; such frames could have crashed wpa_supplicant due to buffer
254 * added support for wired authentication (IEEE 802.1X on wired
255 Ethernet); driver interface 'wired'
256 * obsoleted set_wpa() handler in the driver interface API (it can be
257 replaced by moving enable/disable functionality into init()/deinit())
258 (calls to set_wpa() are still present for backwards compatibility,
259 but they may be removed in the future)
260 * driver_madwifi: fixed association in plaintext mode
261 * modified the EAP workaround that accepts EAP-Success with incorrect
262 Identifier to be even less strict about verification in order to
263 interoperate with some authentication servers
264 * added support for sending TLS alerts
265 * added support for 'any' SSID wildcard; if ssid is not configured or
266 is set to an empty string, any SSID will be accepted for non-WPA AP
267 * added support for asking PIN (for SIM) from frontends (e.g.,
268 wpa_cli); if a PIN is needed, but not included in the configuration
269 file, a control interface request is sent and EAP processing is
270 delayed until the PIN is available
271 * added support for using external devices (e.g., a smartcard) for
272 private key operations in EAP-TLS (CONFIG_SMARTCARD=y in .config);
273 new wpa_supplicant.conf variables:
274 - global: opensc_engine_path, pkcs11_engine_path, pkcs11_module_path
275 - network: engine, engine_id, key_id
276 * added experimental support for EAP-PAX
277 * added monitor mode for wpa_cli (-a<path to a program to run>) that
278 allows external commands (e.g., shell scripts) to be run based on
279 wpa_supplicant events, e.g., when authentication has been completed
280 and data connection is ready; other related wpa_cli arguments:
281 -B (run in background), -P (write PID file); wpa_supplicant has a new
282 command line argument (-W) that can be used to make it wait until a
283 control interface command is received in order to avoid missing
285 * added support for opportunistic WPA2 PMKSA key caching (disabled by
286 default, can be enabled with proactive_key_caching=1)
287 * fixed RSN IE in 4-Way Handshake message 2/4 for the case where
288 Authenticator rejects PMKSA caching attempt and the driver is not
289 using assoc_info events
290 * added -P<pid file> argument for wpa_supplicant to write the current
291 process id into a file
293 2005-02-12 - v0.3.7 (beginning of 0.3.x stable releases)
294 * added new phase1 option parameter, include_tls_length=1, to force
295 wpa_supplicant to add TLS Message Length field to all TLS messages
296 even if the packet is not fragmented; this may be needed with some
297 authentication servers
298 * fixed WPA/RSN IE verification in message 3 of 4-Way Handshake when
299 using drivers that take care of AP selection (e.g., when using
301 * fixed reprocessing of pending request after ctrl_iface requests for
302 identity/password/otp
303 * fixed ctrl_iface requests for identity/password/otp in Phase 2 of
304 EAP-PEAP and EAP-TTLS
305 * all drivers using driver_wext: set interface up and select Managed
306 mode when starting wpa_supplicant; set interface down when exiting
307 * renamed driver_ipw2100.c to driver_ipw.c since it now supports both
308 ipw2100 and ipw2200; please note that this also changed the
309 configuration variable in .config to CONFIG_DRIVER_IPW
312 * fixed a busy loop introduced in v0.3.5 for scan result processing
313 when no matching AP is found
316 * added a workaround for an interoperability issue with a Cisco AP
318 * fixed non-WPA IEEE 802.1X to use the same authentication timeout as
319 WPA with IEEE 802.1X (i.e., timeout 10 -> 70 sec to allow
320 retransmission of dropped frames)
321 * fixed issues with 64-bit CPUs and SHA1 cleanup in previous version
322 (e.g., segfault when processing EAPOL-Key frames)
323 * fixed EAP workaround and fast reauthentication configuration for
324 RSN pre-authentication; previously these were disabled and
325 pre-authentication would fail if the used authentication server
326 requires EAP workarounds
327 * added support for blacklisting APs that fail or timeout
328 authentication in ap_scan=1 mode so that all APs are tried in cases
329 where the ones with strongest signal level are failing authentication
330 * fixed CA certificate loading after a failed EAP-TLS/PEAP/TTLS
331 authentication attempt
332 * allow EAP-PEAP/TTLS fast reauthentication only if Phase 2 succeeded
333 in the previous authentication (previously, only Phase 1 success was
337 * added preliminary support for IBSS (ad-hoc) mode configuration
338 (mode=1 in network block); this included a new key_mgmt mode
339 WPA-NONE, i.e., TKIP or CCMP with a fixed key (based on psk) and no
340 key management; see wpa_supplicant.conf for more details and an
341 example on how to configure this (note: this is currently implemented
342 only for driver_hostapd.c, but the changes should be trivial to add
343 in associate() handler for other drivers, too (assuming the driver
345 * added preliminary port for native Windows (i.e., no cygwin) using
349 * added optional support for GNU Readline and History Libraries for
350 wpa_cli (CONFIG_READLINE)
351 * cleaned up EAP state machine <-> method interface and number of
352 small problems with error case processing not terminating on
353 EAP-Failure but waiting for timeout
354 * added couple of workarounds for interoperability issues with a
355 Cisco AP when using WPA2
356 * added support for EAP-FAST (draft-cam-winget-eap-fast-00.txt);
357 Note: This requires a patch for openssl to add support for TLS
358 extensions and number of workarounds for operations without
359 certificates. Proof of concept type of experimental patch is
360 included in openssl-tls-extensions.patch.
363 * fixed private key loading for cases where passphrase is not set
364 * fixed Windows/cygwin L2 packet handler freeing; previous version
365 could cause a segfault when RSN pre-authentication was completed
366 * added support for PMKSA caching with drivers that generate RSN IEs
367 (e.g., NDIS); currently, this is only implemented in driver_ndis.c,
368 but similar code can be easily added to driver_ndiswrapper.c once
369 ndiswrapper gets full support for RSN PMKSA caching
370 * improved recovery from PMKID mismatches by requesting full EAP
371 authentication in case of failed PMKSA caching attempt
372 * driver_ndis: added support for NDIS NdisMIncidateStatus() events
373 (this requires that ndis_events is ran while wpa_supplicant is
375 * driver_ndis: use ADD_WEP/REMOVE_WEP when configuring WEP keys
376 * added support for driver interfaces to replace the interface name
377 based on driver/OS specific mapping, e.g., in case of driver_ndis,
378 this allows the beginning of the adapter description to be used as
380 * added support for CR+LF (Windows-style) line ends in configuration
382 * driver_ndis: enable radio before starting scanning, disable radio
384 * modified association event handler to set portEnabled = FALSE before
385 clearing port Valid in order to reset EAP state machine and avoid
386 problems with new authentication getting ignored because of state
387 machines ending up in AUTHENTICATED/SUCCESS state based on old
389 * added support for driver events to add PMKID candidates in order to
390 allow drivers to give priority to most likely roaming candidates
391 * driver_hostap: moved PrivacyInvoked configuration to associate()
392 function so that this will not be set for plaintext connections
393 * added KEY_MGMT_802_1X_NO_WPA as a new key_mgmt type so that driver
394 interface can distinguish plaintext and IEEE 802.1X (no WPA)
396 * fixed static WEP key configuration to use broadcast/default type for
397 all keys (previously, the default TX key was configured as pairwise/
399 * driver_ndis: added legacy WPA capability detection for non-WPA2
401 * added support for setting static WEP keys for IEEE 802.1X without
402 dynamic WEP keying (eapol_flags=0)
405 * added support for reading PKCS#12 (PFX) files (as a replacement for
406 PEM/DER) to get certificate and private key (CONFIG_PKCS12)
407 * fixed compilation with CONFIG_PCSC=y
408 * added new ap_scan mode, ap_scan=2, for drivers that take care of
409 association, but need to be configured with security policy and SSID,
410 e.g., ndiswrapper and NDIS driver; this mode should allow such
411 drivers to work with hidden SSIDs and optimized roaming; when
412 ap_scan=2 is used, only the first network block in the configuration
413 file is used and this configuration should have explicit security
414 policy (i.e., only one option in the lists) for key_mgmt, pairwise,
415 group, proto variables
416 * added experimental port of wpa_supplicant for Windows
417 - driver_ndis.c driver interface (NDIS OIDs)
418 - currently, this requires cygwin and WinPcap
419 - small utility, win_if_list, can be used to get interface name
420 * control interface can now be removed at build time; add
421 CONFIG_CTRL_IFACE=y to .config to maintain old functionality
422 * optional Xsupplicant interface can now be removed at build time;
423 (CONFIG_XSUPPLICANT_IFACE=y in .config to bring it back)
424 * added auth_alg to driver interface associate() parameters to make it
425 easier for drivers to configure authentication algorithm as part of
428 2004-12-05 - v0.3.0 (beginning of 0.3.x development releases)
429 * driver_broadcom: added new driver interface for Broadcom wl.o driver
430 (a generic driver for Broadcom IEEE 802.11a/g cards)
431 * wpa_cli: fixed parsing of -p <path> command line argument
432 * PEAPv1: fixed tunneled EAP-Success reply handling to reply with TLS
433 ACK, not tunneled EAP-Success (of which only the first byte was
434 actually send due to a bug in previous code); this seems to
435 interoperate with most RADIUS servers that implements PEAPv1
436 * PEAPv1: added support for terminating PEAP authentication on tunneled
437 EAP-Success message; this can be configured by adding
438 peap_outer_success=0 on phase1 parameters in wpa_supplicant.conf
439 (some RADIUS servers require this whereas others require a tunneled
441 * PEAPv1: changed phase1 option peaplabel to use default to 0, i.e., to
442 the old label for key derivation; previously, the default was 1,
443 but it looks like most existing PEAPv1 implementations use the old
444 label which is thus more suitable default option
445 * added support for EAP-PSK (draft-bersani-eap-psk-03.txt)
446 * fixed parsing of wep_tx_keyidx
447 * added support for configuring list of allowed Phase 2 EAP types
448 (for both EAP-PEAP and EAP-TTLS) instead of only one type
449 * added support for configuring IEEE 802.11 authentication algorithm
450 (auth_alg; mainly for using Shared Key authentication with static
452 * added support for EAP-AKA (with UMTS SIM)
453 * fixed couple of errors in PCSC handling that could have caused
454 random-looking errors for EAP-SIM
455 * added support for EAP-SIM pseudonyms and fast re-authentication
456 * added support for EAP-TLS/PEAP/TTLS fast re-authentication (TLS
458 * added support for EAP-SIM with two challanges
459 (phase1="sim_min_num_chal=3" can be used to require three challenges)
460 * added support for configuring DH/DSA parameters for an ephemeral DH
461 key exchange (EAP-TLS/PEAP/TTLS) using new configuration parameters
462 dh_file and dh_file2 (phase 2); this adds support for using DSA keys
463 and optional DH key exchange to achieve forward secracy with RSA keys
464 * added support for matching subject of the authentication server
465 certificate with a substring when using EAP-TLS/PEAP/TTLS; new
466 configuration variables subject_match and subject_match2
467 * changed SSID configuration in driver_wext.c (used by many driver
468 interfaces) to use ssid_len+1 as the length for SSID since some Linux
470 * fixed couple of unaligned reads in scan result parsing to fix WPA
471 connection on some platforms (e.g., ARM)
472 * added driver interface for Intel ipw2100 driver
473 * added support for LEAP with WPA
474 * added support for larger scan results report (old limit was 4 kB of
475 data, i.e., about 35 or so APs) when using Linux wireless extensions
477 * fixed a bug in PMKSA cache processing: skip sending of EAPOL-Start
478 only if there is a PMKSA cache entry for the current AP
479 * fixed error handling for case where reading of scan results fails:
480 must schedule a new scan or wpa_supplicant will remain waiting
482 * changed debug output to remove shared password/key material by
483 default; all key information can be included with -K command line
484 argument to match the previous behavior
485 * added support for timestamping debug log messages (disabled by
486 default, can be enabled with -t command line argument)
487 * set pairwise/group cipher suite for non-WPA IEEE 802.1X to WEP-104
488 if keys are not configured to be used; this fixes IEEE 802.1X mode
489 with drivers that use this information to configure whether Privacy
490 bit can be in Beacon frames (e.g., ndiswrapper)
491 * avoid clearing driver keys if no keys have been configured since last
492 key clear request; this seems to improve reliability of group key
493 handshake for ndiswrapper & NDIS driver which seems to be suffering
494 of some kind of timing issue when the keys are cleared again after
496 * changed driver interface API:
497 - WPA_SUPPLICANT_DRIVER_VERSION define can be used to determine which
498 version is being used (now, this is set to 2; previously, it was
500 - pass pointer to private data structure to all calls
501 - the new API is not backwards compatible; all in-tree driver
502 interfaces has been converted to the new API
503 * added support for controlling multiple interfaces (radios) per
504 wpa_supplicant process; each interface needs to be listed on the
505 command line (-c, -i, -D arguments) with -N as a separator
506 (-cwpa1.conf -iwlan0 -Dhostap -N -cwpa2.conf -iath0 -Dmadwifi)
507 * added a workaround for EAP servers that incorrectly use same Id for
508 sequential EAP packets
509 * changed libpcap/libdnet configuration to use .config variable,
510 CONFIG_DNET_PCAP, instead of requiring Makefile modification
511 * improved downgrade attack detection in IE verification of msg 3/4:
512 verify both WPA and RSN IEs, if present, not only the selected one;
513 reject the AP if an RSN IE is found in msg 3/4, but not in Beacon or
514 Probe Response frame, and RSN is enabled in wpa_supplicant
516 * fixed WPA msg 3/4 processing to allow Key Data field contain other
517 IEs than just one WPA IE
518 * added support for FreeBSD and driver interface for the BSD net80211
519 layer (CONFIG_DRIVER_BSD=y in .config); please note that some of the
520 required kernel mods have not yet been committed
521 * made EAP workarounds configurable; enabled by default, can be
522 disabled with network block option eap_workaround=0
524 2004-07-17 - v0.2.4 (beginning of 0.2.x stable releases)
525 * resolved couple of interoperability issues with EAP-PEAPv1 and
526 Phase 2 (inner EAP) fragment reassembly
527 * driver_madwifi: fixed WEP key configuration for IEEE 802.1X when the
528 AP is using non-zero key index for the unicast key and key index zero
529 for the broadcast key
530 * driver_hostap: fixed IEEE 802.1X WEP key updates and
531 re-authentication by allowing unencrypted EAPOL frames when not using
533 * added a new driver interface, 'wext', which uses only standard,
534 driver independent functionality in Linux wireless extensions;
535 currently, this can be used only for non-WPA IEEE 802.1X mode, but
536 eventually, this is to be extended to support full WPA/WPA2 once
537 Linux wireless extensions get support for this
538 * added support for mode in which the driver is responsible for AP
539 scanning and selection; this is disabled by default and can be
540 enabled with global ap_scan=0 variable in wpa_supplicant.conf;
541 this mode can be used, e.g., with generic 'wext' driver interface to
542 use wpa_supplicant as IEEE 802.1X Supplicant with any Linux driver
543 supporting wireless extensions.
544 * driver_madwifi: fixed WPA2 configuration and scan_ssid=1 (e.g.,
545 operation with an AP that does not include SSID in the Beacon frames)
546 * added support for new EAP authentication methods:
547 EAP-TTLS/EAP-OTP, EAP-PEAPv0/OTP, EAP-PEAPv1/OTP, EAP-OTP
548 * added support for asking one-time-passwords from frontends (e.g.,
549 wpa_cli); this 'otp' command works otherwise like 'password' command,
550 but the password is used only once and the frontend will be asked for
551 a new password whenever a request from authenticator requires a
552 password; this can be used with both EAP-OTP and EAP-GTC
553 * changed wpa_cli to automatically re-establish connection so that it
554 does not need to be re-started when wpa_supplicant is terminated and
556 * improved user data (identity/password/otp) requests through
557 frontends: process pending EAPOL packets after getting new
558 information so that full authentication does not need to be
559 restarted; in addition, send pending requests again whenever a new
561 * changed control frontends to use a new directory for socket files to
562 make it easier for wpa_cli to automatically select between interfaces
563 and to provide access control for the control interface;
564 wpa_supplicant.conf: ctrl_interface is now a path
565 (/var/run/wpa_supplicant is the recommended path) and
566 ctrl_interface_group can be used to select which group gets access to
567 the control interface;
568 wpa_cli: by default, try to connect to the first interface available
569 in /var/run/wpa_supplicant; this path can be overriden with -p option
570 and an interface can be selected with -i option (i.e., in most common
571 cases, wpa_cli does not need to get any arguments)
572 * added support for LEAP
573 * added driver interface for Linux ndiswrapper
574 * added priority option for network blocks in the configuration file;
575 this allows networks to be grouped based on priority (the scan
576 results are searched for matches with network blocks in this order)
579 * sort scan results to improve AP selection
580 * fixed control interface socket removal for some error cases
581 * improved scan requesting and authentication timeout
582 * small improvements/bug fixes for EAP-MSCHAPv2, EAP-PEAP, and
584 * PEAP version can now be forced with phase1="peapver=<ver>"
585 (mostly for testing; by default, the highest version supported by
586 both the Supplicant and Authentication Server is selected
588 * added support for madwifi driver (Atheros ar521x)
589 * added a workaround for cases where AP sets Install Tx/Rx bit for
590 WPA Group Key messages when pairwise keys are used (without this,
591 the Group Key would be used for Tx and the AP would drop frames
593 * added GSM SIM/USIM interface for GSM authentication algorithm for
594 EAP-SIM; this requires pcsc-lite
595 * added support for ATMEL AT76C5XXx driver
596 * fixed IEEE 802.1X WEP key derivation in the case where Authenticator
597 does not include key data in the EAPOL-Key frame (i.e., part of
598 EAP keying material is used as data encryption key)
599 * added support for using plaintext and static WEP networks
603 * added support for new EAP authentication methods:
604 EAP-TTLS/EAP-MD5-Challenge
606 EAP-TTLS/EAP-MSCHAPv2
614 EAP-PEAP/MD5-Challenge
616 EAP-SIM (not yet complete; needs GSM/SIM authentication interface)
617 * added support for anonymous identity (to be used when identity is
618 sent in plaintext; real identity will be used within TLS protected
619 tunnel (e.g., with EAP-TTLS)
620 * added event messages from wpa_supplicant to frontends, e.g., wpa_cli
621 * added support for requesting identity and password information using
622 control interface; in other words, the password for EAP-PEAP or
623 EAP-TTLS does not need to be included in the configuration file since
624 a frontand (e.g., wpa_cli) can ask it from the user
625 * improved RSN pre-authentication to use a candidate list and process
626 all candidates from each scan; not only one per scan
627 * fixed RSN IE and WPA IE capabilities field parsing
628 * ignore Tx bit in GTK IE when Pairwise keys are used
629 * avoid making new scan requests during IEEE 802.1X negotiation
630 * use openssl/libcrypto for MD5 and SHA-1 when compiling wpa_supplicant
631 with TLS support (this replaces the included implementation with
632 library code to save about 8 kB since the library code is needed
634 * fixed WPA-PSK only mode when compiled without IEEE 802.1X support
635 (i.e., without CONFIG_IEEE8021X_EAPOL=y in .config)
638 * added support for internal IEEE 802.1X (actually, IEEE 802.1aa/D6.1)
640 - EAPOL state machines for Supplicant [IEEE 802.1aa/D6.1]
641 - EAP peer state machine [draft-ietf-eap-statemachine-02.pdf]
642 - EAP-MD5 (cannot be used with WPA-RADIUS)
643 [draft-ietf-eap-rfc2284bis-09.txt]
645 - EAP-MSCHAPv2 (currently used only with EAP-PEAP)
646 - EAP-PEAP/MSCHAPv2 [draft-josefsson-pppext-eap-tls-eap-07.txt]
647 [draft-kamath-pppext-eap-mschapv2-00.txt]
648 (PEAP version 0, 1, and parts of 2; only 0 and 1 are enabled by
649 default; tested with FreeRADIUS, Microsoft IAS, and Funk Odyssey)
650 - new configuration file options: eap, identity, password, ca_cert,
651 client_cert, privatekey, private_key_passwd
652 - Xsupplicant is not required anymore, but it can be used by
653 disabling the internal IEEE 802.1X Supplicant with -e command line
655 - this code is not included in the default build; Makefile need to
656 be edited for this (uncomment lines for selected functionality)
657 - EAP-TLS and EAP-PEAP require openssl libraries
658 * use module prefix in debug messages (WPA, EAP, EAP-TLS, ..)
659 * added support for non-WPA IEEE 802.1X mode with dynamic WEP keys
660 (i.e., complete IEEE 802.1X/EAP authentication and use IEEE 802.1X
661 EAPOL-Key frames instead of WPA key handshakes)
662 * added support for IEEE 802.11i/RSN (WPA2)
663 - improved PTK Key Handshake
664 - PMKSA caching, pre-authentication
665 * fixed wpa_supplicant to ignore possible extra data after WPA
666 EAPOL-Key packets (this fixes 'Invalid EAPOL-Key MIC when using
667 TPTK' error from message 3 of 4-Way Handshake in case the AP
668 includes extra data after the EAPOL-Key)
669 * added interface for external programs (frontends) to control
671 - CLI example (wpa_cli) with interactive mode and command line
673 - replaced SIGUSR1 status/statistics with the new control interface
674 * made some feature compile time configurable
675 - .config file for make
676 - driver interfaces (hostap, hermes, ..)
677 - EAPOL/EAP functions
680 * Initial version of wpa_supplicant