Home | History | Annotate | Download | only in wpa_supplicant
      1 /*
      2  * BSS table
      3  * Copyright (c) 2009-2010, Jouni Malinen <j (at) 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 
    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