Loading...
1/* SPDX-License-Identifier: GPL-2.0 */
2#ifndef __NET_PKT_SCHED_H
3#define __NET_PKT_SCHED_H
4
5#include <linux/jiffies.h>
6#include <linux/ktime.h>
7#include <linux/if_vlan.h>
8#include <linux/netdevice.h>
9#include <net/sch_generic.h>
10#include <net/net_namespace.h>
11#include <uapi/linux/pkt_sched.h>
12
13#define DEFAULT_TX_QUEUE_LEN 1000
14#define STAB_SIZE_LOG_MAX 30
15
16struct qdisc_walker {
17 int stop;
18 int skip;
19 int count;
20 int (*fn)(struct Qdisc *, unsigned long cl, struct qdisc_walker *);
21};
22
23#define qdisc_priv(q) \
24 _Generic(q, \
25 const struct Qdisc * : (const void *)&q->privdata, \
26 struct Qdisc * : (void *)&q->privdata)
27
28static inline struct Qdisc *qdisc_from_priv(void *priv)
29{
30 return container_of(priv, struct Qdisc, privdata);
31}
32
33/*
34 Timer resolution MUST BE < 10% of min_schedulable_packet_size/bandwidth
35
36 Normal IP packet size ~ 512byte, hence:
37
38 0.5Kbyte/1Mbyte/sec = 0.5msec, so that we need 50usec timer for
39 10Mbit ethernet.
40
41 10msec resolution -> <50Kbit/sec.
42
43 The result: [34]86 is not good choice for QoS router :-(
44
45 The things are not so bad, because we may use artificial
46 clock evaluated by integration of network data flow
47 in the most critical places.
48 */
49
50typedef u64 psched_time_t;
51typedef long psched_tdiff_t;
52
53/* Avoid doing 64 bit divide */
54#define PSCHED_SHIFT 6
55#define PSCHED_TICKS2NS(x) ((s64)(x) << PSCHED_SHIFT)
56#define PSCHED_NS2TICKS(x) ((x) >> PSCHED_SHIFT)
57
58#define PSCHED_TICKS_PER_SEC PSCHED_NS2TICKS(NSEC_PER_SEC)
59#define PSCHED_PASTPERFECT 0
60
61static inline psched_time_t psched_get_time(void)
62{
63 return PSCHED_NS2TICKS(ktime_get_ns());
64}
65
66struct qdisc_watchdog {
67 struct hrtimer timer;
68 struct Qdisc *qdisc;
69};
70
71void qdisc_watchdog_init_clockid(struct qdisc_watchdog *wd, struct Qdisc *qdisc,
72 clockid_t clockid);
73void qdisc_watchdog_init(struct qdisc_watchdog *wd, struct Qdisc *qdisc);
74
75void qdisc_watchdog_schedule_range_ns(struct qdisc_watchdog *wd, u64 expires,
76 u64 delta_ns);
77
78static inline void qdisc_watchdog_schedule_ns(struct qdisc_watchdog *wd,
79 u64 expires)
80{
81 return qdisc_watchdog_schedule_range_ns(wd, expires, 0ULL);
82}
83
84static inline void qdisc_watchdog_schedule(struct qdisc_watchdog *wd,
85 psched_time_t expires)
86{
87 qdisc_watchdog_schedule_ns(wd, PSCHED_TICKS2NS(expires));
88}
89
90void qdisc_watchdog_cancel(struct qdisc_watchdog *wd);
91
92extern struct Qdisc_ops pfifo_qdisc_ops;
93extern struct Qdisc_ops bfifo_qdisc_ops;
94extern struct Qdisc_ops pfifo_head_drop_qdisc_ops;
95
96int fifo_set_limit(struct Qdisc *q, unsigned int limit);
97struct Qdisc *fifo_create_dflt(struct Qdisc *sch, struct Qdisc_ops *ops,
98 unsigned int limit,
99 struct netlink_ext_ack *extack);
100
101int register_qdisc(struct Qdisc_ops *qops);
102void unregister_qdisc(struct Qdisc_ops *qops);
103#define NET_SCH_ALIAS_PREFIX "net-sch-"
104#define MODULE_ALIAS_NET_SCH(id) MODULE_ALIAS(NET_SCH_ALIAS_PREFIX id)
105void qdisc_get_default(char *id, size_t len);
106int qdisc_set_default(const char *id);
107
108void qdisc_hash_add(struct Qdisc *q, bool invisible);
109void qdisc_hash_del(struct Qdisc *q);
110struct Qdisc *qdisc_lookup(struct net_device *dev, u32 handle);
111struct Qdisc *qdisc_lookup_rcu(struct net_device *dev, u32 handle);
112struct qdisc_rate_table *qdisc_get_rtab(struct tc_ratespec *r,
113 struct nlattr *tab,
114 struct netlink_ext_ack *extack);
115void qdisc_put_rtab(struct qdisc_rate_table *tab);
116void qdisc_put_stab(struct qdisc_size_table *tab);
117void qdisc_warn_nonwc(const char *txt, struct Qdisc *qdisc);
118bool sch_direct_xmit(struct sk_buff *skb, struct Qdisc *q,
119 struct net_device *dev, struct netdev_queue *txq,
120 spinlock_t *root_lock, bool validate);
121
122void __qdisc_run(struct Qdisc *q);
123
124static inline void qdisc_run(struct Qdisc *q)
125{
126 if (qdisc_run_begin(q)) {
127 __qdisc_run(q);
128 qdisc_run_end(q);
129 }
130}
131
132extern const struct nla_policy rtm_tca_policy[TCA_MAX + 1];
133
134/* Calculate maximal size of packet seen by hard_start_xmit
135 routine of this device.
136 */
137static inline unsigned int psched_mtu(const struct net_device *dev)
138{
139 return READ_ONCE(dev->mtu) + dev->hard_header_len;
140}
141
142static inline struct net *qdisc_net(struct Qdisc *q)
143{
144 return dev_net(q->dev_queue->dev);
145}
146
147struct tc_query_caps_base {
148 enum tc_setup_type type;
149 void *caps;
150};
151
152struct tc_cbs_qopt_offload {
153 u8 enable;
154 s32 queue;
155 s32 hicredit;
156 s32 locredit;
157 s32 idleslope;
158 s32 sendslope;
159};
160
161struct tc_etf_qopt_offload {
162 u8 enable;
163 s32 queue;
164};
165
166struct tc_mqprio_caps {
167 bool validate_queue_counts:1;
168};
169
170struct tc_mqprio_qopt_offload {
171 /* struct tc_mqprio_qopt must always be the first element */
172 struct tc_mqprio_qopt qopt;
173 struct netlink_ext_ack *extack;
174 u16 mode;
175 u16 shaper;
176 u32 flags;
177 u64 min_rate[TC_QOPT_MAX_QUEUE];
178 u64 max_rate[TC_QOPT_MAX_QUEUE];
179 unsigned long preemptible_tcs;
180};
181
182struct tc_taprio_caps {
183 bool supports_queue_max_sdu:1;
184 bool gate_mask_per_txq:1;
185 /* Device expects lower TXQ numbers to have higher priority over higher
186 * TXQs, regardless of their TC mapping. DO NOT USE FOR NEW DRIVERS,
187 * INSTEAD ENFORCE A PROPER TC:TXQ MAPPING COMING FROM USER SPACE.
188 */
189 bool broken_mqprio:1;
190};
191
192enum tc_taprio_qopt_cmd {
193 TAPRIO_CMD_REPLACE,
194 TAPRIO_CMD_DESTROY,
195 TAPRIO_CMD_STATS,
196 TAPRIO_CMD_QUEUE_STATS,
197};
198
199/**
200 * struct tc_taprio_qopt_stats - IEEE 802.1Qbv statistics
201 * @window_drops: Frames that were dropped because they were too large to be
202 * transmitted in any of the allotted time windows (open gates) for their
203 * traffic class.
204 * @tx_overruns: Frames still being transmitted by the MAC after the
205 * transmission gate associated with their traffic class has closed.
206 * Equivalent to `12.29.1.1.2 TransmissionOverrun` from 802.1Q-2018.
207 */
208struct tc_taprio_qopt_stats {
209 u64 window_drops;
210 u64 tx_overruns;
211};
212
213struct tc_taprio_qopt_queue_stats {
214 int queue;
215 struct tc_taprio_qopt_stats stats;
216};
217
218struct tc_taprio_sched_entry {
219 u8 command; /* TC_TAPRIO_CMD_* */
220
221 /* The gate_mask in the offloading side refers to traffic classes */
222 u32 gate_mask;
223 u32 interval;
224};
225
226struct tc_taprio_qopt_offload {
227 enum tc_taprio_qopt_cmd cmd;
228
229 union {
230 /* TAPRIO_CMD_STATS */
231 struct tc_taprio_qopt_stats stats;
232 /* TAPRIO_CMD_QUEUE_STATS */
233 struct tc_taprio_qopt_queue_stats queue_stats;
234 /* TAPRIO_CMD_REPLACE */
235 struct {
236 struct tc_mqprio_qopt_offload mqprio;
237 struct netlink_ext_ack *extack;
238 ktime_t base_time;
239 u64 cycle_time;
240 u64 cycle_time_extension;
241 u32 max_sdu[TC_MAX_QUEUE];
242
243 size_t num_entries;
244 struct tc_taprio_sched_entry entries[];
245 };
246 };
247};
248
249#if IS_ENABLED(CONFIG_NET_SCH_TAPRIO)
250
251/* Reference counting */
252struct tc_taprio_qopt_offload *taprio_offload_get(struct tc_taprio_qopt_offload
253 *offload);
254void taprio_offload_free(struct tc_taprio_qopt_offload *offload);
255
256#else
257
258/* Reference counting */
259static inline struct tc_taprio_qopt_offload *
260taprio_offload_get(struct tc_taprio_qopt_offload *offload)
261{
262 return NULL;
263}
264
265static inline void taprio_offload_free(struct tc_taprio_qopt_offload *offload)
266{
267}
268
269#endif
270
271/* Ensure skb_mstamp_ns, which might have been populated with the txtime, is
272 * not mistaken for a software timestamp, because this will otherwise prevent
273 * the dispatch of hardware timestamps to the socket.
274 */
275static inline void skb_txtime_consumed(struct sk_buff *skb)
276{
277 skb->tstamp = ktime_set(0, 0);
278}
279
280static inline bool tc_qdisc_stats_dump(struct Qdisc *sch,
281 unsigned long cl,
282 struct qdisc_walker *arg)
283{
284 if (arg->count >= arg->skip && arg->fn(sch, cl, arg) < 0) {
285 arg->stop = 1;
286 return false;
287 }
288
289 arg->count++;
290 return true;
291}
292
293#endif
1/* SPDX-License-Identifier: GPL-2.0 */
2#ifndef __NET_PKT_SCHED_H
3#define __NET_PKT_SCHED_H
4
5#include <linux/jiffies.h>
6#include <linux/ktime.h>
7#include <linux/if_vlan.h>
8#include <linux/netdevice.h>
9#include <net/sch_generic.h>
10#include <net/net_namespace.h>
11#include <uapi/linux/pkt_sched.h>
12
13#define DEFAULT_TX_QUEUE_LEN 1000
14#define STAB_SIZE_LOG_MAX 30
15
16struct qdisc_walker {
17 int stop;
18 int skip;
19 int count;
20 int (*fn)(struct Qdisc *, unsigned long cl, struct qdisc_walker *);
21};
22
23static inline void *qdisc_priv(struct Qdisc *q)
24{
25 return &q->privdata;
26}
27
28static inline struct Qdisc *qdisc_from_priv(void *priv)
29{
30 return container_of(priv, struct Qdisc, privdata);
31}
32
33/*
34 Timer resolution MUST BE < 10% of min_schedulable_packet_size/bandwidth
35
36 Normal IP packet size ~ 512byte, hence:
37
38 0.5Kbyte/1Mbyte/sec = 0.5msec, so that we need 50usec timer for
39 10Mbit ethernet.
40
41 10msec resolution -> <50Kbit/sec.
42
43 The result: [34]86 is not good choice for QoS router :-(
44
45 The things are not so bad, because we may use artificial
46 clock evaluated by integration of network data flow
47 in the most critical places.
48 */
49
50typedef u64 psched_time_t;
51typedef long psched_tdiff_t;
52
53/* Avoid doing 64 bit divide */
54#define PSCHED_SHIFT 6
55#define PSCHED_TICKS2NS(x) ((s64)(x) << PSCHED_SHIFT)
56#define PSCHED_NS2TICKS(x) ((x) >> PSCHED_SHIFT)
57
58#define PSCHED_TICKS_PER_SEC PSCHED_NS2TICKS(NSEC_PER_SEC)
59#define PSCHED_PASTPERFECT 0
60
61static inline psched_time_t psched_get_time(void)
62{
63 return PSCHED_NS2TICKS(ktime_get_ns());
64}
65
66struct qdisc_watchdog {
67 u64 last_expires;
68 struct hrtimer timer;
69 struct Qdisc *qdisc;
70};
71
72void qdisc_watchdog_init_clockid(struct qdisc_watchdog *wd, struct Qdisc *qdisc,
73 clockid_t clockid);
74void qdisc_watchdog_init(struct qdisc_watchdog *wd, struct Qdisc *qdisc);
75
76void qdisc_watchdog_schedule_range_ns(struct qdisc_watchdog *wd, u64 expires,
77 u64 delta_ns);
78
79static inline void qdisc_watchdog_schedule_ns(struct qdisc_watchdog *wd,
80 u64 expires)
81{
82 return qdisc_watchdog_schedule_range_ns(wd, expires, 0ULL);
83}
84
85static inline void qdisc_watchdog_schedule(struct qdisc_watchdog *wd,
86 psched_time_t expires)
87{
88 qdisc_watchdog_schedule_ns(wd, PSCHED_TICKS2NS(expires));
89}
90
91void qdisc_watchdog_cancel(struct qdisc_watchdog *wd);
92
93extern struct Qdisc_ops pfifo_qdisc_ops;
94extern struct Qdisc_ops bfifo_qdisc_ops;
95extern struct Qdisc_ops pfifo_head_drop_qdisc_ops;
96
97int fifo_set_limit(struct Qdisc *q, unsigned int limit);
98struct Qdisc *fifo_create_dflt(struct Qdisc *sch, struct Qdisc_ops *ops,
99 unsigned int limit,
100 struct netlink_ext_ack *extack);
101
102int register_qdisc(struct Qdisc_ops *qops);
103void unregister_qdisc(struct Qdisc_ops *qops);
104void qdisc_get_default(char *id, size_t len);
105int qdisc_set_default(const char *id);
106
107void qdisc_hash_add(struct Qdisc *q, bool invisible);
108void qdisc_hash_del(struct Qdisc *q);
109struct Qdisc *qdisc_lookup(struct net_device *dev, u32 handle);
110struct Qdisc *qdisc_lookup_rcu(struct net_device *dev, u32 handle);
111struct qdisc_rate_table *qdisc_get_rtab(struct tc_ratespec *r,
112 struct nlattr *tab,
113 struct netlink_ext_ack *extack);
114void qdisc_put_rtab(struct qdisc_rate_table *tab);
115void qdisc_put_stab(struct qdisc_size_table *tab);
116void qdisc_warn_nonwc(const char *txt, struct Qdisc *qdisc);
117bool sch_direct_xmit(struct sk_buff *skb, struct Qdisc *q,
118 struct net_device *dev, struct netdev_queue *txq,
119 spinlock_t *root_lock, bool validate);
120
121void __qdisc_run(struct Qdisc *q);
122
123static inline void qdisc_run(struct Qdisc *q)
124{
125 if (qdisc_run_begin(q)) {
126 __qdisc_run(q);
127 qdisc_run_end(q);
128 }
129}
130
131/* Calculate maximal size of packet seen by hard_start_xmit
132 routine of this device.
133 */
134static inline unsigned int psched_mtu(const struct net_device *dev)
135{
136 return dev->mtu + dev->hard_header_len;
137}
138
139static inline struct net *qdisc_net(struct Qdisc *q)
140{
141 return dev_net(q->dev_queue->dev);
142}
143
144struct tc_query_caps_base {
145 enum tc_setup_type type;
146 void *caps;
147};
148
149struct tc_cbs_qopt_offload {
150 u8 enable;
151 s32 queue;
152 s32 hicredit;
153 s32 locredit;
154 s32 idleslope;
155 s32 sendslope;
156};
157
158struct tc_etf_qopt_offload {
159 u8 enable;
160 s32 queue;
161};
162
163struct tc_taprio_caps {
164 bool supports_queue_max_sdu:1;
165};
166
167struct tc_taprio_sched_entry {
168 u8 command; /* TC_TAPRIO_CMD_* */
169
170 /* The gate_mask in the offloading side refers to traffic classes */
171 u32 gate_mask;
172 u32 interval;
173};
174
175struct tc_taprio_qopt_offload {
176 u8 enable;
177 ktime_t base_time;
178 u64 cycle_time;
179 u64 cycle_time_extension;
180 u32 max_sdu[TC_MAX_QUEUE];
181
182 size_t num_entries;
183 struct tc_taprio_sched_entry entries[];
184};
185
186#if IS_ENABLED(CONFIG_NET_SCH_TAPRIO)
187
188/* Reference counting */
189struct tc_taprio_qopt_offload *taprio_offload_get(struct tc_taprio_qopt_offload
190 *offload);
191void taprio_offload_free(struct tc_taprio_qopt_offload *offload);
192
193#else
194
195/* Reference counting */
196static inline struct tc_taprio_qopt_offload *
197taprio_offload_get(struct tc_taprio_qopt_offload *offload)
198{
199 return NULL;
200}
201
202static inline void taprio_offload_free(struct tc_taprio_qopt_offload *offload)
203{
204}
205
206#endif
207
208/* Ensure skb_mstamp_ns, which might have been populated with the txtime, is
209 * not mistaken for a software timestamp, because this will otherwise prevent
210 * the dispatch of hardware timestamps to the socket.
211 */
212static inline void skb_txtime_consumed(struct sk_buff *skb)
213{
214 skb->tstamp = ktime_set(0, 0);
215}
216
217struct tc_skb_cb {
218 struct qdisc_skb_cb qdisc_cb;
219
220 u16 mru;
221 u8 post_ct:1;
222 u8 post_ct_snat:1;
223 u8 post_ct_dnat:1;
224 u16 zone; /* Only valid if post_ct = true */
225};
226
227static inline struct tc_skb_cb *tc_skb_cb(const struct sk_buff *skb)
228{
229 struct tc_skb_cb *cb = (struct tc_skb_cb *)skb->cb;
230
231 BUILD_BUG_ON(sizeof(*cb) > sizeof_field(struct sk_buff, cb));
232 return cb;
233}
234
235static inline bool tc_qdisc_stats_dump(struct Qdisc *sch,
236 unsigned long cl,
237 struct qdisc_walker *arg)
238{
239 if (arg->count >= arg->skip && arg->fn(sch, cl, arg) < 0) {
240 arg->stop = 1;
241 return false;
242 }
243
244 arg->count++;
245 return true;
246}
247
248#endif