cfg80211_chandef_dfs_usable(9)
π cfg80211_chandef_dfs_usable(9)
okay so bestie, welcome to the Kernel API Manual β¨ β this one's a little function with a big job and honestly? it's giving gatekeeper energy. let's get into it π
β¨ NAME β¨
cfg80211_chandef_dfs_usable β checks if chandef is DFS usable and we can/need start CAC on such channel π¦
like, it's literally the vibe check for whether a channel definition is DFS-usable and whether we can or need to start CAC on that channel, iykyk π
πΈ SYNOPSIS πΈ
bool cfg80211_chandef_dfs_usable (struct wiphy *wiphy , const struct
cfg80211_chan_def *chandef );
returns a bool, takes two pointers, no cap π«Ά
π ARGUMENTS π
wiphyβ the wiphy to validate against π₯ like, this is the thing we're checking everything against, the main character, the reference pointchandefβ the channel definition to check π the actual channel sitch you're asking about
β RETURN β
true if all channels available and at least one channel requires CAC (NL80211_DFS_USABLE) πβ¨
so like β all channels gotta be available, and at least one of them has to require CAC. both. together. that's the combo that gets you a true, periodt π
careful bestie: it's not true for just anything β the all-channels-available part AND the at-least-one-requires-CAC part both have to be true. that's literally the whole point of the function π
that's part 1, more incoming π
β¨ SEE ALSO β¨
okay bestie, so this is the part where the page shows you everyone else in the friend group π
and no, I'm not gonna skip any of them, because there are literally like 359 of these and each one is a real cross-reference you might actually need. every single name below is written exactly how it appears, (9) and all β that's just how these are spelled here, don't come for me π«Ά
the header itself lives at Kernel file ./include/net/cfg80211.h, and the soft intro pages are Introduction(9) and Device registration(9) β start there if you're brand new, no cap.
π the channel / band / rate besties
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)
yes, _ieee80211_set_sband_iftype_data(9) really does have that little underscore in front. it's not a typo, it's just the shy one π
πΈ actions & configuration era
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)
π the whole chandef cinematic universe
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_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)
like, that's the family this page belongs to fr fr β you literally saw cfg80211_chandef_usable(9) up in the synopsis and now here's all its siblings π
π¦ survey, AP, beacons & friends
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, rates & stats
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
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 & BSS list handling (a whole moment)
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 & connect structs
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)
π patterns, wowlan, coalesce & qos
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 (Neighbor Awareness Networking) corner
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
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 & combinations
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)
π the wiphy lifecycle & locking girlies
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)
π wireless_dev trio
struct wireless_dev(9),wdev_priv(9),wdev_chandef(9)
β¨ utility functions (the glow-up section)
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 & element finders
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
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 informing & refcounting
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_get_bss(9) has two underscores up front, and yes that means it's the lowkey internal one, respect the naming convention π
π₯ mlme notifications & failures
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, 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)
β connect / roam / disconnect results
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)
π«Ά station add/del & tid stats
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)
π the notify-everyone section (cqm, radar, cac & co.)
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 that's literally where this part stops β the list just keeps going in the next chunk, so don't go anywhere π§ββοΈ
...and the list just keeps going, bestie. Like genuinely, the see-also section here is doing the absolute most π so here's the whole rest of the crew, in order, no skips:
cfg80211_reg_check_beaconing(9)β checking if beaconing is even allowed, the pre-flight vibe check π¦cfg80211_reg_can_beacon(9)β the classic "can I beacon here" questioncfg80211_reg_can_beacon_relax(9)β same question, but with the rules loosened a lil bitcfg80211_ch_switch_notify(9)β channel switch went through, tell everyonecfg80211_ch_switch_started_notify(9)β channel switch just started, also tell everyoneieee80211_operating_class_to_band(9)β operating class in, band outieee80211_operating_class_to_chandef(9)β operating class in, channel definition outieee80211_chandef_to_operating_class(9)β the reverse, obviouslyieee80211_chandef_to_khz(9)β channel definition, but make it kilohertz β¨cfg80211_tdls_oper_request(9)β TDLS operation requests, very niche, very iconiccfg80211_calculate_bitrate(9)β math time, let's compute a bitratecfg80211_unregister_wdev(9)β yeeting a wireless device registrationcfg80211_register_netdevice(9)β registering a netdevice insteadcfg80211_unregister_netdevice(9)β and un-registering it, the circle of life π«Άstruct cfg80211_ft_event_params(9)β the struct holding FT event paramscfg80211_ft_event(9)β the fast-transition event itselfcfg80211_get_p2p_attr(9)β grabbing a P2P attributeieee80211_ie_split_ric(9)β splitting information elements with RIC handlingieee80211_ie_split(9)β splitting IEs, no RIC dramaieee80211_fragment_element(9)β chopping an element into fragments π₯cfg80211_report_wowlan_wakeup(9)β WoWLAN woke up, here's the reportcfg80211_crit_proto_stopped(9)β critical protocol just said byeieee80211_get_num_supported_channels(9)β how many channels we got, counting timecfg80211_check_combinations(9)β checking if your channel/interface combo even workscfg80211_iter_combinations(9)β iterating over all the comboscfg80211_get_radio_idx_by_chan(9)β which radio owns this channel, enquiring mindscfg80211_stop_link(9)β stopping a single linkcfg80211_stop_iface(9)β stopping the whole interfacecfg80211_shutdown_all_interfaces(9)β stopping everything, nuclear option πwiphy_ext_feature_set(9)β setting an extended wiphy feature bitwiphy_ext_feature_isset(9)β asking if that bit is setcfg80211_free_nan_func(9)β freeing a NAN function, clean up after yourselfstruct cfg80211_nan_match_params(9)β the struct for NAN match paramscfg80211_nan_match(9)β NAN match happenedcfg80211_nan_func_terminated(9)β NAN function is donecfg80211_nan_sched_update_done(9)β NAN schedule update finishedcfg80211_external_auth_request(9)β external auth, please advisecfg80211_pmsr_report(9)β PMSR measurement report incomingcfg80211_pmsr_complete(9)β PMSR run is completecfg80211_iftype_allowed(9)β is this interface type even permittedcfg80211_assoc_comeback(9)β the assoc comeback timer situationcfg80211_update_owe_info_event(9)β OWE info event, pushing updatescfg80211_bss_flush(9)β flushing the BSS list, out with the oldcfg80211_bss_color_notify(9)β BSS color notificationcfg80211_obss_color_collision_notify(9)β oop, OBSS color collision, notify the world πcfg80211_color_change_started_notify(9)β color change startedcfg80211_color_change_aborted_notify(9)β color change aborted, we don't talk about itcfg80211_color_change_notify(9)β color change, done and dustedcfg80211_6ghz_power_type(9)β 6 GHz power type stuff, very new-schoolcfg80211_links_removed(9)β links got removedstruct cfg80211_mlo_reconf_done_data(9)β the struct for MLO reconfig done datacfg80211_mlo_reconf_add_done(9)β MLO reconfig add finishedcfg80211_schedule_channels_check(9)β scheduling a channels checkcfg80211_epcs_changed(9)β EPCS changed, noting itcfg80211_next_nan_dw_notif(9)β next NAN discovery window notificationcfg80211_nan_cluster_joined(9)β you joined a NAN cluster, slaycfg80211_nan_ulw_update(9)β NAN ULW updatecfg80211_nan_channel_evac(9)β NAN channel evacuation, everybody out πββοΈwiphy_locked_debugfs_read(9)β debugfs read while holding the wiphy lockwiphy_locked_debugfs_write(9)β and the write counterpartcfg80211_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)β the S1G primary sibling, as one doescfg80211_incumbent_signal_notify(9)β incumbent signal spotted, notify the appropriate people π‘
okay that's literally the whole page, bestie, we made it π Take a sip of water, you've earned it.
This one's shipped straight out of ./include/net, dated October 2026, and it's the cfg80211_chandef_dfs_usable(9) page β go forth and check those DFS channel definitions responsibly, iykyk π
π¦ 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