rte_eth_stats(3)

📦 version 26.03, in nixos 26.05, nixpkgs unstable

✨ rte_eth_stats 💖

okay bestie so this is a page from the Library Functions Manual — it's all about rte_eth_stats, and it's genuinely one of those "you'll need this the second you try to figure out why your packets vanished" situations. 🎀

🌸 NAME 🌸

rte_eth_stats — the struct you go to when you wanna know what your Ethernet port has actually been up to 🫶

⭐ SYNOPSIS ⭐

#include <rte_ethdev.h>

🦋 Data Fields 🦋

uint64_t ipackets
uint64_t opackets
uint64_t ibytes
uint64_t obytes
uint64_t imissed
uint64_t ierrors
uint64_t oerrors
uint64_t rx_nombuf

💅 DETAILED DESCRIPTION 💅

So basically: this is a structure used to retrieve statistics for an Ethernet port. That's the whole vibe. It's the receipts bag for your NIC. 🧾

Not all statistics fields in struct rte_eth_stats are supported by any type of network interface card (NIC). And like... if any statistics field is not supported, its value is 0. Read that again, because this is the part that trips people up: a zero doesn't always mean "nothing happened," sometimes it means "your NIC simply doesn't do that one." 🙈

Also — and this is important, no cap — all byte-related statistics do not include Ethernet FCS, regardless of whether these bytes have been delivered to the application (see RTE_ETH_RX_OFFLOAD_KEEP_CRC). So don't come for the byte counts, they're doing their best. 😭

Definition at line 262 of file rte_ethdev.h.

👑 FIELD DOCUMENTATION 👑

okay this is the part where we meet every single field one by one, group-chat-introduction style 💖

🍓 uint64_t ipackets

Total number of successfully received packets. The "yay it worked" counter ✨

Definition at line 263 of file rte_ethdev.h.

🍓 uint64_t opackets

Total number of successfully transmitted packets. Sending era 💌

Definition at line 264 of file rte_ethdev.h.

🍓 uint64_t ibytes

Total number of successfully received bytes. The big number, the main character 👑

Definition at line 265 of file rte_ethdev.h.

🍓 uint64_t obytes

Total number of successfully transmitted bytes. Sending era, but in volume 🔥

Definition at line 266 of file rte_ethdev.h.

💀 uint64_t imissed

Total of Rx packets dropped by the HW, because there are no available buffer (i.e. Rx queues are full). This one hurts. The hardware literally had nowhere to put them so it said "not my problem" 😭

Definition at line 271 of file rte_ethdev.h.

💀 uint64_t ierrors

Total number of erroneous received packets. They arrived, they were just... wrong. 🫠

Definition at line 272 of file rte_ethdev.h.

💀 uint64_t oerrors

Total number of failed transmitted packets. We do not talk about these at parties 🙈

Definition at line 273 of file rte_ethdev.h.

💀 uint64_t rx_nombuf

Total number of Rx mbuf allocation failures. The mbuf pool ran dry, which is its own whole saga 🧚

Definition at line 274 of file rte_ethdev.h.

🌈 AUTHOR 🌈

Generated automatically by Doxygen for DPDK from the source code. So no human wrote this, the machine did it, and honestly? Slay. 🤖💅

and that's the whole page bestie, you ate that 💖 this was DPDK, Version 26.03.0 — mwah, go read your stats, ily, bye 🫶✨🎀

📦 where this page comes from