[PATCH net-next v10 4/4] Documentation/netlink/specs: tc: describe fq_pie per-flow class stats

From: Hemendra M. Naik

Date: Mon Nov 09 2026 - 02:15:50 EST


Add the tc-fq-pie-cl-stats header for fq_pie per flow (class) stats in Documentation/netlink/specs/tc.yaml
with its five fields: prob, delay, deficit, avg-dq-rate, fq-rate-estimating.

Extend the tc-fq-pie-xstats fixed header with the type discriminator and the per-flow class_stats fields
that follow the nine legacy __u32 qdisc counters in struct tc_fq_pie_xstats.

Signed-off-by: Hemendra M. Naik <hemendranaik@xxxxxxxxx>
Signed-off-by: Vishal Kamath <vishy0777@xxxxxxxxx>
Signed-off-by: Mohit P. Tahiliani <tahiliani@xxxxxxxxxxx>
---
Documentation/netlink/specs/tc.yaml | 33 +++++++++++++++++++++++++++++
1 file changed, 33 insertions(+)

diff --git a/Documentation/netlink/specs/tc.yaml b/Documentation/netlink/specs/tc.yaml
index b6ccc645b0e3..b159c4b563c7 100644
--- a/Documentation/netlink/specs/tc.yaml
+++ b/Documentation/netlink/specs/tc.yaml
@@ -894,6 +894,30 @@ definitions:
name: memory-limit
type: u32
doc: Memory limit in bytes
+ -
+ name: tc-fq-pie-cl-stats
+ type: struct
+ members:
+ -
+ name: prob
+ type: u64
+ doc: Current drop probability of the flow
+ -
+ name: delay
+ type: u32
+ doc: Current queue delay of the flow in microseconds
+ -
+ name: deficit
+ type: s32
+ doc: Number of remaining byte credits
+ -
+ name: avg-dq-rate
+ type: u32
+ doc: Current average dq_rate in bytes/second
+ -
+ name: dq-rate-estimating
+ type: u32
+ doc: Is avg-dq-rate being calculated?
-
name: tc-fq-pie-xstats
type: struct
@@ -934,6 +958,15 @@ definitions:
name: memory-usage
type: u32
doc: Total memory across all queues
+ -
+ name: type
+ type: u32
+ doc: TCA_FQ_PIE_XSTATS_QDISC (0) or TCA_FQ_PIE_XSTATS_CLASS (1)
+ -
+ name: class-stats
+ type: binary
+ struct: tc-fq-pie-cl-stats
+ doc: Class statistics of a particular flow (invoked via tc class show)
-
name: tc-fq-qd-stats
type: struct
--
2.34.1