Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 1 | ##### hostapd configuration file ############################################## |
| 2 | # Empty lines and lines starting with # are ignored |
| 3 | |
| 4 | # AP netdevice name (without 'ap' postfix, i.e., wlan0 uses wlan0ap for |
| 5 | # management frames); ath0 for madwifi |
| 6 | interface=wlan0 |
| 7 | |
| 8 | # In case of madwifi, atheros, and nl80211 driver interfaces, an additional |
| 9 | # configuration parameter, bridge, may be used to notify hostapd if the |
| 10 | # interface is included in a bridge. This parameter is not used with Host AP |
| 11 | # driver. If the bridge parameter is not set, the drivers will automatically |
| 12 | # figure out the bridge interface (assuming sysfs is enabled and mounted to |
| 13 | # /sys) and this parameter may not be needed. |
| 14 | # |
| 15 | # For nl80211, this parameter can be used to request the AP interface to be |
| 16 | # added to the bridge automatically (brctl may refuse to do this before hostapd |
| 17 | # has been started to change the interface mode). If needed, the bridge |
| 18 | # interface is also created. |
| 19 | #bridge=br0 |
| 20 | |
| 21 | # Driver interface type (hostap/wired/madwifi/test/none/nl80211/bsd); |
| 22 | # default: hostap). nl80211 is used with all Linux mac80211 drivers. |
| 23 | # Use driver=none if building hostapd as a standalone RADIUS server that does |
| 24 | # not control any wireless/wired driver. |
| 25 | # driver=hostap |
| 26 | |
| 27 | # hostapd event logger configuration |
| 28 | # |
| 29 | # Two output method: syslog and stdout (only usable if not forking to |
| 30 | # background). |
| 31 | # |
| 32 | # Module bitfield (ORed bitfield of modules that will be logged; -1 = all |
| 33 | # modules): |
| 34 | # bit 0 (1) = IEEE 802.11 |
| 35 | # bit 1 (2) = IEEE 802.1X |
| 36 | # bit 2 (4) = RADIUS |
| 37 | # bit 3 (8) = WPA |
| 38 | # bit 4 (16) = driver interface |
| 39 | # bit 5 (32) = IAPP |
| 40 | # bit 6 (64) = MLME |
| 41 | # |
| 42 | # Levels (minimum value for logged events): |
| 43 | # 0 = verbose debugging |
| 44 | # 1 = debugging |
| 45 | # 2 = informational messages |
| 46 | # 3 = notification |
| 47 | # 4 = warning |
| 48 | # |
| 49 | logger_syslog=-1 |
| 50 | logger_syslog_level=2 |
| 51 | logger_stdout=-1 |
| 52 | logger_stdout_level=2 |
| 53 | |
| 54 | # Dump file for state information (on SIGUSR1) |
| 55 | dump_file=/tmp/hostapd.dump |
| 56 | |
| 57 | # Interface for separate control program. If this is specified, hostapd |
| 58 | # will create this directory and a UNIX domain socket for listening to requests |
| 59 | # from external programs (CLI/GUI, etc.) for status information and |
| 60 | # configuration. The socket file will be named based on the interface name, so |
| 61 | # multiple hostapd processes/interfaces can be run at the same time if more |
| 62 | # than one interface is used. |
| 63 | # /var/run/hostapd is the recommended directory for sockets and by default, |
| 64 | # hostapd_cli will use it when trying to connect with hostapd. |
| 65 | ctrl_interface=/var/run/hostapd |
| 66 | |
| 67 | # Access control for the control interface can be configured by setting the |
| 68 | # directory to allow only members of a group to use sockets. This way, it is |
| 69 | # possible to run hostapd as root (since it needs to change network |
| 70 | # configuration and open raw sockets) and still allow GUI/CLI components to be |
| 71 | # run as non-root users. However, since the control interface can be used to |
| 72 | # change the network configuration, this access needs to be protected in many |
| 73 | # cases. By default, hostapd is configured to use gid 0 (root). If you |
| 74 | # want to allow non-root users to use the contron interface, add a new group |
| 75 | # and change this value to match with that group. Add users that should have |
| 76 | # control interface access to this group. |
| 77 | # |
| 78 | # This variable can be a group name or gid. |
| 79 | #ctrl_interface_group=wheel |
| 80 | ctrl_interface_group=0 |
| 81 | |
| 82 | |
| 83 | ##### IEEE 802.11 related configuration ####################################### |
| 84 | |
| 85 | # SSID to be used in IEEE 802.11 management frames |
| 86 | ssid=test |
Dmitry Shmidt | 61d9df3 | 2012-08-29 16:22:06 -0700 | [diff] [blame] | 87 | # Alternative formats for configuring SSID |
| 88 | # (double quoted string, hexdump, printf-escaped string) |
| 89 | #ssid2="test" |
| 90 | #ssid2=74657374 |
| 91 | #ssid2=P"hello\nthere" |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 92 | |
Dmitry Shmidt | a54fa5f | 2013-01-15 13:53:35 -0800 | [diff] [blame] | 93 | # UTF-8 SSID: Whether the SSID is to be interpreted using UTF-8 encoding |
| 94 | #utf8_ssid=1 |
| 95 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 96 | # Country code (ISO/IEC 3166-1). Used to set regulatory domain. |
| 97 | # Set as needed to indicate country in which device is operating. |
| 98 | # This can limit available channels and transmit power. |
| 99 | #country_code=US |
| 100 | |
| 101 | # Enable IEEE 802.11d. This advertises the country_code and the set of allowed |
| 102 | # channels and transmit power levels based on the regulatory limits. The |
| 103 | # country_code setting must be configured with the correct country for |
| 104 | # IEEE 802.11d functions. |
| 105 | # (default: 0 = disabled) |
| 106 | #ieee80211d=1 |
| 107 | |
Dmitry Shmidt | ea69e84 | 2013-05-13 14:52:28 -0700 | [diff] [blame] | 108 | # Enable IEEE 802.11h. This enables radar detection and DFS support if |
| 109 | # available. DFS support is required on outdoor 5 GHz channels in most countries |
| 110 | # of the world. This can be used only with ieee80211d=1. |
| 111 | # (default: 0 = disabled) |
| 112 | #ieee80211h=1 |
| 113 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 114 | # Operation mode (a = IEEE 802.11a, b = IEEE 802.11b, g = IEEE 802.11g, |
Dmitry Shmidt | a54fa5f | 2013-01-15 13:53:35 -0800 | [diff] [blame] | 115 | # ad = IEEE 802.11ad (60 GHz); a/g options are used with IEEE 802.11n, too, to |
| 116 | # specify band) |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 117 | # Default: IEEE 802.11b |
Dmitry Shmidt | 1f69aa5 | 2012-01-24 16:10:04 -0800 | [diff] [blame] | 118 | hw_mode=g |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 119 | |
| 120 | # Channel number (IEEE 802.11) |
| 121 | # (default: 0, i.e., not set) |
Dmitry Shmidt | 1f69aa5 | 2012-01-24 16:10:04 -0800 | [diff] [blame] | 122 | # Please note that some drivers do not use this value from hostapd and the |
| 123 | # channel will need to be configured separately with iwconfig. |
| 124 | channel=1 |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 125 | |
| 126 | # Beacon interval in kus (1.024 ms) (default: 100; range 15..65535) |
| 127 | beacon_int=100 |
| 128 | |
Dmitry Shmidt | 1f69aa5 | 2012-01-24 16:10:04 -0800 | [diff] [blame] | 129 | # DTIM (delivery traffic information message) period (range 1..255): |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 130 | # number of beacons between DTIMs (1 = every beacon includes DTIM element) |
| 131 | # (default: 2) |
| 132 | dtim_period=2 |
| 133 | |
| 134 | # Maximum number of stations allowed in station table. New stations will be |
| 135 | # rejected after the station table is full. IEEE 802.11 has a limit of 2007 |
| 136 | # different association IDs, so this number should not be larger than that. |
| 137 | # (default: 2007) |
| 138 | max_num_sta=255 |
| 139 | |
| 140 | # RTS/CTS threshold; 2347 = disabled (default); range 0..2347 |
| 141 | # If this field is not included in hostapd.conf, hostapd will not control |
| 142 | # RTS threshold and 'iwconfig wlan# rts <val>' can be used to set it. |
| 143 | rts_threshold=2347 |
| 144 | |
| 145 | # Fragmentation threshold; 2346 = disabled (default); range 256..2346 |
| 146 | # If this field is not included in hostapd.conf, hostapd will not control |
| 147 | # fragmentation threshold and 'iwconfig wlan# frag <val>' can be used to set |
| 148 | # it. |
| 149 | fragm_threshold=2346 |
| 150 | |
| 151 | # Rate configuration |
| 152 | # Default is to enable all rates supported by the hardware. This configuration |
| 153 | # item allows this list be filtered so that only the listed rates will be left |
| 154 | # in the list. If the list is empty, all rates are used. This list can have |
| 155 | # entries that are not in the list of rates the hardware supports (such entries |
| 156 | # are ignored). The entries in this list are in 100 kbps, i.e., 11 Mbps = 110. |
| 157 | # If this item is present, at least one rate have to be matching with the rates |
| 158 | # hardware supports. |
| 159 | # default: use the most common supported rate setting for the selected |
| 160 | # hw_mode (i.e., this line can be removed from configuration file in most |
| 161 | # cases) |
| 162 | #supported_rates=10 20 55 110 60 90 120 180 240 360 480 540 |
| 163 | |
| 164 | # Basic rate set configuration |
| 165 | # List of rates (in 100 kbps) that are included in the basic rate set. |
| 166 | # If this item is not included, usually reasonable default set is used. |
| 167 | #basic_rates=10 20 |
| 168 | #basic_rates=10 20 55 110 |
| 169 | #basic_rates=60 120 240 |
| 170 | |
| 171 | # Short Preamble |
| 172 | # This parameter can be used to enable optional use of short preamble for |
| 173 | # frames sent at 2 Mbps, 5.5 Mbps, and 11 Mbps to improve network performance. |
| 174 | # This applies only to IEEE 802.11b-compatible networks and this should only be |
| 175 | # enabled if the local hardware supports use of short preamble. If any of the |
| 176 | # associated STAs do not support short preamble, use of short preamble will be |
| 177 | # disabled (and enabled when such STAs disassociate) dynamically. |
| 178 | # 0 = do not allow use of short preamble (default) |
| 179 | # 1 = allow use of short preamble |
| 180 | #preamble=1 |
| 181 | |
| 182 | # Station MAC address -based authentication |
| 183 | # Please note that this kind of access control requires a driver that uses |
| 184 | # hostapd to take care of management frame processing and as such, this can be |
| 185 | # used with driver=hostap or driver=nl80211, but not with driver=madwifi. |
| 186 | # 0 = accept unless in deny list |
| 187 | # 1 = deny unless in accept list |
| 188 | # 2 = use external RADIUS server (accept/deny lists are searched first) |
| 189 | macaddr_acl=0 |
| 190 | |
| 191 | # Accept/deny lists are read from separate files (containing list of |
| 192 | # MAC addresses, one per line). Use absolute path name to make sure that the |
| 193 | # files can be read on SIGHUP configuration reloads. |
| 194 | #accept_mac_file=/etc/hostapd.accept |
| 195 | #deny_mac_file=/etc/hostapd.deny |
| 196 | |
| 197 | # IEEE 802.11 specifies two authentication algorithms. hostapd can be |
| 198 | # configured to allow both of these or only one. Open system authentication |
| 199 | # should be used with IEEE 802.1X. |
| 200 | # Bit fields of allowed authentication algorithms: |
| 201 | # bit 0 = Open System Authentication |
| 202 | # bit 1 = Shared Key Authentication (requires WEP) |
| 203 | auth_algs=3 |
| 204 | |
| 205 | # Send empty SSID in beacons and ignore probe request frames that do not |
| 206 | # specify full SSID, i.e., require stations to know SSID. |
| 207 | # default: disabled (0) |
| 208 | # 1 = send empty (length=0) SSID in beacon and ignore probe request for |
| 209 | # broadcast SSID |
| 210 | # 2 = clear SSID (ASCII 0), but keep the original length (this may be required |
| 211 | # with some clients that do not support empty SSID) and ignore probe |
| 212 | # requests for broadcast SSID |
| 213 | ignore_broadcast_ssid=0 |
| 214 | |
Dmitry Shmidt | 61d9df3 | 2012-08-29 16:22:06 -0700 | [diff] [blame] | 215 | # Additional vendor specfic elements for Beacon and Probe Response frames |
| 216 | # This parameter can be used to add additional vendor specific element(s) into |
| 217 | # the end of the Beacon and Probe Response frames. The format for these |
| 218 | # element(s) is a hexdump of the raw information elements (id+len+payload for |
| 219 | # one or more elements) |
| 220 | #vendor_elements=dd0411223301 |
| 221 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 222 | # TX queue parameters (EDCF / bursting) |
| 223 | # tx_queue_<queue name>_<param> |
| 224 | # queues: data0, data1, data2, data3, after_beacon, beacon |
| 225 | # (data0 is the highest priority queue) |
| 226 | # parameters: |
| 227 | # aifs: AIFS (default 2) |
| 228 | # cwmin: cwMin (1, 3, 7, 15, 31, 63, 127, 255, 511, 1023) |
| 229 | # cwmax: cwMax (1, 3, 7, 15, 31, 63, 127, 255, 511, 1023); cwMax >= cwMin |
| 230 | # burst: maximum length (in milliseconds with precision of up to 0.1 ms) for |
| 231 | # bursting |
| 232 | # |
| 233 | # Default WMM parameters (IEEE 802.11 draft; 11-03-0504-03-000e): |
| 234 | # These parameters are used by the access point when transmitting frames |
| 235 | # to the clients. |
| 236 | # |
| 237 | # Low priority / AC_BK = background |
| 238 | #tx_queue_data3_aifs=7 |
| 239 | #tx_queue_data3_cwmin=15 |
| 240 | #tx_queue_data3_cwmax=1023 |
| 241 | #tx_queue_data3_burst=0 |
| 242 | # Note: for IEEE 802.11b mode: cWmin=31 cWmax=1023 burst=0 |
| 243 | # |
| 244 | # Normal priority / AC_BE = best effort |
| 245 | #tx_queue_data2_aifs=3 |
| 246 | #tx_queue_data2_cwmin=15 |
| 247 | #tx_queue_data2_cwmax=63 |
| 248 | #tx_queue_data2_burst=0 |
| 249 | # Note: for IEEE 802.11b mode: cWmin=31 cWmax=127 burst=0 |
| 250 | # |
| 251 | # High priority / AC_VI = video |
| 252 | #tx_queue_data1_aifs=1 |
| 253 | #tx_queue_data1_cwmin=7 |
| 254 | #tx_queue_data1_cwmax=15 |
| 255 | #tx_queue_data1_burst=3.0 |
| 256 | # Note: for IEEE 802.11b mode: cWmin=15 cWmax=31 burst=6.0 |
| 257 | # |
| 258 | # Highest priority / AC_VO = voice |
| 259 | #tx_queue_data0_aifs=1 |
| 260 | #tx_queue_data0_cwmin=3 |
| 261 | #tx_queue_data0_cwmax=7 |
| 262 | #tx_queue_data0_burst=1.5 |
| 263 | # Note: for IEEE 802.11b mode: cWmin=7 cWmax=15 burst=3.3 |
| 264 | |
| 265 | # 802.1D Tag (= UP) to AC mappings |
| 266 | # WMM specifies following mapping of data frames to different ACs. This mapping |
| 267 | # can be configured using Linux QoS/tc and sch_pktpri.o module. |
| 268 | # 802.1D Tag 802.1D Designation Access Category WMM Designation |
| 269 | # 1 BK AC_BK Background |
| 270 | # 2 - AC_BK Background |
| 271 | # 0 BE AC_BE Best Effort |
| 272 | # 3 EE AC_BE Best Effort |
| 273 | # 4 CL AC_VI Video |
| 274 | # 5 VI AC_VI Video |
| 275 | # 6 VO AC_VO Voice |
| 276 | # 7 NC AC_VO Voice |
| 277 | # Data frames with no priority information: AC_BE |
| 278 | # Management frames: AC_VO |
| 279 | # PS-Poll frames: AC_BE |
| 280 | |
| 281 | # Default WMM parameters (IEEE 802.11 draft; 11-03-0504-03-000e): |
| 282 | # for 802.11a or 802.11g networks |
| 283 | # These parameters are sent to WMM clients when they associate. |
| 284 | # The parameters will be used by WMM clients for frames transmitted to the |
| 285 | # access point. |
| 286 | # |
| 287 | # note - txop_limit is in units of 32microseconds |
| 288 | # note - acm is admission control mandatory flag. 0 = admission control not |
| 289 | # required, 1 = mandatory |
| 290 | # note - here cwMin and cmMax are in exponent form. the actual cw value used |
| 291 | # will be (2^n)-1 where n is the value given here |
| 292 | # |
| 293 | wmm_enabled=1 |
| 294 | # |
| 295 | # WMM-PS Unscheduled Automatic Power Save Delivery [U-APSD] |
| 296 | # Enable this flag if U-APSD supported outside hostapd (eg., Firmware/driver) |
| 297 | #uapsd_advertisement_enabled=1 |
| 298 | # |
| 299 | # Low priority / AC_BK = background |
| 300 | wmm_ac_bk_cwmin=4 |
| 301 | wmm_ac_bk_cwmax=10 |
| 302 | wmm_ac_bk_aifs=7 |
| 303 | wmm_ac_bk_txop_limit=0 |
| 304 | wmm_ac_bk_acm=0 |
| 305 | # Note: for IEEE 802.11b mode: cWmin=5 cWmax=10 |
| 306 | # |
| 307 | # Normal priority / AC_BE = best effort |
| 308 | wmm_ac_be_aifs=3 |
| 309 | wmm_ac_be_cwmin=4 |
| 310 | wmm_ac_be_cwmax=10 |
| 311 | wmm_ac_be_txop_limit=0 |
| 312 | wmm_ac_be_acm=0 |
| 313 | # Note: for IEEE 802.11b mode: cWmin=5 cWmax=7 |
| 314 | # |
| 315 | # High priority / AC_VI = video |
| 316 | wmm_ac_vi_aifs=2 |
| 317 | wmm_ac_vi_cwmin=3 |
| 318 | wmm_ac_vi_cwmax=4 |
| 319 | wmm_ac_vi_txop_limit=94 |
| 320 | wmm_ac_vi_acm=0 |
| 321 | # Note: for IEEE 802.11b mode: cWmin=4 cWmax=5 txop_limit=188 |
| 322 | # |
| 323 | # Highest priority / AC_VO = voice |
| 324 | wmm_ac_vo_aifs=2 |
| 325 | wmm_ac_vo_cwmin=2 |
| 326 | wmm_ac_vo_cwmax=3 |
| 327 | wmm_ac_vo_txop_limit=47 |
| 328 | wmm_ac_vo_acm=0 |
| 329 | # Note: for IEEE 802.11b mode: cWmin=3 cWmax=4 burst=102 |
| 330 | |
| 331 | # Static WEP key configuration |
| 332 | # |
| 333 | # The key number to use when transmitting. |
| 334 | # It must be between 0 and 3, and the corresponding key must be set. |
| 335 | # default: not set |
| 336 | #wep_default_key=0 |
| 337 | # The WEP keys to use. |
| 338 | # A key may be a quoted string or unquoted hexadecimal digits. |
| 339 | # The key length should be 5, 13, or 16 characters, or 10, 26, or 32 |
| 340 | # digits, depending on whether 40-bit (64-bit), 104-bit (128-bit), or |
| 341 | # 128-bit (152-bit) WEP is used. |
| 342 | # Only the default key must be supplied; the others are optional. |
| 343 | # default: not set |
| 344 | #wep_key0=123456789a |
| 345 | #wep_key1="vwxyz" |
| 346 | #wep_key2=0102030405060708090a0b0c0d |
| 347 | #wep_key3=".2.4.6.8.0.23" |
| 348 | |
| 349 | # Station inactivity limit |
| 350 | # |
| 351 | # If a station does not send anything in ap_max_inactivity seconds, an |
| 352 | # empty data frame is sent to it in order to verify whether it is |
| 353 | # still in range. If this frame is not ACKed, the station will be |
| 354 | # disassociated and then deauthenticated. This feature is used to |
| 355 | # clear station table of old entries when the STAs move out of the |
| 356 | # range. |
| 357 | # |
| 358 | # The station can associate again with the AP if it is still in range; |
| 359 | # this inactivity poll is just used as a nicer way of verifying |
| 360 | # inactivity; i.e., client will not report broken connection because |
| 361 | # disassociation frame is not sent immediately without first polling |
| 362 | # the STA with a data frame. |
| 363 | # default: 300 (i.e., 5 minutes) |
| 364 | #ap_max_inactivity=300 |
Dmitry Shmidt | 1f69aa5 | 2012-01-24 16:10:04 -0800 | [diff] [blame] | 365 | # |
| 366 | # The inactivity polling can be disabled to disconnect stations based on |
| 367 | # inactivity timeout so that idle stations are more likely to be disconnected |
| 368 | # even if they are still in range of the AP. This can be done by setting |
| 369 | # skip_inactivity_poll to 1 (default 0). |
| 370 | #skip_inactivity_poll=0 |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 371 | |
| 372 | # Disassociate stations based on excessive transmission failures or other |
| 373 | # indications of connection loss. This depends on the driver capabilities and |
| 374 | # may not be available with all drivers. |
| 375 | #disassoc_low_ack=1 |
| 376 | |
| 377 | # Maximum allowed Listen Interval (how many Beacon periods STAs are allowed to |
| 378 | # remain asleep). Default: 65535 (no limit apart from field size) |
| 379 | #max_listen_interval=100 |
| 380 | |
| 381 | # WDS (4-address frame) mode with per-station virtual interfaces |
| 382 | # (only supported with driver=nl80211) |
| 383 | # This mode allows associated stations to use 4-address frames to allow layer 2 |
| 384 | # bridging to be used. |
| 385 | #wds_sta=1 |
| 386 | |
| 387 | # If bridge parameter is set, the WDS STA interface will be added to the same |
| 388 | # bridge by default. This can be overridden with the wds_bridge parameter to |
| 389 | # use a separate bridge. |
| 390 | #wds_bridge=wds-br0 |
| 391 | |
Dmitry Shmidt | c2ebb4b | 2013-07-24 12:57:51 -0700 | [diff] [blame^] | 392 | # Start the AP with beaconing disabled by default. |
| 393 | #start_disabled=0 |
| 394 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 395 | # Client isolation can be used to prevent low-level bridging of frames between |
| 396 | # associated stations in the BSS. By default, this bridging is allowed. |
| 397 | #ap_isolate=1 |
| 398 | |
| 399 | ##### IEEE 802.11n related configuration ###################################### |
| 400 | |
| 401 | # ieee80211n: Whether IEEE 802.11n (HT) is enabled |
| 402 | # 0 = disabled (default) |
| 403 | # 1 = enabled |
| 404 | # Note: You will also need to enable WMM for full HT functionality. |
| 405 | #ieee80211n=1 |
| 406 | |
| 407 | # ht_capab: HT capabilities (list of flags) |
| 408 | # LDPC coding capability: [LDPC] = supported |
| 409 | # Supported channel width set: [HT40-] = both 20 MHz and 40 MHz with secondary |
| 410 | # channel below the primary channel; [HT40+] = both 20 MHz and 40 MHz |
| 411 | # with secondary channel below the primary channel |
| 412 | # (20 MHz only if neither is set) |
| 413 | # Note: There are limits on which channels can be used with HT40- and |
| 414 | # HT40+. Following table shows the channels that may be available for |
| 415 | # HT40- and HT40+ use per IEEE 802.11n Annex J: |
| 416 | # freq HT40- HT40+ |
| 417 | # 2.4 GHz 5-13 1-7 (1-9 in Europe/Japan) |
| 418 | # 5 GHz 40,48,56,64 36,44,52,60 |
| 419 | # (depending on the location, not all of these channels may be available |
| 420 | # for use) |
| 421 | # Please note that 40 MHz channels may switch their primary and secondary |
| 422 | # channels if needed or creation of 40 MHz channel maybe rejected based |
| 423 | # on overlapping BSSes. These changes are done automatically when hostapd |
| 424 | # is setting up the 40 MHz channel. |
| 425 | # Spatial Multiplexing (SM) Power Save: [SMPS-STATIC] or [SMPS-DYNAMIC] |
| 426 | # (SMPS disabled if neither is set) |
| 427 | # HT-greenfield: [GF] (disabled if not set) |
| 428 | # Short GI for 20 MHz: [SHORT-GI-20] (disabled if not set) |
| 429 | # Short GI for 40 MHz: [SHORT-GI-40] (disabled if not set) |
| 430 | # Tx STBC: [TX-STBC] (disabled if not set) |
| 431 | # Rx STBC: [RX-STBC1] (one spatial stream), [RX-STBC12] (one or two spatial |
| 432 | # streams), or [RX-STBC123] (one, two, or three spatial streams); Rx STBC |
| 433 | # disabled if none of these set |
| 434 | # HT-delayed Block Ack: [DELAYED-BA] (disabled if not set) |
| 435 | # Maximum A-MSDU length: [MAX-AMSDU-7935] for 7935 octets (3839 octets if not |
| 436 | # set) |
| 437 | # DSSS/CCK Mode in 40 MHz: [DSSS_CCK-40] = allowed (not allowed if not set) |
| 438 | # PSMP support: [PSMP] (disabled if not set) |
| 439 | # L-SIG TXOP protection support: [LSIG-TXOP-PROT] (disabled if not set) |
| 440 | #ht_capab=[HT40-][SHORT-GI-20][SHORT-GI-40] |
| 441 | |
| 442 | # Require stations to support HT PHY (reject association if they do not) |
| 443 | #require_ht=1 |
| 444 | |
Dmitry Shmidt | 0494959 | 2012-07-19 12:16:46 -0700 | [diff] [blame] | 445 | ##### IEEE 802.11ac related configuration ##################################### |
| 446 | |
| 447 | # ieee80211ac: Whether IEEE 802.11ac (VHT) is enabled |
| 448 | # 0 = disabled (default) |
| 449 | # 1 = enabled |
| 450 | # Note: You will also need to enable WMM for full VHT functionality. |
| 451 | #ieee80211ac=1 |
| 452 | |
| 453 | # vht_capab: VHT capabilities (list of flags) |
| 454 | # |
| 455 | # vht_max_mpdu_len: [MAX-MPDU-7991] [MAX-MPDU-11454] |
| 456 | # Indicates maximum MPDU length |
| 457 | # 0 = 3895 octets (default) |
| 458 | # 1 = 7991 octets |
| 459 | # 2 = 11454 octets |
| 460 | # 3 = reserved |
| 461 | # |
| 462 | # supported_chan_width: [VHT160] [VHT160-80PLUS80] |
| 463 | # Indicates supported Channel widths |
| 464 | # 0 = 160 MHz & 80+80 channel widths are not supported (default) |
| 465 | # 1 = 160 MHz channel width is supported |
| 466 | # 2 = 160 MHz & 80+80 channel widths are supported |
| 467 | # 3 = reserved |
| 468 | # |
| 469 | # Rx LDPC coding capability: [RXLDPC] |
| 470 | # Indicates support for receiving LDPC coded pkts |
| 471 | # 0 = Not supported (default) |
| 472 | # 1 = Supported |
| 473 | # |
| 474 | # Short GI for 80 MHz: [SHORT-GI-80] |
| 475 | # Indicates short GI support for reception of packets transmitted with TXVECTOR |
| 476 | # params format equal to VHT and CBW = 80Mhz |
| 477 | # 0 = Not supported (default) |
| 478 | # 1 = Supported |
| 479 | # |
| 480 | # Short GI for 160 MHz: [SHORT-GI-160] |
| 481 | # Indicates short GI support for reception of packets transmitted with TXVECTOR |
| 482 | # params format equal to VHT and CBW = 160Mhz |
| 483 | # 0 = Not supported (default) |
| 484 | # 1 = Supported |
| 485 | # |
| 486 | # Tx STBC: [TX-STBC-2BY1] |
| 487 | # Indicates support for the transmission of at least 2x1 STBC |
| 488 | # 0 = Not supported (default) |
| 489 | # 1 = Supported |
| 490 | # |
| 491 | # Rx STBC: [RX-STBC-1] [RX-STBC-12] [RX-STBC-123] [RX-STBC-1234] |
| 492 | # Indicates support for the reception of PPDUs using STBC |
| 493 | # 0 = Not supported (default) |
| 494 | # 1 = support of one spatial stream |
| 495 | # 2 = support of one and two spatial streams |
| 496 | # 3 = support of one, two and three spatial streams |
| 497 | # 4 = support of one, two, three and four spatial streams |
| 498 | # 5,6,7 = reserved |
| 499 | # |
| 500 | # SU Beamformer Capable: [SU-BEAMFORMER] |
| 501 | # Indicates support for operation as a single user beamformer |
| 502 | # 0 = Not supported (default) |
| 503 | # 1 = Supported |
| 504 | # |
| 505 | # SU Beamformee Capable: [SU-BEAMFORMEE] |
| 506 | # Indicates support for operation as a single user beamformee |
| 507 | # 0 = Not supported (default) |
| 508 | # 1 = Supported |
| 509 | # |
| 510 | # Compressed Steering Number of Beamformer Antennas Supported: [BF-ANTENNA-2] |
| 511 | # Beamformee's capability indicating the maximum number of beamformer |
| 512 | # antennas the beamformee can support when sending compressed beamforming |
| 513 | # feedback |
| 514 | # If SU beamformer capable, set to maximum value minus 1 |
| 515 | # else reserved (default) |
| 516 | # |
| 517 | # Number of Sounding Dimensions: [SOUNDING-DIMENSION-2] |
Dmitry Shmidt | 61d9df3 | 2012-08-29 16:22:06 -0700 | [diff] [blame] | 518 | # Beamformer's capability indicating the maximum value of the NUM_STS parameter |
Dmitry Shmidt | 0494959 | 2012-07-19 12:16:46 -0700 | [diff] [blame] | 519 | # in the TXVECTOR of a VHT NDP |
| 520 | # If SU beamformer capable, set to maximum value minus 1 |
| 521 | # else reserved (default) |
| 522 | # |
| 523 | # MU Beamformer Capable: [MU-BEAMFORMER] |
| 524 | # Indicates support for operation as an MU beamformer |
| 525 | # 0 = Not supported or sent by Non-AP STA (default) |
| 526 | # 1 = Supported |
| 527 | # |
| 528 | # MU Beamformee Capable: [MU-BEAMFORMEE] |
| 529 | # Indicates support for operation as an MU beamformee |
| 530 | # 0 = Not supported or sent by AP (default) |
| 531 | # 1 = Supported |
| 532 | # |
| 533 | # VHT TXOP PS: [VHT-TXOP-PS] |
| 534 | # Indicates whether or not the AP supports VHT TXOP Power Save Mode |
| 535 | # or whether or not the STA is in VHT TXOP Power Save mode |
| 536 | # 0 = VHT AP doesnt support VHT TXOP PS mode (OR) VHT Sta not in VHT TXOP PS |
| 537 | # mode |
| 538 | # 1 = VHT AP supports VHT TXOP PS mode (OR) VHT Sta is in VHT TXOP power save |
| 539 | # mode |
| 540 | # |
| 541 | # +HTC-VHT Capable: [HTC-VHT] |
| 542 | # Indicates whether or not the STA supports receiving a VHT variant HT Control |
| 543 | # field. |
| 544 | # 0 = Not supported (default) |
| 545 | # 1 = supported |
| 546 | # |
| 547 | # Maximum A-MPDU Length Exponent: [MAX-A-MPDU-LEN-EXP0]..[MAX-A-MPDU-LEN-EXP7] |
| 548 | # Indicates the maximum length of A-MPDU pre-EOF padding that the STA can recv |
| 549 | # This field is an integer in the range of 0 to 7. |
| 550 | # The length defined by this field is equal to |
Dmitry Shmidt | 61d9df3 | 2012-08-29 16:22:06 -0700 | [diff] [blame] | 551 | # 2 pow(13 + Maximum A-MPDU Length Exponent) -1 octets |
Dmitry Shmidt | 0494959 | 2012-07-19 12:16:46 -0700 | [diff] [blame] | 552 | # |
| 553 | # VHT Link Adaptation Capable: [VHT-LINK-ADAPT2] [VHT-LINK-ADAPT3] |
| 554 | # Indicates whether or not the STA supports link adaptation using VHT variant |
| 555 | # HT Control field |
| 556 | # If +HTC-VHTcapable is 1 |
| 557 | # 0 = (no feedback) if the STA does not provide VHT MFB (default) |
| 558 | # 1 = reserved |
| 559 | # 2 = (Unsolicited) if the STA provides only unsolicited VHT MFB |
| 560 | # 3 = (Both) if the STA can provide VHT MFB in response to VHT MRQ and if the |
| 561 | # STA provides unsolicited VHT MFB |
| 562 | # Reserved if +HTC-VHTcapable is 0 |
| 563 | # |
| 564 | # Rx Antenna Pattern Consistency: [RX-ANTENNA-PATTERN] |
| 565 | # Indicates the possibility of Rx antenna pattern change |
| 566 | # 0 = Rx antenna pattern might change during the lifetime of an association |
| 567 | # 1 = Rx antenna pattern does not change during the lifetime of an association |
| 568 | # |
| 569 | # Tx Antenna Pattern Consistency: [TX-ANTENNA-PATTERN] |
| 570 | # Indicates the possibility of Tx antenna pattern change |
| 571 | # 0 = Tx antenna pattern might change during the lifetime of an association |
| 572 | # 1 = Tx antenna pattern does not change during the lifetime of an association |
| 573 | #vht_capab=[SHORT-GI-80][HTC-VHT] |
Dmitry Shmidt | 61d9df3 | 2012-08-29 16:22:06 -0700 | [diff] [blame] | 574 | # |
| 575 | # Require stations to support VHT PHY (reject association if they do not) |
| 576 | #require_vht=1 |
| 577 | |
| 578 | # 0 = 20 or 40 MHz operating Channel width |
| 579 | # 1 = 80 MHz channel width |
| 580 | # 2 = 160 MHz channel width |
| 581 | # 3 = 80+80 MHz channel width |
Dmitry Shmidt | 0494959 | 2012-07-19 12:16:46 -0700 | [diff] [blame] | 582 | #vht_oper_chwidth=1 |
Dmitry Shmidt | 61d9df3 | 2012-08-29 16:22:06 -0700 | [diff] [blame] | 583 | # |
| 584 | # center freq = 5 GHz + (5 * index) |
| 585 | # So index 42 gives center freq 5.210 GHz |
| 586 | # which is channel 42 in 5G band |
| 587 | # |
| 588 | #vht_oper_centr_freq_seg0_idx=42 |
Dmitry Shmidt | d5e4923 | 2012-12-03 15:08:10 -0800 | [diff] [blame] | 589 | # |
| 590 | # center freq = 5 GHz + (5 * index) |
| 591 | # So index 159 gives center freq 5.795 GHz |
| 592 | # which is channel 159 in 5G band |
| 593 | # |
| 594 | #vht_oper_centr_freq_seg1_idx=159 |
Dmitry Shmidt | 0494959 | 2012-07-19 12:16:46 -0700 | [diff] [blame] | 595 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 596 | ##### IEEE 802.1X-2004 related configuration ################################## |
| 597 | |
| 598 | # Require IEEE 802.1X authorization |
| 599 | #ieee8021x=1 |
| 600 | |
| 601 | # IEEE 802.1X/EAPOL version |
| 602 | # hostapd is implemented based on IEEE Std 802.1X-2004 which defines EAPOL |
| 603 | # version 2. However, there are many client implementations that do not handle |
| 604 | # the new version number correctly (they seem to drop the frames completely). |
| 605 | # In order to make hostapd interoperate with these clients, the version number |
| 606 | # can be set to the older version (1) with this configuration value. |
| 607 | #eapol_version=2 |
| 608 | |
| 609 | # Optional displayable message sent with EAP Request-Identity. The first \0 |
| 610 | # in this string will be converted to ASCII-0 (nul). This can be used to |
| 611 | # separate network info (comma separated list of attribute=value pairs); see, |
| 612 | # e.g., RFC 4284. |
| 613 | #eap_message=hello |
| 614 | #eap_message=hello\0networkid=netw,nasid=foo,portid=0,NAIRealms=example.com |
| 615 | |
| 616 | # WEP rekeying (disabled if key lengths are not set or are set to 0) |
| 617 | # Key lengths for default/broadcast and individual/unicast keys: |
| 618 | # 5 = 40-bit WEP (also known as 64-bit WEP with 40 secret bits) |
| 619 | # 13 = 104-bit WEP (also known as 128-bit WEP with 104 secret bits) |
| 620 | #wep_key_len_broadcast=5 |
| 621 | #wep_key_len_unicast=5 |
| 622 | # Rekeying period in seconds. 0 = do not rekey (i.e., set keys only once) |
| 623 | #wep_rekey_period=300 |
| 624 | |
| 625 | # EAPOL-Key index workaround (set bit7) for WinXP Supplicant (needed only if |
| 626 | # only broadcast keys are used) |
| 627 | eapol_key_index_workaround=0 |
| 628 | |
| 629 | # EAP reauthentication period in seconds (default: 3600 seconds; 0 = disable |
| 630 | # reauthentication). |
| 631 | #eap_reauth_period=3600 |
| 632 | |
| 633 | # Use PAE group address (01:80:c2:00:00:03) instead of individual target |
| 634 | # address when sending EAPOL frames with driver=wired. This is the most common |
| 635 | # mechanism used in wired authentication, but it also requires that the port |
| 636 | # is only used by one station. |
| 637 | #use_pae_group_addr=1 |
| 638 | |
| 639 | ##### Integrated EAP server ################################################### |
| 640 | |
| 641 | # Optionally, hostapd can be configured to use an integrated EAP server |
| 642 | # to process EAP authentication locally without need for an external RADIUS |
| 643 | # server. This functionality can be used both as a local authentication server |
| 644 | # for IEEE 802.1X/EAPOL and as a RADIUS server for other devices. |
| 645 | |
| 646 | # Use integrated EAP server instead of external RADIUS authentication |
| 647 | # server. This is also needed if hostapd is configured to act as a RADIUS |
| 648 | # authentication server. |
| 649 | eap_server=0 |
| 650 | |
| 651 | # Path for EAP server user database |
Dmitry Shmidt | d5e4923 | 2012-12-03 15:08:10 -0800 | [diff] [blame] | 652 | # If SQLite support is included, this can be set to "sqlite:/path/to/sqlite.db" |
| 653 | # to use SQLite database instead of a text file. |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 654 | #eap_user_file=/etc/hostapd.eap_user |
| 655 | |
| 656 | # CA certificate (PEM or DER file) for EAP-TLS/PEAP/TTLS |
| 657 | #ca_cert=/etc/hostapd.ca.pem |
| 658 | |
| 659 | # Server certificate (PEM or DER file) for EAP-TLS/PEAP/TTLS |
| 660 | #server_cert=/etc/hostapd.server.pem |
| 661 | |
| 662 | # Private key matching with the server certificate for EAP-TLS/PEAP/TTLS |
| 663 | # This may point to the same file as server_cert if both certificate and key |
| 664 | # are included in a single file. PKCS#12 (PFX) file (.p12/.pfx) can also be |
| 665 | # used by commenting out server_cert and specifying the PFX file as the |
| 666 | # private_key. |
| 667 | #private_key=/etc/hostapd.server.prv |
| 668 | |
| 669 | # Passphrase for private key |
| 670 | #private_key_passwd=secret passphrase |
| 671 | |
Dmitry Shmidt | 34af306 | 2013-07-11 10:46:32 -0700 | [diff] [blame] | 672 | # Server identity |
| 673 | # EAP methods that provide mechanism for authenticated server identity delivery |
| 674 | # use this value. If not set, "hostapd" is used as a default. |
| 675 | #server_id=server.example.com |
| 676 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 677 | # Enable CRL verification. |
| 678 | # Note: hostapd does not yet support CRL downloading based on CDP. Thus, a |
| 679 | # valid CRL signed by the CA is required to be included in the ca_cert file. |
| 680 | # This can be done by using PEM format for CA certificate and CRL and |
| 681 | # concatenating these into one file. Whenever CRL changes, hostapd needs to be |
| 682 | # restarted to take the new CRL into use. |
| 683 | # 0 = do not verify CRLs (default) |
| 684 | # 1 = check the CRL of the user certificate |
| 685 | # 2 = check all CRLs in the certificate path |
| 686 | #check_crl=1 |
| 687 | |
Dmitry Shmidt | 34af306 | 2013-07-11 10:46:32 -0700 | [diff] [blame] | 688 | # Cached OCSP stapling response (DER encoded) |
| 689 | # If set, this file is sent as a certificate status response by the EAP server |
| 690 | # if the EAP peer requests certificate status in the ClientHello message. |
| 691 | # This cache file can be updated, e.g., by running following command |
| 692 | # periodically to get an update from the OCSP responder: |
| 693 | # openssl ocsp \ |
| 694 | # -no_nonce \ |
| 695 | # -CAfile /etc/hostapd.ca.pem \ |
| 696 | # -issuer /etc/hostapd.ca.pem \ |
| 697 | # -cert /etc/hostapd.server.pem \ |
| 698 | # -url http://ocsp.example.com:8888/ \ |
| 699 | # -respout /tmp/ocsp-cache.der |
| 700 | #ocsp_stapling_response=/tmp/ocsp-cache.der |
| 701 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 702 | # dh_file: File path to DH/DSA parameters file (in PEM format) |
| 703 | # This is an optional configuration file for setting parameters for an |
| 704 | # ephemeral DH key exchange. In most cases, the default RSA authentication does |
| 705 | # not use this configuration. However, it is possible setup RSA to use |
| 706 | # ephemeral DH key exchange. In addition, ciphers with DSA keys always use |
| 707 | # ephemeral DH keys. This can be used to achieve forward secrecy. If the file |
| 708 | # is in DSA parameters format, it will be automatically converted into DH |
| 709 | # params. This parameter is required if anonymous EAP-FAST is used. |
| 710 | # You can generate DH parameters file with OpenSSL, e.g., |
| 711 | # "openssl dhparam -out /etc/hostapd.dh.pem 1024" |
| 712 | #dh_file=/etc/hostapd.dh.pem |
| 713 | |
| 714 | # Fragment size for EAP methods |
| 715 | #fragment_size=1400 |
| 716 | |
Dmitry Shmidt | 1f69aa5 | 2012-01-24 16:10:04 -0800 | [diff] [blame] | 717 | # Finite cyclic group for EAP-pwd. Number maps to group of domain parameters |
| 718 | # using the IANA repository for IKE (RFC 2409). |
| 719 | #pwd_group=19 |
| 720 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 721 | # Configuration data for EAP-SIM database/authentication gateway interface. |
| 722 | # This is a text string in implementation specific format. The example |
| 723 | # implementation in eap_sim_db.c uses this as the UNIX domain socket name for |
| 724 | # the HLR/AuC gateway (e.g., hlr_auc_gw). In this case, the path uses "unix:" |
Dmitry Shmidt | 4530cfd | 2012-09-09 15:20:40 -0700 | [diff] [blame] | 725 | # prefix. If hostapd is built with SQLite support (CONFIG_SQLITE=y in .config), |
| 726 | # database file can be described with an optional db=<path> parameter. |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 727 | #eap_sim_db=unix:/tmp/hlr_auc_gw.sock |
Dmitry Shmidt | 4530cfd | 2012-09-09 15:20:40 -0700 | [diff] [blame] | 728 | #eap_sim_db=unix:/tmp/hlr_auc_gw.sock db=/tmp/hostapd.db |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 729 | |
| 730 | # Encryption key for EAP-FAST PAC-Opaque values. This key must be a secret, |
| 731 | # random value. It is configured as a 16-octet value in hex format. It can be |
| 732 | # generated, e.g., with the following command: |
| 733 | # od -tx1 -v -N16 /dev/random | colrm 1 8 | tr -d ' ' |
| 734 | #pac_opaque_encr_key=000102030405060708090a0b0c0d0e0f |
| 735 | |
| 736 | # EAP-FAST authority identity (A-ID) |
| 737 | # A-ID indicates the identity of the authority that issues PACs. The A-ID |
| 738 | # should be unique across all issuing servers. In theory, this is a variable |
| 739 | # length field, but due to some existing implementations requiring A-ID to be |
| 740 | # 16 octets in length, it is strongly recommended to use that length for the |
| 741 | # field to provid interoperability with deployed peer implementations. This |
| 742 | # field is configured in hex format. |
| 743 | #eap_fast_a_id=101112131415161718191a1b1c1d1e1f |
| 744 | |
| 745 | # EAP-FAST authority identifier information (A-ID-Info) |
| 746 | # This is a user-friendly name for the A-ID. For example, the enterprise name |
| 747 | # and server name in a human-readable format. This field is encoded as UTF-8. |
| 748 | #eap_fast_a_id_info=test server |
| 749 | |
| 750 | # Enable/disable different EAP-FAST provisioning modes: |
| 751 | #0 = provisioning disabled |
| 752 | #1 = only anonymous provisioning allowed |
| 753 | #2 = only authenticated provisioning allowed |
| 754 | #3 = both provisioning modes allowed (default) |
| 755 | #eap_fast_prov=3 |
| 756 | |
| 757 | # EAP-FAST PAC-Key lifetime in seconds (hard limit) |
| 758 | #pac_key_lifetime=604800 |
| 759 | |
| 760 | # EAP-FAST PAC-Key refresh time in seconds (soft limit on remaining hard |
| 761 | # limit). The server will generate a new PAC-Key when this number of seconds |
| 762 | # (or fewer) of the lifetime remains. |
| 763 | #pac_key_refresh_time=86400 |
| 764 | |
| 765 | # EAP-SIM and EAP-AKA protected success/failure indication using AT_RESULT_IND |
| 766 | # (default: 0 = disabled). |
| 767 | #eap_sim_aka_result_ind=1 |
| 768 | |
| 769 | # Trusted Network Connect (TNC) |
| 770 | # If enabled, TNC validation will be required before the peer is allowed to |
| 771 | # connect. Note: This is only used with EAP-TTLS and EAP-FAST. If any other |
| 772 | # EAP method is enabled, the peer will be allowed to connect without TNC. |
| 773 | #tnc=1 |
| 774 | |
| 775 | |
| 776 | ##### IEEE 802.11f - Inter-Access Point Protocol (IAPP) ####################### |
| 777 | |
| 778 | # Interface to be used for IAPP broadcast packets |
| 779 | #iapp_interface=eth0 |
| 780 | |
| 781 | |
| 782 | ##### RADIUS client configuration ############################################# |
| 783 | # for IEEE 802.1X with external Authentication Server, IEEE 802.11 |
| 784 | # authentication with external ACL for MAC addresses, and accounting |
| 785 | |
| 786 | # The own IP address of the access point (used as NAS-IP-Address) |
| 787 | own_ip_addr=127.0.0.1 |
| 788 | |
| 789 | # Optional NAS-Identifier string for RADIUS messages. When used, this should be |
| 790 | # a unique to the NAS within the scope of the RADIUS server. For example, a |
| 791 | # fully qualified domain name can be used here. |
| 792 | # When using IEEE 802.11r, nas_identifier must be set and must be between 1 and |
| 793 | # 48 octets long. |
| 794 | #nas_identifier=ap.example.com |
| 795 | |
| 796 | # RADIUS authentication server |
| 797 | #auth_server_addr=127.0.0.1 |
| 798 | #auth_server_port=1812 |
| 799 | #auth_server_shared_secret=secret |
| 800 | |
| 801 | # RADIUS accounting server |
| 802 | #acct_server_addr=127.0.0.1 |
| 803 | #acct_server_port=1813 |
| 804 | #acct_server_shared_secret=secret |
| 805 | |
| 806 | # Secondary RADIUS servers; to be used if primary one does not reply to |
| 807 | # RADIUS packets. These are optional and there can be more than one secondary |
| 808 | # server listed. |
| 809 | #auth_server_addr=127.0.0.2 |
| 810 | #auth_server_port=1812 |
| 811 | #auth_server_shared_secret=secret2 |
| 812 | # |
| 813 | #acct_server_addr=127.0.0.2 |
| 814 | #acct_server_port=1813 |
| 815 | #acct_server_shared_secret=secret2 |
| 816 | |
| 817 | # Retry interval for trying to return to the primary RADIUS server (in |
| 818 | # seconds). RADIUS client code will automatically try to use the next server |
| 819 | # when the current server is not replying to requests. If this interval is set, |
| 820 | # primary server will be retried after configured amount of time even if the |
| 821 | # currently used secondary server is still working. |
| 822 | #radius_retry_primary_interval=600 |
| 823 | |
| 824 | |
| 825 | # Interim accounting update interval |
| 826 | # If this is set (larger than 0) and acct_server is configured, hostapd will |
| 827 | # send interim accounting updates every N seconds. Note: if set, this overrides |
| 828 | # possible Acct-Interim-Interval attribute in Access-Accept message. Thus, this |
| 829 | # value should not be configured in hostapd.conf, if RADIUS server is used to |
| 830 | # control the interim interval. |
| 831 | # This value should not be less 600 (10 minutes) and must not be less than |
| 832 | # 60 (1 minute). |
| 833 | #radius_acct_interim_interval=600 |
| 834 | |
Dmitry Shmidt | 0494959 | 2012-07-19 12:16:46 -0700 | [diff] [blame] | 835 | # Request Chargeable-User-Identity (RFC 4372) |
| 836 | # This parameter can be used to configure hostapd to request CUI from the |
| 837 | # RADIUS server by including Chargeable-User-Identity attribute into |
| 838 | # Access-Request packets. |
| 839 | #radius_request_cui=1 |
| 840 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 841 | # Dynamic VLAN mode; allow RADIUS authentication server to decide which VLAN |
| 842 | # is used for the stations. This information is parsed from following RADIUS |
| 843 | # attributes based on RFC 3580 and RFC 2868: Tunnel-Type (value 13 = VLAN), |
| 844 | # Tunnel-Medium-Type (value 6 = IEEE 802), Tunnel-Private-Group-ID (value |
Dmitry Shmidt | 4b06059 | 2013-04-29 16:42:49 -0700 | [diff] [blame] | 845 | # VLANID as a string). Optionally, the local MAC ACL list (accept_mac_file) can |
| 846 | # be used to set static client MAC address to VLAN ID mapping. |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 847 | # 0 = disabled (default) |
| 848 | # 1 = option; use default interface if RADIUS server does not include VLAN ID |
| 849 | # 2 = required; reject authentication if RADIUS server does not include VLAN ID |
| 850 | #dynamic_vlan=0 |
| 851 | |
| 852 | # VLAN interface list for dynamic VLAN mode is read from a separate text file. |
| 853 | # This list is used to map VLAN ID from the RADIUS server to a network |
| 854 | # interface. Each station is bound to one interface in the same way as with |
| 855 | # multiple BSSIDs or SSIDs. Each line in this text file is defining a new |
| 856 | # interface and the line must include VLAN ID and interface name separated by |
| 857 | # white space (space or tab). |
Dmitry Shmidt | 4b06059 | 2013-04-29 16:42:49 -0700 | [diff] [blame] | 858 | # If no entries are provided by this file, the station is statically mapped |
| 859 | # to <bss-iface>.<vlan-id> interfaces. |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 860 | #vlan_file=/etc/hostapd.vlan |
| 861 | |
| 862 | # Interface where 802.1q tagged packets should appear when a RADIUS server is |
| 863 | # used to determine which VLAN a station is on. hostapd creates a bridge for |
| 864 | # each VLAN. Then hostapd adds a VLAN interface (associated with the interface |
| 865 | # indicated by 'vlan_tagged_interface') and the appropriate wireless interface |
| 866 | # to the bridge. |
| 867 | #vlan_tagged_interface=eth0 |
| 868 | |
Dmitry Shmidt | 34af306 | 2013-07-11 10:46:32 -0700 | [diff] [blame] | 869 | # Bridge (prefix) to add the wifi and the tagged interface to. This gets the |
| 870 | # VLAN ID appended. It defaults to brvlan%d if no tagged interface is given |
| 871 | # and br%s.%d if a tagged interface is given, provided %s = tagged interface |
| 872 | # and %d = VLAN ID. |
| 873 | #vlan_bridge=brvlan |
| 874 | |
Dmitry Shmidt | 61d9df3 | 2012-08-29 16:22:06 -0700 | [diff] [blame] | 875 | # When hostapd creates a VLAN interface on vlan_tagged_interfaces, it needs |
| 876 | # to know how to name it. |
| 877 | # 0 = vlan<XXX>, e.g., vlan1 |
| 878 | # 1 = <vlan_tagged_interface>.<XXX>, e.g. eth0.1 |
| 879 | #vlan_naming=0 |
| 880 | |
Dmitry Shmidt | 0494959 | 2012-07-19 12:16:46 -0700 | [diff] [blame] | 881 | # Arbitrary RADIUS attributes can be added into Access-Request and |
| 882 | # Accounting-Request packets by specifying the contents of the attributes with |
| 883 | # the following configuration parameters. There can be multiple of these to |
| 884 | # add multiple attributes. These parameters can also be used to override some |
| 885 | # of the attributes added automatically by hostapd. |
| 886 | # Format: <attr_id>[:<syntax:value>] |
| 887 | # attr_id: RADIUS attribute type (e.g., 26 = Vendor-Specific) |
| 888 | # syntax: s = string (UTF-8), d = integer, x = octet string |
| 889 | # value: attribute value in format indicated by the syntax |
| 890 | # If syntax and value parts are omitted, a null value (single 0x00 octet) is |
| 891 | # used. |
| 892 | # |
| 893 | # Additional Access-Request attributes |
| 894 | # radius_auth_req_attr=<attr_id>[:<syntax:value>] |
| 895 | # Examples: |
| 896 | # Operator-Name = "Operator" |
| 897 | #radius_auth_req_attr=126:s:Operator |
| 898 | # Service-Type = Framed (2) |
| 899 | #radius_auth_req_attr=6:d:2 |
| 900 | # Connect-Info = "testing" (this overrides the automatically generated value) |
| 901 | #radius_auth_req_attr=77:s:testing |
| 902 | # Same Connect-Info value set as a hexdump |
| 903 | #radius_auth_req_attr=77:x:74657374696e67 |
| 904 | |
| 905 | # |
| 906 | # Additional Accounting-Request attributes |
| 907 | # radius_acct_req_attr=<attr_id>[:<syntax:value>] |
| 908 | # Examples: |
| 909 | # Operator-Name = "Operator" |
| 910 | #radius_acct_req_attr=126:s:Operator |
| 911 | |
| 912 | # Dynamic Authorization Extensions (RFC 5176) |
| 913 | # This mechanism can be used to allow dynamic changes to user session based on |
| 914 | # commands from a RADIUS server (or some other disconnect client that has the |
| 915 | # needed session information). For example, Disconnect message can be used to |
| 916 | # request an associated station to be disconnected. |
| 917 | # |
| 918 | # This is disabled by default. Set radius_das_port to non-zero UDP port |
| 919 | # number to enable. |
| 920 | #radius_das_port=3799 |
| 921 | # |
| 922 | # DAS client (the host that can send Disconnect/CoA requests) and shared secret |
| 923 | #radius_das_client=192.168.1.123 shared secret here |
| 924 | # |
| 925 | # DAS Event-Timestamp time window in seconds |
| 926 | #radius_das_time_window=300 |
| 927 | # |
| 928 | # DAS require Event-Timestamp |
| 929 | #radius_das_require_event_timestamp=1 |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 930 | |
| 931 | ##### RADIUS authentication server configuration ############################## |
| 932 | |
| 933 | # hostapd can be used as a RADIUS authentication server for other hosts. This |
| 934 | # requires that the integrated EAP server is also enabled and both |
| 935 | # authentication services are sharing the same configuration. |
| 936 | |
| 937 | # File name of the RADIUS clients configuration for the RADIUS server. If this |
| 938 | # commented out, RADIUS server is disabled. |
| 939 | #radius_server_clients=/etc/hostapd.radius_clients |
| 940 | |
| 941 | # The UDP port number for the RADIUS authentication server |
| 942 | #radius_server_auth_port=1812 |
| 943 | |
| 944 | # Use IPv6 with RADIUS server (IPv4 will also be supported using IPv6 API) |
| 945 | #radius_server_ipv6=1 |
| 946 | |
| 947 | |
| 948 | ##### WPA/IEEE 802.11i configuration ########################################## |
| 949 | |
| 950 | # Enable WPA. Setting this variable configures the AP to require WPA (either |
| 951 | # WPA-PSK or WPA-RADIUS/EAP based on other configuration). For WPA-PSK, either |
| 952 | # wpa_psk or wpa_passphrase must be set and wpa_key_mgmt must include WPA-PSK. |
Dmitry Shmidt | 1f69aa5 | 2012-01-24 16:10:04 -0800 | [diff] [blame] | 953 | # Instead of wpa_psk / wpa_passphrase, wpa_psk_radius might suffice. |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 954 | # For WPA-RADIUS/EAP, ieee8021x must be set (but without dynamic WEP keys), |
| 955 | # RADIUS authentication server must be configured, and WPA-EAP must be included |
| 956 | # in wpa_key_mgmt. |
| 957 | # This field is a bit field that can be used to enable WPA (IEEE 802.11i/D3.0) |
| 958 | # and/or WPA2 (full IEEE 802.11i/RSN): |
| 959 | # bit0 = WPA |
| 960 | # bit1 = IEEE 802.11i/RSN (WPA2) (dot11RSNAEnabled) |
| 961 | #wpa=1 |
| 962 | |
| 963 | # WPA pre-shared keys for WPA-PSK. This can be either entered as a 256-bit |
| 964 | # secret in hex format (64 hex digits), wpa_psk, or as an ASCII passphrase |
| 965 | # (8..63 characters) that will be converted to PSK. This conversion uses SSID |
| 966 | # so the PSK changes when ASCII passphrase is used and the SSID is changed. |
| 967 | # wpa_psk (dot11RSNAConfigPSKValue) |
| 968 | # wpa_passphrase (dot11RSNAConfigPSKPassPhrase) |
| 969 | #wpa_psk=0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef |
| 970 | #wpa_passphrase=secret passphrase |
| 971 | |
| 972 | # Optionally, WPA PSKs can be read from a separate text file (containing list |
| 973 | # of (PSK,MAC address) pairs. This allows more than one PSK to be configured. |
| 974 | # Use absolute path name to make sure that the files can be read on SIGHUP |
| 975 | # configuration reloads. |
| 976 | #wpa_psk_file=/etc/hostapd.wpa_psk |
| 977 | |
Dmitry Shmidt | 1f69aa5 | 2012-01-24 16:10:04 -0800 | [diff] [blame] | 978 | # Optionally, WPA passphrase can be received from RADIUS authentication server |
| 979 | # This requires macaddr_acl to be set to 2 (RADIUS) |
| 980 | # 0 = disabled (default) |
| 981 | # 1 = optional; use default passphrase/psk if RADIUS server does not include |
| 982 | # Tunnel-Password |
| 983 | # 2 = required; reject authentication if RADIUS server does not include |
| 984 | # Tunnel-Password |
| 985 | #wpa_psk_radius=0 |
| 986 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 987 | # Set of accepted key management algorithms (WPA-PSK, WPA-EAP, or both). The |
| 988 | # entries are separated with a space. WPA-PSK-SHA256 and WPA-EAP-SHA256 can be |
| 989 | # added to enable SHA256-based stronger algorithms. |
| 990 | # (dot11RSNAConfigAuthenticationSuitesTable) |
| 991 | #wpa_key_mgmt=WPA-PSK WPA-EAP |
| 992 | |
| 993 | # Set of accepted cipher suites (encryption algorithms) for pairwise keys |
| 994 | # (unicast packets). This is a space separated list of algorithms: |
| 995 | # CCMP = AES in Counter mode with CBC-MAC [RFC 3610, IEEE 802.11i/D7.0] |
| 996 | # TKIP = Temporal Key Integrity Protocol [IEEE 802.11i/D7.0] |
| 997 | # Group cipher suite (encryption algorithm for broadcast and multicast frames) |
| 998 | # is automatically selected based on this configuration. If only CCMP is |
| 999 | # allowed as the pairwise cipher, group cipher will also be CCMP. Otherwise, |
| 1000 | # TKIP will be used as the group cipher. |
| 1001 | # (dot11RSNAConfigPairwiseCiphersTable) |
| 1002 | # Pairwise cipher for WPA (v1) (default: TKIP) |
| 1003 | #wpa_pairwise=TKIP CCMP |
| 1004 | # Pairwise cipher for RSN/WPA2 (default: use wpa_pairwise value) |
| 1005 | #rsn_pairwise=CCMP |
| 1006 | |
| 1007 | # Time interval for rekeying GTK (broadcast/multicast encryption keys) in |
| 1008 | # seconds. (dot11RSNAConfigGroupRekeyTime) |
| 1009 | #wpa_group_rekey=600 |
| 1010 | |
| 1011 | # Rekey GTK when any STA that possesses the current GTK is leaving the BSS. |
| 1012 | # (dot11RSNAConfigGroupRekeyStrict) |
| 1013 | #wpa_strict_rekey=1 |
| 1014 | |
| 1015 | # Time interval for rekeying GMK (master key used internally to generate GTKs |
| 1016 | # (in seconds). |
| 1017 | #wpa_gmk_rekey=86400 |
| 1018 | |
| 1019 | # Maximum lifetime for PTK in seconds. This can be used to enforce rekeying of |
| 1020 | # PTK to mitigate some attacks against TKIP deficiencies. |
| 1021 | #wpa_ptk_rekey=600 |
| 1022 | |
| 1023 | # Enable IEEE 802.11i/RSN/WPA2 pre-authentication. This is used to speed up |
| 1024 | # roaming be pre-authenticating IEEE 802.1X/EAP part of the full RSN |
| 1025 | # authentication and key handshake before actually associating with a new AP. |
| 1026 | # (dot11RSNAPreauthenticationEnabled) |
| 1027 | #rsn_preauth=1 |
| 1028 | # |
| 1029 | # Space separated list of interfaces from which pre-authentication frames are |
| 1030 | # accepted (e.g., 'eth0' or 'eth0 wlan0wds0'. This list should include all |
| 1031 | # interface that are used for connections to other APs. This could include |
| 1032 | # wired interfaces and WDS links. The normal wireless data interface towards |
| 1033 | # associated stations (e.g., wlan0) should not be added, since |
| 1034 | # pre-authentication is only used with APs other than the currently associated |
| 1035 | # one. |
| 1036 | #rsn_preauth_interfaces=eth0 |
| 1037 | |
| 1038 | # peerkey: Whether PeerKey negotiation for direct links (IEEE 802.11e) is |
| 1039 | # allowed. This is only used with RSN/WPA2. |
| 1040 | # 0 = disabled (default) |
| 1041 | # 1 = enabled |
| 1042 | #peerkey=1 |
| 1043 | |
| 1044 | # ieee80211w: Whether management frame protection (MFP) is enabled |
| 1045 | # 0 = disabled (default) |
| 1046 | # 1 = optional |
| 1047 | # 2 = required |
| 1048 | #ieee80211w=0 |
| 1049 | |
| 1050 | # Association SA Query maximum timeout (in TU = 1.024 ms; for MFP) |
| 1051 | # (maximum time to wait for a SA Query response) |
| 1052 | # dot11AssociationSAQueryMaximumTimeout, 1...4294967295 |
| 1053 | #assoc_sa_query_max_timeout=1000 |
| 1054 | |
| 1055 | # Association SA Query retry timeout (in TU = 1.024 ms; for MFP) |
| 1056 | # (time between two subsequent SA Query requests) |
| 1057 | # dot11AssociationSAQueryRetryTimeout, 1...4294967295 |
| 1058 | #assoc_sa_query_retry_timeout=201 |
| 1059 | |
Dmitry Shmidt | c55524a | 2011-07-07 11:18:38 -0700 | [diff] [blame] | 1060 | # disable_pmksa_caching: Disable PMKSA caching |
| 1061 | # This parameter can be used to disable caching of PMKSA created through EAP |
| 1062 | # authentication. RSN preauthentication may still end up using PMKSA caching if |
| 1063 | # it is enabled (rsn_preauth=1). |
| 1064 | # 0 = PMKSA caching enabled (default) |
| 1065 | # 1 = PMKSA caching disabled |
| 1066 | #disable_pmksa_caching=0 |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 1067 | |
| 1068 | # okc: Opportunistic Key Caching (aka Proactive Key Caching) |
| 1069 | # Allow PMK cache to be shared opportunistically among configured interfaces |
| 1070 | # and BSSes (i.e., all configurations within a single hostapd process). |
| 1071 | # 0 = disabled (default) |
| 1072 | # 1 = enabled |
| 1073 | #okc=1 |
| 1074 | |
Dmitry Shmidt | a54fa5f | 2013-01-15 13:53:35 -0800 | [diff] [blame] | 1075 | # SAE threshold for anti-clogging mechanism (dot11RSNASAEAntiCloggingThreshold) |
| 1076 | # This parameter defines how many open SAE instances can be in progress at the |
| 1077 | # same time before the anti-clogging mechanism is taken into use. |
| 1078 | #sae_anti_clogging_threshold=5 |
| 1079 | |
| 1080 | # Enabled SAE finite cyclic groups |
| 1081 | # SAE implementation are required to support group 19 (ECC group defined over a |
| 1082 | # 256-bit prime order field). All groups that are supported by the |
| 1083 | # implementation are enabled by default. This configuration parameter can be |
| 1084 | # used to specify a limited set of allowed groups. The group values are listed |
| 1085 | # in the IANA registry: |
| 1086 | # http://www.iana.org/assignments/ipsec-registry/ipsec-registry.xml#ipsec-registry-9 |
| 1087 | #sae_groups=19 20 21 25 26 |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 1088 | |
| 1089 | ##### IEEE 802.11r configuration ############################################## |
| 1090 | |
| 1091 | # Mobility Domain identifier (dot11FTMobilityDomainID, MDID) |
| 1092 | # MDID is used to indicate a group of APs (within an ESS, i.e., sharing the |
| 1093 | # same SSID) between which a STA can use Fast BSS Transition. |
| 1094 | # 2-octet identifier as a hex string. |
| 1095 | #mobility_domain=a1b2 |
| 1096 | |
| 1097 | # PMK-R0 Key Holder identifier (dot11FTR0KeyHolderID) |
| 1098 | # 1 to 48 octet identifier. |
| 1099 | # This is configured with nas_identifier (see RADIUS client section above). |
| 1100 | |
| 1101 | # Default lifetime of the PMK-RO in minutes; range 1..65535 |
| 1102 | # (dot11FTR0KeyLifetime) |
| 1103 | #r0_key_lifetime=10000 |
| 1104 | |
| 1105 | # PMK-R1 Key Holder identifier (dot11FTR1KeyHolderID) |
| 1106 | # 6-octet identifier as a hex string. |
| 1107 | #r1_key_holder=000102030405 |
| 1108 | |
| 1109 | # Reassociation deadline in time units (TUs / 1.024 ms; range 1000..65535) |
| 1110 | # (dot11FTReassociationDeadline) |
| 1111 | #reassociation_deadline=1000 |
| 1112 | |
| 1113 | # List of R0KHs in the same Mobility Domain |
| 1114 | # format: <MAC address> <NAS Identifier> <128-bit key as hex string> |
| 1115 | # This list is used to map R0KH-ID (NAS Identifier) to a destination MAC |
| 1116 | # address when requesting PMK-R1 key from the R0KH that the STA used during the |
| 1117 | # Initial Mobility Domain Association. |
| 1118 | #r0kh=02:01:02:03:04:05 r0kh-1.example.com 000102030405060708090a0b0c0d0e0f |
| 1119 | #r0kh=02:01:02:03:04:06 r0kh-2.example.com 00112233445566778899aabbccddeeff |
| 1120 | # And so on.. One line per R0KH. |
| 1121 | |
| 1122 | # List of R1KHs in the same Mobility Domain |
| 1123 | # format: <MAC address> <R1KH-ID> <128-bit key as hex string> |
| 1124 | # This list is used to map R1KH-ID to a destination MAC address when sending |
| 1125 | # PMK-R1 key from the R0KH. This is also the list of authorized R1KHs in the MD |
| 1126 | # that can request PMK-R1 keys. |
| 1127 | #r1kh=02:01:02:03:04:05 02:11:22:33:44:55 000102030405060708090a0b0c0d0e0f |
| 1128 | #r1kh=02:01:02:03:04:06 02:11:22:33:44:66 00112233445566778899aabbccddeeff |
| 1129 | # And so on.. One line per R1KH. |
| 1130 | |
| 1131 | # Whether PMK-R1 push is enabled at R0KH |
| 1132 | # 0 = do not push PMK-R1 to all configured R1KHs (default) |
| 1133 | # 1 = push PMK-R1 to all configured R1KHs whenever a new PMK-R0 is derived |
| 1134 | #pmk_r1_push=1 |
| 1135 | |
| 1136 | ##### Neighbor table ########################################################## |
| 1137 | # Maximum number of entries kept in AP table (either for neigbor table or for |
| 1138 | # detecting Overlapping Legacy BSS Condition). The oldest entry will be |
| 1139 | # removed when adding a new entry that would make the list grow over this |
| 1140 | # limit. Note! WFA certification for IEEE 802.11g requires that OLBC is |
| 1141 | # enabled, so this field should not be set to 0 when using IEEE 802.11g. |
| 1142 | # default: 255 |
| 1143 | #ap_table_max_size=255 |
| 1144 | |
| 1145 | # Number of seconds of no frames received after which entries may be deleted |
| 1146 | # from the AP table. Since passive scanning is not usually performed frequently |
| 1147 | # this should not be set to very small value. In addition, there is no |
| 1148 | # guarantee that every scan cycle will receive beacon frames from the |
| 1149 | # neighboring APs. |
| 1150 | # default: 60 |
| 1151 | #ap_table_expiration_time=3600 |
| 1152 | |
| 1153 | |
| 1154 | ##### Wi-Fi Protected Setup (WPS) ############################################# |
| 1155 | |
| 1156 | # WPS state |
| 1157 | # 0 = WPS disabled (default) |
| 1158 | # 1 = WPS enabled, not configured |
| 1159 | # 2 = WPS enabled, configured |
| 1160 | #wps_state=2 |
| 1161 | |
Dmitry Shmidt | 444d567 | 2013-04-01 13:08:44 -0700 | [diff] [blame] | 1162 | # Whether to manage this interface independently from other WPS interfaces |
| 1163 | # By default, a single hostapd process applies WPS operations to all configured |
| 1164 | # interfaces. This parameter can be used to disable that behavior for a subset |
| 1165 | # of interfaces. If this is set to non-zero for an interface, WPS commands |
| 1166 | # issued on that interface do not apply to other interfaces and WPS operations |
| 1167 | # performed on other interfaces do not affect this interface. |
| 1168 | #wps_independent=0 |
| 1169 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 1170 | # AP can be configured into a locked state where new WPS Registrar are not |
| 1171 | # accepted, but previously authorized Registrars (including the internal one) |
| 1172 | # can continue to add new Enrollees. |
| 1173 | #ap_setup_locked=1 |
| 1174 | |
| 1175 | # Universally Unique IDentifier (UUID; see RFC 4122) of the device |
| 1176 | # This value is used as the UUID for the internal WPS Registrar. If the AP |
| 1177 | # is also using UPnP, this value should be set to the device's UPnP UUID. |
| 1178 | # If not configured, UUID will be generated based on the local MAC address. |
| 1179 | #uuid=12345678-9abc-def0-1234-56789abcdef0 |
| 1180 | |
| 1181 | # Note: If wpa_psk_file is set, WPS is used to generate random, per-device PSKs |
| 1182 | # that will be appended to the wpa_psk_file. If wpa_psk_file is not set, the |
| 1183 | # default PSK (wpa_psk/wpa_passphrase) will be delivered to Enrollees. Use of |
| 1184 | # per-device PSKs is recommended as the more secure option (i.e., make sure to |
| 1185 | # set wpa_psk_file when using WPS with WPA-PSK). |
| 1186 | |
| 1187 | # When an Enrollee requests access to the network with PIN method, the Enrollee |
| 1188 | # PIN will need to be entered for the Registrar. PIN request notifications are |
| 1189 | # sent to hostapd ctrl_iface monitor. In addition, they can be written to a |
| 1190 | # text file that could be used, e.g., to populate the AP administration UI with |
| 1191 | # pending PIN requests. If the following variable is set, the PIN requests will |
| 1192 | # be written to the configured file. |
| 1193 | #wps_pin_requests=/var/run/hostapd_wps_pin_requests |
| 1194 | |
| 1195 | # Device Name |
| 1196 | # User-friendly description of device; up to 32 octets encoded in UTF-8 |
| 1197 | #device_name=Wireless AP |
| 1198 | |
| 1199 | # Manufacturer |
| 1200 | # The manufacturer of the device (up to 64 ASCII characters) |
| 1201 | #manufacturer=Company |
| 1202 | |
| 1203 | # Model Name |
| 1204 | # Model of the device (up to 32 ASCII characters) |
| 1205 | #model_name=WAP |
| 1206 | |
| 1207 | # Model Number |
| 1208 | # Additional device description (up to 32 ASCII characters) |
| 1209 | #model_number=123 |
| 1210 | |
| 1211 | # Serial Number |
| 1212 | # Serial number of the device (up to 32 characters) |
| 1213 | #serial_number=12345 |
| 1214 | |
| 1215 | # Primary Device Type |
| 1216 | # Used format: <categ>-<OUI>-<subcateg> |
| 1217 | # categ = Category as an integer value |
| 1218 | # OUI = OUI and type octet as a 4-octet hex-encoded value; 0050F204 for |
| 1219 | # default WPS OUI |
| 1220 | # subcateg = OUI-specific Sub Category as an integer value |
| 1221 | # Examples: |
| 1222 | # 1-0050F204-1 (Computer / PC) |
| 1223 | # 1-0050F204-2 (Computer / Server) |
| 1224 | # 5-0050F204-1 (Storage / NAS) |
| 1225 | # 6-0050F204-1 (Network Infrastructure / AP) |
| 1226 | #device_type=6-0050F204-1 |
| 1227 | |
| 1228 | # OS Version |
| 1229 | # 4-octet operating system version number (hex string) |
| 1230 | #os_version=01020300 |
| 1231 | |
| 1232 | # Config Methods |
| 1233 | # List of the supported configuration methods |
| 1234 | # Available methods: usba ethernet label display ext_nfc_token int_nfc_token |
| 1235 | # nfc_interface push_button keypad virtual_display physical_display |
| 1236 | # virtual_push_button physical_push_button |
| 1237 | #config_methods=label virtual_display virtual_push_button keypad |
| 1238 | |
Jouni Malinen | 87fd279 | 2011-05-16 18:35:42 +0300 | [diff] [blame] | 1239 | # WPS capability discovery workaround for PBC with Windows 7 |
| 1240 | # Windows 7 uses incorrect way of figuring out AP's WPS capabilities by acting |
| 1241 | # as a Registrar and using M1 from the AP. The config methods attribute in that |
| 1242 | # message is supposed to indicate only the configuration method supported by |
| 1243 | # the AP in Enrollee role, i.e., to add an external Registrar. For that case, |
| 1244 | # PBC shall not be used and as such, the PushButton config method is removed |
| 1245 | # from M1 by default. If pbc_in_m1=1 is included in the configuration file, |
| 1246 | # the PushButton config method is left in M1 (if included in config_methods |
| 1247 | # parameter) to allow Windows 7 to use PBC instead of PIN (e.g., from a label |
| 1248 | # in the AP). |
| 1249 | #pbc_in_m1=1 |
| 1250 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 1251 | # Static access point PIN for initial configuration and adding Registrars |
| 1252 | # If not set, hostapd will not allow external WPS Registrars to control the |
| 1253 | # access point. The AP PIN can also be set at runtime with hostapd_cli |
| 1254 | # wps_ap_pin command. Use of temporary (enabled by user action) and random |
| 1255 | # AP PIN is much more secure than configuring a static AP PIN here. As such, |
| 1256 | # use of the ap_pin parameter is not recommended if the AP device has means for |
| 1257 | # displaying a random PIN. |
| 1258 | #ap_pin=12345670 |
| 1259 | |
| 1260 | # Skip building of automatic WPS credential |
| 1261 | # This can be used to allow the automatically generated Credential attribute to |
| 1262 | # be replaced with pre-configured Credential(s). |
| 1263 | #skip_cred_build=1 |
| 1264 | |
| 1265 | # Additional Credential attribute(s) |
| 1266 | # This option can be used to add pre-configured Credential attributes into M8 |
| 1267 | # message when acting as a Registrar. If skip_cred_build=1, this data will also |
| 1268 | # be able to override the Credential attribute that would have otherwise been |
| 1269 | # automatically generated based on network configuration. This configuration |
| 1270 | # option points to an external file that much contain the WPS Credential |
| 1271 | # attribute(s) as binary data. |
| 1272 | #extra_cred=hostapd.cred |
| 1273 | |
| 1274 | # Credential processing |
| 1275 | # 0 = process received credentials internally (default) |
| 1276 | # 1 = do not process received credentials; just pass them over ctrl_iface to |
| 1277 | # external program(s) |
| 1278 | # 2 = process received credentials internally and pass them over ctrl_iface |
| 1279 | # to external program(s) |
| 1280 | # Note: With wps_cred_processing=1, skip_cred_build should be set to 1 and |
| 1281 | # extra_cred be used to provide the Credential data for Enrollees. |
| 1282 | # |
| 1283 | # wps_cred_processing=1 will disabled automatic updates of hostapd.conf file |
| 1284 | # both for Credential processing and for marking AP Setup Locked based on |
| 1285 | # validation failures of AP PIN. An external program is responsible on updating |
| 1286 | # the configuration appropriately in this case. |
| 1287 | #wps_cred_processing=0 |
| 1288 | |
| 1289 | # AP Settings Attributes for M7 |
| 1290 | # By default, hostapd generates the AP Settings Attributes for M7 based on the |
| 1291 | # current configuration. It is possible to override this by providing a file |
| 1292 | # with pre-configured attributes. This is similar to extra_cred file format, |
| 1293 | # but the AP Settings attributes are not encapsulated in a Credential |
| 1294 | # attribute. |
| 1295 | #ap_settings=hostapd.ap_settings |
| 1296 | |
| 1297 | # WPS UPnP interface |
| 1298 | # If set, support for external Registrars is enabled. |
| 1299 | #upnp_iface=br0 |
| 1300 | |
| 1301 | # Friendly Name (required for UPnP) |
| 1302 | # Short description for end use. Should be less than 64 characters. |
| 1303 | #friendly_name=WPS Access Point |
| 1304 | |
| 1305 | # Manufacturer URL (optional for UPnP) |
| 1306 | #manufacturer_url=http://www.example.com/ |
| 1307 | |
| 1308 | # Model Description (recommended for UPnP) |
| 1309 | # Long description for end user. Should be less than 128 characters. |
| 1310 | #model_description=Wireless Access Point |
| 1311 | |
| 1312 | # Model URL (optional for UPnP) |
| 1313 | #model_url=http://www.example.com/model/ |
| 1314 | |
| 1315 | # Universal Product Code (optional for UPnP) |
| 1316 | # 12-digit, all-numeric code that identifies the consumer package. |
| 1317 | #upc=123456789012 |
| 1318 | |
Dmitry Shmidt | 1f69aa5 | 2012-01-24 16:10:04 -0800 | [diff] [blame] | 1319 | # WPS RF Bands (a = 5G, b = 2.4G, g = 2.4G, ag = dual band) |
| 1320 | # This value should be set according to RF band(s) supported by the AP if |
| 1321 | # hw_mode is not set. For dual band dual concurrent devices, this needs to be |
| 1322 | # set to ag to allow both RF bands to be advertized. |
| 1323 | #wps_rf_bands=ag |
| 1324 | |
Dmitry Shmidt | 0494959 | 2012-07-19 12:16:46 -0700 | [diff] [blame] | 1325 | # NFC password token for WPS |
| 1326 | # These parameters can be used to configure a fixed NFC password token for the |
| 1327 | # AP. This can be generated, e.g., with nfc_pw_token from wpa_supplicant. When |
| 1328 | # these parameters are used, the AP is assumed to be deployed with a NFC tag |
| 1329 | # that includes the matching NFC password token (e.g., written based on the |
| 1330 | # NDEF record from nfc_pw_token). |
| 1331 | # |
| 1332 | #wps_nfc_dev_pw_id: Device Password ID (16..65535) |
| 1333 | #wps_nfc_dh_pubkey: Hexdump of DH Public Key |
| 1334 | #wps_nfc_dh_privkey: Hexdump of DH Private Key |
| 1335 | #wps_nfc_dev_pw: Hexdump of Device Password |
| 1336 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 1337 | ##### Wi-Fi Direct (P2P) ###################################################### |
| 1338 | |
| 1339 | # Enable P2P Device management |
| 1340 | #manage_p2p=1 |
| 1341 | |
| 1342 | # Allow cross connection |
| 1343 | #allow_cross_connection=1 |
| 1344 | |
| 1345 | #### TDLS (IEEE 802.11z-2010) ################################################# |
| 1346 | |
| 1347 | # Prohibit use of TDLS in this BSS |
| 1348 | #tdls_prohibit=1 |
| 1349 | |
| 1350 | # Prohibit use of TDLS Channel Switching in this BSS |
| 1351 | #tdls_prohibit_chan_switch=1 |
| 1352 | |
Dmitry Shmidt | 1f69aa5 | 2012-01-24 16:10:04 -0800 | [diff] [blame] | 1353 | ##### IEEE 802.11v-2011 ####################################################### |
| 1354 | |
| 1355 | # Time advertisement |
| 1356 | # 0 = disabled (default) |
| 1357 | # 2 = UTC time at which the TSF timer is 0 |
| 1358 | #time_advertisement=2 |
| 1359 | |
| 1360 | # Local time zone as specified in 8.3 of IEEE Std 1003.1-2004: |
| 1361 | # stdoffset[dst[offset][,start[/time],end[/time]]] |
| 1362 | #time_zone=EST5 |
| 1363 | |
Dmitry Shmidt | a54fa5f | 2013-01-15 13:53:35 -0800 | [diff] [blame] | 1364 | # WNM-Sleep Mode (extended sleep mode for stations) |
| 1365 | # 0 = disabled (default) |
| 1366 | # 1 = enabled (allow stations to use WNM-Sleep Mode) |
| 1367 | #wnm_sleep_mode=1 |
| 1368 | |
| 1369 | # BSS Transition Management |
| 1370 | # 0 = disabled (default) |
| 1371 | # 1 = enabled |
| 1372 | #bss_transition=1 |
| 1373 | |
Dmitry Shmidt | 1f69aa5 | 2012-01-24 16:10:04 -0800 | [diff] [blame] | 1374 | ##### IEEE 802.11u-2011 ####################################################### |
| 1375 | |
| 1376 | # Enable Interworking service |
| 1377 | #interworking=1 |
| 1378 | |
| 1379 | # Access Network Type |
| 1380 | # 0 = Private network |
| 1381 | # 1 = Private network with guest access |
| 1382 | # 2 = Chargeable public network |
| 1383 | # 3 = Free public network |
| 1384 | # 4 = Personal device network |
| 1385 | # 5 = Emergency services only network |
| 1386 | # 14 = Test or experimental |
| 1387 | # 15 = Wildcard |
| 1388 | #access_network_type=0 |
| 1389 | |
| 1390 | # Whether the network provides connectivity to the Internet |
| 1391 | # 0 = Unspecified |
| 1392 | # 1 = Network provides connectivity to the Internet |
| 1393 | #internet=1 |
| 1394 | |
| 1395 | # Additional Step Required for Access |
| 1396 | # Note: This is only used with open network, i.e., ASRA shall ne set to 0 if |
| 1397 | # RSN is used. |
| 1398 | #asra=0 |
| 1399 | |
| 1400 | # Emergency services reachable |
| 1401 | #esr=0 |
| 1402 | |
| 1403 | # Unauthenticated emergency service accessible |
| 1404 | #uesa=0 |
| 1405 | |
| 1406 | # Venue Info (optional) |
| 1407 | # The available values are defined in IEEE Std 802.11u-2011, 7.3.1.34. |
| 1408 | # Example values (group,type): |
| 1409 | # 0,0 = Unspecified |
| 1410 | # 1,7 = Convention Center |
| 1411 | # 1,13 = Coffee Shop |
| 1412 | # 2,0 = Unspecified Business |
| 1413 | # 7,1 Private Residence |
| 1414 | #venue_group=7 |
| 1415 | #venue_type=1 |
| 1416 | |
| 1417 | # Homogeneous ESS identifier (optional; dot11HESSID) |
| 1418 | # If set, this shall be identifical to one of the BSSIDs in the homogeneous |
| 1419 | # ESS and this shall be set to the same value across all BSSs in homogeneous |
| 1420 | # ESS. |
| 1421 | #hessid=02:03:04:05:06:07 |
| 1422 | |
| 1423 | # Roaming Consortium List |
| 1424 | # Arbitrary number of Roaming Consortium OIs can be configured with each line |
| 1425 | # adding a new OI to the list. The first three entries are available through |
| 1426 | # Beacon and Probe Response frames. Any additional entry will be available only |
Dmitry Shmidt | 61d9df3 | 2012-08-29 16:22:06 -0700 | [diff] [blame] | 1427 | # through ANQP queries. Each OI is between 3 and 15 octets and is configured as |
Dmitry Shmidt | 1f69aa5 | 2012-01-24 16:10:04 -0800 | [diff] [blame] | 1428 | # a hexstring. |
| 1429 | #roaming_consortium=021122 |
| 1430 | #roaming_consortium=2233445566 |
| 1431 | |
Dmitry Shmidt | 0494959 | 2012-07-19 12:16:46 -0700 | [diff] [blame] | 1432 | # Venue Name information |
| 1433 | # This parameter can be used to configure one or more Venue Name Duples for |
| 1434 | # Venue Name ANQP information. Each entry has a two or three character language |
| 1435 | # code (ISO-639) separated by colon from the venue name string. |
| 1436 | # Note that venue_group and venue_type have to be set for Venue Name |
| 1437 | # information to be complete. |
| 1438 | #venue_name=eng:Example venue |
| 1439 | #venue_name=fin:Esimerkkipaikka |
| 1440 | |
Dmitry Shmidt | 61d9df3 | 2012-08-29 16:22:06 -0700 | [diff] [blame] | 1441 | # Network Authentication Type |
| 1442 | # This parameter indicates what type of network authentication is used in the |
| 1443 | # network. |
| 1444 | # format: <network auth type indicator (1-octet hex str)> [redirect URL] |
| 1445 | # Network Authentication Type Indicator values: |
| 1446 | # 00 = Acceptance of terms and conditions |
| 1447 | # 01 = On-line enrollment supported |
| 1448 | # 02 = http/https redirection |
| 1449 | # 03 = DNS redirection |
| 1450 | #network_auth_type=00 |
| 1451 | #network_auth_type=02http://www.example.com/redirect/me/here/ |
| 1452 | |
| 1453 | # IP Address Type Availability |
| 1454 | # format: <1-octet encoded value as hex str> |
| 1455 | # (ipv4_type & 0x3f) << 2 | (ipv6_type & 0x3) |
| 1456 | # ipv4_type: |
| 1457 | # 0 = Address type not available |
| 1458 | # 1 = Public IPv4 address available |
| 1459 | # 2 = Port-restricted IPv4 address available |
| 1460 | # 3 = Single NATed private IPv4 address available |
| 1461 | # 4 = Double NATed private IPv4 address available |
| 1462 | # 5 = Port-restricted IPv4 address and single NATed IPv4 address available |
| 1463 | # 6 = Port-restricted IPv4 address and double NATed IPv4 address available |
| 1464 | # 7 = Availability of the address type is not known |
| 1465 | # ipv6_type: |
| 1466 | # 0 = Address type not available |
| 1467 | # 1 = Address type available |
| 1468 | # 2 = Availability of the address type not known |
| 1469 | #ipaddr_type_availability=14 |
| 1470 | |
| 1471 | # Domain Name |
| 1472 | # format: <variable-octet str>[,<variable-octet str>] |
| 1473 | #domain_name=example.com,another.example.com,yet-another.example.com |
| 1474 | |
| 1475 | # 3GPP Cellular Network information |
| 1476 | # format: <MCC1,MNC1>[;<MCC2,MNC2>][;...] |
| 1477 | #anqp_3gpp_cell_net=244,91;310,026;234,56 |
| 1478 | |
| 1479 | # NAI Realm information |
| 1480 | # One or more realm can be advertised. Each nai_realm line adds a new realm to |
| 1481 | # the set. These parameters provide information for stations using Interworking |
| 1482 | # network selection to allow automatic connection to a network based on |
| 1483 | # credentials. |
| 1484 | # format: <encoding>,<NAI Realm(s)>[,<EAP Method 1>][,<EAP Method 2>][,...] |
| 1485 | # encoding: |
| 1486 | # 0 = Realm formatted in accordance with IETF RFC 4282 |
| 1487 | # 1 = UTF-8 formatted character string that is not formatted in |
| 1488 | # accordance with IETF RFC 4282 |
| 1489 | # NAI Realm(s): Semi-colon delimited NAI Realm(s) |
| 1490 | # EAP Method: <EAP Method>[:<[AuthParam1:Val1]>][<[AuthParam2:Val2]>][...] |
| 1491 | # AuthParam (Table 8-188 in IEEE Std 802.11-2012): |
| 1492 | # ID 2 = Non-EAP Inner Authentication Type |
| 1493 | # 1 = PAP, 2 = CHAP, 3 = MSCHAP, 4 = MSCHAPV2 |
| 1494 | # ID 3 = Inner authentication EAP Method Type |
| 1495 | # ID 5 = Credential Type |
| 1496 | # 1 = SIM, 2 = USIM, 3 = NFC Secure Element, 4 = Hardware Token, |
| 1497 | # 5 = Softoken, 6 = Certificate, 7 = username/password, 9 = Anonymous, |
| 1498 | # 10 = Vendor Specific |
| 1499 | #nai_realm=0,example.com;example.net |
| 1500 | # EAP methods EAP-TLS with certificate and EAP-TTLS/MSCHAPv2 with |
| 1501 | # username/password |
| 1502 | #nai_realm=0,example.org,13[5:6],21[2:4][5:7] |
| 1503 | |
| 1504 | ##### Hotspot 2.0 ############################################################# |
| 1505 | |
| 1506 | # Enable Hotspot 2.0 support |
| 1507 | #hs20=1 |
| 1508 | |
| 1509 | # Disable Downstream Group-Addressed Forwarding (DGAF) |
| 1510 | # This can be used to configure a network where no group-addressed frames are |
| 1511 | # allowed. The AP will not forward any group-address frames to the stations and |
| 1512 | # random GTKs are issued for each station to prevent associated stations from |
| 1513 | # forging such frames to other stations in the BSS. |
| 1514 | #disable_dgaf=1 |
| 1515 | |
| 1516 | # Operator Friendly Name |
| 1517 | # This parameter can be used to configure one or more Operator Friendly Name |
| 1518 | # Duples. Each entry has a two or three character language code (ISO-639) |
| 1519 | # separated by colon from the operator friendly name string. |
| 1520 | #hs20_oper_friendly_name=eng:Example operator |
| 1521 | #hs20_oper_friendly_name=fin:Esimerkkioperaattori |
| 1522 | |
| 1523 | # Connection Capability |
| 1524 | # This can be used to advertise what type of IP traffic can be sent through the |
| 1525 | # hotspot (e.g., due to firewall allowing/blocking protocols/ports). |
| 1526 | # format: <IP Protocol>:<Port Number>:<Status> |
| 1527 | # IP Protocol: 1 = ICMP, 6 = TCP, 17 = UDP |
| 1528 | # Port Number: 0..65535 |
| 1529 | # Status: 0 = Closed, 1 = Open, 2 = Unknown |
| 1530 | # Each hs20_conn_capab line is added to the list of advertised tuples. |
| 1531 | #hs20_conn_capab=1:0:2 |
| 1532 | #hs20_conn_capab=6:22:1 |
| 1533 | #hs20_conn_capab=17:5060:0 |
| 1534 | |
| 1535 | # WAN Metrics |
| 1536 | # format: <WAN Info>:<DL Speed>:<UL Speed>:<DL Load>:<UL Load>:<LMD> |
| 1537 | # WAN Info: B0-B1: Link Status, B2: Symmetric Link, B3: At Capabity |
| 1538 | # (encoded as two hex digits) |
| 1539 | # Link Status: 1 = Link up, 2 = Link down, 3 = Link in test state |
| 1540 | # Downlink Speed: Estimate of WAN backhaul link current downlink speed in kbps; |
| 1541 | # 1..4294967295; 0 = unknown |
| 1542 | # Uplink Speed: Estimate of WAN backhaul link current uplink speed in kbps |
| 1543 | # 1..4294967295; 0 = unknown |
| 1544 | # Downlink Load: Current load of downlink WAN connection (scaled to 255 = 100%) |
| 1545 | # Uplink Load: Current load of uplink WAN connection (scaled to 255 = 100%) |
| 1546 | # Load Measurement Duration: Duration for measuring downlink/uplink load in |
| 1547 | # tenths of a second (1..65535); 0 if load cannot be determined |
| 1548 | #hs20_wan_metrics=01:8000:1000:80:240:3000 |
| 1549 | |
| 1550 | # Operating Class Indication |
| 1551 | # List of operating classes the BSSes in this ESS use. The Global operating |
| 1552 | # classes in Table E-4 of IEEE Std 802.11-2012 Annex E define the values that |
| 1553 | # can be used in this. |
| 1554 | # format: hexdump of operating class octets |
| 1555 | # for example, operating classes 81 (2.4 GHz channels 1-13) and 115 (5 GHz |
| 1556 | # channels 36-48): |
| 1557 | #hs20_operating_class=5173 |
| 1558 | |
Dmitry Shmidt | 8da800a | 2013-04-24 12:57:01 -0700 | [diff] [blame] | 1559 | ##### TESTING OPTIONS ######################################################### |
| 1560 | # |
| 1561 | # The options in this section are only available when the build configuration |
| 1562 | # option CONFIG_TESTING_OPTIONS is set while compiling hostapd. They allow |
| 1563 | # testing some scenarios that are otherwise difficult to reproduce. |
| 1564 | # |
| 1565 | # Ignore probe requests sent to hostapd with the given probability, must be a |
| 1566 | # floating point number in the range [0, 1). |
| 1567 | #ignore_probe_probability=0.0 |
| 1568 | # |
| 1569 | # Ignore authentication frames with the given probability |
| 1570 | #ignore_auth_probability=0.0 |
| 1571 | # |
| 1572 | # Ignore association requests with the given probability |
| 1573 | #ignore_assoc_probability=0.0 |
| 1574 | # |
| 1575 | # Ignore reassociation requests with the given probability |
| 1576 | #ignore_reassoc_probability=0.0 |
Dmitry Shmidt | 51b6ea8 | 2013-05-08 10:42:09 -0700 | [diff] [blame] | 1577 | # |
| 1578 | # Corrupt Key MIC in GTK rekey EAPOL-Key frames with the given probability |
| 1579 | #corrupt_gtk_rekey_mic_probability=0.0 |
Dmitry Shmidt | 8da800a | 2013-04-24 12:57:01 -0700 | [diff] [blame] | 1580 | |
Dmitry Shmidt | 8d520ff | 2011-05-09 14:06:53 -0700 | [diff] [blame] | 1581 | ##### Multiple BSSID support ################################################## |
| 1582 | # |
| 1583 | # Above configuration is using the default interface (wlan#, or multi-SSID VLAN |
| 1584 | # interfaces). Other BSSIDs can be added by using separator 'bss' with |
| 1585 | # default interface name to be allocated for the data packets of the new BSS. |
| 1586 | # |
| 1587 | # hostapd will generate BSSID mask based on the BSSIDs that are |
| 1588 | # configured. hostapd will verify that dev_addr & MASK == dev_addr. If this is |
| 1589 | # not the case, the MAC address of the radio must be changed before starting |
| 1590 | # hostapd (ifconfig wlan0 hw ether <MAC addr>). If a BSSID is configured for |
| 1591 | # every secondary BSS, this limitation is not applied at hostapd and other |
| 1592 | # masks may be used if the driver supports them (e.g., swap the locally |
| 1593 | # administered bit) |
| 1594 | # |
| 1595 | # BSSIDs are assigned in order to each BSS, unless an explicit BSSID is |
| 1596 | # specified using the 'bssid' parameter. |
| 1597 | # If an explicit BSSID is specified, it must be chosen such that it: |
| 1598 | # - results in a valid MASK that covers it and the dev_addr |
| 1599 | # - is not the same as the MAC address of the radio |
| 1600 | # - is not the same as any other explicitly specified BSSID |
| 1601 | # |
| 1602 | # Please note that hostapd uses some of the values configured for the first BSS |
| 1603 | # as the defaults for the following BSSes. However, it is recommended that all |
| 1604 | # BSSes include explicit configuration of all relevant configuration items. |
| 1605 | # |
| 1606 | #bss=wlan0_0 |
| 1607 | #ssid=test2 |
| 1608 | # most of the above items can be used here (apart from radio interface specific |
| 1609 | # items, like channel) |
| 1610 | |
| 1611 | #bss=wlan0_1 |
| 1612 | #bssid=00:13:10:95:fe:0b |
| 1613 | # ... |