__wx_ptp_detach_tx_skb(9)

📦 version 7.3.1, in nixpkgs unstable

💅 NAME 💅

ok so like, __wx_ptp_detach_tx_skb — it detaches the skb that's tracking the Tx timestamp request 🎀 that's the whole vibe, that's the mission, no cap

(this is a page from the Kernel API Manual, bestie — welcome to the kernel girlies club 👑)

✨ SYNOPSIS ✨

struct sk_buff * __wx_ptp_detach_tx_skb (struct wx *wx );

🌸 ARGUMENTS 🌸

  • wx — the private board structure 💖 like, the board's whole personality in one struct, yk?

🦋 DESCRIPTION 🦋

okay so bestie, here's the tea ☕ — this function detaches the skb of the outstanding request, and then it releases the in-progress bit. why? so that a new request can be submitted, periodt ✨ it's literally just clearing the way for the next one.

and here's the important part, ngl: this performs no register access. like, zero. none. not a single poke at the hardware 🙈

so if you're a caller and you need a timestamp that the hardware may have left latched, you gotta unlatch it yourself — and you gotta do it while the device is known to be alive. that's on you, not on this function, iykyk 💅

and speaking of which — wx_ptp_quiesce runs during PCIe error recovery, where MMIO is not reliable, so it deliberately skips the unlatch. not a bug, it's a choice, and honestly? iconic behaviour 🧚

🔥 CONTEXT 🔥

expects wx->ptp_tx_lock to be held by the caller 🫶 like, hold the lock, bestie. that's the whole thing. that's the vibe check.

⭐ RETURN ⭐

it returns the detached skb 🎀 or NULL if no request was outstanding — so like, if nothing was happening, you get nothing back, which is fair fr fr.

and heads up: the caller owns the returned reference and must release it once the lock is dropped 💀 don't just walk away with it, that's not the move.

🌈 SEE ALSO 🌈

the kernel file lives at ./drivers/net/ethernet/wangxun/libwx/wx_ptp.c — go read it, it's giving main character energy 📖

and the whole friend group, in no particular order:

💖 and that's the page, bestie! from ./drivers/net/ethernet/wangxun..., dated October 2026, and yes it's still __wx_ptp_detach_tx_skb(9) — slay 🌸✨🦋🎀
📦 where this page comes from