regulatory_h...found_beacon(9)

💖 regulatory_hint_found_beacon(9) 💖

okay so real talk, this is from the Kernel API Manual and it's genuinely one of the more lowkey iconic little helpers in the wireless regulatory world. sit down bestie, we're learning about beacon hints 🎀

---

✨ NAME ✨

regulatory_hint_found_beacon — literally just hints that a beacon was found on a channel 💅

---

🌸 SYNOPSIS 🌸

void regulatory_hint_found_beacon (struct wiphy *wiphy , struct
ieee80211_channel *beacon_chan , gfp_t gfp );

---

🦋 ARGUMENTS 🦋

• wiphy — the wireless device where the beacon was found on 🫶
• beacon_chan — the channel on which the beacon was found on ✨
• gfp — context flags, yep that's it, that's the whole vibe

---

🔥 DESCRIPTION 🔥

okay so what this does: it informs the wireless core that a beacon from an AP was found on the channel you provided. that's the whole thing. very demure, very mindful. the wireless core then gets to make educated guesses on regulatory stuff to help with world roaming 🌈

and listen — this is only used for world roaming. like, when we do not know our current location. if you know where you are, this is not your moment, bestie 😭

it's also only useful on channels 12, 13 and 14 on the 2 GHz band — because channels 1-11 are already enabled by the world regulatory domain, so like, no notes there — and on non-radar 5 GHz channels 🦋

💀 heads up: drivers do not need to call this. cfg80211 will do it for after a scan on a newly found BSS. it's already handling it, you can chill.

and if you genuinely cannot make use of this feature? no stress, just set the wiphy->disable_beacon_hints to true and move on with your life 🙈

---

👑 SEE ALSO 👑

Kernel file ./net/wireless/reg.h, plus the whole friend group: regulatory_hint_indoor(9), regulatory_netlink_notify(9), regulatory_hint_country_ie(9), regulatory_hint_disconnect(9), cfg80211_get_unii(9), regulatory_indoor_allowed(9), regulatory_propagate_dfs_state(9), reg_dfs_domain_same(9), reg_reload_regdb(9), reg_check_channels(9), reg_leave_invalid_chans_wk(9), reg_leave_invalid_nan_wk(9) ✨

---

that's the page bestie, go forth and hint those beacons responsibly 🧚💜

— xoxo, sourced from ./net/wireless, dated October 2026, still serving regulatory_h...found_beacon(9) realness ⭐💅