STRUCT CFG80211_NAN_BAND_CONFIG(9)

👑 struct cfg80211_nan_band_config — from the `cfg80211_nan_band_config(9)` page in the Kernel API Manual 💅

Okay bestie, sit down, hydrate, and let me tell you about struct cfg80211_nan_band_config ✨ — it's literally the NAN band specific configuration, one of those little structs that's doing a LOT of heavy lifting behind the scenes. Fr fr.

It's giving "quiet main character energy": small struct, but every field matters, and if you get one wrong the whole vibe check fails 😭

✨ SYNOPSIS ✨

struct cfg80211_nan_band_config {
    struct ieee80211_channel *chan;
    s8 rssi_close;
    s8 rssi_middle;
    u8 awake_dw_interval;
    bool disable_scan;
 };

That's the whole squad right there 🫶 — five fields, zero drama (okay, some drama, see the thresholds below).

💖 Members 💖

chan — a pointer to the struct ieee80211_channel structure, aka the channel you're gonna use for NAN operations on this band 🦋. Real talk on the values:
- For the 2.4 GHz band, this is always channel 6 — no negotiating, no "but what about", it's 6. Periodt.
- For the 5 GHz band, the channel is either 44 or 149, depending on the regulatory constraints you're living under 🌍.
- And here's the important bit ⚠️: if chan is NULL, the entire band configuration entry is considered invalid and should not be used. Like, do not pass go, do not collect, do not use it. 💀
rssi_close — the RSSI close threshold, used by the NAN state transition algorithm, exactly as described in chapters 3.3.6 and 3.3.7 "NAN Device Role and State Transition" of the Wi-Fi Aware Specification v4.0 📖. If it's not specified (i.e. set to 0), the default device value is used. The value should be greater than -60 dBm — ngl, keep an eye on that.
rssi_middle — the RSSI middle threshold, also for the NAN state transition algorithm, as described in chapters 3.3.6 and 3.3.7 "NAN Device Role and State Transition" of the Wi-Fi Aware Specification v4.0 🎀. Not specified (set to 0)? Default device value, same deal as above. The value should be greater than -75 dBm and less than rssi_close — so it's gotta be sandwiched in there, no exceptions 🥪.
awake_dw_interval — the Committed DW interval 🌸. Valid values range: 0-5. Now this one has lore:
- 0 indicates no wakeup for DW and can't be used on 2.4GHz band 🚫 — not allowed, don't try it.
- Otherwise it's 2^(n-1) ✨ — do the math, bestie, the numbers are right there.
disable_scan — if true, the device will not scan this band for cluster merge 🦋. And heads up 🙈: disabling scan on 2.4 GHz band is not allowed. That's a hard no, not a soft no.

Ngl, these caveats are the kind of thing that'll ruin your whole afternoon if you ignore them — read the thresholds, respect the NULL check, and don't disable that scan on 2.4 GHz 💀

So yeah — that's the struct and all five of its members 🔥 it's honestly iconic how much meaning is packed into so few fields.

so buckle up buttercup, because this is the part where the manpage dumps the entire extended friend group 💅 and ngl it's a lot of names. Every single one of these is a real doc page you can pull up, and every single one is on the list for a reason. No skipping, no scrolling past — we're reading the whole roster ~~(jk… unless 👀)~~.

heads up before we go: those (9) bits at the end are part of the name. keep them attached, don't rename anything, don't "fix" the underscores. fr fr.

the very first one is the source file itself, obviously:

./include/net/cfg80211.h

🌸 the intro + all the band, channel, and capability lore 🌸

okay so this group is giving "foundations". start with Introduction(9) and Device registration(9), then it's channels, rates, and every single cap struct in the alphabet:

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), 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), 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), _ieee80211_set_sband_iftype_data(9), 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), wiphy_read_of_freq_limits(9).

✨ actions and configuration — the chandef girlies ✨

this whole block is highkey the chandef cinematic universe, plus the vif/key params that start it off:

🎀 beacons, AP settings, stations, and the rest of config 🎀

survey stuff, crypto settings, mbssid, beacon data, AP settings/update, CSA, color change, iface combinations, then a whole station block (params, del params, link params, txpwr, TTLM, station type, check_station_change, rate info, bss params, txq/tid stats, link station info, station info), then SAR, then mesh/OCB/txq params. breathe. it's fine. we're fine:

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), 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), 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), 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).

🦋 scanning and BSS list handling 🦋

scan requests, sched scan plans, BSS structs, auth/assoc/deauth/disassoc, connect params, wowlan + coalesce, and it ends on the QoS map. this block ate, honestly:

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), 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) — yes, the main character section 💜

this is our section bestie, the one this whole page belongs to, so obviously it's here in full:

