| b.liu | e958203 | 2025-04-17 19:18:16 +0800 | [diff] [blame] | 1 | # Example hostapd 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 cass, these lines should use += in order not | 
|  | 10 | # to override previous values of the variables. | 
|  | 11 |  | 
|  | 12 | # Driver interface for Host AP driver | 
|  | 13 | #CONFIG_DRIVER_HOSTAP=y | 
|  | 14 |  | 
|  | 15 | # Driver interface for wired authenticator | 
|  | 16 | CONFIG_DRIVER_WIRED=y | 
|  | 17 |  | 
|  | 18 | # Driver interface for drivers using the nl80211 kernel interface | 
|  | 19 | CONFIG_DRIVER_NL80211=y | 
|  | 20 |  | 
|  | 21 | # QCA vendor extensions to nl80211 | 
|  | 22 | #CONFIG_DRIVER_NL80211_QCA=y | 
|  | 23 |  | 
|  | 24 | # driver_nl80211.c requires libnl. If you are compiling it yourself | 
|  | 25 | # you may need to point hostapd to your version of libnl. | 
|  | 26 | # | 
|  | 27 | #CFLAGS += -I$<path to libnl include files> | 
|  | 28 | #LIBS += -L$<path to libnl library files> | 
|  | 29 |  | 
|  | 30 | # Use libnl v2.0 (or 3.0) libraries. | 
|  | 31 | #CONFIG_LIBNL20=y | 
|  | 32 |  | 
|  | 33 | # Use libnl 3.2 libraries (if this is selected, CONFIG_LIBNL20 is ignored) | 
|  | 34 | #CONFIG_LIBNL32=y | 
|  | 35 |  | 
|  | 36 |  | 
|  | 37 | # Driver interface for FreeBSD net80211 layer (e.g., Atheros driver) | 
|  | 38 | #CONFIG_DRIVER_BSD=y | 
|  | 39 | #CFLAGS += -I/usr/local/include | 
|  | 40 | #LIBS += -L/usr/local/lib | 
|  | 41 | #LIBS_p += -L/usr/local/lib | 
|  | 42 | #LIBS_c += -L/usr/local/lib | 
|  | 43 |  | 
|  | 44 | # Driver interface for no driver (e.g., RADIUS server only) | 
|  | 45 | #CONFIG_DRIVER_NONE=y | 
|  | 46 |  | 
|  | 47 | # IEEE 802.11F/IAPP | 
|  | 48 | CONFIG_IAPP=y | 
|  | 49 |  | 
|  | 50 | # WPA2/IEEE 802.11i RSN pre-authentication | 
|  | 51 | CONFIG_RSN_PREAUTH=y | 
|  | 52 |  | 
|  | 53 | # IEEE 802.11w (management frame protection) | 
|  | 54 | #CONFIG_IEEE80211W=y | 
|  | 55 |  | 
|  | 56 | # Support Operating Channel Validation | 
|  | 57 | CONFIG_OCV=y | 
|  | 58 |  | 
|  | 59 | # Integrated EAP server | 
|  | 60 | CONFIG_EAP=y | 
|  | 61 |  | 
|  | 62 | # EAP Re-authentication Protocol (ERP) in integrated EAP server | 
|  | 63 | CONFIG_ERP=y | 
|  | 64 |  | 
|  | 65 | # EAP-MD5 for the integrated EAP server | 
|  | 66 | CONFIG_EAP_MD5=y | 
|  | 67 |  | 
|  | 68 | # EAP-TLS for the integrated EAP server | 
|  | 69 | CONFIG_EAP_TLS=y | 
|  | 70 |  | 
|  | 71 | # EAP-MSCHAPv2 for the integrated EAP server | 
|  | 72 | CONFIG_EAP_MSCHAPV2=y | 
|  | 73 |  | 
|  | 74 | # EAP-PEAP for the integrated EAP server | 
|  | 75 | CONFIG_EAP_PEAP=y | 
|  | 76 |  | 
|  | 77 | # EAP-GTC for the integrated EAP server | 
|  | 78 | CONFIG_EAP_GTC=y | 
|  | 79 |  | 
|  | 80 | # EAP-TTLS for the integrated EAP server | 
|  | 81 | CONFIG_EAP_TTLS=y | 
|  | 82 |  | 
|  | 83 | # EAP-SIM for the integrated EAP server | 
|  | 84 | #CONFIG_EAP_SIM=y | 
|  | 85 |  | 
|  | 86 | # EAP-AKA for the integrated EAP server | 
|  | 87 | #CONFIG_EAP_AKA=y | 
|  | 88 |  | 
|  | 89 | # EAP-AKA' for the integrated EAP server | 
|  | 90 | # This requires CONFIG_EAP_AKA to be enabled, too. | 
|  | 91 | #CONFIG_EAP_AKA_PRIME=y | 
|  | 92 |  | 
|  | 93 | # EAP-PAX for the integrated EAP server | 
|  | 94 | #CONFIG_EAP_PAX=y | 
|  | 95 |  | 
|  | 96 | # EAP-PSK for the integrated EAP server (this is _not_ needed for WPA-PSK) | 
|  | 97 | #CONFIG_EAP_PSK=y | 
|  | 98 |  | 
|  | 99 | # EAP-pwd for the integrated EAP server (secure authentication with a password) | 
|  | 100 | #CONFIG_EAP_PWD=y | 
|  | 101 |  | 
|  | 102 | # EAP-SAKE for the integrated EAP server | 
|  | 103 | #CONFIG_EAP_SAKE=y | 
|  | 104 |  | 
|  | 105 | # EAP-GPSK for the integrated EAP server | 
|  | 106 | #CONFIG_EAP_GPSK=y | 
|  | 107 | # Include support for optional SHA256 cipher suite in EAP-GPSK | 
|  | 108 | #CONFIG_EAP_GPSK_SHA256=y | 
|  | 109 |  | 
|  | 110 | # EAP-FAST for the integrated EAP server | 
|  | 111 | CONFIG_EAP_FAST=y | 
|  | 112 |  | 
|  | 113 | # EAP-TEAP for the integrated EAP server | 
|  | 114 | # Note: The current EAP-TEAP implementation is experimental and should not be | 
|  | 115 | # enabled for production use. The IETF RFC 7170 that defines EAP-TEAP has number | 
|  | 116 | # of conflicting statements and missing details and the implementation has | 
|  | 117 | # vendor specific workarounds for those and as such, may not interoperate with | 
|  | 118 | # any other implementation. This should not be used for anything else than | 
|  | 119 | # experimentation and interoperability testing until those issues has been | 
|  | 120 | # resolved. | 
|  | 121 | #CONFIG_EAP_TEAP=y | 
|  | 122 |  | 
|  | 123 | # Wi-Fi Protected Setup (WPS) | 
|  | 124 | CONFIG_WPS=y | 
|  | 125 | # Enable UPnP support for external WPS Registrars | 
|  | 126 | #CONFIG_WPS_UPNP=y | 
|  | 127 | # Enable WPS support with NFC config method | 
|  | 128 | #CONFIG_WPS_NFC=y | 
|  | 129 |  | 
|  | 130 | # EAP-IKEv2 | 
|  | 131 | #CONFIG_EAP_IKEV2=y | 
|  | 132 |  | 
|  | 133 | # Trusted Network Connect (EAP-TNC) | 
|  | 134 | #CONFIG_EAP_TNC=y | 
|  | 135 |  | 
|  | 136 | # EAP-EKE for the integrated EAP server | 
|  | 137 | #CONFIG_EAP_EKE=y | 
|  | 138 |  | 
|  | 139 | # PKCS#12 (PFX) support (used to read private key and certificate file from | 
|  | 140 | # a file that usually has extension .p12 or .pfx) | 
|  | 141 | CONFIG_PKCS12=y | 
|  | 142 |  | 
|  | 143 | # RADIUS authentication server. This provides access to the integrated EAP | 
|  | 144 | # server from external hosts using RADIUS. | 
|  | 145 | CONFIG_RADIUS_SERVER=y | 
|  | 146 |  | 
|  | 147 | # Build IPv6 support for RADIUS operations | 
|  | 148 | CONFIG_IPV6=y | 
|  | 149 |  | 
|  | 150 | # IEEE Std 802.11r-2008 (Fast BSS Transition) | 
|  | 151 | CONFIG_IEEE80211R=y | 
|  | 152 |  | 
|  | 153 | # Use the hostapd's IEEE 802.11 authentication (ACL), but without | 
|  | 154 | # the IEEE 802.11 Management capability (e.g., FreeBSD/net80211) | 
|  | 155 | #CONFIG_DRIVER_RADIUS_ACL=y | 
|  | 156 |  | 
|  | 157 | # IEEE 802.11n (High Throughput) support | 
|  | 158 | CONFIG_IEEE80211N=y | 
|  | 159 |  | 
|  | 160 | # Wireless Network Management (IEEE Std 802.11v-2011) | 
|  | 161 | # Note: This is experimental and not complete implementation. | 
|  | 162 | CONFIG_WNM=y | 
|  | 163 |  | 
|  | 164 | # IEEE 802.11ac (Very High Throughput) support | 
|  | 165 | CONFIG_IEEE80211AC=y | 
|  | 166 |  | 
|  | 167 | # IEEE 802.11ax HE support | 
|  | 168 | # Note: This is experimental and work in progress. The definitions are still | 
|  | 169 | # subject to change and this should not be expected to interoperate with the | 
|  | 170 | # final IEEE 802.11ax version. | 
|  | 171 | #CONFIG_IEEE80211AX=y | 
|  | 172 |  | 
|  | 173 | # Remove debugging code that is printing out debug messages to stdout. | 
|  | 174 | # This can be used to reduce the size of the hostapd considerably if debugging | 
|  | 175 | # code is not needed. | 
|  | 176 | #CONFIG_NO_STDOUT_DEBUG=y | 
|  | 177 |  | 
|  | 178 | # Add support for writing debug log to a file: -f /tmp/hostapd.log | 
|  | 179 | # Disabled by default. | 
|  | 180 | #CONFIG_DEBUG_FILE=y | 
|  | 181 |  | 
|  | 182 | # Send debug messages to syslog instead of stdout | 
|  | 183 | CONFIG_DEBUG_SYSLOG=y | 
|  | 184 |  | 
|  | 185 | # Add support for sending all debug messages (regardless of debug verbosity) | 
|  | 186 | # to the Linux kernel tracing facility. This helps debug the entire stack by | 
|  | 187 | # making it easy to record everything happening from the driver up into the | 
|  | 188 | # same file, e.g., using trace-cmd. | 
|  | 189 | #CONFIG_DEBUG_LINUX_TRACING=y | 
|  | 190 |  | 
|  | 191 | # Remove support for RADIUS accounting | 
|  | 192 | #CONFIG_NO_ACCOUNTING=y | 
|  | 193 |  | 
|  | 194 | # Remove support for RADIUS | 
|  | 195 | #CONFIG_NO_RADIUS=y | 
|  | 196 |  | 
|  | 197 | # Remove support for VLANs | 
|  | 198 | #CONFIG_NO_VLAN=y | 
|  | 199 |  | 
|  | 200 | # Enable support for fully dynamic VLANs. This enables hostapd to | 
|  | 201 | # automatically create bridge and VLAN interfaces if necessary. | 
|  | 202 | CONFIG_FULL_DYNAMIC_VLAN=y | 
|  | 203 |  | 
|  | 204 | # Use netlink-based kernel API for VLAN operations instead of ioctl() | 
|  | 205 | # Note: This requires libnl 3.1 or newer. | 
|  | 206 | #CONFIG_VLAN_NETLINK=y | 
|  | 207 |  | 
|  | 208 | # Remove support for dumping internal state through control interface commands | 
|  | 209 | # This can be used to reduce binary size at the cost of disabling a debugging | 
|  | 210 | # option. | 
|  | 211 | CONFIG_NO_DUMP_STATE=y | 
|  | 212 |  | 
|  | 213 | # Enable tracing code for developer debugging | 
|  | 214 | # This tracks use of memory allocations and other registrations and reports | 
|  | 215 | # incorrect use with a backtrace of call (or allocation) location. | 
|  | 216 | #CONFIG_WPA_TRACE=y | 
|  | 217 | # For BSD, comment out these. | 
|  | 218 | #LIBS += -lexecinfo | 
|  | 219 | #LIBS_p += -lexecinfo | 
|  | 220 | #LIBS_c += -lexecinfo | 
|  | 221 |  | 
|  | 222 | # Use libbfd to get more details for developer debugging | 
|  | 223 | # This enables use of libbfd to get more detailed symbols for the backtraces | 
|  | 224 | # generated by CONFIG_WPA_TRACE=y. | 
|  | 225 | #CONFIG_WPA_TRACE_BFD=y | 
|  | 226 | # For BSD, comment out these. | 
|  | 227 | #LIBS += -lbfd -liberty -lz | 
|  | 228 | #LIBS_p += -lbfd -liberty -lz | 
|  | 229 | #LIBS_c += -lbfd -liberty -lz | 
|  | 230 |  | 
|  | 231 | # hostapd depends on strong random number generation being available from the | 
|  | 232 | # operating system. os_get_random() function is used to fetch random data when | 
|  | 233 | # needed, e.g., for key generation. On Linux and BSD systems, this works by | 
|  | 234 | # reading /dev/urandom. It should be noted that the OS entropy pool needs to be | 
|  | 235 | # properly initialized before hostapd is started. This is important especially | 
|  | 236 | # on embedded devices that do not have a hardware random number generator and | 
|  | 237 | # may by default start up with minimal entropy available for random number | 
|  | 238 | # generation. | 
|  | 239 | # | 
|  | 240 | # As a safety net, hostapd is by default trying to internally collect | 
|  | 241 | # additional entropy for generating random data to mix in with the data | 
|  | 242 | # fetched from the OS. This by itself is not considered to be very strong, but | 
|  | 243 | # it may help in cases where the system pool is not initialized properly. | 
|  | 244 | # However, it is very strongly recommended that the system pool is initialized | 
|  | 245 | # with enough entropy either by using hardware assisted random number | 
|  | 246 | # generator or by storing state over device reboots. | 
|  | 247 | # | 
|  | 248 | # hostapd can be configured to maintain its own entropy store over restarts to | 
|  | 249 | # enhance random number generation. This is not perfect, but it is much more | 
|  | 250 | # secure than using the same sequence of random numbers after every reboot. | 
|  | 251 | # This can be enabled with -e<entropy file> command line option. The specified | 
|  | 252 | # file needs to be readable and writable by hostapd. | 
|  | 253 | # | 
|  | 254 | # If the os_get_random() is known to provide strong random data (e.g., on | 
|  | 255 | # Linux/BSD, the board in question is known to have reliable source of random | 
|  | 256 | # data from /dev/urandom), the internal hostapd random pool can be disabled. | 
|  | 257 | # This will save some in binary size and CPU use. However, this should only be | 
|  | 258 | # considered for builds that are known to be used on devices that meet the | 
|  | 259 | # requirements described above. | 
|  | 260 | CONFIG_NO_RANDOM_POOL=y | 
|  | 261 |  | 
|  | 262 | # Should we attempt to use the getrandom(2) call that provides more reliable | 
|  | 263 | # yet secure randomness source than /dev/random on Linux 3.17 and newer. | 
|  | 264 | # Requires glibc 2.25 to build, falls back to /dev/random if unavailable. | 
|  | 265 | CONFIG_GETRANDOM=y | 
|  | 266 |  | 
|  | 267 | # Should we use poll instead of select? Select is used by default. | 
|  | 268 | #CONFIG_ELOOP_POLL=y | 
|  | 269 |  | 
|  | 270 | # Should we use epoll instead of select? Select is used by default. | 
|  | 271 | CONFIG_ELOOP_EPOLL=y | 
|  | 272 |  | 
|  | 273 | # Should we use kqueue instead of select? Select is used by default. | 
|  | 274 | #CONFIG_ELOOP_KQUEUE=y | 
|  | 275 |  | 
|  | 276 | # Select TLS implementation | 
|  | 277 | # openssl = OpenSSL (default) | 
|  | 278 | # gnutls = GnuTLS | 
|  | 279 | # internal = Internal TLSv1 implementation (experimental) | 
|  | 280 | # linux = Linux kernel AF_ALG and internal TLSv1 implementation (experimental) | 
|  | 281 | # none = Empty template | 
|  | 282 | CONFIG_TLS=internal | 
|  | 283 |  | 
|  | 284 | # TLS-based EAP methods require at least TLS v1.0. Newer version of TLS (v1.1) | 
|  | 285 | # can be enabled to get a stronger construction of messages when block ciphers | 
|  | 286 | # are used. | 
|  | 287 | #CONFIG_TLSV11=y | 
|  | 288 |  | 
|  | 289 | # TLS-based EAP methods require at least TLS v1.0. Newer version of TLS (v1.2) | 
|  | 290 | # can be enabled to enable use of stronger crypto algorithms. | 
|  | 291 | #CONFIG_TLSV12=y | 
|  | 292 |  | 
|  | 293 | # Select which ciphers to use by default with OpenSSL if the user does not | 
|  | 294 | # specify them. | 
|  | 295 | #CONFIG_TLS_DEFAULT_CIPHERS="DEFAULT:!EXP:!LOW" | 
|  | 296 |  | 
|  | 297 | # If CONFIG_TLS=internal is used, additional library and include paths are | 
|  | 298 | # needed for LibTomMath. Alternatively, an integrated, minimal version of | 
|  | 299 | # LibTomMath can be used. See beginning of libtommath.c for details on benefits | 
|  | 300 | # and drawbacks of this option. | 
|  | 301 | CONFIG_INTERNAL_LIBTOMMATH=y | 
|  | 302 | #ifndef CONFIG_INTERNAL_LIBTOMMATH | 
|  | 303 | #LTM_PATH=/usr/src/libtommath-0.39 | 
|  | 304 | #CFLAGS += -I$(LTM_PATH) | 
|  | 305 | #LIBS += -L$(LTM_PATH) | 
|  | 306 | #LIBS_p += -L$(LTM_PATH) | 
|  | 307 | #endif | 
|  | 308 | # At the cost of about 4 kB of additional binary size, the internal LibTomMath | 
|  | 309 | # can be configured to include faster routines for exptmod, sqr, and div to | 
|  | 310 | # speed up DH and RSA calculation considerably | 
|  | 311 | #CONFIG_INTERNAL_LIBTOMMATH_FAST=y | 
|  | 312 |  | 
|  | 313 | # Interworking (IEEE 802.11u) | 
|  | 314 | # This can be used to enable functionality to improve interworking with | 
|  | 315 | # external networks. | 
|  | 316 | CONFIG_INTERWORKING=y | 
|  | 317 |  | 
|  | 318 | # Hotspot 2.0 | 
|  | 319 | CONFIG_HS20=y | 
|  | 320 |  | 
|  | 321 | # Enable SQLite database support in hlr_auc_gw, EAP-SIM DB, and eap_user_file | 
|  | 322 | #CONFIG_SQLITE=y | 
|  | 323 |  | 
|  | 324 | # Enable Fast Session Transfer (FST) | 
|  | 325 | #CONFIG_FST=y | 
|  | 326 |  | 
|  | 327 | # Enable CLI commands for FST testing | 
|  | 328 | #CONFIG_FST_TEST=y | 
|  | 329 |  | 
|  | 330 | # Testing options | 
|  | 331 | # This can be used to enable some testing options (see also the example | 
|  | 332 | # configuration file) that are really useful only for testing clients that | 
|  | 333 | # connect to this hostapd. These options allow, for example, to drop a | 
|  | 334 | # certain percentage of probe requests or auth/(re)assoc frames. | 
|  | 335 | # | 
|  | 336 | #CONFIG_TESTING_OPTIONS=y | 
|  | 337 |  | 
|  | 338 | # Automatic Channel Selection | 
|  | 339 | # This will allow hostapd to pick the channel automatically when channel is set | 
|  | 340 | # to "acs_survey" or "0". Eventually, other ACS algorithms can be added in | 
|  | 341 | # similar way. | 
|  | 342 | # | 
|  | 343 | # Automatic selection is currently only done through initialization, later on | 
|  | 344 | # we hope to do background checks to keep us moving to more ideal channels as | 
|  | 345 | # time goes by. ACS is currently only supported through the nl80211 driver and | 
|  | 346 | # your driver must have survey dump capability that is filled by the driver | 
|  | 347 | # during scanning. | 
|  | 348 | # | 
|  | 349 | # You can customize the ACS survey algorithm with the hostapd.conf variable | 
|  | 350 | # acs_num_scans. | 
|  | 351 | # | 
|  | 352 | # Supported ACS drivers: | 
|  | 353 | # * ath9k | 
|  | 354 | # * ath5k | 
|  | 355 | # * ath10k | 
|  | 356 | # | 
|  | 357 | # For more details refer to: | 
|  | 358 | # http://wireless.kernel.org/en/users/Documentation/acs | 
|  | 359 | # | 
|  | 360 | #CONFIG_ACS=y | 
|  | 361 |  | 
|  | 362 | # Multiband Operation support | 
|  | 363 | # These extentions facilitate efficient use of multiple frequency bands | 
|  | 364 | # available to the AP and the devices that may associate with it. | 
|  | 365 | #CONFIG_MBO=y | 
|  | 366 |  | 
|  | 367 | # Client Taxonomy | 
|  | 368 | # Has the AP retain the Probe Request and (Re)Association Request frames from | 
|  | 369 | # a client, from which a signature can be produced which can identify the model | 
|  | 370 | # of client device like "Nexus 6P" or "iPhone 5s". | 
|  | 371 | CONFIG_TAXONOMY=y | 
|  | 372 |  | 
|  | 373 | # Fast Initial Link Setup (FILS) (IEEE 802.11ai) | 
|  | 374 | #CONFIG_FILS=y | 
|  | 375 | # FILS shared key authentication with PFS | 
|  | 376 | #CONFIG_FILS_SK_PFS=y | 
|  | 377 |  | 
|  | 378 | # Include internal line edit mode in hostapd_cli. This can be used to provide | 
|  | 379 | # limited command line editing and history support. | 
|  | 380 | #CONFIG_WPA_CLI_EDIT=y | 
|  | 381 |  | 
|  | 382 | # Opportunistic Wireless Encryption (OWE) | 
|  | 383 | # Experimental implementation of draft-harkins-owe-07.txt | 
|  | 384 | #CONFIG_OWE=y | 
|  | 385 |  | 
|  | 386 | # Airtime policy support | 
|  | 387 | CONFIG_AIRTIME_POLICY=y | 
|  | 388 |  | 
|  | 389 | # Proxy ARP support | 
|  | 390 | CONFIG_PROXYARP=y | 
|  | 391 |  | 
|  | 392 | # Override default value for the wpa_disable_eapol_key_retries configuration | 
|  | 393 | # parameter. See that parameter in hostapd.conf for more details. | 
|  | 394 | #CFLAGS += -DDEFAULT_WPA_DISABLE_EAPOL_KEY_RETRIES=1 | 
|  | 395 |  | 
|  | 396 | # uBus IPC/RPC System | 
|  | 397 | # Services can connect to the bus and provide methods | 
|  | 398 | # that can be called by other services or clients. | 
|  | 399 | CONFIG_UBUS=y | 
|  | 400 |  | 
|  | 401 | # OpenWrt patch 380-disable-ctrl-iface-mib.patch | 
|  | 402 | # leads to the MIB only being compiled in if | 
|  | 403 | # CONFIG_CTRL_IFACE_MIB is enabled. | 
|  | 404 | CONFIG_CTRL_IFACE_MIB=y | 
|  | 405 |  | 
|  | 406 | # DFS CAC Timer config | 
|  | 407 | CONFIG_DFS_CAC_TIMER=y | 
|  | 408 |  | 
|  | 409 | # 2.4G band 20M/40M bandwidth switch | 
|  | 410 | CONFIG_24G_BW_SWITCH=y | 
|  | 411 |  | 
|  | 412 | # 5G band 20M/40M/80M bandwidth switch | 
|  | 413 | CONFIG_5G_BW_SWITCH=y | 
|  | 414 |  | 
|  | 415 | # BSS Transition implementation | 
|  | 416 | #CONFIG_BSS_TRANS_IMPL=y | 
|  | 417 |  | 
|  | 418 | # WPS 5G priority access when push button | 
|  | 419 | #CONFIG_WPS_5G_PREFER=y |