1 /*
2 * BSS table
3 * Copyright (c) 2009-2010, Jouni Malinen <j@w1.fi>
4 *
5 * This software may be distributed under the terms of the BSD license.
6 * See README for more details.
7 */
8
9 #ifndef BSS_H
10 #define BSS_H
11
12 struct wpa_scan_res;
13
14 #define WPA_BSS_QUAL_INVALID BIT(0)
15 #define WPA_BSS_NOISE_INVALID BIT(1)
16 #define WPA_BSS_LEVEL_INVALID BIT(2)
17 #define WPA_BSS_LEVEL_DBM BIT(3)
18 #define WPA_BSS_AUTHENTICATED BIT(4)
19 #define WPA_BSS_ASSOCIATED BIT(5)
20 #define WPA_BSS_ANQP_FETCH_TRIED BIT(6)
21
22 /**
23 * struct wpa_bss_anqp - ANQP data for a BSS entry (struct wpa_bss)
24 */
25 struct wpa_bss_anqp {
26 /** Number of BSS entries referring to this ANQP data instance */
27 unsigned int users;
28 #ifdef CONFIG_INTERWORKING
29 struct wpabuf *venue_name;
30 struct wpabuf *network_auth_type;
31 struct wpabuf *roaming_consortium;
32 struct wpabuf *ip_addr_type_availability;
33 struct wpabuf *nai_realm;
34 struct wpabuf *anqp_3gpp;
35 struct wpabuf *domain_name;
36 #endif /* CONFIG_INTERWORKING */
37 #ifdef CONFIG_HS20
38 struct wpabuf *hs20_operator_friendly_name;
39 struct wpabuf *hs20_wan_metrics;
40 struct wpabuf *hs20_connection_capability;
41 struct wpabuf *hs20_operating_class;
42 struct wpabuf *hs20_osu_providers_list;
43 #endif /* CONFIG_HS20 */
44 };
45
46 /**
47 * struct wpa_bss - BSS table
48 *
49 * This structure is used to store information about neighboring BSSes in
50 * generic format. It is mainly updated based on scan results from the driver.
51 */
52 struct wpa_bss {
53 /** List entry for struct wpa_supplicant::bss */
54 struct dl_list list;
55 /** List entry for struct wpa_supplicant::bss_id */
56 struct dl_list list_id;
57 /** Unique identifier for this BSS entry */
58 unsigned int id;
59 /** Number of counts without seeing this BSS */
60 unsigned int scan_miss_count;
61 /** Index of the last scan update */
62 unsigned int last_update_idx;
63 /** Information flags about the BSS/IBSS (WPA_BSS_*) */
64 unsigned int flags;
65 /** BSSID */
66 u8 bssid[ETH_ALEN];
67 /** HESSID */
68 u8 hessid[ETH_ALEN];
69 /** SSID */
70 u8 ssid[32];
71 /** Length of SSID */
72 size_t ssid_len;
73 /** Frequency of the channel in MHz (e.g., 2412 = channel 1) */
74 int freq;
75 /** Beacon interval in TUs (host byte order) */
76 u16 beacon_int;
77 /** Capability information field in host byte order */
78 u16 caps;
79 /** Signal quality */
80 int qual;
81 /** Noise level */
82 int noise;
83 /** Signal level */
84 int level;
85 /** Timestamp of last Beacon/Probe Response frame */
86 u64 tsf;
87 /** Time of the last update (i.e., Beacon or Probe Response RX) */
88 struct os_reltime last_update;
89 /** ANQP data */
90 struct wpa_bss_anqp *anqp;
91 /** Length of the following IE field in octets (from Probe Response) */
92 size_t ie_len;
93 /** Length of the following Beacon IE field in octets */
94 size_t beacon_ie_len;
95 /* followed by ie_len octets of IEs */
96 /* followed by beacon_ie_len octets of IEs */
97 };
98
99 void wpa_bss_update_start(struct wpa_supplicant *wpa_s);
100 void wpa_bss_update_scan_res(struct wpa_supplicant *wpa_s,
101 struct wpa_scan_res *res,
102 struct os_reltime *fetch_time);
103 void wpa_bss_update_end(struct wpa_supplicant *wpa_s, struct scan_info *info,
104 int new_scan);
105 int wpa_bss_init(struct wpa_supplicant *wpa_s);
106 void wpa_bss_deinit(struct wpa_supplicant *wpa_s);
107 void wpa_bss_flush(struct wpa_supplicant *wpa_s);
108 void wpa_bss_flush_by_age(struct wpa_supplicant *wpa_s, int age);
109 struct wpa_bss * wpa_bss_get(struct wpa_supplicant *wpa_s, const u8 *bssid,
110 const u8 *ssid, size_t ssid_len);
111 struct wpa_bss * wpa_bss_get_bssid(struct wpa_supplicant *wpa_s,
112 const u8 *bssid);
113 struct wpa_bss * wpa_bss_get_bssid_latest(struct wpa_supplicant *wpa_s,
114 const u8 *bssid);
115 struct wpa_bss * wpa_bss_get_p2p_dev_addr(struct wpa_supplicant *wpa_s,
116 const u8 *dev_addr);
117 struct wpa_bss * wpa_bss_get_id(struct wpa_supplicant *wpa_s, unsigned int id);
118 struct wpa_bss * wpa_bss_get_id_range(struct wpa_supplicant *wpa_s,
119 unsigned int idf, unsigned int idl);
120 const u8 * wpa_bss_get_ie(const struct wpa_bss *bss, u8 ie);
121 const u8 * wpa_bss_get_vendor_ie(const struct wpa_bss *bss, u32 vendor_type);
122 const u8 * wpa_bss_get_vendor_ie_beacon(const struct wpa_bss *bss,
123 u32 vendor_type);
124 struct wpabuf * wpa_bss_get_vendor_ie_multi(const struct wpa_bss *bss,
125 u32 vendor_type);
126 struct wpabuf * wpa_bss_get_vendor_ie_multi_beacon(const struct wpa_bss *bss,
127 u32 vendor_type);
128 int wpa_bss_get_max_rate(const struct wpa_bss *bss);
129 int wpa_bss_get_bit_rates(const struct wpa_bss *bss, u8 **rates);
130 struct wpa_bss_anqp * wpa_bss_anqp_alloc(void);
131 int wpa_bss_anqp_unshare_alloc(struct wpa_bss *bss);
132
bss_is_dmg(const struct wpa_bss * bss)133 static inline int bss_is_dmg(const struct wpa_bss *bss)
134 {
135 return bss->freq > 45000;
136 }
137
138 #endif /* BSS_H */
139