ieee80211_fi...y_link_addrs(9)

📦 version 7.3.1, in nixpkgs unstable

💅 NAME 💅

okay so bestie, the vibe of this whole page is ieee80211_find_sta_by_link_addrs — literally it's the "find STA by link addresses" girlie ✨. That's it, that's the whole name section, we move.

✨ SYNOPSIS ✨

here's the signature, don't touch it, it's iconic exactly as it is:

struct ieee80211_sta * ieee80211_find_sta_by_link_addrs (struct
       ieee80211_hw *hw , const u8 *addr , const u8 *localaddr , unsigned int
       *link_id );

🎀 ARGUMENTS 🎀

so like, four things go in, bestie, and they all matter:

  • hw — pointer as obtained from ieee80211_alloc_hw. yeah. that one. you already have it, don't act brand new 🫶
  • addr — the remote station's link address. like, THE station you're hunting for, its link addr, periodt.
  • localaddr — the local link address. lowkey you can pass NULL for any, but the manpage says avoid that 🙈 so, like, maybe don't.
  • link_id — pointer to obtain the link ID if the STA is found. may be NULL if the link ID is not needed. no thoughts head empty, just pass NULL, it's fine 💅

🦋 DESCRIPTION 🦋

okay so the actual bit: you obtain the STA by link address. that's the whole errand. must use RCU protection. must. like not optional, not "when you feel like it" — RCU protection or it's giving undefined chaos 😭 this is a caveat, bestie, respect the caveat.

⭐ RETURN ⭐

pointer to STA if found, otherwise NULL. that's the tea. found = pointer, not found = NULL, and you have to check it, please, for me 🎀

🌈 SEE ALSO 🌈

okay so this is the part where the manpage just names the entire extended friend group, and I'm not skipping a single one because every single one of them is on the list ✨ the home base is the Kernel file ./include/net/mac80211.h, and then, in this order, no cap:

like I said — the whole group chat. nobody left on read 💜

and that's the page, bestie!! 🦋✨ this one lives in ./include/net, dated October 2026, and it's from the Kernel API Manual — go forth and find your STA (with RCU protection, obviously) 💖🎀

📦 where this page comes from