ieee80211_g...tunnel_proto(9)
π ieee80211_get_8023_tunnel_proto β from the Kernel API Manual, bestie π
okay so bestie, welcome to page one of three β grab a strawberry drink π, we're reading a kernel manpage together and honestly? it's a short one, you're gonna slay this.
β¨ NAME β¨
ieee80211_get_8023_tunnel_proto β literally just "get the RFC1042 or bridge tunnel encap protocol". that's the whole vibe. it goes digging in a packet and pulls out the protocol that's hiding inside the tunnel header π
πΈ SYNOPSIS πΈ
bool ieee80211_get_8023_tunnel_proto(const void *hdr, __be16 *proto);
π¦ ARGUMENTS π¦
hdrβ pointer to the MSDU payload. yeah. that's the thing you're inspecting. it's aconst void *so like, we're looking, not touching πprotoβ destination pointer where the protocol gets stored. you hand it over, it fills it in. main character output parameter energy π
π DESCRIPTION π
so what does it actually do? it checks for an RFC1042 or bridge tunnel header, and if one's there, it fetches the encapsulated protocol out of it. that's it. that's the whole function. lowkey iconic for being that straightforward ngl β¨
π₯ RETURN π₯
returns true if encapsulation was found. if it wasn't found β well, it's not true, iykyk π
okay that's part one, don't go anywhere, more is coming π«Ά
β¨ SEE ALSO β¨
okay so here's the moment where this manpage just unleashes the entire friend group at you π
and honestly? iconic behaviour. literally everything below lives in the kernel file ./include/net/cfg80211.h, and every single one of these has its own (9) page waiting for you to slide into its DMs:
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).
that whole first wave? capability-coded π¦ it's giving "i know my own bands and rates and i'm not sorry".
next up, the configuration girlies β Actions and configuration(9) and her whole entourage of structs and chandef helpers π
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).
not the chandef cinematic universe π so many of them, but every single one matters, slay.
then the survey + crypto + beacon crowd, no skipping:
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).
bestie if you're reading this whole list out loud, hydrate first π§ that's a lot of station info.
okay now pull up a chair because Scanning and BSS list handling(9) brought the whole squad π
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).
a whole scan request AND a scheduled scan request? she contains multitudes β¨
and then β Neighbor Awareness Networking (NAN)(9) π the moment we've all been waiting for, the NAN crew:
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 cfg80211_ops(9) in there carrying the entire driver API on her back, no cap π
now the wiphy-adjacent icons, aka the device registration hall of fame π§
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).
the way that queue / cancel / flush trio repeats three whole timesβ¦ consistency is her love language π«Ά
Utility functions(9) β the little helpers who have your back πΈ
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).
channel β frequency conversions in both directions, we love a function who does the round trip π
Data path helpers(9) coming through with the actual packets π¦
ieee80211_data_to_8023_exthdr(9), ieee80211_data_to_8023(9), ieee80211_is_valid_amsdu(9), ieee80211_amsdu_to_8023s(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 _elem / _ie pairs are literally twins, one for elements and one for IEs, and yes you need both, iykyk β¨
Regulatory enforcement infrastructure(9) π aka the vibes police:
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), plus Internal regulatory db functions(9) and reg_query_regdb_wmm(9).
they decide if you're allowed to transmit. do not upset them. fr fr π
back to the notifications crew, all in the original order, mwah:
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).
cfg80211_ref_bss(9) and cfg80211_put_bss(9) β the classic ref/put duo, they go together like π and cream, and yes the __ underscore version of __cfg80211_get_bss(9) is a separate page, bestie, don't @ me π
RFkill integration(9) gets her own little moment π‘:
wiphy_rfkill_set_hw_state_reason(9), wiphy_rfkill_start_polling(9), wiphy_rfkill_stop_polling(9).
then Vendor commands(9) rolls in with the custom stuff, and Test mode(9) right behind her:
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), cfg80211_testmode_alloc_reply_skb(9), cfg80211_testmode_reply(9), cfg80211_testmode_alloc_event_skb(9), cfg80211_testmode_event(9).
alloc β reply, alloc β event, both flavors, one pattern: skb goes in, notification comes out π
and here's the notifications-and-events final stretch, every last one of them, because we do not skip π:
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)
hotpink>and that's the reference list, bestie π₯ every last one of them, in order, nothing dropped, nothing merged β but hold up, don't close this tab yet π
Okay so the rest of the SEE ALSO list is basically the whole extended friend group, and honestly? Every single one of them is iconic in their own way π«Ά let's get into it.
the regulatory girlies (beaconing rights & vibe checks) π
cfg80211_reg_check_beaconing(9)β checks whether you're even allowed to beacon, no capcfg80211_reg_can_beacon(9)β can you beacon? asking for regulatory reasonscfg80211_reg_can_beacon_relax(9)β same question but the relaxed version, living a littlecfg80211_ch_switch_notify(9)β channel switch happened, tell everyonecfg80211_ch_switch_started_notify(9)β channel switch is starting, tell everyone sooner
channel β band β chandef conversion station π
ieee80211_operating_class_to_band(9)β operating class in, band outieee80211_operating_class_to_chandef(9)β operating class in, chandef outieee80211_chandef_to_operating_class(9)β the reverse slayieee80211_chandef_to_khz(9)β chandef to kHz, math girlie behaviour
misc core-crowd faves β¨
cfg80211_tdls_oper_request(9)β TDLS operation request incomingcfg80211_calculate_bitrate(9)β does the bitrate math for you, king behaviourcfg80211_unregister_wdev(9)β bye-bye wireless devicecfg80211_register_netdevice(9)β hi hi netdevicecfg80211_unregister_netdevice(9)β and hi hi to saying goodbyestruct cfg80211_ft_event_params(9)β the struct that holds your FT event params πcfg80211_ft_event(9)β the FT event itselfcfg80211_get_p2p_attr(9)β grab a P2P attributeieee80211_ie_split_ric(9)β splits IEs, RIC editionieee80211_ie_split(9)β splits IEs, plain editionieee80211_fragment_element(9)β fragments an element, as one does
sleepy-time & crit-proto π΄
cfg80211_report_wowlan_wakeup(9)β reporting WoWLAN wakeups (yes it woke up, ugh)cfg80211_crit_proto_stopped(9)β critical protocol has stopped
channels, combinations, radio index π»
ieee80211_get_num_supported_channels(9)β how many channels do you support, bestiecfg80211_check_combinations(9)β checks your combinations, very thoroughcfg80211_iter_combinations(9)β iterates them, also thoroughcfg80211_get_radio_idx_by_chan(9)β find the radio index by channel
the stopping squad β
cfg80211_stop_link(9)β stop that linkcfg80211_stop_iface(9)β stop that ifacecfg80211_shutdown_all_interfaces(9)β stop all the ifaces, dramatic but valid π
feature flags π©
wiphy_ext_feature_set(9)β set an extended featurewiphy_ext_feature_isset(9)β check if one's set
NAN, part one (the first batch) π¦
cfg80211_free_nan_func(9)β free your NAN functionstruct cfg80211_nan_match_params(9)β struct for NAN match paramscfg80211_nan_match(9)β you got a NAN matchcfg80211_nan_func_terminated(9)β your NAN function endedcfg80211_nan_sched_update_done(9)β NAN schedule update is done, phew
auth, pmsr & assoc-comeback era π₯
cfg80211_external_auth_request(9)β external auth request, go handle itcfg80211_pmsr_report(9)β PMSR reportcfg80211_pmsr_complete(9)β PMSR completecfg80211_iftype_allowed(9)β is this iftype even allowedcfg80211_assoc_comeback(9)β the assoc comeback, literally the namecfg80211_update_owe_info_event(9)β OWE info update event
BSS flush & the whole colour-change cinematic universe π
cfg80211_bss_flush(9)β flush those BSSescfg80211_bss_color_notify(9)β BSS colour notificationcfg80211_obss_color_collision_notify(9)β OBSS colour collision, notifying about itcfg80211_color_change_started_notify(9)β colour change startedcfg80211_color_change_aborted_notify(9)β colour change aborted πcfg80211_color_change_notify(9)β colour change happenedcfg80211_6ghz_power_type(9)β 6 GHz power type, very current
MLO & links π
cfg80211_links_removed(9)β links got removedstruct cfg80211_mlo_reconf_done_data(9)β struct holding MLO reconf done datacfg80211_mlo_reconf_add_done(9)β MLO reconf add is donecfg80211_schedule_channels_check(9)β schedule a channels checkcfg80211_epcs_changed(9)β EPCS changed
NAN, part two (the sequel) π§
cfg80211_next_nan_dw_notif(9)β next NAN DW notificationcfg80211_nan_cluster_joined(9)β you joined a NAN cluster πcfg80211_nan_ulw_update(9)β NAN ULW updatecfg80211_nan_channel_evac(9)β NAN channel evacuation, everyone out
debugfs duo π
wiphy_locked_debugfs_read(9)β locked debugfs readwiphy_locked_debugfs_write(9)β locked debugfs write
S1G squad πΈ
cfg80211_s1g_get_start_freq_khz(9)β S1G start frequency in kHzcfg80211_s1g_get_end_freq_khz(9)β S1G end frequency in kHzcfg80211_s1g_get_primary_sibling(9)β get the primary sibling
and the final boss π
cfg80211_incumbent_signal_notify(9)β incumbent signal, notify about it
aaaand that's the whole friend group accounted for, not a single one left behind π this page lives in ./include/net, dated October 2026 (so she's from the future, respectfully), and the manual page you just read is ieee80211_g...tunnel_proto(9). go forth and tunnel, bestie π«Άβ¨
π¦ 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