cfg80211_put_bss(9)

📦 version 7.3.1, in nixpkgs unstable

✨ cfg80211_put_bss(9) ✨

okay so bestie, welcome to the Kernel API Manual page for cfg80211_put_bss — like, this is the actual manpage (section 9, kernel API, iykyk) and we're gonna get through it together 💅

🎀 NAME 🎀

cfg80211_put_bss — unref BSS struct

like, it drops a reference on a BSS struct. that's the whole vibe. ✨

🌸 SYNOPSIS 🌸

void cfg80211_put_bss (struct wiphy *wiphy , struct cfg80211_bss *bss );

that's it, that's the signature — copy it exactly, don't be weird about the spacing 🫶

🦋 ARGUMENTS 🦋

  • wiphy — the wiphy this BSS struct belongs to. like, the owner of the BSS. you gotta tell it which wiphy it's from, no cap.
  • bss — the BSS struct itself. the actual STAR of the show, main character energy 👑

💖 DESCRIPTION 💖

Decrements the refcount of the given BSS struct.

that's literally it. one job, and it does it slayfully. you hand it a bss, it lowers the refcount by one. iconic. 🌈

ngl this one is short but don't skip the vibe check — the refcount is the whole point, so put it back when you're done with it, fr fr 💀

🌈 SEE ALSO 🌈

okay bestie, deep breath — this is the cross-reference section and it is a lot. like, scroll-for-a-while a lot. every single one of these is in section (9) (that's the kernel-API docs section, iykyk), so when you see the (9) you already know what time it is ✨

so the whole trail starts at the header file itself:

  • ./include/net/cfg80211.h — the actual kernel file everything here lives in, tucked over in include/net/

then the intro crew 🫶

yes there are two of them with basically the same name (one's got a _ in front, don't come for me, that's just how it is 💅).

okay next stretch, this one's all about configuring things and channel definitions — it's giving "the plumbing" energy 🎀

the chandef gang really said "we will be everywhere" and honestly? respect 🫡

now the survey / beacon / station-parameters block. this is the long one, hydrate first 🍓

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

mesh, OCB, SAR, stations, links — everybody's here, it's a whole party 🎉

and then 👑 Scanning and BSS list handling kicks off a whole arc, from SSIDs all the way through connection params and literally every wowlan/coalesce struct you could ever want:

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

the way this list just keeps going — main character energy fr fr 😭

okay now we hit NAN (Neighbor Awareness Networking) and the PMSR/OWE corner of the universe, plus the giant struct cfg80211_ops:

the wiphy_ entries alone are a whole friend group — wiphy_work_*, wiphy_delayed_work_*, wiphy_hrtimer_work_*… iconic scheduling family 💜

Utility functions time!! this is where all the conversion helpers live (khz ↔ freq ↔ channel, the whole little ecosystem) plus the data-path helpers and element-finders:

the find_*_ie / find_*_elem pairs 😌 so many matched sets, we love a consistent naming scheme 🦋

and the grand finale stretch — scan/BSS reporting, mlme mgmt, rfkill, vendor commands, test mode, connect/roam/disconnect notifications, and every notify function under the sun:

and that's the roster 💀 genuine "I know her" moment for every single symbol in cfg80211. don't worry, we're not done yet — keep scrolling bestie 🧚

okay so the cross-reference list literally does not stop, bestie — this is the SEE ALSO grand finale and every single one of these is a real page you can go read 💅 consider this your reading list, no skips, i will be quizzing you ✨

the regulatory girlies 🎀 say hi

conversions, conversions, conversions 🔁 iconic behaviour honestly

register/unregister besties, plus a struct and a P2P moment 🦋

the element-splitting trio, slicing IEs like it's nothing ✂️

stopping, shutting down, counting your channels — the responsible-adult corner of the page 🌸

feature flags and the whole NAN crew 🔥 (yes there are more NAN pages below, she's everywhere)

auth, ranging, iftype checks, assoc comeback, OWE, and a flush for good measure 💜

color change saga + MLO + 6GHz power type — highkey the most extra group here 🌈

and the grand finale: more NAN, debugfs read/write, the S1G freq trio, and the incumbent signal notifier 👑 that's the whole list, you made it, i'm so proud 😭

and that's a wrap on cfg80211_put_bss(9) bestie 🫶 this lil masterpiece lives in the source tree under ./include/net, dated October 2026 — go forth, cite your references, and slay your kernel docs ✨💖

📦 where this page comes from