DGNum/hostapd
6
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions
hostapd/wpa_supplicant/scan.h

100 lines
4.3 KiB
C
Raw Normal View History

Move wpa_supplicant specific scan code away from src/drivers This fits better in wpa_supplicant/scan.c. Couple of remaining scan_helpers.c functions are currently used in driver wrappers, but they can likely be removed in the future.
2010-01-03 17:48:11 +01:00
/*
* WPA Supplicant - Scanning
Add helper functions for cloning and freeing scan parameters Signed-hostap: Jouni Malinen <j@w1.fi>
2014-01-03 08:48:00 +01:00
* Copyright (c) 2003-2014, Jouni Malinen <j@w1.fi>
Move wpa_supplicant specific scan code away from src/drivers This fits better in wpa_supplicant/scan.c. Couple of remaining scan_helpers.c functions are currently used in driver wrappers, but they can likely be removed in the future.
2010-01-03 17:48:11 +01:00
*
Remove the GPL notification from files contributed by Jouni Malinen Remove the GPL notification text from the files that were initially contributed by myself. Signed-hostap: Jouni Malinen <j@w1.fi>
2012-02-11 15:46:35 +01:00
* This software may be distributed under the terms of the BSD license.
* See README for more details.
Move wpa_supplicant specific scan code away from src/drivers This fits better in wpa_supplicant/scan.c. Couple of remaining scan_helpers.c functions are currently used in driver wrappers, but they can likely be removed in the future.
2010-01-03 17:48:11 +01:00
*/
#ifndef SCAN_H
#define SCAN_H
Move scan/roaming related defines to a header file This is a step towards allowing these values to be used in both scan.c and events.c. Signed-off-by: Emmanuel Grumbach <emmanuel.grumbach@intel.com>
2019-12-06 23:27:47 +01:00
/*
* Noise floor values to use when we have signal strength
* measurements, but no noise floor measurements. These values were
* measured in an office environment with many APs.
*/
#define DEFAULT_NOISE_FLOOR_2GHZ (-89)
#define DEFAULT_NOISE_FLOOR_5GHZ (-92)
Prefer 6 GHz APs for connection in BSS selection Prefer 6 GHz APs when estimated throughputs are equal with APs from the 2.4/5 GHz bands while selecting APs for connection. Also add a 6 GHz specific noise floor default value for the 6 GHz band (with the same value as was used for 5 GHz previously) to make this step clearer. Signed-off-by: Jouni Malinen <jouni@codeaurora.org>
2021-05-04 15:46:44 +02:00
#define DEFAULT_NOISE_FLOOR_6GHZ (-92)
Move scan/roaming related defines to a header file This is a step towards allowing these values to be used in both scan.c and events.c. Signed-off-by: Emmanuel Grumbach <emmanuel.grumbach@intel.com>
2019-12-06 23:27:47 +01:00
/*
* Channels with a great SNR can operate at full rate. What is a great SNR?
* This doc https://supportforums.cisco.com/docs/DOC-12954 says, "the general
* rule of thumb is that any SNR above 20 is good." This one
* http://www.cisco.com/en/US/tech/tk722/tk809/technologies_q_and_a_item09186a00805e9a96.shtml#qa23
* recommends 25 as a minimum SNR for 54 Mbps data rate. The estimates used in
* scan_est_throughput() allow even smaller SNR values for the maximum rates
* (21 for 54 Mbps, 22 for VHT80 MCS9, 24 for HT40 and HT20 MCS7). Use 25 as a
* somewhat conservative value here.
*/
#define GREAT_SNR 25
Add support to calculate estimated throughputs for HE rates Add support to consider HE rates while estimating throughputs for the scan results from HE enabled APs. HE 0.8 usec GI rates are used in all tables. The minimum SNR values for HE rates (1024-QAM) are derived by adding the existing minimum SNR values of 256-QAM rates from VHT tables and the difference between the values of minimum sensitivity levels of 256-QAM rates and 1024-QAM rates defined in Table 27-51 (Receiver minimum input level sensitivity) in IEEE P802.11ax/D8.0. Signed-off-by: Jouni Malinen <jouni@codeaurora.org>
2021-05-04 15:01:18 +02:00
#define IS_2P4GHZ(n) (n >= 2412 && n <= 2484)
Prefer 6 GHz APs for connection in BSS selection Prefer 6 GHz APs when estimated throughputs are equal with APs from the 2.4/5 GHz bands while selecting APs for connection. Also add a 6 GHz specific noise floor default value for the 6 GHz band (with the same value as was used for 5 GHz previously) to make this step clearer. Signed-off-by: Jouni Malinen <jouni@codeaurora.org>
2021-05-04 15:46:44 +02:00
#define IS_5GHZ(n) (n > 4000 && n < 5895)
Move scan/roaming related defines to a header file This is a step towards allowing these values to be used in both scan.c and events.c. Signed-off-by: Emmanuel Grumbach <emmanuel.grumbach@intel.com>
2019-12-06 23:27:47 +01:00
Validate WEP key lengths based on driver capabilities The nl80211 driver interface does not allow 128-bit WEP to be used without a vendor specific cipher suite and no such suite is defined for this purpose. Do not accept WEP key length 16 for nl80211 driver interface forn ow. wext-interface can still try to use these for backwards compatibility. Signed-hostap: Jouni Malinen <jouni@qca.qualcomm.com>
2012-05-10 13:34:46 +02:00
int wpa_supplicant_enabled_networks(struct wpa_supplicant *wpa_s);
Move wpa_supplicant specific scan code away from src/drivers This fits better in wpa_supplicant/scan.c. Couple of remaining scan_helpers.c functions are currently used in driver wrappers, but they can likely be removed in the future.
2010-01-03 17:48:11 +01:00
void wpa_supplicant_req_scan(struct wpa_supplicant *wpa_s, int sec, int usec);
Add delayed scheduled scan request When initializing, the scheduled scan code was being called before everything is ready. With normal scans, the first scan round is delayed, so the initialization is finished by the time it really starts. Add a function that can be used to request a delayed scheduled scan. The scan will only start after the specified time has elapsed. Call this function instead of starting the scheduled scan directly during driver initialization. Signed-off-by: Luciano Coelho <coelho@ti.com>
2011-09-27 21:21:38 +02:00
int wpa_supplicant_delayed_sched_scan(struct wpa_supplicant *wpa_s,
int sec, int usec);
Add scheduled scan driver operations In new Linux kernel versions (>=3.0), nl80211 adds scheduled scan capability. In order to use this feature to its full extent, we need to support it in the wpa_supplicant core, so that it can also be used by other drivers. This commit adds initial scheduled scan support operations and events. Signed-off-by: Luciano Coelho <coelho@ti.com>
2011-09-27 21:21:29 +02:00
int wpa_supplicant_req_sched_scan(struct wpa_supplicant *wpa_s);
Move wpa_supplicant specific scan code away from src/drivers This fits better in wpa_supplicant/scan.c. Couple of remaining scan_helpers.c functions are currently used in driver wrappers, but they can likely be removed in the future.
2010-01-03 17:48:11 +01:00
void wpa_supplicant_cancel_scan(struct wpa_supplicant *wpa_s);
Cancel delayed scheduled scan when wpa_supplicant cleans up Because a delayed scheduled scan will access the members of struct wpa_supplicant which is freed and this can result in a crash, wpa_supplicant needs to cancel delayed scheduled scan during cleanups. Signed-hostap: Chengyi Zhao <chengyix.zhao@gmail.com>
2013-07-20 16:47:02 +02:00
void wpa_supplicant_cancel_delayed_sched_scan(struct wpa_supplicant *wpa_s);
Add scheduled scan driver operations In new Linux kernel versions (>=3.0), nl80211 adds scheduled scan capability. In order to use this feature to its full extent, we need to support it in the wpa_supplicant core, so that it can also be used by other drivers. This commit adds initial scheduled scan support operations and events. Signed-off-by: Luciano Coelho <coelho@ti.com>
2011-09-27 21:21:29 +02:00
void wpa_supplicant_cancel_sched_scan(struct wpa_supplicant *wpa_s);
Move wpa_supplicant specific scan code away from src/drivers This fits better in wpa_supplicant/scan.c. Couple of remaining scan_helpers.c functions are currently used in driver wrappers, but they can likely be removed in the future.
2010-01-03 17:48:11 +01:00
void wpa_supplicant_notify_scanning(struct wpa_supplicant *wpa_s,
int scanning);
struct wpa_driver_scan_params;
int wpa_supplicant_trigger_scan(struct wpa_supplicant *wpa_s,
Use default IEs in wpa_supplicant_trigger_scan() wpa_supplicant_trigger_scan() previously wouldn't include any of the IEs generated by wpa_supplicant_extra_ies(). Instruct it to do so in most cases. This is necessary because MBO STAs are required to include MBO capabilities in their Probe Request frames. Signed-off-by: Matthew Wang <matthewmwang@chromium.org>
2023-06-03 00:15:08 +02:00
struct wpa_driver_scan_params *params,
bool default_ies);
Move wpa_supplicant specific scan code away from src/drivers This fits better in wpa_supplicant/scan.c. Couple of remaining scan_helpers.c functions are currently used in driver wrappers, but they can likely be removed in the future.
2010-01-03 17:48:11 +01:00
struct wpa_scan_results *
wpa_supplicant_get_scan_results(struct wpa_supplicant *wpa_s,
struct scan_info *info, int new_scan);
int wpa_supplicant_update_scan_results(struct wpa_supplicant *wpa_s);
Remove src/drivers/scan_helpers.c Most of this file was already moved into wpa_supplicant/scan.c and we can remove the file completely by having couple of small helper functions copied to the remaining users outside core wpa_supplicant code.
2010-01-03 19:27:32 +01:00
const u8 * wpa_scan_get_ie(const struct wpa_scan_res *res, u8 ie);
scan: Helper function to get ML IE of specified type from scan result IEs Add a helper function to get Multi-Link element of a specified type from scan result Probe Response frame or Beacon frame elements. Signed-off-by: Shivani Baranwal <quic_shivbara@quicinc.com>
2022-09-08 16:44:13 +02:00
const u8 * wpa_scan_get_ml_ie(const struct wpa_scan_res *res, u8 type);
Move wpa_supplicant specific scan code away from src/drivers This fits better in wpa_supplicant/scan.c. Couple of remaining scan_helpers.c functions are currently used in driver wrappers, but they can likely be removed in the future.
2010-01-03 17:48:11 +01:00
const u8 * wpa_scan_get_vendor_ie(const struct wpa_scan_res *res,
u32 vendor_type);
P2P: Allow GO to be discovered based on Beacon frame This fixes some P2P-join-a-group cases where GO may have been discovered based on passive scan or non-P2P scan. P2P IEs may have been received from a Beacon frame in such a case and that information can be used to create a P2P peer entry, e.g., to allow provision discovery exchange to be completed. Signed-hostap: Jouni Malinen <jouni@qca.qualcomm.com>
2013-10-14 18:25:28 +02:00
const u8 * wpa_scan_get_vendor_ie_beacon(const struct wpa_scan_res *res,
u32 vendor_type);
Move wpa_supplicant specific scan code away from src/drivers This fits better in wpa_supplicant/scan.c. Couple of remaining scan_helpers.c functions are currently used in driver wrappers, but they can likely be removed in the future.
2010-01-03 17:48:11 +01:00
struct wpabuf * wpa_scan_get_vendor_ie_multi(const struct wpa_scan_res *res,
u32 vendor_type);
Add BSSID filter for testing purposes wpa_supplicant can now be configured to filter out scan results based on a BSSID filter. Space-separated set of allowed BSSIDs can be set with wpa_cli set bssid_filter command. Filtering mechanism can be disabled by setting this variable to an empty list. When set, only the BSSes that have a matching entry in this list will be accepted from scan results. Signed-hostap: Jouni Malinen <jouni@qca.qualcomm.com>
2012-02-16 15:30:13 +01:00
int wpa_supplicant_filter_bssid_match(struct wpa_supplicant *wpa_s,
const u8 *bssid);
Update scan interval gracefully When the scan interval is changed the new interval is effective after the old interval timer fires off one last time. This can cause an unacceptable long delay when updating the interval. Change this behaviour to use MIN(left of old interval, new interval) for the scan interval following the interval change. Signed-hostap: Pontus Fuchs <pontus.fuchs@gmail.com>
2013-02-03 17:14:05 +01:00
void wpa_supplicant_update_scan_int(struct wpa_supplicant *wpa_s, int sec);
Add 'SCAN TYPE=ONLY' functionality Usual manual scan request may cause reassociation due to several reasons. New command is intended to perform pure scan without taking any automatic action based on the results. Signed-off-by: Dmitry Shmidt <dimitrysh@google.com>
2013-02-07 17:06:51 +01:00
void scan_only_handler(struct wpa_supplicant *wpa_s,
struct wpa_scan_results *scan_res);
P2P: Postpone P2P scan only if station mode scan is pending sta_scan_pending was supposed to be accurate enough for determining whether a P2P scan needs to be postponed. However, it has turned out that there were cases where sta_scan_pending was not cleared properly. While the known cases have now been addressed, it is possible that some other cases may still exist. To avoid issues with P2P operationg getting stuck, verify more carefully that there is a real pending station mode scan (either in progress or scheduled to be requested). Signed-hostap: Jouni Malinen <jouni@qca.qualcomm.com>
2013-03-18 16:11:15 +01:00
int wpas_scan_scheduled(struct wpa_supplicant *wpa_s);
Add helper functions for cloning and freeing scan parameters Signed-hostap: Jouni Malinen <j@w1.fi>
2014-01-03 08:48:00 +01:00
struct wpa_driver_scan_params *
wpa_scan_clone_params(const struct wpa_driver_scan_params *src);
void wpa_scan_free_params(struct wpa_driver_scan_params *params);
PNO: Move and rename pno_start()/pno_stop() Move pno_start() and pno_stop() to scan.c as a more relevant location and rename them to wpas_start_pno()/wpas_stop_pno(). Signed-off-by: Alexander Bondar <alexander.bondar@intel.com> Signed-off-by: Ilan Peer <ilan.peer@intel.com>
2014-02-26 07:04:10 +01:00
int wpas_start_pno(struct wpa_supplicant *wpa_s);
int wpas_stop_pno(struct wpa_supplicant *wpa_s);
wpa_supplicant: Cancel sched_scan on SELECT_NETWORK initiated scan If a scheduled scan is running on select network command, cancel and reset it before kicking off a regular scan request. Signed-off-by: Max Stepanov <Max.Stepanov@intel.com>
2016-09-05 16:32:58 +02:00
void wpas_scan_reset_sched_scan(struct wpa_supplicant *wpa_s);
Share a common helper function for restarting sched_scan This code sequence was already used at two different places (and an additional one has been proposed), so add a common helper function to avoid having to copy-paste this functionality in multiple locations. Signed-off-by: Jouni Malinen <jouni@qca.qualcomm.com>
2016-09-26 23:09:33 +02:00
void wpas_scan_restart_sched_scan(struct wpa_supplicant *wpa_s);
Move wpa_supplicant specific scan code away from src/drivers This fits better in wpa_supplicant/scan.c. Couple of remaining scan_helpers.c functions are currently used in driver wrappers, but they can likely be removed in the future.
2010-01-03 17:48:11 +01:00
scan: Add MAC address randomization in scan handling 1. Supported MAC address randomization for scan. 2. Supported MAC address randomization for scheduled scan. 2. Supported MAC address randomization for pno. 4. Add functions to set and clear the MAC address randomization state variables. Signed-off-by: Ilan Peer <ilan.peer@intel.com>
2014-12-29 07:41:06 +01:00
void wpas_mac_addr_rand_scan_clear(struct wpa_supplicant *wpa_s,
unsigned int type);
int wpas_mac_addr_rand_scan_set(struct wpa_supplicant *wpa_s,
unsigned int type, const u8 *addr,
const u8 *mask);
D-Bus: Add MAC address randomization endpoints Add D-Bus property: * MACAddressRandomizationMask: a{say} which configure random MAC address functionality in the Wi-Fi driver via netlink. Signed-off-by: Eric Caruso <ejcaruso@chromium.org>
2019-10-18 01:03:51 +02:00
int wpas_mac_addr_rand_scan_get_mask(struct wpa_supplicant *wpa_s,
unsigned int type, u8 *mask);
Abort an ongoing scan before connect Connect radio work is sometimes delayed for a considerable duration if there is an ongoing scan radio work. To avoid these delays abort the ongoing scan on that interface before queuing a connect request. Upon a scan done indication from the driver, connect radio work will be scheduled. Signed-off-by: Jouni Malinen <jouni@qca.qualcomm.com>
2015-10-19 16:00:34 +02:00
int wpas_abort_ongoing_scan(struct wpa_supplicant *wpa_s);
WNM: Fetch scan results before checking transition candidates On receiving a WNM BSS Transition Management Request frame with a candidate list, fetch the latest scan results from the kernel to see if there are any recent scan results for the candidates and initiate a connection if found. This helps to avoid triggering a new scan in cases where a scan initiated by something else (e.g., an internal beacon measurement report functionality in a driver) has processed Beacon or Probe Response frames without wpa_supplicant having received a notification of such an update yet. Signed-off-by: Jouni Malinen <jouni@qca.qualcomm.com>
2016-04-21 13:29:56 +02:00
void filter_scan_res(struct wpa_supplicant *wpa_s,
struct wpa_scan_results *res);
void scan_snr(struct wpa_scan_res *res);
void scan_est_throughput(struct wpa_supplicant *wpa_s,
struct wpa_scan_res *res);
Move throughput estimation into a helper function This is a step towards allowing this functionality to update the scan result -based values with the values from a signal poll for the current BSS. Signed-off-by: Emmanuel Grumbach <emmanuel.grumbach@intel.com>
2019-12-06 23:27:47 +01:00
unsigned int wpas_get_est_tpt(const struct wpa_supplicant *wpa_s,
const u8 *ies, size_t ies_len, int rate,
Check local supported features for estimating BSS throughputs accurately Add checks for features supported by the specific hardware mode of the local device that has the channel for which the throughput is being estimated instead of assuming the local device supports all optional features. This is more accurate for cases where the local capabilities might differ based on the band. In addition, this is in preparation for extending rate estimates to cover optional VHT and HE features. Signed-off-by: Jouni Malinen <jouni@codeaurora.org>
2021-05-04 21:15:30 +02:00
int snr, int freq);
Set default scan IEs to the driver (QCA vendor extension) This makes wpa_supplicant set default scan IEs to the driver (if the vendor command is supported). The driver can use these IEs in the scan requests initiated by the driver itself. Also the driver can merge these IEs into further scan requests that it receives, in case if the scan request doesn't carry any of the IEs sent in this command. Signed-off-by: Jouni Malinen <jouni@qca.qualcomm.com>
2016-07-19 09:11:15 +02:00
void wpa_supplicant_set_default_scan_ies(struct wpa_supplicant *wpa_s);
scan: Add a helper function to append supported freqs from a given band This functionality was repeated for couple of times. Use a shared helper function to avoid code duplication. Signed-off-by: Veerendranath Jakkam <vjakkam@codeaurora.org>
2020-11-20 15:28:50 +01:00
int wpa_add_scan_freqs_list(struct wpa_supplicant *wpa_s,
enum hostapd_hw_mode band,
Use bool for is_6ghz variables and functions Replace the implicit boolean checks that used int variables with use of a more explicit bool variable type. Signed-off-by: Jouni Malinen <jouni@codeaurora.org>
2020-12-11 16:18:09 +01:00
struct wpa_driver_scan_params *params,
P2P: Support preferred GO band based optimization for scanning Allow specifying preferred GO band in addition to frequency. If a band is specified, the first two scans will be limited to only non-DFS channels to shorten scan times, and the next two will scan the entire band. Signed-off-by: Matthew Wang <matthewmwang@chromium.org>
2022-12-16 20:10:02 +01:00
bool is_6ghz, bool only_6ghz_psc,
bool exclude_radar);
scan: Add MAC address randomization in scan handling 1. Supported MAC address randomization for scan. 2. Supported MAC address randomization for scheduled scan. 2. Supported MAC address randomization for pno. 4. Add functions to set and clear the MAC address randomization state variables. Signed-off-by: Ilan Peer <ilan.peer@intel.com>
2014-12-29 07:41:06 +01:00
Move wpa_supplicant specific scan code away from src/drivers This fits better in wpa_supplicant/scan.c. Couple of remaining scan_helpers.c functions are currently used in driver wrappers, but they can likely be removed in the future.
2010-01-03 17:48:11 +01:00
#endif /* SCAN_H */
Reference in a new issue Copy permalink