wpa_supplicant/bss.h

   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
 133 static inline int bss_is_dmg(const struct wpa_bss *bss)
 134 {
 135         return bss->freq > 45000;
 136 }
 137
 138 #endif /* BSS_H */