e1000e_read_phy_reg_bm(9)

📦 version 7.3.1, in nixpkgs unstable

💅 e1000e_read_phy_reg_bm — from the Kernel API Manual, bestie edition ✨

okay so you opened the Kernel API Manual page for e1000e_read_phy_reg_bm and it's giving "dry technical document" energy, but don't worry, I'm gonna translate it for you 🫶

✨ NAME ✨

e1000e_read_phy_reg_bm — literally just "Read BM PHY register" 🎀 that's the whole vibe, no cap.

🌸 SYNOPSIS 🌸

s32 e1000e_read_phy_reg_bm (struct e1000_hw *hw , u32 offset , u16 *data
);

look at that signature. she's iconic. she returns an s32, she takes your hw, your offset, your data pointer, and she gets stuff done 💅

🦋 ARGUMENTS 🦋

  • hw — pointer to the HW structure ✨ your hardware's little passport, basically. everything starts here.
  • offset — register offset to be read 📍 the exact spot in PHY-land you're trying to peek at.
  • data — pointer to the read data 🍓 this is where the good stuff lands. it's a pointer, so like... it's writing through it, iykyk.

💖 DESCRIPTION 💖

so here's the tea: this function acquires the semaphore, if necessary, then reads the PHY register at offset and stores the retrieved information in data. 🔥

and then — and this is the respectful part — it releases any acquired semaphores before exiting. periodt. no lock left behind, no drama, main character energy but make it polite 💜

fr fr though, if you were worried about leaked semaphores: she cleans up before she leaves. that's the whole point. 🧚

👑 SEE ALSO 👑

first up, the source file, because we love a primary source:

  • Kernel file ./drivers/net/ethernet/intel/e1000e/phy.c 📁

and now... the friend group. the whole squad. every single one. I'm not skipping a single bestie, that would be disrespectful 🙈

like, that's the whole roster. imagine being in that group chat. 💀 anyway, all of them are family, go read their pages too 🌈

and that's the page!! 🎀 source/version situation is ./drivers/net/ethernet/intel/e... and the date on the tin says October 2026, so yeah — bookmark it, cite it, love it. slay 💅✨

📦 where this page comes from