STRUCT CFG80211_SCHED_SCAN_REQUEST(9)

📦 version 7.3.1, in nixpkgs unstable

💖 NAME 💖

okay so you opened the struct cfg80211_sched_scan_request(9) page in the Kernel API Manual and you need the whole struct tea? say less bestie, this is the scheduled scan request description and we are going through every single field like the main characters they are 💅✨

✨ SYNOPSIS ✨

struct cfg80211_sched_scan_request {
    u64 reqid;
    struct cfg80211_ssid *ssids;
    int n_ssids;
    u32 n_channels;
    const u8 *ie;
    size_t ie_len;
    u32 flags;
    struct cfg80211_match_set *match_sets;
    int n_match_sets;
    s32 min_rssi_thold;
    u32 delay;
    struct cfg80211_sched_scan_plan *scan_plans;
    int n_scan_plans;
    u8 mac_addr[ETH_ALEN];
    u8 mac_addr_mask[ETH_ALEN];
    bool relative_rssi_set;
    s8 relative_rssi;
    struct cfg80211_bss_select_adjust rssi_adjust;
    struct wiphy *wiphy;
    struct net_device *dev;
    unsigned long scan_start;
    bool report_results;
    struct rcu_head rcu_head;
    u32 owner_nlportid;
    bool nl_owner_dead;
    struct list_head list;
    struct ieee80211_channel *channels[];
};

🎀 Members 🎀

  • reqid — identifies this request, like a little name tag for the whole vibe 🏷️
  • ssids — SSIDs to scan for (passed in the probe_reqs in active scans) 👀
  • n_ssids — number of SSIDs, bestie 🔢
  • n_channels — total number of channels to scan 📡
  • ie — optional information element(s) to add into Probe Request, or NULL 🫶
  • ie_len — length of ie in octets 📏
  • flags — control flags from enum nl80211_scan_flags 🚩
  • match_sets — sets of parameters to be matched for a scan result entry to be considered valid and to be passed to the host (others are filtered out). If omitted, all results are passed. basically the bouncer for scan results 💅
  • n_match_sets — number of match sets 🔢
  • min_rssi_thold — for drivers only supporting a single threshold, this contains the minimum over all matchsets 📶
  • delay — delay in seconds to use before starting the first scan cycle. The driver may ignore this parameter and start immediately (or at any other time), if this feature is not supported. no cap, it might just do its own thing 😭
  • scan_plans — scan plans to be executed in this scheduled scan. Lowest index must be executed first. order matters, periodt 📋
  • n_scan_plans — number of scan plans, at least 1 ☝️
  • mac_addr — MAC address used with randomisation 🎲
  • mac_addr_mask — MAC address mask used with randomisation, bits that are 0 in the mask should be randomised, bits that are 1 should be taken from the mac_addr 🎭
  • relative_rssi_set — Indicates whether relative_rssi is set or not ✅
  • relative_rssi — Relative RSSI threshold in dB to restrict scan result reporting in connected state to cases where a matching BSS is determined to have better or slightly worse RSSI than the current connected BSS. The relative RSSI threshold values are ignored in disconnected state. connected-state only, iykyk 📶
  • rssi_adjust — delta dB of RSSI preference to be given to the BSSs that belong to the specified band while deciding whether a better BSS is reported using relative_rssi. If delta is a negative number, the BSSs that belong to the specified band will be penalized by delta dB in relative comparisons. lowkey a whole scoring system 🧮
  • wiphy — the wiphy this was for 🌈
  • dev — the interface 🔌
  • scan_start — start time of the scheduled scan ⏰
  • report_results — indicates that results were reported for this request 📬
  • rcu_head — RCU callback used to free the struct 🧹
  • owner_nlportid — netlink portid of owner (if this request is owned by a particular socket) 🔑
  • nl_owner_dead — netlink owner socket was closed — this request be freed 💀
  • list — for keeping list of requests 📝
  • channels — channels to scan 📶

💖 SEE ALSO 💖

okay so this part is basically the group chat member list of the cfg80211 universe 💅 like everyone this struct ever dated, roomed with, or borrowed a charger from. it all lives in the kernel file ./include/net/cfg80211.h, and honestly? the roster is long. buckle up bestie 🎀

