STRUCT CFG80211_PMSR_CAPABILITIES(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’– NAME πŸ’–

struct cfg80211_pmsr_capabilities β€” the cfg80211 peer measurement capabilities πŸ’… (yes that's the whole name, it's a mouthful, we know)


✨ SYNOPSIS ✨

okay so here's the whole struct, look at her, she's gorgeous:

struct cfg80211_pmsr_capabilities {
    unsigned int max_peers;
    u8 report_ap_tsf:1, randomize_mac_addr:1;
    struct {
      u32 preambles;
      u32 bandwidths;
      s8 max_bursts_exponent;
      u8 max_ftms_per_burst;
      u8 supported:1, asap:1, non_asap:1, request_lci:1,
         request_civicloc:1, trigger_based:1, non_trigger_based:1,
         support_6ghz:1;
      u8 max_tx_ltf_rep;
      u8 max_rx_ltf_rep;
      u8 max_tx_sts;
      u8 max_rx_sts;
      u8 max_total_ltf_tx;
      u8 max_total_ltf_rx;
      struct {
        u8 support_ntb:1, support_tb:1, support_edca:1;
        u32 max_peers;
      } ista;
      struct {
        u8 support_ntb:1, support_tb:1, support_edca:1;
        u32 max_peers;
      } rsta;
      u8 max_no_of_tx_antennas;
      u8 max_no_of_rx_antennas;
      u32 min_allowed_ranging_interval_edca;
      u32 min_allowed_ranging_interval_ntb;
      struct {
        u8 infra_support:1, pd_support:1;
      } type;
      u8 concurrent_ista_rsta_support:1;
      u32 pd_preambles;
      u32 pd_bandwidths;
    } ftm;
};

🧚 MEMBERS 🧚

bestie this is the part where we go field by field, stay with me πŸ’œ

  • max_peers β€” the maximum number of peers you can have in a single measurement. like a group chat with a member cap, no cap 🫢
  • report_ap_tsf β€” can it report the assoc AP's TSF for radio resource measurement? that's the vibe check on this one.
  • randomize_mac_addr β€” can randomize the MAC address for the measurement. yes ma'am, privacy queen πŸ‘‘
  • ftm β€” all the FTM measurement data lives in here, this is the main character of the struct ngl

🌸 the ftm era 🌸

  • ftm.preambles β€” bitmap of preambles supported (enum nl80211_preamble). it's giving bitmask energy ✨
  • ftm.bandwidths β€” bitmap of bandwidths supported (enum nl80211_chan_width)
  • ftm.max_bursts_exponent β€” maximum burst exponent supported, and it's a s8 for a reason: set to -1 if not limited. > ⚠️ heads up babes: setting this will necessarily forbid using the value 15 to let the responder pick. that's not me being dramatic, that's just what it says 😭
  • ftm.max_ftms_per_burst β€” maximum FTMs per burst supported (set to 0 if not limited). zero means go off, no ceiling πŸ¦‹
  • ftm.supported β€” FTM measurement is supported. that's it, that's the flag πŸ’…
  • ftm.asap β€” ASAP-mode is supported. do it now energy.
  • ftm.non_asap β€” non-ASAP-mode is supported. do it eventually energy.
  • ftm.request_lci β€” can request LCI data
  • ftm.request_civicloc β€” can request civic location data
  • ftm.trigger_based β€” trigger based ranging measurement is supported
  • ftm.non_trigger_based β€” non trigger based ranging measurement is supported
  • ftm.support_6ghz β€” supports ranging in the 6 GHz band. highkey iconic spectrum 🌈

⭐ the LTF/STS section (yes there are a lot of these) ⭐

  • ftm.max_tx_ltf_rep β€” maximum number of TX LTF repetitions supported (0 means only one LTF, no repetitions)
  • ftm.max_rx_ltf_rep β€” maximum number of RX LTF repetitions supported (0 means only one LTF, no repetitions)
  • ftm.max_tx_sts β€” maximum number of TX STS supported (zero based). zero based, don't forget, that detail matters fr fr
  • ftm.max_rx_sts β€” maximum number of RX STS supported (zero based)
  • ftm.max_total_ltf_tx β€” maximum total number of LTFs that can be transmitted (0 means unknown)
  • ftm.max_total_ltf_rx β€” maximum total number of LTFs that can be received (0 means unknown)

πŸŽ€ roles: ista & rsta πŸŽ€

  • ftm.ista β€” initiator role capabilities
  • ftm.ista.support_ntb β€” supports operating as ISTA in PMSR FTM request for NTB ranging.
  • ftm.ista.support_tb β€” supports operating as ISTA in PMSR FTM request for TB ranging.
  • ftm.ista.support_edca β€” supports operating as ISTA in PMSR FTM request for EDCA based ranging.
  • ftm.ista.max_peers β€” maximum number of peers supported in the ISTA role. If zero, no role-specific peer limit applies. (so 0 = unlimited-ish, cute)
  • ftm.rsta β€” responder role capabilities
  • ftm.rsta.support_ntb β€” supports operating as RSTA in PMSR FTM request for NTB ranging.
  • ftm.rsta.support_tb β€” supports operating as RSTA in PMSR FTM request for TB ranging.
  • ftm.rsta.support_edca β€” supports operating as RSTA in PMSR FTM request for EDCA based ranging.
  • ftm.rsta.max_peers β€” maximum number of peers supported in the RSTA role. If zero, no role-specific peer limit applies.

πŸ¦‹ antennas & intervals πŸ¦‹

  • ftm.max_no_of_tx_antennas β€” maximum number of transmit antennas supported for EDCA based ranging (0 means unknown)
  • ftm.max_no_of_rx_antennas β€” maximum number of receive antennas supported for EDCA based ranging (0 means unknown)
  • ftm.min_allowed_ranging_interval_edca β€” Minimum EDCA ranging interval supported by the device, in milli seconds (0 means unknown). Applications can use this value to estimate the burst period to be given in the FTM request for the EDCA based ranging case. If non-zero, this value will be used to validate the burst period in the FTM request. so like, it's not just decor, it does actual work πŸ’€
  • ftm.min_allowed_ranging_interval_ntb β€” Minimum NTB ranging interval supported by the device, in milli seconds (0 means unknown). Applications can use this value to estimate the burst period to be given in the FTM request for the NTB ranging case. If non-zero, this value will be used to validate the nominal time in the FTM request. (yes NTB validates the nominal time, EDCA validates the burst period β€” they're different, don't mix them up πŸ“)

🌈 the ftm.type moment 🌈

  • ftm.type β€” ranging type capabilities
  • ftm.type.infra_support β€” supports infrastructure ranging (STA-to-AP or AP-to-STA) as part of Proximity Detection
  • ftm.type.pd_support β€” supports peer-to-peer ranging as mentioned in the specification "PR Implementation Consideration Draft 1.9 rev 1" where PD stands for proximity detection. ok quote the spec exactly, we don't freelance πŸ“œ

πŸ’€ PD extras & the concurrent thing πŸ’€

  • ftm.concurrent_ista_rsta_support β€” indicates if the device can simultaneously act as initiator and responder in a multi-peer measurement request. > ⚠️ Only valid if ftm.rsta_support is set. (yes, read that again, that's exactly what it says β€” we do not editorialize πŸ’…)
  • ftm.pd_preambles β€” bitmap of preambles supported (enum nl80211_preamble) for PD ranging requests. Ignored if ftm.type.pd_support is not set.
  • ftm.pd_bandwidths β€” bitmap of bandwidths supported (enum nl80211_chan_width) for PD ranging requests. Ignored if ftm.type.pd_support is not set.

okay that's the struct unpacked, and there's still more coming so don't go anywhere πŸ’–

πŸ¦‹ SEE ALSO πŸ¦‹

okay bestie, deep breath β€” this is the part where the page stops explaining and just flexes. It's a whole constellation of cross-references, and yes, we're gonna get through all of them, because every single one is here for a reason. Buckle in, grab a snack πŸ“.

  • Kernel file ./include/net/cfg80211.h β€” that's the actual file this struct lives in. Home sweet home 🏠

🌸 The channel / rate / cap family (the OGs)

  • Introduction(9), Device registration(9), enum ieee80211_channel_flags(9), struct ieee80211_channel(9), enum ieee80211_rate_flags(9), enum ieee80211_bss_type(9), enum ieee80211_privacy(9), struct ieee80211_rate(9) β€” the absolute basics. Channels, rates, BSS types, privacy. Start here if you're new, no cap ✨
  • struct ieee80211_he_obss_pd(9), struct cfg80211_he_bss_color(9), struct ieee80211_sta_ht_cap(9), struct ieee80211_sta_vht_cap(9), struct ieee80211_sta_he_cap(9), struct ieee80211_eht_mcs_nss_supp(9), struct ieee80211_sta_eht_cap(9), struct ieee80211_sta_uhr_cap(9) β€” the capability glow-up timeline, HT β†’ VHT β†’ HE β†’ EHT β†’ UHR. It's giving generational excellence πŸ’…
  • struct ieee80211_sband_iftype_data(9), enum ieee80211_edmg_bw_config(9), struct ieee80211_edmg(9), struct ieee80211_sta_s1g_cap(9), struct ieee80211_supported_band(9) β€” per-band, per-iftype data plus the EDMG and S1G corner of the universe πŸ¦‹
  • _ieee80211_set_sband_iftype_data(9) β€” note the leading underscore, bestie, that's not a typo, copy it exactly πŸ™ˆ
  • ieee80211_set_sband_iftype_data(9), for_each_sband_iftype_data(9), ieee80211_get_sband_iftype_data(9), ieee80211_get_he_iftype_cap(9), ieee80211_get_he_6ghz_capa(9), ieee80211_get_eht_iftype_cap(9), ieee80211_get_uhr_iftype_cap(9) β€” setters, getters and the iterator. Iconic little helper squad 🫢
  • wiphy_read_of_freq_limits(9) β€” pulls freq limits out of device tree. πŸŽ€

πŸ”₯ Actions and configuration (aka the whole entire world)

  • Actions and configuration(9), struct vif_params(9), struct key_params(9), struct cfg80211_chan_def(9), struct cfg80211_tid_cfg(9), struct cfg80211_tid_config(9), struct cfg80211_fils_aad(9), struct cfg80211_set_hw_timestamp(9) β€” the entry point plus the parameter structs you'll bump into immediately. 🧚

the chandef cinematic universe

structs for days

  • enum survey_info_flags(9), struct survey_info(9), struct cfg80211_crypto_settings(9), struct cfg80211_mbssid_config(9), struct cfg80211_mbssid_elems(9), struct cfg80211_rnr_elems(9), struct cfg80211_beacon_data(9), struct cfg80211_acl_data(9), struct cfg80211_fils_discovery(9), struct cfg80211_unsol_bcast_probe_resp(9), struct cfg80211_s1g_short_beacon(9), struct cfg80211_ap_settings(9), struct cfg80211_ap_update(9), struct cfg80211_csa_settings(9), struct cfg80211_color_change_settings(9), struct iface_combination_params(9) β€” survey, crypto, multi-BSSID, RNR, beacon data, ACL, FILS discovery, unsolicited broadcast probe response, S1G short beacon, AP settings/update, CSA, color change, iface combos. That's a lot of structs and every single one is valid πŸ’–
  • enum station_parameters_apply_mask(9), struct sta_txpwr(9), struct link_station_parameters(9), struct link_station_del_parameters(9), struct cfg80211_ttlm_params(9), struct station_parameters(9), struct station_del_parameters(9), enum cfg80211_station_type(9), cfg80211_check_station_change(9) β€” add a station, delete a station, TTLM params, and the change-checker that keeps you honest 🫑
  • enum rate_info_flags(9), enum rate_info_bw(9), struct rate_info(9), enum bss_param_flags(9), struct sta_bss_parameters(9), struct cfg80211_txq_stats(9), struct cfg80211_tid_stats(9), struct link_station_info(9), struct station_info(9) β€” rates, BSS params, txq/TID stats, per-link and overall station info. Stats girlies rise 🌈
  • struct cfg80211_sar_sub_specs(9), struct cfg80211_sar_specs(9), struct cfg80211_sar_freq_ranges(9), struct cfg80211_sar_capa(9), cfg80211_get_station(9), enum monitor_flags(9), enum mpath_info_flags(9), struct mpath_info(9), enum wiphy_bss_param_flags(9), struct bss_parameters(9), struct mesh_config(9), struct mesh_setup(9), struct ocb_setup(9), struct ieee80211_txq_params(9) β€” SAR specs, station lookup, monitor flags, mesh path info, BSS params, mesh config/setup, OCB setup, txq params. Mesh girlies, this one's for you πŸ§šβ€β™€οΈ

⭐ Scanning and BSS list handling

  • Scanning and BSS list handling(9), 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), struct cfg80211_sched_scan_request(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) β€” scanning, scheduled scanning, 6GHz params, BSS selection tweaks, signal types, IEs and BSS lookups. The scan arc is SO iconic ✨

connections & powersave

  • 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) β€” auth, assoc, ML reconf, deauth, disassoc, IBSS, BSS selection, connect params, PMKSA. The whole relationship lifecycle, honestly πŸ’€
  • 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) β€” wowlan (packet patterns, TCP keepalive, net-detect), coalesce rules, GTK rekey, FT IEs, mgmt TX params, DSCP exceptions/ranges and the QoS map. Sleep-mode excellence 😴

πŸŽ€ Neighbor Awareness Networking (NAN) β€” and honestly so much more

  • Neighbor Awareness Networking (NAN)(9), 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) β€” NAN config, channels, local/peer schedules, peer maps, filters, functions. NAN stans assemble πŸ¦‹
  • 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) β€” PMK conf, external auth, FTM responder stats, and look β€” the whole cfg80211_pmsr_* result/request family that this very page is about. Full circle moment πŸ”₯

wiphy-adjacent everything


🌈 Utility functions


πŸ’œ Data path helpers


πŸ’– Regulatory enforcement infrastructure

vendor commands & test mode

connection events & notifications

…and here's the rest of the extended family, bestie β€” every single one of them, no skips, no "etc." cop-outs πŸ’–


And that's a wrap on the whole page, bestie 🫢 You made it to the end β€” go read something fun now, like cfg80211_pmsr_report(9), she'd love the attention.

tiny housekeeping so nobody comes for me: this page lives in ./include/net, it's dated October 2026, and the page itself is struct cfg8...capabilities(9) β€” yes, the title is literally truncated in the header, iconic, no notes πŸ’€βœ¨

bye bestie, go forth and configure your kernel 🌈

πŸ“¦ where this page comes from