cfg80211_report_obss_beacon(9)
π« cfg80211_report_obss_beacon(9) π«
okay so bestie, this one is straight out of the Kernel API Manual and it's giving "hey kernel, I saw a beacon, pls tell userspace" energy. it's a void function, so likeβ¦ no returns, no drama, no notes. π
β¨ NAME β¨
cfg80211_report_obss_beacon β report a beacon that came from other APs π (yes, the ones that aren't you, the whole point)
π¦ SYNOPSIS π¦
void cfg80211_report_obss_beacon (struct wiphy *wiphy , const u8 *frame
, size_t len , int freq , int sig_dbm );
that's the whole signature, copy it exactly, no cap. π
πΈ ARGUMENTS πΈ
wiphyβ thewiphythat received the beacon. like, whose radio caught it. π«Άframeβ the frame. that's it, that's the whole description, the frame itself. πlenβ length of the frame. how many bytes of frame you're handing over.freqβ the frequency the frame was received on. π‘sig_dbmβ signal strength in dBm, or0if unknown. so if you don't know, just put0, it's fine, nobody's judging. π
π₯ DESCRIPTION π₯
Use this function to report to userspace when a beacon was received. π¨ that's literally its whole job β beacon shows up, you tell userspace, everyone stays informed, iconic behaviour honestly.
β οΈ okay but listen: it is not useful to call this when there is no netdev that is in AP/GO mode. so if you've got no netdev running as an AP or GO, this call is lowkey pointless β vibe check your setup first, bestie. π§
more parts coming, don't go anywhere π
π SEE ALSO β¨
Okay bestie, real talk: this bit is literally just the cross-reference dump for the whole cfg80211 universe, and it is long. But every single one of these pages is listed below, in order, no skips, no "lol you get the idea". Ngl it's giving "phone book but make it wireless". Obsessed anyway π
- Kernel file
./include/net/cfg80211.h 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)
πΈ and now we enter the configuration era, hold my iced coffee πΈ
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)cfg80211_get_chandef_type(9)cfg80211_chandef_create(9)cfg80211_chandef_identical(9)cfg80211_chandef_is_edmg(9)cfg80211_chandef_is_s1g(9)cfg80211_chandef_compatible(9)nl80211_chan_width_to_mhz(9)cfg80211_chandef_get_width(9)cfg80211_chandef_valid(9)cfg80211_chandef_usable(9)cfg80211_chandef_dfs_required(9)cfg80211_chandef_dfs_usable(9)cfg80211_chandef_dfs_cac_time(9)cfg80211_chandef_primary(9)cfg80211_chandef_npca_valid(9)cfg80211_chandef_add_npca(9)cfg80211_chandef_add_dbe(9)nl80211_send_chandef(9)ieee80211_chandef_max_power(9)cfg80211_chandef_s1g_pri_width(9)cfg80211_any_usable_channels(9)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 bestie era, we love a BSS list π¦
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)(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)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_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 corner, aka the little helpers that ate π
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(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 section, she's rules and she knows 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)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)
π rfkill, vendor stuff, test mode, and then a frankly unhinged number of notify functions π
RFkill integration(9)wiphy_rfkill_set_hw_state_reason(9)wiphy_rfkill_start_polling(9)wiphy_rfkill_stop_polling(9)Vendor commands(9)cfg80211_vendor_cmd_alloc_reply_skb(9)cfg80211_vendor_cmd_reply(9)cfg80211_vendor_cmd_get_sender(9)cfg80211_vendor_event_alloc(9)cfg80211_vendor_event_alloc_ucast(9)cfg80211_vendor_event(9)Test mode(9)cfg80211_testmode_alloc_reply_skb(9)cfg80211_testmode_reply(9)cfg80211_testmode_alloc_event_skb(9)cfg80211_testmode_event(9)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)struct cfg80211_beaconing_check_config(9)cfg80211_reg_check_beaconing(9)
Heads up bestie: that last stretch is the whole tail end of the list in the exact order it was given, so if you're grepping, everything after cfg80211_probe_status(9) is exactly those three and then it's done β¨
Andβ¦ yeah, that's the entire SEE ALSO. Still with me? π«Ά There's more coming, so don't go anywhere π
Okay bestie, the cross-reference list keeps going β grab a snack, this is the long tail of the SEE ALSO section and we're reading it all β¨
cfg80211_reg_can_beacon(9),cfg80211_reg_can_beacon_relax(9)β the regulatory beacon duo, one chill and one relaxed about it πcfg80211_ch_switch_notify(9),cfg80211_ch_switch_started_notify(9)β channel switch, both the "we're doing it" and the "we did it" versionsieee80211_operating_class_to_band(9),ieee80211_operating_class_to_chandef(9)β converting operating classes, because nothing in this subsystem can just be one thing πieee80211_chandef_to_operating_class(9),ieee80211_chandef_to_khz(9)β and the conversions going the other way, plus one that lands you in kHzcfg80211_tdls_oper_request(9)β TDLS operation requests, very niche, very iconic πcfg80211_calculate_bitrate(9)β math time, no capcfg80211_unregister_wdev(9)β unregistering your wireless device, sadgirl hourscfg80211_register_netdevice(9),cfg80211_unregister_netdevice(9)β the netdevice in-and-out combo π¦struct cfg80211_ft_event_params(9),cfg80211_ft_event(9)β the fast-transition event β struct first, then the function that takes it, as the universe intendedcfg80211_get_p2p_attr(9)β pulling a P2P attribute outieee80211_ie_split_ric(9),ieee80211_ie_split(9)β information element splitting, one of them RIC-flavouredieee80211_fragment_element(9)β chopping an element into fragments πcfg80211_report_wowlan_wakeup(9)β wakeup reporting, the "your Wi-Fi woke the laptop" of it allcfg80211_crit_proto_stopped(9)β critical protocol has stopped, moment of silence πieee80211_get_num_supported_channels(9)β counting channels, lowkey satisfyingcfg80211_check_combinations(9),cfg80211_iter_combinations(9)β the combinations saga, check 'em then iterate 'emcfg80211_get_radio_idx_by_chan(9)β radio index by channel, iykykcfg80211_stop_link(9),cfg80211_stop_iface(9),cfg80211_shutdown_all_interfaces(9)β escalating levels of stopping things, from one link all the way to every interface fr frwiphy_ext_feature_set(9),wiphy_ext_feature_isset(9)β set the extended feature, ask if the extended feature is set. the classic pair πcfg80211_free_nan_func(9),struct cfg80211_nan_match_params(9),cfg80211_nan_match(9),cfg80211_nan_func_terminated(9),cfg80211_nan_sched_update_done(9)β a whole NAN cluster of entries, we love a themed block πΈcfg80211_external_auth_request(9)β external auth, requesting itcfg80211_pmsr_report(9),cfg80211_pmsr_complete(9)β PMSR: report it, then complete it, in that order bestie π«Άcfg80211_iftype_allowed(9)β is this interface type allowed? vibe check πcfg80211_assoc_comeback(9)β assoc comeback, main character energycfg80211_update_owe_info_event(9)β OWE info, updating, event-ifiedcfg80211_bss_flush(9)β flush the BSS, clean slate β¨cfg80211_bss_color_notify(9),cfg80211_obss_color_collision_notify(9)β coloring siblings, one of them a whole collision notify
cfg80211_color_change_started_notify(9),cfg80211_color_change_aborted_notify(9),cfg80211_color_change_notify(9)β started, aborted, and just plain done β the color change trilogy π¨cfg80211_6ghz_power_type(9)β 6 GHz power type, nothing more, nothing lesscfg80211_links_removed(9)β links removed π₯²struct cfg80211_mlo_reconf_done_data(9),cfg80211_mlo_reconf_add_done(9)β MLO reconfig: the struct, then the "done" call that eats itcfg80211_schedule_channels_check(9)β schedule those channel checks, girlboss behavior πcfg80211_epcs_changed(9)β EPCS has changed, notedcfg80211_next_nan_dw_notif(9),cfg80211_nan_cluster_joined(9),cfg80211_nan_ulw_update(9),cfg80211_nan_channel_evac(9)β the second NAN block, and yes, they're all here, we do not skip entries in this house πwiphy_locked_debugfs_read(9),wiphy_locked_debugfs_write(9)β debugfs, locked, read and write, a matched set π₯cfg80211_s1g_get_start_freq_khz(9),cfg80211_s1g_get_end_freq_khz(9),cfg80211_s1g_get_primary_sibling(9)β S1G frequency starts, frequency ends, and the primary sibling π§cfg80211_incumbent_signal_notify(9)β last but never least, the incumbent signal notify β
That's the whole list, bestie. Sixty-three references, zero skipped, and honestly? Ate. π
And for the cute sign-off β the little footer that lives at the bottom of the page: this one's sourced out of ./include/net, dated October 2026, and it's filed under the manual page title cfg80211_report_obss_beacon(9). So like, when you cite it, cite it correctly π«Ά Go be great with your beacons, bestie β you've got this fr fr π
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms