ieee802154_alloc_hw(9)

✨ ieee802154_alloc_hw(9) ✨

okay bestie, welcome to the Kernel API Manual — this is the page for ieee802154_alloc_hw(9) and it's genuinely the moment your driver's whole life begins 🎀

---

🌸 NAME 🌸

ieee802154_alloc_hw — allocate a new hardware device. yes, the actual birthing of the device. main character energy from line one 👑

---

🦋 SYNOPSIS 🦋

struct ieee802154_hw * ieee802154_alloc_hw (size_t priv_data_len , const
struct ieee802154_ops *ops );

like, that's the whole call. two args, one pointer back at you, slay 💅

---

💖 ARGUMENTS 💖

• priv_data_len — the length of the private data. how much room your driver gets to stash its own little vibe corner ✨
• ops — the callbacks for this device. all the things this device can do, handed over as one struct 🫶

---

🧚 DESCRIPTION 🧚

okay so listen closely: this must be called once for each hardware device. once per device, no cap. 🚨

the returned pointer? that's your new bestie. you must use that pointer to refer to this device whenever you call other functions — don't be out here losing track of it, that's not the move 🙈

and here's the cute part: mac802154 allocates a private data area for the driver, and that area is pointed to by priv in struct ieee802154_hw. the size of this area is exactly what you passed as priv_data_len. so like, tell it how much you need and it sets you up 💅

---

🌈 RETURN 🌈

a pointer to the new hardware device 💖 … or NULL on error 😭 (and yes, you gotta check for that, bestie, it's giving "handle your errors")

---

⭐ SEE ALSO ⭐

• Kernel file ./include/net/mac802154.h enum
• ieee802154_hw_addr_filt_flags(9)
• struct ieee802154_hw_addr_filt(9)
• struct ieee802154_hw(9)
• enum ieee802154_hw_flags(9)
• ieee802154_get_fc_from_skb(9)
• ieee802154_skb_dst_pan(9)
• ieee802154_skb_src_pan(9)
• ieee802154_skb_is_intra_pan_addressing(9)
• ieee802154_be64_to_le64(9)
• ieee802154_le64_to_be64(9)
• ieee802154_le16_to_be16(9)
• ieee802154_be16_to_le16(9)
• ieee802154_free_hw(9)
• ieee802154_register_hw(9)
• ieee802154_unregister_hw(9)
• ieee802154_rx_irqsafe(9)
• ieee802154_xmit_complete(9)
• ieee802154_xmit_error(9)
• ieee802154_xmit_hw_error(9)

---

and that's the page, bestie!! go forth and allocate 💜

this lil masterpiece lives in ./include/net and it's dated October 2026 — and the source/version line was right there next to ieee802154_alloc_hw(9) the whole time, periodt. see you in the group chat 🫶✨