1 /*
2  * Copyright (C) 2016 Netronome Systems, Inc.
3  *
4  * This software is dual licensed under the GNU General License Version 2,
5  * June 1991 as shown in the file COPYING in the top-level directory of this
6  * source tree or the BSD 2-Clause License provided below.  You have the
7  * option to license this software under the complete terms of either license.
8  *
9  * The BSD 2-Clause License:
10  *
11  *     Redistribution and use in source and binary forms, with or
12  *     without modification, are permitted provided that the following
13  *     conditions are met:
14  *
15  *      1. Redistributions of source code must retain the above
16  *         copyright notice, this list of conditions and the following
17  *         disclaimer.
18  *
19  *      2. Redistributions in binary form must reproduce the above
20  *         copyright notice, this list of conditions and the following
21  *         disclaimer in the documentation and/or other materials
22  *         provided with the distribution.
23  *
24  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
25  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
26  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
27  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
28  * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
29  * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
30  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
31  * SOFTWARE.
32  */
33 
34 #ifndef __NFP_BPF_H__
35 #define __NFP_BPF_H__ 1
36 
37 #include <linux/bitfield.h>
38 #include <linux/bpf.h>
39 #include <linux/bpf_verifier.h>
40 #include <linux/list.h>
41 #include <linux/types.h>
42 
43 #include "../nfp_asm.h"
44 #include "../nfp_net.h"
45 
46 /* For branch fixup logic use up-most byte of branch instruction as scratch
47  * area.  Remember to clear this before sending instructions to HW!
48  */
49 #define OP_BR_SPECIAL	0xff00000000000000ULL
50 
51 enum br_special {
52 	OP_BR_NORMAL = 0,
53 	OP_BR_GO_OUT,
54 	OP_BR_GO_ABORT,
55 };
56 
57 enum static_regs {
58 	STATIC_REG_IMM		= 21, /* Bank AB */
59 	STATIC_REG_STACK	= 22, /* Bank A */
60 	STATIC_REG_PKT_LEN	= 22, /* Bank B */
61 };
62 
63 enum pkt_vec {
64 	PKT_VEC_PKT_LEN		= 0,
65 	PKT_VEC_PKT_PTR		= 2,
66 };
67 
68 enum nfp_bpf_action_type {
69 	NN_ACT_TC_DROP,
70 	NN_ACT_TC_REDIR,
71 	NN_ACT_DIRECT,
72 	NN_ACT_XDP,
73 };
74 
75 #define pv_len(np)	reg_lm(1, PKT_VEC_PKT_LEN)
76 #define pv_ctm_ptr(np)	reg_lm(1, PKT_VEC_PKT_PTR)
77 
78 #define stack_reg(np)	reg_a(STATIC_REG_STACK)
79 #define stack_imm(np)	imm_b(np)
80 #define plen_reg(np)	reg_b(STATIC_REG_PKT_LEN)
81 #define pptr_reg(np)	pv_ctm_ptr(np)
82 #define imm_a(np)	reg_a(STATIC_REG_IMM)
83 #define imm_b(np)	reg_b(STATIC_REG_IMM)
84 #define imm_both(np)	reg_both(STATIC_REG_IMM)
85 
86 #define NFP_BPF_ABI_FLAGS	reg_imm(0)
87 #define   NFP_BPF_ABI_FLAG_MARK	1
88 
89 struct nfp_prog;
90 struct nfp_insn_meta;
91 typedef int (*instr_cb_t)(struct nfp_prog *, struct nfp_insn_meta *);
92 
93 #define nfp_prog_first_meta(nfp_prog)					\
94 	list_first_entry(&(nfp_prog)->insns, struct nfp_insn_meta, l)
95 #define nfp_prog_last_meta(nfp_prog)					\
96 	list_last_entry(&(nfp_prog)->insns, struct nfp_insn_meta, l)
97 #define nfp_meta_next(meta)	list_next_entry(meta, l)
98 #define nfp_meta_prev(meta)	list_prev_entry(meta, l)
99 
100 /**
101  * struct nfp_insn_meta - BPF instruction wrapper
102  * @insn: BPF instruction
103  * @ptr: pointer type for memory operations
104  * @ptr_not_const: pointer is not always constant
105  * @off: index of first generated machine instruction (in nfp_prog.prog)
106  * @n: eBPF instruction number
107  * @skip: skip this instruction (optimized out)
108  * @double_cb: callback for second part of the instruction
109  * @l: link on nfp_prog->insns list
110  */
111 struct nfp_insn_meta {
112 	struct bpf_insn insn;
113 	struct bpf_reg_state ptr;
114 	bool ptr_not_const;
115 	unsigned int off;
116 	unsigned short n;
117 	bool skip;
118 	instr_cb_t double_cb;
119 
120 	struct list_head l;
121 };
122 
123 #define BPF_SIZE_MASK	0x18
124 
125 static inline u8 mbpf_class(const struct nfp_insn_meta *meta)
126 {
127 	return BPF_CLASS(meta->insn.code);
128 }
129 
130 static inline u8 mbpf_src(const struct nfp_insn_meta *meta)
131 {
132 	return BPF_SRC(meta->insn.code);
133 }
134 
135 static inline u8 mbpf_op(const struct nfp_insn_meta *meta)
136 {
137 	return BPF_OP(meta->insn.code);
138 }
139 
140 static inline u8 mbpf_mode(const struct nfp_insn_meta *meta)
141 {
142 	return BPF_MODE(meta->insn.code);
143 }
144 
145 /**
146  * struct nfp_prog - nfp BPF program
147  * @prog: machine code
148  * @prog_len: number of valid instructions in @prog array
149  * @__prog_alloc_len: alloc size of @prog array
150  * @act: BPF program/action type (TC DA, TC with action, XDP etc.)
151  * @num_regs: number of registers used by this program
152  * @regs_per_thread: number of basic registers allocated per thread
153  * @start_off: address of the first instruction in the memory
154  * @tgt_out: jump target for normal exit
155  * @tgt_abort: jump target for abort (e.g. access outside of packet buffer)
156  * @tgt_done: jump target to get the next packet
157  * @n_translated: number of successfully translated instructions (for errors)
158  * @error: error code if something went wrong
159  * @stack_depth: max stack depth from the verifier
160  * @insns: list of BPF instruction wrappers (struct nfp_insn_meta)
161  */
162 struct nfp_prog {
163 	u64 *prog;
164 	unsigned int prog_len;
165 	unsigned int __prog_alloc_len;
166 
167 	enum nfp_bpf_action_type act;
168 
169 	unsigned int num_regs;
170 	unsigned int regs_per_thread;
171 
172 	unsigned int start_off;
173 	unsigned int tgt_out;
174 	unsigned int tgt_abort;
175 	unsigned int tgt_done;
176 
177 	unsigned int n_translated;
178 	int error;
179 
180 	unsigned int stack_depth;
181 
182 	struct list_head insns;
183 };
184 
185 struct nfp_bpf_result {
186 	unsigned int n_instr;
187 	bool dense_mode;
188 };
189 
190 int
191 nfp_bpf_jit(struct bpf_prog *filter, void *prog, enum nfp_bpf_action_type act,
192 	    unsigned int prog_start, unsigned int prog_done,
193 	    unsigned int prog_sz, struct nfp_bpf_result *res);
194 
195 int nfp_prog_verify(struct nfp_prog *nfp_prog, struct bpf_prog *prog);
196 
197 struct nfp_net;
198 struct tc_cls_bpf_offload;
199 
200 /**
201  * struct nfp_net_bpf_priv - per-vNIC BPF private data
202  * @rx_filter:		Filter offload statistics - dropped packets/bytes
203  * @rx_filter_prev:	Filter offload statistics - values from previous update
204  * @rx_filter_change:	Jiffies when statistics last changed
205  * @rx_filter_stats_timer:  Timer for polling filter offload statistics
206  * @rx_filter_lock:	Lock protecting timer state changes (teardown)
207  */
208 struct nfp_net_bpf_priv {
209 	struct nfp_stat_pair rx_filter, rx_filter_prev;
210 	unsigned long rx_filter_change;
211 	struct timer_list rx_filter_stats_timer;
212 	struct nfp_net *nn;
213 	spinlock_t rx_filter_lock;
214 };
215 
216 int nfp_net_bpf_offload(struct nfp_net *nn, struct tc_cls_bpf_offload *cls_bpf);
217 void nfp_net_filter_stats_timer(struct timer_list *t);
218 
219 #endif
220