cfg80211_ch_switch_notify(9)

📦 version 7.3.1, in nixpkgs unstable

👑 cfg80211_ch_switch_notify — kernel API manual energy ✨

okay so bestie, gather round, because we're diving into cfg80211_ch_switch_notify(9) from the Kernel API Manual and honestly? it's giving "tiny function, big responsibilities" 💅

🌸 NAME 🌸

cfg80211_ch_switch_notify — update wdev channel and notify userspace 🦋

like, that's the whole gig. you switch a channel, you tell the wdev about it, and you let userspace know what's up. no cap. ✨

💖 SYNOPSIS 💖

void cfg80211_ch_switch_notify (struct net_device *dev , struct
       cfg80211_chan_def *chandef , unsigned int link_id );

she takes three args and returns void, periodt. 🎀

🎀 ARGUMENTS 🎀

  • dev — the device which switched channels 📡 literally the network device that did the channel-switching thing. main character energy fr fr.
  • chandef — the new channel definition 🌈 the whole definition of the channel you just switched to. slay.
  • link_id — the link ID for MLO, must be 0 for non-MLO 🫶 yes bestie, this one's important: it's the link ID when you're doing MLO, and it must be 0 if you're not. no exceptions, iykyk.

🔥 DESCRIPTION 🔥

okay so here's the vibe check that actually matters 👀 the caller must hold wiphy mutex, which means this must only be called from sleepable driver context! 😭 like, do not come in here from atomic context, she will not survive it. highkey a big deal. 💀

⚠️ bestie pls remember: wiphy mutex held, sleepable driver context only. this is not a drill 🙈

more parts coming, don't go anywhere 💜

✨ SEE ALSO ✨

Okay bestie, buckle up — this is the iconic link-dump, the main-character reading list of the whole cfg80211 cinematic universe 💅. Every single one is here, no skips, no cap. Think of it as the group chat where every member is a struct or a function that lowkey runs your Wi-Fi. Go touch grass after this one 🫶.

🎀 the very start of it all 🎀

  • Kernel file ./include/net/cfg80211.h Introduction(9)
  • Device registration(9)

💖 channels, rates, bss types, privacy — the basics baes 💖

  • 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)

🌸 he / ht / vht / eht / uhr era — the glow-up era 🌸

  • 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)

🦋 the sband iftype fam — literally so helpful 🦋

👑 Actions and configuration(9) — the whole vibe section, periodt 👑

  • 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)

💅 chandef this, chandef that — she ate 💅

🎀 survey + crypto + beacon-ish things 🎀

  • 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)

💀 stations, tids, rates, sar — ngl this is a lot 💀

  • 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)

🌈 monitor + mpath + mesh + ocb + txq 🌈

  • 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(9) — the scanner arc 🦋

  • 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)

🔥 auth / assoc / connect / woflan — the connection chronicles 🔥

  • 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) — nan, but make it networking 🧚

  • 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)

💜 pmk / auth / pmsr / owe / mgmt regs / ops 💜

  • 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)

👑 the wiphy era — main character struct energy 👑

🌸 Utility functions(9) — the helpful besties 🌸

🍓 Data path helpers(9) — where the packets actually flow 🍓

💀 Regulatory enforcement infrastructure(9) — the rules arc 💀

🙈 Internal regulatory db functions(9) — the backstage reg db 🙈

🎀 scan done + bss inform + get_bss + ref/put — the bss lifecycle 🎀

🦋 RFkill integration(9) — bestie said turn it off and on again 🦋

🔥 Vendor commands(9) + Test mode(9) — the exclusive collab drop 🔥

💜 connect / roam / disconnect / remain-on-channel — the connection lore continues 💜

🧚 station info + new/del sta + rx/tx mgmt — station storytime 🧚

🎀 cqm + radar + cac + notify stuff — the notification queens 🎀

And that's the whole link-dump, every last one accounted for, no crumbs left behind 😭💖. More coming in the next part, so don't go anywhere bestie 🫶.

okay bestie that's genuinely the whole squad, all 63 of them, nothing skipped 💖 and that's the entire page!! if you made it this far you deserve a little treat 🍓

tiny sign-off because every manpage has to bow out somewhere: this one lives in ./include/net, it's dated October 2026, and it's filed under cfg80211_ch_switch_notify(9) in section 9 of the manual. periodt. now go notify somebody about a channel switch ✨💅

📦 where this page comes from