hostapd
Classes | Public Attributes | List of all members
wpa_driver_scan_params Struct Reference

struct wpa_driver_scan_params - Scan parameters Data for struct wpa_driver_ops::scan2(). More...

#include <driver.h>

Classes

struct  sched_scan_plan
 sched_scan_plans - Scan plans for scheduled scan More...
 
struct  wpa_driver_scan_filter
 filter_ssids - Filter for reporting SSIDs More...
 

Public Attributes

struct wpa_driver_scan_ssid ssids [WPAS_MAX_SCAN_SSIDS]
 ssids - SSIDs to scan for
 
size_t num_ssids
 num_ssids - Number of entries in ssids array Zero indicates a request for a passive scan.
 
const u8 * extra_ies
 extra_ies - Extra IE(s) to add into Probe Request or NULL
 
size_t extra_ies_len
 extra_ies_len - Length of extra_ies in octets
 
int * freqs
 freqs - Array of frequencies to scan or NULL for all frequencies More...
 
struct wpa_driver_scan_params::wpa_driver_scan_filterfilter_ssids
 
size_t num_filter_ssids
 num_filter_ssids - Number of entries in filter_ssids array
 
s32 filter_rssi
 filter_rssi - Filter by RSSI More...
 
unsigned int p2p_probe:1
 p2p_probe - Used to disable CCK (802.11b) rates for P2P probes More...
 
unsigned int only_new_results:1
 only_new_results - Request driver to report only new results More...
 
unsigned int low_priority:1
 low_priority - Requests driver to use a lower scan priority More...
 
unsigned int mac_addr_rand:1
 mac_addr_rand - Requests driver to randomize MAC address
 
const u8 * mac_addr
 mac_addr - MAC address used with randomization. More...
 
const u8 * mac_addr_mask
 mac_addr_mask - MAC address mask used with randomization. More...
 
struct wpa_driver_scan_params::sched_scan_plansched_scan_plans
 
unsigned int sched_scan_plans_num
 sched_scan_plans_num - Number of scan plans in sched_scan_plans array
 
const u8 * bssid
 bssid - Specific BSSID to scan for More...
 
u64 scan_cookie
 scan_cookie - Unique identification representing the scan request More...
 
u16 duration
 duration - Dwell time on each channel More...
 
unsigned int duration_mandatory:1
 duration_mandatory - Whether the specified duration is mandatory More...
 

Detailed Description

struct wpa_driver_scan_params - Scan parameters Data for struct wpa_driver_ops::scan2().

Member Data Documentation

§ bssid

const u8* wpa_driver_scan_params::bssid

bssid - Specific BSSID to scan for

This optional parameter can be used to replace the default wildcard BSSID with a specific BSSID to scan for if results are needed from only a single BSS.

§ duration

u16 wpa_driver_scan_params::duration

duration - Dwell time on each channel

This optional parameter can be used to set the dwell time on each channel. In TUs.

§ duration_mandatory

unsigned int wpa_driver_scan_params::duration_mandatory

duration_mandatory - Whether the specified duration is mandatory

If this is set, the duration specified by the duration field is mandatory (and the driver should reject the scan request if it is unable to comply with the specified duration), otherwise it is the maximum duration and the actual duration may be shorter.

§ filter_rssi

s32 wpa_driver_scan_params::filter_rssi

filter_rssi - Filter by RSSI

The driver may filter scan results in firmware to reduce host wakeups and thereby save power. Specify the RSSI threshold in s32 dBm.

§ freqs

int* wpa_driver_scan_params::freqs

freqs - Array of frequencies to scan or NULL for all frequencies

The frequency is set in MHz. The array is zero-terminated.

§ low_priority

unsigned int wpa_driver_scan_params::low_priority

low_priority - Requests driver to use a lower scan priority

This is used to request the driver to use a lower scan priority if it supports such a thing.

§ mac_addr

const u8* wpa_driver_scan_params::mac_addr

mac_addr - MAC address used with randomization.

The address cannot be a multicast one, i.e., bit 0 of byte 0 should not be set.

§ mac_addr_mask

const u8* wpa_driver_scan_params::mac_addr_mask

mac_addr_mask - MAC address mask used with randomization.

Bits that are 0 in the mask should be randomized. Bits that are 1 in the mask should be taken as is from mac_addr. The mask should not allow the generation of a multicast address, i.e., bit 0 of byte 0 must be set.

§ only_new_results

unsigned int wpa_driver_scan_params::only_new_results

only_new_results - Request driver to report only new results

This is used to request the driver to report only BSSes that have been detected after this scan request has been started, i.e., to flush old cached BSS entries.

§ p2p_probe

unsigned int wpa_driver_scan_params::p2p_probe

p2p_probe - Used to disable CCK (802.11b) rates for P2P probes

When set, the driver is expected to remove rates 1, 2, 5.5, and 11 Mbps from the support rates element(s) in the Probe Request frames and not to transmit the frames at any of those rates.

§ scan_cookie

u64 wpa_driver_scan_params::scan_cookie

scan_cookie - Unique identification representing the scan request

This scan_cookie carries a unique identification representing the scan request if the host driver/kernel supports concurrent scan requests. This cookie is returned from the corresponding driver interface.

Note: Unlike other parameters in this structure, scan_cookie is used only to return information instead of setting parameters for the scan.


The documentation for this struct was generated from the following file: