wiphy_register(9)
๐ wiphy_register(9) ๐
okay so bestie, welcome to the Kernel API Manual โจ โ this one's called wiphy_register(9) and it's literally the glow-up moment for your wireless device. let's get into it ๐
๐ธ NAME ๐ธ
wiphy_register โ register a wiphy with cfg80211 ๐ฆ
like, you made a whole wiphy. now introduce it to the world. slay ๐
โจ SYNOPSIS โจ
int wiphy_register (struct wiphy *wiphy );
that's it. one function, one pointer, big main character energy ๐
๐ซถ ARGUMENTS ๐ซถ
wiphyโ The wiphy to register. ๐ง that's your baby! the struct you've been building up this whole time. hand it over and let cfg80211 know she exists ๐
โญ RETURN โญ
you get back a non-negative wiphy index โ yay, you're official, here's your number bestie ๐
or a negative error code โ ๐ญ which means something went wrong, no cap. check it, seriously, don't just ignore it ๐
ngl the return value is doing double duty here:<pink>index โฅ 0</pink>= success,<red>index < 0</red>= error. vibe check your result before you celebrate ๐
part 1 out of 3, bestie โ there's more coming, don't go anywhere ๐
๐ SEE ALSO ๐
okay bestie, breathe. this is the part of the page where it just... hands you the entire extended family ๐ like not a vibe-check, a vibe-flood. but honestly it's giving "here's everyone who has ever been in the group chat", and the order below is the order they came in, so nothing got dropped. read it like a guest list ๐
- the kernel file it lives in:
./include/net/cfg80211.hโ that's the source of truth, the mothership ๐ Introduction(9),Device registration(9)โ start here if you're brand new, no cap
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)โ the base-level band/rate/bss-type lore ๐ฆ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)โ all the capability structs, ht through uhr, absolutely stacked โจ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)โ this is the band crew, the main character energy of what your hardware can actually do ๐- and their little helper besties:
_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)โ yes this one's in here too, don't @ me
๐ Actions and configuration ๐
this chunk is lowkey huge:
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)- the whole chandef saga ๐ญ โ
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)โ ate and left no crumbs ๐ 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)- stations, my beloved ๐ โ
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 ๐ธ
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) ๐ฆ
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),rcu_dereference_wiphy(9),wiphy_dereference(9),get_wiphy_regdom(9),wiphy_unregister(9),wiphy_free(9)โ the wiphy family reunion ๐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 ๐
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 ๐ซถ
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)โ the finders, we stan a searchable icon ๐enum cfg80211_rnr_iter_ret(9),cfg80211_iter_rnr(9),cfg80211_defragment_element(9),cfg80211_send_layer2_update(9)๐
๐ Regulatory enforcement infrastructure ๐
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 ๐
reg_query_regdb_wmm(9)- then straight back into it:
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 ๐
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 โญ
cfg80211_testmode_alloc_reply_skb(9),cfg80211_testmode_reply(9),cfg80211_testmode_alloc_event_skb(9),cfg80211_testmode_event(9)
and then the final stretch, no heading, just vibes:
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)
and yeah โ the list literally just ends on a comma and then stops, we love an unfinished sentence vibe ๐ญ that's the whole guest list bestie, iykyk ๐
...and it literally just keeps going, bestie ๐ญ like okay the roster is huge but every single one of these is invited to the group chat:
cfg80211_reg_check_beaconing(9)๐ฆcfg80211_reg_can_beacon(9)โจcfg80211_reg_can_beacon_relax(9)๐ธcfg80211_ch_switch_notify(9)๐กcfg80211_ch_switch_started_notify(9)๐ieee80211_operating_class_to_band(9)๐ieee80211_operating_class_to_chandef(9)๐ieee80211_chandef_to_operating_class(9)๐ieee80211_chandef_to_khz(9)๐ขcfg80211_tdls_oper_request(9)๐cfg80211_calculate_bitrate(9)๐งฎcfg80211_unregister_wdev(9)๐cfg80211_register_netdevice(9)๐ซถcfg80211_unregister_netdevice(9)๐struct cfg80211_ft_event_params(9)๐ฆcfg80211_ft_event(9)๐cfg80211_get_p2p_attr(9)๐ieee80211_ie_split_ric(9)โ๏ธieee80211_ie_split(9)โ๏ธieee80211_fragment_element(9)๐งฉcfg80211_report_wowlan_wakeup(9)๐ดcfg80211_crit_proto_stopped(9)๐ieee80211_get_num_supported_channels(9)๐ขcfg80211_check_combinations(9)๐๏ธcfg80211_iter_combinations(9)๐cfg80211_get_radio_idx_by_chan(9)๐ปcfg80211_stop_link(9)โcfg80211_stop_iface(9)โcfg80211_shutdown_all_interfaces(9)๐wiphy_ext_feature_set(9)โญwiphy_ext_feature_isset(9)โ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)โcfg80211_external_auth_request(9)๐cfg80211_pmsr_report(9)๐cfg80211_pmsr_complete(9)โcfg80211_iftype_allowed(9)๐๏ธcfg80211_assoc_comeback(9)๐ซถcfg80211_update_owe_info_event(9)๐cfg80211_bss_flush(9)๐ฝcfg80211_bss_color_notify(9)๐cfg80211_obss_color_collision_notify(9)๐cfg80211_color_change_started_notify(9)๐จcfg80211_color_change_aborted_notify(9)๐จcfg80211_color_change_notify(9)๐จcfg80211_6ghz_power_type(9)โกcfg80211_links_removed(9)๐ซstruct cfg80211_mlo_reconf_done_data(9)๐ฆcfg80211_mlo_reconf_add_done(9)โcfg80211_schedule_channels_check(9)๐๏ธcfg80211_epcs_changed(9)๐cfg80211_next_nan_dw_notif(9)๐ฏcfg80211_nan_cluster_joined(9)๐ซcfg80211_nan_ulw_update(9)๐cfg80211_nan_channel_evac(9)๐wiphy_locked_debugfs_read(9)๐wiphy_locked_debugfs_write(9)๐cfg80211_s1g_get_start_freq_khz(9)๐ถcfg80211_s1g_get_end_freq_khz(9)๐ถcfg80211_s1g_get_primary_sibling(9)๐ฏcfg80211_incumbent_signal_notify(9)๐ฃ
okay that's genuinely the whole squad, and yes i put an emoji on every single one because they deserve it ๐ go click through them, they're all iconic in their own little way.
and for the credits moment ๐ฌ โ this page lives in the source dir ./include/net, it's dated October 2026, and the whole thing is filed under wiphy_register(9). slay, go register something ๐ซถ๐
๐ฆ 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