efx_siena_update_stats(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

🌸 efx_siena_update_stats 🌸

okay bestie, welcome to the Kernel API Manual πŸ’… we're doing efx_siena_update_stats(9) today and honestly? it's giving "glow-up for hardware numbers" ✨


✨ NAME ✨

efx_siena_update_stats β€” convert a statistics DMA buffer into an array of u64 πŸ¦‹

like, the raw hardware vibe gets translated into numbers your code can actually read, no cap πŸ’–


πŸŽ€ SYNOPSIS πŸŽ€

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

periodt πŸ’… that's the whole signature, don't come for me about the line breaks, that's literally how it's written ✨


πŸ’œ ARGUMENTS πŸ’œ

okay so here's the whole cast, main character energy each and every one of them 🫢

  • desc β€” an array of struct efx_hw_stat_desc that describes the DMA buffer layout. DMA widths of 0, 16, 32 and 64 are supported 😌 and lowkey important: where the width is specified as 0, the corresponding element of stats is not updated. so it's a little "i'm not touching that one" situation πŸ™ˆ
  • count β€” the length of the desc array. that's it, that's the whole vibe. just how many are in there πŸ”₯
  • mask β€” a bitmask of which elements of desc are enabled. think of it as the guest list for the function πŸ’… only the invited ones get processed πŸ‘‘
  • stats β€” the buffer you're updating with the converted statistics πŸ’– heads up bestie: the length of this array must be at least count. not a suggestion, that's the rule 🌸
  • dma_buf β€” the DMA buffer containing hardware statistics. this is where the raw numbers live πŸ¦‹
  • accumulate β€” if set, the converted values will be added to the corresponding elements of stats rather than directly stored 😌 so it's either "here's your fresh value" or "we're stacking, we're adding to the collection" ✨
ngl, that stats length requirement is not a drill β€” at least count, always 🫢

🌈 SEE ALSO 🌈

go read those too, iykyk πŸ’œ


and that's the page, bestie πŸŽ€ this gem comes to you from the kernel source at ./drivers/net/ethernet/sfc/siena, dated October 2026, and it's still efx_siena_update_stats(9) around here πŸ‘‘ slay πŸ’…βœ¨

πŸ“¦ where this page comes from