ef4_nic_update_stats(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’– ef4_nic_update_stats β€” like, the manual page πŸ’–

okay so bestie, welcome to ef4_nic_update_stats(9), straight out of the Kernel API Manual ✨ this one's a little function with a big job, and honestly? she ate.


🌸 NAME 🌸

ef4_nic_update_stats β€” converts a statistics DMA buffer into an array of u64. that's it, that's the whole vibe. a glow-up from raw DMA bytes to actual numbers you can read πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

void ef4_nic_update_stats (const struct ef4_hw_stat_desc *desc , size_t
count , const unsigned long *mask , u64 *stats , const void *dma_buf ,
bool accumulate );

like, six whole arguments. she's high-maintenance but worth it, i promise 🫢


πŸŽ€ ARGUMENTS πŸŽ€

  • desc β€” an array of struct ef4_hw_stat_desc that describes how the DMA buffer is laid out. DMA widths of 0, 16, 32 and 64 are supported β€” and here's the slay detail: when the width is specified as 0, the corresponding element of stats is not updated. not me ghosting that element πŸ™ˆ
  • count β€” the length of the desc array. keep count, bestie πŸ“‹
  • mask β€” a bitmask of which elements of desc are enabled. think of it as the guest list β€” if you're not on it, you're not getting in πŸ’…
  • stats β€” the buffer you're updating with the converted statistics. the length of this array must be at least count β€” no cap, if it's shorter you're gonna have a bad time 😭
  • dma_buf β€” the DMA buffer containing the hardware statistics. the raw material, the unedited footage, the before pic 🎬
  • accumulate β€” if set, the converted values get added to the corresponding elements of stats rather than directly stored. it's giving "keep the receipts and stack them" πŸ”₯ if it's not set, it just overwrites. simple as that.

⭐ SEE ALSO ⭐

  • Kernel file ./drivers/net/ethernet/sfc/falcon/nic.c β€” go read the source, iykyk πŸ‘‘
  • ef4_nic_describe_stats(9) β€” her sister page, equally iconic 🌈

okay real talk: stats needs to be at least count long, and width-0 entries get skipped entirely. don't come for me if you ignore that, i literally told you πŸ’€

and that's the whole page!! mwah πŸ’‹ this one came from the ./drivers/net/ethernet/sfc/falcon crew, dated October 2026, and it's ef4_nic_update_stats(9) forever and always 🧚✨ bye bestie, go convert some stats πŸ’–

πŸ“¦ where this page comes from