cfg80211_assoc_failure(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

🌸 NAME 🌸

Okay so this is cfg80211_assoc_failure β€” it's from the Kernel API Manual (that's the manual this page lives in, bestie, folding it in up top like a good host) β€” and the whole vibe of this function is: notification of association failure. That's it. That's the job. It tells the world that an association attempt didn't work out 😭


✨ SYNOPSIS ✨

Here's the signature, and I'm giving it to you exactly as it is, no edits, no vibes-based rewriting of the code:

void cfg80211_assoc_failure (struct net_device *dev , struct
cfg80211_assoc_failure *data );

Notice the line break in there? Yeah. That's how it is. We respect it. 🫢


πŸ’… ARGUMENTS πŸ’…

Two arguments, both certified load-bearing:

  • dev β€” the network device. Like, the actual net device we're talking about here πŸ’–
  • data β€” the data describing the association failure. Yes, the struct is literally named after the function, that's just how it goes. It's the receipts for why the association flopped 🧾

πŸ¦‹ DESCRIPTION πŸ¦‹

Okay so this is the part where you need to lock in, because there are two facts here and both of them will get you if you skip them:

This function may sleep. Not "might", not "under some conditions" β€” it may sleep. Plan accordingly. πŸ˜΄πŸ’€

And the second one:

The caller must hold the corresponding wdev's mutex. Not a mutex. Not some mutex nearby. The corresponding wdev's mutex. So if you're about to call this and you're not holding it, put your hands down, you are not ready πŸ™ˆ

Lowkey that's the whole page β€” the function announces that an association failed, it can sleep, and you gotta be holding that wdev mutex when you call it. Simple. Iconic. Very "small function, big consequences" energy πŸ‘‘


and yes bestie, there's more where that came from β€” hang tight πŸ’œ

🌈 SEE ALSO 🌈

okay bestie, buckle up, because this is the part where the manpage stops being a manpage and starts being a whole extended universe. it's giving "linked list of destiny", it's giving "the kernel said 'here, have ✨everything✨'". every single cross-reference is down below, nothing skipped, nothing merged, because the kernel does not do abridged versions. πŸ’…

  • Kernel file ./include/net/cfg80211.h β€” the mothership, the source of truth, the main character's actual house
  • Introduction(9), Device registration(9) β€” start here if you're brand new, no gatekeeping 🫢

πŸ¦‹ the "what even is a radio" cluster

your whole physical-layer lore drop, all in one place:

  • enum ieee80211_channel_flags(9), struct ieee80211_channel(9) β€” channels, flags, the whole vibe check
  • enum ieee80211_rate_flags(9), struct ieee80211_rate(9) β€” rates, and the flags that come with them
  • enum ieee80211_bss_type(9), enum ieee80211_privacy(9) β€” what kind of BSS it is, and whether it's locked down
  • struct ieee80211_he_obss_pd(9), struct cfg80211_he_bss_color(9) β€” HE obss pd and bss color, iconic duo honestly
  • struct ieee80211_sta_ht_cap(9), struct ieee80211_sta_vht_cap(9) β€” HT and VHT caps, the classics
  • struct ieee80211_sta_he_cap(9), struct ieee80211_eht_mcs_nss_supp(9), struct ieee80211_sta_eht_cap(9) β€” HE and EHT, we're going deeper 🌸
  • struct ieee80211_sta_uhr_cap(9) β€” UHR cap, yes she went there

πŸŽ€ bands, EDMG, S1G & the iftype data girlies

this is the part where it gets specific. obsessed.


✨ ACTIONS AND CONFIGURATION β€” the big one

