blob: 0c8e5f21b4022ce56d342f29cd918b91bd7990f9 [file] [log] [blame]
Dmitry Shmidt8d520ff2011-05-09 14:06:53 -07001# Example wpa_supplicant build time configuration
2#
3# This file lists the configuration options that are used when building the
4# hostapd binary. All lines starting with # are ignored. Configuration option
5# lines must be commented out complete, if they are not to be included, i.e.,
6# just setting VARIABLE=n is not disabling that variable.
7#
8# This file is included in Makefile, so variables like CFLAGS and LIBS can also
9# be modified from here. In most cases, these lines should use += in order not
10# to override previous values of the variables.
11
12
13# Uncomment following two lines and fix the paths if you have installed OpenSSL
14# or GnuTLS in non-default location
15#CFLAGS += -I/usr/local/openssl/include
16#LIBS += -L/usr/local/openssl/lib
17
18# Some Red Hat versions seem to include kerberos header files from OpenSSL, but
19# the kerberos files are not in the default include path. Following line can be
20# used to fix build issues on such systems (krb5.h not found).
21#CFLAGS += -I/usr/include/kerberos
22
23# Example configuration for various cross-compilation platforms
24
25#### sveasoft (e.g., for Linksys WRT54G) ######################################
26#CC=mipsel-uclibc-gcc
27#CC=/opt/brcm/hndtools-mipsel-uclibc/bin/mipsel-uclibc-gcc
28#CFLAGS += -Os
29#CPPFLAGS += -I../src/include -I../../src/router/openssl/include
30#LIBS += -L/opt/brcm/hndtools-mipsel-uclibc-0.9.19/lib -lssl
31###############################################################################
32
33#### openwrt (e.g., for Linksys WRT54G) #######################################
34#CC=mipsel-uclibc-gcc
35#CC=/opt/brcm/hndtools-mipsel-uclibc/bin/mipsel-uclibc-gcc
36#CFLAGS += -Os
37#CPPFLAGS=-I../src/include -I../openssl-0.9.7d/include \
38# -I../WRT54GS/release/src/include
39#LIBS = -lssl
40###############################################################################
41
42
43# Driver interface for Host AP driver
44CONFIG_DRIVER_HOSTAP=y
45
46# Driver interface for Agere driver
47#CONFIG_DRIVER_HERMES=y
48# Change include directories to match with the local setup
49#CFLAGS += -I../../hcf -I../../include -I../../include/hcf
50#CFLAGS += -I../../include/wireless
51
52# Driver interface for madwifi driver
53# Deprecated; use CONFIG_DRIVER_WEXT=y instead.
54#CONFIG_DRIVER_MADWIFI=y
55# Set include directory to the madwifi source tree
56#CFLAGS += -I../../madwifi
57
58# Driver interface for ndiswrapper
59# Deprecated; use CONFIG_DRIVER_WEXT=y instead.
60#CONFIG_DRIVER_NDISWRAPPER=y
61
62# Driver interface for Atmel driver
63CONFIG_DRIVER_ATMEL=y
64
65# Driver interface for old Broadcom driver
66# Please note that the newer Broadcom driver ("hybrid Linux driver") supports
67# Linux wireless extensions and does not need (or even work) with the old
68# driver wrapper. Use CONFIG_DRIVER_WEXT=y with that driver.
69#CONFIG_DRIVER_BROADCOM=y
70# Example path for wlioctl.h; change to match your configuration
71#CFLAGS += -I/opt/WRT54GS/release/src/include
72
73# Driver interface for Intel ipw2100/2200 driver
74# Deprecated; use CONFIG_DRIVER_WEXT=y instead.
75#CONFIG_DRIVER_IPW=y
76
77# Driver interface for Ralink driver
78#CONFIG_DRIVER_RALINK=y
79
80# Driver interface for generic Linux wireless extensions
81# Note: WEXT is deprecated in the current Linux kernel version and no new
82# functionality is added to it. nl80211-based interface is the new
83# replacement for WEXT and its use allows wpa_supplicant to properly control
84# the driver to improve existing functionality like roaming and to support new
85# functionality.
86CONFIG_DRIVER_WEXT=y
87
88# Driver interface for Linux drivers using the nl80211 kernel interface
89CONFIG_DRIVER_NL80211=y
90
91# Driver interface for FreeBSD net80211 layer (e.g., Atheros driver)
92#CONFIG_DRIVER_BSD=y
93#CFLAGS += -I/usr/local/include
94#LIBS += -L/usr/local/lib
95#LIBS_p += -L/usr/local/lib
96#LIBS_c += -L/usr/local/lib
97
98# Driver interface for Windows NDIS
99#CONFIG_DRIVER_NDIS=y
100#CFLAGS += -I/usr/include/w32api/ddk
101#LIBS += -L/usr/local/lib
102# For native build using mingw
103#CONFIG_NATIVE_WINDOWS=y
104# Additional directories for cross-compilation on Linux host for mingw target
105#CFLAGS += -I/opt/mingw/mingw32/include/ddk
106#LIBS += -L/opt/mingw/mingw32/lib
107#CC=mingw32-gcc
108# By default, driver_ndis uses WinPcap for low-level operations. This can be
109# replaced with the following option which replaces WinPcap calls with NDISUIO.
110# However, this requires that WZC is disabled (net stop wzcsvc) before starting
111# wpa_supplicant.
112# CONFIG_USE_NDISUIO=y
113
114# Driver interface for development testing
115#CONFIG_DRIVER_TEST=y
116
117# Include client MLME (management frame processing) for test driver
118# This can be used to test MLME operations in hostapd with the test interface.
119# space.
120#CONFIG_CLIENT_MLME=y
121
122# Driver interface for wired Ethernet drivers
123CONFIG_DRIVER_WIRED=y
124
125# Driver interface for the Broadcom RoboSwitch family
126#CONFIG_DRIVER_ROBOSWITCH=y
127
128# Driver interface for no driver (e.g., WPS ER only)
129#CONFIG_DRIVER_NONE=y
130
131# Solaris libraries
132#LIBS += -lsocket -ldlpi -lnsl
133#LIBS_c += -lsocket
134
135# Enable IEEE 802.1X Supplicant (automatically included if any EAP method is
136# included)
137CONFIG_IEEE8021X_EAPOL=y
138
139# EAP-MD5
140CONFIG_EAP_MD5=y
141
142# EAP-MSCHAPv2
143CONFIG_EAP_MSCHAPV2=y
144
145# EAP-TLS
146CONFIG_EAP_TLS=y
147
148# EAL-PEAP
149CONFIG_EAP_PEAP=y
150
151# EAP-TTLS
152CONFIG_EAP_TTLS=y
153
154# EAP-FAST
155# Note: Default OpenSSL package does not include support for all the
156# functionality needed for EAP-FAST. If EAP-FAST is enabled with OpenSSL,
157# the OpenSSL library must be patched (openssl-0.9.8d-tls-extensions.patch)
158# to add the needed functions.
159#CONFIG_EAP_FAST=y
160
161# EAP-GTC
162CONFIG_EAP_GTC=y
163
164# EAP-OTP
165CONFIG_EAP_OTP=y
166
167# EAP-SIM (enable CONFIG_PCSC, if EAP-SIM is used)
168#CONFIG_EAP_SIM=y
169
170# EAP-PSK (experimental; this is _not_ needed for WPA-PSK)
171#CONFIG_EAP_PSK=y
172
173# EAP-PAX
174#CONFIG_EAP_PAX=y
175
176# LEAP
177CONFIG_EAP_LEAP=y
178
179# EAP-AKA (enable CONFIG_PCSC, if EAP-AKA is used)
180#CONFIG_EAP_AKA=y
181
182# EAP-AKA' (enable CONFIG_PCSC, if EAP-AKA' is used).
183# This requires CONFIG_EAP_AKA to be enabled, too.
184#CONFIG_EAP_AKA_PRIME=y
185
186# Enable USIM simulator (Milenage) for EAP-AKA
187#CONFIG_USIM_SIMULATOR=y
188
189# EAP-SAKE
190#CONFIG_EAP_SAKE=y
191
192# EAP-GPSK
193#CONFIG_EAP_GPSK=y
194# Include support for optional SHA256 cipher suite in EAP-GPSK
195#CONFIG_EAP_GPSK_SHA256=y
196
197# EAP-TNC and related Trusted Network Connect support (experimental)
198#CONFIG_EAP_TNC=y
199
200# Wi-Fi Protected Setup (WPS)
201#CONFIG_WPS=y
202# Enable WSC 2.0 support
203#CONFIG_WPS2=y
204
205# EAP-IKEv2
206#CONFIG_EAP_IKEV2=y
207
208# PKCS#12 (PFX) support (used to read private key and certificate file from
209# a file that usually has extension .p12 or .pfx)
210CONFIG_PKCS12=y
211
212# Smartcard support (i.e., private key on a smartcard), e.g., with openssl
213# engine.
214CONFIG_SMARTCARD=y
215
216# PC/SC interface for smartcards (USIM, GSM SIM)
217# Enable this if EAP-SIM or EAP-AKA is included
218#CONFIG_PCSC=y
219
220# Development testing
221#CONFIG_EAPOL_TEST=y
222
223# Select control interface backend for external programs, e.g, wpa_cli:
224# unix = UNIX domain sockets (default for Linux/*BSD)
225# udp = UDP sockets using localhost (127.0.0.1)
226# named_pipe = Windows Named Pipe (default for Windows)
227# y = use default (backwards compatibility)
228# If this option is commented out, control interface is not included in the
229# build.
230CONFIG_CTRL_IFACE=y
231
232# Include support for GNU Readline and History Libraries in wpa_cli.
233# When building a wpa_cli binary for distribution, please note that these
234# libraries are licensed under GPL and as such, BSD license may not apply for
235# the resulting binary.
236#CONFIG_READLINE=y
237
238# Include internal line edit mode in wpa_cli. This can be used as a replacement
239# for GNU Readline to provide limited command line editing and history support.
240#CONFIG_WPA_CLI_EDIT=y
241
242# Remove debugging code that is printing out debug message to stdout.
243# This can be used to reduce the size of the wpa_supplicant considerably
244# if debugging code is not needed. The size reduction can be around 35%
245# (e.g., 90 kB).
246#CONFIG_NO_STDOUT_DEBUG=y
247
248# Remove WPA support, e.g., for wired-only IEEE 802.1X supplicant, to save
249# 35-50 kB in code size.
250#CONFIG_NO_WPA=y
251
252# Remove WPA2 support. This allows WPA to be used, but removes WPA2 code to
253# save about 1 kB in code size when building only WPA-Personal (no EAP support)
254# or 6 kB if building for WPA-Enterprise.
255#CONFIG_NO_WPA2=y
256
257# Remove IEEE 802.11i/WPA-Personal ASCII passphrase support
258# This option can be used to reduce code size by removing support for
259# converting ASCII passphrases into PSK. If this functionality is removed, the
260# PSK can only be configured as the 64-octet hexstring (e.g., from
261# wpa_passphrase). This saves about 0.5 kB in code size.
262#CONFIG_NO_WPA_PASSPHRASE=y
263
264# Disable scan result processing (ap_mode=1) to save code size by about 1 kB.
265# This can be used if ap_scan=1 mode is never enabled.
266#CONFIG_NO_SCAN_PROCESSING=y
267
268# Select configuration backend:
269# file = text file (e.g., wpa_supplicant.conf; note: the configuration file
270# path is given on command line, not here; this option is just used to
271# select the backend that allows configuration files to be used)
272# winreg = Windows registry (see win_example.reg for an example)
273CONFIG_BACKEND=file
274
275# Remove configuration write functionality (i.e., to allow the configuration
276# file to be updated based on runtime configuration changes). The runtime
277# configuration can still be changed, the changes are just not going to be
278# persistent over restarts. This option can be used to reduce code size by
279# about 3.5 kB.
280#CONFIG_NO_CONFIG_WRITE=y
281
282# Remove support for configuration blobs to reduce code size by about 1.5 kB.
283#CONFIG_NO_CONFIG_BLOBS=y
284
285# Select program entry point implementation:
286# main = UNIX/POSIX like main() function (default)
287# main_winsvc = Windows service (read parameters from registry)
288# main_none = Very basic example (development use only)
289#CONFIG_MAIN=main
290
291# Select wrapper for operatins system and C library specific functions
292# unix = UNIX/POSIX like systems (default)
293# win32 = Windows systems
294# none = Empty template
295#CONFIG_OS=unix
296
297# Select event loop implementation
298# eloop = select() loop (default)
299# eloop_win = Windows events and WaitForMultipleObject() loop
300# eloop_none = Empty template
301#CONFIG_ELOOP=eloop
302
303# Select layer 2 packet implementation
304# linux = Linux packet socket (default)
305# pcap = libpcap/libdnet/WinPcap
306# freebsd = FreeBSD libpcap
307# winpcap = WinPcap with receive thread
308# ndis = Windows NDISUIO (note: requires CONFIG_USE_NDISUIO=y)
309# none = Empty template
310#CONFIG_L2_PACKET=linux
311
312# PeerKey handshake for Station to Station Link (IEEE 802.11e DLS)
313CONFIG_PEERKEY=y
314
315# IEEE 802.11w (management frame protection)
316# This version is an experimental implementation based on IEEE 802.11w/D1.0
317# draft and is subject to change since the standard has not yet been finalized.
318# Driver support is also needed for IEEE 802.11w.
319#CONFIG_IEEE80211W=y
320
321# Select TLS implementation
322# openssl = OpenSSL (default)
323# gnutls = GnuTLS (needed for TLS/IA, see also CONFIG_GNUTLS_EXTRA)
324# internal = Internal TLSv1 implementation (experimental)
325# none = Empty template
326#CONFIG_TLS=openssl
327
328# Whether to enable TLS/IA support, which is required for EAP-TTLSv1.
329# You need CONFIG_TLS=gnutls for this to have any effect. Please note that
330# even though the core GnuTLS library is released under LGPL, this extra
331# library uses GPL and as such, the terms of GPL apply to the combination
332# of wpa_supplicant and GnuTLS if this option is enabled. BSD license may not
333# apply for distribution of the resulting binary.
334#CONFIG_GNUTLS_EXTRA=y
335
336# If CONFIG_TLS=internal is used, additional library and include paths are
337# needed for LibTomMath. Alternatively, an integrated, minimal version of
338# LibTomMath can be used. See beginning of libtommath.c for details on benefits
339# and drawbacks of this option.
340#CONFIG_INTERNAL_LIBTOMMATH=y
341#ifndef CONFIG_INTERNAL_LIBTOMMATH
342#LTM_PATH=/usr/src/libtommath-0.39
343#CFLAGS += -I$(LTM_PATH)
344#LIBS += -L$(LTM_PATH)
345#LIBS_p += -L$(LTM_PATH)
346#endif
347# At the cost of about 4 kB of additional binary size, the internal LibTomMath
348# can be configured to include faster routines for exptmod, sqr, and div to
349# speed up DH and RSA calculation considerably
350#CONFIG_INTERNAL_LIBTOMMATH_FAST=y
351
352# Include NDIS event processing through WMI into wpa_supplicant/wpasvc.
353# This is only for Windows builds and requires WMI-related header files and
354# WbemUuid.Lib from Platform SDK even when building with MinGW.
355#CONFIG_NDIS_EVENTS_INTEGRATED=y
356#PLATFORMSDKLIB="/opt/Program Files/Microsoft Platform SDK/Lib"
357
358# Add support for old DBus control interface
359# (fi.epitest.hostap.WPASupplicant)
360#CONFIG_CTRL_IFACE_DBUS=y
361
362# Add support for new DBus control interface
363# (fi.w1.hostap.wpa_supplicant1)
364#CONFIG_CTRL_IFACE_DBUS_NEW=y
365
366# Add introspection support for new DBus control interface
367#CONFIG_CTRL_IFACE_DBUS_INTRO=y
368
369# Add support for loading EAP methods dynamically as shared libraries.
370# When this option is enabled, each EAP method can be either included
371# statically (CONFIG_EAP_<method>=y) or dynamically (CONFIG_EAP_<method>=dyn).
372# Dynamic EAP methods are build as shared objects (eap_*.so) and they need to
373# be loaded in the beginning of the wpa_supplicant configuration file
374# (see load_dynamic_eap parameter in the example file) before being used in
375# the network blocks.
376#
377# Note that some shared parts of EAP methods are included in the main program
378# and in order to be able to use dynamic EAP methods using these parts, the
379# main program must have been build with the EAP method enabled (=y or =dyn).
380# This means that EAP-TLS/PEAP/TTLS/FAST cannot be added as dynamic libraries
381# unless at least one of them was included in the main build to force inclusion
382# of the shared code. Similarly, at least one of EAP-SIM/AKA must be included
383# in the main build to be able to load these methods dynamically.
384#
385# Please also note that using dynamic libraries will increase the total binary
386# size. Thus, it may not be the best option for targets that have limited
387# amount of memory/flash.
388#CONFIG_DYNAMIC_EAP_METHODS=y
389
390# IEEE Std 802.11r-2008 (Fast BSS Transition)
391#CONFIG_IEEE80211R=y
392
393# Add support for writing debug log to a file (/tmp/wpa_supplicant-log-#.txt)
394#CONFIG_DEBUG_FILE=y
395
396# Send debug messages to syslog instead of stdout
397#CONFIG_DEBUG_SYSLOG=y
398# Set syslog facility for debug messages
399#CONFIG_DEBUG_SYSLOG_FACILITY=LOG_DAEMON
400
401# Enable privilege separation (see README 'Privilege separation' for details)
402#CONFIG_PRIVSEP=y
403
404# Enable mitigation against certain attacks against TKIP by delaying Michael
405# MIC error reports by a random amount of time between 0 and 60 seconds
406#CONFIG_DELAYED_MIC_ERROR_REPORT=y
407
408# Enable tracing code for developer debugging
409# This tracks use of memory allocations and other registrations and reports
410# incorrect use with a backtrace of call (or allocation) location.
411#CONFIG_WPA_TRACE=y
412# For BSD, comment out these.
413#LIBS += -lexecinfo
414#LIBS_p += -lexecinfo
415#LIBS_c += -lexecinfo
416
417# Use libbfd to get more details for developer debugging
418# This enables use of libbfd to get more detailed symbols for the backtraces
419# generated by CONFIG_WPA_TRACE=y.
420#CONFIG_WPA_TRACE_BFD=y
421# For BSD, comment out these.
422#LIBS += -lbfd -liberty -lz
423#LIBS_p += -lbfd -liberty -lz
424#LIBS_c += -lbfd -liberty -lz
425
426# wpa_supplicant depends on strong random number generation being available
427# from the operating system. os_get_random() function is used to fetch random
428# data when needed, e.g., for key generation. On Linux and BSD systems, this
429# works by reading /dev/urandom. It should be noted that the OS entropy pool
430# needs to be properly initialized before wpa_supplicant is started. This is
431# important especially on embedded devices that do not have a hardware random
432# number generator and may by default start up with minimal entropy available
433# for random number generation.
434#
435# As a safety net, wpa_supplicant is by default trying to internally collect
436# additional entropy for generating random data to mix in with the data fetched
437# from the OS. This by itself is not considered to be very strong, but it may
438# help in cases where the system pool is not initialized properly. However, it
439# is very strongly recommended that the system pool is initialized with enough
440# entropy either by using hardware assisted random number generatior or by
441# storing state over device reboots.
442#
443# If the os_get_random() is known to provide strong ramdom data (e.g., on
444# Linux/BSD, the board in question is known to have reliable source of random
445# data from /dev/urandom), the internal wpa_supplicant random pool can be
446# disabled. This will save some in binary size and CPU use. However, this
447# should only be considered for builds that are known to be used on devices
448# that meet the requirements described above.
449#CONFIG_NO_RANDOM_POOL=y