Home | History | Annotate | Line # | Download | only in wpa_supplicant
defconfig revision 1.5.8.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.4  christos # wpa_supplicant binary. All lines starting with # are ignored. Configuration
      5      1.4  christos # option lines must be commented out complete, if they are not to be included,
      6      1.4  christos # 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.4  christos 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.4  christos # Driver interface for MACsec capable Qualcomm Atheros drivers
     77      1.4  christos #CONFIG_DRIVER_MACSEC_QCA=y
     78      1.4  christos 
     79      1.4  christos # Driver interface for Linux MACsec drivers
     80  1.5.8.1  perseant CONFIG_DRIVER_MACSEC_LINUX=y
     81      1.4  christos 
     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.4  christos # Enable IEEE 802.1X Supplicant (automatically included if any EAP method or
     93      1.4  christos # 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.5.8.1  perseant # Enable EAP-TLSv1.3 support by default (currently disabled unless explicitly
    105  1.5.8.1  perseant # enabled in network configuration)
    106  1.5.8.1  perseant #CONFIG_EAP_TLSV1_3=y
    107      1.1  christos 
    108      1.1  christos # EAL-PEAP
    109      1.1  christos CONFIG_EAP_PEAP=y
    110      1.1  christos 
    111      1.1  christos # EAP-TTLS
    112      1.1  christos CONFIG_EAP_TTLS=y
    113      1.1  christos 
    114      1.1  christos # EAP-FAST
    115      1.5  christos CONFIG_EAP_FAST=y
    116      1.5  christos 
    117      1.5  christos # EAP-TEAP
    118      1.5  christos # Note: The current EAP-TEAP implementation is experimental and should not be
    119      1.5  christos # enabled for production use. The IETF RFC 7170 that defines EAP-TEAP has number
    120      1.5  christos # of conflicting statements and missing details and the implementation has
    121      1.5  christos # vendor specific workarounds for those and as such, may not interoperate with
    122      1.5  christos # any other implementation. This should not be used for anything else than
    123      1.5  christos # experimentation and interoperability testing until those issues has been
    124      1.5  christos # resolved.
    125      1.5  christos #CONFIG_EAP_TEAP=y
    126      1.1  christos 
    127      1.1  christos # EAP-GTC
    128      1.1  christos CONFIG_EAP_GTC=y
    129      1.1  christos 
    130      1.1  christos # EAP-OTP
    131      1.1  christos CONFIG_EAP_OTP=y
    132      1.1  christos 
    133      1.1  christos # EAP-SIM (enable CONFIG_PCSC, if EAP-SIM is used)
    134      1.1  christos #CONFIG_EAP_SIM=y
    135      1.1  christos 
    136      1.5  christos # Enable SIM simulator (Milenage) for EAP-SIM
    137      1.5  christos #CONFIG_SIM_SIMULATOR=y
    138      1.5  christos 
    139      1.1  christos # EAP-PSK (experimental; this is _not_ needed for WPA-PSK)
    140      1.1  christos #CONFIG_EAP_PSK=y
    141      1.1  christos 
    142      1.2       roy # EAP-pwd (secure authentication using only a password)
    143      1.5  christos CONFIG_EAP_PWD=y
    144      1.2       roy 
    145      1.1  christos # EAP-PAX
    146      1.5  christos CONFIG_EAP_PAX=y
    147      1.1  christos 
    148      1.1  christos # LEAP
    149      1.1  christos CONFIG_EAP_LEAP=y
    150      1.1  christos 
    151      1.1  christos # EAP-AKA (enable CONFIG_PCSC, if EAP-AKA is used)
    152      1.1  christos #CONFIG_EAP_AKA=y
    153      1.1  christos 
    154      1.1  christos # EAP-AKA' (enable CONFIG_PCSC, if EAP-AKA' is used).
    155      1.1  christos # This requires CONFIG_EAP_AKA to be enabled, too.
    156      1.1  christos #CONFIG_EAP_AKA_PRIME=y
    157      1.1  christos 
    158      1.1  christos # Enable USIM simulator (Milenage) for EAP-AKA
    159      1.1  christos #CONFIG_USIM_SIMULATOR=y
    160      1.1  christos 
    161      1.1  christos # EAP-SAKE
    162      1.5  christos CONFIG_EAP_SAKE=y
    163      1.1  christos 
    164      1.1  christos # EAP-GPSK
    165      1.5  christos CONFIG_EAP_GPSK=y
    166      1.1  christos # Include support for optional SHA256 cipher suite in EAP-GPSK
    167      1.5  christos CONFIG_EAP_GPSK_SHA256=y
    168      1.1  christos 
    169      1.1  christos # EAP-TNC and related Trusted Network Connect support (experimental)
    170      1.5  christos CONFIG_EAP_TNC=y
    171      1.1  christos 
    172      1.1  christos # Wi-Fi Protected Setup (WPS)
    173      1.5  christos CONFIG_WPS=y
    174      1.2       roy # Enable WPS external registrar functionality
    175      1.2       roy #CONFIG_WPS_ER=y
    176      1.2       roy # Disable credentials for an open network by default when acting as a WPS
    177      1.2       roy # registrar.
    178      1.2       roy #CONFIG_WPS_REG_DISABLE_OPEN=y
    179      1.2       roy # Enable WPS support with NFC config method
    180      1.2       roy #CONFIG_WPS_NFC=y
    181      1.1  christos 
    182      1.1  christos # EAP-IKEv2
    183      1.5  christos CONFIG_EAP_IKEV2=y
    184      1.1  christos 
    185      1.2       roy # EAP-EKE
    186      1.2       roy #CONFIG_EAP_EKE=y
    187      1.2       roy 
    188      1.4  christos # MACsec
    189  1.5.8.1  perseant CONFIG_MACSEC=y
    190      1.4  christos 
    191      1.1  christos # PKCS#12 (PFX) support (used to read private key and certificate file from
    192      1.1  christos # a file that usually has extension .p12 or .pfx)
    193      1.1  christos CONFIG_PKCS12=y
    194      1.1  christos 
    195      1.1  christos # Smartcard support (i.e., private key on a smartcard), e.g., with openssl
    196      1.1  christos # engine.
    197      1.1  christos CONFIG_SMARTCARD=y
    198      1.1  christos 
    199      1.1  christos # PC/SC interface for smartcards (USIM, GSM SIM)
    200      1.1  christos # Enable this if EAP-SIM or EAP-AKA is included
    201      1.1  christos #CONFIG_PCSC=y
    202      1.1  christos 
    203      1.2       roy # Support HT overrides (disable HT/HT40, mask MCS rates, etc.)
    204      1.2       roy #CONFIG_HT_OVERRIDES=y
    205      1.2       roy 
    206      1.2       roy # Support VHT overrides (disable VHT, mask MCS rates, etc.)
    207      1.2       roy #CONFIG_VHT_OVERRIDES=y
    208      1.2       roy 
    209  1.5.8.1  perseant # Support HE overrides
    210  1.5.8.1  perseant #CONFIG_HE_OVERRIDES=y
    211  1.5.8.1  perseant 
    212      1.1  christos # Development testing
    213      1.1  christos #CONFIG_EAPOL_TEST=y
    214      1.1  christos 
    215  1.5.8.1  perseant # Support IPv6
    216  1.5.8.1  perseant CONFIG_IPV6=y
    217  1.5.8.1  perseant 
    218      1.1  christos # Select control interface backend for external programs, e.g, wpa_cli:
    219      1.1  christos # unix = UNIX domain sockets (default for Linux/*BSD)
    220      1.1  christos # udp = UDP sockets using localhost (127.0.0.1)
    221      1.2       roy # udp6 = UDP IPv6 sockets using localhost (::1)
    222      1.1  christos # named_pipe = Windows Named Pipe (default for Windows)
    223      1.2       roy # udp-remote = UDP sockets with remote access (only for tests systems/purpose)
    224      1.2       roy # udp6-remote = UDP IPv6 sockets with remote access (only for tests purpose)
    225      1.1  christos # y = use default (backwards compatibility)
    226      1.1  christos # If this option is commented out, control interface is not included in the
    227      1.1  christos # build.
    228      1.1  christos CONFIG_CTRL_IFACE=y
    229      1.1  christos 
    230      1.1  christos # Include support for GNU Readline and History Libraries in wpa_cli.
    231      1.1  christos # When building a wpa_cli binary for distribution, please note that these
    232      1.1  christos # libraries are licensed under GPL and as such, BSD license may not apply for
    233      1.1  christos # the resulting binary.
    234      1.1  christos #CONFIG_READLINE=y
    235      1.1  christos 
    236      1.2       roy # Include internal line edit mode in wpa_cli. This can be used as a replacement
    237      1.2       roy # for GNU Readline to provide limited command line editing and history support.
    238      1.2       roy #CONFIG_WPA_CLI_EDIT=y
    239      1.2       roy 
    240      1.1  christos # Remove debugging code that is printing out debug message to stdout.
    241      1.1  christos # This can be used to reduce the size of the wpa_supplicant considerably
    242      1.1  christos # if debugging code is not needed. The size reduction can be around 35%
    243      1.1  christos # (e.g., 90 kB).
    244      1.1  christos #CONFIG_NO_STDOUT_DEBUG=y
    245      1.1  christos 
    246      1.1  christos # Remove WPA support, e.g., for wired-only IEEE 802.1X supplicant, to save
    247      1.1  christos # 35-50 kB in code size.
    248      1.1  christos #CONFIG_NO_WPA=y
    249      1.1  christos 
    250      1.1  christos # Remove IEEE 802.11i/WPA-Personal ASCII passphrase support
    251      1.1  christos # This option can be used to reduce code size by removing support for
    252      1.1  christos # converting ASCII passphrases into PSK. If this functionality is removed, the
    253      1.1  christos # PSK can only be configured as the 64-octet hexstring (e.g., from
    254      1.1  christos # wpa_passphrase). This saves about 0.5 kB in code size.
    255      1.1  christos #CONFIG_NO_WPA_PASSPHRASE=y
    256      1.1  christos 
    257      1.5  christos # Simultaneous Authentication of Equals (SAE), WPA3-Personal
    258      1.5  christos CONFIG_SAE=y
    259      1.5  christos 
    260  1.5.8.1  perseant # SAE Public Key, WPA3-Personal
    261  1.5.8.1  perseant #CONFIG_SAE_PK=y
    262  1.5.8.1  perseant 
    263  1.5.8.1  perseant # Disable scan result processing (ap_scan=1) to save code size by about 1 kB.
    264      1.1  christos # This can be used if ap_scan=1 mode is never enabled.
    265      1.1  christos #CONFIG_NO_SCAN_PROCESSING=y
    266      1.1  christos 
    267      1.1  christos # Select configuration backend:
    268      1.1  christos # file = text file (e.g., wpa_supplicant.conf; note: the configuration file
    269      1.1  christos #	path is given on command line, not here; this option is just used to
    270      1.1  christos #	select the backend that allows configuration files to be used)
    271      1.1  christos # winreg = Windows registry (see win_example.reg for an example)
    272      1.1  christos CONFIG_BACKEND=file
    273      1.1  christos 
    274      1.1  christos # Remove configuration write functionality (i.e., to allow the configuration
    275      1.1  christos # file to be updated based on runtime configuration changes). The runtime
    276      1.1  christos # configuration can still be changed, the changes are just not going to be
    277      1.1  christos # persistent over restarts. This option can be used to reduce code size by
    278      1.1  christos # about 3.5 kB.
    279      1.1  christos #CONFIG_NO_CONFIG_WRITE=y
    280      1.1  christos 
    281      1.1  christos # Remove support for configuration blobs to reduce code size by about 1.5 kB.
    282      1.1  christos #CONFIG_NO_CONFIG_BLOBS=y
    283      1.1  christos 
    284      1.1  christos # Select program entry point implementation:
    285      1.1  christos # main = UNIX/POSIX like main() function (default)
    286      1.1  christos # main_winsvc = Windows service (read parameters from registry)
    287      1.1  christos # main_none = Very basic example (development use only)
    288      1.1  christos #CONFIG_MAIN=main
    289      1.1  christos 
    290      1.2       roy # Select wrapper for operating system and C library specific functions
    291      1.1  christos # unix = UNIX/POSIX like systems (default)
    292      1.1  christos # win32 = Windows systems
    293      1.1  christos # none = Empty template
    294      1.1  christos #CONFIG_OS=unix
    295      1.1  christos 
    296      1.1  christos # Select event loop implementation
    297      1.1  christos # eloop = select() loop (default)
    298      1.1  christos # eloop_win = Windows events and WaitForMultipleObject() loop
    299      1.1  christos #CONFIG_ELOOP=eloop
    300      1.1  christos 
    301      1.2       roy # Should we use poll instead of select? Select is used by default.
    302      1.2       roy #CONFIG_ELOOP_POLL=y
    303      1.2       roy 
    304      1.2       roy # Should we use epoll instead of select? Select is used by default.
    305      1.2       roy #CONFIG_ELOOP_EPOLL=y
    306      1.2       roy 
    307      1.3  christos # Should we use kqueue instead of select? Select is used by default.
    308      1.3  christos #CONFIG_ELOOP_KQUEUE=y
    309      1.3  christos 
    310      1.1  christos # Select layer 2 packet implementation
    311      1.1  christos # linux = Linux packet socket (default)
    312      1.1  christos # pcap = libpcap/libdnet/WinPcap
    313      1.1  christos # freebsd = FreeBSD libpcap
    314      1.1  christos # winpcap = WinPcap with receive thread
    315      1.1  christos # ndis = Windows NDISUIO (note: requires CONFIG_USE_NDISUIO=y)
    316      1.1  christos # none = Empty template
    317      1.1  christos #CONFIG_L2_PACKET=linux
    318      1.1  christos 
    319      1.3  christos # Disable Linux packet socket workaround applicable for station interface
    320      1.3  christos # in a bridge for EAPOL frames. This should be uncommented only if the kernel
    321      1.3  christos # is known to not have the regression issue in packet socket behavior with
    322      1.3  christos # bridge interfaces (commit 'bridge: respect RFC2863 operational state')').
    323      1.3  christos #CONFIG_NO_LINUX_PACKET_SOCKET_WAR=y
    324      1.3  christos 
    325      1.5  christos # Support Operating Channel Validation
    326      1.5  christos #CONFIG_OCV=y
    327      1.1  christos 
    328      1.1  christos # Select TLS implementation
    329      1.1  christos # openssl = OpenSSL (default)
    330      1.2       roy # gnutls = GnuTLS
    331      1.1  christos # internal = Internal TLSv1 implementation (experimental)
    332      1.4  christos # linux = Linux kernel AF_ALG and internal TLSv1 implementation (experimental)
    333      1.1  christos # none = Empty template
    334      1.1  christos #CONFIG_TLS=openssl
    335      1.1  christos 
    336      1.2       roy # TLS-based EAP methods require at least TLS v1.0. Newer version of TLS (v1.1)
    337      1.2       roy # can be enabled to get a stronger construction of messages when block ciphers
    338      1.2       roy # are used. It should be noted that some existing TLS v1.0 -based
    339      1.2       roy # implementation may not be compatible with TLS v1.1 message (ClientHello is
    340      1.2       roy # sent prior to negotiating which version will be used)
    341      1.2       roy #CONFIG_TLSV11=y
    342      1.2       roy 
    343      1.2       roy # TLS-based EAP methods require at least TLS v1.0. Newer version of TLS (v1.2)
    344      1.2       roy # can be enabled to enable use of stronger crypto algorithms. It should be
    345      1.2       roy # noted that some existing TLS v1.0 -based implementation may not be compatible
    346      1.2       roy # with TLS v1.2 message (ClientHello is sent prior to negotiating which version
    347      1.2       roy # will be used)
    348      1.2       roy #CONFIG_TLSV12=y
    349      1.1  christos 
    350      1.4  christos # Select which ciphers to use by default with OpenSSL if the user does not
    351      1.4  christos # specify them.
    352      1.4  christos #CONFIG_TLS_DEFAULT_CIPHERS="DEFAULT:!EXP:!LOW"
    353      1.4  christos 
    354      1.1  christos # If CONFIG_TLS=internal is used, additional library and include paths are
    355      1.1  christos # needed for LibTomMath. Alternatively, an integrated, minimal version of
    356      1.1  christos # LibTomMath can be used. See beginning of libtommath.c for details on benefits
    357      1.1  christos # and drawbacks of this option.
    358      1.1  christos #CONFIG_INTERNAL_LIBTOMMATH=y
    359      1.1  christos #ifndef CONFIG_INTERNAL_LIBTOMMATH
    360      1.1  christos #LTM_PATH=/usr/src/libtommath-0.39
    361      1.1  christos #CFLAGS += -I$(LTM_PATH)
    362      1.1  christos #LIBS += -L$(LTM_PATH)
    363      1.1  christos #LIBS_p += -L$(LTM_PATH)
    364      1.1  christos #endif
    365      1.1  christos # At the cost of about 4 kB of additional binary size, the internal LibTomMath
    366      1.1  christos # can be configured to include faster routines for exptmod, sqr, and div to
    367      1.1  christos # speed up DH and RSA calculation considerably
    368      1.1  christos #CONFIG_INTERNAL_LIBTOMMATH_FAST=y
    369      1.1  christos 
    370      1.1  christos # Include NDIS event processing through WMI into wpa_supplicant/wpasvc.
    371      1.1  christos # This is only for Windows builds and requires WMI-related header files and
    372      1.1  christos # WbemUuid.Lib from Platform SDK even when building with MinGW.
    373      1.1  christos #CONFIG_NDIS_EVENTS_INTEGRATED=y
    374      1.1  christos #PLATFORMSDKLIB="/opt/Program Files/Microsoft Platform SDK/Lib"
    375      1.1  christos 
    376      1.1  christos # Add support for new DBus control interface
    377  1.5.8.1  perseant # (fi.w1.wpa_supplicant1)
    378      1.5  christos CONFIG_CTRL_IFACE_DBUS_NEW=y
    379      1.1  christos 
    380      1.1  christos # Add introspection support for new DBus control interface
    381      1.5  christos CONFIG_CTRL_IFACE_DBUS_INTRO=y
    382      1.1  christos 
    383      1.1  christos # Add support for loading EAP methods dynamically as shared libraries.
    384      1.1  christos # When this option is enabled, each EAP method can be either included
    385      1.1  christos # statically (CONFIG_EAP_<method>=y) or dynamically (CONFIG_EAP_<method>=dyn).
    386      1.1  christos # Dynamic EAP methods are build as shared objects (eap_*.so) and they need to
    387      1.1  christos # be loaded in the beginning of the wpa_supplicant configuration file
    388      1.1  christos # (see load_dynamic_eap parameter in the example file) before being used in
    389      1.1  christos # the network blocks.
    390      1.1  christos #
    391      1.1  christos # Note that some shared parts of EAP methods are included in the main program
    392      1.1  christos # and in order to be able to use dynamic EAP methods using these parts, the
    393      1.1  christos # main program must have been build with the EAP method enabled (=y or =dyn).
    394      1.1  christos # This means that EAP-TLS/PEAP/TTLS/FAST cannot be added as dynamic libraries
    395      1.1  christos # unless at least one of them was included in the main build to force inclusion
    396      1.1  christos # of the shared code. Similarly, at least one of EAP-SIM/AKA must be included
    397      1.1  christos # in the main build to be able to load these methods dynamically.
    398      1.1  christos #
    399      1.1  christos # Please also note that using dynamic libraries will increase the total binary
    400      1.1  christos # size. Thus, it may not be the best option for targets that have limited
    401      1.1  christos # amount of memory/flash.
    402      1.1  christos #CONFIG_DYNAMIC_EAP_METHODS=y
    403      1.1  christos 
    404  1.5.8.1  perseant # Dynamic library loading
    405  1.5.8.1  perseant 
    406  1.5.8.1  perseant # Add the ability to configure libraries to load at compile time.
    407  1.5.8.1  perseant # If set, these disable dynamic configuration.
    408  1.5.8.1  perseant #CONFIG_PKCS11_ENGINE_PATH - pkcs11_engine library location.
    409  1.5.8.1  perseant #CONFIG_PKCS11_MODULE_PATH - pkcs11_module library location.
    410  1.5.8.1  perseant #CONFIG_OPENSC_ENGINE_PATH - opensc_engine library location.
    411  1.5.8.1  perseant #
    412  1.5.8.1  perseant # Prevent library loading at runtime
    413  1.5.8.1  perseant #CONFIG_NO_PKCS11_ENGINE_PATH=y # prevents loading pkcs11_engine library.
    414  1.5.8.1  perseant #CONFIG_NO_PKCS11_MODULE_PATH=y # prevents loading pkcs11_module library.
    415  1.5.8.1  perseant # CONFIG_NO_OPENSC_ENGINE_PATH=y # prevents loading opensc_engine library.
    416  1.5.8.1  perseant 
    417  1.5.8.1  perseant # Prevents loading EAP libraries at runtime
    418  1.5.8.1  perseant #CONFIG_NO_LOAD_DYNAMIC_EAP=y
    419  1.5.8.1  perseant 
    420      1.4  christos # IEEE Std 802.11r-2008 (Fast BSS Transition) for station mode
    421      1.5  christos CONFIG_IEEE80211R=y
    422      1.1  christos 
    423      1.1  christos # Add support for writing debug log to a file (/tmp/wpa_supplicant-log-#.txt)
    424      1.5  christos CONFIG_DEBUG_FILE=y
    425      1.1  christos 
    426      1.2       roy # Send debug messages to syslog instead of stdout
    427      1.5  christos CONFIG_DEBUG_SYSLOG=y
    428      1.2       roy # Set syslog facility for debug messages
    429      1.2       roy #CONFIG_DEBUG_SYSLOG_FACILITY=LOG_DAEMON
    430      1.2       roy 
    431      1.2       roy # Add support for sending all debug messages (regardless of debug verbosity)
    432      1.2       roy # to the Linux kernel tracing facility. This helps debug the entire stack by
    433      1.2       roy # making it easy to record everything happening from the driver up into the
    434      1.2       roy # same file, e.g., using trace-cmd.
    435      1.2       roy #CONFIG_DEBUG_LINUX_TRACING=y
    436      1.2       roy 
    437      1.2       roy # Add support for writing debug log to Android logcat instead of standard
    438      1.2       roy # output
    439      1.2       roy #CONFIG_ANDROID_LOG=y
    440      1.2       roy 
    441      1.1  christos # Enable privilege separation (see README 'Privilege separation' for details)
    442      1.1  christos #CONFIG_PRIVSEP=y
    443      1.1  christos 
    444      1.1  christos # Enable mitigation against certain attacks against TKIP by delaying Michael
    445      1.1  christos # MIC error reports by a random amount of time between 0 and 60 seconds
    446      1.1  christos #CONFIG_DELAYED_MIC_ERROR_REPORT=y
    447      1.1  christos 
    448      1.1  christos # Enable tracing code for developer debugging
    449      1.1  christos # This tracks use of memory allocations and other registrations and reports
    450      1.1  christos # incorrect use with a backtrace of call (or allocation) location.
    451      1.1  christos #CONFIG_WPA_TRACE=y
    452      1.2       roy # For BSD, uncomment these.
    453      1.1  christos #LIBS += -lexecinfo
    454      1.1  christos #LIBS_p += -lexecinfo
    455      1.1  christos #LIBS_c += -lexecinfo
    456      1.1  christos 
    457      1.1  christos # Use libbfd to get more details for developer debugging
    458      1.1  christos # This enables use of libbfd to get more detailed symbols for the backtraces
    459      1.1  christos # generated by CONFIG_WPA_TRACE=y.
    460      1.1  christos #CONFIG_WPA_TRACE_BFD=y
    461      1.2       roy # For BSD, uncomment these.
    462      1.1  christos #LIBS += -lbfd -liberty -lz
    463      1.1  christos #LIBS_p += -lbfd -liberty -lz
    464      1.1  christos #LIBS_c += -lbfd -liberty -lz
    465      1.2       roy 
    466      1.2       roy # wpa_supplicant depends on strong random number generation being available
    467      1.2       roy # from the operating system. os_get_random() function is used to fetch random
    468      1.2       roy # data when needed, e.g., for key generation. On Linux and BSD systems, this
    469      1.2       roy # works by reading /dev/urandom. It should be noted that the OS entropy pool
    470      1.2       roy # needs to be properly initialized before wpa_supplicant is started. This is
    471      1.2       roy # important especially on embedded devices that do not have a hardware random
    472      1.2       roy # number generator and may by default start up with minimal entropy available
    473      1.2       roy # for random number generation.
    474      1.2       roy #
    475      1.2       roy # As a safety net, wpa_supplicant is by default trying to internally collect
    476      1.2       roy # additional entropy for generating random data to mix in with the data fetched
    477      1.2       roy # from the OS. This by itself is not considered to be very strong, but it may
    478      1.2       roy # help in cases where the system pool is not initialized properly. However, it
    479      1.2       roy # is very strongly recommended that the system pool is initialized with enough
    480      1.2       roy # entropy either by using hardware assisted random number generator or by
    481      1.2       roy # storing state over device reboots.
    482      1.2       roy #
    483      1.2       roy # wpa_supplicant can be configured to maintain its own entropy store over
    484      1.2       roy # restarts to enhance random number generation. This is not perfect, but it is
    485      1.2       roy # much more secure than using the same sequence of random numbers after every
    486      1.2       roy # reboot. This can be enabled with -e<entropy file> command line option. The
    487      1.2       roy # specified file needs to be readable and writable by wpa_supplicant.
    488      1.2       roy #
    489      1.2       roy # If the os_get_random() is known to provide strong random data (e.g., on
    490      1.2       roy # Linux/BSD, the board in question is known to have reliable source of random
    491      1.2       roy # data from /dev/urandom), the internal wpa_supplicant random pool can be
    492      1.2       roy # disabled. This will save some in binary size and CPU use. However, this
    493      1.2       roy # should only be considered for builds that are known to be used on devices
    494      1.2       roy # that meet the requirements described above.
    495      1.2       roy #CONFIG_NO_RANDOM_POOL=y
    496      1.2       roy 
    497      1.5  christos # Should we attempt to use the getrandom(2) call that provides more reliable
    498      1.5  christos # yet secure randomness source than /dev/random on Linux 3.17 and newer.
    499      1.5  christos # Requires glibc 2.25 to build, falls back to /dev/random if unavailable.
    500      1.5  christos #CONFIG_GETRANDOM=y
    501      1.5  christos 
    502      1.2       roy # IEEE 802.11ac (Very High Throughput) support (mainly for AP mode)
    503      1.5  christos CONFIG_IEEE80211AC=y
    504      1.2       roy 
    505  1.5.8.1  perseant # IEEE 802.11ax HE support (mainly for AP mode)
    506  1.5.8.1  perseant CONFIG_IEEE80211AX=y
    507  1.5.8.1  perseant 
    508  1.5.8.1  perseant # IEEE 802.11be EHT support (mainly for AP mode)
    509  1.5.8.1  perseant # CONFIG_IEEE80211AX is mandatory for setting CONFIG_IEEE80211BE.
    510  1.5.8.1  perseant # Note: This is experimental and work in progress. The definitions are still
    511  1.5.8.1  perseant # subject to change and this should not be expected to interoperate with the
    512  1.5.8.1  perseant # final IEEE 802.11be version.
    513  1.5.8.1  perseant #CONFIG_IEEE80211BE=y
    514  1.5.8.1  perseant 
    515      1.2       roy # Wireless Network Management (IEEE Std 802.11v-2011)
    516      1.2       roy # Note: This is experimental and not complete implementation.
    517      1.2       roy #CONFIG_WNM=y
    518      1.2       roy 
    519      1.2       roy # Interworking (IEEE 802.11u)
    520      1.2       roy # This can be used to enable functionality to improve interworking with
    521      1.2       roy # external networks (GAS/ANQP to learn more about the networks and network
    522      1.2       roy # selection based on available credentials).
    523      1.5  christos CONFIG_INTERWORKING=y
    524      1.2       roy 
    525      1.2       roy # Hotspot 2.0
    526      1.5  christos CONFIG_HS20=y
    527      1.2       roy 
    528      1.2       roy # Enable interface matching in wpa_supplicant
    529      1.2       roy #CONFIG_MATCH_IFACE=y
    530      1.2       roy 
    531      1.2       roy # Disable roaming in wpa_supplicant
    532      1.2       roy #CONFIG_NO_ROAMING=y
    533      1.2       roy 
    534      1.2       roy # AP mode operations with wpa_supplicant
    535      1.2       roy # This can be used for controlling AP mode operations with wpa_supplicant. It
    536      1.2       roy # should be noted that this is mainly aimed at simple cases like
    537      1.2       roy # WPA2-Personal while more complex configurations like WPA2-Enterprise with an
    538      1.2       roy # external RADIUS server can be supported with hostapd.
    539      1.5  christos CONFIG_AP=y
    540      1.2       roy 
    541      1.2       roy # P2P (Wi-Fi Direct)
    542      1.2       roy # This can be used to enable P2P support in wpa_supplicant. See README-P2P for
    543      1.2       roy # more information on P2P operations.
    544      1.5  christos CONFIG_P2P=y
    545      1.2       roy 
    546      1.2       roy # Enable TDLS support
    547  1.5.8.1  perseant CONFIG_TDLS=y
    548      1.2       roy 
    549      1.5  christos # Wi-Fi Display
    550      1.5  christos # This can be used to enable Wi-Fi Display extensions for P2P using an external
    551      1.2       roy # program to control the additional information exchanges in the messages.
    552      1.5  christos CONFIG_WIFI_DISPLAY=y
    553      1.2       roy 
    554      1.2       roy # Autoscan
    555      1.2       roy # This can be used to enable automatic scan support in wpa_supplicant.
    556      1.2       roy # See wpa_supplicant.conf for more information on autoscan usage.
    557      1.2       roy #
    558      1.2       roy # Enabling directly a module will enable autoscan support.
    559      1.2       roy # For exponential module:
    560      1.2       roy #CONFIG_AUTOSCAN_EXPONENTIAL=y
    561      1.2       roy # For periodic module:
    562      1.2       roy #CONFIG_AUTOSCAN_PERIODIC=y
    563      1.2       roy 
    564      1.2       roy # Password (and passphrase, etc.) backend for external storage
    565      1.2       roy # These optional mechanisms can be used to add support for storing passwords
    566      1.2       roy # and other secrets in external (to wpa_supplicant) location. This allows, for
    567      1.2       roy # example, operating system specific key storage to be used
    568      1.2       roy #
    569      1.2       roy # External password backend for testing purposes (developer use)
    570      1.2       roy #CONFIG_EXT_PASSWORD_TEST=y
    571  1.5.8.1  perseant # File-based backend to read passwords from an external file.
    572  1.5.8.1  perseant #CONFIG_EXT_PASSWORD_FILE=y
    573      1.3  christos 
    574      1.3  christos # Enable Fast Session Transfer (FST)
    575      1.3  christos #CONFIG_FST=y
    576      1.3  christos 
    577      1.3  christos # Enable CLI commands for FST testing
    578      1.3  christos #CONFIG_FST_TEST=y
    579      1.3  christos 
    580      1.3  christos # OS X builds. This is only for building eapol_test.
    581      1.3  christos #CONFIG_OSX=y
    582      1.3  christos 
    583      1.3  christos # Automatic Channel Selection
    584      1.3  christos # This will allow wpa_supplicant to pick the channel automatically when channel
    585      1.3  christos # is set to "0".
    586      1.3  christos #
    587      1.3  christos # TODO: Extend parser to be able to parse "channel=acs_survey" as an alternative
    588      1.3  christos # to "channel=0". This would enable us to eventually add other ACS algorithms in
    589      1.3  christos # similar way.
    590      1.3  christos #
    591      1.3  christos # Automatic selection is currently only done through initialization, later on
    592      1.3  christos # we hope to do background checks to keep us moving to more ideal channels as
    593      1.3  christos # time goes by. ACS is currently only supported through the nl80211 driver and
    594      1.3  christos # your driver must have survey dump capability that is filled by the driver
    595      1.3  christos # during scanning.
    596      1.3  christos #
    597      1.3  christos # TODO: In analogy to hostapd be able to customize the ACS survey algorithm with
    598      1.3  christos # a newly to create wpa_supplicant.conf variable acs_num_scans.
    599      1.3  christos #
    600      1.3  christos # Supported ACS drivers:
    601      1.3  christos # * ath9k
    602      1.3  christos # * ath5k
    603      1.3  christos # * ath10k
    604      1.3  christos #
    605      1.3  christos # For more details refer to:
    606      1.3  christos # http://wireless.kernel.org/en/users/Documentation/acs
    607      1.3  christos #CONFIG_ACS=y
    608      1.3  christos 
    609      1.3  christos # Support Multi Band Operation
    610      1.3  christos #CONFIG_MBO=y
    611      1.4  christos 
    612      1.4  christos # Fast Initial Link Setup (FILS) (IEEE 802.11ai)
    613      1.4  christos #CONFIG_FILS=y
    614      1.4  christos # FILS shared key authentication with PFS
    615      1.4  christos #CONFIG_FILS_SK_PFS=y
    616      1.4  christos 
    617      1.4  christos # Support RSN on IBSS networks
    618      1.4  christos # This is needed to be able to use mode=1 network profile with proto=RSN and
    619      1.4  christos # key_mgmt=WPA-PSK (i.e., full key management instead of WPA-None).
    620      1.5  christos CONFIG_IBSS_RSN=y
    621      1.4  christos 
    622      1.4  christos # External PMKSA cache control
    623      1.4  christos # This can be used to enable control interface commands that allow the current
    624      1.4  christos # PMKSA cache entries to be fetched and new entries to be added.
    625      1.4  christos #CONFIG_PMKSA_CACHE_EXTERNAL=y
    626      1.4  christos 
    627      1.4  christos # Mesh Networking (IEEE 802.11s)
    628      1.4  christos #CONFIG_MESH=y
    629      1.4  christos 
    630      1.4  christos # Background scanning modules
    631      1.4  christos # These can be used to request wpa_supplicant to perform background scanning
    632      1.4  christos # operations for roaming within an ESS (same SSID). See the bgscan parameter in
    633      1.4  christos # the wpa_supplicant.conf file for more details.
    634      1.4  christos # Periodic background scans based on signal strength
    635      1.5  christos CONFIG_BGSCAN_SIMPLE=y
    636      1.4  christos # Learn channels used by the network and try to avoid bgscans on other
    637      1.4  christos # channels (experimental)
    638      1.4  christos #CONFIG_BGSCAN_LEARN=y
    639      1.4  christos 
    640      1.4  christos # Opportunistic Wireless Encryption (OWE)
    641      1.4  christos # Experimental implementation of draft-harkins-owe-07.txt
    642      1.4  christos #CONFIG_OWE=y
    643      1.5  christos 
    644  1.5.8.1  perseant # Device Provisioning Protocol (DPP) (also known as Wi-Fi Easy Connect)
    645      1.5  christos CONFIG_DPP=y
    646  1.5.8.1  perseant # DPP version 2 support
    647  1.5.8.1  perseant CONFIG_DPP2=y
    648  1.5.8.1  perseant # DPP version 3 support (experimental and still changing; do not enable for
    649  1.5.8.1  perseant # production use)
    650  1.5.8.1  perseant #CONFIG_DPP3=y
    651  1.5.8.1  perseant 
    652  1.5.8.1  perseant # Wired equivalent privacy (WEP)
    653  1.5.8.1  perseant # WEP is an obsolete cryptographic data confidentiality algorithm that is not
    654  1.5.8.1  perseant # considered secure. It should not be used for anything anymore. The
    655  1.5.8.1  perseant # functionality needed to use WEP is available in the current wpa_supplicant
    656  1.5.8.1  perseant # release under this optional build parameter. This functionality is subject to
    657  1.5.8.1  perseant # be completely removed in a future release.
    658  1.5.8.1  perseant #CONFIG_WEP=y
    659  1.5.8.1  perseant 
    660  1.5.8.1  perseant # Remove all TKIP functionality
    661  1.5.8.1  perseant # TKIP is an old cryptographic data confidentiality algorithm that is not
    662  1.5.8.1  perseant # considered secure. It should not be used anymore for anything else than a
    663  1.5.8.1  perseant # backwards compatibility option as a group cipher when connecting to APs that
    664  1.5.8.1  perseant # use WPA+WPA2 mixed mode. For now, the default wpa_supplicant build includes
    665  1.5.8.1  perseant # support for this by default, but that functionality is subject to be removed
    666  1.5.8.1  perseant # in the future.
    667  1.5.8.1  perseant #CONFIG_NO_TKIP=y
    668  1.5.8.1  perseant 
    669  1.5.8.1  perseant # Pre-Association Security Negotiation (PASN)
    670  1.5.8.1  perseant # Experimental implementation based on IEEE P802.11z/D2.6 and the protocol
    671  1.5.8.1  perseant # design is still subject to change. As such, this should not yet be enabled in
    672  1.5.8.1  perseant # production use.
    673  1.5.8.1  perseant #CONFIG_PASN=y
    674  1.5.8.1  perseant 
    675  1.5.8.1  perseant # Disable support for Radio Measurement (IEEE 802.11k) and supported operating
    676  1.5.8.1  perseant # class indication. Removing these is not recommended since they can help the
    677  1.5.8.1  perseant # AP manage the network and STA steering.
    678  1.5.8.1  perseant #CONFIG_NO_RRM=y
    679  1.5.8.1  perseant 
    680  1.5.8.1  perseant # Disable support for Robust AV streaming for consumer and enterprise Wi-Fi
    681  1.5.8.1  perseant # applications; IEEE Std 802.11-2020, 4.3.24; SCS, MSCS, QoS Management
    682  1.5.8.1  perseant #CONFIG_NO_ROBUST_AV=y
    683  1.5.8.1  perseant 
    684  1.5.8.1  perseant # Disable support for WMM admission control
    685  1.5.8.1  perseant #CONFIG_NO_WMM_AC=y
    686  1.5.8.1  perseant 
    687  1.5.8.1  perseant # Wi-Fi Aware unsynchronized service discovery (NAN USD)
    688  1.5.8.1  perseant #CONFIG_NAN_USD=y
    689