Linux Audio

Check our new training course

Loading...
v6.13.7
  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
v3.1
 
  1#ifndef __NET_PKT_SCHED_H
  2#define __NET_PKT_SCHED_H
  3
  4#include <linux/jiffies.h>
  5#include <linux/ktime.h>
 
 
  6#include <net/sch_generic.h>
 
 
 
 
 
  7
  8struct qdisc_walker {
  9	int	stop;
 10	int	skip;
 11	int	count;
 12	int	(*fn)(struct Qdisc *, unsigned long cl, struct qdisc_walker *);
 13};
 14
 15#define QDISC_ALIGNTO		64
 16#define QDISC_ALIGN(len)	(((len) + QDISC_ALIGNTO-1) & ~(QDISC_ALIGNTO-1))
 
 
 17
 18static inline void *qdisc_priv(struct Qdisc *q)
 19{
 20	return (char *) q + QDISC_ALIGN(sizeof(struct Qdisc));
 21}
 22
 23/* 
 24   Timer resolution MUST BE < 10% of min_schedulable_packet_size/bandwidth
 25   
 26   Normal IP packet size ~ 512byte, hence:
 27
 28   0.5Kbyte/1Mbyte/sec = 0.5msec, so that we need 50usec timer for
 29   10Mbit ethernet.
 30
 31   10msec resolution -> <50Kbit/sec.
 32   
 33   The result: [34]86 is not good choice for QoS router :-(
 34
 35   The things are not so bad, because we may use artificial
 36   clock evaluated by integration of network data flow
 37   in the most critical places.
 38 */
 39
 40typedef u64	psched_time_t;
 41typedef long	psched_tdiff_t;
 42
 43/* Avoid doing 64 bit divide */
 44#define PSCHED_SHIFT			6
 45#define PSCHED_TICKS2NS(x)		((s64)(x) << PSCHED_SHIFT)
 46#define PSCHED_NS2TICKS(x)		((x) >> PSCHED_SHIFT)
 47
 48#define PSCHED_TICKS_PER_SEC		PSCHED_NS2TICKS(NSEC_PER_SEC)
 49#define PSCHED_PASTPERFECT		0
 50
 51static inline psched_time_t psched_get_time(void)
 52{
 53	return PSCHED_NS2TICKS(ktime_to_ns(ktime_get()));
 54}
 55
 56static inline psched_tdiff_t
 57psched_tdiff_bounded(psched_time_t tv1, psched_time_t tv2, psched_time_t bound)
 58{
 59	return min(tv1 - tv2, bound);
 60}
 61
 62struct qdisc_watchdog {
 63	struct hrtimer	timer;
 64	struct Qdisc	*qdisc;
 65};
 66
 67extern void qdisc_watchdog_init(struct qdisc_watchdog *wd, struct Qdisc *qdisc);
 68extern void qdisc_watchdog_schedule(struct qdisc_watchdog *wd,
 69				    psched_time_t expires);
 70extern void qdisc_watchdog_cancel(struct qdisc_watchdog *wd);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 71
 72extern struct Qdisc_ops pfifo_qdisc_ops;
 73extern struct Qdisc_ops bfifo_qdisc_ops;
 74extern struct Qdisc_ops pfifo_head_drop_qdisc_ops;
 75
 76extern int fifo_set_limit(struct Qdisc *q, unsigned int limit);
 77extern struct Qdisc *fifo_create_dflt(struct Qdisc *sch, struct Qdisc_ops *ops,
 78				      unsigned int limit);
 79
 80extern int register_qdisc(struct Qdisc_ops *qops);
 81extern int unregister_qdisc(struct Qdisc_ops *qops);
 82extern void qdisc_list_del(struct Qdisc *q);
 83extern struct Qdisc *qdisc_lookup(struct net_device *dev, u32 handle);
 84extern struct Qdisc *qdisc_lookup_class(struct net_device *dev, u32 handle);
 85extern struct qdisc_rate_table *qdisc_get_rtab(struct tc_ratespec *r,
 86		struct nlattr *tab);
 87extern void qdisc_put_rtab(struct qdisc_rate_table *tab);
 88extern void qdisc_put_stab(struct qdisc_size_table *tab);
 89extern void qdisc_warn_nonwc(char *txt, struct Qdisc *qdisc);
 90extern int sch_direct_xmit(struct sk_buff *skb, struct Qdisc *q,
 91			   struct net_device *dev, struct netdev_queue *txq,
 92			   spinlock_t *root_lock);
 
 
 
 
 
 
 
 
 93
 94extern void __qdisc_run(struct Qdisc *q);
 95
 96static inline void qdisc_run(struct Qdisc *q)
 97{
 98	if (qdisc_run_begin(q))
 99		__qdisc_run(q);
 
 
100}
101
102extern int tc_classify_compat(struct sk_buff *skb, const struct tcf_proto *tp,
103			      struct tcf_result *res);
104extern int tc_classify(struct sk_buff *skb, const struct tcf_proto *tp,
105		       struct tcf_result *res);
106
107/* Calculate maximal size of packet seen by hard_start_xmit
108   routine of this device.
109 */
110static inline unsigned psched_mtu(const struct net_device *dev)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
111{
112	return dev->mtu + dev->hard_header_len;
 
 
 
 
 
 
 
 
 
 
 
 
 
113}
114
115#endif