Linux Audio

Check our new training course

In-person Linux kernel drivers training

Jun 16-20, 2025
Register
Loading...
v5.4
  1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef __NET_ACT_API_H
  3#define __NET_ACT_API_H
  4
  5/*
  6 * Public action API for classifiers/qdiscs
  7*/
  8
  9#include <linux/refcount.h>
 10#include <net/sch_generic.h>
 11#include <net/pkt_sched.h>
 12#include <net/net_namespace.h>
 13#include <net/netns/generic.h>
 14
 15struct tcf_idrinfo {
 16	struct mutex	lock;
 17	struct idr	action_idr;
 18	struct net	*net;
 
 
 19};
 20
 21struct tc_action_ops;
 22
 23struct tc_action {
 24	const struct tc_action_ops	*ops;
 25	__u32				type; /* for backward compat(TCA_OLD_COMPAT) */
 26	__u32				order;
 27	struct tcf_idrinfo		*idrinfo;
 
 28
 
 29	u32				tcfa_index;
 30	refcount_t			tcfa_refcnt;
 31	atomic_t			tcfa_bindcnt;
 
 32	int				tcfa_action;
 33	struct tcf_t			tcfa_tm;
 34	struct gnet_stats_basic_packed	tcfa_bstats;
 35	struct gnet_stats_basic_packed	tcfa_bstats_hw;
 36	struct gnet_stats_queue		tcfa_qstats;
 37	struct net_rate_estimator __rcu *tcfa_rate_est;
 38	spinlock_t			tcfa_lock;
 
 39	struct gnet_stats_basic_cpu __percpu *cpu_bstats;
 40	struct gnet_stats_basic_cpu __percpu *cpu_bstats_hw;
 41	struct gnet_stats_queue __percpu *cpu_qstats;
 42	struct tc_cookie	__rcu *act_cookie;
 43	struct tcf_chain	__rcu *goto_chain;
 44};
 
 45#define tcf_index	common.tcfa_index
 46#define tcf_refcnt	common.tcfa_refcnt
 47#define tcf_bindcnt	common.tcfa_bindcnt
 
 48#define tcf_action	common.tcfa_action
 49#define tcf_tm		common.tcfa_tm
 50#define tcf_bstats	common.tcfa_bstats
 51#define tcf_qstats	common.tcfa_qstats
 52#define tcf_rate_est	common.tcfa_rate_est
 53#define tcf_lock	common.tcfa_lock
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 54
 55/* Update lastuse only if needed, to avoid dirtying a cache line.
 56 * We use a temp variable to avoid fetching jiffies twice.
 57 */
 58static inline void tcf_lastuse_update(struct tcf_t *tm)
 59{
 60	unsigned long now = jiffies;
 61
 62	if (tm->lastuse != now)
 63		tm->lastuse = now;
 64	if (unlikely(!tm->firstuse))
 65		tm->firstuse = now;
 66}
 67
 68static inline void tcf_tm_dump(struct tcf_t *dtm, const struct tcf_t *stm)
 69{
 70	dtm->install = jiffies_to_clock_t(jiffies - stm->install);
 71	dtm->lastuse = jiffies_to_clock_t(jiffies - stm->lastuse);
 72	dtm->firstuse = jiffies_to_clock_t(jiffies - stm->firstuse);
 73	dtm->expires = jiffies_to_clock_t(stm->expires);
 74}
 75
 76#ifdef CONFIG_NET_CLS_ACT
 77
 78#define ACT_P_CREATED 1
 79#define ACT_P_DELETED 1
 80
 81typedef void (*tc_action_priv_destructor)(void *priv);
 82
 83struct tc_action_ops {
 84	struct list_head head;
 85	char    kind[IFNAMSIZ];
 86	enum tca_id  id; /* identifier should match kind */
 87	size_t	size;
 88	struct module		*owner;
 89	int     (*act)(struct sk_buff *, const struct tc_action *,
 90		       struct tcf_result *); /* called under RCU BH lock*/
 91	int     (*dump)(struct sk_buff *, struct tc_action *, int, int);
 92	void	(*cleanup)(struct tc_action *);
 93	int     (*lookup)(struct net *net, struct tc_action **a, u32 index);
 94	int     (*init)(struct net *net, struct nlattr *nla,
 95			struct nlattr *est, struct tc_action **act, int ovr,
 96			int bind, bool rtnl_held, struct tcf_proto *tp,
 97			struct netlink_ext_ack *extack);
 98	int     (*walk)(struct net *, struct sk_buff *,
 99			struct netlink_callback *, int,
100			const struct tc_action_ops *,
101			struct netlink_ext_ack *);
102	void	(*stats_update)(struct tc_action *, u64, u32, u64, bool);
103	size_t  (*get_fill_size)(const struct tc_action *act);
104	struct net_device *(*get_dev)(const struct tc_action *a,
105				      tc_action_priv_destructor *destructor);
106	struct psample_group *
107	(*get_psample_group)(const struct tc_action *a,
108			     tc_action_priv_destructor *destructor);
109};
110
111struct tc_action_net {
112	struct tcf_idrinfo *idrinfo;
113	const struct tc_action_ops *ops;
114};
115
116static inline
117int tc_action_net_init(struct net *net, struct tc_action_net *tn,
118		       const struct tc_action_ops *ops)
119{
120	int err = 0;
121
122	tn->idrinfo = kmalloc(sizeof(*tn->idrinfo), GFP_KERNEL);
123	if (!tn->idrinfo)
124		return -ENOMEM;
125	tn->ops = ops;
126	tn->idrinfo->net = net;
127	mutex_init(&tn->idrinfo->lock);
128	idr_init(&tn->idrinfo->action_idr);
129	return err;
130}
131
132void tcf_idrinfo_destroy(const struct tc_action_ops *ops,
133			 struct tcf_idrinfo *idrinfo);
134
135static inline void tc_action_net_exit(struct list_head *net_list,
136				      unsigned int id)
137{
138	struct net *net;
139
140	rtnl_lock();
141	list_for_each_entry(net, net_list, exit_list) {
142		struct tc_action_net *tn = net_generic(net, id);
143
144		tcf_idrinfo_destroy(tn->ops, tn->idrinfo);
145		kfree(tn->idrinfo);
146	}
147	rtnl_unlock();
148}
149
150int tcf_generic_walker(struct tc_action_net *tn, struct sk_buff *skb,
151		       struct netlink_callback *cb, int type,
152		       const struct tc_action_ops *ops,
153		       struct netlink_ext_ack *extack);
154int tcf_idr_search(struct tc_action_net *tn, struct tc_action **a, u32 index);
155int tcf_idr_create(struct tc_action_net *tn, u32 index, struct nlattr *est,
156		   struct tc_action **a, const struct tc_action_ops *ops,
157		   int bind, bool cpustats);
158void tcf_idr_insert(struct tc_action_net *tn, struct tc_action *a);
159
160void tcf_idr_cleanup(struct tc_action_net *tn, u32 index);
161int tcf_idr_check_alloc(struct tc_action_net *tn, u32 *index,
162			struct tc_action **a, int bind);
163int __tcf_idr_release(struct tc_action *a, bool bind, bool strict);
164
165static inline int tcf_idr_release(struct tc_action *a, bool bind)
166{
167	return __tcf_idr_release(a, bind, false);
168}
169
170int tcf_register_action(struct tc_action_ops *a, struct pernet_operations *ops);
171int tcf_unregister_action(struct tc_action_ops *a,
172			  struct pernet_operations *ops);
173int tcf_action_destroy(struct tc_action *actions[], int bind);
174int tcf_action_exec(struct sk_buff *skb, struct tc_action **actions,
175		    int nr_actions, struct tcf_result *res);
176int tcf_action_init(struct net *net, struct tcf_proto *tp, struct nlattr *nla,
177		    struct nlattr *est, char *name, int ovr, int bind,
178		    struct tc_action *actions[], size_t *attr_size,
179		    bool rtnl_held, struct netlink_ext_ack *extack);
180struct tc_action *tcf_action_init_1(struct net *net, struct tcf_proto *tp,
181				    struct nlattr *nla, struct nlattr *est,
182				    char *name, int ovr, int bind,
183				    bool rtnl_held,
184				    struct netlink_ext_ack *extack);
185int tcf_action_dump(struct sk_buff *skb, struct tc_action *actions[], int bind,
186		    int ref);
187int tcf_action_dump_old(struct sk_buff *skb, struct tc_action *a, int, int);
188int tcf_action_dump_1(struct sk_buff *skb, struct tc_action *a, int, int);
189int tcf_action_copy_stats(struct sk_buff *, struct tc_action *, int);
190
191int tcf_action_check_ctrlact(int action, struct tcf_proto *tp,
192			     struct tcf_chain **handle,
193			     struct netlink_ext_ack *newchain);
194struct tcf_chain *tcf_action_set_ctrlact(struct tc_action *a, int action,
195					 struct tcf_chain *newchain);
196#endif /* CONFIG_NET_CLS_ACT */
197
198static inline void tcf_action_stats_update(struct tc_action *a, u64 bytes,
199					   u64 packets, u64 lastuse, bool hw)
200{
201#ifdef CONFIG_NET_CLS_ACT
202	if (!a->ops->stats_update)
203		return;
204
205	a->ops->stats_update(a, bytes, packets, lastuse, hw);
206#endif
207}
208
209
210#endif
v4.10.11
 
  1#ifndef __NET_ACT_API_H
  2#define __NET_ACT_API_H
  3
  4/*
  5 * Public action API for classifiers/qdiscs
  6*/
  7
 
  8#include <net/sch_generic.h>
  9#include <net/pkt_sched.h>
 10#include <net/net_namespace.h>
 11#include <net/netns/generic.h>
 12
 13
 14struct tcf_hashinfo {
 15	struct hlist_head	*htab;
 16	unsigned int		hmask;
 17	spinlock_t		lock;
 18	u32			index;
 19};
 20
 21struct tc_action_ops;
 22
 23struct tc_action {
 24	const struct tc_action_ops	*ops;
 25	__u32				type; /* for backward compat(TCA_OLD_COMPAT) */
 26	__u32				order;
 27	struct list_head		list;
 28	struct tcf_hashinfo		*hinfo;
 29
 30	struct hlist_node		tcfa_head;
 31	u32				tcfa_index;
 32	int				tcfa_refcnt;
 33	int				tcfa_bindcnt;
 34	u32				tcfa_capab;
 35	int				tcfa_action;
 36	struct tcf_t			tcfa_tm;
 37	struct gnet_stats_basic_packed	tcfa_bstats;
 
 38	struct gnet_stats_queue		tcfa_qstats;
 39	struct net_rate_estimator __rcu *tcfa_rate_est;
 40	spinlock_t			tcfa_lock;
 41	struct rcu_head			tcfa_rcu;
 42	struct gnet_stats_basic_cpu __percpu *cpu_bstats;
 
 43	struct gnet_stats_queue __percpu *cpu_qstats;
 
 
 44};
 45#define tcf_head	common.tcfa_head
 46#define tcf_index	common.tcfa_index
 47#define tcf_refcnt	common.tcfa_refcnt
 48#define tcf_bindcnt	common.tcfa_bindcnt
 49#define tcf_capab	common.tcfa_capab
 50#define tcf_action	common.tcfa_action
 51#define tcf_tm		common.tcfa_tm
 52#define tcf_bstats	common.tcfa_bstats
 53#define tcf_qstats	common.tcfa_qstats
 54#define tcf_rate_est	common.tcfa_rate_est
 55#define tcf_lock	common.tcfa_lock
 56#define tcf_rcu		common.tcfa_rcu
 57
 58static inline unsigned int tcf_hash(u32 index, unsigned int hmask)
 59{
 60	return index & hmask;
 61}
 62
 63static inline int tcf_hashinfo_init(struct tcf_hashinfo *hf, unsigned int mask)
 64{
 65	int i;
 66
 67	spin_lock_init(&hf->lock);
 68	hf->index = 0;
 69	hf->hmask = mask;
 70	hf->htab = kzalloc((mask + 1) * sizeof(struct hlist_head),
 71			   GFP_KERNEL);
 72	if (!hf->htab)
 73		return -ENOMEM;
 74	for (i = 0; i < mask + 1; i++)
 75		INIT_HLIST_HEAD(&hf->htab[i]);
 76	return 0;
 77}
 78
 79/* Update lastuse only if needed, to avoid dirtying a cache line.
 80 * We use a temp variable to avoid fetching jiffies twice.
 81 */
 82static inline void tcf_lastuse_update(struct tcf_t *tm)
 83{
 84	unsigned long now = jiffies;
 85
 86	if (tm->lastuse != now)
 87		tm->lastuse = now;
 88	if (unlikely(!tm->firstuse))
 89		tm->firstuse = now;
 90}
 91
 92static inline void tcf_tm_dump(struct tcf_t *dtm, const struct tcf_t *stm)
 93{
 94	dtm->install = jiffies_to_clock_t(jiffies - stm->install);
 95	dtm->lastuse = jiffies_to_clock_t(jiffies - stm->lastuse);
 96	dtm->firstuse = jiffies_to_clock_t(jiffies - stm->firstuse);
 97	dtm->expires = jiffies_to_clock_t(stm->expires);
 98}
 99
