Loading...
1/*
2 * net/core/gen_stats.c
3 *
4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public License
6 * as published by the Free Software Foundation; either version
7 * 2 of the License, or (at your option) any later version.
8 *
9 * Authors: Thomas Graf <tgraf@suug.ch>
10 * Jamal Hadi Salim
11 * Alexey Kuznetsov, <kuznet@ms2.inr.ac.ru>
12 *
13 * See Documentation/networking/gen_stats.txt
14 */
15
16#include <linux/types.h>
17#include <linux/kernel.h>
18#include <linux/module.h>
19#include <linux/interrupt.h>
20#include <linux/socket.h>
21#include <linux/rtnetlink.h>
22#include <linux/gen_stats.h>
23#include <net/netlink.h>
24#include <net/gen_stats.h>
25
26
27static inline int
28gnet_stats_copy(struct gnet_dump *d, int type, void *buf, int size)
29{
30 NLA_PUT(d->skb, type, size, buf);
31 return 0;
32
33nla_put_failure:
34 spin_unlock_bh(d->lock);
35 return -1;
36}
37
38/**
39 * gnet_stats_start_copy_compat - start dumping procedure in compatibility mode
40 * @skb: socket buffer to put statistics TLVs into
41 * @type: TLV type for top level statistic TLV
42 * @tc_stats_type: TLV type for backward compatibility struct tc_stats TLV
43 * @xstats_type: TLV type for backward compatibility xstats TLV
44 * @lock: statistics lock
45 * @d: dumping handle
46 *
47 * Initializes the dumping handle, grabs the statistic lock and appends
48 * an empty TLV header to the socket buffer for use a container for all
49 * other statistic TLVS.
50 *
51 * The dumping handle is marked to be in backward compatibility mode telling
52 * all gnet_stats_copy_XXX() functions to fill a local copy of struct tc_stats.
53 *
54 * Returns 0 on success or -1 if the room in the socket buffer was not sufficient.
55 */
56int
57gnet_stats_start_copy_compat(struct sk_buff *skb, int type, int tc_stats_type,
58 int xstats_type, spinlock_t *lock, struct gnet_dump *d)
59 __acquires(lock)
60{
61 memset(d, 0, sizeof(*d));
62
63 spin_lock_bh(lock);
64 d->lock = lock;
65 if (type)
66 d->tail = (struct nlattr *)skb_tail_pointer(skb);
67 d->skb = skb;
68 d->compat_tc_stats = tc_stats_type;
69 d->compat_xstats = xstats_type;
70
71 if (d->tail)
72 return gnet_stats_copy(d, type, NULL, 0);
73
74 return 0;
75}
76EXPORT_SYMBOL(gnet_stats_start_copy_compat);
77
78/**
79 * gnet_stats_start_copy_compat - start dumping procedure in compatibility mode
80 * @skb: socket buffer to put statistics TLVs into
81 * @type: TLV type for top level statistic TLV
82 * @lock: statistics lock
83 * @d: dumping handle
84 *
85 * Initializes the dumping handle, grabs the statistic lock and appends
86 * an empty TLV header to the socket buffer for use a container for all
87 * other statistic TLVS.
88 *
89 * Returns 0 on success or -1 if the room in the socket buffer was not sufficient.
90 */
91int
92gnet_stats_start_copy(struct sk_buff *skb, int type, spinlock_t *lock,
93 struct gnet_dump *d)
94{
95 return gnet_stats_start_copy_compat(skb, type, 0, 0, lock, d);
96}
97EXPORT_SYMBOL(gnet_stats_start_copy);
98
99/**
100 * gnet_stats_copy_basic - copy basic statistics into statistic TLV
101 * @d: dumping handle
102 * @b: basic statistics
103 *
104 * Appends the basic statistics to the top level TLV created by
105 * gnet_stats_start_copy().
106 *
107 * Returns 0 on success or -1 with the statistic lock released
108 * if the room in the socket buffer was not sufficient.
109 */
110int
111gnet_stats_copy_basic(struct gnet_dump *d, struct gnet_stats_basic_packed *b)
112{
113 if (d->compat_tc_stats) {
114 d->tc_stats.bytes = b->bytes;
115 d->tc_stats.packets = b->packets;
116 }
117
118 if (d->tail) {
119 struct gnet_stats_basic sb;
120
121 memset(&sb, 0, sizeof(sb));
122 sb.bytes = b->bytes;
123 sb.packets = b->packets;
124 return gnet_stats_copy(d, TCA_STATS_BASIC, &sb, sizeof(sb));
125 }
126 return 0;
127}
128EXPORT_SYMBOL(gnet_stats_copy_basic);
129
130/**
131 * gnet_stats_copy_rate_est - copy rate estimator statistics into statistics TLV
132 * @d: dumping handle
133 * @b: basic statistics
134 * @r: rate estimator statistics
135 *
136 * Appends the rate estimator statistics to the top level TLV created by
137 * gnet_stats_start_copy().
138 *
139 * Returns 0 on success or -1 with the statistic lock released
140 * if the room in the socket buffer was not sufficient.
141 */
142int
143gnet_stats_copy_rate_est(struct gnet_dump *d,
144 const struct gnet_stats_basic_packed *b,
145 struct gnet_stats_rate_est *r)
146{
147 if (b && !gen_estimator_active(b, r))
148 return 0;
149
150 if (d->compat_tc_stats) {
151 d->tc_stats.bps = r->bps;
152 d->tc_stats.pps = r->pps;
153 }
154
155 if (d->tail)
156 return gnet_stats_copy(d, TCA_STATS_RATE_EST, r, sizeof(*r));
157
158 return 0;
159}
160EXPORT_SYMBOL(gnet_stats_copy_rate_est);
161
162/**
163 * gnet_stats_copy_queue - copy queue statistics into statistics TLV
164 * @d: dumping handle
165 * @q: queue statistics
166 *
167 * Appends the queue statistics to the top level TLV created by
168 * gnet_stats_start_copy().
169 *
170 * Returns 0 on success or -1 with the statistic lock released
171 * if the room in the socket buffer was not sufficient.
172 */
173int
174gnet_stats_copy_queue(struct gnet_dump *d, struct gnet_stats_queue *q)
175{
176 if (d->compat_tc_stats) {
177 d->tc_stats.drops = q->drops;
178 d->tc_stats.qlen = q->qlen;
179 d->tc_stats.backlog = q->backlog;
180 d->tc_stats.overlimits = q->overlimits;
181 }
182
183 if (d->tail)
184 return gnet_stats_copy(d, TCA_STATS_QUEUE, q, sizeof(*q));
185
186 return 0;
187}
188EXPORT_SYMBOL(gnet_stats_copy_queue);
189
190/**
191 * gnet_stats_copy_app - copy application specific statistics into statistics TLV
192 * @d: dumping handle
193 * @st: application specific statistics data
194 * @len: length of data
195 *
196 * Appends the application sepecific statistics to the top level TLV created by
197 * gnet_stats_start_copy() and remembers the data for XSTATS if the dumping
198 * handle is in backward compatibility mode.
199 *
200 * Returns 0 on success or -1 with the statistic lock released
201 * if the room in the socket buffer was not sufficient.
202 */
203int
204gnet_stats_copy_app(struct gnet_dump *d, void *st, int len)
205{
206 if (d->compat_xstats) {
207 d->xstats = st;
208 d->xstats_len = len;
209 }
210
211 if (d->tail)
212 return gnet_stats_copy(d, TCA_STATS_APP, st, len);
213
214 return 0;
215}
216EXPORT_SYMBOL(gnet_stats_copy_app);
217
218/**
219 * gnet_stats_finish_copy - finish dumping procedure
220 * @d: dumping handle
221 *
222 * Corrects the length of the top level TLV to include all TLVs added
223 * by gnet_stats_copy_XXX() calls. Adds the backward compatibility TLVs
224 * if gnet_stats_start_copy_compat() was used and releases the statistics
225 * lock.
226 *
227 * Returns 0 on success or -1 with the statistic lock released
228 * if the room in the socket buffer was not sufficient.
229 */
230int
231gnet_stats_finish_copy(struct gnet_dump *d)
232{
233 if (d->tail)
234 d->tail->nla_len = skb_tail_pointer(d->skb) - (u8 *)d->tail;
235
236 if (d->compat_tc_stats)
237 if (gnet_stats_copy(d, d->compat_tc_stats, &d->tc_stats,
238 sizeof(d->tc_stats)) < 0)
239 return -1;
240
241 if (d->compat_xstats && d->xstats) {
242 if (gnet_stats_copy(d, d->compat_xstats, d->xstats,
243 d->xstats_len) < 0)
244 return -1;
245 }
246
247 spin_unlock_bh(d->lock);
248 return 0;
249}
250EXPORT_SYMBOL(gnet_stats_finish_copy);
1// SPDX-License-Identifier: GPL-2.0-or-later
2/*
3 * net/core/gen_stats.c
4 *
5 * Authors: Thomas Graf <tgraf@suug.ch>
6 * Jamal Hadi Salim
7 * Alexey Kuznetsov, <kuznet@ms2.inr.ac.ru>
8 *
9 * See Documentation/networking/gen_stats.rst
10 */
11
12#include <linux/types.h>
13#include <linux/kernel.h>
14#include <linux/module.h>
15#include <linux/interrupt.h>
16#include <linux/socket.h>
17#include <linux/rtnetlink.h>
18#include <linux/gen_stats.h>
19#include <net/netlink.h>
20#include <net/gen_stats.h>
21
22
23static inline int
24gnet_stats_copy(struct gnet_dump *d, int type, void *buf, int size, int padattr)
25{
26 if (nla_put_64bit(d->skb, type, size, buf, padattr))
27 goto nla_put_failure;
28 return 0;
29
30nla_put_failure:
31 if (d->lock)
32 spin_unlock_bh(d->lock);
33 kfree(d->xstats);
34 d->xstats = NULL;
35 d->xstats_len = 0;
36 return -1;
37}
38
39/**
40 * gnet_stats_start_copy_compat - start dumping procedure in compatibility mode
41 * @skb: socket buffer to put statistics TLVs into
42 * @type: TLV type for top level statistic TLV
43 * @tc_stats_type: TLV type for backward compatibility struct tc_stats TLV
44 * @xstats_type: TLV type for backward compatibility xstats TLV
45 * @lock: statistics lock
46 * @d: dumping handle
47 * @padattr: padding attribute
48 *
49 * Initializes the dumping handle, grabs the statistic lock and appends
50 * an empty TLV header to the socket buffer for use a container for all
51 * other statistic TLVS.
52 *
53 * The dumping handle is marked to be in backward compatibility mode telling
54 * all gnet_stats_copy_XXX() functions to fill a local copy of struct tc_stats.
55 *
56 * Returns 0 on success or -1 if the room in the socket buffer was not sufficient.
57 */
58int
59gnet_stats_start_copy_compat(struct sk_buff *skb, int type, int tc_stats_type,
60 int xstats_type, spinlock_t *lock,
61 struct gnet_dump *d, int padattr)
62 __acquires(lock)
63{
64 memset(d, 0, sizeof(*d));
65
66 if (type)
67 d->tail = (struct nlattr *)skb_tail_pointer(skb);
68 d->skb = skb;
69 d->compat_tc_stats = tc_stats_type;
70 d->compat_xstats = xstats_type;
71 d->padattr = padattr;
72 if (lock) {
73 d->lock = lock;
74 spin_lock_bh(lock);
75 }
76 if (d->tail) {
77 int ret = gnet_stats_copy(d, type, NULL, 0, padattr);
78
79 /* The initial attribute added in gnet_stats_copy() may be
80 * preceded by a padding attribute, in which case d->tail will
81 * end up pointing at the padding instead of the real attribute.
82 * Fix this so gnet_stats_finish_copy() adjusts the length of
83 * the right attribute.
84 */
85 if (ret == 0 && d->tail->nla_type == padattr)
86 d->tail = (struct nlattr *)((char *)d->tail +
87 NLA_ALIGN(d->tail->nla_len));
88 return ret;
89 }
90
91 return 0;
92}
93EXPORT_SYMBOL(gnet_stats_start_copy_compat);
94
95/**
96 * gnet_stats_start_copy - start dumping procedure in compatibility mode
97 * @skb: socket buffer to put statistics TLVs into
98 * @type: TLV type for top level statistic TLV
99 * @lock: statistics lock
100 * @d: dumping handle
101 * @padattr: padding attribute
102 *
103 * Initializes the dumping handle, grabs the statistic lock and appends
104 * an empty TLV header to the socket buffer for use a container for all
105 * other statistic TLVS.
106 *
107 * Returns 0 on success or -1 if the room in the socket buffer was not sufficient.
108 */
109int
110gnet_stats_start_copy(struct sk_buff *skb, int type, spinlock_t *lock,
111 struct gnet_dump *d, int padattr)
112{
113 return gnet_stats_start_copy_compat(skb, type, 0, 0, lock, d, padattr);
114}
115EXPORT_SYMBOL(gnet_stats_start_copy);
116
117static void
118__gnet_stats_copy_basic_cpu(struct gnet_stats_basic_packed *bstats,
119 struct gnet_stats_basic_cpu __percpu *cpu)
120{
121 int i;
122
123 for_each_possible_cpu(i) {
124 struct gnet_stats_basic_cpu *bcpu = per_cpu_ptr(cpu, i);
125 unsigned int start;
126 u64 bytes, packets;
127
128 do {
129 start = u64_stats_fetch_begin_irq(&bcpu->syncp);
130 bytes = bcpu->bstats.bytes;
131 packets = bcpu->bstats.packets;
132 } while (u64_stats_fetch_retry_irq(&bcpu->syncp, start));
133
134 bstats->bytes += bytes;
135 bstats->packets += packets;
136 }
137}
138
139void
140__gnet_stats_copy_basic(const seqcount_t *running,
141 struct gnet_stats_basic_packed *bstats,
142 struct gnet_stats_basic_cpu __percpu *cpu,
143 struct gnet_stats_basic_packed *b)
144{
145 unsigned int seq;
146
147 if (cpu) {
148 __gnet_stats_copy_basic_cpu(bstats, cpu);
149 return;
150 }
151 do {
152 if (running)
153 seq = read_seqcount_begin(running);
154 bstats->bytes = b->bytes;
155 bstats->packets = b->packets;
156 } while (running && read_seqcount_retry(running, seq));
157}
158EXPORT_SYMBOL(__gnet_stats_copy_basic);
159
160static int
161___gnet_stats_copy_basic(const seqcount_t *running,
162 struct gnet_dump *d,
163 struct gnet_stats_basic_cpu __percpu *cpu,
164 struct gnet_stats_basic_packed *b,
165 int type)
166{
167 struct gnet_stats_basic_packed bstats = {0};
168
169 __gnet_stats_copy_basic(running, &bstats, cpu, b);
170
171 if (d->compat_tc_stats && type == TCA_STATS_BASIC) {
172 d->tc_stats.bytes = bstats.bytes;
173 d->tc_stats.packets = bstats.packets;
174 }
175
176 if (d->tail) {
177 struct gnet_stats_basic sb;
178 int res;
179
180 memset(&sb, 0, sizeof(sb));
181 sb.bytes = bstats.bytes;
182 sb.packets = bstats.packets;
183 res = gnet_stats_copy(d, type, &sb, sizeof(sb), TCA_STATS_PAD);
184 if (res < 0 || sb.packets == bstats.packets)
185 return res;
186 /* emit 64bit stats only if needed */
187 return gnet_stats_copy(d, TCA_STATS_PKT64, &bstats.packets,
188 sizeof(bstats.packets), TCA_STATS_PAD);
189 }
190 return 0;
191}
192
193/**
194 * gnet_stats_copy_basic - copy basic statistics into statistic TLV
195 * @running: seqcount_t pointer
196 * @d: dumping handle
197 * @cpu: copy statistic per cpu
198 * @b: basic statistics
199 *
200 * Appends the basic statistics to the top level TLV created by
201 * gnet_stats_start_copy().
202 *
203 * Returns 0 on success or -1 with the statistic lock released
204 * if the room in the socket buffer was not sufficient.
205 */
206int
207gnet_stats_copy_basic(const seqcount_t *running,
208 struct gnet_dump *d,
209 struct gnet_stats_basic_cpu __percpu *cpu,
210 struct gnet_stats_basic_packed *b)
211{
212 return ___gnet_stats_copy_basic(running, d, cpu, b,
213 TCA_STATS_BASIC);
214}
215EXPORT_SYMBOL(gnet_stats_copy_basic);
216
217/**
218 * gnet_stats_copy_basic_hw - copy basic hw statistics into statistic TLV
219 * @running: seqcount_t pointer
220 * @d: dumping handle
221 * @cpu: copy statistic per cpu
222 * @b: basic statistics
223 *
224 * Appends the basic statistics to the top level TLV created by
225 * gnet_stats_start_copy().
226 *
227 * Returns 0 on success or -1 with the statistic lock released
228 * if the room in the socket buffer was not sufficient.
229 */
230int
231gnet_stats_copy_basic_hw(const seqcount_t *running,
232 struct gnet_dump *d,
233 struct gnet_stats_basic_cpu __percpu *cpu,
234 struct gnet_stats_basic_packed *b)
235{
236 return ___gnet_stats_copy_basic(running, d, cpu, b,
237 TCA_STATS_BASIC_HW);
238}
239EXPORT_SYMBOL(gnet_stats_copy_basic_hw);
240
241/**
242 * gnet_stats_copy_rate_est - copy rate estimator statistics into statistics TLV
243 * @d: dumping handle
244 * @rate_est: rate estimator
245 *
246 * Appends the rate estimator statistics to the top level TLV created by
247 * gnet_stats_start_copy().
248 *
249 * Returns 0 on success or -1 with the statistic lock released
250 * if the room in the socket buffer was not sufficient.
251 */
252int
253gnet_stats_copy_rate_est(struct gnet_dump *d,
254 struct net_rate_estimator __rcu **rate_est)
255{
256 struct gnet_stats_rate_est64 sample;
257 struct gnet_stats_rate_est est;
258 int res;
259
260 if (!gen_estimator_read(rate_est, &sample))
261 return 0;
262 est.bps = min_t(u64, UINT_MAX, sample.bps);
263 /* we have some time before reaching 2^32 packets per second */
264 est.pps = sample.pps;
265
266 if (d->compat_tc_stats) {
267 d->tc_stats.bps = est.bps;
268 d->tc_stats.pps = est.pps;
269 }
270
271 if (d->tail) {
272 res = gnet_stats_copy(d, TCA_STATS_RATE_EST, &est, sizeof(est),
273 TCA_STATS_PAD);
274 if (res < 0 || est.bps == sample.bps)
275 return res;
276 /* emit 64bit stats only if needed */
277 return gnet_stats_copy(d, TCA_STATS_RATE_EST64, &sample,
278 sizeof(sample), TCA_STATS_PAD);
279 }
280
281 return 0;
282}
283EXPORT_SYMBOL(gnet_stats_copy_rate_est);
284
285static void
286__gnet_stats_copy_queue_cpu(struct gnet_stats_queue *qstats,
287 const struct gnet_stats_queue __percpu *q)
288{
289 int i;
290
291 for_each_possible_cpu(i) {
292 const struct gnet_stats_queue *qcpu = per_cpu_ptr(q, i);
293
294 qstats->qlen = 0;
295 qstats->backlog += qcpu->backlog;
296 qstats->drops += qcpu->drops;
297 qstats->requeues += qcpu->requeues;
298 qstats->overlimits += qcpu->overlimits;
299 }
300}
301
302void __gnet_stats_copy_queue(struct gnet_stats_queue *qstats,
303 const struct gnet_stats_queue __percpu *cpu,
304 const struct gnet_stats_queue *q,
305 __u32 qlen)
306{
307 if (cpu) {
308 __gnet_stats_copy_queue_cpu(qstats, cpu);
309 } else {
310 qstats->qlen = q->qlen;
311 qstats->backlog = q->backlog;
312 qstats->drops = q->drops;
313 qstats->requeues = q->requeues;
314 qstats->overlimits = q->overlimits;
315 }
316
317 qstats->qlen = qlen;
318}
319EXPORT_SYMBOL(__gnet_stats_copy_queue);
320
321/**
322 * gnet_stats_copy_queue - copy queue statistics into statistics TLV
323 * @d: dumping handle
324 * @cpu_q: per cpu queue statistics
325 * @q: queue statistics
326 * @qlen: queue length statistics
327 *
328 * Appends the queue statistics to the top level TLV created by
329 * gnet_stats_start_copy(). Using per cpu queue statistics if
330 * they are available.
331 *
332 * Returns 0 on success or -1 with the statistic lock released
333 * if the room in the socket buffer was not sufficient.
334 */
335int
336gnet_stats_copy_queue(struct gnet_dump *d,
337 struct gnet_stats_queue __percpu *cpu_q,
338 struct gnet_stats_queue *q, __u32 qlen)
339{
340 struct gnet_stats_queue qstats = {0};
341
342 __gnet_stats_copy_queue(&qstats, cpu_q, q, qlen);
343
344 if (d->compat_tc_stats) {
345 d->tc_stats.drops = qstats.drops;
346 d->tc_stats.qlen = qstats.qlen;
347 d->tc_stats.backlog = qstats.backlog;
348 d->tc_stats.overlimits = qstats.overlimits;
349 }
350
351 if (d->tail)
352 return gnet_stats_copy(d, TCA_STATS_QUEUE,
353 &qstats, sizeof(qstats),
354 TCA_STATS_PAD);
355
356 return 0;
357}
358EXPORT_SYMBOL(gnet_stats_copy_queue);
359
360/**
361 * gnet_stats_copy_app - copy application specific statistics into statistics TLV
362 * @d: dumping handle
363 * @st: application specific statistics data
364 * @len: length of data
365 *
366 * Appends the application specific statistics to the top level TLV created by
367 * gnet_stats_start_copy() and remembers the data for XSTATS if the dumping
368 * handle is in backward compatibility mode.
369 *
370 * Returns 0 on success or -1 with the statistic lock released
371 * if the room in the socket buffer was not sufficient.
372 */
373int
374gnet_stats_copy_app(struct gnet_dump *d, void *st, int len)
375{
376 if (d->compat_xstats) {
377 d->xstats = kmemdup(st, len, GFP_ATOMIC);
378 if (!d->xstats)
379 goto err_out;
380 d->xstats_len = len;
381 }
382
383 if (d->tail)
384 return gnet_stats_copy(d, TCA_STATS_APP, st, len,
385 TCA_STATS_PAD);
386
387 return 0;
388
389err_out:
390 if (d->lock)
391 spin_unlock_bh(d->lock);
392 d->xstats_len = 0;
393 return -1;
394}
395EXPORT_SYMBOL(gnet_stats_copy_app);
396
397/**
398 * gnet_stats_finish_copy - finish dumping procedure
399 * @d: dumping handle
400 *
401 * Corrects the length of the top level TLV to include all TLVs added
402 * by gnet_stats_copy_XXX() calls. Adds the backward compatibility TLVs
403 * if gnet_stats_start_copy_compat() was used and releases the statistics
404 * lock.
405 *
406 * Returns 0 on success or -1 with the statistic lock released
407 * if the room in the socket buffer was not sufficient.
408 */
409int
410gnet_stats_finish_copy(struct gnet_dump *d)
411{
412 if (d->tail)
413 d->tail->nla_len = skb_tail_pointer(d->skb) - (u8 *)d->tail;
414
415 if (d->compat_tc_stats)
416 if (gnet_stats_copy(d, d->compat_tc_stats, &d->tc_stats,
417 sizeof(d->tc_stats), d->padattr) < 0)
418 return -1;
419
420 if (d->compat_xstats && d->xstats) {
421 if (gnet_stats_copy(d, d->compat_xstats, d->xstats,
422 d->xstats_len, d->padattr) < 0)
423 return -1;
424 }
425
426 if (d->lock)
427 spin_unlock_bh(d->lock);
428 kfree(d->xstats);
429 d->xstats = NULL;
430 d->xstats_len = 0;
431 return 0;
432}
433EXPORT_SYMBOL(gnet_stats_finish_copy);