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, Jouni Malinen <j@w1.fi>
6 * Copyright (c) 2007-2008, Intel Corporation
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
12 * Alternatively, this software may be distributed under the terms of BSD
15 * See README and COPYING for more details.
20 #ifndef CONFIG_NATIVE_WINDOWS
23 #include "ieee802_11.h"
27 #include "hw_features.h"
30 #include "wps_hostapd.h"
33 static u8 ieee802_11_erp_info(struct hostapd_data *hapd)
37 if (hapd->iface->current_mode == NULL ||
38 hapd->iface->current_mode->mode != HOSTAPD_MODE_IEEE80211G)
41 switch (hapd->iconf->cts_protection_type) {
42 case CTS_PROTECTION_FORCE_ENABLED:
43 erp |= ERP_INFO_NON_ERP_PRESENT | ERP_INFO_USE_PROTECTION;
45 case CTS_PROTECTION_FORCE_DISABLED:
48 case CTS_PROTECTION_AUTOMATIC:
49 if (hapd->iface->olbc)
50 erp |= ERP_INFO_USE_PROTECTION;
52 case CTS_PROTECTION_AUTOMATIC_NO_OLBC:
53 if (hapd->iface->num_sta_non_erp > 0) {
54 erp |= ERP_INFO_NON_ERP_PRESENT |
55 ERP_INFO_USE_PROTECTION;
59 if (hapd->iface->num_sta_no_short_preamble > 0)
60 erp |= ERP_INFO_BARKER_PREAMBLE_MODE;
66 static u8 * hostapd_eid_ds_params(struct hostapd_data *hapd, u8 *eid)
68 *eid++ = WLAN_EID_DS_PARAMS;
70 *eid++ = hapd->iconf->channel;
75 static u8 * hostapd_eid_erp_info(struct hostapd_data *hapd, u8 *eid)
77 if (hapd->iface->current_mode == NULL ||
78 hapd->iface->current_mode->mode != HOSTAPD_MODE_IEEE80211G)
81 /* Set NonERP_present and use_protection bits if there
82 * are any associated NonERP stations. */
83 /* TODO: use_protection bit can be set to zero even if
84 * there are NonERP stations present. This optimization
85 * might be useful if NonERP stations are "quiet".
86 * See 802.11g/D6 E-1 for recommended practice.
87 * In addition, Non ERP present might be set, if AP detects Non ERP
88 * operation on other APs. */
90 /* Add ERP Information element */
91 *eid++ = WLAN_EID_ERP_INFO;
93 *eid++ = ieee802_11_erp_info(hapd);
99 static u8 * hostapd_eid_country_add(u8 *pos, u8 *end, int chan_spacing,
100 struct hostapd_channel_data *start,
101 struct hostapd_channel_data *prev)
106 /* first channel number */
107 *pos++ = start->chan;
108 /* number of channels */
109 *pos++ = (prev->chan - start->chan) / chan_spacing + 1;
110 /* maximum transmit power level */
111 *pos++ = start->max_tx_power;
117 static u8 * hostapd_eid_country(struct hostapd_data *hapd, u8 *eid,
121 u8 *end = eid + max_len;
123 struct hostapd_hw_modes *mode;
124 struct hostapd_channel_data *start, *prev;
125 int chan_spacing = 1;
127 if (!hapd->iconf->ieee80211d || max_len < 6 ||
128 hapd->iface->current_mode == NULL)
131 *pos++ = WLAN_EID_COUNTRY;
132 pos++; /* length will be set later */
133 os_memcpy(pos, hapd->iconf->country, 3); /* e.g., 'US ' */
136 mode = hapd->iface->current_mode;
137 if (mode->mode == HOSTAPD_MODE_IEEE80211A)
141 for (i = 0; i < mode->num_channels; i++) {
142 struct hostapd_channel_data *chan = &mode->channels[i];
143 if (chan->flag & HOSTAPD_CHAN_DISABLED)
146 prev->chan + chan_spacing == chan->chan &&
147 start->max_tx_power == chan->max_tx_power) {
149 continue; /* can use same entry */
153 pos = hostapd_eid_country_add(pos, end, chan_spacing,
158 /* Start new group */
163 pos = hostapd_eid_country_add(pos, end, chan_spacing,
167 if ((pos - eid) & 1) {
170 *pos++ = 0; /* pad for 16-bit alignment */
173 eid[1] = (pos - eid) - 2;
179 static u8 * hostapd_eid_wpa(struct hostapd_data *hapd, u8 *eid, size_t len,
180 struct sta_info *sta)
185 ie = wpa_auth_get_wpa_ie(hapd->wpa_auth, &ielen);
186 if (ie == NULL || ielen > len)
189 os_memcpy(eid, ie, ielen);
194 void handle_probe_req(struct hostapd_data *hapd, struct ieee80211_mgmt *mgmt,
197 struct ieee80211_mgmt *resp;
198 struct ieee802_11_elems elems;
201 size_t ssid_len, ie_len;
202 struct sta_info *sta = NULL;
204 ie = mgmt->u.probe_req.variable;
205 ie_len = len - (IEEE80211_HDRLEN + sizeof(mgmt->u.probe_req));
207 hostapd_wps_probe_req_rx(hapd, mgmt->sa, ie, ie_len);
209 if (!hapd->iconf->send_probe_response)
212 if (ieee802_11_parse_elems(ie, ie_len, &elems, 0) == ParseFailed) {
213 wpa_printf(MSG_DEBUG, "Could not parse ProbeReq from " MACSTR,
221 if ((!elems.ssid || !elems.supp_rates)) {
222 wpa_printf(MSG_DEBUG, "STA " MACSTR " sent probe request "
223 "without SSID or supported rates element",
228 if (hapd->conf->ignore_broadcast_ssid && elems.ssid_len == 0) {
229 wpa_printf(MSG_MSGDUMP, "Probe Request from " MACSTR " for "
230 "broadcast SSID ignored", MAC2STR(mgmt->sa));
234 sta = ap_get_sta(hapd, mgmt->sa);
236 if (elems.ssid_len == 0 ||
237 (elems.ssid_len == hapd->conf->ssid.ssid_len &&
238 os_memcmp(elems.ssid, hapd->conf->ssid.ssid, elems.ssid_len) ==
240 ssid = hapd->conf->ssid.ssid;
241 ssid_len = hapd->conf->ssid.ssid_len;
243 sta->ssid_probe = &hapd->conf->ssid;
247 if (!(mgmt->da[0] & 0x01)) {
249 ieee802_11_print_ssid(ssid_txt, elems.ssid,
251 wpa_printf(MSG_MSGDUMP, "Probe Request from " MACSTR
252 " for foreign SSID '%s'",
253 MAC2STR(mgmt->sa), ssid_txt);
258 /* TODO: verify that supp_rates contains at least one matching rate
259 * with AP configuration */
260 #define MAX_PROBERESP_LEN 768
261 resp = os_zalloc(MAX_PROBERESP_LEN);
264 epos = ((u8 *) resp) + MAX_PROBERESP_LEN;
266 resp->frame_control = IEEE80211_FC(WLAN_FC_TYPE_MGMT,
267 WLAN_FC_STYPE_PROBE_RESP);
268 os_memcpy(resp->da, mgmt->sa, ETH_ALEN);
269 os_memcpy(resp->sa, hapd->own_addr, ETH_ALEN);
271 os_memcpy(resp->bssid, hapd->own_addr, ETH_ALEN);
272 resp->u.probe_resp.beacon_int =
273 host_to_le16(hapd->iconf->beacon_int);
275 /* hardware or low-level driver will setup seq_ctrl and timestamp */
276 resp->u.probe_resp.capab_info =
277 host_to_le16(hostapd_own_capab_info(hapd, sta, 1));
279 pos = resp->u.probe_resp.variable;
280 *pos++ = WLAN_EID_SSID;
282 os_memcpy(pos, ssid, ssid_len);
285 /* Supported rates */
286 pos = hostapd_eid_supp_rates(hapd, pos);
289 pos = hostapd_eid_ds_params(hapd, pos);
291 pos = hostapd_eid_country(hapd, pos, epos - pos);
293 /* ERP Information element */
294 pos = hostapd_eid_erp_info(hapd, pos);
296 /* Extended supported rates */
297 pos = hostapd_eid_ext_supp_rates(hapd, pos);
299 pos = hostapd_eid_wpa(hapd, pos, epos - pos, sta);
301 /* Wi-Fi Alliance WMM */
302 pos = hostapd_eid_wmm(hapd, pos);
304 pos = hostapd_eid_ht_capabilities_info(hapd, pos);
305 pos = hostapd_eid_ht_operation(hapd, pos);
308 if (hapd->conf->wps_state && hapd->wps_probe_resp_ie) {
309 os_memcpy(pos, hapd->wps_probe_resp_ie,
310 hapd->wps_probe_resp_ie_len);
311 pos += hapd->wps_probe_resp_ie_len;
313 #endif /* CONFIG_WPS */
315 if (hostapd_send_mgmt_frame(hapd, resp, pos - (u8 *) resp, 0) < 0)
316 perror("handle_probe_req: send");
320 wpa_printf(MSG_MSGDUMP, "STA " MACSTR " sent probe request for %s "
321 "SSID", MAC2STR(mgmt->sa),
322 elems.ssid_len == 0 ? "broadcast" : "our");
326 void ieee802_11_set_beacon(struct hostapd_data *hapd)
328 struct ieee80211_mgmt *head;
329 u8 *pos, *tail, *tailpos;
332 size_t head_len, tail_len;
333 int cts_protection = ((ieee802_11_erp_info(hapd) &
334 ERP_INFO_USE_PROTECTION) ? 1 : 0);
336 #define BEACON_HEAD_BUF_SIZE 256
337 #define BEACON_TAIL_BUF_SIZE 512
338 head = os_zalloc(BEACON_HEAD_BUF_SIZE);
339 tailpos = tail = os_malloc(BEACON_TAIL_BUF_SIZE);
340 if (head == NULL || tail == NULL) {
341 wpa_printf(MSG_ERROR, "Failed to set beacon data");
347 head->frame_control = IEEE80211_FC(WLAN_FC_TYPE_MGMT,
348 WLAN_FC_STYPE_BEACON);
349 head->duration = host_to_le16(0);
350 os_memset(head->da, 0xff, ETH_ALEN);
352 os_memcpy(head->sa, hapd->own_addr, ETH_ALEN);
353 os_memcpy(head->bssid, hapd->own_addr, ETH_ALEN);
354 head->u.beacon.beacon_int =
355 host_to_le16(hapd->iconf->beacon_int);
357 /* hardware or low-level driver will setup seq_ctrl and timestamp */
358 capab_info = hostapd_own_capab_info(hapd, NULL, 0);
359 head->u.beacon.capab_info = host_to_le16(capab_info);
360 pos = &head->u.beacon.variable[0];
363 *pos++ = WLAN_EID_SSID;
364 if (hapd->conf->ignore_broadcast_ssid == 2) {
365 /* clear the data, but keep the correct length of the SSID */
366 *pos++ = hapd->conf->ssid.ssid_len;
367 os_memset(pos, 0, hapd->conf->ssid.ssid_len);
368 pos += hapd->conf->ssid.ssid_len;
369 } else if (hapd->conf->ignore_broadcast_ssid) {
370 *pos++ = 0; /* empty SSID */
372 *pos++ = hapd->conf->ssid.ssid_len;
373 os_memcpy(pos, hapd->conf->ssid.ssid,
374 hapd->conf->ssid.ssid_len);
375 pos += hapd->conf->ssid.ssid_len;
378 /* Supported rates */
379 pos = hostapd_eid_supp_rates(hapd, pos);
382 pos = hostapd_eid_ds_params(hapd, pos);
384 head_len = pos - (u8 *) head;
386 tailpos = hostapd_eid_country(hapd, tailpos,
387 tail + BEACON_TAIL_BUF_SIZE - tailpos);
389 /* ERP Information element */
390 tailpos = hostapd_eid_erp_info(hapd, tailpos);
392 /* Extended supported rates */
393 tailpos = hostapd_eid_ext_supp_rates(hapd, tailpos);
395 tailpos = hostapd_eid_wpa(hapd, tailpos, tail + BEACON_TAIL_BUF_SIZE -
398 /* Wi-Fi Alliance WMM */
399 tailpos = hostapd_eid_wmm(hapd, tailpos);
401 #ifdef CONFIG_IEEE80211N
402 if (hapd->iconf->ieee80211n) {
403 u8 *ht_capab, *ht_oper;
405 tailpos = hostapd_eid_ht_capabilities_info(hapd, tailpos);
408 tailpos = hostapd_eid_ht_operation(hapd, tailpos);
410 if (tailpos > ht_oper && ht_oper > ht_capab &&
411 hostapd_set_ht_params(hapd->conf->iface, hapd,
412 ht_capab + 2, ht_capab[1],
413 ht_oper + 2, ht_oper[1])) {
414 wpa_printf(MSG_ERROR, "Could not set HT capabilities "
415 "for kernel driver");
418 #endif /* CONFIG_IEEE80211N */
421 if (hapd->conf->wps_state && hapd->wps_beacon_ie) {
422 os_memcpy(tailpos, hapd->wps_beacon_ie,
423 hapd->wps_beacon_ie_len);
424 tailpos += hapd->wps_beacon_ie_len;
426 #endif /* CONFIG_WPS */
428 tail_len = tailpos > tail ? tailpos - tail : 0;
430 if (hostapd_set_beacon(hapd->conf->iface, hapd, (u8 *) head, head_len,
432 wpa_printf(MSG_ERROR, "Failed to set beacon head/tail");
437 if (hostapd_set_cts_protect(hapd, cts_protection))
438 wpa_printf(MSG_ERROR, "Failed to set CTS protect in kernel "
441 if (hapd->iface->current_mode &&
442 hapd->iface->current_mode->mode == HOSTAPD_MODE_IEEE80211G &&
443 hostapd_set_short_slot_time(hapd,
444 hapd->iface->num_sta_no_short_slot_time
446 wpa_printf(MSG_ERROR, "Failed to set Short Slot Time option "
449 if (hapd->iface->num_sta_no_short_preamble == 0 &&
450 hapd->iconf->preamble == SHORT_PREAMBLE)
451 preamble = SHORT_PREAMBLE;
453 preamble = LONG_PREAMBLE;
454 if (hostapd_set_preamble(hapd, preamble))
455 wpa_printf(MSG_ERROR, "Could not set preamble for kernel "
460 void ieee802_11_set_beacons(struct hostapd_iface *iface)
463 for (i = 0; i < iface->num_bss; i++)
464 ieee802_11_set_beacon(iface->bss[i]);
467 #endif /* CONFIG_NATIVE_WINDOWS */