Neighbor Awareness Networking (NAN)(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).

🫶 pmk, external auth, FTM, PMSR, and the wiphy structs 🫶

this stretch runs from pmk_conf all the way to struct wiphy itself — including struct cfg80211_ops, the flags enums, iface limits/combinations, wowlan + coalesce support, vendor command stuff, iftype ext capab, radio structs, and the NAN wiphy flags/capa. lowkey iconic lineup:

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), struct cfg80211_ops(9), enum wiphy_flags(9), struct ieee80211_iface_limit(9), struct ieee80211_iface_combination(9), enum wiphy_wowlan_support_flags(9), struct wiphy_wowlan_support(9), struct wiphy_coalesce_support(9), enum wiphy_vendor_command_flags(9), enum wiphy_opmode_flag(9), struct sta_opmode_info(9), struct wiphy_vendor_command(9), struct wiphy_iftype_ext_capab(9), cfg80211_get_iftype_ext_capa(9), struct cfg80211_pmsr_capabilities(9), struct wiphy_iftype_akm_suites(9), struct wiphy_radio_cfg(9), struct wiphy_radio_freq_range(9), struct wiphy_radio(9), enum wiphy_nan_flags(9), struct wiphy_nan_capa(9), struct wiphy(9).

🌈 wiphy lifecycle + the work/timer helpers + wireless_dev 🌈

priv/register/unregister/free, the lock + unlock, all the wiphy_work_*, wiphy_delayed_work_* and wiphy_hrtimer_work_* variants, ap reg power, then wireless_dev and its helpers:

wiphy_priv(9), priv_to_wiphy(9), set_wiphy_dev(9), wiphy_dev(9), wiphy_name(9), wiphy_new_nm(9), wiphy_new(9), wiphy_register(9), rcu_dereference_wiphy(9), wiphy_dereference(9), get_wiphy_regdom(9), wiphy_unregister(9), wiphy_free(9), wiphy_lock(9), wiphy_unlock(9), wiphy_work_queue(9), wiphy_work_cancel(9), wiphy_work_flush(9), wiphy_delayed_work_queue(9), wiphy_delayed_work_cancel(9), wiphy_delayed_work_flush(9), wiphy_delayed_work_pending(9), wiphy_hrtimer_work_queue(9), wiphy_hrtimer_work_cancel(9), wiphy_hrtimer_work_flush(9), wiphy_hrtimer_work_pending(9), enum ieee80211_ap_reg_power(9), struct wireless_dev(9), wdev_priv(9), wdev_chandef(9).

⭐ utility functions ⭐

channel↔frequency conversions, rate lookups, radiotap iterator, and the hdrlen crew:

Utility functions(9), ieee80211_channel_equal(9), ieee80211_channel_to_khz(9), ieee80211_channel_to_freq_khz(9), ieee80211_channel_to_frequency(9), ieee80211_freq_khz_to_channel(9), ieee80211_frequency_to_channel(9), ieee80211_get_channel_khz(9), ieee80211_get_channel(9), cfg80211_channel_is_psc(9), ieee80211_radio_freq_range_valid(9), cfg80211_radio_chandef_valid(9), cfg80211_wdev_channel_allowed(9), ieee80211_get_response_rate(9), ieee80211_mandatory_rates(9), struct ieee80211_radiotap_iterator(9), ieee80211_get_hdrlen_from_skb(9), ieee80211_hdrlen(9), ieee80211_get_mesh_hdrlen(9).

🧚 data path helpers 🧚

8023 conversion, amsdu checks, element finding (regular / ext / vendor), RNR iteration, defragmenting, layer2 update:

Data path helpers(9), ieee80211_data_to_8023_exthdr(9), ieee80211_data_to_8023(9), ieee80211_is_valid_amsdu(9), ieee80211_amsdu_to_8023s(9), ieee80211_get_8023_tunnel_proto(9), ieee80211_strip_8023_mesh_hdr(9), cfg80211_classify8021d(9), cfg80211_find_elem_match(9), cfg80211_find_ie_match(9), cfg80211_find_elem(9), cfg80211_find_ie(9), cfg80211_find_ext_elem(9), cfg80211_find_ext_ie(9), cfg80211_find_vendor_elem(9), cfg80211_find_vendor_ie(9), enum cfg80211_rnr_iter_ret(9), cfg80211_iter_rnr(9), cfg80211_defragment_element(9), cfg80211_send_layer2_update(9).

🔥 regulatory enforcement infrastructure 🔥

and the internal regdb functions right after it:

