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

112 lines
4.8 KiB
C
Raw Permalink 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
Adjust the SNR when comparing BSSes based on Tx power config The max transmit power of Standard Power (SP) Access Points (AP) on 6 GHz band and APs on 2.4 GHz and 5 GHz bands is limited by effective isotropic radiated power (EIRP), while the max transmit power of Low Power Indoor (LPI) APs on 6 GHz Band is limited by power spectral density (PSD). Therefore the max transmit power of LPI APs grows as the channel width increases, similar to the noise power which has constant PSD. Adjust the SNR of BSSes based on the transmit power config and max channel width. EIRP limited APs usually have constant max transmit power on different channel widths, their SNR decreases on larger channel width because the noise power is higher, while PSD limited APs have constant SNR over all channel widths. Signed-off-by: Kaidong Wang <kaidong@chromium.org>
2023-11-08 04:58:05 +01:00
/*
* IEEE Sts 802.11ax-2021, 9.4.2.161 (Transmit Power Envelope element) indicates
* no max TX power limit if Maximum Transmit Power field is 63.5 dBm.
* The default TX power if it is not constrained by Transmit Power Envelope
* element.
*/
#define TX_POWER_NO_CONSTRAINT 64
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,
Scan 6 GHz channels after change to 6 GHz-allowed regdom Drivers will often report regdom changes in the middle of a scan if they detect during that scan that the regulatory domain has changed. If this happens and we enter a regdom that supports 6 GHz channels when the previous one didn't (this often happens in 6 GHz-capable regdoms for devices after suspend/resume), immediately trigger a 6 GHz-only scan if we were not able to connect to an AP on a legacy band. This should significantly improve connection time to 6 GHz AP after regdom has been reset. Signed-off-by: Matthew Wang <matthewmwang@chromium.org>
2023-06-03 00:15:11 +02:00
bool default_ies, bool next);
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,
Optimize internal BSS table updates based on a specific BSSID When wpa_supplicant needed to update the internal BSS table with the latest scan results from the driver, it fetched all BSSs and processed them all. This is unnecessary for cases where an update is needed only for a specific BSS. Optimize this by filtering out the unnecessary entries from the results. Signed-off-by: Jouni Malinen <quic_jouni@quicinc.com>
2024-03-20 10:20:43 +01:00
struct scan_info *info, int new_scan,
const u8 *bssid);
int wpa_supplicant_update_scan_results(struct wpa_supplicant *wpa_s,
const u8 *bssid);
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 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,
Adjust the SNR when comparing BSSes based on Tx power config The max transmit power of Standard Power (SP) Access Points (AP) on 6 GHz band and APs on 2.4 GHz and 5 GHz bands is limited by effective isotropic radiated power (EIRP), while the max transmit power of Low Power Indoor (LPI) APs on 6 GHz Band is limited by power spectral density (PSD). Therefore the max transmit power of LPI APs grows as the channel width increases, similar to the noise power which has constant PSD. Adjust the SNR of BSSes based on the transmit power config and max channel width. EIRP limited APs usually have constant max transmit power on different channel widths, their SNR decreases on larger channel width because the noise power is higher, while PSD limited APs have constant SNR over all channel widths. Signed-off-by: Kaidong Wang <kaidong@chromium.org>
2023-11-08 04:58:05 +01:00
int snr, int freq, enum chan_width *max_cw);
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);
Adjust the SNR when comparing BSSes based on Tx power config The max transmit power of Standard Power (SP) Access Points (AP) on 6 GHz band and APs on 2.4 GHz and 5 GHz bands is limited by effective isotropic radiated power (EIRP), while the max transmit power of Low Power Indoor (LPI) APs on 6 GHz Band is limited by power spectral density (PSD). Therefore the max transmit power of LPI APs grows as the channel width increases, similar to the noise power which has constant PSD. Adjust the SNR of BSSes based on the transmit power config and max channel width. EIRP limited APs usually have constant max transmit power on different channel widths, their SNR decreases on larger channel width because the noise power is higher, while PSD limited APs have constant SNR over all channel widths. Signed-off-by: Kaidong Wang <kaidong@chromium.org>
2023-11-08 04:58:05 +01:00
int wpas_channel_width_rssi_bump(const u8 *ies, size_t ies_len,
enum chan_width cw);
int wpas_adjust_snr_by_chanwidth(const u8 *ies, size_t ies_len,
enum chan_width max_cw, int snr);
bgscan: Add OWE transition mode SSID to network scan Add transition mode SSIDs to the SSID scan-list for bgscan. This is currently missing and bgscan fails to scan for SSIDs on the OWE transition network if one is currently used. Signed-off-by: David Bauer <mail@david-bauer.net>
2024-04-28 15:13:43 +02:00
void wpa_add_owe_scan_ssid(struct wpa_supplicant *wpa_s,
struct wpa_driver_scan_params *params,
const struct wpa_ssid *ssid, size_t max_ssids);
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