cfg80211_get_station(9)
π cfg80211_get_station β a Kernel API Manual moment
ok so bestie, welcome to the cfg80211_get_station(9) page π this is part of the Kernel API Manual, and bestie, it's giving "small function, big job" energy. Like yeah it's only four sections but every single one of them matters, no cap.
β¨ NAME β¨
cfg80211_get_station β retrieve information about a given station πΈ
Like, that's the whole vibe. You point at a station, it gives you the deets. Obsessed.
β¨ SYNOPSIS β¨
int cfg80211_get_station (struct net_device *dev , const u8 *mac_addr ,
struct station_info *sinfo );
Look at that signature, it ate π three arguments, one int coming back. Nothing extra, nothing missing. Iconic.
β¨ ARGUMENTS β¨
devβ the device where the station is supposed to be connected to π like, that's the net_device we're working with, and yes "supposed to" is doing a lot of heavy lifting there, keep that in mind bestie.mac_addrβ the mac address of the station of interest π¦ you know, the one you're actually curious about.const u8 *, so like, don't go writing to it, it's not yours.sinfoβ pointer to the structure to fill with the information π that's thestruct station_info *, and it is literally the whole point of calling this function. It's the little empty vessel waiting to be filled with station lore.
β¨ RETURN β¨
so here's the vibe check on what comes back π₯
0on success β andsinfois filled with the available information β¨ slay, you got your data, go wild.- a negative error code otherwise β and here's the important part, bestie, don't skip this: the content of
sinfohas to be considered undefined π like genuinely do not touch it, do not read it, do not assume it's empty or zeroed or anything. It's undefined. Periodt.
π«Ά fr fr though β if you get a negative error code back, that sinfo is not your friend. Treat it like it doesn't exist. That's the rule, and it's not a cute little suggestion, it's the contract.
π SEE ALSO π
okay bestie, brace yourself β this is the link dump to end all link dumps. Every single thing below is a real page you can go read, and honestly? it's giving "the entire extended cinematic universe". grab a snack, we're going through all of it π
- the actual source, like where it all lives β kernel file
./include/net/cfg80211.h. that's the header. that's the mothership. everything down there belongs to this world πΈ - start here if you're new new β
Introduction(9),Device registration(9) - channels, rates & the basic vibes β
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 "how good is this BSS actually" era β
struct ieee80211_he_obss_pd(9),struct cfg80211_he_bss_color(9) - capability structs, aka the glow-up timeline (HT β VHT β HE β EHT β UHR) β
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)π₯ - bands & iftype data, the whole squad β
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) - getters & setters for that iftype data β
_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)(yes, the underscore one too, she's real, don't @ me) - device tree said what now β
wiphy_read_of_freq_limits(9) - the whole "doing stuff" chapter β
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) - chandef helpers, lowkey the backbone of everything β
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, beacons & AP config β
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) - station era β params, links, rates, stats, the full sitcom β
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, monitor, mesh, OCB, txq β the side quests β
struct cfg80211_sar_sub_specs(9),struct cfg80211_sar_specs(9),struct cfg80211_sar_freq_ranges(9),struct cfg80211_sar_capa(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 & BSS list handling, the whole arc β
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, deauth, and the whole "will they won't they" of connecting β
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) - power save / wowlan / coalesce / QoS energy β
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) - NAN, aka Neighbor Awareness Networking, aka the friend-finding protocol β
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, OWE, mgmt frame regs β
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) - the big one β ops, wiphy flags, iface combos, vendor cmds, radio configs β
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 lifecycle & work queues, the whole glow-up and glow-down β
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) - wireless_dev adjacent β
enum ieee80211_ap_reg_power(9),struct wireless_dev(9),wdev_priv(9),wdev_chandef(9) - Utility functions chapter β conversions, channels, rates, radiotap, header lengths β
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 β frames, A-MSDU, 802.3 tunneling, element hunting β
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, aka the vibes police β
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 stuff β
Internal regulatory db functions(9),reg_query_regdb_wmm(9) - scan done, BSS informing, MLME mgmt, the whole notification saga β
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, the "airplane mode said no" chapter β
RFkill integration(9),wiphy_rfkill_set_hw_state_reason(9),wiphy_rfkill_start_polling(9),wiphy_rfkill_stop_polling(9) - Vendor commands & Test mode β
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) - connect results, roaming, port authorization, TID stats, sta add/del β
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) - rx/tx mgmt, control port, CQM notifications & radar/CAC events β
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) - and the very last one, bestie, we made it β
struct cfg80211_beaconing_check_config(9)π
that's the entire link dump, no skips, no "oh that one's probably not important". every single page is here because the kernel does not do "optional reading" fr fr β but likeβ¦ if you actually read all of these, genuinely iconic of you π
β¦and the reading list keeps going, bestie, because this corner of the kernel genuinely has like a hundred little friends and they all want a shoutout π so here's the rest of the extended universe, one iconic cameo at a time:
cfg80211_reg_check_beaconing(9)β beaconing check, regulatory flavoured πΈcfg80211_reg_can_beacon(9)β the "can we beacon tho" question, answeredcfg80211_reg_can_beacon_relax(9)β same question, chiller energycfg80211_ch_switch_notify(9)β channel switch, but make it a notification π¦cfg80211_ch_switch_started_notify(9)β the "we've started, guys" versionieee80211_operating_class_to_band(9)β operating class β‘οΈ band, no capieee80211_operating_class_to_chandef(9)β operating class β‘οΈ chandefieee80211_chandef_to_operating_class(9)β and the reverse trip back π«ieee80211_chandef_to_khz(9)β chandef β‘οΈ kilohertz, math girlie behaviourcfg80211_tdls_oper_request(9)β TDLS operation request, very niche, very validcfg80211_calculate_bitrate(9)β the bitrate calculator, lowkey the MVP π₯cfg80211_unregister_wdev(9)β bye-bye, wireless devicecfg80211_register_netdevice(9)β hiii, netdevice πcfg80211_unregister_netdevice(9)β and hiii, goodbyestruct cfg80211_ft_event_params(9)β a struct! we love a struct β¨cfg80211_ft_event(9)β fast-transition event vibescfg80211_get_p2p_attr(9)β P2P attribute fetch, iykykieee80211_ie_split_ric(9)β IE splitting, the RIC remixieee80211_ie_split(9)β IE splitting, original flavourieee80211_fragment_element(9)β it fragments the element, periodtcfg80211_report_wowlan_wakeup(9)β wakeup reporting, WoWLAN edition πcfg80211_crit_proto_stopped(9)β critical protocol said "I'm out" πieee80211_get_num_supported_channels(9)β count those channels, bestiecfg80211_check_combinations(9)β combo checking π§cfg80211_iter_combinations(9)β combo iterating, the sequelcfg80211_get_radio_idx_by_chan(9)β channel β‘οΈ radio indexcfg80211_stop_link(9)β stop the link πcfg80211_stop_iface(9)β stop the interfacecfg80211_shutdown_all_interfaces(9)β all of them. every single one. πwiphy_ext_feature_set(9)β set that extended featurewiphy_ext_feature_isset(9)β β¦and check it after πcfg80211_free_nan_func(9)β free the NAN function, be responsiblestruct cfg80211_nan_match_params(9)β another struct bestie π«Άcfg80211_nan_match(9)β NAN match momentcfg80211_nan_func_terminated(9)β the NAN function has left the chatcfg80211_nan_sched_update_done(9)β schedule update: done βcfg80211_external_auth_request(9)β external auth, requestingcfg80211_pmsr_report(9)β PMSR report, very serious businesscfg80211_pmsr_complete(9)β PMSR complete, we're so backcfg80211_iftype_allowed(9)β is this iftype allowed? find outcfg80211_assoc_comeback(9)β assoc comeback, the plot twistcfg80211_update_owe_info_event(9)β OWE info update eventcfg80211_bss_flush(9)β flush those BSS entries πΏcfg80211_bss_color_notify(9)β BSS color, notified π¨cfg80211_obss_color_collision_notify(9)β color collision!! dramacfg80211_color_change_started_notify(9)β color change: startedcfg80211_color_change_aborted_notify(9)β color change: nvm, aborted π¬cfg80211_color_change_notify(9)β color change: the notificationcfg80211_6ghz_power_type(9)β 6 GHz power type, highkey fancycfg80211_links_removed(9)β the links are gone, girlstruct cfg80211_mlo_reconf_done_data(9)β the longest struct name ever, iconic πcfg80211_mlo_reconf_add_done(9)β MLO reconf add: donecfg80211_schedule_channels_check(9)β schedule the channel check, queencfg80211_epcs_changed(9)β EPCS changed, bestiecfg80211_next_nan_dw_notif(9)β next NAN DW notificationcfg80211_nan_cluster_joined(9)β joined the NAN cluster, we're in πcfg80211_nan_ulw_update(9)β NAN ULW updatecfg80211_nan_channel_evac(9)β NAN channel evacuation, everybody out πββοΈwiphy_locked_debugfs_read(9)β locked debugfs readwiphy_locked_debugfs_write(9)β locked debugfs write, its twincfg80211_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)β S1G primary sibling π§cfg80211_incumbent_signal_notify(9)β incumbent signal, notified, and we're done π
okay that's the whole squad, every single one accounted for, not a single name dropped π
and that's a wrap on cfg80211_get_station(9)! πsource: the lovely humans over in ./include/net, dated October 2026 β go drink some water, then go read your man pages, bestie. slay, stay curious, and don't forget to free your NAN functions π«Άβ¨
π¦ 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