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
12struct 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 */
25struct 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 */
52struct 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
99void wpa_bss_update_start(struct wpa_supplicant *wpa_s);
100void wpa_bss_update_scan_res(struct wpa_supplicant *wpa_s,
101			     struct wpa_scan_res *res,
102			     struct os_reltime *fetch_time);
103void wpa_bss_update_end(struct wpa_supplicant *wpa_s, struct scan_info *info,
104			int new_scan);
105int wpa_bss_init(struct wpa_supplicant *wpa_s);
106void wpa_bss_deinit(struct wpa_supplicant *wpa_s);
107void wpa_bss_flush(struct wpa_supplicant *wpa_s);
108void wpa_bss_flush_by_age(struct wpa_supplicant *wpa_s, int age);
109struct wpa_bss * wpa_bss_get(struct wpa_supplicant *wpa_s, const u8 *bssid,
110			     const u8 *ssid, size_t ssid_len);
111struct wpa_bss * wpa_bss_get_bssid(struct wpa_supplicant *wpa_s,
112				   const u8 *bssid);
113struct wpa_bss * wpa_bss_get_bssid_latest(struct wpa_supplicant *wpa_s,
114					  const u8 *bssid);
115struct wpa_bss * wpa_bss_get_p2p_dev_addr(struct wpa_supplicant *wpa_s,
116					  const u8 *dev_addr);
117struct wpa_bss * wpa_bss_get_id(struct wpa_supplicant *wpa_s, unsigned int id);
118struct wpa_bss * wpa_bss_get_id_range(struct wpa_supplicant *wpa_s,
119				      unsigned int idf, unsigned int idl);
120const u8 * wpa_bss_get_ie(const struct wpa_bss *bss, u8 ie);
121const u8 * wpa_bss_get_vendor_ie(const struct wpa_bss *bss, u32 vendor_type);
122const u8 * wpa_bss_get_vendor_ie_beacon(const struct wpa_bss *bss,
123					u32 vendor_type);
124struct wpabuf * wpa_bss_get_vendor_ie_multi(const struct wpa_bss *bss,
125					    u32 vendor_type);
126struct wpabuf * wpa_bss_get_vendor_ie_multi_beacon(const struct wpa_bss *bss,
127						   u32 vendor_type);
128int wpa_bss_get_max_rate(const struct wpa_bss *bss);
129int wpa_bss_get_bit_rates(const struct wpa_bss *bss, u8 **rates);
130struct wpa_bss_anqp * wpa_bss_anqp_alloc(void);
131int wpa_bss_anqp_unshare_alloc(struct wpa_bss *bss);
132
133static inline int bss_is_dmg(const struct wpa_bss *bss)
134{
135	return bss->freq > 45000;
136}
137
138#endif /* BSS_H */
139