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