Regulatory enforcement infrastructure(9), regulatory_hint(9), regulatory_set_wiphy_regd(9), regulatory_set_wiphy_regd_sync(9), wiphy_apply_custom_regulatory(9), freq_reg_info(9), reg_initiator_name(9), regulatory_pre_cac_allowed(9), Internal regulatory db functions(9), reg_query_regdb_wmm(9).

🍓 scan done + BSS/mgmt notifications 🍓

the big notify block — scan done, sched scan results/stopped, informing BSS, get/ref/put/unlink BSS, mlme mgmt rx/tx, assoc resp, michael mic failure, ibss joined, new peer candidate:

cfg80211_scan_done(9), cfg80211_sched_scan_results(9), cfg80211_sched_scan_stopped(9), cfg80211_sched_scan_stopped_locked(9), cfg80211_inform_bss_frame_data(9), cfg80211_gen_new_bssid(9), cfg80211_is_element_inherited(9), cfg80211_merge_profile(9), enum cfg80211_bss_frame_type(9), cfg80211_get_ies_channel_number(9), cfg80211_ssid_eq(9), cfg80211_inform_bss_data(9), __cfg80211_get_bss(9), cfg80211_get_bss(9), cfg80211_ref_bss(9), cfg80211_put_bss(9), cfg80211_unlink_bss(9), cfg80211_bss_iter(9), cfg80211_rx_mlme_mgmt(9), cfg80211_auth_timeout(9), struct cfg80211_rx_assoc_resp_data(9), cfg80211_rx_assoc_resp(9), struct cfg80211_assoc_failure(9), cfg80211_assoc_failure(9), cfg80211_tx_mlme_mgmt(9), cfg80211_rx_unprot_mlme_mgmt(9), cfg80211_michael_mic_failure(9), cfg80211_ibss_joined(9), cfg80211_notify_new_peer_candidate(9).

👑 the last stretch: connect, roam, mgmt rx/tx, CQM, CAC, and friends 👑

this is the final boss block and it goes hard — connect resp params, connect done/bss/result/timeout, roam info + roamed, port authorized, disconnected, ready on channel, remain on channel expired, tx mgmt expired, the sinfo tid helpers, new_sta/del_sta, conn failed, rx info, mgmt rx/tx status, control port, CQM notifs, radar/CAC events, gtk rekey, pmksa candidate, spurious frame, unexpected 4addr frame, probe status, obss beacon reports, and one last beaconing check config:

struct cfg80211_fils_resp_params(9), struct cfg80211_connect_resp_params(9), cfg80211_connect_done(9), cfg80211_connect_bss(9), cfg80211_connect_result(9), cfg80211_connect_timeout(9), struct cfg80211_roam_info(9), cfg80211_roamed(9), cfg80211_port_authorized(9), cfg80211_disconnected(9), cfg80211_ready_on_channel(9), cfg80211_remain_on_channel_expired(9), cfg80211_tx_mgmt_expired(9), cfg80211_sinfo_alloc_tid_stats(9), cfg80211_link_sinfo_alloc_tid_stats(9), cfg80211_sinfo_release_content(9), cfg80211_new_sta(9), cfg80211_del_sta_sinfo(9), cfg80211_del_sta(9), cfg80211_conn_failed(9), struct cfg80211_rx_info(9), cfg80211_rx_mgmt_ext(9), cfg80211_rx_mgmt_khz(9), cfg80211_rx_mgmt(9), struct cfg80211_tx_status(9), cfg80211_mgmt_tx_status_ext(9), cfg80211_mgmt_tx_status(9), cfg80211_control_port_tx_status(9), cfg80211_rx_control_port(9), cfg80211_cqm_rssi_notify(9), cfg80211_cqm_pktloss_notify(9), cfg80211_cqm_txe_notify(9), cfg80211_cqm_beacon_loss_notify(9), __cfg80211_radar_event(9), cfg80211_sta_opmode_change_notify(9), cfg80211_cac_event(9), cfg80211_background_cac_abort(9), cfg80211_gtk_rekey_notify(9), cfg80211_pmksa_candidate_notify(9), cfg80211_rx_spurious_frame(9), cfg80211_rx_unexpected_4addr_frame(9), cfg80211_probe_status(9), cfg80211_report_obss_beacon_khz(9), cfg80211_report_obss_beacon(9), struct cfg80211_beaconing_check_config(9).

and that's the entire roster, bestie — you survived 💀🎀 no cap, that was the long one. but don't close the tab yet, because there's still more of this page coming 👀

okay so the SEE ALSO list literally does not stop, bestie — here's the rest of it, every single one, in order, nothing skipped. Tuck in 💅

