2 * hostapd / IEEE 802.11 Management: Beacon and Probe Request/Response
3 * Copyright (c) 2002-2004, Instant802 Networks, Inc.
4 * Copyright (c) 2005-2006, Devicescape Software, Inc.
5 * Copyright (c) 2008-2009, Jouni Malinen <j@w1.fi>
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
11 * Alternatively, this software may be distributed under the terms of BSD
14 * See README and COPYING for more details.
17 #include "utils/includes.h"
19 #ifndef CONFIG_NATIVE_WINDOWS
21 #include "utils/common.h"
22 #include "common/ieee802_11_defs.h"
23 #include "common/ieee802_11_common.h"
24 #include "drivers/driver.h"
26 #include "ieee802_11.h"
29 #include "ap_config.h"
34 static u8
ieee802_11_erp_info(struct hostapd_data
*hapd
)
38 if (hapd
->iface
->current_mode
== NULL
||
39 hapd
->iface
->current_mode
->mode
!= HOSTAPD_MODE_IEEE80211G
)
42 switch (hapd
->iconf
->cts_protection_type
) {
43 case CTS_PROTECTION_FORCE_ENABLED
:
44 erp
|= ERP_INFO_NON_ERP_PRESENT
| ERP_INFO_USE_PROTECTION
;
46 case CTS_PROTECTION_FORCE_DISABLED
:
49 case CTS_PROTECTION_AUTOMATIC
:
50 if (hapd
->iface
->olbc
)
51 erp
|= ERP_INFO_USE_PROTECTION
;
53 case CTS_PROTECTION_AUTOMATIC_NO_OLBC
:
54 if (hapd
->iface
->num_sta_non_erp
> 0) {
55 erp
|= ERP_INFO_NON_ERP_PRESENT
|
56 ERP_INFO_USE_PROTECTION
;
60 if (hapd
->iface
->num_sta_no_short_preamble
> 0 ||
61 hapd
->iconf
->preamble
== LONG_PREAMBLE
)
62 erp
|= ERP_INFO_BARKER_PREAMBLE_MODE
;
68 static u8
* hostapd_eid_ds_params(struct hostapd_data
*hapd
, u8
*eid
)
70 *eid
++ = WLAN_EID_DS_PARAMS
;
72 *eid
++ = hapd
->iconf
->channel
;
77 static u8
* hostapd_eid_erp_info(struct hostapd_data
*hapd
, u8
*eid
)
79 if (hapd
->iface
->current_mode
== NULL
||
80 hapd
->iface
->current_mode
->mode
!= HOSTAPD_MODE_IEEE80211G
)
83 /* Set NonERP_present and use_protection bits if there
84 * are any associated NonERP stations. */
85 /* TODO: use_protection bit can be set to zero even if
86 * there are NonERP stations present. This optimization
87 * might be useful if NonERP stations are "quiet".
88 * See 802.11g/D6 E-1 for recommended practice.
89 * In addition, Non ERP present might be set, if AP detects Non ERP
90 * operation on other APs. */
92 /* Add ERP Information element */
93 *eid
++ = WLAN_EID_ERP_INFO
;
95 *eid
++ = ieee802_11_erp_info(hapd
);
101 static u8
* hostapd_eid_country_add(u8
*pos
, u8
*end
, int chan_spacing
,
102 struct hostapd_channel_data
*start
,
103 struct hostapd_channel_data
*prev
)
108 /* first channel number */
109 *pos
++ = start
->chan
;
110 /* number of channels */
111 *pos
++ = (prev
->chan
- start
->chan
) / chan_spacing
+ 1;
112 /* maximum transmit power level */
113 *pos
++ = start
->max_tx_power
;
119 static u8
* hostapd_eid_country(struct hostapd_data
*hapd
, u8
*eid
,
123 u8
*end
= eid
+ max_len
;
125 struct hostapd_hw_modes
*mode
;
126 struct hostapd_channel_data
*start
, *prev
;
127 int chan_spacing
= 1;
129 if (!hapd
->iconf
->ieee80211d
|| max_len
< 6 ||
130 hapd
->iface
->current_mode
== NULL
)
133 *pos
++ = WLAN_EID_COUNTRY
;
134 pos
++; /* length will be set later */
135 os_memcpy(pos
, hapd
->iconf
->country
, 3); /* e.g., 'US ' */
138 mode
= hapd
->iface
->current_mode
;
139 if (mode
->mode
== HOSTAPD_MODE_IEEE80211A
)
143 for (i
= 0; i
< mode
->num_channels
; i
++) {
144 struct hostapd_channel_data
*chan
= &mode
->channels
[i
];
145 if (chan
->flag
& HOSTAPD_CHAN_DISABLED
)
148 prev
->chan
+ chan_spacing
== chan
->chan
&&
149 start
->max_tx_power
== chan
->max_tx_power
) {
151 continue; /* can use same entry */
155 pos
= hostapd_eid_country_add(pos
, end
, chan_spacing
,
160 /* Start new group */
165 pos
= hostapd_eid_country_add(pos
, end
, chan_spacing
,
169 if ((pos
- eid
) & 1) {
172 *pos
++ = 0; /* pad for 16-bit alignment */
175 eid
[1] = (pos
- eid
) - 2;
181 static u8
* hostapd_eid_wpa(struct hostapd_data
*hapd
, u8
*eid
, size_t len
,
182 struct sta_info
*sta
)
187 ie
= wpa_auth_get_wpa_ie(hapd
->wpa_auth
, &ielen
);
188 if (ie
== NULL
|| ielen
> len
)
191 os_memcpy(eid
, ie
, ielen
);
196 void handle_probe_req(struct hostapd_data
*hapd
,
197 const struct ieee80211_mgmt
*mgmt
, size_t len
)
199 struct ieee80211_mgmt
*resp
;
200 struct ieee802_11_elems elems
;
204 size_t ssid_len
, ie_len
;
205 struct sta_info
*sta
= NULL
;
209 ie
= mgmt
->u
.probe_req
.variable
;
210 ie_len
= len
- (IEEE80211_HDRLEN
+ sizeof(mgmt
->u
.probe_req
));
212 for (i
= 0; hapd
->probereq_cb
&& i
< hapd
->num_probereq_cb
; i
++)
213 if (hapd
->probereq_cb
[i
].cb(hapd
->probereq_cb
[i
].ctx
,
214 mgmt
->sa
, ie
, ie_len
) > 0)
217 if (!hapd
->iconf
->send_probe_response
)
220 if (ieee802_11_parse_elems(ie
, ie_len
, &elems
, 0) == ParseFailed
) {
221 wpa_printf(MSG_DEBUG
, "Could not parse ProbeReq from " MACSTR
,
229 if ((!elems
.ssid
|| !elems
.supp_rates
)) {
230 wpa_printf(MSG_DEBUG
, "STA " MACSTR
" sent probe request "
231 "without SSID or supported rates element",
236 if (hapd
->conf
->ignore_broadcast_ssid
&& elems
.ssid_len
== 0) {
237 wpa_printf(MSG_MSGDUMP
, "Probe Request from " MACSTR
" for "
238 "broadcast SSID ignored", MAC2STR(mgmt
->sa
));
242 sta
= ap_get_sta(hapd
, mgmt
->sa
);
244 if (elems
.ssid_len
== 0 ||
245 (elems
.ssid_len
== hapd
->conf
->ssid
.ssid_len
&&
246 os_memcmp(elems
.ssid
, hapd
->conf
->ssid
.ssid
, elems
.ssid_len
) ==
248 ssid
= hapd
->conf
->ssid
.ssid
;
249 ssid_len
= hapd
->conf
->ssid
.ssid_len
;
251 sta
->ssid_probe
= &hapd
->conf
->ssid
;
255 if (!(mgmt
->da
[0] & 0x01)) {
257 ieee802_11_print_ssid(ssid_txt
, elems
.ssid
,
259 wpa_printf(MSG_MSGDUMP
, "Probe Request from " MACSTR
260 " for foreign SSID '%s'",
261 MAC2STR(mgmt
->sa
), ssid_txt
);
266 /* TODO: verify that supp_rates contains at least one matching rate
267 * with AP configuration */
268 #define MAX_PROBERESP_LEN 768
269 buflen
= MAX_PROBERESP_LEN
;
271 if (hapd
->wps_probe_resp_ie
)
272 buflen
+= wpabuf_len(hapd
->wps_probe_resp_ie
);
273 #endif /* CONFIG_WPS */
274 resp
= os_zalloc(buflen
);
277 epos
= ((u8
*) resp
) + MAX_PROBERESP_LEN
;
279 resp
->frame_control
= IEEE80211_FC(WLAN_FC_TYPE_MGMT
,
280 WLAN_FC_STYPE_PROBE_RESP
);
281 os_memcpy(resp
->da
, mgmt
->sa
, ETH_ALEN
);
282 os_memcpy(resp
->sa
, hapd
->own_addr
, ETH_ALEN
);
284 os_memcpy(resp
->bssid
, hapd
->own_addr
, ETH_ALEN
);
285 resp
->u
.probe_resp
.beacon_int
=
286 host_to_le16(hapd
->iconf
->beacon_int
);
288 /* hardware or low-level driver will setup seq_ctrl and timestamp */
289 resp
->u
.probe_resp
.capab_info
=
290 host_to_le16(hostapd_own_capab_info(hapd
, sta
, 1));
292 pos
= resp
->u
.probe_resp
.variable
;
293 *pos
++ = WLAN_EID_SSID
;
295 os_memcpy(pos
, ssid
, ssid_len
);
298 /* Supported rates */
299 pos
= hostapd_eid_supp_rates(hapd
, pos
);
302 pos
= hostapd_eid_ds_params(hapd
, pos
);
304 pos
= hostapd_eid_country(hapd
, pos
, epos
- pos
);
306 /* ERP Information element */
307 pos
= hostapd_eid_erp_info(hapd
, pos
);
309 /* Extended supported rates */
310 pos
= hostapd_eid_ext_supp_rates(hapd
, pos
);
313 pos
= hostapd_eid_wpa(hapd
, pos
, epos
- pos
, sta
);
315 #ifdef CONFIG_IEEE80211N
316 pos
= hostapd_eid_ht_capabilities(hapd
, pos
);
317 pos
= hostapd_eid_ht_operation(hapd
, pos
);
318 #endif /* CONFIG_IEEE80211N */
320 /* Wi-Fi Alliance WMM */
321 pos
= hostapd_eid_wmm(hapd
, pos
);
324 if (hapd
->conf
->wps_state
&& hapd
->wps_probe_resp_ie
) {
325 os_memcpy(pos
, wpabuf_head(hapd
->wps_probe_resp_ie
),
326 wpabuf_len(hapd
->wps_probe_resp_ie
));
327 pos
+= wpabuf_len(hapd
->wps_probe_resp_ie
);
329 #endif /* CONFIG_WPS */
331 if (hapd
->drv
.send_mgmt_frame(hapd
, resp
, pos
- (u8
*) resp
) < 0)
332 perror("handle_probe_req: send");
336 wpa_printf(MSG_MSGDUMP
, "STA " MACSTR
" sent probe request for %s "
337 "SSID", MAC2STR(mgmt
->sa
),
338 elems
.ssid_len
== 0 ? "broadcast" : "our");
342 void ieee802_11_set_beacon(struct hostapd_data
*hapd
)
344 struct ieee80211_mgmt
*head
;
345 u8
*pos
, *tail
, *tailpos
;
347 size_t head_len
, tail_len
;
349 #define BEACON_HEAD_BUF_SIZE 256
350 #define BEACON_TAIL_BUF_SIZE 512
351 head
= os_zalloc(BEACON_HEAD_BUF_SIZE
);
352 tail_len
= BEACON_TAIL_BUF_SIZE
;
354 if (hapd
->conf
->wps_state
&& hapd
->wps_beacon_ie
)
355 tail_len
+= wpabuf_len(hapd
->wps_beacon_ie
);
356 #endif /* CONFIG_WPS */
357 tailpos
= tail
= os_malloc(tail_len
);
358 if (head
== NULL
|| tail
== NULL
) {
359 wpa_printf(MSG_ERROR
, "Failed to set beacon data");
365 head
->frame_control
= IEEE80211_FC(WLAN_FC_TYPE_MGMT
,
366 WLAN_FC_STYPE_BEACON
);
367 head
->duration
= host_to_le16(0);
368 os_memset(head
->da
, 0xff, ETH_ALEN
);
370 os_memcpy(head
->sa
, hapd
->own_addr
, ETH_ALEN
);
371 os_memcpy(head
->bssid
, hapd
->own_addr
, ETH_ALEN
);
372 head
->u
.beacon
.beacon_int
=
373 host_to_le16(hapd
->iconf
->beacon_int
);
375 /* hardware or low-level driver will setup seq_ctrl and timestamp */
376 capab_info
= hostapd_own_capab_info(hapd
, NULL
, 0);
377 head
->u
.beacon
.capab_info
= host_to_le16(capab_info
);
378 pos
= &head
->u
.beacon
.variable
[0];
381 *pos
++ = WLAN_EID_SSID
;
382 if (hapd
->conf
->ignore_broadcast_ssid
== 2) {
383 /* clear the data, but keep the correct length of the SSID */
384 *pos
++ = hapd
->conf
->ssid
.ssid_len
;
385 os_memset(pos
, 0, hapd
->conf
->ssid
.ssid_len
);
386 pos
+= hapd
->conf
->ssid
.ssid_len
;
387 } else if (hapd
->conf
->ignore_broadcast_ssid
) {
388 *pos
++ = 0; /* empty SSID */
390 *pos
++ = hapd
->conf
->ssid
.ssid_len
;
391 os_memcpy(pos
, hapd
->conf
->ssid
.ssid
,
392 hapd
->conf
->ssid
.ssid_len
);
393 pos
+= hapd
->conf
->ssid
.ssid_len
;
396 /* Supported rates */
397 pos
= hostapd_eid_supp_rates(hapd
, pos
);
400 pos
= hostapd_eid_ds_params(hapd
, pos
);
402 head_len
= pos
- (u8
*) head
;
404 tailpos
= hostapd_eid_country(hapd
, tailpos
,
405 tail
+ BEACON_TAIL_BUF_SIZE
- tailpos
);
407 /* ERP Information element */
408 tailpos
= hostapd_eid_erp_info(hapd
, tailpos
);
410 /* Extended supported rates */
411 tailpos
= hostapd_eid_ext_supp_rates(hapd
, tailpos
);
414 tailpos
= hostapd_eid_wpa(hapd
, tailpos
, tail
+ BEACON_TAIL_BUF_SIZE
-
417 #ifdef CONFIG_IEEE80211N
418 tailpos
= hostapd_eid_ht_capabilities(hapd
, tailpos
);
419 tailpos
= hostapd_eid_ht_operation(hapd
, tailpos
);
420 #endif /* CONFIG_IEEE80211N */
422 /* Wi-Fi Alliance WMM */
423 tailpos
= hostapd_eid_wmm(hapd
, tailpos
);
426 if (hapd
->conf
->wps_state
&& hapd
->wps_beacon_ie
) {
427 os_memcpy(tailpos
, wpabuf_head(hapd
->wps_beacon_ie
),
428 wpabuf_len(hapd
->wps_beacon_ie
));
429 tailpos
+= wpabuf_len(hapd
->wps_beacon_ie
);
431 #endif /* CONFIG_WPS */
433 tail_len
= tailpos
> tail
? tailpos
- tail
: 0;
435 if (hapd
->drv
.set_beacon(hapd
, (u8
*) head
, head_len
,
436 tail
, tail_len
, hapd
->conf
->dtim_period
,
437 hapd
->iconf
->beacon_int
))
438 wpa_printf(MSG_ERROR
, "Failed to set beacon head/tail or DTIM "
444 hapd
->drv
.set_bss_params(hapd
, !!(ieee802_11_erp_info(hapd
) &
445 ERP_INFO_USE_PROTECTION
));
449 void ieee802_11_set_beacons(struct hostapd_iface
*iface
)
452 for (i
= 0; i
< iface
->num_bss
; i
++)
453 ieee802_11_set_beacon(iface
->bss
[i
]);
456 #endif /* CONFIG_NATIVE_WINDOWS */