stmmac_dvr_probe(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… stmmac_dvr_probe(9) β€” a Kernel API Manual moment ✨

okay so this is a page from the Kernel API Manual (that's the manual name, bestie, keep it in your notes πŸŽ€) and today's main character is stmmac_dvr_probe. she's the probe function for the stmmac ethernet driver and honestly she does a lot of heavy lifting behind the scenes 🌸


✨ NAME ✨

stmmac_dvr_probe β€”

not me leaving the description blank 😭 nope, that's literally how it comes. no tagline, no summary, just the name and a dash. mysterious. iconic. the manpage said "figure it out."

πŸ¦‹ SYNOPSIS πŸ¦‹

int stmmac_dvr_probe (struct device *dev , struct plat_stmmacenet_data
*plat_dat , struct stmmac_resources *res );

she takes three pointers and hands you back an int. that's the whole vibe check πŸ’«


πŸ“ ARGUMENTS πŸ“

  • dev β€” device pointer. the device's little handle, bestie 🫢
  • plat_dat β€” platform data pointer. struct plat_stmmacenet_data *, so the platform bits live in here ✨
  • res β€” stmmac resource pointer. struct stmmac_resources *, the resources get passed in through this one πŸŽ€

πŸ’– DESCRIPTION πŸ’–

so basically 🌟 this is the main probe function, and here's the tea: it's the one that calls alloc_etherdev and allocates the priv structure. that's the assignment. that's what she does. no cap. πŸ’…

like, when the driver gets probed, this is the function that shows up first with her clipboard, gets the ethernet device allocated via alloc_etherdev, and gets the private (priv) structure set up too. main character energy fr fr πŸ‘‘


🌈 RETURN 🌈

  • returns 0 on success πŸŽ‰
  • otherwise, it returns an errno πŸ’€

so like, 0 = slay, anything else = check your errno and go cry about it (affectionately) 😭


πŸ”₯ SEE ALSO πŸ”₯

first up, the actual kernel file where all this lives:

Kernel file ./drivers/net/ethernet/stmicro/stmmac/stmmac_main.c

and now the extended universe β€” grab a snack, this is a long one πŸ“βœ¨ every single one of these is (9) iykyk:

lowkey that's 80 functions. she has a lot of friends. i'm not jealous. i'm taking notes πŸ§šπŸ’œ

okay that's the page!! πŸŽ€ and per the footer, this beauty comes from ./drivers/net/ethernet/stmicro... (yes the path is literally truncated in the source, don't come for me πŸ™ˆ) and it's dated October 2026 ⭐ so mark your calendars, bestie β€” this probe function is out here living her best life in the stmmac_dvr_probe(9) era πŸ’…βœ¨πŸ’–

πŸ“¦ where this page comes from