🌸 the core starting points

🔥 Actions and configuration(9)

the "setting things up" era of the doc set ✨

🦋 Scanning and BSS list handling(9)

the literal neighborhood of the struct this whole page is about, so yeah, pay attention 🙈

  • struct cfg80211_ssid(9), struct cfg80211_scan_info(9), struct cfg80211_scan_6ghz_params(9), struct cfg80211_scan_request(9), struct cfg80211_match_set(9), struct cfg80211_sched_scan_plan(9), struct cfg80211_bss_select_adjust(9), enum cfg80211_signal_type(9), struct cfg80211_inform_bss(9), struct cfg80211_bss_ies(9), struct cfg80211_bss(9), ieee80211_bss_get_elem(9), ieee80211_bss_get_ie(9)
  • struct cfg80211_auth_request(9), struct cfg80211_assoc_link(9), struct cfg80211_ml_reconf_req(9), enum cfg80211_assoc_req_flags(9), struct cfg80211_assoc_request(9), struct cfg80211_deauth_request(9), struct cfg80211_disassoc_request(9), struct cfg80211_ibss_params(9), struct cfg80211_bss_selection(9), struct cfg80211_connect_params(9), enum cfg80211_connect_params_changed(9)
  • enum wiphy_params_flags(9), struct cfg80211_pmksa(9), struct cfg80211_pkt_pattern(9), struct cfg80211_wowlan_tcp(9), struct cfg80211_wowlan(9), struct cfg80211_coalesce_rules(9), struct cfg80211_coalesce(9), struct cfg80211_wowlan_nd_match(9), struct cfg80211_wowlan_nd_info(9), struct cfg80211_wowlan_wakeup(9), struct cfg80211_gtk_rekey_data(9), struct cfg80211_update_ft_ies_params(9), struct cfg80211_mgmt_tx_params(9), struct cfg80211_dscp_exception(9), struct cfg80211_dscp_range(9), struct cfg80211_qos_map(9)

🧚 Neighbor Awareness Networking (NAN)(9)

the NAN girlies get their own corner 💜

  • struct cfg80211_nan_band_config(9), struct cfg80211_nan_conf(9), struct cfg80211_nan_channel(9), struct cfg80211_nan_local_sched(9), struct cfg80211_nan_peer_map(9), struct cfg80211_nan_peer_sched(9), enum cfg80211_nan_conf_changes(9), struct cfg80211_nan_func_filter(9), struct cfg80211_nan_func(9)
  • then the neighbors who aren't NAN but vibe adjacent: struct cfg80211_pmk_conf(9), struct cfg80211_external_auth_params(9), struct cfg80211_ftm_responder_stats(9), struct cfg80211_pmsr_ftm_result(9), struct cfg80211_pmsr_result(9), struct cfg80211_pmsr_ftm_request_peer(9), struct cfg80211_pmsr_request_peer(9), struct cfg80211_pmsr_request(9), struct cfg80211_update_owe_info(9), struct mgmt_frame_regs(9)

👑 the wiphy-verse (yes it's its own universe)

⭐ Utility functions(9)

the little helpers that carry the whole operation 🫶

🌈 Data path helpers(9)

💀 Regulatory enforcement infrastructure(9)

the vibe check of the spectrum, honestly 🔥

🍓 the long tail of scanning, BSS and connect notifs

🎀 and the rest of the notifications (they didn't fit above, ok)

ok and that's the entire friend group 😭 like yes, all of them, nobody got left out, and no we're not done yet — there's still more page coming, so don't go anywhere bestie 💅✨

okay so the SEE ALSO list keeps going, and honestly? she's thriving 💅 buckle up bestie, we're finishing the roll call:

and that's the whole squad 🫶 like, sixty-four cross-references, we literally ate and left zero crumbs ✨

okay that's a wrap on the entire page, bestie 🎀 this one came straight out of ./include/net and it's dated October 2026 — yes, the future, she's ahead of her time 💅 the footer still spells the title as struct cfg80...scan_request(9) (truncated and iconic, no notes ✨). go read your structs, hydrate, and remember: sched scan never sleeps 😭 🦋👑

📦 where this page comes from