1 ChangeLog for wpa_supplicant
4 * added support for simultaneous authentication of equals (SAE) for
5 stronger password-based authentication with WPA2-Personal
6 * improved P2P negotiation and group formation robustness
7 - avoid unnecessary Dialog Token value changes during retries
8 - avoid more concurrent scanning cases during full group formation
10 - do not use potentially obsolete scan result data from driver
11 cache for peer discovery/updates
12 - avoid undesired re-starting of GO negotiation based on Probe
14 - increase GO Negotiation and Invitation timeouts to address busy
15 environments and peers that take long time to react to messages,
16 e.g., due to power saving
17 - P2P Device interface type
18 * improved P2P channel selection (use more peer information and allow
20 * added support for optional per-device PSK assignment by P2P GO
21 (wpa_cli p2p_set per_sta_psk <0/1>)
22 * added P2P_REMOVE_CLIENT for removing a client from P2P groups
23 (including persistent groups); this can be used to securely remove
24 a client from a group if per-device PSKs are used
25 * added more configuration flexibility for allowed P2P GO/client
26 channels (p2p_no_go_freq list and p2p_add_cli_chan=0/1)
27 * added nl80211 functionality
28 - VHT configuration for nl80211
29 - MFP (IEEE 802.11w) information for nl80211 command API
30 - support split wiphy dump
31 - FT (IEEE 802.11r) with driver-based SME
32 - use advertised number of supported concurrent channels
33 - QoS Mapping configuration
34 * improved TDLS negotiation robustness
35 * added more TDLS peer parameters to be configured to the driver
36 * optimized connection time by allowing recently received scan results
37 to be used instead of having to run through a new scan
38 * fixed ctrl_iface BSS command iteration with RANGE argument and no
39 exact matches; also fixed argument parsing for some cases with
41 * added 'SCAN TYPE=ONLY' ctrl_iface command to request manual scan
42 without executing roaming/network re-selection on scan results
43 * added Session-Id derivation for EAP peer methods
44 * added fully automated regression testing with mac80211_hwsim
45 * changed configuration parser to reject invalid integer values
46 * allow AP/Enrollee to be specified with BSSID instead of UUID for
48 * disable network block temporarily on repeated connection failures
49 * changed the default driver interface from wext to nl80211 if both are
51 * remove duplicate networks if WPS provisioning is run multiple times
52 * remove duplicate networks when Interworking network selection uses the
54 * added global freq_list configuration to allow scan frequencies to be
55 limited for all cases instead of just for a specific network block
56 * added support for BSS Transition Management
57 * added option to use "IFNAME=<ifname> " prefix to use the global
58 control interface connection to perform per-interface commands;
59 similarly, allow global control interface to be used as a monitor
60 interface to receive events from all interfaces
61 * fixed OKC-based PMKSA cache entry clearing
62 * fixed TKIP group key configuration with FT
63 * added support for using OCSP stapling to validate server certificate
64 (ocsp=1 as optional and ocsp=2 as mandatory)
66 * added peer restart detection for IBSS RSN
67 * added domain_suffix_match (and domain_suffix_match2 for Phase 2
68 EAP-TLS) to specify additional constraint for the server certificate
70 * added support for external SIM/USIM processing in EAP-SIM, EAP-AKA,
71 and EAP-AKA' (CTRL-REQ-SIM and CTRL-RSP-SIM commands over control
73 * added global bgscan configuration option as a default for all network
74 blocks that do not specify their own bgscan parameters
75 * added D-Bus methods for TDLS
76 * added more control to scan requests
77 - "SCAN freq=<freq list>" can be used to specify which channels are
78 scanned (comma-separated frequency ranges in MHz)
79 - "SCAN passive=1" can be used to request a passive scan (no Probe
80 Request frames are sent)
81 - "SCAN use_id" can be used to request a scan id to be returned and
82 included in event messages related to this specific scan operation
83 - "SCAN only_new=1" can be used to request the driver/cfg80211 to
84 report only BSS entries that have been updated during this scan
86 - these optional arguments to the SCAN command can be combined with
88 * modified behavior on externally triggered scans
89 - avoid concurrent operations requiring full control of the radio when
90 an externally triggered scan is detected
91 - do not use results for internal roaming decision
92 * added a new cred block parameter 'temporary' to allow credential
93 blocks to be stored separately even if wpa_supplicant configuration
94 file is used to maintain other network information
95 * added "radio work" framework to schedule exclusive radio operations
96 for off-channel functionality
97 - reduce issues with concurrent operations that try to control which
99 - allow external programs to request exclusive radio control in a way
100 that avoids conflicts with wpa_supplicant
101 * added support for using Protected Dual of Public Action frames for
102 GAS/ANQP exchanges when associated with PMF
103 * added support for WPS+NFC updates and P2P+NFC
104 - improved protocol for WPS
105 - P2P group formation/join based on NFC connection handover
106 - new IPv4 address assignment for P2P groups (ip_addr_* configuration
107 parameters on the GO) to replace DHCP
108 - option to fetch and report alternative carrier records for external
113 * removed Qt3-based wpa_gui (obsoleted by wpa_qui-qt4)
114 * removed unmaintained driver wrappers broadcom, iphone, osx, ralink,
115 hostap, madwifi (hostap and madwifi remain available for hostapd;
116 their wpa_supplicant functionality is obsoleted by wext)
117 * improved debug logging (human readable event names, interface name
118 included in more entries)
119 * changed AP mode behavior to enable WPS only for open and
120 WPA/WPA2-Personal configuration
121 * improved P2P concurrency operations
122 - better coordination of concurrent scan and P2P search operations
123 - avoid concurrent remain-on-channel operation requests by canceling
124 previous operations prior to starting a new one
125 - reject operations that would require multi-channel concurrency if
126 the driver does not support it
127 - add parameter to select whether STA or P2P connection is preferred
128 if the driver cannot support both at the same time
129 - allow driver to indicate channel changes
130 - added optional delay=<search delay in milliseconds> parameter for
131 p2p_find to avoid taking all radio resources
132 - use 500 ms p2p_find search delay by default during concurrent
134 - allow all channels in GO Negotiation if the driver supports
135 multi-channel concurrency
136 * added number of small changes to make it easier for static analyzers
137 to understand the implementation
138 * fixed number of small bugs (see git logs for more details)
139 * nl80211: number of updates to use new cfg80211/nl80211 functionality
140 - replace monitor interface with nl80211 commands for AP mode
141 - additional information for driver-based AP SME
142 - STA entry authorization in RSN IBSS
144 - fixed KDF for group 21 and zero-padding
145 - added support for fragmentation
146 - increased maximum number of hunting-and-pecking iterations
147 * avoid excessive Probe Response retries for broadcast Probe Request
148 frames (only with drivers using wpa_supplicant AP mode SME/MLME)
149 * added "GET country" ctrl_iface command
150 * do not save an invalid network block in wpa_supplicant.conf to avoid
151 problems reading the file on next start
152 * send STA connected/disconnected ctrl_iface events to both the P2P
153 group and parent interfaces
154 * added preliminary support for using TLS v1.2 (CONFIG_TLSV12=y)
155 * added "SET pno <1/0>" ctrl_iface command to start/stop preferred
156 network offload with sched_scan driver command
157 * merged in number of changes from Android repository for P2P, nl80211,
159 * changed P2P GO mode configuration to use driver capabilities to
160 automatically enable HT operations when supported
161 * added "wpa_cli status wps" command to fetch WPA2-Personal passhrase
162 for WPS use cases in AP mode
163 * EAP-AKA: keep pseudonym identity across EAP exchanges to match EAP-SIM
165 * improved reassociation behavior in cases where association is rejected
166 or when an AP disconnects us to handle common load balancing
168 - try to avoid extra scans when the needed information is available
169 * added optional "join" argument for p2p_prov_disc ctrl_iface command
170 * added group ifname to P2P-PROV-DISC-* events
171 * added P2P Device Address to AP-STA-DISCONNECTED event and use
172 p2p_dev_addr parameter name with AP-STA-CONNECTED
173 * added workarounds for WPS PBC overlap detection for some P2P use cases
174 where deployed stations work incorrectly
175 * optimize WPS connection speed by disconnecting prior to WPS scan and
176 by using single channel scans when AP channel is known
177 * PCSC and SIM/USIM improvements:
178 - accept 0x67 (Wrong length) as a response to READ RECORD to fix
179 issues with some USIM cards
180 - try to read MNC length from SIM/USIM
181 - build realm according to 3GPP TS 23.003 with identity from the SIM
182 - allow T1 protocol to be enabled
183 * added more WPS and P2P information available through D-Bus
184 * improve P2P negotiation robustness
185 - extra waits to get ACK frames through
186 - longer timeouts for cases where deployed devices have been
187 identified have issues meeting the specification requirements
188 - more retries for some P2P frames
189 - handle race conditions in GO Negotiation start by both devices
190 - ignore unexpected GO Negotiation Response frame
191 * added support for libnl 3.2 and newer
192 * added P2P persistent group info to P2P_PEER data
193 * maintain a list of P2P Clients for persistent group on GO
194 * AP: increased initial group key handshake retransmit timeout to 500 ms
195 * added optional dev_id parameter for p2p_find
196 * added P2P-FIND-STOPPED ctrl_iface event
197 * fixed issues in WPA/RSN element validation when roaming with ap_scan=1
198 and driver-based BSS selection
199 * do not expire P2P peer entries while connected with the peer in a
201 * fixed WSC element inclusion in cases where P2P is disabled
202 * AP: added a WPS workaround for mixed mode AP Settings with Windows 7
203 * EAP-SIM: fixed AT_COUNTER_TOO_SMALL use
204 * EAP-SIM/AKA: append realm to pseudonym identity
205 * EAP-SIM/AKA: store pseudonym identity in network configuration to
206 allow it to persist over multiple EAP sessions and wpa_supplicant
208 * EAP-AKA': updated to RFC 5448 (username prefixes changed); note: this
209 breaks interoperability with older versions
210 * added support for WFA Hotspot 2.0
211 - GAS/ANQP to fetch network information
212 - credential configuration and automatic network selections based on
213 credential match with ANQP information
214 * limited PMKSA cache entries to be used only with the network context
215 that was used to create them
216 * improved PMKSA cache expiration to avoid unnecessary disconnections
217 * adjusted bgscan_simple fast-scan backoff to avoid too frequent
219 * removed ctrl_iface event on P2P PD Response in join-group case
220 * added option to fetch BSS table entry based on P2P Device Address
221 ("BSS p2p_dev_addr=<P2P Device Address>")
222 * added BSS entry age to ctrl_iface BSS command output
223 * added optional MASK=0xH option for ctrl_iface BSS command to select
224 which fields are included in the response
225 * added optional RANGE=ALL|N1-N2 option for ctrl_iface BSS command to
226 fetch information about several BSSes in one call
227 * simplified licensing terms by selecting the BSD license as the only
229 * added "P2P_SET disallow_freq <freq list>" ctrl_iface command to
230 disable channels from P2P use
231 * added p2p_pref_chan configuration parameter to allow preferred P2P
232 channels to be specified
233 * added support for advertising immediate availability of a WPS
234 credential for P2P use cases
235 * optimized scan operations for P2P use cases (use single channel scan
236 for a specific SSID when possible)
237 * EAP-TTLS: fixed peer challenge generation for MSCHAPv2
238 * SME: do not use reassociation after explicit disconnection request
239 (local or a notification from an AP)
240 * added support for sending debug info to Linux tracing (-T on command
242 * added support for using Deauthentication reason code 3 as an
243 indication of P2P group termination
244 * added wps_vendor_ext_m1 configuration parameter to allow vendor
245 specific attributes to be added to WPS M1
246 * started using separate TLS library context for tunneled TLS
247 (EAP-PEAP/TLS, EAP-TTLS/TLS, EAP-FAST/TLS) to support different CA
248 certificate configuration between Phase 1 and Phase 2
249 * added optional "auto" parameter for p2p_connect to request automatic
250 GO Negotiation vs. join-a-group selection
251 * added disabled_scan_offload parameter to disable automatic scan
252 offloading (sched_scan)
253 * added optional persistent=<network id> parameter for p2p_connect to
254 allow forcing of a specific SSID/passphrase for GO Negotiation
255 * added support for OBSS scan requests and 20/40 BSS coexistence reports
256 * reject PD Request for unknown group
257 * removed scripts and notes related to Windows binary releases (which
258 have not been used starting from 1.x)
259 * added initial support for WNM operations
260 - Keep-alive based on BSS max idle period
262 - minimal BSS Transition Management processing
263 * added autoscan module to control scanning behavior while not connected
264 - autoscan_periodic and autoscan_exponential modules
265 * added new WPS NFC ctrl_iface mechanism
266 - added initial support NFC connection handover
267 - removed obsoleted WPS_OOB command (including support for deprecated
269 * added optional framework for external password storage ("ext:<name>")
270 * wpa_cli: added optional support for controlling wpa_supplicant
271 remotely over UDP (CONFIG_CTRL_IFACE=udp-remote) for testing purposes
272 * wpa_cli: extended tab completion to more commands
273 * changed SSID output to use printf-escaped strings instead of masking
274 of non-ASCII characters
275 - SSID can now be configured in the same format: ssid=P"abc\x00test"
276 * removed default ACM=1 from AC_VO and AC_VI
277 * added optional "ht40" argument for P2P ctrl_iface commands to allow
278 40 MHz channels to be requested on the 5 GHz band
279 * added optional parameters for p2p_invite command to specify channel
280 when reinvoking a persistent group as the GO
281 * improved FIPS mode builds with OpenSSL
282 - "make fips" with CONFIG_FIPS=y to build wpa_supplicant with the
283 OpenSSL FIPS object module
284 - replace low level OpenSSL AES API calls to use EVP
285 - use OpenSSL keying material exporter when possible
286 - do not export TLS keys in FIPS mode
287 - remove MD5 from CONFIG_FIPS=y builds
288 - use OpenSSL function for PKBDF2 passphrase-to-PSK
289 - use OpenSSL HMAC implementation
290 - mix RAND_bytes() output into random_get_bytes() to force OpenSSL
291 DRBG to be used in FIPS mode
292 - use OpenSSL CMAC implementation
293 * added mechanism to disable TLS Session Ticket extension
294 - a workaround for servers that do not support TLS extensions that
295 was enabled by default in recent OpenSSL versions
296 - tls_disable_session_ticket=1
297 - automatically disable TLS Session Ticket extension by default when
298 using EAP-TLS/PEAP/TTLS (i.e., only use it with EAP-FAST)
299 * changed VENDOR-TEST EAP method to use proper private enterprise number
300 (this will not interoperate with older versions)
301 * disable network block temporarily on authentication failures
302 * improved WPS AP selection during WPS PIN iteration
303 * added support for configuring GCMP cipher for IEEE 802.11ad
304 * added support for Wi-Fi Display extensions
305 - WFD_SUBELEMENT_SET ctrl_iface command to configure WFD subelements
306 - SET wifi_display <0/1> to disable/enable WFD support
307 - WFD service discovery
308 - an external program is needed to manage the audio/video streaming
310 * optimized scan result use for network selection
311 - use the internal BSS table instead of raw scan results
312 - allow unnecessary scans to be skipped if fresh information is
313 available (e.g., after GAS/ANQP round for Interworking)
314 * added support for 256-bit AES with internal TLS implementation
315 * allow peer to propose channel in P2P invitation process for a
317 * added disallow_aps parameter to allow BSSIDs/SSIDs to be disallowed
318 from network selection
319 * re-enable the networks disabled during WPS operations
320 * allow P2P functionality to be disabled per interface (p2p_disabled=1)
321 * added secondary device types into P2P_PEER output
322 * added an option to disable use of a separate P2P group interface
323 (p2p_no_group_iface=1)
324 * fixed P2P Bonjour SD to match entries with both compressed and not
325 compressed domain name format and support multiple Bonjour PTR matches
327 * use deauthentication instead of disassociation for all disconnection
328 operations; this removes the now unused disassociate() wpa_driver_ops
330 * optimized PSK generation on P2P GO by caching results to avoid
331 multiple PBKDF2 operations
332 * added okc=1 global configuration parameter to allow OKC to be enabled
333 by default for all network blocks
334 * added a workaround for WPS PBC session overlap detection to avoid
335 interop issues with deployed station implementations that do not
336 remove active PBC indication from Probe Request frames properly
337 * added basic support for 60 GHz band
338 * extend EAPOL frames processing workaround for roaming cases
339 (postpone processing of unexpected EAPOL frame until association
340 event to handle reordered events)
343 * bsd: Add support for setting HT values in IFM_MMASK.
344 * Delay STA entry removal until Deauth/Disassoc TX status in AP mode.
345 This allows the driver to use PS buffering of Deauthentication and
346 Disassociation frames when the STA is in power save sleep. Only
347 available with drivers that provide TX status events for Deauth/
348 Disassoc frames (nl80211).
349 * Drop oldest unknown BSS table entries first. This makes it less
350 likely to hit connection issues in environments with huge number
352 * Add systemd support.
353 * Add support for setting the syslog facility from the config file
355 * atheros: Add support for IEEE 802.11w configuration.
356 * AP mode: Allow enable HT20 if driver supports it, by setting the
357 config parameter ieee80211n.
358 * Allow AP mode to disconnect STAs based on low ACK condition (when
359 the data connection is not working properly, e.g., due to the STA
360 going outside the range of the AP). Disabled by default, enable by
361 config option disassoc_low_ack.
363 - Support GTK rekey offload.
364 - Support PMKSA candidate events. This adds support for RSN
365 pre-authentication with nl80211 interface and drivers that handle
368 - Add a DBus signal for EAP SM requests, emitted on the Interface
370 - Export max scan ssids supported by the driver as MaxScanSSID.
371 - Add signal Certification for information about server certification.
372 - Add BSSExpireAge and BSSExpireCount interface properties and
373 support set/get, which allows for setting BSS cache expiration age
374 and expiration scan count.
375 - Add ConfigFile to AddInterface properties.
376 - Add Interface.Country property and support to get/set the value.
377 - Add DBus property CurrentAuthMode.
378 - P2P DBus API added.
379 - Emit property changed events (for property BSSs) when adding/
381 - Treat '' in SSIDs of Interface.Scan as a request for broadcast
382 scan, instead of ignoring it.
383 - Add DBus getter/setter for FastReauth.
384 - Raise PropertiesChanged on org.freedesktop.DBus.Properties.
386 - Send AP-STA-DISCONNECTED event when an AP disconnects a station
388 - Make second argument to set command optional. This can be used to
389 indicate a zero length value.
390 - Add signal_poll command.
391 - Add bss_expire_age and bss_expire_count commands to set/get BSS
392 cache expiration age and expiration scan count.
393 - Add ability to set scan interval (the time in seconds wpa_s waits
394 before requesting a new scan after failing to find a suitable
395 network in scan results) using scan_interval command.
396 - Add event CTRL-EVENT-ASSOC-REJECT for association rejected.
397 - Add command get version, that returns wpa_supplicant version string.
398 - Add command sta_autoconnect for disabling automatic reconnection
399 on receiving disconnection event.
400 - Setting bssid parameter to an empty string "" or any can now be
401 used to clear the bssid_set flag in a network block, i.e., to remove
403 - Add tdls_testing command to add a special testing feature for
404 changing TDLS behavior. Build param CONFIG_TDLS_TESTING must be
406 - For interworking, add wpa_cli commands interworking_select,
407 interworking_connect, anqp_get, fetch_anqp, and stop_fetch_anqp.
408 - Many P2P commands were added. See README-P2P.
409 - Many WPS/WPS ER commands - see WPS/WPS ER sections for details.
410 - Allow set command to change global config parameters.
411 - Add log_level command, which can be used to display the current
412 debugging level and to change the log level during run time.
413 - Add note command, which can be used to insert notes to the debug
415 - Add internal line edit implementation. CONFIG_WPA_CLI_EDIT=y
416 can now be used to build wpa_cli with internal implementation of
417 line editing and history support. This can be used as a replacement
418 for CONFIG_READLINE=y.
419 * AP mode: Add max_num_sta config option, which can be used to limit
420 the number of stations allowed to connect to the AP.
421 * Add WPA_IGNORE_CONFIG_ERRORS build option to continue in case of bad
423 * wext: Increase scan timeout from 5 to 10 seconds.
424 * Add blacklist command, allowing an external program to
425 manage the BSS blacklist and display its current contents.
427 - Add wpa_cli wps_pin get command for generating random PINs. This can
428 be used in a UI to generate a PIN without starting WPS (or P2P)
430 - Set RF bands based on driver capabilities, instead of hardcoding
432 - Add mechanism for indicating non-standard WPS errors.
433 - Add CONFIG_WPS_REG_DISABLE_OPEN=y option to disable open networks
435 - Add wps_ap_pin cli command for wpa_supplicant AP mode.
436 - Add wps_check_pin cli command for processing PIN from user input.
437 UIs can use this command to process a PIN entered by a user and to
438 validate the checksum digit (if present).
439 - Cancel WPS operation on PBC session overlap detection.
440 - New wps_cancel command in wpa_cli will cancel a pending WPS
442 - wpa_cli action: Add WPS_EVENT_SUCCESS and WPS_EVENT_FAIL handlers.
443 - Trigger WPS config update on Manufacturer, Model Name, Model
444 Number, and Serial Number changes.
445 - Fragment size is now configurable for EAP-WSC peer. Use
446 wpa_cli set wps_fragment_size <val>.
447 - Disable AP PIN after 10 consecutive failures. Slow down attacks on
449 - Allow AP to start in Enrollee mode without AP PIN for probing, to
450 be compatible with Windows 7.
451 - Add Config Error into WPS-FAIL events to provide more info to the
452 user on how to resolve the issue.
453 - Label and Display config methods are not allowed to be enabled
454 at the same time, since it is unclear which PIN to use if both
455 methods are advertised.
456 - When controlling multiple interfaces:
457 - apply WPS commands to all interfaces configured to use WPS
458 - apply WPS config changes to all interfaces that use WPS
459 - when an attack is detected on any interface, disable AP PIN on
462 - Add special AP Setup Locked mode to allow read only ER.
463 ap_setup_locked=2 can now be used to enable a special mode where
464 WPS ER can learn the current AP settings, but cannot change them.
465 - Show SetSelectedRegistrar events as ctrl_iface events
466 - Add wps_er_set_config to enroll a network based on a local
467 network configuration block instead of having to (re-)learn the
468 current AP settings with wps_er_learn.
469 - Allow AP filtering based on IP address, add ctrl_iface event for
470 learned AP settings, add wps_er_config command to configure an AP.
471 * WPS 2.0: Add support for WPS 2.0 (CONFIG_WPS2)
472 - Add build option CONFIG_WPS_EXTENSIBILITY_TESTING to enable tool
473 for testing protocol extensibility.
474 - Add build option CONFIG_WPS_STRICT to allow disabling of WPS
476 - Add support for AuthorizedMACs attribute.
478 - Propogate TDLS related nl80211 capability flags from kernel and
479 add them as driver capability flags. If the driver doesn't support
480 capabilities, assume TDLS is supported internally. When TDLS is
481 explicitly not supported, disable all user facing TDLS operations.
482 - Allow TDLS to be disabled at runtime (mostly for testing).
483 Use set tdls_disabled.
484 - Honor AP TDLS settings that prohibit/allow TDLS.
485 - Add a special testing feature for changing TDLS behavior. Use
486 CONFIG_TDLS_TESTING build param to enable. Configure at runtime
487 with tdls_testing cli command.
488 - Add support for TDLS 802.11z.
489 * wlantest: Add a tool wlantest for IEEE802.11 protocol testing.
490 wlantest can be used to capture frames from a monitor interface
491 for realtime capturing or from pcap files for offline analysis.
492 * Interworking: Support added for 802.11u. Enable in .config with
493 CONFIG_INTERWORKING. See wpa_supplicant.conf for config parameters
494 for interworking. wpa_cli commands added to support this are
495 interworking_select, interworking_connect, anqp_get, fetch_anqp,
497 * Android: Add build and runtime support for Android wpa_supplicant.
498 * bgscan learn: Add new bgscan that learns BSS information based on
499 previous scans, and uses that information to dynamically generate
500 the list of channels for background scans.
501 * Add a new debug message level for excessive information. Use
503 * TLS: Add support for tls_disable_time_checks=1 in client mode.
505 - Add support for TLS v1.1 (RFC 4346). Enable with build parameter
507 - Add domainComponent parser for X.509 names.
508 * Linux: Add RFKill support by adding an interface state "disabled".
509 * Reorder some IEs to get closer to IEEE 802.11 standard. Move
510 WMM into end of Beacon, Probe Resp and (Re)Assoc Resp frames.
511 Move HT IEs to be later in (Re)Assoc Resp.
512 * Solaris: Add support for wired 802.1X client.
513 * Wi-Fi Direct support. See README-P2P for more information.
517 * nl80211: fixed number of issues with roaming
518 * avoid unnecessary roaming if multiple APs with similar signal
519 strength are present in scan results
520 * add TLS client events and server probing to ease design of
521 automatic detection of EAP parameters
522 * add option for server certificate matching (SHA256 hash of the
523 certificate) instead of trusted CA certificate configuration
524 * bsd: Cleaned up driver wrapper and added various low-level
525 configuration options
526 * wpa_gui-qt4: do not show too frequent WPS AP available events as
528 * TNC: fixed issues with fragmentation
529 * EAP-TNC: add Flags field into fragment acknowledgement (needed to
530 interoperate with other implementations; may potentially breaks
531 compatibility with older wpa_supplicant/hostapd versions)
532 * wpa_cli: added option for using a separate process to receive event
533 messages to reduce latency in showing these
534 (CFLAGS += -DCONFIG_WPA_CLI_FORK=y in .config to enable this)
535 * maximum BSS table size can now be configured (bss_max_count)
536 * BSSes to be included in the BSS table can be filtered based on
537 configured SSIDs to save memory (filter_ssids)
538 * fix number of issues with IEEE 802.11r/FT; this version is not
539 backwards compatible with old versions
540 * nl80211: add support for IEEE 802.11r/FT protocol (both over-the-air
542 * add freq_list network configuration parameter to allow the AP
543 selection to filter out entries based on the operating channel
544 * add signal strength change events for bgscan; this allows more
545 dynamic changes to background scanning interval based on changes in
546 the signal strength with the current AP; this improves roaming within
547 ESS quite a bit, e.g., with bgscan="simple:30:-45:300" in the network
548 configuration block to request background scans less frequently when
549 signal strength remains good and to automatically trigger background
550 scans whenever signal strength drops noticeably
551 (this is currently only available with nl80211)
552 * add BSSID and reason code (if available) to disconnect event messages
553 * wpa_gui-qt4: more complete support for translating the GUI with
554 linguist and add German translation
555 * fix DH padding with internal crypto code (mainly, for WPS)
556 * do not trigger initial scan automatically anymore if there are no
560 * cleaned up driver wrapper API (struct wpa_driver_ops); the new API
561 is not fully backwards compatible, so out-of-tree driver wrappers
562 will need modifications
563 * cleaned up various module interfaces
564 * merge hostapd and wpa_supplicant developers' documentation into a
566 * nl80211: use explicit deauthentication to clear cfg80211 state to
567 avoid issues when roaming between APs
568 * dbus: major design changes in the new D-Bus API
569 (fi.w1.wpa_supplicant1)
570 * nl80211: added support for IBSS networks
571 * added internal debugging mechanism with backtrace support and memory
572 allocation/freeing validation, etc. tests (CONFIG_WPA_TRACE=y)
573 * added WPS ER unsubscription command to more cleanly unregister from
574 receiving UPnP events when ER is terminated
575 * cleaned up AP mode operations to avoid need for virtual driver_ops
577 * added BSS table to maintain more complete scan result information
578 over multiple scans (that may include only partial results)
579 * wpa_gui-qt4: update Peers dialog information more dynamically while
580 the dialog is kept open
581 * fixed PKCS#12 use with OpenSSL 1.0.0
582 * driver_wext: Added cfg80211-specific optimization to avoid some
583 unnecessary scans and to speed up association
586 * increased wpa_cli ping interval to 5 seconds and made this
587 configurable with a new command line options (-G<seconds>)
588 * fixed scan buffer processing with WEXT to handle up to 65535
589 byte result buffer (previously, limited to 32768 bytes)
590 * allow multiple driver wrappers to be specified on command line
591 (e.g., -Dnl80211,wext); the first one that is able to initialize the
592 interface will be used
593 * added support for multiple SSIDs per scan request to optimize
594 scan_ssid=1 operations in ap_scan=1 mode (i.e., search for hidden
595 SSIDs); this requires driver support and can currently be used only
597 * added support for WPS USBA out-of-band mechanism with USB Flash
598 Drives (UFD) (CONFIG_WPS_UFD=y)
599 * driver_ndis: add PAE group address to the multicast address list to
600 fix wired IEEE 802.1X authentication
601 * fixed IEEE 802.11r key derivation function to match with the standard
602 (note: this breaks interoperability with previous version) [Bug 303]
603 * added better support for drivers that allow separate authentication
604 and association commands (e.g., mac80211-based Linux drivers with
605 nl80211; SME in wpa_supplicant); this allows over-the-air FT protocol
606 to be used (IEEE 802.11r)
607 * fixed SHA-256 based key derivation function to match with the
608 standard when using CCMP (for IEEE 802.11r and IEEE 802.11w)
609 (note: this breaks interoperability with previous version) [Bug 307]
610 * use shared driver wrapper files with hostapd
611 * added AP mode functionality (CONFIG_AP=y) with mode=2 in the network
612 block; this can be used for open and WPA2-Personal networks
613 (optionally, with WPS); this links in parts of hostapd functionality
615 * wpa_gui-qt4: added new Peers dialog to show information about peers
616 (other devices, including APs and stations, etc. in the neighborhood)
617 * added support for WPS External Registrar functionality (configure APs
618 and enroll new devices); can be used with wpa_gui-qt4 Peers dialog
619 and wpa_cli commands wps_er_start, wps_er_stop, wps_er_pin,
620 wps_er_pbc, wps_er_learn
621 (this can also be used with a new 'none' driver wrapper if no
622 wireless device or IEEE 802.1X on wired is needed)
623 * driver_nl80211: multiple updates to provide support for new Linux
624 nl80211/mac80211 functionality
625 * updated management frame protection to use IEEE Std 802.11w-2009
626 * fixed number of small WPS issues and added workarounds to
627 interoperate with common deployed broken implementations
628 * added support for NFC out-of-band mechanism with WPS
629 * driver_ndis: fixed wired IEEE 802.1X authentication with PAE group
631 * added preliminary support for IEEE 802.11r RIC processing
632 * added support for specifying subset of enabled frequencies to scan
633 (scan_freq option in the network configuration block); this can speed
634 up scanning process considerably if it is known that only a small
635 subset of channels is actually used in the network (this is currently
636 supported only with -Dnl80211)
637 * added a workaround for race condition between receiving the
638 association event and the following EAPOL-Key
639 * added background scan and roaming infrastructure to allow
640 network-specific optimizations to be used to improve roaming within
642 * added new DBus interface (fi.w1.wpa_supplicant1)
645 * added support for Wi-Fi Protected Setup (WPS)
646 (wpa_supplicant can now be configured to act as a WPS Enrollee to
647 enroll credentials for a network using PIN and PBC methods; in
648 addition, wpa_supplicant can act as a wireless WPS Registrar to
649 configure an AP); WPS support can be enabled by adding CONFIG_WPS=y
650 into .config and setting the runtime configuration variables in
651 wpa_supplicant.conf (see WPS section in the example configuration
652 file); new wpa_cli commands wps_pin, wps_pbc, and wps_reg are used to
653 manage WPS negotiation; see README-WPS for more details
654 * added support for EAP-AKA' (draft-arkko-eap-aka-kdf)
655 * added support for using driver_test over UDP socket
656 * fixed PEAPv0 Cryptobinding interoperability issue with Windows Server
657 2008 NPS; optional cryptobinding is now enabled (again) by default
658 * fixed PSK editing in wpa_gui
659 * changed EAP-GPSK to use the IANA assigned EAP method type 51
660 * added a Windows installer that includes WinPcap and all the needed
661 DLLs; in addition, it set up the registry automatically so that user
662 will only need start wpa_gui to get prompted to start the wpasvc
663 servide and add a new interface if needed through wpa_gui dialog
664 * updated management frame protection to use IEEE 802.11w/D7.0
667 * added Milenage SIM/USIM emulator for EAP-SIM/EAP-AKA
668 (can be used to simulate test SIM/USIM card with a known private key;
669 enable with CONFIG_SIM_SIMULATOR=y/CONFIG_USIM_SIMULATOR=y in .config
670 and password="Ki:OPc"/password="Ki:OPc:SQN" in network configuration)
671 * added a new network configuration option, wpa_ptk_rekey, that can be
672 used to enforce frequent PTK rekeying, e.g., to mitigate some attacks
673 against TKIP deficiencies
674 * added an optional mitigation mechanism for certain attacks against
675 TKIP by delaying Michael MIC error reports by a random amount of time
676 between 0 and 60 seconds; this can be enabled with a build option
677 CONFIG_DELAYED_MIC_ERROR_REPORT=y in .config
678 * fixed EAP-AKA to use RES Length field in AT_RES as length in bits,
680 * updated OpenSSL code for EAP-FAST to use an updated version of the
681 session ticket overriding API that was included into the upstream
682 OpenSSL 0.9.9 tree on 2008-11-15 (no additional OpenSSL patch is
683 needed with that version anymore)
684 * updated userspace MLME instructions to match with the current Linux
685 mac80211 implementation; please also note that this can only be used
686 with driver_nl80211.c (the old code from driver_wext.c was removed)
687 * added support (Linux only) for RoboSwitch chipsets (often found in
688 consumer grade routers); driver interface 'roboswitch'
689 * fixed canceling of PMKSA caching when using drivers that generate
690 RSN IE and refuse to drop PMKIDs that wpa_supplicant does not know
694 * added support for SHA-256 as X.509 certificate digest when using the
695 internal X.509/TLSv1 implementation
696 * updated management frame protection to use IEEE 802.11w/D6.0
697 * added support for using SHA256-based stronger key derivation for WPA2
699 * fixed FT (IEEE 802.11r) authentication after a failed association to
701 * added support for configuring Phase 2 (inner/tunneled) authentication
702 method with wpa_gui-qt4
705 * added support for EAP Sequences in EAP-FAST Phase 2
706 * added support for using TNC with EAP-FAST
707 * added driver_ps3 for the PS3 Linux wireless driver
708 * added support for optional cryptobinding with PEAPv0
709 * fixed the OpenSSL patches (0.9.8g and 0.9.9) for EAP-FAST to
710 allow fallback to full handshake if server rejects PAC-Opaque
711 * added fragmentation support for EAP-TNC
712 * added support for parsing PKCS #8 formatted private keys into the
713 internal TLS implementation (both PKCS #1 RSA key and PKCS #8
714 encapsulated RSA key can now be used)
715 * added option of using faster, but larger, routines in the internal
716 LibTomMath (for internal TLS implementation) to speed up DH and RSA
717 calculations (CONFIG_INTERNAL_LIBTOMMATH_FAST=y)
718 * fixed race condition between disassociation event and group key
719 handshake to avoid getting stuck in incorrect state [Bug 261]
720 * fixed opportunistic key caching (proactive_key_caching)
723 * removed 'nai' and 'eappsk' network configuration variables that were
724 previously used for configuring user identity and key for EAP-PSK,
725 EAP-PAX, EAP-SAKE, and EAP-GPSK. 'identity' field is now used as the
726 replacement for 'nai' (if old configuration used a separate
727 'identity' value, that would now be configured as
728 'anonymous_identity'). 'password' field is now used as the
729 replacement for 'eappsk' (it can also be set using hexstring to
730 present random binary data)
731 * removed '-w' command line parameter (wait for interface to be added,
732 if needed); cleaner way of handling this functionality is to use an
733 external mechanism (e.g., hotplug scripts) that start wpa_supplicant
734 when an interface is added
735 * updated FT support to use the latest draft, IEEE 802.11r/D9.0
736 * added ctrl_iface monitor event (CTRL-EVENT-SCAN-RESULTS) for
737 indicating when new scan results become available
738 * added new ctrl_iface command, BSS, to allow scan results to be
739 fetched without hitting the message size limits (this command
740 can be used to iterate through the scan results one BSS at the time)
741 * fixed EAP-SIM not to include AT_NONCE_MT and AT_SELECTED_VERSION
742 attributes in EAP-SIM Start/Response when using fast reauthentication
743 * fixed EAPOL not to end up in infinite loop when processing dynamic
744 WEP keys with IEEE 802.1X
745 * fixed problems in getting NDIS events from WMI on Windows 2000
748 * added support for Makefile builds to include debug-log-to-a-file
749 functionality (CONFIG_DEBUG_FILE=y and -f<path> on command line)
750 * fixed EAP-SIM and EAP-AKA message parser to validate attribute
751 lengths properly to avoid potential crash caused by invalid messages
752 * added data structure for storing allocated buffers (struct wpabuf);
753 this does not affect wpa_supplicant usage, but many of the APIs
754 changed and various interfaces (e.g., EAP) is not compatible with old
756 * added support for protecting EAP-AKA/Identity messages with
757 AT_CHECKCODE (optional feature in RFC 4187)
758 * added support for protected result indication with AT_RESULT_IND for
759 EAP-SIM and EAP-AKA (phase1="result_ind=1")
760 * added driver_wext workaround for race condition between scanning and
761 association with drivers that take very long time to scan all
762 channels (e.g., madwifi with dual-band cards); wpa_supplicant is now
763 using a longer hardcoded timeout for the scan if the driver supports
764 notifications for scan completion (SIOCGIWSCAN event); this helps,
765 e.g., in cases where wpa_supplicant and madwifi driver ended up in
766 loop where the driver did not even try to associate
767 * stop EAPOL timer tick when no timers are in use in order to reduce
768 power consumption (no need to wake up the process once per second)
770 * added support for privilege separation (run only minimal part of
771 wpa_supplicant functionality as root and rest as unprivileged,
772 non-root process); see 'Privilege separation' in README for details;
773 this is disabled by default and can be enabled with CONFIG_PRIVSEP=y
775 * changed scan results data structure to include all information
776 elements to make it easier to support new IEs; old get_scan_result()
777 driver_ops is still supported for backwards compatibility (results
778 are converted internally to the new format), but all drivers should
779 start using the new get_scan_results2() to make them more likely to
780 work with new features
781 * Qt4 version of wpa_gui (wpa_gui-qt4 subdirectory) is now native Qt4
782 application, i.e., it does not require Qt3Support anymore; Windows
783 binary of wpa_gui.exe is now from this directory and only requires
784 QtCore4.dll and QtGui4.dll libraries
785 * updated Windows binary build to use Qt 4.3.3 and made Qt DLLs
786 available as a separate package to make wpa_gui installation easier:
787 http://w1.fi/wpa_supplicant/qt4/wpa_gui-qt433-windows-dll.zip
788 * added support for EAP-IKEv2 (draft-tschofenig-eap-ikev2-15.txt);
789 only shared key/password authentication is supported in this version
792 * added support for configuring password as NtPasswordHash
793 (16-byte MD4 hash of password) in hash:<32 hex digits> format
794 * added support for fallback from abbreviated TLS handshake to
795 full handshake when using EAP-FAST (e.g., due to an expired
797 * updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
798 draft (draft-ietf-emu-eap-gpsk-07.txt)
799 * added support for drivers that take care of RSN 4-way handshake
800 internally (WPA_DRIVER_FLAGS_4WAY_HANDSHAKE in get_capa flags and
801 WPA_ALG_PMK in set_key)
802 * added an experimental port for Mac OS X (CONFIG_DRIVER_OSX=y in
803 .config); this version supports only ap_scan=2 mode and allow the
804 driver to take care of the 4-way handshake
805 * fixed a buffer overflow in parsing TSF from scan results when using
806 driver_wext.c with a driver that includes the TSF (e.g., iwl4965)
808 * updated FT support to use the latest draft, IEEE 802.11r/D8.0
809 * fixed an integer overflow issue in the ASN.1 parser used by the
810 (experimental) internal TLS implementation to avoid a potential
812 * fixed a race condition with -W option (wait for a control interface
813 monitor before starting) that could have caused the first messages to
815 * added support for processing TNCC-TNCS-Messages to report
816 recommendation (allow/none/isolate) when using TNC [Bug 243]
819 * added network configuration parameter 'frequency' for setting
820 initial channel for IBSS (adhoc) networks
821 * added experimental IEEE 802.11r/D6.0 support
822 * updated EAP-SAKE to RFC 4763 and the IANA-allocated EAP type 48
823 * updated EAP-PSK to use the IANA-allocated EAP type 47
824 * fixed EAP-PAX key derivation
825 * fixed EAP-PSK bit ordering of the Flags field
826 * fixed EAP-PEAP/TTLS/FAST to use the correct EAP identifier in
827 tunnelled identity request (previously, the identifier from the outer
828 method was used, not the tunnelled identifier which could be
830 * added support for fragmentation of outer TLS packets during Phase 2
831 of EAP-PEAP/TTLS/FAST
832 * fixed EAP-TTLS AVP parser processing for too short AVP lengths
833 * added support for EAP-FAST authentication with inner methods that
834 generate MSK (e.g., EAP-MSCHAPv2 that was previously only supported
835 for PAC provisioning)
836 * added support for authenticated EAP-FAST provisioning
837 * added support for configuring maximum number of EAP-FAST PACs to
838 store in a PAC list (fast_max_pac_list_len=<max> in phase1 string)
839 * added support for storing EAP-FAST PACs in binary format
840 (fast_pac_format=binary in phase1 string)
841 * fixed dbus ctrl_iface to validate message interface before
842 dispatching to avoid a possible segfault [Bug 190]
843 * fixed PeerKey key derivation to use the correct PRF label
844 * updated Windows binary build to link against OpenSSL 0.9.8d and
845 added support for EAP-FAST
846 * updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
847 draft (draft-ietf-emu-eap-gpsk-04.txt)
848 * fixed EAP-AKA Notification processing to allow Notification to be
849 processed after AKA Challenge response has been sent
850 * updated to use IEEE 802.11w/D2.0 for management frame protection
852 * fixed EAP-TTLS implementation not to crash on use of freed memory
853 if TLS library initialization fails
854 * added support for EAP-TNC (Trusted Network Connect)
855 (this version implements the EAP-TNC method and EAP-TTLS changes
856 needed to run two methods in sequence (IF-T) and the IF-IMC and
857 IF-TNCCS interfaces from TNCC)
860 * added experimental, integrated TLSv1 client implementation with the
861 needed X.509/ASN.1/RSA/bignum processing (this can be enabled by
862 setting CONFIG_TLS=internal and CONFIG_INTERNAL_LIBTOMMATH=y in
863 .config); this can be useful, e.g., if the target system does not
864 have a suitable TLS library and a minimal code size is required
865 (total size of this internal TLS/crypto code is bit under 50 kB on
866 x86 and the crypto code is shared by rest of the supplicant so some
867 of it was already required; TLSv1/X.509/ASN.1/RSA added about 25 kB)
868 * removed STAKey handshake since PeerKey handshake has replaced it in
869 IEEE 802.11ma and there are no known deployments of STAKey
870 * updated EAP Generalized Pre-Shared Key (EAP-GPSK) to use the latest
871 draft (draft-ietf-emu-eap-gpsk-01.txt)
872 * added preliminary implementation of IEEE 802.11w/D1.0 (management
874 (Note: this requires driver support to work properly.)
875 (Note2: IEEE 802.11w is an unapproved draft and subject to change.)
876 * fixed Windows named pipes ctrl_iface to not stop listening for
877 commands if client program opens a named pipe and closes it
878 immediately without sending a command
879 * fixed USIM PIN status determination for the case that PIN is not
880 needed (this allows EAP-AKA to be used with USIM cards that do not
882 * added support for reading 3G USIM AID from EF_DIR to allow EAP-AKA to
883 be used with cards that do not support file selection based on
885 * added support for matching the subjectAltName of the authentication
886 server certificate against multiple name components (e.g.,
887 altsubject_match="DNS:server.example.com;DNS:server2.example.com")
888 * fixed EAP-SIM/AKA key derivation for re-authentication case (only
889 affects IEEE 802.1X with dynamic WEP keys)
890 * changed ctrl_iface network configuration 'get' operations to not
891 return password/key material; if these fields are requested, "*"
892 will be returned if the password/key is set, but the value of the
893 parameter is not exposed
896 * added support for building Windows version with UNICODE defined
897 (wide-char functions)
898 * driver_ndis: fixed static WEP configuration to avoid race condition
899 issues with some NDIS drivers between association and setting WEP
901 * driver_ndis: added validation for IELength value in scan results to
902 avoid crashes when using buggy NDIS drivers [Bug 165]
903 * fixed Release|Win32 target in the Visual Studio project files
904 (previously, only Debug|Win32 target was set properly)
905 * changed control interface API call wpa_ctrl_pending() to allow it to
906 return -1 on error (e.g., connection lost); control interface clients
907 will need to make sure that they verify that the value is indeed >0
908 when determining whether there are pending messages
909 * added an alternative control interface backend for Windows targets:
910 Named Pipe (CONFIG_CTRL_IFACE=named_pipe); this is now the default
911 control interface mechanism for Windows builds (previously, UDP to
913 * changed ctrl_interface configuration for UNIX domain sockets:
914 - deprecated ctrl_interface_group variable (it may be removed in
916 - allow both directory and group be configured with ctrl_interface
917 in following format: DIR=/var/run/wpa_supplicant GROUP=wheel
918 - ctrl_interface=/var/run/wpa_supplicant is still supported for the
919 case when group is not changed
920 * added support for controlling more than one interface per process in
922 * added a workaround for a case where the AP is using unknown address
923 (e.g., MAC address of the wired interface) as the source address for
924 EAPOL-Key frames; previously, that source address was used as the
925 destination for EAPOL-Key frames and in key derivation; now, BSSID is
926 used even if the source address does not match with it
927 (this resolves an interoperability issue with Thomson SpeedTouch 580)
928 * added a workaround for UDP-based control interface (which was used in
929 Windows builds before this release) to prevent packets with forged
930 addresses from being accepted as local control requests
931 * removed ndis_events.cpp and possibility of using external
932 ndis_events.exe; C version (ndis_events.c) is fully functional and
933 there is no desire to maintain two separate versions of this
935 * ndis_events: Changed NDIS event notification design to use WMI to
936 learn the adapter description through Win32_PnPEntity class; this
937 should fix some cases where the adapter name was not recognized
938 correctly (e.g., with some USB WLAN adapters, e.g., Ralink RT2500
940 * fixed selection of the first network in ap_scan=2 mode; previously,
941 wpa_supplicant could get stuck in SCANNING state when only the first
942 network for enabled (e.g., after 'wpa_cli select_network 0')
943 * winsvc: added support for configuring ctrl_interface parameters in
944 registry (ctrl_interface string value in
945 HKLM\SOFTWARE\wpa_supplicant\interfaces\0000 key); this new value is
946 required to enable control interface (previously, this was hardcoded
948 * allow wpa_gui subdirectory to be built with both Qt3 and Qt4
949 * converted wpa_gui-qt4 subdirectory to use Qt4 specific project format
952 * fixed build with CONFIG_STAKEY=y [Bug 143]
953 * added support for doing MLME (IEEE 802.11 management frame
954 processing) in wpa_supplicant when using Devicescape IEEE 802.11
955 stack (wireless-dev.git tree)
956 * added a new network block configuration option, fragment_size, to
957 configure the maximum EAP fragment size
958 * driver_ndis: Disable WZC automatically for the selected interface to
959 avoid conflicts with two programs trying to control the radio; WZC
960 will be re-enabled (if it was enabled originally) when wpa_supplicant
962 * added an experimental TLSv1 client implementation
963 (CONFIG_TLS=internal) that can be used instead of an external TLS
964 library, e.g., to reduce total size requirement on systems that do
965 not include any TLS library by default (this is not yet complete;
966 basic functionality is there, but certificate validation is not yet
968 * added PeerKey handshake implementation for IEEE 802.11e
969 direct link setup (DLS) to replace STAKey handshake
970 * fixed WPA PSK update through ctrl_iface for the case where the old
971 PSK was derived from an ASCII passphrase and the new PSK is set as
972 a raw PSK (hex string)
973 * added new configuration option for identifying which network block
974 was used (id_str in wpa_supplicant.conf; included on
975 WPA_EVENT_CONNECT monitor event and as WPA_ID_STR environmental
976 variable in wpa_cli action scripts; in addition WPA_ID variable is
977 set to the current unique identifier that wpa_supplicant assigned
978 automatically for the network and that can be used with
979 GET_NETWORK/SET_NETWORK ctrl_iface commands)
980 * wpa_cli action script is now called only when the connect/disconnect
981 status changes or when associating with a different network
982 * fixed configuration parser not to remove CCMP from group cipher list
983 if WPA-None (adhoc) is used (pairwise=NONE in that case)
984 * fixed integrated NDIS events processing not to hang the process due
985 to a missed change in eloop_win.c API in v0.5.3 [Bug 155]
986 * added support for EAP Generalized Pre-Shared Key (EAP-GPSK,
987 draft-clancy-emu-eap-shared-secret-00.txt)
988 * added Microsoft Visual Studio 2005 solution and project files for
989 build wpa_supplicant for Windows (see vs2005 subdirectory)
990 * eloop_win: fixed unregistration of Windows events
991 * l2_packet_winpcap: fixed a deadlock in deinitializing l2_packet
992 at the end of RSN pre-authentication and added unregistration of
993 a Windows event to avoid getting eloop_win stuck with an invalid
995 * driver_ndis: added support for selecting AP based on BSSID
996 * added new environmental variable for wpa_cli action scripts:
997 WPA_CTRL_DIR is the current control interface directory
998 * driver_ndis: added support for using NDISUIO instead of WinPcap for
999 OID set/query operations (CONFIG_USE_NDISUIO=y in .config); with new
1000 l2_packet_ndis (CONFIG_L2_PACKET=ndis), this can be used to build
1001 wpa_supplicant without requiring WinPcap; note that using NDISUIO
1002 requires that WZC is disabled (net stop wzcsvc) since NDISUIO allows
1003 only one application to open the device
1004 * changed NDIS driver naming to only include device GUID, e.g.,
1005 {7EE3EFE5-C165-472F-986D-F6FBEDFE8C8D}, instead of including WinPcap
1006 specific \Device\NPF_ prefix before the GUID; the prefix is still
1007 allowed for backwards compatibility, but it is not required anymore
1008 when specifying the interface
1009 * driver_ndis: re-initialize driver interface is the adapter is removed
1010 and re-inserted [Bug 159]
1011 * driver_madwifi: fixed TKIP and CCMP sequence number configuration on
1012 big endian hosts [Bug 146]
1015 * fixed EAP-GTC response to include correct user identity when run as
1016 phase 2 method of EAP-FAST (i.e., EAP-FAST did not work in v0.5.2)
1017 * driver_ndis: Fixed encryption mode configuration for unencrypted
1018 networks (some NDIS drivers ignored this, but others, e.g., Broadcom,
1019 refused to associate with open networks) [Bug 106]
1020 * driver_ndis: use BSSID OID polling to detect when IBSS network is
1021 formed even when ndis_events code is included since some NDIS drivers
1022 do not generate media connect events in IBSS mode
1023 * config_winreg: allow global ctrl_interface parameter to be configured
1025 * config_winreg: added support for saving configuration data into
1027 * added support for controlling network device operational state
1028 (dormant/up) for Linux 2.6.17 to improve DHCP processing (see
1029 http://www.flamewarmaster.de/software/dhcpclient/ for a DHCP client
1030 that can use this information)
1031 * driver_wext: added support for WE-21 change to SSID configuration
1032 * driver_wext: fixed privacy configuration for static WEP keys mode
1034 * added an optional driver_ops callback for MLME-SETPROTECTION.request
1036 * added support for EAP-SAKE (no EAP method number allocated yet, so
1037 this is using the same experimental type 255 as EAP-PSK)
1038 * added support for dynamically loading EAP methods (.so files) instead
1039 of requiring them to be statically linked in; this is disabled by
1040 default (see CONFIG_DYNAMIC_EAP_METHODS in defconfig for information
1044 * do not try to use USIM APDUs when initializing PC/SC for SIM card
1045 access for a network that has not enabled EAP-AKA
1046 * fixed EAP phase 2 Nak for EAP-{PEAP,TTLS,FAST} (this was broken in
1047 v0.5.1 due to the new support for expanded EAP types)
1048 * added support for generating EAP Expanded Nak
1049 * try to fetch scan results once before requesting new scan when
1050 starting up in ap_scan=1 mode (this can speed up initial association
1051 a lot with, e.g., madwifi-ng driver)
1052 * added support for receiving EAPOL frames from a Linux bridge
1053 interface (-bbr0 on command line)
1054 * fixed EAPOL re-authentication for sessions that used PMKSA caching
1055 * changed EAP method registration to use a dynamic list of methods
1056 instead of a static list generated at build time
1057 * fixed PMKSA cache deinitialization not to use freed memory when
1058 removing PMKSA entries
1059 * fixed a memory leak in EAP-TTLS re-authentication
1060 * reject WPA/WPA2 message 3/4 if it does not include any valid
1062 * driver_wext: added fallback to use SIOCSIWENCODE for setting auth_alg
1063 if the driver does not support SIOCSIWAUTH
1066 * driver_test: added better support for multiple APs and STAs by using
1067 a directory with sockets that include MAC address for each device in
1068 the name (driver_param=test_dir=/tmp/test)
1069 * added support for EAP expanded type (vendor specific EAP methods)
1070 * added AP_SCAN command into ctrl_iface so that ap_scan configuration
1071 option can be changed if needed
1072 * wpa_cli/wpa_gui: skip non-socket files in control directory when
1073 using UNIX domain sockets; this avoids selecting an incorrect
1074 interface (e.g., a PID file could be in this directory, even though
1075 use of this directory for something else than socket files is not
1077 * fixed TLS library deinitialization after RSN pre-authentication not
1078 to disable TLS library for normal authentication
1079 * driver_wext: Remove null-termination from SSID length if the driver
1080 used it; some Linux drivers do this and they were causing problems in
1081 wpa_supplicant not finding matching configuration block. This change
1082 would break a case where the SSID actually ends in '\0', but that is
1083 not likely to happen in real use.
1084 * fixed PMKSA cache processing not to trigger deauthentication if the
1085 current PMKSA cache entry is replaced with a valid new entry
1086 * fixed PC/SC initialization for ap_scan != 1 modes (this fixes
1087 EAP-SIM and EAP-AKA with real SIM/USIM card when using ap_scan=0 or
1090 2005-12-18 - v0.5.0 (beginning of 0.5.x development releases)
1091 * added experimental STAKey handshake implementation for IEEE 802.11e
1092 direct link setup (DLS); note: this is disabled by default in both
1093 build and runtime configuration (can be enabled with CONFIG_STAKEY=y
1095 * fixed EAP-SIM and EAP-AKA pseudonym and fast re-authentication to
1096 decrypt AT_ENCR_DATA attributes correctly
1097 * fixed EAP-AKA to allow resynchronization within the same session
1098 * made code closer to ANSI C89 standard to make it easier to port to
1099 other C libraries and compilers
1100 * started moving operating system or C library specific functions into
1101 wrapper functions defined in os.h and implemented in os_*.c to make
1103 * wpa_supplicant can now be built with Microsoft Visual C++
1104 (e.g., with the freely available Toolkit 2003 version or Visual
1105 C++ 2005 Express Edition and Platform SDK); see nmake.mak for an
1106 example makefile for nmake
1107 * added support for using Windows registry for command line parameters
1108 (CONFIG_MAIN=main_winsvc) and configuration data
1109 (CONFIG_BACKEND=winreg); see win_example.reg for an example registry
1110 contents; this version can be run both as a Windows service and as a
1111 normal application; 'wpasvc.exe app' to start as applicant,
1112 'wpasvc.exe reg <full path to wpasvc.exe>' to register a service,
1113 'net start wpasvc' to start the service, 'wpasvc.exe unreg' to
1114 unregister a service
1115 * made it possible to link ndis_events.exe functionality into
1116 wpa_supplicant.exe by defining CONFIG_NDIS_EVENTS_INTEGRATED
1117 * added better support for multiple control interface backends
1118 (CONFIG_CTRL_IFACE option); currently, 'unix' and 'udp' are supported
1119 * fixed PC/SC code to use correct length for GSM AUTH command buffer
1120 and to not use pioRecvPci with SCardTransmit() calls; these were not
1121 causing visible problems with pcsc-lite, but Windows Winscard.dll
1122 refused the previously used parameters; this fixes EAP-SIM and
1123 EAP-AKA authentication using SIM/USIM card under Windows
1124 * added new event loop implementation for Windows using
1125 WaitForMultipleObject() instead of select() in order to allow waiting
1126 for non-socket objects; this can be selected with
1127 CONFIG_ELOOP=eloop_win in .config
1128 * added support for selecting l2_packet implementation in .config
1129 (CONFIG_L2_PACKET; following options are available now: linux, pcap,
1130 winpcap, freebsd, none)
1131 * added new l2_packet implementation for WinPcap
1132 (CONFIG_L2_PACKET=winpcap) that uses a separate receive thread to
1133 reduce latency in EAPOL receive processing from about 100 ms to about
1135 * added support for EAP-FAST key derivation using other ciphers than
1136 RC4-128-SHA for authentication and AES128-SHA for provisioning
1137 * added support for configuring CA certificate as DER file and as a
1139 * fixed private key configuration as configuration blob and added
1140 support for using PKCS#12 as a blob
1141 * tls_gnutls: added support for using PKCS#12 files; added support for
1143 * added support for loading trusted CA certificates from Windows
1144 certificate store: ca_cert="cert_store://<name>", where <name> is
1145 likely CA (Intermediate CA certificates) or ROOT (root certificates)
1146 * added C version of ndis_events.cpp and made it possible to build this
1147 with MinGW so that CONFIG_NDIS_EVENTS_INTEGRATED can be used more
1148 easily on cross-compilation builds
1149 * added wpasvc.exe into Windows binary release; this is an alternative
1150 version of wpa_supplicant.exe with configuration backend using
1151 Windows registry and with the entry point designed to run as a
1153 * integrated ndis_events.exe functionality into wpa_supplicant.exe and
1154 wpasvc.exe and removed this additional tool from the Windows binary
1155 release since it is not needed anymore
1156 * load winscard.dll functions dynamically when building with MinGW
1157 since MinGW does not yet include winscard library
1159 2005-11-20 - v0.4.7 (beginning of 0.4.x stable releases)
1160 * l2_packet_pcap: fixed wired IEEE 802.1X authentication with libpcap
1161 and WinPcap to receive frames sent to PAE group address
1162 * disable EAP state machine when IEEE 802.1X authentication is not used
1163 in order to get rid of bogus "EAP failed" messages
1164 * fixed OpenSSL error reporting to go through all pending errors to
1165 avoid confusing reports of old errors being reported at later point
1167 * fixed configuration file updating to not write empty variables
1168 (e.g., proto or key_mgmt) that the file parser would not accept
1169 * fixed ADD_NETWORK ctrl_iface command to use the same default values
1170 for variables as empty network definitions read from config file
1172 * fixed EAP state machine to not discard EAP-Failure messages in many
1173 cases (e.g., during TLS handshake)
1174 * fixed a infinite loop in private key reading if the configured file
1175 cannot be parsed successfully
1176 * driver_madwifi: added support for madwifi-ng
1177 * wpa_gui: do not display password/PSK field contents
1178 * wpa_gui: added CA certificate configuration
1179 * driver_ndis: fixed scan request in ap_scan=2 mode not to change SSID
1180 * driver_ndis: include Beacon IEs in AssocInfo in order to notice if
1181 the new AP is using different WPA/RSN IE
1182 * use longer timeout for IEEE 802.11 association to avoid problems with
1183 drivers that may take more than five second to associate
1186 * allow fallback to WPA, if mixed WPA+WPA2 networks have mismatch in
1187 RSN IE, but WPA IE would match with wpa_supplicant configuration
1188 * added support for named configuration blobs in order to avoid having
1189 to use file system for external files (e.g., certificates);
1190 variables can be set to "blob://<blob name>" instead of file path to
1191 use a named blob; supported fields: pac_file, client_cert,
1193 * fixed RSN pre-authentication (it was broken in the clean up of WPA
1194 state machine interface in v0.4.5)
1195 * driver_madwifi: set IEEE80211_KEY_GROUP flag for group keys to make
1196 sure the driver configures broadcast decryption correctly
1197 * added ca_path (and ca_path2) configuration variables that can be used
1198 to configure OpenSSL CA path, e.g., /etc/ssl/certs, for using the
1199 system-wide trusted CA list
1200 * added support for starting wpa_supplicant without a configuration
1201 file (-C argument must be used to set ctrl_interface parameter for
1202 this case; in addition, -p argument can be used to provide
1203 driver_param; these new arguments can also be used with a
1204 configuration to override the values from the configuration)
1205 * added global control interface that can be optionally used for adding
1206 and removing network interfaces dynamically (-g command line argument
1207 for both wpa_supplicant and wpa_cli) without having to restart
1208 wpa_supplicant process
1210 - try to save configuration whenever something is modified
1211 - added WEP key configuration
1212 - added possibility to edit the current network configuration
1213 * driver_ndis: fixed driver polling not to increase frequency on each
1214 received EAPOL frame due to incorrectly cancelled timeout
1215 * added simple configuration file examples (in examples subdirectory)
1216 * fixed driver_wext.c to filter wireless events based on ifindex to
1217 avoid interfaces receiving events from other interfaces
1218 * delay sending initial EAPOL-Start couple of seconds to speed up
1219 authentication for the most common case of Authenticator starting
1220 EAP authentication immediately after association
1223 * added a workaround for clearing keys with ndiswrapper to allow
1224 roaming from WPA enabled AP to plaintext one
1225 * added docbook documentation (doc/docbook) that can be used to
1226 generate, e.g., man pages
1227 * l2_packet_linux: use socket type SOCK_DGRAM instead of SOCK_RAW for
1228 PF_PACKET in order to prepare for network devices that do not use
1229 Ethernet headers (e.g., network stack with native IEEE 802.11 frames)
1230 * use receipt of EAPOL-Key frame as a lower layer success indication
1231 for EAP state machine to allow recovery from dropped EAP-Success
1233 * cleaned up internal EAPOL frame processing by not including link
1234 layer (Ethernet) header during WPA and EAPOL/EAP processing; this
1235 header is added only when transmitted the frame; this makes it easier
1236 to use wpa_supplicant on link layers that use different header than
1238 * updated EAP-PSK to use draft 9 by default since this can now be
1239 tested with hostapd; removed support for draft 3, including
1240 server_nai configuration option from network blocks
1241 * driver_wired: add PAE address to the multicast address list in order
1242 to be able to receive EAPOL frames with drivers that do not include
1243 these multicast addresses by default
1244 * driver_wext: add support for WE-19
1245 * added support for multiple configuration backends (CONFIG_BACKEND
1246 option); currently, only 'file' is supported (i.e., the format used
1247 in wpa_supplicant.conf)
1248 * added support for updating configuration ('wpa_cli save_config');
1249 this is disabled by default and can be enabled with global
1250 update_config=1 variable in wpa_supplicant.conf; this allows wpa_cli
1251 and wpa_gui to store the configuration changes in a permanent store
1252 * added GET_NETWORK ctrl_iface command
1253 (e.g., 'wpa_cli get_network 0 ssid')
1256 * replaced OpenSSL patch for EAP-FAST support
1257 (openssl-tls-extensions.patch) with a more generic and correct
1258 patch (the new patch is not compatible with the previous one, so the
1259 OpenSSL library will need to be patched with the new patch in order
1260 to be able to build wpa_supplicant with EAP-FAST support)
1261 * added support for using Windows certificate store (through CryptoAPI)
1262 for client certificate and private key operations (EAP-TLS)
1263 (see wpa_supplicant.conf for more information on how to configure
1264 this with private_key)
1265 * ported wpa_gui to Windows
1266 * added Qt4 version of wpa_gui (wpa_gui-qt4 directory); this can be
1267 built with the open source version of the Qt4 for Windows
1268 * allow non-WPA modes (e.g., IEEE 802.1X with dynamic WEP) to be used
1269 with drivers that do not support WPA
1270 * ndis_events: fixed Windows 2000 support
1271 * added support for enabling/disabling networks from the list of all
1272 configured networks ('wpa_cli enable_network <network id>' and
1273 'wpa_cli disable_network <network id>')
1274 * added support for adding and removing network from the current
1275 configuration ('wpa_cli add_network' and 'wpa_cli remove_network
1276 <network id>'); added networks are disabled by default and they can
1277 be enabled with enable_network command once the configuration is done
1278 for the new network; note: configuration file is not yet updated, so
1279 these new networks are lost when wpa_supplicant is restarted
1280 * added support for setting network configuration parameters through
1281 the control interface, for example:
1282 wpa_cli set_network 0 ssid "\"my network\""
1283 * fixed parsing of strings that include both " and # within double
1284 quoted area (e.g., "start"#end")
1285 * added EAP workaround for PEAP session resumption: allow outer,
1286 i.e., not tunneled, EAP-Success to terminate session since; this can
1287 be disabled with eap_workaround=0
1288 (this was allowed for PEAPv1 before, but now it is also allowed for
1289 PEAPv0 since at least one RADIUS authentication server seems to be
1290 doing this for PEAPv0, too)
1291 * wpa_gui: added preliminary support for adding new networks to the
1292 wpa_supplicant configuration (double click on the scan results to
1293 open network configuration)
1296 * removed interface for external EAPOL/EAP supplicant (e.g.,
1297 Xsupplicant), (CONFIG_XSUPPLICANT_IFACE) since it is not required
1298 anymore and is unlikely to be used by anyone
1299 * driver_ndis: fixed WinPcap 3.0 support
1300 * fixed build with CONFIG_DNET_PCAP=y on Linux
1301 * l2_packet: moved different implementations into separate files
1305 * driver_ipw: updated driver structures to match with ipw2200-1.0.4
1306 (note: ipw2100-1.1.0 is likely to require an update to work with
1308 * added support for using ap_scan=2 mode with multiple network blocks;
1309 wpa_supplicant will go through the networks one by one until the
1310 driver reports a successful association; this uses the same order for
1311 networks as scan_ssid=1 scans, i.e., the priority field is ignored
1312 and the network block order in the file is used instead
1313 * fixed a potential issue in RSN pre-authentication ending up using
1314 freed memory if pre-authentication times out
1315 * added support for matching alternative subject name extensions of the
1316 authentication server certificate; new configuration variables
1317 altsubject_match and altsubject_match2
1318 * driver_ndis: added support for IEEE 802.1X authentication with wired
1320 * added support for querying private key password (EAP-TLS) through the
1321 control interface (wpa_cli/wpa_gui) if one is not included in the
1323 * driver_broadcom: fixed couple of memory leaks in scan result
1325 * EAP-PAX is now registered as EAP type 46
1326 * fixed EAP-PAX MAC calculation
1327 * fixed EAP-PAX CK and ICK key derivation
1328 * added support for using password with EAP-PAX (as an alternative to
1329 entering key with eappsk); SHA-1 hash of the password will be used as
1330 the key in this case
1331 * added support for arbitrary driver interface parameters through the
1332 configuration file with a new driver_param field; this adds a new
1333 driver_ops function set_param()
1334 * added possibility to override l2_packet module with driver interface
1335 API (new send_eapol handler); this can be used to implement driver
1336 specific TX/RX functions for EAPOL frames
1337 * fixed ctrl_interface_group processing for the case where gid is
1338 entered as a number, not group name
1339 * driver_test: added support for testing hostapd with wpa_supplicant
1340 by using test driver interface without any kernel drivers or network
1344 * driver_madwifi: fixed WPA/WPA2 mode configuration to allow EAPOL
1345 packets to be encrypted; this was apparently broken by the changed
1346 ioctl order in v0.4.0
1347 * driver_madwifi: added preliminary support for compiling against 'BSD'
1348 branch of madwifi CVS tree
1349 * added support for EAP-MSCHAPv2 password retries within the same EAP
1350 authentication session
1351 * added support for password changes with EAP-MSCHAPv2 (used when the
1352 password has expired)
1353 * added support for reading additional certificates from PKCS#12 files
1354 and adding them to the certificate chain
1355 * fixed association with IEEE 802.1X (no WPA) when dynamic WEP keys
1357 * fixed a possible double free in EAP-TTLS fast-reauthentication when
1358 identity or password is entered through control interface
1359 * display EAP Notification messages to user through control interface
1360 with "CTRL-EVENT-EAP-NOTIFICATION" prefix
1361 * added GUI version of wpa_cli, wpa_gui; this is not build
1362 automatically with 'make'; use 'make wpa_gui' to build (this requires
1363 Qt development tools)
1364 * added 'disconnect' command to control interface for setting
1365 wpa_supplicant in state where it will not associate before
1366 'reassociate' command has been used
1367 * added support for selecting a network from the list of all configured
1368 networks ('wpa_cli select_network <network id>'; this disabled all
1369 other networks; to re-enable, 'wpa_cli select_network any')
1370 * added support for getting scan results through control interface
1371 * added EAP workaround for PEAPv1 session resumption: allow outer,
1372 i.e., not tunneled, EAP-Success to terminate session since; this can
1373 be disabled with eap_workaround=0
1375 2005-04-25 - v0.4.0 (beginning of 0.4.x development releases)
1376 * added a new build time option, CONFIG_NO_STDOUT_DEBUG, that can be
1377 used to reduce the size of the wpa_supplicant considerably if
1378 debugging code is not needed
1379 * fixed EAPOL-Key validation to drop packets with invalid Key Data
1380 Length; such frames could have crashed wpa_supplicant due to buffer
1382 * added support for wired authentication (IEEE 802.1X on wired
1383 Ethernet); driver interface 'wired'
1384 * obsoleted set_wpa() handler in the driver interface API (it can be
1385 replaced by moving enable/disable functionality into init()/deinit())
1386 (calls to set_wpa() are still present for backwards compatibility,
1387 but they may be removed in the future)
1388 * driver_madwifi: fixed association in plaintext mode
1389 * modified the EAP workaround that accepts EAP-Success with incorrect
1390 Identifier to be even less strict about verification in order to
1391 interoperate with some authentication servers
1392 * added support for sending TLS alerts
1393 * added support for 'any' SSID wildcard; if ssid is not configured or
1394 is set to an empty string, any SSID will be accepted for non-WPA AP
1395 * added support for asking PIN (for SIM) from frontends (e.g.,
1396 wpa_cli); if a PIN is needed, but not included in the configuration
1397 file, a control interface request is sent and EAP processing is
1398 delayed until the PIN is available
1399 * added support for using external devices (e.g., a smartcard) for
1400 private key operations in EAP-TLS (CONFIG_SMARTCARD=y in .config);
1401 new wpa_supplicant.conf variables:
1402 - global: opensc_engine_path, pkcs11_engine_path, pkcs11_module_path
1403 - network: engine, engine_id, key_id
1404 * added experimental support for EAP-PAX
1405 * added monitor mode for wpa_cli (-a<path to a program to run>) that
1406 allows external commands (e.g., shell scripts) to be run based on
1407 wpa_supplicant events, e.g., when authentication has been completed
1408 and data connection is ready; other related wpa_cli arguments:
1409 -B (run in background), -P (write PID file); wpa_supplicant has a new
1410 command line argument (-W) that can be used to make it wait until a
1411 control interface command is received in order to avoid missing
1413 * added support for opportunistic WPA2 PMKSA key caching (disabled by
1414 default, can be enabled with proactive_key_caching=1)
1415 * fixed RSN IE in 4-Way Handshake message 2/4 for the case where
1416 Authenticator rejects PMKSA caching attempt and the driver is not
1417 using assoc_info events
1418 * added -P<pid file> argument for wpa_supplicant to write the current
1419 process id into a file
1421 2005-02-12 - v0.3.7 (beginning of 0.3.x stable releases)
1422 * added new phase1 option parameter, include_tls_length=1, to force
1423 wpa_supplicant to add TLS Message Length field to all TLS messages
1424 even if the packet is not fragmented; this may be needed with some
1425 authentication servers
1426 * fixed WPA/RSN IE verification in message 3 of 4-Way Handshake when
1427 using drivers that take care of AP selection (e.g., when using
1429 * fixed reprocessing of pending request after ctrl_iface requests for
1430 identity/password/otp
1431 * fixed ctrl_iface requests for identity/password/otp in Phase 2 of
1432 EAP-PEAP and EAP-TTLS
1433 * all drivers using driver_wext: set interface up and select Managed
1434 mode when starting wpa_supplicant; set interface down when exiting
1435 * renamed driver_ipw2100.c to driver_ipw.c since it now supports both
1436 ipw2100 and ipw2200; please note that this also changed the
1437 configuration variable in .config to CONFIG_DRIVER_IPW
1440 * fixed a busy loop introduced in v0.3.5 for scan result processing
1441 when no matching AP is found
1444 * added a workaround for an interoperability issue with a Cisco AP
1446 * fixed non-WPA IEEE 802.1X to use the same authentication timeout as
1447 WPA with IEEE 802.1X (i.e., timeout 10 -> 70 sec to allow
1448 retransmission of dropped frames)
1449 * fixed issues with 64-bit CPUs and SHA1 cleanup in previous version
1450 (e.g., segfault when processing EAPOL-Key frames)
1451 * fixed EAP workaround and fast reauthentication configuration for
1452 RSN pre-authentication; previously these were disabled and
1453 pre-authentication would fail if the used authentication server
1454 requires EAP workarounds
1455 * added support for blacklisting APs that fail or timeout
1456 authentication in ap_scan=1 mode so that all APs are tried in cases
1457 where the ones with strongest signal level are failing authentication
1458 * fixed CA certificate loading after a failed EAP-TLS/PEAP/TTLS
1459 authentication attempt
1460 * allow EAP-PEAP/TTLS fast reauthentication only if Phase 2 succeeded
1461 in the previous authentication (previously, only Phase 1 success was
1465 * added preliminary support for IBSS (ad-hoc) mode configuration
1466 (mode=1 in network block); this included a new key_mgmt mode
1467 WPA-NONE, i.e., TKIP or CCMP with a fixed key (based on psk) and no
1468 key management; see wpa_supplicant.conf for more details and an
1469 example on how to configure this (note: this is currently implemented
1470 only for driver_hostapd.c, but the changes should be trivial to add
1471 in associate() handler for other drivers, too (assuming the driver
1473 * added preliminary port for native Windows (i.e., no cygwin) using
1477 * added optional support for GNU Readline and History Libraries for
1478 wpa_cli (CONFIG_READLINE)
1479 * cleaned up EAP state machine <-> method interface and number of
1480 small problems with error case processing not terminating on
1481 EAP-Failure but waiting for timeout
1482 * added couple of workarounds for interoperability issues with a
1483 Cisco AP when using WPA2
1484 * added support for EAP-FAST (draft-cam-winget-eap-fast-00.txt);
1485 Note: This requires a patch for openssl to add support for TLS
1486 extensions and number of workarounds for operations without
1487 certificates. Proof of concept type of experimental patch is
1488 included in openssl-tls-extensions.patch.
1491 * fixed private key loading for cases where passphrase is not set
1492 * fixed Windows/cygwin L2 packet handler freeing; previous version
1493 could cause a segfault when RSN pre-authentication was completed
1494 * added support for PMKSA caching with drivers that generate RSN IEs
1495 (e.g., NDIS); currently, this is only implemented in driver_ndis.c,
1496 but similar code can be easily added to driver_ndiswrapper.c once
1497 ndiswrapper gets full support for RSN PMKSA caching
1498 * improved recovery from PMKID mismatches by requesting full EAP
1499 authentication in case of failed PMKSA caching attempt
1500 * driver_ndis: added support for NDIS NdisMIncidateStatus() events
1501 (this requires that ndis_events is ran while wpa_supplicant is
1503 * driver_ndis: use ADD_WEP/REMOVE_WEP when configuring WEP keys
1504 * added support for driver interfaces to replace the interface name
1505 based on driver/OS specific mapping, e.g., in case of driver_ndis,
1506 this allows the beginning of the adapter description to be used as
1508 * added support for CR+LF (Windows-style) line ends in configuration
1510 * driver_ndis: enable radio before starting scanning, disable radio
1512 * modified association event handler to set portEnabled = FALSE before
1513 clearing port Valid in order to reset EAP state machine and avoid
1514 problems with new authentication getting ignored because of state
1515 machines ending up in AUTHENTICATED/SUCCESS state based on old
1517 * added support for driver events to add PMKID candidates in order to
1518 allow drivers to give priority to most likely roaming candidates
1519 * driver_hostap: moved PrivacyInvoked configuration to associate()
1520 function so that this will not be set for plaintext connections
1521 * added KEY_MGMT_802_1X_NO_WPA as a new key_mgmt type so that driver
1522 interface can distinguish plaintext and IEEE 802.1X (no WPA)
1524 * fixed static WEP key configuration to use broadcast/default type for
1525 all keys (previously, the default TX key was configured as pairwise/
1527 * driver_ndis: added legacy WPA capability detection for non-WPA2
1529 * added support for setting static WEP keys for IEEE 802.1X without
1530 dynamic WEP keying (eapol_flags=0)
1533 * added support for reading PKCS#12 (PFX) files (as a replacement for
1534 PEM/DER) to get certificate and private key (CONFIG_PKCS12)
1535 * fixed compilation with CONFIG_PCSC=y
1536 * added new ap_scan mode, ap_scan=2, for drivers that take care of
1537 association, but need to be configured with security policy and SSID,
1538 e.g., ndiswrapper and NDIS driver; this mode should allow such
1539 drivers to work with hidden SSIDs and optimized roaming; when
1540 ap_scan=2 is used, only the first network block in the configuration
1541 file is used and this configuration should have explicit security
1542 policy (i.e., only one option in the lists) for key_mgmt, pairwise,
1543 group, proto variables
1544 * added experimental port of wpa_supplicant for Windows
1545 - driver_ndis.c driver interface (NDIS OIDs)
1546 - currently, this requires cygwin and WinPcap
1547 - small utility, win_if_list, can be used to get interface name
1548 * control interface can now be removed at build time; add
1549 CONFIG_CTRL_IFACE=y to .config to maintain old functionality
1550 * optional Xsupplicant interface can now be removed at build time;
1551 (CONFIG_XSUPPLICANT_IFACE=y in .config to bring it back)
1552 * added auth_alg to driver interface associate() parameters to make it
1553 easier for drivers to configure authentication algorithm as part of
1556 2004-12-05 - v0.3.0 (beginning of 0.3.x development releases)
1557 * driver_broadcom: added new driver interface for Broadcom wl.o driver
1558 (a generic driver for Broadcom IEEE 802.11a/g cards)
1559 * wpa_cli: fixed parsing of -p <path> command line argument
1560 * PEAPv1: fixed tunneled EAP-Success reply handling to reply with TLS
1561 ACK, not tunneled EAP-Success (of which only the first byte was
1562 actually send due to a bug in previous code); this seems to
1563 interoperate with most RADIUS servers that implements PEAPv1
1564 * PEAPv1: added support for terminating PEAP authentication on tunneled
1565 EAP-Success message; this can be configured by adding
1566 peap_outer_success=0 on phase1 parameters in wpa_supplicant.conf
1567 (some RADIUS servers require this whereas others require a tunneled
1569 * PEAPv1: changed phase1 option peaplabel to use default to 0, i.e., to
1570 the old label for key derivation; previously, the default was 1,
1571 but it looks like most existing PEAPv1 implementations use the old
1572 label which is thus more suitable default option
1573 * added support for EAP-PSK (draft-bersani-eap-psk-03.txt)
1574 * fixed parsing of wep_tx_keyidx
1575 * added support for configuring list of allowed Phase 2 EAP types
1576 (for both EAP-PEAP and EAP-TTLS) instead of only one type
1577 * added support for configuring IEEE 802.11 authentication algorithm
1578 (auth_alg; mainly for using Shared Key authentication with static
1580 * added support for EAP-AKA (with UMTS SIM)
1581 * fixed couple of errors in PCSC handling that could have caused
1582 random-looking errors for EAP-SIM
1583 * added support for EAP-SIM pseudonyms and fast re-authentication
1584 * added support for EAP-TLS/PEAP/TTLS fast re-authentication (TLS
1586 * added support for EAP-SIM with two challanges
1587 (phase1="sim_min_num_chal=3" can be used to require three challenges)
1588 * added support for configuring DH/DSA parameters for an ephemeral DH
1589 key exchange (EAP-TLS/PEAP/TTLS) using new configuration parameters
1590 dh_file and dh_file2 (phase 2); this adds support for using DSA keys
1591 and optional DH key exchange to achieve forward secracy with RSA keys
1592 * added support for matching subject of the authentication server
1593 certificate with a substring when using EAP-TLS/PEAP/TTLS; new
1594 configuration variables subject_match and subject_match2
1595 * changed SSID configuration in driver_wext.c (used by many driver
1596 interfaces) to use ssid_len+1 as the length for SSID since some Linux
1598 * fixed couple of unaligned reads in scan result parsing to fix WPA
1599 connection on some platforms (e.g., ARM)
1600 * added driver interface for Intel ipw2100 driver
1601 * added support for LEAP with WPA
1602 * added support for larger scan results report (old limit was 4 kB of
1603 data, i.e., about 35 or so APs) when using Linux wireless extensions
1605 * fixed a bug in PMKSA cache processing: skip sending of EAPOL-Start
1606 only if there is a PMKSA cache entry for the current AP
1607 * fixed error handling for case where reading of scan results fails:
1608 must schedule a new scan or wpa_supplicant will remain waiting
1610 * changed debug output to remove shared password/key material by
1611 default; all key information can be included with -K command line
1612 argument to match the previous behavior
1613 * added support for timestamping debug log messages (disabled by
1614 default, can be enabled with -t command line argument)
1615 * set pairwise/group cipher suite for non-WPA IEEE 802.1X to WEP-104
1616 if keys are not configured to be used; this fixes IEEE 802.1X mode
1617 with drivers that use this information to configure whether Privacy
1618 bit can be in Beacon frames (e.g., ndiswrapper)
1619 * avoid clearing driver keys if no keys have been configured since last
1620 key clear request; this seems to improve reliability of group key
1621 handshake for ndiswrapper & NDIS driver which seems to be suffering
1622 of some kind of timing issue when the keys are cleared again after
1624 * changed driver interface API:
1625 - WPA_SUPPLICANT_DRIVER_VERSION define can be used to determine which
1626 version is being used (now, this is set to 2; previously, it was
1628 - pass pointer to private data structure to all calls
1629 - the new API is not backwards compatible; all in-tree driver
1630 interfaces has been converted to the new API
1631 * added support for controlling multiple interfaces (radios) per
1632 wpa_supplicant process; each interface needs to be listed on the
1633 command line (-c, -i, -D arguments) with -N as a separator
1634 (-cwpa1.conf -iwlan0 -Dhostap -N -cwpa2.conf -iath0 -Dmadwifi)
1635 * added a workaround for EAP servers that incorrectly use same Id for
1636 sequential EAP packets
1637 * changed libpcap/libdnet configuration to use .config variable,
1638 CONFIG_DNET_PCAP, instead of requiring Makefile modification
1639 * improved downgrade attack detection in IE verification of msg 3/4:
1640 verify both WPA and RSN IEs, if present, not only the selected one;
1641 reject the AP if an RSN IE is found in msg 3/4, but not in Beacon or
1642 Probe Response frame, and RSN is enabled in wpa_supplicant
1644 * fixed WPA msg 3/4 processing to allow Key Data field contain other
1645 IEs than just one WPA IE
1646 * added support for FreeBSD and driver interface for the BSD net80211
1647 layer (CONFIG_DRIVER_BSD=y in .config); please note that some of the
1648 required kernel mods have not yet been committed
1649 * made EAP workarounds configurable; enabled by default, can be
1650 disabled with network block option eap_workaround=0
1652 2004-07-17 - v0.2.4 (beginning of 0.2.x stable releases)
1653 * resolved couple of interoperability issues with EAP-PEAPv1 and
1654 Phase 2 (inner EAP) fragment reassembly
1655 * driver_madwifi: fixed WEP key configuration for IEEE 802.1X when the
1656 AP is using non-zero key index for the unicast key and key index zero
1657 for the broadcast key
1658 * driver_hostap: fixed IEEE 802.1X WEP key updates and
1659 re-authentication by allowing unencrypted EAPOL frames when not using
1661 * added a new driver interface, 'wext', which uses only standard,
1662 driver independent functionality in Linux wireless extensions;
1663 currently, this can be used only for non-WPA IEEE 802.1X mode, but
1664 eventually, this is to be extended to support full WPA/WPA2 once
1665 Linux wireless extensions get support for this
1666 * added support for mode in which the driver is responsible for AP
1667 scanning and selection; this is disabled by default and can be
1668 enabled with global ap_scan=0 variable in wpa_supplicant.conf;
1669 this mode can be used, e.g., with generic 'wext' driver interface to
1670 use wpa_supplicant as IEEE 802.1X Supplicant with any Linux driver
1671 supporting wireless extensions.
1672 * driver_madwifi: fixed WPA2 configuration and scan_ssid=1 (e.g.,
1673 operation with an AP that does not include SSID in the Beacon frames)
1674 * added support for new EAP authentication methods:
1675 EAP-TTLS/EAP-OTP, EAP-PEAPv0/OTP, EAP-PEAPv1/OTP, EAP-OTP
1676 * added support for asking one-time-passwords from frontends (e.g.,
1677 wpa_cli); this 'otp' command works otherwise like 'password' command,
1678 but the password is used only once and the frontend will be asked for
1679 a new password whenever a request from authenticator requires a
1680 password; this can be used with both EAP-OTP and EAP-GTC
1681 * changed wpa_cli to automatically re-establish connection so that it
1682 does not need to be re-started when wpa_supplicant is terminated and
1684 * improved user data (identity/password/otp) requests through
1685 frontends: process pending EAPOL packets after getting new
1686 information so that full authentication does not need to be
1687 restarted; in addition, send pending requests again whenever a new
1688 frontend is attached
1689 * changed control frontends to use a new directory for socket files to
1690 make it easier for wpa_cli to automatically select between interfaces
1691 and to provide access control for the control interface;
1692 wpa_supplicant.conf: ctrl_interface is now a path
1693 (/var/run/wpa_supplicant is the recommended path) and
1694 ctrl_interface_group can be used to select which group gets access to
1695 the control interface;
1696 wpa_cli: by default, try to connect to the first interface available
1697 in /var/run/wpa_supplicant; this path can be overriden with -p option
1698 and an interface can be selected with -i option (i.e., in most common
1699 cases, wpa_cli does not need to get any arguments)
1700 * added support for LEAP
1701 * added driver interface for Linux ndiswrapper
1702 * added priority option for network blocks in the configuration file;
1703 this allows networks to be grouped based on priority (the scan
1704 results are searched for matches with network blocks in this order)
1707 * sort scan results to improve AP selection
1708 * fixed control interface socket removal for some error cases
1709 * improved scan requesting and authentication timeout
1710 * small improvements/bug fixes for EAP-MSCHAPv2, EAP-PEAP, and
1712 * PEAP version can now be forced with phase1="peapver=<ver>"
1713 (mostly for testing; by default, the highest version supported by
1714 both the Supplicant and Authentication Server is selected
1716 * added support for madwifi driver (Atheros ar521x)
1717 * added a workaround for cases where AP sets Install Tx/Rx bit for
1718 WPA Group Key messages when pairwise keys are used (without this,
1719 the Group Key would be used for Tx and the AP would drop frames
1721 * added GSM SIM/USIM interface for GSM authentication algorithm for
1722 EAP-SIM; this requires pcsc-lite
1723 * added support for ATMEL AT76C5XXx driver
1724 * fixed IEEE 802.1X WEP key derivation in the case where Authenticator
1725 does not include key data in the EAPOL-Key frame (i.e., part of
1726 EAP keying material is used as data encryption key)
1727 * added support for using plaintext and static WEP networks
1731 * added support for new EAP authentication methods:
1732 EAP-TTLS/EAP-MD5-Challenge
1734 EAP-TTLS/EAP-MSCHAPv2
1742 EAP-PEAP/MD5-Challenge
1744 EAP-SIM (not yet complete; needs GSM/SIM authentication interface)
1745 * added support for anonymous identity (to be used when identity is
1746 sent in plaintext; real identity will be used within TLS protected
1747 tunnel (e.g., with EAP-TTLS)
1748 * added event messages from wpa_supplicant to frontends, e.g., wpa_cli
1749 * added support for requesting identity and password information using
1750 control interface; in other words, the password for EAP-PEAP or
1751 EAP-TTLS does not need to be included in the configuration file since
1752 a frontand (e.g., wpa_cli) can ask it from the user
1753 * improved RSN pre-authentication to use a candidate list and process
1754 all candidates from each scan; not only one per scan
1755 * fixed RSN IE and WPA IE capabilities field parsing
1756 * ignore Tx bit in GTK IE when Pairwise keys are used
1757 * avoid making new scan requests during IEEE 802.1X negotiation
1758 * use openssl/libcrypto for MD5 and SHA-1 when compiling wpa_supplicant
1759 with TLS support (this replaces the included implementation with
1760 library code to save about 8 kB since the library code is needed
1762 * fixed WPA-PSK only mode when compiled without IEEE 802.1X support
1763 (i.e., without CONFIG_IEEE8021X_EAPOL=y in .config)
1766 * added support for internal IEEE 802.1X (actually, IEEE 802.1aa/D6.1)
1768 - EAPOL state machines for Supplicant [IEEE 802.1aa/D6.1]
1769 - EAP peer state machine [draft-ietf-eap-statemachine-02.pdf]
1770 - EAP-MD5 (cannot be used with WPA-RADIUS)
1771 [draft-ietf-eap-rfc2284bis-09.txt]
1772 - EAP-TLS [RFC 2716]
1773 - EAP-MSCHAPv2 (currently used only with EAP-PEAP)
1774 - EAP-PEAP/MSCHAPv2 [draft-josefsson-pppext-eap-tls-eap-07.txt]
1775 [draft-kamath-pppext-eap-mschapv2-00.txt]
1776 (PEAP version 0, 1, and parts of 2; only 0 and 1 are enabled by
1777 default; tested with FreeRADIUS, Microsoft IAS, and Funk Odyssey)
1778 - new configuration file options: eap, identity, password, ca_cert,
1779 client_cert, privatekey, private_key_passwd
1780 - Xsupplicant is not required anymore, but it can be used by
1781 disabling the internal IEEE 802.1X Supplicant with -e command line
1783 - this code is not included in the default build; Makefile need to
1784 be edited for this (uncomment lines for selected functionality)
1785 - EAP-TLS and EAP-PEAP require openssl libraries
1786 * use module prefix in debug messages (WPA, EAP, EAP-TLS, ..)
1787 * added support for non-WPA IEEE 802.1X mode with dynamic WEP keys
1788 (i.e., complete IEEE 802.1X/EAP authentication and use IEEE 802.1X
1789 EAPOL-Key frames instead of WPA key handshakes)
1790 * added support for IEEE 802.11i/RSN (WPA2)
1791 - improved PTK Key Handshake
1792 - PMKSA caching, pre-authentication
1793 * fixed wpa_supplicant to ignore possible extra data after WPA
1794 EAPOL-Key packets (this fixes 'Invalid EAPOL-Key MIC when using
1795 TPTK' error from message 3 of 4-Way Handshake in case the AP
1796 includes extra data after the EAPOL-Key)
1797 * added interface for external programs (frontends) to control
1799 - CLI example (wpa_cli) with interactive mode and command line
1801 - replaced SIGUSR1 status/statistics with the new control interface
1802 * made some feature compile time configurable
1803 - .config file for make
1804 - driver interfaces (hostap, hermes, ..)
1805 - EAPOL/EAP functions
1808 * Initial version of wpa_supplicant