defconfig revision 1.3.12.1 1 1.1 christos # Example wpa_supplicant build time configuration
2 1.1 christos #
3 1.1 christos # This file lists the configuration options that are used when building the
4 1.3.12.1 pgoyette # wpa_supplicant binary. All lines starting with # are ignored. Configuration
5 1.3.12.1 pgoyette # option lines must be commented out complete, if they are not to be included,
6 1.3.12.1 pgoyette # i.e., just setting VARIABLE=n is not disabling that variable.
7 1.1 christos #
8 1.1 christos # This file is included in Makefile, so variables like CFLAGS and LIBS can also
9 1.1 christos # be modified from here. In most cases, these lines should use += in order not
10 1.1 christos # to override previous values of the variables.
11 1.1 christos
12 1.1 christos
13 1.1 christos # Uncomment following two lines and fix the paths if you have installed OpenSSL
14 1.1 christos # or GnuTLS in non-default location
15 1.1 christos #CFLAGS += -I/usr/local/openssl/include
16 1.1 christos #LIBS += -L/usr/local/openssl/lib
17 1.1 christos
18 1.1 christos # Some Red Hat versions seem to include kerberos header files from OpenSSL, but
19 1.1 christos # the kerberos files are not in the default include path. Following line can be
20 1.1 christos # used to fix build issues on such systems (krb5.h not found).
21 1.1 christos #CFLAGS += -I/usr/include/kerberos
22 1.1 christos
23 1.2 roy # Driver interface for generic Linux wireless extensions
24 1.2 roy # Note: WEXT is deprecated in the current Linux kernel version and no new
25 1.2 roy # functionality is added to it. nl80211-based interface is the new
26 1.2 roy # replacement for WEXT and its use allows wpa_supplicant to properly control
27 1.2 roy # the driver to improve existing functionality like roaming and to support new
28 1.2 roy # functionality.
29 1.2 roy CONFIG_DRIVER_WEXT=y
30 1.1 christos
31 1.2 roy # Driver interface for Linux drivers using the nl80211 kernel interface
32 1.2 roy CONFIG_DRIVER_NL80211=y
33 1.1 christos
34 1.3 christos # QCA vendor extensions to nl80211
35 1.3 christos #CONFIG_DRIVER_NL80211_QCA=y
36 1.3 christos
37 1.2 roy # driver_nl80211.c requires libnl. If you are compiling it yourself
38 1.2 roy # you may need to point hostapd to your version of libnl.
39 1.2 roy #
40 1.2 roy #CFLAGS += -I$<path to libnl include files>
41 1.2 roy #LIBS += -L$<path to libnl library files>
42 1.1 christos
43 1.2 roy # Use libnl v2.0 (or 3.0) libraries.
44 1.2 roy #CONFIG_LIBNL20=y
45 1.2 roy
46 1.2 roy # Use libnl 3.2 libraries (if this is selected, CONFIG_LIBNL20 is ignored)
47 1.3.12.1 pgoyette CONFIG_LIBNL32=y
48 1.1 christos
49 1.1 christos
50 1.1 christos # Driver interface for FreeBSD net80211 layer (e.g., Atheros driver)
51 1.1 christos #CONFIG_DRIVER_BSD=y
52 1.1 christos #CFLAGS += -I/usr/local/include
53 1.1 christos #LIBS += -L/usr/local/lib
54 1.1 christos #LIBS_p += -L/usr/local/lib
55 1.1 christos #LIBS_c += -L/usr/local/lib
56 1.1 christos
57 1.1 christos # Driver interface for Windows NDIS
58 1.1 christos #CONFIG_DRIVER_NDIS=y
59 1.1 christos #CFLAGS += -I/usr/include/w32api/ddk
60 1.1 christos #LIBS += -L/usr/local/lib
61 1.1 christos # For native build using mingw
62 1.1 christos #CONFIG_NATIVE_WINDOWS=y
63 1.1 christos # Additional directories for cross-compilation on Linux host for mingw target
64 1.1 christos #CFLAGS += -I/opt/mingw/mingw32/include/ddk
65 1.1 christos #LIBS += -L/opt/mingw/mingw32/lib
66 1.1 christos #CC=mingw32-gcc
67 1.1 christos # By default, driver_ndis uses WinPcap for low-level operations. This can be
68 1.1 christos # replaced with the following option which replaces WinPcap calls with NDISUIO.
69 1.1 christos # However, this requires that WZC is disabled (net stop wzcsvc) before starting
70 1.1 christos # wpa_supplicant.
71 1.1 christos # CONFIG_USE_NDISUIO=y
72 1.1 christos
73 1.1 christos # Driver interface for wired Ethernet drivers
74 1.1 christos CONFIG_DRIVER_WIRED=y
75 1.1 christos
76 1.3.12.1 pgoyette # Driver interface for MACsec capable Qualcomm Atheros drivers
77 1.3.12.1 pgoyette #CONFIG_DRIVER_MACSEC_QCA=y
78 1.3.12.1 pgoyette
79 1.3.12.1 pgoyette # Driver interface for Linux MACsec drivers
80 1.3.12.1 pgoyette #CONFIG_DRIVER_MACSEC_LINUX=y
81 1.3.12.1 pgoyette
82 1.1 christos # Driver interface for the Broadcom RoboSwitch family
83 1.1 christos #CONFIG_DRIVER_ROBOSWITCH=y
84 1.1 christos
85 1.1 christos # Driver interface for no driver (e.g., WPS ER only)
86 1.1 christos #CONFIG_DRIVER_NONE=y
87 1.1 christos
88 1.2 roy # Solaris libraries
89 1.2 roy #LIBS += -lsocket -ldlpi -lnsl
90 1.2 roy #LIBS_c += -lsocket
91 1.2 roy
92 1.3.12.1 pgoyette # Enable IEEE 802.1X Supplicant (automatically included if any EAP method or
93 1.3.12.1 pgoyette # MACsec is included)
94 1.1 christos CONFIG_IEEE8021X_EAPOL=y
95 1.1 christos
96 1.1 christos # EAP-MD5
97 1.1 christos CONFIG_EAP_MD5=y
98 1.1 christos
99 1.1 christos # EAP-MSCHAPv2
100 1.1 christos CONFIG_EAP_MSCHAPV2=y
101 1.1 christos
102 1.1 christos # EAP-TLS
103 1.1 christos CONFIG_EAP_TLS=y
104 1.1 christos
105 1.1 christos # EAL-PEAP
106 1.1 christos CONFIG_EAP_PEAP=y
107 1.1 christos
108 1.1 christos # EAP-TTLS
109 1.1 christos CONFIG_EAP_TTLS=y
110 1.1 christos
111 1.1 christos # EAP-FAST
112 1.2 roy # Note: If OpenSSL is used as the TLS library, OpenSSL 1.0 or newer is needed
113 1.2 roy # for EAP-FAST support. Older OpenSSL releases would need to be patched, e.g.,
114 1.2 roy # with openssl-0.9.8x-tls-extensions.patch, to add the needed functions.
115 1.1 christos #CONFIG_EAP_FAST=y
116 1.1 christos
117 1.1 christos # EAP-GTC
118 1.1 christos CONFIG_EAP_GTC=y
119 1.1 christos
120 1.1 christos # EAP-OTP
121 1.1 christos CONFIG_EAP_OTP=y
122 1.1 christos
123 1.1 christos # EAP-SIM (enable CONFIG_PCSC, if EAP-SIM is used)
124 1.1 christos #CONFIG_EAP_SIM=y
125 1.1 christos
126 1.1 christos # EAP-PSK (experimental; this is _not_ needed for WPA-PSK)
127 1.1 christos #CONFIG_EAP_PSK=y
128 1.1 christos
129 1.2 roy # EAP-pwd (secure authentication using only a password)
130 1.2 roy #CONFIG_EAP_PWD=y
131 1.2 roy
132 1.1 christos # EAP-PAX
133 1.1 christos #CONFIG_EAP_PAX=y
134 1.1 christos
135 1.1 christos # LEAP
136 1.1 christos CONFIG_EAP_LEAP=y
137 1.1 christos
138 1.1 christos # EAP-AKA (enable CONFIG_PCSC, if EAP-AKA is used)
139 1.1 christos #CONFIG_EAP_AKA=y
140 1.1 christos
141 1.1 christos # EAP-AKA' (enable CONFIG_PCSC, if EAP-AKA' is used).
142 1.1 christos # This requires CONFIG_EAP_AKA to be enabled, too.
143 1.1 christos #CONFIG_EAP_AKA_PRIME=y
144 1.1 christos
145 1.1 christos # Enable USIM simulator (Milenage) for EAP-AKA
146 1.1 christos #CONFIG_USIM_SIMULATOR=y
147 1.1 christos
148 1.1 christos # EAP-SAKE
149 1.1 christos #CONFIG_EAP_SAKE=y
150 1.1 christos
151 1.1 christos # EAP-GPSK
152 1.1 christos #CONFIG_EAP_GPSK=y
153 1.1 christos # Include support for optional SHA256 cipher suite in EAP-GPSK
154 1.1 christos #CONFIG_EAP_GPSK_SHA256=y
155 1.1 christos
156 1.1 christos # EAP-TNC and related Trusted Network Connect support (experimental)
157 1.1 christos #CONFIG_EAP_TNC=y
158 1.1 christos
159 1.1 christos # Wi-Fi Protected Setup (WPS)
160 1.1 christos #CONFIG_WPS=y
161 1.2 roy # Enable WPS external registrar functionality
162 1.2 roy #CONFIG_WPS_ER=y
163 1.2 roy # Disable credentials for an open network by default when acting as a WPS
164 1.2 roy # registrar.
165 1.2 roy #CONFIG_WPS_REG_DISABLE_OPEN=y
166 1.2 roy # Enable WPS support with NFC config method
167 1.2 roy #CONFIG_WPS_NFC=y
168 1.1 christos
169 1.1 christos # EAP-IKEv2
170 1.1 christos #CONFIG_EAP_IKEV2=y
171 1.1 christos
172 1.2 roy # EAP-EKE
173 1.2 roy #CONFIG_EAP_EKE=y
174 1.2 roy
175 1.3.12.1 pgoyette # MACsec
176 1.3.12.1 pgoyette #CONFIG_MACSEC=y
177 1.3.12.1 pgoyette
178 1.1 christos # PKCS#12 (PFX) support (used to read private key and certificate file from
179 1.1 christos # a file that usually has extension .p12 or .pfx)
180 1.1 christos CONFIG_PKCS12=y
181 1.1 christos
182 1.1 christos # Smartcard support (i.e., private key on a smartcard), e.g., with openssl
183 1.1 christos # engine.
184 1.1 christos CONFIG_SMARTCARD=y
185 1.1 christos
186 1.1 christos # PC/SC interface for smartcards (USIM, GSM SIM)
187 1.1 christos # Enable this if EAP-SIM or EAP-AKA is included
188 1.1 christos #CONFIG_PCSC=y
189 1.1 christos
190 1.2 roy # Support HT overrides (disable HT/HT40, mask MCS rates, etc.)
191 1.2 roy #CONFIG_HT_OVERRIDES=y
192 1.2 roy
193 1.2 roy # Support VHT overrides (disable VHT, mask MCS rates, etc.)
194 1.2 roy #CONFIG_VHT_OVERRIDES=y
195 1.2 roy
196 1.1 christos # Development testing
197 1.1 christos #CONFIG_EAPOL_TEST=y
198 1.1 christos
199 1.1 christos # Select control interface backend for external programs, e.g, wpa_cli:
200 1.1 christos # unix = UNIX domain sockets (default for Linux/*BSD)
201 1.1 christos # udp = UDP sockets using localhost (127.0.0.1)
202 1.2 roy # udp6 = UDP IPv6 sockets using localhost (::1)
203 1.1 christos # named_pipe = Windows Named Pipe (default for Windows)
204 1.2 roy # udp-remote = UDP sockets with remote access (only for tests systems/purpose)
205 1.2 roy # udp6-remote = UDP IPv6 sockets with remote access (only for tests purpose)
206 1.1 christos # y = use default (backwards compatibility)
207 1.1 christos # If this option is commented out, control interface is not included in the
208 1.1 christos # build.
209 1.1 christos CONFIG_CTRL_IFACE=y
210 1.1 christos
211 1.1 christos # Include support for GNU Readline and History Libraries in wpa_cli.
212 1.1 christos # When building a wpa_cli binary for distribution, please note that these
213 1.1 christos # libraries are licensed under GPL and as such, BSD license may not apply for
214 1.1 christos # the resulting binary.
215 1.1 christos #CONFIG_READLINE=y
216 1.1 christos
217 1.2 roy # Include internal line edit mode in wpa_cli. This can be used as a replacement
218 1.2 roy # for GNU Readline to provide limited command line editing and history support.
219 1.2 roy #CONFIG_WPA_CLI_EDIT=y
220 1.2 roy
221 1.1 christos # Remove debugging code that is printing out debug message to stdout.
222 1.1 christos # This can be used to reduce the size of the wpa_supplicant considerably
223 1.1 christos # if debugging code is not needed. The size reduction can be around 35%
224 1.1 christos # (e.g., 90 kB).
225 1.1 christos #CONFIG_NO_STDOUT_DEBUG=y
226 1.1 christos
227 1.1 christos # Remove WPA support, e.g., for wired-only IEEE 802.1X supplicant, to save
228 1.1 christos # 35-50 kB in code size.
229 1.1 christos #CONFIG_NO_WPA=y
230 1.1 christos
231 1.1 christos # Remove IEEE 802.11i/WPA-Personal ASCII passphrase support
232 1.1 christos # This option can be used to reduce code size by removing support for
233 1.1 christos # converting ASCII passphrases into PSK. If this functionality is removed, the
234 1.1 christos # PSK can only be configured as the 64-octet hexstring (e.g., from
235 1.1 christos # wpa_passphrase). This saves about 0.5 kB in code size.
236 1.1 christos #CONFIG_NO_WPA_PASSPHRASE=y
237 1.1 christos
238 1.1 christos # Disable scan result processing (ap_mode=1) to save code size by about 1 kB.
239 1.1 christos # This can be used if ap_scan=1 mode is never enabled.
240 1.1 christos #CONFIG_NO_SCAN_PROCESSING=y
241 1.1 christos
242 1.1 christos # Select configuration backend:
243 1.1 christos # file = text file (e.g., wpa_supplicant.conf; note: the configuration file
244 1.1 christos # path is given on command line, not here; this option is just used to
245 1.1 christos # select the backend that allows configuration files to be used)
246 1.1 christos # winreg = Windows registry (see win_example.reg for an example)
247 1.1 christos CONFIG_BACKEND=file
248 1.1 christos
249 1.1 christos # Remove configuration write functionality (i.e., to allow the configuration
250 1.1 christos # file to be updated based on runtime configuration changes). The runtime
251 1.1 christos # configuration can still be changed, the changes are just not going to be
252 1.1 christos # persistent over restarts. This option can be used to reduce code size by
253 1.1 christos # about 3.5 kB.
254 1.1 christos #CONFIG_NO_CONFIG_WRITE=y
255 1.1 christos
256 1.1 christos # Remove support for configuration blobs to reduce code size by about 1.5 kB.
257 1.1 christos #CONFIG_NO_CONFIG_BLOBS=y
258 1.1 christos
259 1.1 christos # Select program entry point implementation:
260 1.1 christos # main = UNIX/POSIX like main() function (default)
261 1.1 christos # main_winsvc = Windows service (read parameters from registry)
262 1.1 christos # main_none = Very basic example (development use only)
263 1.1 christos #CONFIG_MAIN=main
264 1.1 christos
265 1.2 roy # Select wrapper for operating system and C library specific functions
266 1.1 christos # unix = UNIX/POSIX like systems (default)
267 1.1 christos # win32 = Windows systems
268 1.1 christos # none = Empty template
269 1.1 christos #CONFIG_OS=unix
270 1.1 christos
271 1.1 christos # Select event loop implementation
272 1.1 christos # eloop = select() loop (default)
273 1.1 christos # eloop_win = Windows events and WaitForMultipleObject() loop
274 1.1 christos #CONFIG_ELOOP=eloop
275 1.1 christos
276 1.2 roy # Should we use poll instead of select? Select is used by default.
277 1.2 roy #CONFIG_ELOOP_POLL=y
278 1.2 roy
279 1.2 roy # Should we use epoll instead of select? Select is used by default.
280 1.2 roy #CONFIG_ELOOP_EPOLL=y
281 1.2 roy
282 1.3 christos # Should we use kqueue instead of select? Select is used by default.
283 1.3 christos #CONFIG_ELOOP_KQUEUE=y
284 1.3 christos
285 1.1 christos # Select layer 2 packet implementation
286 1.1 christos # linux = Linux packet socket (default)
287 1.1 christos # pcap = libpcap/libdnet/WinPcap
288 1.1 christos # freebsd = FreeBSD libpcap
289 1.1 christos # winpcap = WinPcap with receive thread
290 1.1 christos # ndis = Windows NDISUIO (note: requires CONFIG_USE_NDISUIO=y)
291 1.1 christos # none = Empty template
292 1.1 christos #CONFIG_L2_PACKET=linux
293 1.1 christos
294 1.3 christos # Disable Linux packet socket workaround applicable for station interface
295 1.3 christos # in a bridge for EAPOL frames. This should be uncommented only if the kernel
296 1.3 christos # is known to not have the regression issue in packet socket behavior with
297 1.3 christos # bridge interfaces (commit 'bridge: respect RFC2863 operational state')').
298 1.3 christos #CONFIG_NO_LINUX_PACKET_SOCKET_WAR=y
299 1.3 christos
300 1.2 roy # IEEE 802.11w (management frame protection), also known as PMF
301 1.1 christos # Driver support is also needed for IEEE 802.11w.
302 1.1 christos #CONFIG_IEEE80211W=y
303 1.1 christos
304 1.1 christos # Select TLS implementation
305 1.1 christos # openssl = OpenSSL (default)
306 1.2 roy # gnutls = GnuTLS
307 1.1 christos # internal = Internal TLSv1 implementation (experimental)
308 1.3.12.1 pgoyette # linux = Linux kernel AF_ALG and internal TLSv1 implementation (experimental)
309 1.1 christos # none = Empty template
310 1.1 christos #CONFIG_TLS=openssl
311 1.1 christos
312 1.2 roy # TLS-based EAP methods require at least TLS v1.0. Newer version of TLS (v1.1)
313 1.2 roy # can be enabled to get a stronger construction of messages when block ciphers
314 1.2 roy # are used. It should be noted that some existing TLS v1.0 -based
315 1.2 roy # implementation may not be compatible with TLS v1.1 message (ClientHello is
316 1.2 roy # sent prior to negotiating which version will be used)
317 1.2 roy #CONFIG_TLSV11=y
318 1.2 roy
319 1.2 roy # TLS-based EAP methods require at least TLS v1.0. Newer version of TLS (v1.2)
320 1.2 roy # can be enabled to enable use of stronger crypto algorithms. It should be
321 1.2 roy # noted that some existing TLS v1.0 -based implementation may not be compatible
322 1.2 roy # with TLS v1.2 message (ClientHello is sent prior to negotiating which version
323 1.2 roy # will be used)
324 1.2 roy #CONFIG_TLSV12=y
325 1.1 christos
326 1.3.12.1 pgoyette # Select which ciphers to use by default with OpenSSL if the user does not
327 1.3.12.1 pgoyette # specify them.
328 1.3.12.1 pgoyette #CONFIG_TLS_DEFAULT_CIPHERS="DEFAULT:!EXP:!LOW"
329 1.3.12.1 pgoyette
330 1.1 christos # If CONFIG_TLS=internal is used, additional library and include paths are
331 1.1 christos # needed for LibTomMath. Alternatively, an integrated, minimal version of
332 1.1 christos # LibTomMath can be used. See beginning of libtommath.c for details on benefits
333 1.1 christos # and drawbacks of this option.
334 1.1 christos #CONFIG_INTERNAL_LIBTOMMATH=y
335 1.1 christos #ifndef CONFIG_INTERNAL_LIBTOMMATH
336 1.1 christos #LTM_PATH=/usr/src/libtommath-0.39
337 1.1 christos #CFLAGS += -I$(LTM_PATH)
338 1.1 christos #LIBS += -L$(LTM_PATH)
339 1.1 christos #LIBS_p += -L$(LTM_PATH)
340 1.1 christos #endif
341 1.1 christos # At the cost of about 4 kB of additional binary size, the internal LibTomMath
342 1.1 christos # can be configured to include faster routines for exptmod, sqr, and div to
343 1.1 christos # speed up DH and RSA calculation considerably
344 1.1 christos #CONFIG_INTERNAL_LIBTOMMATH_FAST=y
345 1.1 christos
346 1.1 christos # Include NDIS event processing through WMI into wpa_supplicant/wpasvc.
347 1.1 christos # This is only for Windows builds and requires WMI-related header files and
348 1.1 christos # WbemUuid.Lib from Platform SDK even when building with MinGW.
349 1.1 christos #CONFIG_NDIS_EVENTS_INTEGRATED=y
350 1.1 christos #PLATFORMSDKLIB="/opt/Program Files/Microsoft Platform SDK/Lib"
351 1.1 christos
352 1.1 christos # Add support for old DBus control interface
353 1.1 christos # (fi.epitest.hostap.WPASupplicant)
354 1.1 christos #CONFIG_CTRL_IFACE_DBUS=y
355 1.1 christos
356 1.1 christos # Add support for new DBus control interface
357 1.1 christos # (fi.w1.hostap.wpa_supplicant1)
358 1.1 christos #CONFIG_CTRL_IFACE_DBUS_NEW=y
359 1.1 christos
360 1.1 christos # Add introspection support for new DBus control interface
361 1.1 christos #CONFIG_CTRL_IFACE_DBUS_INTRO=y
362 1.1 christos
363 1.1 christos # Add support for loading EAP methods dynamically as shared libraries.
364 1.1 christos # When this option is enabled, each EAP method can be either included
365 1.1 christos # statically (CONFIG_EAP_<method>=y) or dynamically (CONFIG_EAP_<method>=dyn).
366 1.1 christos # Dynamic EAP methods are build as shared objects (eap_*.so) and they need to
367 1.1 christos # be loaded in the beginning of the wpa_supplicant configuration file
368 1.1 christos # (see load_dynamic_eap parameter in the example file) before being used in
369 1.1 christos # the network blocks.
370 1.1 christos #
371 1.1 christos # Note that some shared parts of EAP methods are included in the main program
372 1.1 christos # and in order to be able to use dynamic EAP methods using these parts, the
373 1.1 christos # main program must have been build with the EAP method enabled (=y or =dyn).
374 1.1 christos # This means that EAP-TLS/PEAP/TTLS/FAST cannot be added as dynamic libraries
375 1.1 christos # unless at least one of them was included in the main build to force inclusion
376 1.1 christos # of the shared code. Similarly, at least one of EAP-SIM/AKA must be included
377 1.1 christos # in the main build to be able to load these methods dynamically.
378 1.1 christos #
379 1.1 christos # Please also note that using dynamic libraries will increase the total binary
380 1.1 christos # size. Thus, it may not be the best option for targets that have limited
381 1.1 christos # amount of memory/flash.
382 1.1 christos #CONFIG_DYNAMIC_EAP_METHODS=y
383 1.1 christos
384 1.3.12.1 pgoyette # IEEE Std 802.11r-2008 (Fast BSS Transition) for station mode
385 1.1 christos #CONFIG_IEEE80211R=y
386 1.1 christos
387 1.1 christos # Add support for writing debug log to a file (/tmp/wpa_supplicant-log-#.txt)
388 1.1 christos #CONFIG_DEBUG_FILE=y
389 1.1 christos
390 1.2 roy # Send debug messages to syslog instead of stdout
391 1.2 roy #CONFIG_DEBUG_SYSLOG=y
392 1.2 roy # Set syslog facility for debug messages
393 1.2 roy #CONFIG_DEBUG_SYSLOG_FACILITY=LOG_DAEMON
394 1.2 roy
395 1.2 roy # Add support for sending all debug messages (regardless of debug verbosity)
396 1.2 roy # to the Linux kernel tracing facility. This helps debug the entire stack by
397 1.2 roy # making it easy to record everything happening from the driver up into the
398 1.2 roy # same file, e.g., using trace-cmd.
399 1.2 roy #CONFIG_DEBUG_LINUX_TRACING=y
400 1.2 roy
401 1.2 roy # Add support for writing debug log to Android logcat instead of standard
402 1.2 roy # output
403 1.2 roy #CONFIG_ANDROID_LOG=y
404 1.2 roy
405 1.1 christos # Enable privilege separation (see README 'Privilege separation' for details)
406 1.1 christos #CONFIG_PRIVSEP=y
407 1.1 christos
408 1.1 christos # Enable mitigation against certain attacks against TKIP by delaying Michael
409 1.1 christos # MIC error reports by a random amount of time between 0 and 60 seconds
410 1.1 christos #CONFIG_DELAYED_MIC_ERROR_REPORT=y
411 1.1 christos
412 1.1 christos # Enable tracing code for developer debugging
413 1.1 christos # This tracks use of memory allocations and other registrations and reports
414 1.1 christos # incorrect use with a backtrace of call (or allocation) location.
415 1.1 christos #CONFIG_WPA_TRACE=y
416 1.2 roy # For BSD, uncomment these.
417 1.1 christos #LIBS += -lexecinfo
418 1.1 christos #LIBS_p += -lexecinfo
419 1.1 christos #LIBS_c += -lexecinfo
420 1.1 christos
421 1.1 christos # Use libbfd to get more details for developer debugging
422 1.1 christos # This enables use of libbfd to get more detailed symbols for the backtraces
423 1.1 christos # generated by CONFIG_WPA_TRACE=y.
424 1.1 christos #CONFIG_WPA_TRACE_BFD=y
425 1.2 roy # For BSD, uncomment these.
426 1.1 christos #LIBS += -lbfd -liberty -lz
427 1.1 christos #LIBS_p += -lbfd -liberty -lz
428 1.1 christos #LIBS_c += -lbfd -liberty -lz
429 1.2 roy
430 1.2 roy # wpa_supplicant depends on strong random number generation being available
431 1.2 roy # from the operating system. os_get_random() function is used to fetch random
432 1.2 roy # data when needed, e.g., for key generation. On Linux and BSD systems, this
433 1.2 roy # works by reading /dev/urandom. It should be noted that the OS entropy pool
434 1.2 roy # needs to be properly initialized before wpa_supplicant is started. This is
435 1.2 roy # important especially on embedded devices that do not have a hardware random
436 1.2 roy # number generator and may by default start up with minimal entropy available
437 1.2 roy # for random number generation.
438 1.2 roy #
439 1.2 roy # As a safety net, wpa_supplicant is by default trying to internally collect
440 1.2 roy # additional entropy for generating random data to mix in with the data fetched
441 1.2 roy # from the OS. This by itself is not considered to be very strong, but it may
442 1.2 roy # help in cases where the system pool is not initialized properly. However, it
443 1.2 roy # is very strongly recommended that the system pool is initialized with enough
444 1.2 roy # entropy either by using hardware assisted random number generator or by
445 1.2 roy # storing state over device reboots.
446 1.2 roy #
447 1.2 roy # wpa_supplicant can be configured to maintain its own entropy store over
448 1.2 roy # restarts to enhance random number generation. This is not perfect, but it is
449 1.2 roy # much more secure than using the same sequence of random numbers after every
450 1.2 roy # reboot. This can be enabled with -e<entropy file> command line option. The
451 1.2 roy # specified file needs to be readable and writable by wpa_supplicant.
452 1.2 roy #
453 1.2 roy # If the os_get_random() is known to provide strong random data (e.g., on
454 1.2 roy # Linux/BSD, the board in question is known to have reliable source of random
455 1.2 roy # data from /dev/urandom), the internal wpa_supplicant random pool can be
456 1.2 roy # disabled. This will save some in binary size and CPU use. However, this
457 1.2 roy # should only be considered for builds that are known to be used on devices
458 1.2 roy # that meet the requirements described above.
459 1.2 roy #CONFIG_NO_RANDOM_POOL=y
460 1.2 roy
461 1.2 roy # IEEE 802.11n (High Throughput) support (mainly for AP mode)
462 1.2 roy #CONFIG_IEEE80211N=y
463 1.2 roy
464 1.2 roy # IEEE 802.11ac (Very High Throughput) support (mainly for AP mode)
465 1.2 roy # (depends on CONFIG_IEEE80211N)
466 1.2 roy #CONFIG_IEEE80211AC=y
467 1.2 roy
468 1.2 roy # Wireless Network Management (IEEE Std 802.11v-2011)
469 1.2 roy # Note: This is experimental and not complete implementation.
470 1.2 roy #CONFIG_WNM=y
471 1.2 roy
472 1.2 roy # Interworking (IEEE 802.11u)
473 1.2 roy # This can be used to enable functionality to improve interworking with
474 1.2 roy # external networks (GAS/ANQP to learn more about the networks and network
475 1.2 roy # selection based on available credentials).
476 1.2 roy #CONFIG_INTERWORKING=y
477 1.2 roy
478 1.2 roy # Hotspot 2.0
479 1.2 roy #CONFIG_HS20=y
480 1.2 roy
481 1.2 roy # Enable interface matching in wpa_supplicant
482 1.2 roy #CONFIG_MATCH_IFACE=y
483 1.2 roy
484 1.2 roy # Disable roaming in wpa_supplicant
485 1.2 roy #CONFIG_NO_ROAMING=y
486 1.2 roy
487 1.2 roy # AP mode operations with wpa_supplicant
488 1.2 roy # This can be used for controlling AP mode operations with wpa_supplicant. It
489 1.2 roy # should be noted that this is mainly aimed at simple cases like
490 1.2 roy # WPA2-Personal while more complex configurations like WPA2-Enterprise with an
491 1.2 roy # external RADIUS server can be supported with hostapd.
492 1.2 roy #CONFIG_AP=y
493 1.2 roy
494 1.2 roy # P2P (Wi-Fi Direct)
495 1.2 roy # This can be used to enable P2P support in wpa_supplicant. See README-P2P for
496 1.2 roy # more information on P2P operations.
497 1.2 roy #CONFIG_P2P=y
498 1.2 roy
499 1.2 roy # Enable TDLS support
500 1.2 roy #CONFIG_TDLS=y
501 1.2 roy
502 1.2 roy # Wi-Fi Direct
503 1.2 roy # This can be used to enable Wi-Fi Direct extensions for P2P using an external
504 1.2 roy # program to control the additional information exchanges in the messages.
505 1.2 roy #CONFIG_WIFI_DISPLAY=y
506 1.2 roy
507 1.2 roy # Autoscan
508 1.2 roy # This can be used to enable automatic scan support in wpa_supplicant.
509 1.2 roy # See wpa_supplicant.conf for more information on autoscan usage.
510 1.2 roy #
511 1.2 roy # Enabling directly a module will enable autoscan support.
512 1.2 roy # For exponential module:
513 1.2 roy #CONFIG_AUTOSCAN_EXPONENTIAL=y
514 1.2 roy # For periodic module:
515 1.2 roy #CONFIG_AUTOSCAN_PERIODIC=y
516 1.2 roy
517 1.2 roy # Password (and passphrase, etc.) backend for external storage
518 1.2 roy # These optional mechanisms can be used to add support for storing passwords
519 1.2 roy # and other secrets in external (to wpa_supplicant) location. This allows, for
520 1.2 roy # example, operating system specific key storage to be used
521 1.2 roy #
522 1.2 roy # External password backend for testing purposes (developer use)
523 1.2 roy #CONFIG_EXT_PASSWORD_TEST=y
524 1.3 christos
525 1.3 christos # Enable Fast Session Transfer (FST)
526 1.3 christos #CONFIG_FST=y
527 1.3 christos
528 1.3 christos # Enable CLI commands for FST testing
529 1.3 christos #CONFIG_FST_TEST=y
530 1.3 christos
531 1.3 christos # OS X builds. This is only for building eapol_test.
532 1.3 christos #CONFIG_OSX=y
533 1.3 christos
534 1.3 christos # Automatic Channel Selection
535 1.3 christos # This will allow wpa_supplicant to pick the channel automatically when channel
536 1.3 christos # is set to "0".
537 1.3 christos #
538 1.3 christos # TODO: Extend parser to be able to parse "channel=acs_survey" as an alternative
539 1.3 christos # to "channel=0". This would enable us to eventually add other ACS algorithms in
540 1.3 christos # similar way.
541 1.3 christos #
542 1.3 christos # Automatic selection is currently only done through initialization, later on
543 1.3 christos # we hope to do background checks to keep us moving to more ideal channels as
544 1.3 christos # time goes by. ACS is currently only supported through the nl80211 driver and
545 1.3 christos # your driver must have survey dump capability that is filled by the driver
546 1.3 christos # during scanning.
547 1.3 christos #
548 1.3 christos # TODO: In analogy to hostapd be able to customize the ACS survey algorithm with
549 1.3 christos # a newly to create wpa_supplicant.conf variable acs_num_scans.
550 1.3 christos #
551 1.3 christos # Supported ACS drivers:
552 1.3 christos # * ath9k
553 1.3 christos # * ath5k
554 1.3 christos # * ath10k
555 1.3 christos #
556 1.3 christos # For more details refer to:
557 1.3 christos # http://wireless.kernel.org/en/users/Documentation/acs
558 1.3 christos #CONFIG_ACS=y
559 1.3 christos
560 1.3 christos # Support Multi Band Operation
561 1.3 christos #CONFIG_MBO=y
562 1.3.12.1 pgoyette
563 1.3.12.1 pgoyette # Fast Initial Link Setup (FILS) (IEEE 802.11ai)
564 1.3.12.1 pgoyette # Note: This is an experimental and not yet complete implementation. This
565 1.3.12.1 pgoyette # should not be enabled for production use.
566 1.3.12.1 pgoyette #CONFIG_FILS=y
567 1.3.12.1 pgoyette # FILS shared key authentication with PFS
568 1.3.12.1 pgoyette #CONFIG_FILS_SK_PFS=y
569 1.3.12.1 pgoyette
570 1.3.12.1 pgoyette # Support RSN on IBSS networks
571 1.3.12.1 pgoyette # This is needed to be able to use mode=1 network profile with proto=RSN and
572 1.3.12.1 pgoyette # key_mgmt=WPA-PSK (i.e., full key management instead of WPA-None).
573 1.3.12.1 pgoyette #CONFIG_IBSS_RSN=y
574 1.3.12.1 pgoyette
575 1.3.12.1 pgoyette # External PMKSA cache control
576 1.3.12.1 pgoyette # This can be used to enable control interface commands that allow the current
577 1.3.12.1 pgoyette # PMKSA cache entries to be fetched and new entries to be added.
578 1.3.12.1 pgoyette #CONFIG_PMKSA_CACHE_EXTERNAL=y
579 1.3.12.1 pgoyette
580 1.3.12.1 pgoyette # Mesh Networking (IEEE 802.11s)
581 1.3.12.1 pgoyette #CONFIG_MESH=y
582 1.3.12.1 pgoyette
583 1.3.12.1 pgoyette # Background scanning modules
584 1.3.12.1 pgoyette # These can be used to request wpa_supplicant to perform background scanning
585 1.3.12.1 pgoyette # operations for roaming within an ESS (same SSID). See the bgscan parameter in
586 1.3.12.1 pgoyette # the wpa_supplicant.conf file for more details.
587 1.3.12.1 pgoyette # Periodic background scans based on signal strength
588 1.3.12.1 pgoyette #CONFIG_BGSCAN_SIMPLE=y
589 1.3.12.1 pgoyette # Learn channels used by the network and try to avoid bgscans on other
590 1.3.12.1 pgoyette # channels (experimental)
591 1.3.12.1 pgoyette #CONFIG_BGSCAN_LEARN=y
592 1.3.12.1 pgoyette
593 1.3.12.1 pgoyette # Opportunistic Wireless Encryption (OWE)
594 1.3.12.1 pgoyette # Experimental implementation of draft-harkins-owe-07.txt
595 1.3.12.1 pgoyette #CONFIG_OWE=y
596