cfg80211_reg_check_beaconing(9) — beaconing checks, come get y'all
cfg80211_reg_can_beacon(9) — the "can u even beacon tho" one
cfg80211_reg_can_beacon_relax(9) — same question but chiller
cfg80211_ch_switch_notify(9) — channel switch announcements ✨
cfg80211_ch_switch_started_notify(9) — and the "we started" version
ieee80211_operating_class_to_band(9) — conversion girlie
ieee80211_operating_class_to_chandef(9) — another conversion girlie
ieee80211_chandef_to_operating_class(9) — the reverse, we love symmetry
ieee80211_chandef_to_khz(9) — numbers in, kHz out 🔥
cfg80211_tdls_oper_request(9) — TDLS shenanigans
cfg80211_calculate_bitrate(9) — math era 🧮
cfg80211_unregister_wdev(9) — the opposite of registering, obviously
cfg80211_register_netdevice(9) — registering era
cfg80211_unregister_netdevice(9) — un-registering era, matching set 💖
struct cfg80211_ft_event_params(9) — a whole struct, go read it
cfg80211_ft_event(9) — the event that goes with it
cfg80211_get_p2p_attr(9) — P2P attribute grabber
ieee80211_ie_split_ric(9) — RIC edition
ieee80211_ie_split(9) — the plain edition
ieee80211_fragment_element(9) — chopping an element into bits
cfg80211_report_wowlan_wakeup(9) — wakeup reporting, main character energy 👑
cfg80211_crit_proto_stopped(9) — critical protocol said bye
ieee80211_get_num_supported_channels(9) — count 'em
cfg80211_check_combinations(9) — combo checking, very thorough of them
cfg80211_iter_combinations(9) — same vibe, but it iterates
cfg80211_get_radio_idx_by_chan(9) — channel → radio index, slay
cfg80211_stop_link(9) — stop that link
cfg80211_stop_iface(9) — stop that iface
cfg80211_shutdown_all_interfaces(9) — stop everything, dramatic 💀
wiphy_ext_feature_set(9) — set the extended feature
wiphy_ext_feature_isset(9) — and then ask if it's set, iconic duo 🫶
cfg80211_free_nan_func(9) — free the NAN function, no leaks bestie
struct cfg80211_nan_match_params(9) — NAN match struct
cfg80211_nan_match(9) — NAN match event
cfg80211_nan_func_terminated(9) — NAN function said goodbye 😭
cfg80211_nan_sched_update_done(9) — sched update finished, we're so back
cfg80211_external_auth_request(9) — external auth, very "it's giving offload"
cfg80211_pmsr_report(9) — PMSR report
cfg80211_pmsr_complete(9) — PMSR complete, matching set ✨
cfg80211_iftype_allowed(9) — is this iftype allowed or not
cfg80211_assoc_comeback(9) — assoc comeback era, we're so back 🦋
cfg80211_update_owe_info_event(9) — OWE info update event
cfg80211_bss_flush(9) — flush those BSS entries
cfg80211_bss_color_notify(9) — BSS color notifications, colorful 💜
cfg80211_obss_color_collision_notify(9) — collision, oh no, dramatic
cfg80211_color_change_started_notify(9) — color change STARTED
cfg80211_color_change_aborted_notify(9) — color change ABORTED 💀
cfg80211_color_change_notify(9) — color change, the neutral one
cfg80211_6ghz_power_type(9) — 6 GHz power type, fancy
cfg80211_links_removed(9) — links said bye
struct cfg80211_mlo_reconf_done_data(9) — MLO reconf data struct
cfg80211_mlo_reconf_add_done(9) — MLO reconf add, done ✅
cfg80211_schedule_channels_check(9) — schedule that channel check
cfg80211_epcs_changed(9) — EPCS changed, noted
cfg80211_next_nan_dw_notif(9) — next NAN DW notif
cfg80211_nan_cluster_joined(9) — joined the NAN cluster, we're in the group chat now 🎀
cfg80211_nan_ulw_update(9) — ULW update, okurr
cfg80211_nan_channel_evac(9) — channel evacuation, everyone out 🏃‍♀️
wiphy_locked_debugfs_read(9) — locked debugfs, reading edition
wiphy_locked_debugfs_write(9) — locked debugfs, writing edition
cfg80211_s1g_get_start_freq_khz(9) — S1G start freq in kHz
cfg80211_s1g_get_end_freq_khz(9) — S1G end freq in kHz, bookend besties 🌸
cfg80211_s1g_get_primary_sibling(9) — primary sibling, family vibes
cfg80211_incumbent_signal_notify(9) — incumbent signal notification, last one, we made it 😭

and that's the whole reading list, bestie, no cap 🫶

📌 this page lives in ./include/net, stamped October 2026 — that's the source and the date, now u know. go touch some grass (or a wireless driver), ily, bye 💜✨

📦 where this page comes from

nixpkgs unstable: linux-manual 7.3.1
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms