cfg80211_gen_new_bssid(9)
๐ cfg80211_gen_new_bssid(9) ๐
okay so bestie, welcome to the Kernel API Manual page for cfg80211_gen_new_bssid โ yes i know that name is a mouthful, say it with me, we're gonna get through it together ๐ซถ
โจ NAME โจ
cfg80211_gen_new_bssid โ generate a nontransmitted BSSID for multi-BSSID ๐
like, literally what it says on the tin. it makes you a brand-new nontransmitted BSSID. iconic behaviour, no cap.
๐ธ SYNOPSIS ๐ธ
void cfg80211_gen_new_bssid (const u8 *bssid , u8 max_bssid , u8
mbssid_index , u8 *new_bssid );
so it returns void โ meaning it's not gonna hand you back a value, it just does the thing and dips ๐ the actual result lands in new_bssid, which you hand it as a pointer. we love an out-param moment.
๐ ARGUMENTS ๐
bssidโ the transmitter BSSID. this is your main character, the one doing the transmitting ๐ฆmax_bssidโ the max BSSID indicator, and bestie listen โ this one gets taken from the Multiple BSSID element. that's where it lives. don't go looking anywhere else ๐mbssid_indexโ the BSSID index, and this lil guy is taken from the Multiple BSSID index element. yes, index element. different element. keep them straight, i believe in you ๐new_bssidโ the calculated nontransmitted BSSID. this is where the magic gets written, so it's the calculated one, not the transmitted one. very demure, very mindful ๐ธ
ngl the naming on this whole family of symbols is a lot, so just remember:bssidin = transmitter,new_bssidout = nontransmitted. the two middles are just the raw numbers you pulled out of their respective elements ๐
and that's the whole function, bestie โ short and sweet, it's giving tiny-but-loaded ๐ง
๐ SEE ALSO ๐
okay bestie, this is the part where the page just โฆ lists everything. and i mean everything. it's giving "group chat where someone adds all 300 of their mutuals to the same chat" energy ๐ญ like genuinely, this is the whole cfg80211 extended family and they ALL showed up to the party. take a breath, we're going through them ๐
the very first one is the source of truth, the mothership, the actual file these docs came from:
Kernel file ./include/net/cfg80211.h
and then the intro + device registration vibes:
Introduction(9)โ where the whole saga starts, def start here if you're new ๐ซถDevice registration(9)โ the "how do i even become a device" chapter
channel, rate and BSS core stuff โ the foundational girlies โจ
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)
the sband iftype data function squad โ look, the naming is consistent, that's all i'm saying ๐
_ieee80211_set_sband_iftype_data(9)โ bestie with the leading underscore, don't @ herieee80211_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 "we're doing stuff now" era ๐ค
Actions and configuration(9)โ the section that lowkey runs the worldstruct 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)
the chandef cinematic universe ๐ฌ โ yes there really are this many
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)
survey + crypto + the beacon/AP-adjacent fam ๐
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)โ try saying it five times fast, i dare you ๐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)
station era ๐ธ โ the structs and helpers for the little guys connected to you
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)
SAR + station lookup + mesh/mpath/ocb bits ๐ฆ
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)โ not to be confused with the otherbss_param_flagsup there, they're different, i promise, i'm not messing with you ๐ซถ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 โ the "ooh what's out there" chapter ๐
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 era โ the actual "get me on the network" storyline ๐ฅ
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)
wowlan / coalesce / power-save girlies ๐ค โ the "we sleep now" economy
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) โ the social butterfly of the spec, she knows everyone ๐ง
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 / external auth / ftm / pmsr โ i'm not gonna pretend this cluster isn't a lot, but it's all here ๐
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 big one, the driver's whole personality honestlyenum 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)
the wiphy lifecycle saga โ birth, registration, locking, work queueing, all of it ๐
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)
reg power + wireless_dev + its little helpers ๐
enum ieee80211_ap_reg_power(9)struct wireless_dev(9)wdev_priv(9)wdev_chandef(9)
UTILITY FUNCTIONS โ the little toolbox every driver reaches into ๐
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 โ where the actual packets live, slay ๐
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 โ the "no, you can't transmit there" department ๐จ
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 inform / get-put-ref era โ the BSS bookkeeping girlies ๐
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_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)
mlme mgmt notifications โ auth timeout, assoc resp, failures, the whole emotional arc ๐ญ
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 INTEGRATION โ the airplane-mode besties โ๏ธ
RFkill integration(9)wiphy_rfkill_set_hw_state_reason(9)wiphy_rfkill_start_polling(9)wiphy_rfkill_stop_polling(9)
VENDOR COMMANDS + TEST MODE โ the "we made our own rules" section ๐
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)โ not for production, bestie, it says so in the namecfg80211_testmode_alloc_reply_skb(9)cfg80211_testmode_reply(9)cfg80211_testmode_alloc_event_skb(9)cfg80211_testmode_event(9)
connect / roam / disconnect โ the relationship status updates ๐โก๏ธ๐
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)
station bookkeeping notifications ๐
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)
rx/tx mgmt + control port โญ
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)
cqm + radar + cac + gtk rekey โ the "something changed, tell everyone" club ๐ฃ
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)โ she didn't even ask for that frame, iconiccfg80211_rx_unexpected_4addr_frame(9)cfg80211_probe_status(9)cfg80211_report_obss_beacon_khz(9)cfg80211_report_obss_beacon(9)
and the last one we get to before this list literally hits the character limit:
struct cfg80211_beaconing_check_config(9)
and bestieโฆ she's not even done. the comma is still there. there's more. part 3 has the rest, hold onโ ๐
โฆand the list keeps going, bestie, because this page is thorough. Part two of the SEE ALSO squad, in exactly the order the kernel gods wrote them:
cfg80211_reg_check_beaconing(9)โ the "can we even beacon here tho" check โจcfg80211_reg_can_beacon(9)โ beacon legality, the polite editioncfg80211_reg_can_beacon_relax(9)โ same vibe check, but it's willing to chill a lilcfg80211_ch_switch_notify(9)โ telling everyone the channel moved ๐ขcfg80211_ch_switch_started_notify(9)โ same announcement, "we're doing it right now" cutieee80211_operating_class_to_band(9)โ op class in, band outieee80211_operating_class_to_chandef(9)โ op class in, chandef outieee80211_chandef_to_operating_class(9)โ the reverse glow-up ๐ieee80211_chandef_to_khz(9)โ chandef โ kHz, it's literally in the namecfg80211_tdls_oper_request(9)โ TDLS ops knocking at your doorcfg80211_calculate_bitrate(9)โ math time, bitrate edition ๐งฎcfg80211_unregister_wdev(9)โ yeeting a wireless devcfg80211_register_netdevice(9)โ netdevice registration szncfg80211_unregister_netdevice(9)โ the un-registration one, obvistruct cfg80211_ft_event_params(9)โ the FT event params struct, love hercfg80211_ft_event(9)โ the FT event itselfcfg80211_get_p2p_attr(9)โ grab that P2P attributeieee80211_ie_split_ric(9)โ IE splitting, RIC flavourieee80211_ie_split(9)โ IE splitting, the classicieee80211_fragment_element(9)โ chopping an element into lil fragments ๐cfg80211_report_wowlan_wakeup(9)โ WoWLAN woke up and we are telling on itcfg80211_crit_proto_stopped(9)โ critical protocol said "I'm done here"ieee80211_get_num_supported_channels(9)โ countin' channels like counting sheep ๐
cfg80211_check_combinations(9)โ checking the comboscfg80211_iter_combinations(9)โ iterating those same combos, one by onecfg80211_get_radio_idx_by_chan(9)โ which radio owns this channel, slaycfg80211_stop_link(9)โ stopping a link, gentle-likecfg80211_stop_iface(9)โ stopping the whole iface, less gentlecfg80211_shutdown_all_interfaces(9)โ everything off, bye ๐wiphy_ext_feature_set(9)โ set an extended feature bitwiphy_ext_feature_isset(9)โ is it set tho? ask here
cfg80211_free_nan_func(9)โ free the NAN funcstruct cfg80211_nan_match_params(9)โ NAN match params structcfg80211_nan_match(9)โ a NAN match happened ๐ฆcfg80211_nan_func_terminated(9)โ NAN func said byecfg80211_nan_sched_update_done(9)โ NAN sched update: done โcfg80211_external_auth_request(9)โ external auth request incomingcfg80211_pmsr_report(9)โ PMSR reportcfg80211_pmsr_complete(9)โ PMSR completecfg80211_iftype_allowed(9)โ is this iftype allowed? find outcfg80211_assoc_comeback(9)โ assoc comeback moment โจcfg80211_update_owe_info_event(9)โ OWE info update event
cfg80211_bss_flush(9)โ flush the BSS listcfg80211_bss_color_notify(9)โ BSS color notificationcfg80211_obss_color_collision_notify(9)โ OBSS color collision, notifyingcfg80211_color_change_started_notify(9)โ color change startedcfg80211_color_change_aborted_notify(9)โ color change aborted ๐ญcfg80211_color_change_notify(9)โ color change, the plain onecfg80211_6ghz_power_type(9)โ 6 GHz power typecfg80211_links_removed(9)โ links got removed ๐struct cfg80211_mlo_reconf_done_data(9)โ the MLO reconf done data structcfg80211_mlo_reconf_add_done(9)โ MLO reconf add donecfg80211_schedule_channels_check(9)โ schedule a channels checkcfg80211_epcs_changed(9)โ EPCS changed
cfg80211_next_nan_dw_notif(9)โ next NAN DW notificationcfg80211_nan_cluster_joined(9)โ joined a NAN cluster ๐cfg80211_nan_ulw_update(9)โ NAN ULW updatecfg80211_nan_channel_evac(9)โ NAN channel evacwiphy_locked_debugfs_read(9)โ debugfs read, locked editionwiphy_locked_debugfs_write(9)โ debugfs write, also lockedcfg80211_s1g_get_start_freq_khz(9)โ S1G start freq in kHzcfg80211_s1g_get_end_freq_khz(9)โ S1G end freq in kHzcfg80211_s1g_get_primary_sibling(9)โ S1G primary siblingcfg80211_incumbent_signal_notify(9)โ incumbent signal notification, and that's a wrap ๐
ngl bestie if you read all 64 of those you are genuinely built different. go touch some grass, then come back and read the actual pages ๐
๐ธ okay that's the whole page, bye ๐ธ
That's it, that's the manpage, you made it to the end, I'm so proud ๐ซถ This lil gem lives in ./include/net and the version of record is dated October 2026 โ so if you're reading this in the future, hi, hope the kernel is still slaying. Now go write some code, bestie, you've got this โจ๐ฅ๐
๐ฆ 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