STRUCT CFG80211_UPDATE_OWE_INFO(9)
π¦ struct cfg80211_update_owe_info(9) β Kernel API Manual π¦
okay so bestie, we're diving into the Kernel API Manual for struct cfg80211_update_owe_info, and honestly? she's kind of a big deal. OWE stands for Opportunistic Wireless Encryption, and this little struct is the whole vibe-check package that lets the drivers hand that work off to user space. no cap. let's get into it π
β¨ NAME β¨
struct cfg80211_update_owe_info β OWE Information. that's it, that's the name, and she's living up to it π«Ά
πΈ SYNOPSIS πΈ
here's the glow-up in code form, copied exactly so nobody comes for me:
struct cfg80211_update_owe_info {
u8 peer[ETH_ALEN];
u16 status;
const u8 *ie;
size_t ie_len;
int assoc_link_id;
u8 peer_mld_addr[ETH_ALEN];
};
yes, ETH_ALEN twice. iconic, honestly. moving on π
π Members π
let's meet the cast, one member at a time π₯
peerβ the MAC address of the peer device, like, the one you're doing the OWE processing for.ETH_ALENbytes of pure "who dis" energy. πstatusβ the status code, bestie. it'sWLAN_STATUS_SUCCESSwhen the OWE info processing went off without a hitch (slay), and you useWLAN_STATUS_UNSPECIFIED_FAILUREif user space literally cannot give you the real status code for failures. like, it tried, and it doesn't know why it failed, so it just says so. π this one is used only for the OWE update request command interface β that's user space to driver, iykyk.ieβ the IEs, obtained from the peer or constructed by user space. two modes, one pointer, main character energy: these are the IEs of the remote peer in the event from the host driver, and the constructed IEs by the user space in the request interface. same field, different eras. πie_lenβ the length of those IEs, in octets. count 'em. βassoc_link_idβ the MLO link ID of the AP that the peer is requesting (re)association with. the driver fills this in for both MLO and non-MLO station connections when the AP is affiliated with an MLD. for non-MLD AP mode? it's-1. yes,-1, that's the "no thoughts head empty" value. used only with the OWE update event β that's driver to user space. πpeer_mld_addrβ for an MLO connection, this is the MLD address of the peer. for a non-MLO connection, it's all zeros β nothing to see here. this is applicable only whenassoc_link_idis not-1, i.e. the AP is affiliated with an MLD. and just like its neighbor up there, it's used only with the OWE update event (driver to user space). π§
quick vibe check:assoc_link_idandpeer_mld_addrare both event-side-only fields. don't come for me, that's literally what the page says. π
π Description π
so what does this struct actually do? π¦
it provides the information needed for the drivers to offload OWE (Opportunistic Wireless Encryption) processing to user space. that's the whole assignment. the driver's like "bestie, you handle this one" and hands it over. π«Ά
and the fun part: it's commonly used across both the update_owe_info request and event interfaces. one struct, two interfaces, versatile queen. β¨
okay so that's part one, and there's literally more coming β don't go anywhere π
π SEE ALSO π
okay so before you close this page, bestie, there's a whole ecosystem of related pages and honestly? it's giving extended universe. the big one is the kernel file itself:
./include/net/cfg80211.h
that's the source of truth, the main character, the whole file your struct lives in. everything below is cross-referenced from it. grab a snack, we're going through all of them π
β¨ the basics & the band/iftype girlies β¨
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)
lowkey obsessed with how many iftype getters there are. one for every era of wifi, periodt π
π actions & configuration energy π
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)
that's a LOT of chandef. channel definition stans rise π«Ά
πΈ survey, beacon, AP settings, stations & more πΈ
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 β the way this list has range?? ate and left no crumbs π₯
π¦ scanning & BSS list handling π¦
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)
scan, auth, assoc, deauth, disassoc, connect, wowlanβ¦ honestly this one section is a whole demo of the connect lifecycle, go read it bestie β¨
π§ NAN, PMK, FTM & PMSR π§
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)
NAN is literally Neighbor Awareness Networking, which is the most main-character name for a protocol ever ngl π
π wiphy, wireless_dev & all their little helpers π
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)
look at all those _queue / _cancel / _flush / _pending families β work, delayed work, hrtimer work. the symmetry?? iconic ππ
π utility functions, data path helpers & element hunting π
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)
the cfg80211_find_* squad is your bestie when you're digging through information elements. learn them, love them π
β regulatory, BSS plumbing, mlme & notify land β
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 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)cfg80211_report_obss_beacon(9)struct cfg80211_beaconing_check_config(9)
ok that's the whole link dump bestie, no skips, no cuts, we kept every single one π«Ά and yes there's more coming so don't wander off π
okay so the SEE ALSO list here is giving full group-chat energy β it's literally every function that's in the same orbit as this one, and bestie, there are so many. Grab a snack, we're doing roll call π
- the regulatory girlies β
cfg80211_reg_check_beaconing(9),cfg80211_reg_can_beacon(9),cfg80211_reg_can_beacon_relax(9). Rules, rules, rules, but make it β¨legalβ¨. - channel switch announcements β
cfg80211_ch_switch_notify(9),cfg80211_ch_switch_started_notify(9). We're moving, tell everyone π’ - operating class + chandef math class β
ieee80211_operating_class_to_band(9),ieee80211_operating_class_to_chandef(9),ieee80211_chandef_to_operating_class(9),ieee80211_chandef_to_khz(9). Converting back and forth, the way that these four just do conversions for a living π - TDLS business β
cfg80211_tdls_oper_request(9). Direct link vibes, no middleman. - bitrate math β
cfg80211_calculate_bitrate(9). It's in the name, bestie, and the name ate. - device reg/unreg trio β
cfg80211_unregister_wdev(9),cfg80211_register_netdevice(9),cfg80211_unregister_netdevice(9). In, out, in, out β the classic. - fast transition squad β
struct cfg80211_ft_event_params(9),cfg80211_ft_event(9). Fast transition, faster gossip. - P2P β
cfg80211_get_p2p_attr(9). Peer-to-peer, iconic behavior. - IE splitting & fragmenting β
ieee80211_ie_split_ric(9),ieee80211_ie_split(9),ieee80211_fragment_element(9). Chopping information elements into cute lil pieces π - wakeup call β
cfg80211_report_wowlan_wakeup(9). WoWLAN said wake up bestie, it's important. - critical protocol β
cfg80211_crit_proto_stopped(9). Critical protocol said we're done here. - channel counting β
ieee80211_get_num_supported_channels(9). One, two, threeβ¦ okay no cap, it counts for you. - combination checking β
cfg80211_check_combinations(9),cfg80211_iter_combinations(9). Checking, then iterating β the two-step every algorithm does at 3am π - radio index β
cfg80211_get_radio_idx_by_chan(9). Which radio, which channel, main character detective energy π - the shutdown girlies β
cfg80211_stop_link(9),cfg80211_stop_iface(9),cfg80211_shutdown_all_interfaces(9). Escalating from "hmm" to "everything must go" fr fr. - extended features β
wiphy_ext_feature_set(9),wiphy_ext_feature_isset(9). Set it, then check if it's set. The eternal cycle. - NAN, the whole crew β
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_next_nan_dw_notif(9),cfg80211_nan_cluster_joined(9),cfg80211_nan_ulw_update(9),cfg80211_nan_channel_evac(9). That's nine NAN references, ngl that's a whole friend group and they all showed up to the party π«Ά - external auth β
cfg80211_external_auth_request(9). Auth, but make it external. - PMSR pair β
cfg80211_pmsr_report(9),cfg80211_pmsr_complete(9). Report it, complete it, periodt. - iftype permission slip β
cfg80211_iftype_allowed(9). Is it allowed? That's the whole question. - assoc comeback β
cfg80211_assoc_comeback(9). The association said "brb" and then actually came back π - OUR GIRL β
cfg80211_update_owe_info_event(9). The event counterpart. Obviously. Hi bestie π - BSS flush β
cfg80211_bss_flush(9). Down the drain, beautifully. - the colour-change cinematic universe β
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). Started, aborted, collided, notified β that's a whole five-act play π - 6GHz power β
cfg80211_6ghz_power_type(9). Six gigahertz of pure power, highkey. - links removed β
cfg80211_links_removed(9). Link left the chat π - MLO reconfig β
struct cfg80211_mlo_reconf_done_data(9),cfg80211_mlo_reconf_add_done(9). Multi-link operation reconfig, done and done. - channels check scheduling β
cfg80211_schedule_channels_check(9). Put it on the calendar, bestie. - EPCS β
cfg80211_epcs_changed(9). Something changed. That's the tea. - debugfs duo β
wiphy_locked_debugfs_read(9),wiphy_locked_debugfs_write(9). Locked, read, write β debugfs but make it exclusive π - S1G trio β
cfg80211_s1g_get_start_freq_khz(9),cfg80211_s1g_get_end_freq_khz(9),cfg80211_s1g_get_primary_sibling(9). Start, end, and the primary sibling β a whole family πΈ - incumbent signal β
cfg80211_incumbent_signal_notify(9). Notify the incumbent. Respectfully. π
and that's the whole roster, bestie β sixty-four cross-references and not one of them skipped, because we do not leave people out of the list π
okay tiny housekeeping note: the version of this page lives in ./include/net, and it's dated October 2026 β so if you're reading this from the future, hi, hope the WiFi is slaying β¨
that's the page! go forth and cfg80211 responsibly, and remember: the vibe check is mandatory but the details are sacred π§ββοΈπ
π¦ 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