wiphy_priv(9)
๐
wiphy_priv โ wiphy_priv(9), Kernel API Manual
okay bestie, welcome to the <rainbow>Kernel API Manual</rainbow> โจ today we're looking at section 9, wiphy_priv(9) โ and ngl, this one is short and sweet. Baby page. Snack-sized. But it's still lowkey iconic so let's give it the respect it deserves ๐ซถ
๐ธ NAME ๐ธ
wiphy_priv โ return priv from wiphy
Like. That's the whole name section. It returns the priv, from the wiphy. The way that it literally just says what it does? main character energy ๐
โจ SYNOPSIS โจ
void * wiphy_priv (struct wiphy *wiphy );
Obsessed with how tidy this is ๐ one function, one argument, one pointer coming back at you. Copy it exactly if you're typing it out, spacing and all, because we do not freestyle in the synopsis. periodt.
๐ฆ ARGUMENTS ๐ฆ
wiphyโ the wiphy whose priv pointer to return. yes that's the actual job description. you hand it a wiphy, it gives you back that wiphy's priv pointer. match made in heaven ๐
๐ RETURN ๐
The priv of wiphy. ๐ซ
That's it. That's the return value. No twist, no secret second thing, no "unless" clause hiding at the bottom. It's giving simple, clean, unbothered. ๐
bestie reminder: the return type is void * โ so whatever comes back is untyped, and the signature is literally printed up there in the SYNOPSIS. don't come for me about casting, the page doesn't say a single word about it and neither will I ๐ญ
okay that's the whole core of this one โ keep reading, the next part is coming right up ๐
๐๏ธ the file this whole saga lives in
Kernel file ./include/net/cfg80211.hโ bestie this is the header, the mothership, the main character ๐ everything below lives hereIntroduction(9)Device registration(9)
๐ฆ bands, rates & caps (the "can my radio even" section)
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)
โ๏ธ Actions and configuration โ the whole toolkit
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)
๐ก beacons, AP settings & station params โ the whole cast
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 and BSS list handling โ the gossip-gathering era
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) โ literally the social network
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)
๐ ops & wiphy capabilities โ the driver contract
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 & friends โ the lifecycle glow-up
struct wiphy(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 functions โ 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 โ packets doing their thing
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 rules era
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 notify era
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 integration, Vendor commands & Test mode
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)
๐ซถ the connect / roam / notify besties (the whole group chat)
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)cfg80211_report_obss_beacon(9)struct cfg80211_beaconing_check_config(9)
okay so the reference list keeps going, bestie โ grab a snack, we're almost at the end of the cross-reference era ๐
cfg80211_reg_check_beaconing(9)โ the regulatory girlies said check it first โจcfg80211_reg_can_beacon(9)โ the vibe check, but for beaconingcfg80211_reg_can_beacon_relax(9)โ same energy, chill mode ๐cfg80211_ch_switch_notify(9)โ channel switch gossip, deliveredcfg80211_ch_switch_started_notify(9)โ and the "we literally started" follow-upieee80211_operating_class_to_band(9)โ op class โก๏ธ band, iconic conversionieee80211_operating_class_to_chandef(9)โ op class โก๏ธ chandef, slayieee80211_chandef_to_operating_class(9)โ the reverse, it ateieee80211_chandef_to_khz(9)โ numbers, but in kHz, no cap
cfg80211_tdls_oper_request(9)โ TDLS business, handledcfg80211_calculate_bitrate(9)โ math time ๐งฎcfg80211_unregister_wdev(9)โ tearing down, but politelycfg80211_register_netdevice(9)โ and the registering one, obviouslycfg80211_unregister_netdevice(9)โ you already know the pattern, bestiestruct cfg80211_ft_event_params(9)โ a whole struct, main character energy ๐cfg80211_ft_event(9)โ the event that goes with itcfg80211_get_p2p_attr(9)โ P2P attributes, get 'emieee80211_ie_split_ric(9)โ splitting IEs with RIC, obsessedieee80211_ie_split(9)โ the plain split oneieee80211_fragment_element(9)โ fragmenting, it's giving โ๏ธcfg80211_report_wowlan_wakeup(9)โ wakeup reporting, WoWLAN corecfg80211_crit_proto_stopped(9)โ critical protocol said "we're done"
ieee80211_get_num_supported_channels(9)โ counting channels, lowkey usefulcfg80211_check_combinations(9)โ combinations: checkedcfg80211_iter_combinations(9)โ combinations: iteratedcfg80211_get_radio_idx_by_chan(9)โ which radio? found it ๐ฅcfg80211_stop_link(9)โ stopping a link, periodtcfg80211_stop_iface(9)โ stopping an iface, same energycfg80211_shutdown_all_interfaces(9)โ ALL of them ๐ญ dramatic and correctwiphy_ext_feature_set(9)โ extended feature: setwiphy_ext_feature_isset(9)โ extended feature: is it set tho
cfg80211_free_nan_func(9)โ NAN cleanup, gotta free itstruct cfg80211_nan_match_params(9)โ another struct, another slaycfg80211_nan_match(9)โ the match, matchedcfg80211_nan_func_terminated(9)โ terminated, rip ๐ชฆcfg80211_nan_sched_update_done(9)โ schedule update: donecfg80211_external_auth_request(9)โ auth request, but externalcfg80211_pmsr_report(9)โ PMSR, reportedcfg80211_pmsr_complete(9)โ PMSR, completedcfg80211_iftype_allowed(9)โ allowed or not, that's the questioncfg80211_assoc_comeback(9)โ assoc comeback szn ๐ฆcfg80211_update_owe_info_event(9)โ OWE info event, updated
cfg80211_bss_flush(9)โ flushing BSS entries, whoosh ๐จcfg80211_bss_color_notify(9)โ BSS color notificationcfg80211_obss_color_collision_notify(9)โ collision! notify! ๐จcfg80211_color_change_started_notify(9)โ color change: startedcfg80211_color_change_aborted_notify(9)โ color change: aborted (it happens)cfg80211_color_change_notify(9)โ color change: the notifycfg80211_6ghz_power_type(9)โ 6 GHz power type, very nowcfg80211_links_removed(9)โ links? removed. ๐struct cfg80211_mlo_reconf_done_data(9)โ MLO reconf data struct, we stancfg80211_mlo_reconf_add_done(9)โ MLO reconf add: donecfg80211_schedule_channels_check(9)โ schedule that channels checkcfg80211_epcs_changed(9)โ EPCS changed, noted
cfg80211_next_nan_dw_notif(9)โ next NAN DW notification, up nextcfg80211_nan_cluster_joined(9)โ joined the cluster, we're in ๐ซถcfg80211_nan_ulw_update(9)โ ULW updatecfg80211_nan_channel_evac(9)โ channel evac, everybody outwiphy_locked_debugfs_read(9)โ debugfs reading, but locked ๐wiphy_locked_debugfs_write(9)โ debugfs writing, also lockedcfg80211_s1g_get_start_freq_khz(9)โ S1G start freq, in kHzcfg80211_s1g_get_end_freq_khz(9)โ S1G end freq, also kHz, consistent iconcfg80211_s1g_get_primary_sibling(9)โ primary sibling, family vibes ๐ธcfg80211_incumbent_signal_notify(9)โ incumbent signal, notified. and that's the list, bestie ๐
and that's a wrap on the whole page!! ๐ this one lives in the kernel source tree under ./include/net, dated October 2026, and it's section wiphy_priv(9) โ go forth and man responsibly, you absolute legend ๐โจ
๐ฆ 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