100#ifdef CONFIG_NET_CLS_ACT
101
102#define ACT_P_CREATED 1
103#define ACT_P_DELETED 1
104
 
 
105struct tc_action_ops {
106	struct list_head head;
107	char    kind[IFNAMSIZ];
108	__u32   type; /* TBD to match kind */
109	size_t	size;
110	struct module		*owner;
111	int     (*act)(struct sk_buff *, const struct tc_action *,
112		       struct tcf_result *);
113	int     (*dump)(struct sk_buff *, struct tc_action *, int, int);
114	void	(*cleanup)(struct tc_action *, int bind);
115	int     (*lookup)(struct net *, struct tc_action **, u32);
116	int     (*init)(struct net *net, struct nlattr *nla,
117			struct nlattr *est, struct tc_action **act, int ovr,
118			int bind);
 
119	int     (*walk)(struct net *, struct sk_buff *,
120			struct netlink_callback *, int, const struct tc_action_ops *);
121	void	(*stats_update)(struct tc_action *, u64, u32, u64);
122	int	(*get_dev)(const struct tc_action *a, struct net *net,
123			   struct net_device **mirred_dev);
 
 
 
 
 
 
124};
125
126struct tc_action_net {
127	struct tcf_hashinfo *hinfo;
128	const struct tc_action_ops *ops;
129};
130
131static inline
132int tc_action_net_init(struct tc_action_net *tn,
133		       const struct tc_action_ops *ops, unsigned int mask)
134{
135	int err = 0;
136
137	tn->hinfo = kmalloc(sizeof(*tn->hinfo), GFP_KERNEL);
138	if (!tn->hinfo)
139		return -ENOMEM;
140	tn->ops = ops;
141	err = tcf_hashinfo_init(tn->hinfo, mask);
142	if (err)
143		kfree(tn->hinfo);
144	return err;
145}
146
147void tcf_hashinfo_destroy(const struct tc_action_ops *ops,
148			  struct tcf_hashinfo *hinfo);
149
150static inline void tc_action_net_exit(struct tc_action_net *tn)
 
