gnet_stats_copy_basic_hw(9)

📦 version 7.3.1, in nixpkgs unstable

💅 gnet_stats_copy_basic_hw(9) — the Kernel API Manual bestie era ✨

okay so this is a page from the Kernel API Manual, and honestly? it's a little function that does one job and does it well. no cap. let's get into it 🫶

🌸 NAME 🌸

gnet_stats_copy_basic_hw — copy basic hw statistics into statistic TLV

like, that's literally the whole vibe: it takes your basic hardware stats and copies them into the statistic TLV. iconic behavior 🎀

✨ SYNOPSIS ✨

int gnet_stats_copy_basic_hw (struct gnet_dump *d , const struct
gnet_stats_basic_sync __percpu *cpu , const struct gnet_stats_basic_sync
*b , bool running );

look at her go 😭 four arguments, one int return, zero notes. she's booked and busy.

🦋 ARGUMENTS 🦋

  • d — the dumping handle. your main character for this whole operation 💅
  • cpu — copy statistic per cpu. yes, per cpu, we're being thorough 🔥
  • b — the basic statistics themselves. the actual lore ✨
  • running — true if b represents a running qdisc, thus b's internal values might change during basic reads. only used if cpu is NULL ⚠️ like, don't forget that part, bestie
lowkey important: running gets ignored unless cpu is NULL. that's the whole rule. iykyk 🙈

🌈 CONTEXT 🌈

task; must not be run from IRQ or BH contexts 💀

fr fr — task context only. do not come at this from IRQ or BH contexts, it's not that kind of function, and honestly? respect the boundaries 👑

💖 DESCRIPTION 💖

Appends the basic statistics to the top level TLV created by gnet_stats_start_copy. 🧚

Returns 0 on success or -1 with the statistic lock released if the room in the socket buffer was not sufficient. 😭

so basically: it appends, it returns 0 when everything slays, and it returns -1 — and releases the statistic lock — when there just wasn't enough room in the socket buffer. not me crying over a socket buffer 💀 the lock release is a whole detail, don't skip it 🫶

⭐ SEE ALSO ⭐

Kernel file ./net/core/gen_stats.c — and the whole friend group of copy functions, all linked up:

the squad 💜 go read all of them, bestie, they all ate 🌸

🍓 sign-off 🍓

this absolute queen lives in ./net/core, and this page is stamped October 2026 — so yeah, she's from the future, and she's still serving 👑✨

stay hydrated, release your locks, and don't run this from IRQ context 💅🦋 bye bestie!

📦 where this page comes from