bestie this section is huge, I'm not gonna lie to you. but I promised no skipping, so here we go, one bullet at a time. πŸ’–
  • Actions and configuration(9) β€” the section itself, the group chat admin
  • struct vif_params(9), struct key_params(9) β€” vif params and key params, straightforward slay
  • struct cfg80211_chan_def(9) β€” the channel definition, the blueprint
  • struct cfg80211_tid_cfg(9), struct cfg80211_tid_config(9) β€” tid cfg and tid config, yes they're two different things, don't @ me
  • struct cfg80211_fils_aad(9), struct cfg80211_set_hw_timestamp(9) β€” FILS AAD and hw timestamp setting
  • cfg80211_get_chandef_type(9), cfg80211_chandef_create(9), cfg80211_chandef_identical(9) β€” get the type, create one, check if two are identical
  • cfg80211_chandef_is_edmg(9), cfg80211_chandef_is_s1g(9) β€” the "is it though?" twins
  • cfg80211_chandef_compatible(9), nl80211_chan_width_to_mhz(9), cfg80211_chandef_get_width(9) β€” compatibility, width in MHz, and getting the width
  • cfg80211_chandef_valid(9), cfg80211_chandef_usable(9) β€” valid vs usable, both matter, don't confuse them πŸ™ˆ
  • cfg80211_chandef_dfs_required(9), cfg80211_chandef_dfs_usable(9), cfg80211_chandef_dfs_cac_time(9) β€” the entire DFS trio: required, usable, and the CAC time
  • cfg80211_chandef_primary(9), cfg80211_chandef_npca_valid(9), cfg80211_chandef_add_npca(9), cfg80211_chandef_add_dbe(9) β€” primary channel, NPCA validity, adding NPCA, adding DBE
  • nl80211_send_chandef(9), ieee80211_chandef_max_power(9), cfg80211_chandef_s1g_pri_width(9) β€” send it, max power, S1G primary width
  • cfg80211_any_usable_channels(9) β€” "is any channel usable?" the eternal question
  • enum survey_info_flags(9), struct survey_info(9) β€” survey flags and survey info
  • struct cfg80211_crypto_settings(9) β€” crypto settings, the whole security vibe
  • struct cfg80211_mbssid_config(9), struct cfg80211_mbssid_elems(9), struct cfg80211_rnr_elems(9) β€” MBSSID config, MBSSID elems, and RNR elems
  • struct cfg80211_beacon_data(9), struct cfg80211_acl_data(9) β€” beacon data and ACL data
  • struct cfg80211_fils_discovery(9), struct cfg80211_unsol_bcast_probe_resp(9) β€” FILS discovery and the unsolicited broadcast probe response (yes that's the whole name, she's long but she's valid)
  • struct cfg80211_s1g_short_beacon(9) β€” the S1G short beacon 🐝
  • struct cfg80211_ap_settings(9), struct cfg80211_ap_update(9) β€” AP settings and AP update, setting up vs updating
  • struct cfg80211_csa_settings(9), struct cfg80211_color_change_settings(9) β€” channel switch announcement settings, and color change settings
  • struct iface_combination_params(9) β€” interface combination params, the "how many at once" math
  • enum station_parameters_apply_mask(9), struct sta_txpwr(9) β€” the apply mask enum and sta txpwr
  • struct link_station_parameters(9), struct link_station_del_parameters(9), struct cfg80211_ttlm_params(9) β€” link station add params, link station del params, and TTLM params
  • struct station_parameters(9), struct station_del_parameters(9), enum cfg80211_station_type(9) β€” station params, station del params, station type enum
  • cfg80211_check_station_change(9) β€” literally checks a station change, she does what her name says πŸ’…
  • enum rate_info_flags(9), enum rate_info_bw(9), struct rate_info(9) β€” rate info flags, rate info bandwidth, rate info struct β€” a whole trio
  • enum bss_param_flags(9), struct sta_bss_parameters(9) β€” BSS param flags and sta BSS parameters
  • struct cfg80211_txq_stats(9), struct cfg80211_tid_stats(9) β€” txq stats and tid stats
  • struct link_station_info(9), struct station_info(9) β€” link station info and the classic station info
  • struct cfg80211_sar_sub_specs(9), struct cfg80211_sar_specs(9), struct cfg80211_sar_freq_ranges(9), struct cfg80211_sar_capa(9) β€” the entire SAR family: sub specs, specs, freq ranges, and capa 🌈
  • cfg80211_get_station(9) β€” get the station, 10/10 descriptive
  • enum monitor_flags(9), enum mpath_info_flags(9), struct mpath_info(9) β€” monitor flags, mpath info flags, mpath info
  • enum wiphy_bss_param_flags(9), struct bss_parameters(9) β€” wiphy BSS param flags and BSS parameters
  • struct mesh_config(9), struct mesh_setup(9) β€” mesh config and mesh setup, the mesh girlies
  • struct ocb_setup(9) β€” OCB setup, riding that wave πŸ¦‹
  • struct ieee80211_txq_params(9) β€” txq params, last but never least

🌸 SCANNING AND BSS LIST HANDLING

the "who's out there" chapter, and honestly it ate:

  • Scanning and BSS list handling(9) β€” the section header herself
  • struct cfg80211_ssid(9), struct cfg80211_scan_info(9) β€” SSID and scan info
  • struct cfg80211_scan_6ghz_params(9), struct cfg80211_scan_request(9) β€” the 6GHz scan params and the scan request
  • struct cfg80211_match_set(9), struct cfg80211_sched_scan_plan(9) β€” match set and scheduled scan plan
  • struct cfg80211_bss_select_adjust(9), struct cfg80211_sched_scan_request(9) β€” BSS select adjust and sched scan request
  • enum cfg80211_signal_type(9), struct cfg80211_inform_bss(9) β€” signal type enum and inform BSS
  • struct cfg80211_bss_ies(9), struct cfg80211_bss(9) β€” BSS IEs and the BSS itself, icons only
  • ieee80211_bss_get_elem(9), ieee80211_bss_get_ie(9) β€” get elem, get ie, two flavors, both valid
  • struct cfg80211_auth_request(9) β€” auth request, where the handshake begins
  • struct cfg80211_assoc_link(9), struct cfg80211_ml_reconf_req(9), enum cfg80211_assoc_req_flags(9), struct cfg80211_assoc_request(9) β€” assoc link, ML reconf req, assoc req flags, assoc request β€” the whole assoc friend group 🫢
  • struct cfg80211_deauth_request(9), struct cfg80211_disassoc_request(9) β€” deauth and disassoc requests, the sad endings
  • struct cfg80211_ibss_params(9), struct cfg80211_bss_selection(9), struct cfg80211_connect_params(9) β€” IBSS params, BSS selection, connect params
  • enum cfg80211_connect_params_changed(9), enum wiphy_params_flags(9) β€” connect params changed, and wiphy params flags
  • struct cfg80211_pmksa(9), struct cfg80211_pkt_pattern(9) β€” PMKSA and packet pattern
  • struct cfg80211_wowlan_tcp(9), struct cfg80211_wowlan(9) β€” wowlan TCP and wowlan
  • struct cfg80211_coalesce_rules(9), struct cfg80211_coalesce(9) β€” coalesce rules and coalesce
  • struct cfg80211_wowlan_nd_match(9), struct cfg80211_wowlan_nd_info(9), struct cfg80211_wowlan_wakeup(9) β€” wowlan nd match, nd info, and wakeup
  • struct cfg80211_gtk_rekey_data(9), struct cfg80211_update_ft_ies_params(9) β€” GTK rekey data and update FT IEs params
  • struct cfg80211_mgmt_tx_params(9) β€” management tx params
  • struct cfg80211_dscp_exception(9), struct cfg80211_dscp_range(9), struct cfg80211_qos_map(9) β€” DSCP exception, DSCP range, and the QoS map

πŸ’œ NAN, PMK, PMSR, and the wiphy extended universe

this is the deepest lore in the whole page and I need you to stay with me, bestie 😭
  • Neighbor Awareness Networking (NAN)(9) β€” NAN, the section
  • struct cfg80211_nan_band_config(9), struct cfg80211_nan_conf(9), struct cfg80211_nan_channel(9) β€” NAN band config, nan conf, nan channel
  • struct cfg80211_nan_local_sched(9), struct cfg80211_nan_peer_map(9), struct cfg80211_nan_peer_sched(9) β€” local sched, peer map, peer sched
  • enum cfg80211_nan_conf_changes(9), struct cfg80211_nan_func_filter(9), struct cfg80211_nan_func(9) β€” nan conf changes, func filter, and the nan func
  • struct cfg80211_pmk_conf(9), struct cfg80211_external_auth_params(9) β€” PMK conf and external auth params
  • struct cfg80211_ftm_responder_stats(9) β€” FTM responder stats
  • struct cfg80211_pmsr_ftm_result(9), struct cfg80211_pmsr_result(9) β€” PMSR FTM result and PMSR result
  • struct cfg80211_pmsr_ftm_request_peer(9), struct cfg80211_pmsr_request_peer(9), struct cfg80211_pmsr_request(9) β€” FTM request peer, request peer, and the request itself
  • struct cfg80211_update_owe_info(9), struct mgmt_frame_regs(9) β€” update OWE info and mgmt frame regs
  • struct cfg80211_ops(9) β€” the ops struct, the driver's whole personality
  • enum wiphy_flags(9) β€” wiphy flags enum
  • struct ieee80211_iface_limit(9), struct ieee80211_iface_combination(9) β€” iface limit and iface combination
  • enum wiphy_wowlan_support_flags(9), struct wiphy_wowlan_support(9), struct wiphy_coalesce_support(9) β€” wowlan support flags, wowlan support, coalesce support
  • enum wiphy_vendor_command_flags(9), enum wiphy_opmode_flag(9), struct sta_opmode_info(9), struct wiphy_vendor_command(9) β€” vendor command flags, opmode flag, sta opmode info, vendor command
  • struct wiphy_iftype_ext_capab(9), cfg80211_get_iftype_ext_capa(9) β€” iftype ext capab and the getter for it
  • struct cfg80211_pmsr_capabilities(9), struct wiphy_iftype_akm_suites(9) β€” PMSR capabilities and iftype AKM suites
  • struct wiphy_radio_cfg(9), struct wiphy_radio_freq_range(9), struct wiphy_radio(9) β€” radio cfg, radio freq range, radio
  • enum wiphy_nan_flags(9), struct wiphy_nan_capa(9) β€” wiphy NAN flags and NAN capa
  • struct wiphy(9) β€” the big wiphy, undisputed main character energy πŸ‘‘
  • wiphy_priv(9), priv_to_wiphy(9) β€” priv, and back to wiphy again
  • set_wiphy_dev(9), wiphy_dev(9), wiphy_name(9) β€” set the dev, get the dev, get the name
  • wiphy_new_nm(9), wiphy_new(9) β€” new with a name, and plain new
  • wiphy_register(9), rcu_dereference_wiphy(9), wiphy_dereference(9), get_wiphy_regdom(9) β€” register, RCU deref, deref, and get regdom
  • wiphy_unregister(9), wiphy_free(9) β€” unregister, then free, in that order, please πŸ™
  • wiphy_lock(9), wiphy_unlock(9) β€” lock and unlock, the sacred pair
  • wiphy_work_queue(9), wiphy_work_cancel(9), wiphy_work_flush(9) β€” queue it, cancel it, flush it
  • wiphy_delayed_work_queue(9), wiphy_delayed_work_cancel(9), wiphy_delayed_work_flush(9), wiphy_delayed_work_pending(9) β€” the delayed flavor: queue, cancel, flush, pending
  • wiphy_hrtimer_work_queue(9), wiphy_hrtimer_work_cancel(9), wiphy_hrtimer_work_flush(9), wiphy_hrtimer_work_pending(9) β€” and the hrtimer flavor: queue, cancel, flush, pending
  • enum ieee80211_ap_reg_power(9) β€” AP regulatory power enum
  • struct wireless_dev(9), wdev_priv(9), wdev_chandef(9) β€” wireless dev, wdev priv, wdev chandef ✨

🧚 UTILITY FUNCTIONS

the little helpers that fix everything, honestly the backstage crew:


πŸ“ DATA PATH HELPERS

the "get the packet where it's going" club:


πŸŽ€ REGULATORY ENFORCEMENT INFRASTRUCTURE

the "what am I even allowed to transmit" chapter, very responsible of you:


πŸ’€ INTERNAL REGULATORY DB FUNCTIONS

internal means internal bestie, these are the backstage passes, don't go poking at them in your driver and then act surprised 🫢

🐝 RFKILL INTEGRATION, VENDOR COMMANDS & TEST MODE

the three little side-quest sections, all iconic in their own way:


🌈 THE FINAL BOSS: the connect / roam / notify mega-list

no section header here bestie, it just keeps going, and honestly? respect. πŸ”₯

and that's the whole SEE ALSO, every single reference, not one dropped. you're doing amazing sweetie, keep going πŸ’œ

okay bestie the conversion pipeline is right there, we love a glow-up ✨

register, unregister, unregister β€” it's giving "one of these is not like the other" but honestly they're all load-bearing, no cap πŸ’…

not the shutdown-all-interfaces page sitting quietly at the end of the list like it didn't just choose violence 😭 iconic behavior honestly

set and isset, a matched set, we stan a duo 🫢

the assoc comeback!! literally the sibling of this very page, go give it a read fr fr πŸ’–

the whole color-change friend group showed up πŸŽ€ started, aborted, plain notify β€” the way they all pulled up together is so real

and that's the whole list, every last one, nobody left behind πŸ‘‘


okay that's a wrap on part three and on the whole page, bestie!! πŸ¦‹ this one came from ./include/net, dated October 2026, and the page is cfg80211_assoc_failure(9) β€” go forth, read the sibling pages, and slay your wireless stack debugging πŸ’œπŸŒΈ

πŸ“¦ where this page comes from