151{
152	tcf_hashinfo_destroy(tn->ops, tn->hinfo);
153	kfree(tn->hinfo);
 
 
 
 
 
 
 
 
154}
155
156int tcf_generic_walker(struct tc_action_net *tn, struct sk_buff *skb,
157		       struct netlink_callback *cb, int type,
158		       const struct tc_action_ops *ops);
159int tcf_hash_search(struct tc_action_net *tn, struct tc_action **a, u32 index);
160u32 tcf_hash_new_index(struct tc_action_net *tn);
161bool tcf_hash_check(struct tc_action_net *tn, u32 index, struct tc_action **a,
162		    int bind);
163int tcf_hash_create(struct tc_action_net *tn, u32 index, struct nlattr *est,
164		    struct tc_action **a, const struct tc_action_ops *ops, int bind,
165		    bool cpustats);
166void tcf_hash_cleanup(struct tc_action *a, struct nlattr *est);
167void tcf_hash_insert(struct tc_action_net *tn, struct tc_action *a);
168
169int __tcf_hash_release(struct tc_action *a, bool bind, bool strict);
170
171static inline int tcf_hash_release(struct tc_action *a, bool bind)
172{
173	return __tcf_hash_release(a, bind, false);
174}
175
176int tcf_register_action(struct tc_action_ops *a, struct pernet_operations *ops);
177int tcf_unregister_action(struct tc_action_ops *a,
178			  struct pernet_operations *ops);
179int tcf_action_destroy(struct list_head *actions, int bind);
180int tcf_action_exec(struct sk_buff *skb, struct tc_action **actions,
181		    int nr_actions, struct tcf_result *res);
182int tcf_action_init(struct net *net, struct nlattr *nla,
183				  struct nlattr *est, char *n, int ovr,
184				  int bind, struct list_head *);
185struct tc_action *tcf_action_init_1(struct net *net, struct nlattr *nla,
186				    struct nlattr *est, char *n, int ovr,
187				    int bind);
188int tcf_action_dump(struct sk_buff *skb, struct list_head *, int, int);
 
 
 
 
189int tcf_action_dump_old(struct sk_buff *skb, struct tc_action *a, int, int);
190int tcf_action_dump_1(struct sk_buff *skb, struct tc_action *a, int, int);
191int tcf_action_copy_stats(struct sk_buff *, struct tc_action *, int);
192
 
 
 
 
 
193#endif /* CONFIG_NET_CLS_ACT */
194
195static inline void tcf_action_stats_update(struct tc_action *a, u64 bytes,
196					   u64 packets, u64 lastuse)
197{
198#ifdef CONFIG_NET_CLS_ACT
199	if (!a->ops->stats_update)
200		return;
201
202	a->ops->stats_update(a, bytes, packets, lastuse);
203#endif
204}
 
205
206#endif