blob: 1ca1902af23e95731ab61c00117761f1ff2a9cea [file] [log] [blame]
Thomas Gleixner25763b32019-05-28 10:10:09 -07001/* SPDX-License-Identifier: GPL-2.0-only */
Alexei Starovoitov99c55f72014-09-26 00:16:57 -07002/* Copyright (c) 2011-2014 PLUMgrid, http://plumgrid.com
Alexei Starovoitov99c55f72014-09-26 00:16:57 -07003 */
4#ifndef _LINUX_BPF_H
5#define _LINUX_BPF_H 1
6
7#include <uapi/linux/bpf.h>
Delyan Kratunovd687f622022-06-14 23:10:42 +00008#include <uapi/linux/filter.h>
Daniel Borkmann74451e662017-02-16 22:24:50 +01009
Alexei Starovoitov99c55f72014-09-26 00:16:57 -070010#include <linux/workqueue.h>
Alexei Starovoitovdb20fd22014-09-26 00:16:59 -070011#include <linux/file.h>
Alexei Starovoitovb121d1e2016-03-07 21:57:13 -080012#include <linux/percpu.h>
Zi Shen Lim002245c2016-06-08 21:18:47 -070013#include <linux/err.h>
Daniel Borkmann74451e662017-02-16 22:24:50 +010014#include <linux/rbtree_latch.h>
David S. Millerd6e1e462017-08-19 23:34:03 -070015#include <linux/numa.h>
Andrii Nakryikofc970222019-11-17 09:28:04 -080016#include <linux/mm_types.h>
Jakub Kicinskiab3f0062017-11-03 13:56:17 -070017#include <linux/wait.h>
Alexei Starovoitovfec56f52019-11-14 10:57:04 -080018#include <linux/refcount.h>
19#include <linux/mutex.h>
Martin KaFai Lau85d33df2020-01-08 16:35:05 -080020#include <linux/module.h>
Jiri Olsabfea9a82020-03-12 20:55:59 +010021#include <linux/kallsyms.h>
Alexei Starovoitov2c78ee82020-05-13 16:03:54 -070022#include <linux/capability.h>
Roman Gushchin48edc1f2020-12-01 13:58:32 -080023#include <linux/sched/mm.h>
24#include <linux/slab.h>
Alexei Starovoitove21aa342021-03-16 14:00:07 -070025#include <linux/percpu-refcount.h>
Delyan Kratunovd687f622022-06-14 23:10:42 +000026#include <linux/stddef.h>
Alexei Starovoitovaf2ac3e2021-05-13 17:36:05 -070027#include <linux/bpfptr.h>
Kumar Kartikeya Dwivedi14a324f2022-04-25 03:18:55 +053028#include <linux/btf.h>
Delyan Kratunov8c7dcb82022-06-14 23:10:46 +000029#include <linux/rcupdate_trace.h>
Peter Zijlstrac86df29d2022-11-03 13:00:14 +010030#include <linux/static_call.h>
Alexei Starovoitov99c55f72014-09-26 00:16:57 -070031
Jakub Kicinskicae19272017-12-27 18:39:05 -080032struct bpf_verifier_env;
Alexei Starovoitov9e15db62019-10-15 20:25:00 -070033struct bpf_verifier_log;
Daniel Borkmann3b1efb12016-06-15 22:47:14 +020034struct perf_event;
John Fastabend174a79f2017-08-15 22:32:47 -070035struct bpf_prog;
Daniel Borkmannda765a22019-11-22 21:07:58 +010036struct bpf_prog_aux;
Alexei Starovoitov99c55f72014-09-26 00:16:57 -070037struct bpf_map;
John Fastabend4f738ad2018-03-18 12:57:10 -070038struct sock;
Martin KaFai Laua26ca7c2018-04-18 15:56:03 -070039struct seq_file;
Roman Gushchin1b2b2342018-12-10 15:43:00 -080040struct btf;
Daniel Borkmanne8d2bec2018-08-12 01:59:17 +020041struct btf_type;
Alexei Starovoitov3dec5412019-10-15 20:25:03 -070042struct exception_table_entry;
Yonghong Songae243452020-05-09 10:58:59 -070043struct seq_operations;
Yonghong Songf9c79272020-07-23 11:41:10 -070044struct bpf_iter_aux_info;
KP Singhf836a562020-08-25 20:29:15 +020045struct bpf_local_storage;
46struct bpf_local_storage_map;
Andrii Nakryiko36e68442020-11-09 17:19:31 -080047struct kobject;
Roman Gushchin48edc1f2020-12-01 13:58:32 -080048struct mem_cgroup;
Jiri Olsa861de022021-03-26 11:59:00 +010049struct module;
Yonghong Song69c087b2021-02-26 12:49:25 -080050struct bpf_func_state;
Song Liu00963a22022-07-19 17:21:26 -070051struct ftrace_ops;
Hao Luod4ccaf52022-08-24 16:31:13 -070052struct cgroup;
Alexei Starovoitov99c55f72014-09-26 00:16:57 -070053
Quentin Monnet1b9ed842019-08-20 10:31:50 +010054extern struct idr btf_idr;
55extern spinlock_t btf_idr_lock;
Andrii Nakryiko36e68442020-11-09 17:19:31 -080056extern struct kobject *btf_kobj;
Quentin Monnet1b9ed842019-08-20 10:31:50 +010057
Kees Cook102acba2021-09-28 16:09:46 -070058typedef u64 (*bpf_callback_t)(u64, u64, u64, u64, u64);
Yonghong Songf9c79272020-07-23 11:41:10 -070059typedef int (*bpf_iter_init_seq_priv_t)(void *private_data,
60 struct bpf_iter_aux_info *aux);
Yonghong Song14fc6bd62020-07-23 11:41:09 -070061typedef void (*bpf_iter_fini_seq_priv_t)(void *private_data);
Stanislav Fomichevaf3f41342022-06-28 10:43:04 -070062typedef unsigned int (*bpf_func_t)(const void *,
63 const struct bpf_insn *);
Yonghong Song14fc6bd62020-07-23 11:41:09 -070064struct bpf_iter_seq_info {
65 const struct seq_operations *seq_ops;
66 bpf_iter_init_seq_priv_t init_seq_private;
67 bpf_iter_fini_seq_priv_t fini_seq_private;
68 u32 seq_priv_size;
69};
70
Ricardo Ribalda5d903492021-03-18 21:22:22 +010071/* map is generic key/value storage optionally accessible by eBPF programs */
Alexei Starovoitov99c55f72014-09-26 00:16:57 -070072struct bpf_map_ops {
73 /* funcs callable from userspace (via syscall) */
Jakub Kicinski1110f3a2018-01-11 20:29:03 -080074 int (*map_alloc_check)(union bpf_attr *attr);
Alexei Starovoitov99c55f72014-09-26 00:16:57 -070075 struct bpf_map *(*map_alloc)(union bpf_attr *attr);
Daniel Borkmann61d1b6a2016-06-15 22:47:12 +020076 void (*map_release)(struct bpf_map *map, struct file *map_file);
77 void (*map_free)(struct bpf_map *map);
Alexei Starovoitovdb20fd22014-09-26 00:16:59 -070078 int (*map_get_next_key)(struct bpf_map *map, void *key, void *next_key);
John Fastabendba6b8de2018-04-23 15:39:23 -070079 void (*map_release_uref)(struct bpf_map *map);
Daniel Borkmannc6110222019-05-14 01:18:55 +020080 void *(*map_lookup_elem_sys_only)(struct bpf_map *map, void *key);
Brian Vazquezcb4d03a2020-01-15 10:43:01 -080081 int (*map_lookup_batch)(struct bpf_map *map, const union bpf_attr *attr,
82 union bpf_attr __user *uattr);
Denis Salopek3e87f192021-05-11 23:00:04 +020083 int (*map_lookup_and_delete_elem)(struct bpf_map *map, void *key,
84 void *value, u64 flags);
Yonghong Song05799632020-01-15 10:43:04 -080085 int (*map_lookup_and_delete_batch)(struct bpf_map *map,
86 const union bpf_attr *attr,
87 union bpf_attr __user *uattr);
Brian Vazquezaa2e93b2020-01-15 10:43:02 -080088 int (*map_update_batch)(struct bpf_map *map, const union bpf_attr *attr,
89 union bpf_attr __user *uattr);
90 int (*map_delete_batch)(struct bpf_map *map, const union bpf_attr *attr,
91 union bpf_attr __user *uattr);
Alexei Starovoitovdb20fd22014-09-26 00:16:59 -070092
93 /* funcs callable from userspace and from eBPF programs */
94 void *(*map_lookup_elem)(struct bpf_map *map, void *key);
Alexei Starovoitov3274f522014-11-13 17:36:44 -080095 int (*map_update_elem)(struct bpf_map *map, void *key, void *value, u64 flags);
Alexei Starovoitovdb20fd22014-09-26 00:16:59 -070096 int (*map_delete_elem)(struct bpf_map *map, void *key);
Mauricio Vasquez Bf1a2e442018-10-18 15:16:25 +020097 int (*map_push_elem)(struct bpf_map *map, void *value, u64 flags);
98 int (*map_pop_elem)(struct bpf_map *map, void *value);
99 int (*map_peek_elem)(struct bpf_map *map, void *value);
Feng Zhou07343112022-05-11 17:38:53 +0800100 void *(*map_lookup_percpu_elem)(struct bpf_map *map, void *key, u32 cpu);
Wang Nan2a36f0b2015-08-06 07:02:33 +0000101
102 /* funcs called by prog_array and perf_event_array map */
Daniel Borkmannd056a782016-06-15 22:47:13 +0200103 void *(*map_fd_get_ptr)(struct bpf_map *map, struct file *map_file,
104 int fd);
Hou Taoe05b3222023-12-04 22:04:20 +0800105 /* If need_defer is true, the implementation should guarantee that
106 * the to-be-put element is still alive before the bpf program, which
107 * may manipulate it, exists.
108 */
109 void (*map_fd_put_ptr)(struct bpf_map *map, void *ptr, bool need_defer);
Daniel Borkmann4a8f87e2020-10-11 01:40:03 +0200110 int (*map_gen_lookup)(struct bpf_map *map, struct bpf_insn *insn_buf);
Martin KaFai Lau14dc6f02017-06-27 23:08:34 -0700111 u32 (*map_fd_sys_lookup_elem)(void *ptr);
Martin KaFai Laua26ca7c2018-04-18 15:56:03 -0700112 void (*map_seq_show_elem)(struct bpf_map *map, void *key,
113 struct seq_file *m);
Daniel Borkmanne8d2bec2018-08-12 01:59:17 +0200114 int (*map_check_btf)(const struct bpf_map *map,
Roman Gushchin1b2b2342018-12-10 15:43:00 -0800115 const struct btf *btf,
Daniel Borkmanne8d2bec2018-08-12 01:59:17 +0200116 const struct btf_type *key_type,
117 const struct btf_type *value_type);
Daniel Borkmannd8eca5b2019-04-09 23:20:03 +0200118
Daniel Borkmannda765a22019-11-22 21:07:58 +0100119 /* Prog poke tracking helpers. */
120 int (*map_poke_track)(struct bpf_map *map, struct bpf_prog_aux *aux);
121 void (*map_poke_untrack)(struct bpf_map *map, struct bpf_prog_aux *aux);
122 void (*map_poke_run)(struct bpf_map *map, u32 key, struct bpf_prog *old,
123 struct bpf_prog *new);
124
Daniel Borkmannd8eca5b2019-04-09 23:20:03 +0200125 /* Direct value access helpers. */
126 int (*map_direct_value_addr)(const struct bpf_map *map,
127 u64 *imm, u32 off);
128 int (*map_direct_value_meta)(const struct bpf_map *map,
129 u64 imm, u32 *off);
Andrii Nakryikofc970222019-11-17 09:28:04 -0800130 int (*map_mmap)(struct bpf_map *map, struct vm_area_struct *vma);
Andrii Nakryiko457f44362020-05-29 00:54:20 -0700131 __poll_t (*map_poll)(struct bpf_map *map, struct file *filp,
132 struct poll_table_struct *pts);
Andrey Ignatov41c48f32020-06-19 14:11:43 -0700133
KP Singhf836a562020-08-25 20:29:15 +0200134 /* Functions called by bpf_local_storage maps */
135 int (*map_local_storage_charge)(struct bpf_local_storage_map *smap,
136 void *owner, u32 size);
137 void (*map_local_storage_uncharge)(struct bpf_local_storage_map *smap,
138 void *owner, u32 size);
139 struct bpf_local_storage __rcu ** (*map_owner_storage_ptr)(void *owner);
Martin KaFai Lauf4d05252020-08-27 18:18:06 -0700140
Björn Töpele6a47502021-03-08 12:29:06 +0100141 /* Misc helpers.*/
142 int (*map_redirect)(struct bpf_map *map, u32 ifindex, u64 flags);
143
Martin KaFai Lauf4d05252020-08-27 18:18:06 -0700144 /* map_meta_equal must be implemented for maps that can be
145 * used as an inner map. It is a runtime check to ensure
146 * an inner map can be inserted to an outer map.
147 *
148 * Some properties of the inner map has been used during the
149 * verification time. When inserting an inner map at the runtime,
150 * map_meta_equal has to ensure the inserting map has the same
151 * properties that the verifier has used earlier.
152 */
153 bool (*map_meta_equal)(const struct bpf_map *meta0,
154 const struct bpf_map *meta1);
155
Yonghong Song69c087b2021-02-26 12:49:25 -0800156
157 int (*map_set_for_each_callback_args)(struct bpf_verifier_env *env,
158 struct bpf_func_state *caller,
159 struct bpf_func_state *callee);
Kees Cook102acba2021-09-28 16:09:46 -0700160 int (*map_for_each_callback)(struct bpf_map *map,
161 bpf_callback_t callback_fn,
Yonghong Song69c087b2021-02-26 12:49:25 -0800162 void *callback_ctx, u64 flags);
163
Menglong Dongc317ab72022-04-25 21:32:47 +0800164 /* BTF id of struct allocated by map_alloc */
Andrey Ignatov41c48f32020-06-19 14:11:43 -0700165 int *map_btf_id;
Yonghong Songa5cbe052020-07-23 11:41:12 -0700166
167 /* bpf_iter info used to open a seq_file */
168 const struct bpf_iter_seq_info *iter_seq_info;
Alexei Starovoitov99c55f72014-09-26 00:16:57 -0700169};
170
Kumar Kartikeya Dwivedi61df10c2022-04-25 03:18:49 +0530171enum {
172 /* Support at most 8 pointers in a BPF map value */
173 BPF_MAP_VALUE_OFF_MAX = 8,
Kumar Kartikeya Dwivedi4d7d7f62022-04-25 03:18:53 +0530174 BPF_MAP_OFF_ARR_MAX = BPF_MAP_VALUE_OFF_MAX +
175 1 + /* for bpf_spin_lock */
176 1, /* for bpf_timer */
Kumar Kartikeya Dwivedi61df10c2022-04-25 03:18:49 +0530177};
178
Kumar Kartikeya Dwivedic0a5a212022-04-25 03:18:51 +0530179enum bpf_kptr_type {
180 BPF_KPTR_UNREF,
181 BPF_KPTR_REF,
182};
183
Kumar Kartikeya Dwivedi61df10c2022-04-25 03:18:49 +0530184struct bpf_map_value_off_desc {
185 u32 offset;
Kumar Kartikeya Dwivedic0a5a212022-04-25 03:18:51 +0530186 enum bpf_kptr_type type;
Kumar Kartikeya Dwivedi61df10c2022-04-25 03:18:49 +0530187 struct {
188 struct btf *btf;
Kumar Kartikeya Dwivedi14a324f2022-04-25 03:18:55 +0530189 struct module *module;
190 btf_dtor_kfunc_t dtor;
Kumar Kartikeya Dwivedi61df10c2022-04-25 03:18:49 +0530191 u32 btf_id;
192 } kptr;
193};
194
195struct bpf_map_value_off {
196 u32 nr_off;
197 struct bpf_map_value_off_desc off[];
198};
199
Kumar Kartikeya Dwivedi4d7d7f62022-04-25 03:18:53 +0530200struct bpf_map_off_arr {
201 u32 cnt;
202 u32 field_off[BPF_MAP_OFF_ARR_MAX];
203 u8 field_sz[BPF_MAP_OFF_ARR_MAX];
204};
205
Alexei Starovoitov99c55f72014-09-26 00:16:57 -0700206struct bpf_map {
Martin KaFai Laua26ca7c2018-04-18 15:56:03 -0700207 /* The first two cachelines with read-mostly members of which some
Daniel Borkmannbe95a842018-01-09 13:17:44 +0100208 * are also accessed in fast-path (e.g. ops, max_entries).
209 */
210 const struct bpf_map_ops *ops ____cacheline_aligned;
211 struct bpf_map *inner_map_meta;
212#ifdef CONFIG_SECURITY
213 void *security;
214#endif
Alexei Starovoitov99c55f72014-09-26 00:16:57 -0700215 enum bpf_map_type map_type;
216 u32 key_size;
217 u32 value_size;
218 u32 max_entries;
Joanne Koong93309862021-10-27 16:45:00 -0700219 u64 map_extra; /* any per-map-type extra fields */
Alexei Starovoitov6c905982016-03-07 21:57:15 -0800220 u32 map_flags;
Alexei Starovoitovd83525c2019-01-31 15:40:04 -0800221 int spin_lock_off; /* >=0 valid offset, <0 error */
Kumar Kartikeya Dwivedi61df10c2022-04-25 03:18:49 +0530222 struct bpf_map_value_off *kptr_off_tab;
Alexei Starovoitovb00628b2021-07-14 17:54:09 -0700223 int timer_off; /* >=0 valid offset, <0 error */
Martin KaFai Lauf3f1c052017-06-05 12:15:47 -0700224 u32 id;
Martin KaFai Lau96eabe72017-08-18 11:28:00 -0700225 int numa_node;
Martin KaFai Lau9b2cf322018-05-22 14:57:21 -0700226 u32 btf_key_type_id;
227 u32 btf_value_type_id;
Joanne Koong8845b462021-10-29 15:49:08 -0700228 u32 btf_vmlinux_value_type_id;
Martin KaFai Laua26ca7c2018-04-18 15:56:03 -0700229 struct btf *btf;
Roman Gushchin48edc1f2020-12-01 13:58:32 -0800230#ifdef CONFIG_MEMCG_KMEM
Roman Gushchin4201d9ab2022-07-11 09:28:27 -0700231 struct obj_cgroup *objcg;
Roman Gushchin48edc1f2020-12-01 13:58:32 -0800232#endif
Andrii Nakryikofc970222019-11-17 09:28:04 -0800233 char name[BPF_OBJ_NAME_LEN];
Kumar Kartikeya Dwivedi4d7d7f62022-04-25 03:18:53 +0530234 struct bpf_map_off_arr *off_arr;
Martin KaFai Laua26ca7c2018-04-18 15:56:03 -0700235 /* The 3rd and 4th cacheline with misc members to avoid false sharing
Daniel Borkmannbe95a842018-01-09 13:17:44 +0100236 * particularly with refcounting.
237 */
Andrii Nakryiko1e0bd5a2019-11-17 09:28:02 -0800238 atomic64_t refcnt ____cacheline_aligned;
239 atomic64_t usercnt;
Hou Tao62fca832023-12-04 22:04:22 +0800240 /* rcu is used before freeing and work is only used during freeing */
241 union {
242 struct work_struct work;
243 struct rcu_head rcu;
244 };
Andrii Nakryikofc970222019-11-17 09:28:04 -0800245 struct mutex freeze_mutex;
Daniel Borkmann353050b2021-11-09 18:48:08 +0000246 atomic64_t writecnt;
Toke Hoiland-Jorgensenf45d5b62022-01-21 11:10:02 +0100247 /* 'Ownership' of program-containing map is claimed by the first program
248 * that is going to use this map or by the first program which FD is
249 * stored in the map to make sure that all callers and callees have the
250 * same prog type, JITed flag and xdp_has_frags flag.
251 */
252 struct {
253 spinlock_t lock;
254 enum bpf_prog_type type;
255 bool jited;
256 bool xdp_has_frags;
257 } owner;
Kumar Kartikeya Dwivedi4d7d7f62022-04-25 03:18:53 +0530258 bool bypass_spec_v1;
259 bool frozen; /* write-once; write-protected by freeze_mutex */
Hou Tao62fca832023-12-04 22:04:22 +0800260 bool free_after_mult_rcu_gp;
Anton Protopopova6fb03a2023-07-06 13:39:28 +0000261 s64 __percpu *elem_count;
Alexei Starovoitov99c55f72014-09-26 00:16:57 -0700262};
263
Alexei Starovoitovd83525c2019-01-31 15:40:04 -0800264static inline bool map_value_has_spin_lock(const struct bpf_map *map)
265{
266 return map->spin_lock_off >= 0;
267}
268
Alexei Starovoitov68134662021-07-14 17:54:10 -0700269static inline bool map_value_has_timer(const struct bpf_map *map)
Alexei Starovoitovd83525c2019-01-31 15:40:04 -0800270{
Alexei Starovoitov68134662021-07-14 17:54:10 -0700271 return map->timer_off >= 0;
Alexei Starovoitovd83525c2019-01-31 15:40:04 -0800272}
273
Kumar Kartikeya Dwivedi61df10c2022-04-25 03:18:49 +0530274static inline bool map_value_has_kptrs(const struct bpf_map *map)
275{
276 return !IS_ERR_OR_NULL(map->kptr_off_tab);
277}
278
Hou Tao678ea182023-02-15 16:21:31 +0800279/* 'dst' must be a temporary buffer and should not point to memory that is being
280 * used in parallel by a bpf program or bpf syscall, otherwise the access from
281 * the bpf program or bpf syscall may be corrupted by the reinitialization,
282 * leading to weird problems. Even 'dst' is newly-allocated from bpf memory
283 * allocator, it is still possible for 'dst' to be used in parallel by a bpf
284 * program or bpf syscall.
285 */
Alexei Starovoitov68134662021-07-14 17:54:10 -0700286static inline void check_and_init_map_value(struct bpf_map *map, void *dst)
287{
288 if (unlikely(map_value_has_spin_lock(map)))
Yonghong Song5eaed6e2022-02-11 11:49:53 -0800289 memset(dst + map->spin_lock_off, 0, sizeof(struct bpf_spin_lock));
Alexei Starovoitov68134662021-07-14 17:54:10 -0700290 if (unlikely(map_value_has_timer(map)))
Yonghong Song5eaed6e2022-02-11 11:49:53 -0800291 memset(dst + map->timer_off, 0, sizeof(struct bpf_timer));
Kumar Kartikeya Dwivedi4d7d7f62022-04-25 03:18:53 +0530292 if (unlikely(map_value_has_kptrs(map))) {
293 struct bpf_map_value_off *tab = map->kptr_off_tab;
294 int i;
295
296 for (i = 0; i < tab->nr_off; i++)
297 *(u64 *)(dst + tab->off[i].offset) = 0;
298 }
Alexei Starovoitov68134662021-07-14 17:54:10 -0700299}
300
Kumar Kartikeya Dwivedi44832512022-09-04 22:41:14 +0200301/* memcpy that is used with 8-byte aligned pointers, power-of-8 size and
302 * forced to use 'long' read/writes to try to atomically copy long counters.
303 * Best-effort only. No barriers here, since it _will_ race with concurrent
304 * updates from BPF programs. Called from bpf syscall and mostly used with
305 * size 8 or 16 bytes, so ask compiler to inline it.
306 */
307static inline void bpf_long_memcpy(void *dst, const void *src, u32 size)
308{
309 const long *lsrc = src;
310 long *ldst = dst;
311
312 size /= sizeof(long);
313 while (size--)
Daniel Borkmann5685f8a2023-08-29 22:53:52 +0200314 data_race(*ldst++ = *lsrc++);
Kumar Kartikeya Dwivedi44832512022-09-04 22:41:14 +0200315}
316
317/* copy everything but bpf_spin_lock, bpf_timer, and kptrs. There could be one of each. */
318static inline void __copy_map_value(struct bpf_map *map, void *dst, void *src, bool long_memcpy)
Alexei Starovoitovd83525c2019-01-31 15:40:04 -0800319{
Kumar Kartikeya Dwivedi4d7d7f62022-04-25 03:18:53 +0530320 u32 curr_off = 0;
321 int i;
Alexei Starovoitovd83525c2019-01-31 15:40:04 -0800322
Kumar Kartikeya Dwivedi4d7d7f62022-04-25 03:18:53 +0530323 if (likely(!map->off_arr)) {
Kumar Kartikeya Dwivedi44832512022-09-04 22:41:14 +0200324 if (long_memcpy)
325 bpf_long_memcpy(dst, src, round_up(map->value_size, 8));
326 else
327 memcpy(dst, src, map->value_size);
Kumar Kartikeya Dwivedi4d7d7f62022-04-25 03:18:53 +0530328 return;
Alexei Starovoitovd83525c2019-01-31 15:40:04 -0800329 }
Kumar Kartikeya Dwivedi4d7d7f62022-04-25 03:18:53 +0530330
331 for (i = 0; i < map->off_arr->cnt; i++) {
332 u32 next_off = map->off_arr->field_off[i];
333
334 memcpy(dst + curr_off, src + curr_off, next_off - curr_off);
Xu Kuohai1f6e04a2022-11-11 07:56:20 -0500335 curr_off = next_off + map->off_arr->field_sz[i];
Kumar Kartikeya Dwivedi4d7d7f62022-04-25 03:18:53 +0530336 }
337 memcpy(dst + curr_off, src + curr_off, map->value_size - curr_off);
Alexei Starovoitovd83525c2019-01-31 15:40:04 -0800338}
Kumar Kartikeya Dwivedi44832512022-09-04 22:41:14 +0200339
340static inline void copy_map_value(struct bpf_map *map, void *dst, void *src)
341{
342 __copy_map_value(map, dst, src, false);
343}
344
345static inline void copy_map_value_long(struct bpf_map *map, void *dst, void *src)
346{
347 __copy_map_value(map, dst, src, true);
348}
349
Kumar Kartikeya Dwivedicc487552022-09-04 22:41:16 +0200350static inline void zero_map_value(struct bpf_map *map, void *dst)
351{
352 u32 curr_off = 0;
353 int i;
354
355 if (likely(!map->off_arr)) {
356 memset(dst, 0, map->value_size);
357 return;
358 }
359
360 for (i = 0; i < map->off_arr->cnt; i++) {
361 u32 next_off = map->off_arr->field_off[i];
362
363 memset(dst + curr_off, 0, next_off - curr_off);
Xu Kuohai1f6e04a2022-11-11 07:56:20 -0500364 curr_off = next_off + map->off_arr->field_sz[i];
Kumar Kartikeya Dwivedicc487552022-09-04 22:41:16 +0200365 }
366 memset(dst + curr_off, 0, map->value_size - curr_off);
367}
368
Alexei Starovoitov96049f32019-01-31 15:40:09 -0800369void copy_map_value_locked(struct bpf_map *map, void *dst, void *src,
370 bool lock_src);
Alexei Starovoitovb00628b2021-07-14 17:54:09 -0700371void bpf_timer_cancel_and_free(void *timer);
Martin KaFai Lau8e7ae252020-03-13 18:02:09 -0700372int bpf_obj_name_cpy(char *dst, const char *src, unsigned int size);
Alexei Starovoitovd83525c2019-01-31 15:40:04 -0800373
Jakub Kicinski602144c2018-07-17 10:53:25 -0700374struct bpf_offload_dev;
Jakub Kicinskia3884572018-01-11 20:29:09 -0800375struct bpf_offloaded_map;
376
377struct bpf_map_dev_ops {
378 int (*map_get_next_key)(struct bpf_offloaded_map *map,
379 void *key, void *next_key);
380 int (*map_lookup_elem)(struct bpf_offloaded_map *map,
381 void *key, void *value);
382 int (*map_update_elem)(struct bpf_offloaded_map *map,
383 void *key, void *value, u64 flags);
384 int (*map_delete_elem)(struct bpf_offloaded_map *map, void *key);
385};
386
387struct bpf_offloaded_map {
388 struct bpf_map map;
389 struct net_device *netdev;
390 const struct bpf_map_dev_ops *dev_ops;
391 void *dev_priv;
392 struct list_head offloads;
393};
394
395static inline struct bpf_offloaded_map *map_to_offmap(struct bpf_map *map)
396{
397 return container_of(map, struct bpf_offloaded_map, map);
398}
399
Jakub Kicinski0cd3cbe2018-05-03 18:37:08 -0700400static inline bool bpf_map_offload_neutral(const struct bpf_map *map)
401{
402 return map->map_type == BPF_MAP_TYPE_PERF_EVENT_ARRAY;
403}
404
Martin KaFai Laua26ca7c2018-04-18 15:56:03 -0700405static inline bool bpf_map_support_seq_show(const struct bpf_map *map)
406{
Martin KaFai Lau85d33df2020-01-08 16:35:05 -0800407 return (map->btf_value_type_id || map->btf_vmlinux_value_type_id) &&
408 map->ops->map_seq_show_elem;
Martin KaFai Laua26ca7c2018-04-18 15:56:03 -0700409}
410
Daniel Borkmanne8d2bec2018-08-12 01:59:17 +0200411int map_check_no_btf(const struct bpf_map *map,
Roman Gushchin1b2b2342018-12-10 15:43:00 -0800412 const struct btf *btf,
Daniel Borkmanne8d2bec2018-08-12 01:59:17 +0200413 const struct btf_type *key_type,
414 const struct btf_type *value_type);
415
Martin KaFai Lauf4d05252020-08-27 18:18:06 -0700416bool bpf_map_meta_equal(const struct bpf_map *meta0,
417 const struct bpf_map *meta1);
418
Jakub Kicinskia3884572018-01-11 20:29:09 -0800419extern const struct bpf_map_ops bpf_map_offload_ops;
420
Hao Luod639b9d2021-12-16 16:31:44 -0800421/* bpf_type_flag contains a set of flags that are applicable to the values of
422 * arg_type, ret_type and reg_type. For example, a pointer value may be null,
423 * or a memory is read-only. We classify types into two categories: base types
424 * and extended types. Extended types are base types combined with a type flag.
425 *
426 * Currently there are no more than 32 base types in arg_type, ret_type and
427 * reg_types.
428 */
429#define BPF_BASE_TYPE_BITS 8
430
431enum bpf_type_flag {
432 /* PTR may be NULL. */
433 PTR_MAYBE_NULL = BIT(0 + BPF_BASE_TYPE_BITS),
434
Hao Luo216e3cd2021-12-16 16:31:51 -0800435 /* MEM is read-only. When applied on bpf_arg, it indicates the arg is
436 * compatible with both mutable and immutable memory.
437 */
Hao Luo20b2aff2021-12-16 16:31:48 -0800438 MEM_RDONLY = BIT(1 + BPF_BASE_TYPE_BITS),
439
Daniel Borkmanna672b2e2022-01-13 11:11:30 +0000440 /* MEM was "allocated" from a different helper, and cannot be mixed
441 * with regular non-MEM_ALLOC'ed MEM types.
442 */
443 MEM_ALLOC = BIT(2 + BPF_BASE_TYPE_BITS),
444
Yonghong Songc6f1bfe2022-01-27 07:46:06 -0800445 /* MEM is in user address space. */
446 MEM_USER = BIT(3 + BPF_BASE_TYPE_BITS),
447
Hao Luo58441012022-03-04 11:16:56 -0800448 /* MEM is a percpu memory. MEM_PERCPU tags PTR_TO_BTF_ID. When tagged
449 * with MEM_PERCPU, PTR_TO_BTF_ID _cannot_ be directly accessed. In
450 * order to drop this tag, it must be passed into bpf_per_cpu_ptr()
451 * or bpf_this_cpu_ptr(), which will return the pointer corresponding
452 * to the specified cpu.
453 */
454 MEM_PERCPU = BIT(4 + BPF_BASE_TYPE_BITS),
455
Kumar Kartikeya Dwivedi8f148522022-04-25 03:18:50 +0530456 /* Indicates that the argument will be released. */
457 OBJ_RELEASE = BIT(5 + BPF_BASE_TYPE_BITS),
458
Kumar Kartikeya Dwivedi6efe1522022-04-25 03:18:52 +0530459 /* PTR is not trusted. This is only used with PTR_TO_BTF_ID, to mark
460 * unreferenced and referenced kptr loaded from map value using a load
461 * instruction, so that they can only be dereferenced but not escape the
462 * BPF program into the kernel (i.e. cannot be passed as arguments to
463 * kfunc or bpf helpers).
464 */
465 PTR_UNTRUSTED = BIT(6 + BPF_BASE_TYPE_BITS),
466
Joanne Koong16d1e002022-05-09 15:42:52 -0700467 MEM_UNINIT = BIT(7 + BPF_BASE_TYPE_BITS),
468
Joanne Koong97e03f52022-05-23 14:07:07 -0700469 /* DYNPTR points to memory local to the bpf program. */
470 DYNPTR_TYPE_LOCAL = BIT(8 + BPF_BASE_TYPE_BITS),
471
David Vernet20571562022-09-19 19:00:58 -0500472 /* DYNPTR points to a kernel-produced ringbuf record. */
Joanne Koongbc34dee2022-05-23 14:07:09 -0700473 DYNPTR_TYPE_RINGBUF = BIT(9 + BPF_BASE_TYPE_BITS),
474
Maxim Mikityanskiy508362a2022-06-15 16:48:43 +0300475 /* Size is known at compile time. */
476 MEM_FIXED_SIZE = BIT(10 + BPF_BASE_TYPE_BITS),
477
Joanne Koong16d1e002022-05-09 15:42:52 -0700478 __BPF_TYPE_FLAG_MAX,
479 __BPF_TYPE_LAST_FLAG = __BPF_TYPE_FLAG_MAX - 1,
Hao Luod639b9d2021-12-16 16:31:44 -0800480};
481
Joanne Koongbc34dee2022-05-23 14:07:09 -0700482#define DYNPTR_TYPE_FLAG_MASK (DYNPTR_TYPE_LOCAL | DYNPTR_TYPE_RINGBUF)
Joanne Koong97e03f52022-05-23 14:07:07 -0700483
Hao Luod639b9d2021-12-16 16:31:44 -0800484/* Max number of base types. */
485#define BPF_BASE_TYPE_LIMIT (1UL << BPF_BASE_TYPE_BITS)
486
487/* Max number of all types. */
488#define BPF_TYPE_LIMIT (__BPF_TYPE_LAST_FLAG | (__BPF_TYPE_LAST_FLAG - 1))
489
Alexei Starovoitov17a52672014-09-26 00:17:06 -0700490/* function argument constraints */
491enum bpf_arg_type {
Daniel Borkmann80f1d682015-03-12 17:21:42 +0100492 ARG_DONTCARE = 0, /* unused argument in helper function */
Alexei Starovoitov17a52672014-09-26 00:17:06 -0700493
494 /* the following constraints used to prototype
495 * bpf_map_lookup/update/delete_elem() functions
496 */
497 ARG_CONST_MAP_PTR, /* const argument used as pointer to bpf_map */
498 ARG_PTR_TO_MAP_KEY, /* pointer to stack used as map key */
499 ARG_PTR_TO_MAP_VALUE, /* pointer to stack used as map value */
Alexei Starovoitov17a52672014-09-26 00:17:06 -0700500
Joanne Koong16d1e002022-05-09 15:42:52 -0700501 /* Used to prototype bpf_memcmp() and other functions that access data
502 * on eBPF program stack
Alexei Starovoitov17a52672014-09-26 00:17:06 -0700503 */
Alexei Starovoitov39f19ebb2017-01-09 10:19:50 -0800504 ARG_PTR_TO_MEM, /* pointer to valid memory (stack, packet, map value) */
Daniel Borkmann435faee12016-04-13 00:10:51 +0200505
Alexei Starovoitov39f19ebb2017-01-09 10:19:50 -0800506 ARG_CONST_SIZE, /* number of bytes accessed from memory */
507 ARG_CONST_SIZE_OR_ZERO, /* number of bytes accessed from memory or 0 */
Daniel Borkmann80f1d682015-03-12 17:21:42 +0100508
Alexei Starovoitov608cd712015-03-26 19:53:57 -0700509 ARG_PTR_TO_CTX, /* pointer to context */
Daniel Borkmann80f1d682015-03-12 17:21:42 +0100510 ARG_ANYTHING, /* any (initialized) argument is ok */
Alexei Starovoitovd83525c2019-01-31 15:40:04 -0800511 ARG_PTR_TO_SPIN_LOCK, /* pointer to bpf_spin_lock */
Martin KaFai Lau46f8bc92019-02-09 23:22:20 -0800512 ARG_PTR_TO_SOCK_COMMON, /* pointer to sock_common */
Andrey Ignatov57c3bb72019-03-18 16:57:10 -0700513 ARG_PTR_TO_INT, /* pointer to int */
514 ARG_PTR_TO_LONG, /* pointer to long */
Martin KaFai Lau6ac99e82019-04-26 16:39:39 -0700515 ARG_PTR_TO_SOCKET, /* pointer to bpf_sock (fullsock) */
Alexei Starovoitova7658e12019-10-15 20:25:04 -0700516 ARG_PTR_TO_BTF_ID, /* pointer to in-kernel struct */
Andrii Nakryiko457f44362020-05-29 00:54:20 -0700517 ARG_PTR_TO_ALLOC_MEM, /* pointer to dynamically allocated memory */
Andrii Nakryiko457f44362020-05-29 00:54:20 -0700518 ARG_CONST_ALLOC_SIZE_OR_ZERO, /* number of allocated bytes requested */
Martin KaFai Lau1df8f552020-09-24 17:03:50 -0700519 ARG_PTR_TO_BTF_ID_SOCK_COMMON, /* pointer to in-kernel sock_common or bpf-mirrored bpf_sock */
Hao Luoeaa6bcb2020-09-29 16:50:47 -0700520 ARG_PTR_TO_PERCPU_BTF_ID, /* pointer to in-kernel percpu type */
Yonghong Song69c087b2021-02-26 12:49:25 -0800521 ARG_PTR_TO_FUNC, /* pointer to a bpf program function */
Hao Luo48946bd2021-12-16 16:31:45 -0800522 ARG_PTR_TO_STACK, /* pointer to stack */
Florent Revestfff13c42021-04-19 17:52:39 +0200523 ARG_PTR_TO_CONST_STR, /* pointer to a null terminated read-only string */
Alexei Starovoitovb00628b2021-07-14 17:54:09 -0700524 ARG_PTR_TO_TIMER, /* pointer to bpf_timer */
Kumar Kartikeya Dwivedic0a5a212022-04-25 03:18:51 +0530525 ARG_PTR_TO_KPTR, /* pointer to referenced kptr */
Joanne Koong97e03f52022-05-23 14:07:07 -0700526 ARG_PTR_TO_DYNPTR, /* pointer to bpf_dynptr. See bpf_type_flag for dynptr type */
Lorenz Bauerf79e7ea2020-09-21 13:12:27 +0100527 __BPF_ARG_TYPE_MAX,
Hao Luod639b9d2021-12-16 16:31:44 -0800528
Hao Luo48946bd2021-12-16 16:31:45 -0800529 /* Extended arg_types. */
530 ARG_PTR_TO_MAP_VALUE_OR_NULL = PTR_MAYBE_NULL | ARG_PTR_TO_MAP_VALUE,
531 ARG_PTR_TO_MEM_OR_NULL = PTR_MAYBE_NULL | ARG_PTR_TO_MEM,
532 ARG_PTR_TO_CTX_OR_NULL = PTR_MAYBE_NULL | ARG_PTR_TO_CTX,
533 ARG_PTR_TO_SOCKET_OR_NULL = PTR_MAYBE_NULL | ARG_PTR_TO_SOCKET,
534 ARG_PTR_TO_ALLOC_MEM_OR_NULL = PTR_MAYBE_NULL | ARG_PTR_TO_ALLOC_MEM,
535 ARG_PTR_TO_STACK_OR_NULL = PTR_MAYBE_NULL | ARG_PTR_TO_STACK,
Kumar Kartikeya Dwivedic0a5a212022-04-25 03:18:51 +0530536 ARG_PTR_TO_BTF_ID_OR_NULL = PTR_MAYBE_NULL | ARG_PTR_TO_BTF_ID,
Joanne Koong16d1e002022-05-09 15:42:52 -0700537 /* pointer to memory does not need to be initialized, helper function must fill
538 * all bytes or clear them in error case.
539 */
540 ARG_PTR_TO_UNINIT_MEM = MEM_UNINIT | ARG_PTR_TO_MEM,
Maxim Mikityanskiy508362a2022-06-15 16:48:43 +0300541 /* Pointer to valid memory of size known at compile time. */
542 ARG_PTR_TO_FIXED_SIZE_MEM = MEM_FIXED_SIZE | ARG_PTR_TO_MEM,
Hao Luo48946bd2021-12-16 16:31:45 -0800543
Hao Luod639b9d2021-12-16 16:31:44 -0800544 /* This must be the last entry. Its purpose is to ensure the enum is
545 * wide enough to hold the higher bits reserved for bpf_type_flag.
546 */
547 __BPF_ARG_TYPE_LIMIT = BPF_TYPE_LIMIT,
Alexei Starovoitov17a52672014-09-26 00:17:06 -0700548};
Hao Luod639b9d2021-12-16 16:31:44 -0800549static_assert(__BPF_ARG_TYPE_MAX <= BPF_BASE_TYPE_LIMIT);
Alexei Starovoitov17a52672014-09-26 00:17:06 -0700550
551/* type of values returned from helper functions */
552enum bpf_return_type {
553 RET_INTEGER, /* function returns integer */
554 RET_VOID, /* function doesn't return anything */
Roman Gushchin3e6a4b32018-08-02 14:27:22 -0700555 RET_PTR_TO_MAP_VALUE, /* returns a pointer to map elem value */
Hao Luo3c480732021-12-16 16:31:46 -0800556 RET_PTR_TO_SOCKET, /* returns a pointer to a socket */
557 RET_PTR_TO_TCP_SOCK, /* returns a pointer to a tcp_sock */
558 RET_PTR_TO_SOCK_COMMON, /* returns a pointer to a sock_common */
559 RET_PTR_TO_ALLOC_MEM, /* returns a pointer to dynamically allocated memory */
Hao Luo63d9b802020-09-29 16:50:48 -0700560 RET_PTR_TO_MEM_OR_BTF_ID, /* returns a pointer to a valid memory or a btf_id */
KP Singh3ca10322020-11-06 10:37:43 +0000561 RET_PTR_TO_BTF_ID, /* returns a pointer to a btf_id */
Hao Luod639b9d2021-12-16 16:31:44 -0800562 __BPF_RET_TYPE_MAX,
563
Hao Luo3c480732021-12-16 16:31:46 -0800564 /* Extended ret_types. */
565 RET_PTR_TO_MAP_VALUE_OR_NULL = PTR_MAYBE_NULL | RET_PTR_TO_MAP_VALUE,
566 RET_PTR_TO_SOCKET_OR_NULL = PTR_MAYBE_NULL | RET_PTR_TO_SOCKET,
567 RET_PTR_TO_TCP_SOCK_OR_NULL = PTR_MAYBE_NULL | RET_PTR_TO_TCP_SOCK,
568 RET_PTR_TO_SOCK_COMMON_OR_NULL = PTR_MAYBE_NULL | RET_PTR_TO_SOCK_COMMON,
Daniel Borkmanna672b2e2022-01-13 11:11:30 +0000569 RET_PTR_TO_ALLOC_MEM_OR_NULL = PTR_MAYBE_NULL | MEM_ALLOC | RET_PTR_TO_ALLOC_MEM,
Joanne Koong34d4ef52022-05-23 14:07:11 -0700570 RET_PTR_TO_DYNPTR_MEM_OR_NULL = PTR_MAYBE_NULL | RET_PTR_TO_ALLOC_MEM,
Hao Luo3c480732021-12-16 16:31:46 -0800571 RET_PTR_TO_BTF_ID_OR_NULL = PTR_MAYBE_NULL | RET_PTR_TO_BTF_ID,
572
Hao Luod639b9d2021-12-16 16:31:44 -0800573 /* This must be the last entry. Its purpose is to ensure the enum is
574 * wide enough to hold the higher bits reserved for bpf_type_flag.
575 */
576 __BPF_RET_TYPE_LIMIT = BPF_TYPE_LIMIT,
Alexei Starovoitov17a52672014-09-26 00:17:06 -0700577};
Hao Luod639b9d2021-12-16 16:31:44 -0800578static_assert(__BPF_RET_TYPE_MAX <= BPF_BASE_TYPE_LIMIT);
Alexei Starovoitov17a52672014-09-26 00:17:06 -0700579
Alexei Starovoitov09756af2014-09-26 00:17:00 -0700580/* eBPF function prototype used by verifier to allow BPF_CALLs from eBPF programs
581 * to in-kernel helper functions and for adjusting imm32 field in BPF_CALL
582 * instructions after verifying
583 */
584struct bpf_func_proto {
585 u64 (*func)(u64 r1, u64 r2, u64 r3, u64 r4, u64 r5);
586 bool gpl_only;
Daniel Borkmann36bbef52016-09-20 00:26:13 +0200587 bool pkt_access;
Alexei Starovoitov17a52672014-09-26 00:17:06 -0700588 enum bpf_return_type ret_type;
Alexei Starovoitova7658e12019-10-15 20:25:04 -0700589 union {
590 struct {
591 enum bpf_arg_type arg1_type;
592 enum bpf_arg_type arg2_type;
593 enum bpf_arg_type arg3_type;
594 enum bpf_arg_type arg4_type;
595 enum bpf_arg_type arg5_type;
596 };
597 enum bpf_arg_type arg_type[5];
598 };
Lorenz Bauer9436ef62020-09-21 13:12:20 +0100599 union {
600 struct {
601 u32 *arg1_btf_id;
602 u32 *arg2_btf_id;
603 u32 *arg3_btf_id;
604 u32 *arg4_btf_id;
605 u32 *arg5_btf_id;
606 };
607 u32 *arg_btf_id[5];
Maxim Mikityanskiy508362a2022-06-15 16:48:43 +0300608 struct {
609 size_t arg1_size;
610 size_t arg2_size;
611 size_t arg3_size;
612 size_t arg4_size;
613 size_t arg5_size;
614 };
615 size_t arg_size[5];
Lorenz Bauer9436ef62020-09-21 13:12:20 +0100616 };
Yonghong Songaf7ec132020-06-23 16:08:09 -0700617 int *ret_btf_id; /* return value btf_id */
Jiri Olsaeae2e832020-08-25 21:21:19 +0200618 bool (*allowed)(const struct bpf_prog *prog);
Alexei Starovoitov17a52672014-09-26 00:17:06 -0700619};
620
621/* bpf_context is intentionally undefined structure. Pointer to bpf_context is
622 * the first argument to eBPF programs.
623 * For socket filters: 'struct bpf_context *' == 'struct sk_buff *'
624 */
625struct bpf_context;
626
627enum bpf_access_type {
628 BPF_READ = 1,
629 BPF_WRITE = 2
Alexei Starovoitov09756af2014-09-26 00:17:00 -0700630};
631
Alexei Starovoitov19de99f2016-06-15 18:25:38 -0700632/* types of values stored in eBPF registers */
Edward Creef1174f72017-08-07 15:26:19 +0100633/* Pointer types represent:
634 * pointer
635 * pointer + imm
636 * pointer + (u16) var
637 * pointer + (u16) var + imm
638 * if (range > 0) then [ptr, ptr + range - off) is safe to access
639 * if (id > 0) means that some 'var' was added
640 * if (off > 0) means that 'imm' was added
641 */
Alexei Starovoitov19de99f2016-06-15 18:25:38 -0700642enum bpf_reg_type {
643 NOT_INIT = 0, /* nothing was written into register */
Edward Creef1174f72017-08-07 15:26:19 +0100644 SCALAR_VALUE, /* reg doesn't contain a valid pointer */
Alexei Starovoitov19de99f2016-06-15 18:25:38 -0700645 PTR_TO_CTX, /* reg points to bpf_context */
646 CONST_PTR_TO_MAP, /* reg points to struct bpf_map */
647 PTR_TO_MAP_VALUE, /* reg points to map element value */
Hao Luoc25b2ae2021-12-16 16:31:47 -0800648 PTR_TO_MAP_KEY, /* reg points to a map element key */
Edward Creef1174f72017-08-07 15:26:19 +0100649 PTR_TO_STACK, /* reg == frame_pointer + offset */
Daniel Borkmannde8f3a82017-09-25 02:25:51 +0200650 PTR_TO_PACKET_META, /* skb->data - meta_len */
Edward Creef1174f72017-08-07 15:26:19 +0100651 PTR_TO_PACKET, /* reg points to skb->data */
Alexei Starovoitov19de99f2016-06-15 18:25:38 -0700652 PTR_TO_PACKET_END, /* skb->data + headlen */
Petar Penkovd58e4682018-09-14 07:46:18 -0700653 PTR_TO_FLOW_KEYS, /* reg points to bpf_flow_keys */
Joe Stringerc64b7982018-10-02 13:35:33 -0700654 PTR_TO_SOCKET, /* reg points to struct bpf_sock */
Martin KaFai Lau46f8bc92019-02-09 23:22:20 -0800655 PTR_TO_SOCK_COMMON, /* reg points to sock_common */
Martin KaFai Lau655a51e2019-02-09 23:22:24 -0800656 PTR_TO_TCP_SOCK, /* reg points to struct tcp_sock */
Matt Mullins9df1c282019-04-26 11:49:47 -0700657 PTR_TO_TP_BUFFER, /* reg points to a writable raw tp's buffer */
Jonathan Lemonfada7fd2019-06-06 13:59:40 -0700658 PTR_TO_XDP_SOCK, /* reg points to struct xdp_sock */
John Fastabendba5f4cf2020-09-24 12:58:40 -0700659 /* PTR_TO_BTF_ID points to a kernel struct that does not need
660 * to be null checked by the BPF program. This does not imply the
661 * pointer is _not_ null and in practice this can easily be a null
662 * pointer when reading pointer chains. The assumption is program
663 * context will handle null pointer dereference typically via fault
664 * handling. The verifier must keep this in mind and can make no
665 * assumptions about null or non-null when doing branch analysis.
666 * Further, when passed into helpers the helpers can not, without
667 * additional context, assume the value is non-null.
668 */
669 PTR_TO_BTF_ID,
670 /* PTR_TO_BTF_ID_OR_NULL points to a kernel struct that has not
671 * been checked for null. Used primarily to inform the verifier
672 * an explicit null check is required for this struct.
673 */
Andrii Nakryiko457f44362020-05-29 00:54:20 -0700674 PTR_TO_MEM, /* reg points to valid memory region */
Hao Luo20b2aff2021-12-16 16:31:48 -0800675 PTR_TO_BUF, /* reg points to a read/write buffer */
Yonghong Song69c087b2021-02-26 12:49:25 -0800676 PTR_TO_FUNC, /* reg points to a bpf program function */
David Vernet20571562022-09-19 19:00:58 -0500677 PTR_TO_DYNPTR, /* reg points to a dynptr */
Martin KaFai Laue6ac2452021-03-24 18:51:42 -0700678 __BPF_REG_TYPE_MAX,
Hao Luod639b9d2021-12-16 16:31:44 -0800679
Hao Luoc25b2ae2021-12-16 16:31:47 -0800680 /* Extended reg_types. */
681 PTR_TO_MAP_VALUE_OR_NULL = PTR_MAYBE_NULL | PTR_TO_MAP_VALUE,
682 PTR_TO_SOCKET_OR_NULL = PTR_MAYBE_NULL | PTR_TO_SOCKET,
683 PTR_TO_SOCK_COMMON_OR_NULL = PTR_MAYBE_NULL | PTR_TO_SOCK_COMMON,
684 PTR_TO_TCP_SOCK_OR_NULL = PTR_MAYBE_NULL | PTR_TO_TCP_SOCK,
685 PTR_TO_BTF_ID_OR_NULL = PTR_MAYBE_NULL | PTR_TO_BTF_ID,
Hao Luoc25b2ae2021-12-16 16:31:47 -0800686
Hao Luod639b9d2021-12-16 16:31:44 -0800687 /* This must be the last entry. Its purpose is to ensure the enum is
688 * wide enough to hold the higher bits reserved for bpf_type_flag.
689 */
690 __BPF_REG_TYPE_LIMIT = BPF_TYPE_LIMIT,
Alexei Starovoitov19de99f2016-06-15 18:25:38 -0700691};
Hao Luod639b9d2021-12-16 16:31:44 -0800692static_assert(__BPF_REG_TYPE_MAX <= BPF_BASE_TYPE_LIMIT);
Alexei Starovoitov19de99f2016-06-15 18:25:38 -0700693
Yonghong Song23994632017-06-22 15:07:39 -0700694/* The information passed from prog-specific *_is_valid_access
695 * back to the verifier.
696 */
697struct bpf_insn_access_aux {
698 enum bpf_reg_type reg_type;
Alexei Starovoitov9e15db62019-10-15 20:25:00 -0700699 union {
700 int ctx_field_size;
Andrii Nakryiko22dc4a02020-12-03 12:46:29 -0800701 struct {
702 struct btf *btf;
703 u32 btf_id;
704 };
Alexei Starovoitov9e15db62019-10-15 20:25:00 -0700705 };
706 struct bpf_verifier_log *log; /* for verbose logs */
Yonghong Song23994632017-06-22 15:07:39 -0700707};
708
Daniel Borkmannf96da092017-07-02 02:13:27 +0200709static inline void
710bpf_ctx_record_field_size(struct bpf_insn_access_aux *aux, u32 size)
711{
712 aux->ctx_field_size = size;
713}
714
Andrii Nakryikob08acd52023-11-09 16:26:36 -0800715static bool bpf_is_ldimm64(const struct bpf_insn *insn)
716{
717 return insn->code == (BPF_LD | BPF_IMM | BPF_DW);
718}
719
Martin KaFai Lau3990ed42021-11-05 18:40:14 -0700720static inline bool bpf_pseudo_func(const struct bpf_insn *insn)
721{
Andrii Nakryikob08acd52023-11-09 16:26:36 -0800722 return bpf_is_ldimm64(insn) && insn->src_reg == BPF_PSEUDO_FUNC;
Martin KaFai Lau3990ed42021-11-05 18:40:14 -0700723}
724
Jakub Kicinski7de16e32017-10-16 16:40:53 -0700725struct bpf_prog_ops {
726 int (*test_run)(struct bpf_prog *prog, const union bpf_attr *kattr,
727 union bpf_attr __user *uattr);
728};
729
Alexei Starovoitov09756af2014-09-26 00:17:00 -0700730struct bpf_verifier_ops {
731 /* return eBPF function prototype for verification */
Andrey Ignatov5e43f892018-03-30 15:08:00 -0700732 const struct bpf_func_proto *
733 (*get_func_proto)(enum bpf_func_id func_id,
734 const struct bpf_prog *prog);
Alexei Starovoitov17a52672014-09-26 00:17:06 -0700735
736 /* return true if 'size' wide access at offset 'off' within bpf_context
737 * with 'type' (read or write) is allowed
738 */
Alexei Starovoitov19de99f2016-06-15 18:25:38 -0700739 bool (*is_valid_access)(int off, int size, enum bpf_access_type type,
Andrey Ignatov5e43f892018-03-30 15:08:00 -0700740 const struct bpf_prog *prog,
Yonghong Song23994632017-06-22 15:07:39 -0700741 struct bpf_insn_access_aux *info);
Daniel Borkmann36bbef52016-09-20 00:26:13 +0200742 int (*gen_prologue)(struct bpf_insn *insn, bool direct_write,
743 const struct bpf_prog *prog);
Daniel Borkmanne0cea7c2018-05-04 01:08:14 +0200744 int (*gen_ld_abs)(const struct bpf_insn *orig,
745 struct bpf_insn *insn_buf);
Daniel Borkmann6b8cc1d2017-01-12 11:51:32 +0100746 u32 (*convert_ctx_access)(enum bpf_access_type type,
747 const struct bpf_insn *src,
748 struct bpf_insn *dst,
Daniel Borkmannf96da092017-07-02 02:13:27 +0200749 struct bpf_prog *prog, u32 *target_size);
Martin KaFai Lau27ae79972020-01-08 16:35:03 -0800750 int (*btf_struct_access)(struct bpf_verifier_log *log,
Andrii Nakryiko22dc4a02020-12-03 12:46:29 -0800751 const struct btf *btf,
Martin KaFai Lau27ae79972020-01-08 16:35:03 -0800752 const struct btf_type *t, int off, int size,
753 enum bpf_access_type atype,
Yonghong Songc6f1bfe2022-01-27 07:46:06 -0800754 u32 *next_btf_id, enum bpf_type_flag *flag);
Alexei Starovoitov09756af2014-09-26 00:17:00 -0700755};
756
Jakub Kicinskicae19272017-12-27 18:39:05 -0800757struct bpf_prog_offload_ops {
Jakub Kicinski08ca90a2019-01-22 22:45:24 -0800758 /* verifier basic callbacks */
Jakub Kicinskicae19272017-12-27 18:39:05 -0800759 int (*insn_hook)(struct bpf_verifier_env *env,
760 int insn_idx, int prev_insn_idx);
Quentin Monnetc941ce92018-10-07 12:56:47 +0100761 int (*finalize)(struct bpf_verifier_env *env);
Jakub Kicinski08ca90a2019-01-22 22:45:24 -0800762 /* verifier optimization callbacks (called after .finalize) */
763 int (*replace_insn)(struct bpf_verifier_env *env, u32 off,
764 struct bpf_insn *insn);
765 int (*remove_insns)(struct bpf_verifier_env *env, u32 off, u32 cnt);
766 /* program management callbacks */
Quentin Monnet16a8cb5c2018-11-09 13:03:32 +0000767 int (*prepare)(struct bpf_prog *prog);
768 int (*translate)(struct bpf_prog *prog);
Quentin Monneteb911942018-11-09 13:03:30 +0000769 void (*destroy)(struct bpf_prog *prog);
Jakub Kicinskicae19272017-12-27 18:39:05 -0800770};
771
Jakub Kicinski0a9c1992018-01-11 20:29:07 -0800772struct bpf_prog_offload {
Jakub Kicinskiab3f0062017-11-03 13:56:17 -0700773 struct bpf_prog *prog;
774 struct net_device *netdev;
Quentin Monnet341b3e72018-11-09 13:03:26 +0000775 struct bpf_offload_dev *offdev;
Jakub Kicinskiab3f0062017-11-03 13:56:17 -0700776 void *dev_priv;
777 struct list_head offloads;
778 bool dev_state;
Jakub Kicinski08ca90a2019-01-22 22:45:24 -0800779 bool opt_failed;
Jiong Wangfcfb1262018-01-16 16:05:19 -0800780 void *jited_image;
781 u32 jited_len;
Jakub Kicinskiab3f0062017-11-03 13:56:17 -0700782};
783
Roman Gushchin8bad74f2018-09-28 14:45:36 +0000784enum bpf_cgroup_storage_type {
785 BPF_CGROUP_STORAGE_SHARED,
Roman Gushchinb741f162018-09-28 14:45:43 +0000786 BPF_CGROUP_STORAGE_PERCPU,
Roman Gushchin8bad74f2018-09-28 14:45:36 +0000787 __BPF_CGROUP_STORAGE_MAX
788};
789
790#define MAX_BPF_CGROUP_STORAGE_TYPE __BPF_CGROUP_STORAGE_MAX
791
Alexei Starovoitovf1b95092019-10-30 15:32:11 -0700792/* The longest tracepoint has 12 args.
793 * See include/trace/bpf_probe.h
794 */
795#define MAX_BPF_FUNC_ARGS 12
796
Dmitrii Banshchikov523a4cf2021-02-26 00:26:29 +0400797/* The maximum number of arguments passed through registers
798 * a single function may have.
799 */
800#define MAX_BPF_FUNC_REG_ARGS 5
801
Yonghong Song720e6a42022-08-31 08:26:46 -0700802/* The argument is a structure. */
803#define BTF_FMODEL_STRUCT_ARG BIT(0)
804
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800805struct btf_func_model {
806 u8 ret_size;
807 u8 nr_args;
808 u8 arg_size[MAX_BPF_FUNC_ARGS];
Yonghong Song720e6a42022-08-31 08:26:46 -0700809 u8 arg_flags[MAX_BPF_FUNC_ARGS];
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800810};
811
812/* Restore arguments before returning from trampoline to let original function
813 * continue executing. This flag is used for fentry progs when there are no
814 * fexit progs.
815 */
816#define BPF_TRAMP_F_RESTORE_REGS BIT(0)
817/* Call original function after fentry progs, but before fexit progs.
818 * Makes sense for fentry/fexit, normal calls and indirect calls.
819 */
820#define BPF_TRAMP_F_CALL_ORIG BIT(1)
821/* Skip current frame and return to parent. Makes sense for fentry/fexit
822 * programs only. Should not be used with normal calls and indirect calls.
823 */
824#define BPF_TRAMP_F_SKIP_FRAME BIT(2)
Jiri Olsa7e6f3cd2021-07-14 11:43:53 +0200825/* Store IP address of the caller on the trampoline stack,
826 * so it's available for trampoline's programs.
827 */
828#define BPF_TRAMP_F_IP_ARG BIT(3)
Hou Tao356ed642021-09-14 10:33:51 +0800829/* Return the return value of fentry prog. Only used by bpf_struct_ops. */
830#define BPF_TRAMP_F_RET_FENTRY_RET BIT(4)
Jiri Olsa7e6f3cd2021-07-14 11:43:53 +0200831
Jiri Olsa316cba62022-07-19 17:21:25 -0700832/* Get original function from stack instead of from provided direct address.
833 * Makes sense for trampolines with fexit or fmod_ret programs.
834 */
835#define BPF_TRAMP_F_ORIG_STACK BIT(5)
836
Song Liu00963a22022-07-19 17:21:26 -0700837/* This trampoline is on a function with another ftrace_ops with IPMODIFY,
838 * e.g., a live patch. This flag is set and cleared by ftrace call backs,
839 */
840#define BPF_TRAMP_F_SHARE_IPMODIFY BIT(6)
841
Leon Hwang605c8d8f2023-09-12 23:04:41 +0800842/* Indicate that current trampoline is in a tail call context. Then, it has to
843 * cache and restore tail_call_cnt to avoid infinite tail call loop.
844 */
845#define BPF_TRAMP_F_TAIL_CALL_CTX BIT(7)
846
KP Singh88fd9e52020-03-04 20:18:47 +0100847/* Each call __bpf_prog_enter + call bpf_func + call __bpf_prog_exit is ~50
Yuntao Wangb23316a2022-05-19 23:06:10 +0800848 * bytes on x86.
KP Singh88fd9e52020-03-04 20:18:47 +0100849 */
Kui-Feng Leef7e0bea2022-05-10 13:59:19 -0700850#define BPF_MAX_TRAMP_LINKS 38
KP Singh88fd9e52020-03-04 20:18:47 +0100851
Kui-Feng Leef7e0bea2022-05-10 13:59:19 -0700852struct bpf_tramp_links {
853 struct bpf_tramp_link *links[BPF_MAX_TRAMP_LINKS];
854 int nr_links;
KP Singh88fd9e52020-03-04 20:18:47 +0100855};
856
Kui-Feng Leee384c7b2022-05-10 13:59:20 -0700857struct bpf_tramp_run_ctx;
858
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800859/* Different use cases for BPF trampoline:
860 * 1. replace nop at the function entry (kprobe equivalent)
861 * flags = BPF_TRAMP_F_RESTORE_REGS
862 * fentry = a set of programs to run before returning from trampoline
863 *
864 * 2. replace nop at the function entry (kprobe + kretprobe equivalent)
865 * flags = BPF_TRAMP_F_CALL_ORIG | BPF_TRAMP_F_SKIP_FRAME
866 * orig_call = fentry_ip + MCOUNT_INSN_SIZE
867 * fentry = a set of program to run before calling original function
868 * fexit = a set of program to run after original function
869 *
870 * 3. replace direct call instruction anywhere in the function body
871 * or assign a function pointer for indirect call (like tcp_congestion_ops->cong_avoid)
872 * With flags = 0
873 * fentry = a set of programs to run before returning from trampoline
874 * With flags = BPF_TRAMP_F_CALL_ORIG
875 * orig_call = original callback addr or direct function addr
876 * fentry = a set of program to run before calling original function
877 * fexit = a set of program to run after original function
878 */
Alexei Starovoitove21aa342021-03-16 14:00:07 -0700879struct bpf_tramp_image;
880int arch_prepare_bpf_trampoline(struct bpf_tramp_image *tr, void *image, void *image_end,
Martin KaFai Lau85d33df2020-01-08 16:35:05 -0800881 const struct btf_func_model *m, u32 flags,
Kui-Feng Leef7e0bea2022-05-10 13:59:19 -0700882 struct bpf_tramp_links *tlinks,
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800883 void *orig_call);
Martin KaFai Laua12f15d2022-10-25 11:45:16 -0700884u64 notrace __bpf_prog_enter_sleepable_recur(struct bpf_prog *prog,
885 struct bpf_tramp_run_ctx *run_ctx);
886void notrace __bpf_prog_exit_sleepable_recur(struct bpf_prog *prog, u64 start,
887 struct bpf_tramp_run_ctx *run_ctx);
Alexei Starovoitove21aa342021-03-16 14:00:07 -0700888void notrace __bpf_tramp_enter(struct bpf_tramp_image *tr);
889void notrace __bpf_tramp_exit(struct bpf_tramp_image *tr);
Martin KaFai Laua12f15d2022-10-25 11:45:16 -0700890typedef u64 (*bpf_trampoline_enter_t)(struct bpf_prog *prog,
891 struct bpf_tramp_run_ctx *run_ctx);
892typedef void (*bpf_trampoline_exit_t)(struct bpf_prog *prog, u64 start,
893 struct bpf_tramp_run_ctx *run_ctx);
894bpf_trampoline_enter_t bpf_trampoline_enter(const struct bpf_prog *prog);
895bpf_trampoline_exit_t bpf_trampoline_exit(const struct bpf_prog *prog);
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800896
Jiri Olsa535911c2020-03-12 20:55:58 +0100897struct bpf_ksym {
898 unsigned long start;
899 unsigned long end;
Jiri Olsabfea9a82020-03-12 20:55:59 +0100900 char name[KSYM_NAME_LEN];
Jiri Olsaecb60d12020-03-12 20:56:00 +0100901 struct list_head lnode;
Jiri Olsaca4424c2020-03-12 20:56:01 +0100902 struct latch_tree_node tnode;
Jiri Olsacbd76f8d2020-03-12 20:56:03 +0100903 bool prog;
Jiri Olsa535911c2020-03-12 20:55:58 +0100904};
905
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800906enum bpf_tramp_prog_type {
907 BPF_TRAMP_FENTRY,
908 BPF_TRAMP_FEXIT,
KP Singhae240822020-03-04 20:18:49 +0100909 BPF_TRAMP_MODIFY_RETURN,
Alexei Starovoitovbe8704f2020-01-20 16:53:46 -0800910 BPF_TRAMP_MAX,
911 BPF_TRAMP_REPLACE, /* more than MAX */
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800912};
913
Alexei Starovoitove21aa342021-03-16 14:00:07 -0700914struct bpf_tramp_image {
915 void *image;
916 struct bpf_ksym ksym;
917 struct percpu_ref pcref;
918 void *ip_after_call;
919 void *ip_epilogue;
920 union {
921 struct rcu_head rcu;
922 struct work_struct work;
923 };
924};
925
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800926struct bpf_trampoline {
927 /* hlist for trampoline_table */
928 struct hlist_node hlist;
Song Liu00963a22022-07-19 17:21:26 -0700929 struct ftrace_ops *fops;
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800930 /* serializes access to fields of this trampoline */
931 struct mutex mutex;
932 refcount_t refcnt;
Song Liu00963a22022-07-19 17:21:26 -0700933 u32 flags;
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800934 u64 key;
935 struct {
936 struct btf_func_model model;
937 void *addr;
Alexei Starovoitovb91e014f2019-12-08 16:01:13 -0800938 bool ftrace_managed;
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800939 } func;
Alexei Starovoitovbe8704f2020-01-20 16:53:46 -0800940 /* if !NULL this is BPF_PROG_TYPE_EXT program that extends another BPF
941 * program by replacing one of its functions. func.addr is the address
942 * of the function it replaced.
943 */
944 struct bpf_prog *extension_prog;
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800945 /* list of BPF programs using this trampoline */
946 struct hlist_head progs_hlist[BPF_TRAMP_MAX];
947 /* Number of attached programs. A counter per kind. */
948 int progs_cnt[BPF_TRAMP_MAX];
949 /* Executable image of trampoline */
Alexei Starovoitove21aa342021-03-16 14:00:07 -0700950 struct bpf_tramp_image *cur_image;
Jiri Olsa861de022021-03-26 11:59:00 +0100951 struct module *mod;
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800952};
Björn Töpel75ccbef2019-12-13 18:51:08 +0100953
Toke Høiland-Jørgensenf7b12b62020-09-25 23:25:02 +0200954struct bpf_attach_target_info {
955 struct btf_func_model fmodel;
956 long tgt_addr;
957 const char *tgt_name;
958 const struct btf_type *tgt_type;
959};
960
Björn Töpel116eb782019-12-13 18:51:12 +0100961#define BPF_DISPATCHER_MAX 48 /* Fits in 2048B */
Björn Töpel75ccbef2019-12-13 18:51:08 +0100962
963struct bpf_dispatcher_prog {
964 struct bpf_prog *prog;
965 refcount_t users;
966};
967
968struct bpf_dispatcher {
969 /* dispatcher mutex */
970 struct mutex mutex;
971 void *func;
972 struct bpf_dispatcher_prog progs[BPF_DISPATCHER_MAX];
973 int num_progs;
974 void *image;
Song Liu19c02412022-09-26 11:47:38 -0700975 void *rw_image;
Björn Töpel75ccbef2019-12-13 18:51:08 +0100976 u32 image_off;
Jiri Olsa517b75e2020-03-12 20:56:06 +0100977 struct bpf_ksym ksym;
Peter Zijlstrac86df29d2022-11-03 13:00:14 +0100978#ifdef CONFIG_HAVE_STATIC_CALL
979 struct static_call_key *sc_key;
980 void *sc_tramp;
981#endif
Björn Töpel75ccbef2019-12-13 18:51:08 +0100982};
983
Sami Tolvanen9f5b4002021-04-08 11:28:33 -0700984static __always_inline __nocfi unsigned int bpf_dispatcher_nop_func(
Björn Töpel7e6897f2019-12-13 18:51:09 +0100985 const void *ctx,
986 const struct bpf_insn *insnsi,
Stanislav Fomichevaf3f41342022-06-28 10:43:04 -0700987 bpf_func_t bpf_func)
Björn Töpel7e6897f2019-12-13 18:51:09 +0100988{
989 return bpf_func(ctx, insnsi);
990}
Kui-Feng Leef7e0bea2022-05-10 13:59:19 -0700991
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800992#ifdef CONFIG_BPF_JIT
Kui-Feng Leef7e0bea2022-05-10 13:59:19 -0700993int bpf_trampoline_link_prog(struct bpf_tramp_link *link, struct bpf_trampoline *tr);
994int bpf_trampoline_unlink_prog(struct bpf_tramp_link *link, struct bpf_trampoline *tr);
Toke Høiland-Jørgensenf7b12b62020-09-25 23:25:02 +0200995struct bpf_trampoline *bpf_trampoline_get(u64 key,
996 struct bpf_attach_target_info *tgt_info);
Alexei Starovoitovfec56f52019-11-14 10:57:04 -0800997void bpf_trampoline_put(struct bpf_trampoline *tr);
Song Liu19c02412022-09-26 11:47:38 -0700998int arch_prepare_bpf_dispatcher(void *image, void *buf, s64 *funcs, int num_funcs);
Peter Zijlstrac86df29d2022-11-03 13:00:14 +0100999
1000/*
1001 * When the architecture supports STATIC_CALL replace the bpf_dispatcher_fn
1002 * indirection with a direct call to the bpf program. If the architecture does
1003 * not have STATIC_CALL, avoid a double-indirection.
1004 */
1005#ifdef CONFIG_HAVE_STATIC_CALL
1006
1007#define __BPF_DISPATCHER_SC_INIT(_name) \
1008 .sc_key = &STATIC_CALL_KEY(_name), \
1009 .sc_tramp = STATIC_CALL_TRAMP_ADDR(_name),
1010
1011#define __BPF_DISPATCHER_SC(name) \
1012 DEFINE_STATIC_CALL(bpf_dispatcher_##name##_call, bpf_dispatcher_nop_func)
1013
1014#define __BPF_DISPATCHER_CALL(name) \
1015 static_call(bpf_dispatcher_##name##_call)(ctx, insnsi, bpf_func)
1016
1017#define __BPF_DISPATCHER_UPDATE(_d, _new) \
1018 __static_call_update((_d)->sc_key, (_d)->sc_tramp, (_new))
1019
1020#else
1021#define __BPF_DISPATCHER_SC_INIT(name)
1022#define __BPF_DISPATCHER_SC(name)
1023#define __BPF_DISPATCHER_CALL(name) bpf_func(ctx, insnsi)
1024#define __BPF_DISPATCHER_UPDATE(_d, _new)
1025#endif
1026
Jiri Olsa517b75e2020-03-12 20:56:06 +01001027#define BPF_DISPATCHER_INIT(_name) { \
1028 .mutex = __MUTEX_INITIALIZER(_name.mutex), \
1029 .func = &_name##_func, \
1030 .progs = {}, \
1031 .num_progs = 0, \
1032 .image = NULL, \
1033 .image_off = 0, \
1034 .ksym = { \
1035 .name = #_name, \
1036 .lnode = LIST_HEAD_INIT(_name.ksym.lnode), \
1037 }, \
Peter Zijlstrac86df29d2022-11-03 13:00:14 +01001038 __BPF_DISPATCHER_SC_INIT(_name##_call) \
Björn Töpel75ccbef2019-12-13 18:51:08 +01001039}
1040
Björn Töpel75ccbef2019-12-13 18:51:08 +01001041#define DEFINE_BPF_DISPATCHER(name) \
Peter Zijlstrac86df29d2022-11-03 13:00:14 +01001042 __BPF_DISPATCHER_SC(name); \
Sami Tolvanen9f5b4002021-04-08 11:28:33 -07001043 noinline __nocfi unsigned int bpf_dispatcher_##name##_func( \
Björn Töpel75ccbef2019-12-13 18:51:08 +01001044 const void *ctx, \
1045 const struct bpf_insn *insnsi, \
Stanislav Fomichevaf3f41342022-06-28 10:43:04 -07001046 bpf_func_t bpf_func) \
Björn Töpel75ccbef2019-12-13 18:51:08 +01001047 { \
Peter Zijlstrac86df29d2022-11-03 13:00:14 +01001048 return __BPF_DISPATCHER_CALL(name); \
Björn Töpel75ccbef2019-12-13 18:51:08 +01001049 } \
Björn Töpel6a640372020-03-12 20:55:57 +01001050 EXPORT_SYMBOL(bpf_dispatcher_##name##_func); \
1051 struct bpf_dispatcher bpf_dispatcher_##name = \
Peter Zijlstra18acb7f2022-11-03 13:00:13 +01001052 BPF_DISPATCHER_INIT(bpf_dispatcher_##name);
Peter Zijlstrac86df29d2022-11-03 13:00:14 +01001053
Björn Töpel75ccbef2019-12-13 18:51:08 +01001054#define DECLARE_BPF_DISPATCHER(name) \
Björn Töpel6a640372020-03-12 20:55:57 +01001055 unsigned int bpf_dispatcher_##name##_func( \
Björn Töpel75ccbef2019-12-13 18:51:08 +01001056 const void *ctx, \
1057 const struct bpf_insn *insnsi, \
Stanislav Fomichevaf3f41342022-06-28 10:43:04 -07001058 bpf_func_t bpf_func); \
Björn Töpel6a640372020-03-12 20:55:57 +01001059 extern struct bpf_dispatcher bpf_dispatcher_##name;
Peter Zijlstrac86df29d2022-11-03 13:00:14 +01001060
Björn Töpel6a640372020-03-12 20:55:57 +01001061#define BPF_DISPATCHER_FUNC(name) bpf_dispatcher_##name##_func
1062#define BPF_DISPATCHER_PTR(name) (&bpf_dispatcher_##name)
Björn Töpel75ccbef2019-12-13 18:51:08 +01001063void bpf_dispatcher_change_prog(struct bpf_dispatcher *d, struct bpf_prog *from,
1064 struct bpf_prog *to);
Jiri Olsadba122fb2020-03-12 20:56:04 +01001065/* Called only from JIT-enabled code, so there's no need for stubs. */
Jiri Olsaa108f7d2020-03-12 20:56:05 +01001066void bpf_image_ksym_add(void *data, struct bpf_ksym *ksym);
1067void bpf_image_ksym_del(struct bpf_ksym *ksym);
Jiri Olsadba122fb2020-03-12 20:56:04 +01001068void bpf_ksym_add(struct bpf_ksym *ksym);
1069void bpf_ksym_del(struct bpf_ksym *ksym);
Song Liu3486bed2022-02-04 10:57:35 -08001070int bpf_jit_charge_modmem(u32 size);
1071void bpf_jit_uncharge_modmem(u32 size);
Jiri Olsaf92c1e12021-12-08 20:32:44 +01001072bool bpf_prog_has_trampoline(const struct bpf_prog *prog);
Alexei Starovoitovfec56f52019-11-14 10:57:04 -08001073#else
Kui-Feng Leef7e0bea2022-05-10 13:59:19 -07001074static inline int bpf_trampoline_link_prog(struct bpf_tramp_link *link,
Toke Høiland-Jørgensen3aac1ea2020-09-29 14:45:50 +02001075 struct bpf_trampoline *tr)
Alexei Starovoitovfec56f52019-11-14 10:57:04 -08001076{
1077 return -ENOTSUPP;
1078}
Kui-Feng Leef7e0bea2022-05-10 13:59:19 -07001079static inline int bpf_trampoline_unlink_prog(struct bpf_tramp_link *link,
Toke Høiland-Jørgensen3aac1ea2020-09-29 14:45:50 +02001080 struct bpf_trampoline *tr)
Alexei Starovoitovfec56f52019-11-14 10:57:04 -08001081{
1082 return -ENOTSUPP;
1083}
Toke Høiland-Jørgensenf7b12b62020-09-25 23:25:02 +02001084static inline struct bpf_trampoline *bpf_trampoline_get(u64 key,
1085 struct bpf_attach_target_info *tgt_info)
1086{
Leon Hwang163042a2023-09-17 23:38:46 +08001087 return NULL;
Toke Høiland-Jørgensenf7b12b62020-09-25 23:25:02 +02001088}
Alexei Starovoitovfec56f52019-11-14 10:57:04 -08001089static inline void bpf_trampoline_put(struct bpf_trampoline *tr) {}
Björn Töpel75ccbef2019-12-13 18:51:08 +01001090#define DEFINE_BPF_DISPATCHER(name)
1091#define DECLARE_BPF_DISPATCHER(name)
Björn Töpel6a640372020-03-12 20:55:57 +01001092#define BPF_DISPATCHER_FUNC(name) bpf_dispatcher_nop_func
Björn Töpel75ccbef2019-12-13 18:51:08 +01001093#define BPF_DISPATCHER_PTR(name) NULL
1094static inline void bpf_dispatcher_change_prog(struct bpf_dispatcher *d,
1095 struct bpf_prog *from,
1096 struct bpf_prog *to) {}
Jiri Olsae9b4e602020-01-23 17:15:07 +01001097static inline bool is_bpf_image_address(unsigned long address)
1098{
1099 return false;
1100}
Jiri Olsaf92c1e12021-12-08 20:32:44 +01001101static inline bool bpf_prog_has_trampoline(const struct bpf_prog *prog)
1102{
1103 return false;
1104}
Alexei Starovoitovfec56f52019-11-14 10:57:04 -08001105#endif
1106
Alexei Starovoitov8c1b6e62019-11-14 10:57:16 -08001107struct bpf_func_info_aux {
Alexei Starovoitov51c39bb2020-01-09 22:41:20 -08001108 u16 linkage;
Alexei Starovoitov8c1b6e62019-11-14 10:57:16 -08001109 bool unreliable;
1110};
1111
Daniel Borkmanna66886f2019-11-22 21:07:57 +01001112enum bpf_jit_poke_reason {
1113 BPF_POKE_REASON_TAIL_CALL,
1114};
1115
1116/* Descriptor of pokes pointing /into/ the JITed image. */
1117struct bpf_jit_poke_descriptor {
Maciej Fijalkowskicf71b172020-09-16 23:10:06 +02001118 void *tailcall_target;
Maciej Fijalkowskiebf7d1f52020-09-16 23:10:08 +02001119 void *tailcall_bypass;
1120 void *bypass_addr;
John Fastabendf263a812021-07-07 15:38:47 -07001121 void *aux;
Daniel Borkmanna66886f2019-11-22 21:07:57 +01001122 union {
1123 struct {
1124 struct bpf_map *map;
1125 u32 key;
1126 } tail_call;
1127 };
Maciej Fijalkowskicf71b172020-09-16 23:10:06 +02001128 bool tailcall_target_stable;
Daniel Borkmanna66886f2019-11-22 21:07:57 +01001129 u8 adj_off;
1130 u16 reason;
Maciej Fijalkowskia748c692020-09-16 23:10:05 +02001131 u32 insn_idx;
Daniel Borkmanna66886f2019-11-22 21:07:57 +01001132};
1133
Yonghong Song3c32cc12020-05-13 11:02:21 -07001134/* reg_type info for ctx arguments */
1135struct bpf_ctx_arg_aux {
1136 u32 offset;
1137 enum bpf_reg_type reg_type;
Yonghong Song951cf362020-07-20 09:34:03 -07001138 u32 btf_id;
Yonghong Song3c32cc12020-05-13 11:02:21 -07001139};
1140
Andrii Nakryiko541c3ba2021-01-11 23:55:18 -08001141struct btf_mod_pair {
1142 struct btf *btf;
1143 struct module *module;
1144};
1145
Martin KaFai Laue6ac2452021-03-24 18:51:42 -07001146struct bpf_kfunc_desc_tab;
1147
Alexei Starovoitov09756af2014-09-26 00:17:00 -07001148struct bpf_prog_aux {
Andrii Nakryiko85192dbf2019-11-17 09:28:03 -08001149 atomic64_t refcnt;
Daniel Borkmann24701ec2015-03-01 12:31:47 +01001150 u32 used_map_cnt;
Andrii Nakryiko541c3ba2021-01-11 23:55:18 -08001151 u32 used_btf_cnt;
Alexei Starovoitov32bbe002016-04-06 18:43:28 -07001152 u32 max_ctx_offset;
Jiong Wange6478152018-11-08 04:08:42 -05001153 u32 max_pkt_offset;
Matt Mullins9df1c282019-04-26 11:49:47 -07001154 u32 max_tp_access;
Alexei Starovoitov87266792017-05-30 13:31:29 -07001155 u32 stack_depth;
Martin KaFai Laudc4bb0e2017-06-05 12:15:46 -07001156 u32 id;
Yonghong Songba64e7d2018-11-24 23:20:44 -08001157 u32 func_cnt; /* used by non-func prog as the number of func progs */
1158 u32 func_idx; /* 0 for non-func prog, the index in func array for func prog */
Alexei Starovoitovccfe29eb22019-10-15 20:24:58 -07001159 u32 attach_btf_id; /* in-kernel BTF type id to attach to */
Yonghong Song3c32cc12020-05-13 11:02:21 -07001160 u32 ctx_arg_info_size;
Yonghong Songafbf21d2020-07-23 11:41:11 -07001161 u32 max_rdonly_access;
1162 u32 max_rdwr_access;
Andrii Nakryiko22dc4a02020-12-03 12:46:29 -08001163 struct btf *attach_btf;
Yonghong Song3c32cc12020-05-13 11:02:21 -07001164 const struct bpf_ctx_arg_aux *ctx_arg_info;
Toke Høiland-Jørgensen3aac1ea2020-09-29 14:45:50 +02001165 struct mutex dst_mutex; /* protects dst_* pointers below, *after* prog becomes visible */
1166 struct bpf_prog *dst_prog;
1167 struct bpf_trampoline *dst_trampoline;
Toke Høiland-Jørgensen4a1e7c02020-09-29 14:45:51 +02001168 enum bpf_prog_type saved_dst_prog_type;
1169 enum bpf_attach_type saved_dst_attach_type;
Jiong Wanga4b1d3c2019-05-24 23:25:15 +01001170 bool verifier_zext; /* Zero extensions has been inserted by verifier. */
Jakub Kicinski9a18eed2017-12-27 18:39:04 -08001171 bool offload_requested;
Martin KaFai Lau38207292019-10-24 17:18:11 -07001172 bool attach_btf_trace; /* true if attaching to BTF-enabled raw tp */
Alexei Starovoitov8c1b6e62019-11-14 10:57:16 -08001173 bool func_proto_unreliable;
Alexei Starovoitov1e6c62a2020-08-27 15:01:11 -07001174 bool sleepable;
Maciej Fijalkowskiebf7d1f52020-09-16 23:10:08 +02001175 bool tail_call_reachable;
Lorenzo Bianconic2f2cdb2022-01-21 11:09:52 +01001176 bool xdp_has_frags;
Martin KaFai Lau38207292019-10-24 17:18:11 -07001177 /* BTF_KIND_FUNC_PROTO for valid attach_btf_id */
1178 const struct btf_type *attach_func_proto;
1179 /* function name for valid attach_btf_id */
1180 const char *attach_func_name;
Alexei Starovoitov1c2a0882017-12-14 17:55:15 -08001181 struct bpf_prog **func;
1182 void *jit_data; /* JIT specific data. arch dependent */
Daniel Borkmanna66886f2019-11-22 21:07:57 +01001183 struct bpf_jit_poke_descriptor *poke_tab;
Martin KaFai Laue6ac2452021-03-24 18:51:42 -07001184 struct bpf_kfunc_desc_tab *kfunc_tab;
Kumar Kartikeya Dwivedi23576722021-10-02 06:47:49 +05301185 struct bpf_kfunc_btf_tab *kfunc_btf_tab;
Daniel Borkmanna66886f2019-11-22 21:07:57 +01001186 u32 size_poke_tab;
Jiri Olsa535911c2020-03-12 20:55:58 +01001187 struct bpf_ksym ksym;
Jakub Kicinski7de16e32017-10-16 16:40:53 -07001188 const struct bpf_prog_ops *ops;
Alexei Starovoitov09756af2014-09-26 00:17:00 -07001189 struct bpf_map **used_maps;
YiFei Zhu984fe942020-09-15 16:45:39 -07001190 struct mutex used_maps_mutex; /* mutex for used_maps and used_map_cnt */
Andrii Nakryiko541c3ba2021-01-11 23:55:18 -08001191 struct btf_mod_pair *used_btfs;
Alexei Starovoitov09756af2014-09-26 00:17:00 -07001192 struct bpf_prog *prog;
Alexei Starovoitovaaac3ba2015-10-07 22:23:22 -07001193 struct user_struct *user;
Martin KaFai Laucb4d2b32017-09-27 14:37:52 -07001194 u64 load_time; /* ns since boottime */
Dave Marchevskyaba64c72021-10-20 00:48:17 -07001195 u32 verified_insns;
Stanislav Fomichev69fd3372022-06-28 10:43:06 -07001196 int cgroup_atype; /* enum cgroup_bpf_attach_type */
Roman Gushchin8bad74f2018-09-28 14:45:36 +00001197 struct bpf_map *cgroup_storage[MAX_BPF_CGROUP_STORAGE_TYPE];
Martin KaFai Lau067cae42017-10-05 21:52:12 -07001198 char name[BPF_OBJ_NAME_LEN];
Chenbo Fengafdb09c2017-10-18 13:00:24 -07001199#ifdef CONFIG_SECURITY
1200 void *security;
1201#endif
Jakub Kicinski0a9c1992018-01-11 20:29:07 -08001202 struct bpf_prog_offload *offload;
Yonghong Song838e9692018-11-19 15:29:11 -08001203 struct btf *btf;
Yonghong Songba64e7d2018-11-24 23:20:44 -08001204 struct bpf_func_info *func_info;
Alexei Starovoitov8c1b6e62019-11-14 10:57:16 -08001205 struct bpf_func_info_aux *func_info_aux;
Martin KaFai Lauc454a462018-12-07 16:42:25 -08001206 /* bpf_line_info loaded from userspace. linfo->insn_off
1207 * has the xlated insn offset.
1208 * Both the main and sub prog share the same linfo.
1209 * The subprog can access its first linfo by
1210 * using the linfo_idx.
1211 */
1212 struct bpf_line_info *linfo;
1213 /* jited_linfo is the jited addr of the linfo. It has a
1214 * one to one mapping to linfo:
1215 * jited_linfo[i] is the jited addr for the linfo[i]->insn_off.
1216 * Both the main and sub prog share the same jited_linfo.
1217 * The subprog can access its first jited_linfo by
1218 * using the linfo_idx.
1219 */
1220 void **jited_linfo;
Yonghong Songba64e7d2018-11-24 23:20:44 -08001221 u32 func_info_cnt;
Martin KaFai Lauc454a462018-12-07 16:42:25 -08001222 u32 nr_linfo;
1223 /* subprog can use linfo_idx to access its first linfo and
1224 * jited_linfo.
1225 * main prog always has linfo_idx == 0
1226 */
1227 u32 linfo_idx;
Alexei Starovoitov3dec5412019-10-15 20:25:03 -07001228 u32 num_exentries;
1229 struct exception_table_entry *extable;
Alexei Starovoitovabf2e7d2015-05-28 19:26:02 -07001230 union {
1231 struct work_struct work;
1232 struct rcu_head rcu;
1233 };
Alexei Starovoitov09756af2014-09-26 00:17:00 -07001234};
1235
Delyan Kratunovd687f622022-06-14 23:10:42 +00001236struct bpf_prog {
1237 u16 pages; /* Number of allocated pages */
1238 u16 jited:1, /* Is our filter JIT'ed? */
1239 jit_requested:1,/* archs need to JIT the prog */
1240 gpl_compatible:1, /* Is filter GPL compatible? */
1241 cb_access:1, /* Is control block accessed? */
1242 dst_needed:1, /* Do we need dst entry? */
1243 blinding_requested:1, /* needs constant blinding */
1244 blinded:1, /* Was blinded */
1245 is_func:1, /* program is a bpf function */
1246 kprobe_override:1, /* Do we override a kprobe? */
1247 has_callchain_buf:1, /* callchain buffer allocated? */
1248 enforce_expected_attach_type:1, /* Enforce expected_attach_type checking at attach time */
1249 call_get_stack:1, /* Do we call bpf_get_stack() or bpf_get_stackid() */
1250 call_get_func_ip:1, /* Do we call get_func_ip() */
1251 tstamp_type_access:1; /* Accessed __sk_buff->tstamp_type */
1252 enum bpf_prog_type type; /* Type of BPF program */
1253 enum bpf_attach_type expected_attach_type; /* For some prog types */
1254 u32 len; /* Number of filter blocks */
1255 u32 jited_len; /* Size of jited insns in bytes */
1256 u8 tag[BPF_TAG_SIZE];
1257 struct bpf_prog_stats __percpu *stats;
1258 int __percpu *active;
1259 unsigned int (*bpf_func)(const void *ctx,
1260 const struct bpf_insn *insn);
1261 struct bpf_prog_aux *aux; /* Auxiliary fields */
1262 struct sock_fprog_kern *orig_prog; /* Original BPF program */
1263 /* Instructions for interpreter */
1264 union {
1265 DECLARE_FLEX_ARRAY(struct sock_filter, insns);
1266 DECLARE_FLEX_ARRAY(struct bpf_insn, insnsi);
1267 };
1268};
1269
Daniel Borkmann2beee5f2019-11-22 21:07:56 +01001270struct bpf_array_aux {
Daniel Borkmannda765a22019-11-22 21:07:58 +01001271 /* Programs with direct jumps into programs part of this array. */
1272 struct list_head poke_progs;
1273 struct bpf_map *map;
1274 struct mutex poke_mutex;
1275 struct work_struct work;
Daniel Borkmann2beee5f2019-11-22 21:07:56 +01001276};
1277
Andrii Nakryiko6cc7d1e2020-07-21 23:45:54 -07001278struct bpf_link {
1279 atomic64_t refcnt;
1280 u32 id;
1281 enum bpf_link_type type;
1282 const struct bpf_link_ops *ops;
1283 struct bpf_prog *prog;
1284 struct work_struct work;
1285};
1286
1287struct bpf_link_ops {
1288 void (*release)(struct bpf_link *link);
1289 void (*dealloc)(struct bpf_link *link);
Andrii Nakryiko73b11c2a2020-07-31 11:28:26 -07001290 int (*detach)(struct bpf_link *link);
Andrii Nakryiko6cc7d1e2020-07-21 23:45:54 -07001291 int (*update_prog)(struct bpf_link *link, struct bpf_prog *new_prog,
1292 struct bpf_prog *old_prog);
1293 void (*show_fdinfo)(const struct bpf_link *link, struct seq_file *seq);
1294 int (*fill_link_info)(const struct bpf_link *link,
1295 struct bpf_link_info *info);
1296};
1297
Kui-Feng Leef7e0bea2022-05-10 13:59:19 -07001298struct bpf_tramp_link {
1299 struct bpf_link link;
1300 struct hlist_node tramp_hlist;
Kui-Feng Lee2fcc8242022-05-10 13:59:21 -07001301 u64 cookie;
Kui-Feng Leef7e0bea2022-05-10 13:59:19 -07001302};
1303
Stanislav Fomichev69fd3372022-06-28 10:43:06 -07001304struct bpf_shim_tramp_link {
1305 struct bpf_tramp_link link;
1306 struct bpf_trampoline *trampoline;
1307};
1308
Kui-Feng Leef7e0bea2022-05-10 13:59:19 -07001309struct bpf_tracing_link {
1310 struct bpf_tramp_link link;
1311 enum bpf_attach_type attach_type;
1312 struct bpf_trampoline *trampoline;
1313 struct bpf_prog *tgt_prog;
1314};
1315
Andrii Nakryiko6cc7d1e2020-07-21 23:45:54 -07001316struct bpf_link_primer {
1317 struct bpf_link *link;
1318 struct file *file;
1319 int fd;
1320 u32 id;
1321};
1322
Martin KaFai Lau85d33df2020-01-08 16:35:05 -08001323struct bpf_struct_ops_value;
Martin KaFai Lau27ae79972020-01-08 16:35:03 -08001324struct btf_member;
1325
1326#define BPF_STRUCT_OPS_MAX_NR_MEMBERS 64
1327struct bpf_struct_ops {
1328 const struct bpf_verifier_ops *verifier_ops;
1329 int (*init)(struct btf *btf);
1330 int (*check_member)(const struct btf_type *t,
1331 const struct btf_member *member);
Martin KaFai Lau85d33df2020-01-08 16:35:05 -08001332 int (*init_member)(const struct btf_type *t,
1333 const struct btf_member *member,
1334 void *kdata, const void *udata);
1335 int (*reg)(void *kdata);
1336 void (*unreg)(void *kdata);
Martin KaFai Lau27ae79972020-01-08 16:35:03 -08001337 const struct btf_type *type;
Martin KaFai Lau85d33df2020-01-08 16:35:05 -08001338 const struct btf_type *value_type;
Martin KaFai Lau27ae79972020-01-08 16:35:03 -08001339 const char *name;
1340 struct btf_func_model func_models[BPF_STRUCT_OPS_MAX_NR_MEMBERS];
1341 u32 type_id;
Martin KaFai Lau85d33df2020-01-08 16:35:05 -08001342 u32 value_id;
Martin KaFai Lau27ae79972020-01-08 16:35:03 -08001343};
1344
1345#if defined(CONFIG_BPF_JIT) && defined(CONFIG_BPF_SYSCALL)
Martin KaFai Lau85d33df2020-01-08 16:35:05 -08001346#define BPF_MODULE_OWNER ((void *)((0xeB9FUL << 2) + POISON_POINTER_DELTA))
Martin KaFai Lau27ae79972020-01-08 16:35:03 -08001347const struct bpf_struct_ops *bpf_struct_ops_find(u32 type_id);
Martin KaFai Laud3e42bb2020-01-27 09:51:45 -08001348void bpf_struct_ops_init(struct btf *btf, struct bpf_verifier_log *log);
Martin KaFai Lau85d33df2020-01-08 16:35:05 -08001349bool bpf_struct_ops_get(const void *kdata);
1350void bpf_struct_ops_put(const void *kdata);
1351int bpf_struct_ops_map_sys_lookup_elem(struct bpf_map *map, void *key,
1352 void *value);
Kui-Feng Leef7e0bea2022-05-10 13:59:19 -07001353int bpf_struct_ops_prepare_trampoline(struct bpf_tramp_links *tlinks,
1354 struct bpf_tramp_link *link,
Hou Tao31a645a2021-10-25 14:40:22 +08001355 const struct btf_func_model *model,
1356 void *image, void *image_end);
Martin KaFai Lau85d33df2020-01-08 16:35:05 -08001357static inline bool bpf_try_module_get(const void *data, struct module *owner)
1358{
1359 if (owner == BPF_MODULE_OWNER)
1360 return bpf_struct_ops_get(data);
1361 else
1362 return try_module_get(owner);
1363}
1364static inline void bpf_module_put(const void *data, struct module *owner)
1365{
1366 if (owner == BPF_MODULE_OWNER)
1367 bpf_struct_ops_put(data);
1368 else
1369 module_put(owner);
1370}
Hou Taoc1969062021-10-25 14:40:24 +08001371
1372#ifdef CONFIG_NET
1373/* Define it here to avoid the use of forward declaration */
1374struct bpf_dummy_ops_state {
1375 int val;
1376};
1377
1378struct bpf_dummy_ops {
1379 int (*test_1)(struct bpf_dummy_ops_state *cb);
1380 int (*test_2)(struct bpf_dummy_ops_state *cb, int a1, unsigned short a2,
1381 char a3, unsigned long a4);
1382};
1383
1384int bpf_struct_ops_test_run(struct bpf_prog *prog, const union bpf_attr *kattr,
1385 union bpf_attr __user *uattr);
1386#endif
Martin KaFai Lau27ae79972020-01-08 16:35:03 -08001387#else
1388static inline const struct bpf_struct_ops *bpf_struct_ops_find(u32 type_id)
1389{
1390 return NULL;
1391}
Martin KaFai Laud3e42bb2020-01-27 09:51:45 -08001392static inline void bpf_struct_ops_init(struct btf *btf,
1393 struct bpf_verifier_log *log)
1394{
1395}
Martin KaFai Lau85d33df2020-01-08 16:35:05 -08001396static inline bool bpf_try_module_get(const void *data, struct module *owner)
1397{
1398 return try_module_get(owner);
1399}
1400static inline void bpf_module_put(const void *data, struct module *owner)
1401{
1402 module_put(owner);
1403}
1404static inline int bpf_struct_ops_map_sys_lookup_elem(struct bpf_map *map,
1405 void *key,
1406 void *value)
1407{
1408 return -EINVAL;
1409}
Stanislav Fomichev9cb61fd2022-07-20 08:52:20 -07001410#endif
1411
1412#if defined(CONFIG_CGROUP_BPF) && defined(CONFIG_BPF_LSM)
1413int bpf_trampoline_link_cgroup_shim(struct bpf_prog *prog,
1414 int cgroup_atype);
1415void bpf_trampoline_unlink_cgroup_shim(struct bpf_prog *prog);
1416#else
Stanislav Fomichev69fd3372022-06-28 10:43:06 -07001417static inline int bpf_trampoline_link_cgroup_shim(struct bpf_prog *prog,
1418 int cgroup_atype)
1419{
1420 return -EOPNOTSUPP;
1421}
1422static inline void bpf_trampoline_unlink_cgroup_shim(struct bpf_prog *prog)
1423{
1424}
Martin KaFai Lau27ae79972020-01-08 16:35:03 -08001425#endif
1426
Alexei Starovoitov04fd61ab2015-05-19 16:59:03 -07001427struct bpf_array {
1428 struct bpf_map map;
1429 u32 elem_size;
Alexei Starovoitovb2157392018-01-07 17:33:02 -08001430 u32 index_mask;
Daniel Borkmann2beee5f2019-11-22 21:07:56 +01001431 struct bpf_array_aux *aux;
Alexei Starovoitov04fd61ab2015-05-19 16:59:03 -07001432 union {
1433 char value[0] __aligned(8);
Wang Nan2a36f0b2015-08-06 07:02:33 +00001434 void *ptrs[0] __aligned(8);
Alexei Starovoitova10423b2016-02-01 22:39:54 -08001435 void __percpu *pptrs[0] __aligned(8);
Alexei Starovoitov04fd61ab2015-05-19 16:59:03 -07001436 };
1437};
Daniel Borkmann3b1efb12016-06-15 22:47:14 +02001438
Alexei Starovoitovc04c0d22019-04-01 21:27:45 -07001439#define BPF_COMPLEXITY_LIMIT_INSNS 1000000 /* yes. 1M insns */
Tiezhu Yangebf7f6f2021-11-05 09:30:00 +08001440#define MAX_TAIL_CALL_CNT 33
Alexei Starovoitov04fd61ab2015-05-19 16:59:03 -07001441
Eduard Zingerman1ade2372022-06-21 02:53:42 +03001442/* Maximum number of loops for bpf_loop */
1443#define BPF_MAX_LOOPS BIT(23)
1444
Daniel Borkmann591fe982019-04-09 23:20:05 +02001445#define BPF_F_ACCESS_MASK (BPF_F_RDONLY | \
1446 BPF_F_RDONLY_PROG | \
1447 BPF_F_WRONLY | \
1448 BPF_F_WRONLY_PROG)
1449
1450#define BPF_MAP_CAN_READ BIT(0)
1451#define BPF_MAP_CAN_WRITE BIT(1)
1452
David Vernet20571562022-09-19 19:00:58 -05001453/* Maximum number of user-producer ring buffer samples that can be drained in
1454 * a call to bpf_user_ringbuf_drain().
1455 */
1456#define BPF_MAX_USER_RINGBUF_SAMPLES (128 * 1024)
1457
Daniel Borkmann591fe982019-04-09 23:20:05 +02001458static inline u32 bpf_map_flags_to_cap(struct bpf_map *map)
1459{
1460 u32 access_flags = map->map_flags & (BPF_F_RDONLY_PROG | BPF_F_WRONLY_PROG);
1461
1462 /* Combination of BPF_F_RDONLY_PROG | BPF_F_WRONLY_PROG is
1463 * not possible.
1464 */
1465 if (access_flags & BPF_F_RDONLY_PROG)
1466 return BPF_MAP_CAN_READ;
1467 else if (access_flags & BPF_F_WRONLY_PROG)
1468 return BPF_MAP_CAN_WRITE;
1469 else
1470 return BPF_MAP_CAN_READ | BPF_MAP_CAN_WRITE;
1471}
1472
1473static inline bool bpf_map_flags_access_ok(u32 access_flags)
1474{
1475 return (access_flags & (BPF_F_RDONLY_PROG | BPF_F_WRONLY_PROG)) !=
1476 (BPF_F_RDONLY_PROG | BPF_F_WRONLY_PROG);
1477}
1478
Daniel Borkmann3b1efb12016-06-15 22:47:14 +02001479struct bpf_event_entry {
1480 struct perf_event *event;
1481 struct file *perf_file;
1482 struct file *map_file;
1483 struct rcu_head rcu;
1484};
1485
Toke Hoiland-Jorgensenf45d5b62022-01-21 11:10:02 +01001486static inline bool map_type_contains_progs(struct bpf_map *map)
1487{
1488 return map->map_type == BPF_MAP_TYPE_PROG_ARRAY ||
1489 map->map_type == BPF_MAP_TYPE_DEVMAP ||
1490 map->map_type == BPF_MAP_TYPE_CPUMAP;
1491}
1492
1493bool bpf_prog_map_compatible(struct bpf_map *map, const struct bpf_prog *fp);
Daniel Borkmannf1f77142017-01-13 23:38:15 +01001494int bpf_prog_calc_tag(struct bpf_prog *fp);
Daniel Borkmannbd570ff2016-04-18 21:01:24 +02001495
Alexei Starovoitov0756ea32015-06-12 19:39:13 -07001496const struct bpf_func_proto *bpf_get_trace_printk_proto(void);
Dave Marchevsky10aceb62021-09-17 11:29:05 -07001497const struct bpf_func_proto *bpf_get_trace_vprintk_proto(void);
Daniel Borkmann555c8a82016-07-14 18:08:05 +02001498
1499typedef unsigned long (*bpf_ctx_copy_t)(void *dst, const void *src,
Daniel Borkmannaa7145c2016-07-22 01:19:42 +02001500 unsigned long off, unsigned long len);
Joe Stringerc64b7982018-10-02 13:35:33 -07001501typedef u32 (*bpf_convert_ctx_access_t)(enum bpf_access_type type,
1502 const struct bpf_insn *src,
1503 struct bpf_insn *dst,
1504 struct bpf_prog *prog,
1505 u32 *target_size);
Daniel Borkmann555c8a82016-07-14 18:08:05 +02001506
1507u64 bpf_event_output(struct bpf_map *map, u64 flags, void *meta, u64 meta_size,
1508 void *ctx, u64 ctx_size, bpf_ctx_copy_t ctx_copy);
Alexei Starovoitov04fd61ab2015-05-19 16:59:03 -07001509
Alexei Starovoitov324bda9e62017-10-02 22:50:21 -07001510/* an array of programs to be executed under rcu_lock.
1511 *
1512 * Typical usage:
Stanislav Fomichev055eb9552022-04-14 09:12:33 -07001513 * ret = bpf_prog_run_array(rcu_dereference(&bpf_prog_array), ctx, bpf_prog_run);
Alexei Starovoitov324bda9e62017-10-02 22:50:21 -07001514 *
1515 * the structure returned by bpf_prog_array_alloc() should be populated
1516 * with program pointers and the last pointer must be NULL.
1517 * The user has to keep refcnt on the program and make sure the program
1518 * is removed from the array before bpf_prog_put().
1519 * The 'struct bpf_prog_array *' should only be replaced with xchg()
1520 * since other cpus are walking the array of pointers in parallel.
1521 */
Roman Gushchin394e40a2018-08-02 14:27:21 -07001522struct bpf_prog_array_item {
1523 struct bpf_prog *prog;
Andrii Nakryiko82e6b1e2021-08-15 00:05:58 -07001524 union {
1525 struct bpf_cgroup_storage *cgroup_storage[MAX_BPF_CGROUP_STORAGE_TYPE];
1526 u64 bpf_cookie;
1527 };
Roman Gushchin394e40a2018-08-02 14:27:21 -07001528};
1529
Alexei Starovoitov324bda9e62017-10-02 22:50:21 -07001530struct bpf_prog_array {
1531 struct rcu_head rcu;
Gustavo A. R. Silvad7f10df2020-02-26 18:17:44 -06001532 struct bpf_prog_array_item items[];
Alexei Starovoitov324bda9e62017-10-02 22:50:21 -07001533};
1534
Pavel Begunkov46531a32022-01-27 14:09:13 +00001535struct bpf_empty_prog_array {
1536 struct bpf_prog_array hdr;
1537 struct bpf_prog *null_prog;
1538};
1539
1540/* to avoid allocating empty bpf_prog_array for cgroups that
1541 * don't have bpf program attached use one global 'bpf_empty_prog_array'
1542 * It will not be modified the caller of bpf_prog_array_alloc()
1543 * (since caller requested prog_cnt == 0)
1544 * that pointer should be 'freed' by bpf_prog_array_free()
1545 */
1546extern struct bpf_empty_prog_array bpf_empty_prog_array;
1547
Roman Gushchind29ab6e2018-07-13 12:41:10 -07001548struct bpf_prog_array *bpf_prog_array_alloc(u32 prog_cnt, gfp_t flags);
Stanislav Fomichev54e9c9d2019-05-28 14:14:41 -07001549void bpf_prog_array_free(struct bpf_prog_array *progs);
Delyan Kratunov8c7dcb82022-06-14 23:10:46 +00001550/* Use when traversal over the bpf_prog_array uses tasks_trace rcu */
1551void bpf_prog_array_free_sleepable(struct bpf_prog_array *progs);
Stanislav Fomichev54e9c9d2019-05-28 14:14:41 -07001552int bpf_prog_array_length(struct bpf_prog_array *progs);
Stanislav Fomichev0d01da62019-06-27 13:38:47 -07001553bool bpf_prog_array_is_empty(struct bpf_prog_array *array);
Stanislav Fomichev54e9c9d2019-05-28 14:14:41 -07001554int bpf_prog_array_copy_to_user(struct bpf_prog_array *progs,
Alexei Starovoitov468e2f62017-10-02 22:50:22 -07001555 __u32 __user *prog_ids, u32 cnt);
Alexei Starovoitov324bda9e62017-10-02 22:50:21 -07001556
Stanislav Fomichev54e9c9d2019-05-28 14:14:41 -07001557void bpf_prog_array_delete_safe(struct bpf_prog_array *progs,
Yonghong Songe87c6bc382017-10-23 23:53:08 -07001558 struct bpf_prog *old_prog);
Jakub Sitnickice3aa9c2020-07-17 12:35:22 +02001559int bpf_prog_array_delete_safe_at(struct bpf_prog_array *array, int index);
1560int bpf_prog_array_update_at(struct bpf_prog_array *array, int index,
1561 struct bpf_prog *prog);
Stanislav Fomichev54e9c9d2019-05-28 14:14:41 -07001562int bpf_prog_array_copy_info(struct bpf_prog_array *array,
Yonghong Song3a38bb92018-04-10 09:37:32 -07001563 u32 *prog_ids, u32 request_cnt,
1564 u32 *prog_cnt);
Stanislav Fomichev54e9c9d2019-05-28 14:14:41 -07001565int bpf_prog_array_copy(struct bpf_prog_array *old_array,
Yonghong Songe87c6bc382017-10-23 23:53:08 -07001566 struct bpf_prog *exclude_prog,
1567 struct bpf_prog *include_prog,
Andrii Nakryiko82e6b1e2021-08-15 00:05:58 -07001568 u64 bpf_cookie,
Yonghong Songe87c6bc382017-10-23 23:53:08 -07001569 struct bpf_prog_array **new_array);
1570
Andrii Nakryikoc7603cf2021-07-12 16:06:15 -07001571struct bpf_run_ctx {};
1572
1573struct bpf_cg_run_ctx {
1574 struct bpf_run_ctx run_ctx;
Andrii Nakryiko7d08c2c2021-08-15 00:05:55 -07001575 const struct bpf_prog_array_item *prog_item;
YiFei Zhuc4dcfdd2021-12-16 02:04:26 +00001576 int retval;
Andrii Nakryikoc7603cf2021-07-12 16:06:15 -07001577};
1578
Andrii Nakryiko82e6b1e2021-08-15 00:05:58 -07001579struct bpf_trace_run_ctx {
1580 struct bpf_run_ctx run_ctx;
1581 u64 bpf_cookie;
1582};
1583
Kui-Feng Leee384c7b2022-05-10 13:59:20 -07001584struct bpf_tramp_run_ctx {
1585 struct bpf_run_ctx run_ctx;
1586 u64 bpf_cookie;
1587 struct bpf_run_ctx *saved_run_ctx;
1588};
1589
Andrii Nakryiko7d08c2c2021-08-15 00:05:55 -07001590static inline struct bpf_run_ctx *bpf_set_run_ctx(struct bpf_run_ctx *new_ctx)
1591{
1592 struct bpf_run_ctx *old_ctx = NULL;
1593
1594#ifdef CONFIG_BPF_SYSCALL
1595 old_ctx = current->bpf_ctx;
1596 current->bpf_ctx = new_ctx;
1597#endif
1598 return old_ctx;
1599}
1600
1601static inline void bpf_reset_run_ctx(struct bpf_run_ctx *old_ctx)
1602{
1603#ifdef CONFIG_BPF_SYSCALL
1604 current->bpf_ctx = old_ctx;
1605#endif
1606}
1607
Stanislav Fomichev77241212021-01-27 11:31:39 -08001608/* BPF program asks to bypass CAP_NET_BIND_SERVICE in bind. */
1609#define BPF_RET_BIND_NO_CAP_NET_BIND_SERVICE (1 << 0)
1610/* BPF program asks to set CN on the packet. */
1611#define BPF_RET_SET_CN (1 << 0)
1612
Andrii Nakryiko7d08c2c2021-08-15 00:05:55 -07001613typedef u32 (*bpf_prog_run_fn)(const struct bpf_prog *prog, const void *ctx);
Stanislav Fomichev77241212021-01-27 11:31:39 -08001614
Andrii Nakryiko7d08c2c2021-08-15 00:05:55 -07001615static __always_inline u32
Stanislav Fomichev055eb9552022-04-14 09:12:33 -07001616bpf_prog_run_array(const struct bpf_prog_array *array,
Andrii Nakryiko7d08c2c2021-08-15 00:05:55 -07001617 const void *ctx, bpf_prog_run_fn run_prog)
1618{
1619 const struct bpf_prog_array_item *item;
1620 const struct bpf_prog *prog;
Andrii Nakryiko82e6b1e2021-08-15 00:05:58 -07001621 struct bpf_run_ctx *old_run_ctx;
1622 struct bpf_trace_run_ctx run_ctx;
Andrii Nakryiko7d08c2c2021-08-15 00:05:55 -07001623 u32 ret = 1;
1624
Stanislav Fomichev055eb9552022-04-14 09:12:33 -07001625 RCU_LOCKDEP_WARN(!rcu_read_lock_held(), "no rcu lock held");
1626
Andrii Nakryiko7d08c2c2021-08-15 00:05:55 -07001627 if (unlikely(!array))
Stanislav Fomichev055eb9552022-04-14 09:12:33 -07001628 return ret;
1629
1630 migrate_disable();
Andrii Nakryiko82e6b1e2021-08-15 00:05:58 -07001631 old_run_ctx = bpf_set_run_ctx(&run_ctx.run_ctx);
Andrii Nakryiko7d08c2c2021-08-15 00:05:55 -07001632 item = &array->items[0];
1633 while ((prog = READ_ONCE(item->prog))) {
Andrii Nakryiko82e6b1e2021-08-15 00:05:58 -07001634 run_ctx.bpf_cookie = item->bpf_cookie;
Andrii Nakryiko7d08c2c2021-08-15 00:05:55 -07001635 ret &= run_prog(prog, ctx);
1636 item++;
1637 }
Andrii Nakryiko82e6b1e2021-08-15 00:05:58 -07001638 bpf_reset_run_ctx(old_run_ctx);
Andrii Nakryiko7d08c2c2021-08-15 00:05:55 -07001639 migrate_enable();
1640 return ret;
1641}
Alexei Starovoitov324bda9e62017-10-02 22:50:21 -07001642
Delyan Kratunov8c7dcb82022-06-14 23:10:46 +00001643/* Notes on RCU design for bpf_prog_arrays containing sleepable programs:
1644 *
1645 * We use the tasks_trace rcu flavor read section to protect the bpf_prog_array
1646 * overall. As a result, we must use the bpf_prog_array_free_sleepable
1647 * in order to use the tasks_trace rcu grace period.
1648 *
1649 * When a non-sleepable program is inside the array, we take the rcu read
1650 * section and disable preemption for that program alone, so it can access
1651 * rcu-protected dynamically sized maps.
1652 */
1653static __always_inline u32
1654bpf_prog_run_array_sleepable(const struct bpf_prog_array __rcu *array_rcu,
1655 const void *ctx, bpf_prog_run_fn run_prog)
1656{
1657 const struct bpf_prog_array_item *item;
1658 const struct bpf_prog *prog;
1659 const struct bpf_prog_array *array;
1660 struct bpf_run_ctx *old_run_ctx;
1661 struct bpf_trace_run_ctx run_ctx;
1662 u32 ret = 1;
1663
1664 might_fault();
1665
1666 rcu_read_lock_trace();
1667 migrate_disable();
1668
1669 array = rcu_dereference_check(array_rcu, rcu_read_lock_trace_held());
1670 if (unlikely(!array))
1671 goto out;
1672 old_run_ctx = bpf_set_run_ctx(&run_ctx.run_ctx);
1673 item = &array->items[0];
1674 while ((prog = READ_ONCE(item->prog))) {
1675 if (!prog->aux->sleepable)
1676 rcu_read_lock();
1677
1678 run_ctx.bpf_cookie = item->bpf_cookie;
1679 ret &= run_prog(prog, ctx);
1680 item++;
1681
1682 if (!prog->aux->sleepable)
1683 rcu_read_unlock();
1684 }
1685 bpf_reset_run_ctx(old_run_ctx);
1686out:
1687 migrate_enable();
1688 rcu_read_unlock_trace();
1689 return ret;
1690}
1691
Alexei Starovoitov89aa0752014-12-01 15:06:35 -08001692#ifdef CONFIG_BPF_SYSCALL
Alexei Starovoitovb121d1e2016-03-07 21:57:13 -08001693DECLARE_PER_CPU(int, bpf_prog_active);
Song Liud46edd62020-04-30 00:15:04 -07001694extern struct mutex bpf_stats_enabled_mutex;
Alexei Starovoitovb121d1e2016-03-07 21:57:13 -08001695
Thomas Gleixnerc518cfa2020-02-24 15:01:47 +01001696/*
1697 * Block execution of BPF programs attached to instrumentation (perf,
1698 * kprobes, tracepoints) to prevent deadlocks on map operations as any of
1699 * these events can happen inside a region which holds a map bucket lock
1700 * and can deadlock on it.
Thomas Gleixnerc518cfa2020-02-24 15:01:47 +01001701 */
1702static inline void bpf_disable_instrumentation(void)
1703{
1704 migrate_disable();
Sebastian Andrzej Siewior79364032021-11-27 17:32:00 +01001705 this_cpu_inc(bpf_prog_active);
Thomas Gleixnerc518cfa2020-02-24 15:01:47 +01001706}
1707
1708static inline void bpf_enable_instrumentation(void)
1709{
Sebastian Andrzej Siewior79364032021-11-27 17:32:00 +01001710 this_cpu_dec(bpf_prog_active);
Thomas Gleixnerc518cfa2020-02-24 15:01:47 +01001711 migrate_enable();
1712}
1713
Chenbo Fengf66e4482017-10-18 13:00:26 -07001714extern const struct file_operations bpf_map_fops;
1715extern const struct file_operations bpf_prog_fops;
Yonghong Song367ec3e2020-05-09 10:59:06 -07001716extern const struct file_operations bpf_iter_fops;
Chenbo Fengf66e4482017-10-18 13:00:26 -07001717
Alexei Starovoitov91cc1a92019-11-14 10:57:15 -08001718#define BPF_PROG_TYPE(_id, _name, prog_ctx_type, kern_ctx_type) \
Jakub Kicinski7de16e32017-10-16 16:40:53 -07001719 extern const struct bpf_prog_ops _name ## _prog_ops; \
1720 extern const struct bpf_verifier_ops _name ## _verifier_ops;
Johannes Berg40077e02017-04-11 15:34:58 +02001721#define BPF_MAP_TYPE(_id, _ops) \
1722 extern const struct bpf_map_ops _ops;
Andrii Nakryikof2e10bf2020-04-28 17:16:08 -07001723#define BPF_LINK_TYPE(_id, _name)
Johannes Bergbe9370a2017-04-11 15:34:57 +02001724#include <linux/bpf_types.h>
1725#undef BPF_PROG_TYPE
Johannes Berg40077e02017-04-11 15:34:58 +02001726#undef BPF_MAP_TYPE
Andrii Nakryikof2e10bf2020-04-28 17:16:08 -07001727#undef BPF_LINK_TYPE
Daniel Borkmann0fc174d2015-03-01 12:31:44 +01001728
Jakub Kicinskiab3f0062017-11-03 13:56:17 -07001729extern const struct bpf_prog_ops bpf_offload_prog_ops;
Jakub Kicinski4f9218a2017-10-16 16:40:55 -07001730extern const struct bpf_verifier_ops tc_cls_act_analyzer_ops;
1731extern const struct bpf_verifier_ops xdp_analyzer_ops;
1732
Alexei Starovoitov09756af2014-09-26 00:17:00 -07001733struct bpf_prog *bpf_prog_get(u32 ufd);
Jakub Kicinski248f3462017-11-03 13:56:20 -07001734struct bpf_prog *bpf_prog_get_type_dev(u32 ufd, enum bpf_prog_type type,
Jakub Kicinski288b3de52017-11-20 15:21:54 -08001735 bool attach_drv);
Andrii Nakryiko85192dbf2019-11-17 09:28:03 -08001736void bpf_prog_add(struct bpf_prog *prog, int i);
Daniel Borkmannc5405942016-11-09 22:02:34 +01001737void bpf_prog_sub(struct bpf_prog *prog, int i);
Andrii Nakryiko85192dbf2019-11-17 09:28:03 -08001738void bpf_prog_inc(struct bpf_prog *prog);
John Fastabenda6f6df62017-08-15 22:32:22 -07001739struct bpf_prog * __must_check bpf_prog_inc_not_zero(struct bpf_prog *prog);
Daniel Borkmann61e021f32015-03-02 15:21:55 +01001740void bpf_prog_put(struct bpf_prog *prog);
1741
Jakub Kicinskiad8ad792017-12-27 18:39:07 -08001742void bpf_prog_free_id(struct bpf_prog *prog, bool do_idr_lock);
Jakub Kicinskia3884572018-01-11 20:29:09 -08001743void bpf_map_free_id(struct bpf_map *map, bool do_idr_lock);
Jakub Kicinskiad8ad792017-12-27 18:39:07 -08001744
Kumar Kartikeya Dwivedi61df10c2022-04-25 03:18:49 +05301745struct bpf_map_value_off_desc *bpf_map_kptr_off_contains(struct bpf_map *map, u32 offset);
1746void bpf_map_free_kptr_off_tab(struct bpf_map *map);
1747struct bpf_map_value_off *bpf_map_copy_kptr_off_tab(const struct bpf_map *map);
1748bool bpf_map_equal_kptr_off_tab(const struct bpf_map *map_a, const struct bpf_map *map_b);
Kumar Kartikeya Dwivedi14a324f2022-04-25 03:18:55 +05301749void bpf_map_free_kptrs(struct bpf_map *map, void *map_value);
Kumar Kartikeya Dwivedi61df10c2022-04-25 03:18:49 +05301750
Martin KaFai Lau1ed4d922020-02-25 15:04:21 -08001751struct bpf_map *bpf_map_get(u32 ufd);
Daniel Borkmannc9da1612015-11-24 21:28:15 +01001752struct bpf_map *bpf_map_get_with_uref(u32 ufd);
Daniel Borkmannc2101292015-10-29 14:58:07 +01001753struct bpf_map *__bpf_map_get(struct fd f);
Andrii Nakryiko1e0bd5a2019-11-17 09:28:02 -08001754void bpf_map_inc(struct bpf_map *map);
1755void bpf_map_inc_with_uref(struct bpf_map *map);
1756struct bpf_map * __must_check bpf_map_inc_not_zero(struct bpf_map *map);
Daniel Borkmannc9da1612015-11-24 21:28:15 +01001757void bpf_map_put_with_uref(struct bpf_map *map);
Daniel Borkmann61e021f32015-03-02 15:21:55 +01001758void bpf_map_put(struct bpf_map *map);
Daniel Borkmann196e8ca2019-11-20 23:04:44 +01001759void *bpf_map_area_alloc(u64 size, int numa_node);
1760void *bpf_map_area_mmapable_alloc(u64 size, int numa_node);
Daniel Borkmannd407bd22017-01-18 15:14:17 +01001761void bpf_map_area_free(void *base);
Daniel Borkmann353050b2021-11-09 18:48:08 +00001762bool bpf_map_write_active(const struct bpf_map *map);
Jakub Kicinskibd475642018-01-11 20:29:06 -08001763void bpf_map_init_from_attr(struct bpf_map *map, union bpf_attr *attr);
Brian Vazquezcb4d03a2020-01-15 10:43:01 -08001764int generic_map_lookup_batch(struct bpf_map *map,
1765 const union bpf_attr *attr,
1766 union bpf_attr __user *uattr);
Brian Vazquezaa2e93b2020-01-15 10:43:02 -08001767int generic_map_update_batch(struct bpf_map *map,
1768 const union bpf_attr *attr,
1769 union bpf_attr __user *uattr);
1770int generic_map_delete_batch(struct bpf_map *map,
1771 const union bpf_attr *attr,
1772 union bpf_attr __user *uattr);
Yonghong Song6086d292020-05-09 10:59:09 -07001773struct bpf_map *bpf_map_get_curr_or_next(u32 *id);
Alexei Starovoitova228a642020-07-01 18:10:18 -07001774struct bpf_prog *bpf_prog_get_curr_or_next(u32 *id);
Daniel Borkmann61e021f32015-03-02 15:21:55 +01001775
Roman Gushchin48edc1f2020-12-01 13:58:32 -08001776#ifdef CONFIG_MEMCG_KMEM
1777void *bpf_map_kmalloc_node(const struct bpf_map *map, size_t size, gfp_t flags,
1778 int node);
1779void *bpf_map_kzalloc(const struct bpf_map *map, size_t size, gfp_t flags);
1780void __percpu *bpf_map_alloc_percpu(const struct bpf_map *map, size_t size,
1781 size_t align, gfp_t flags);
1782#else
1783static inline void *
1784bpf_map_kmalloc_node(const struct bpf_map *map, size_t size, gfp_t flags,
1785 int node)
1786{
1787 return kmalloc_node(size, flags, node);
1788}
1789
1790static inline void *
1791bpf_map_kzalloc(const struct bpf_map *map, size_t size, gfp_t flags)
1792{
1793 return kzalloc(size, flags);
1794}
1795
1796static inline void __percpu *
1797bpf_map_alloc_percpu(const struct bpf_map *map, size_t size, size_t align,
1798 gfp_t flags)
1799{
1800 return __alloc_percpu_gfp(size, align, flags);
1801}
1802#endif
1803
Anton Protopopova6fb03a2023-07-06 13:39:28 +00001804static inline int
1805bpf_map_init_elem_count(struct bpf_map *map)
1806{
1807 size_t size = sizeof(*map->elem_count), align = size;
1808 gfp_t flags = GFP_USER | __GFP_NOWARN;
1809
1810 map->elem_count = bpf_map_alloc_percpu(map, size, align, flags);
1811 if (!map->elem_count)
1812 return -ENOMEM;
1813
1814 return 0;
1815}
1816
1817static inline void
1818bpf_map_free_elem_count(struct bpf_map *map)
1819{
1820 free_percpu(map->elem_count);
1821}
1822
1823static inline void bpf_map_inc_elem_count(struct bpf_map *map)
1824{
1825 this_cpu_inc(*map->elem_count);
1826}
1827
1828static inline void bpf_map_dec_elem_count(struct bpf_map *map)
1829{
1830 this_cpu_dec(*map->elem_count);
1831}
1832
Alexei Starovoitov1be7f752015-10-07 22:23:21 -07001833extern int sysctl_unprivileged_bpf_disabled;
1834
Alexei Starovoitov2c78ee82020-05-13 16:03:54 -07001835static inline bool bpf_allow_ptr_leaks(void)
1836{
1837 return perfmon_capable();
1838}
1839
Andrei Matei01f810a2021-02-06 20:10:24 -05001840static inline bool bpf_allow_uninit_stack(void)
1841{
1842 return perfmon_capable();
1843}
1844
Andrey Ignatov41c48f32020-06-19 14:11:43 -07001845static inline bool bpf_allow_ptr_to_map_access(void)
1846{
1847 return perfmon_capable();
1848}
1849
Alexei Starovoitov2c78ee82020-05-13 16:03:54 -07001850static inline bool bpf_bypass_spec_v1(void)
1851{
1852 return perfmon_capable();
1853}
1854
1855static inline bool bpf_bypass_spec_v4(void)
1856{
1857 return perfmon_capable();
1858}
1859
Chenbo Feng6e71b042017-10-18 13:00:22 -07001860int bpf_map_new_fd(struct bpf_map *map, int flags);
Daniel Borkmannb2197752015-10-29 14:58:09 +01001861int bpf_prog_new_fd(struct bpf_prog *prog);
1862
Andrii Nakryikof2e10bf2020-04-28 17:16:08 -07001863void bpf_link_init(struct bpf_link *link, enum bpf_link_type type,
Andrii Nakryikoa3b80e12020-04-28 17:16:06 -07001864 const struct bpf_link_ops *ops, struct bpf_prog *prog);
1865int bpf_link_prime(struct bpf_link *link, struct bpf_link_primer *primer);
1866int bpf_link_settle(struct bpf_link_primer *primer);
1867void bpf_link_cleanup(struct bpf_link_primer *primer);
Andrii Nakryiko70ed5062020-03-02 20:31:57 -08001868void bpf_link_inc(struct bpf_link *link);
1869void bpf_link_put(struct bpf_link *link);
1870int bpf_link_new_fd(struct bpf_link *link);
Andrii Nakryikobabf3162020-03-09 16:10:51 -07001871struct file *bpf_link_new_file(struct bpf_link *link, int *reserved_fd);
Andrii Nakryiko70ed5062020-03-02 20:31:57 -08001872struct bpf_link *bpf_link_get_from_fd(u32 ufd);
Dmitrii Dolgov9f883612022-05-10 17:52:30 +02001873struct bpf_link *bpf_link_get_curr_or_next(u32 *id);
Andrii Nakryiko70ed5062020-03-02 20:31:57 -08001874
Daniel Borkmannb2197752015-10-29 14:58:09 +01001875int bpf_obj_pin_user(u32 ufd, const char __user *pathname);
Chenbo Feng6e71b042017-10-18 13:00:22 -07001876int bpf_obj_get_user(const char __user *pathname, int flags);
Daniel Borkmannb2197752015-10-29 14:58:09 +01001877
Yonghong Song21aef702020-05-13 11:02:16 -07001878#define BPF_ITER_FUNC_PREFIX "bpf_iter_"
Yonghong Songe5158d92020-05-09 10:59:07 -07001879#define DEFINE_BPF_ITER_FUNC(target, args...) \
Yonghong Song21aef702020-05-13 11:02:16 -07001880 extern int bpf_iter_ ## target(args); \
1881 int __init bpf_iter_ ## target(args) { return 0; }
Yonghong Song15d83c42020-05-09 10:59:00 -07001882
Kui-Feng Leef0d74c42022-09-26 11:49:53 -07001883/*
1884 * The task type of iterators.
1885 *
1886 * For BPF task iterators, they can be parameterized with various
1887 * parameters to visit only some of tasks.
1888 *
1889 * BPF_TASK_ITER_ALL (default)
1890 * Iterate over resources of every task.
1891 *
1892 * BPF_TASK_ITER_TID
1893 * Iterate over resources of a task/tid.
1894 *
1895 * BPF_TASK_ITER_TGID
1896 * Iterate over resources of every task of a process / task group.
1897 */
1898enum bpf_iter_task_type {
1899 BPF_TASK_ITER_ALL = 0,
1900 BPF_TASK_ITER_TID,
1901 BPF_TASK_ITER_TGID,
1902};
1903
Yonghong Songf9c79272020-07-23 11:41:10 -07001904struct bpf_iter_aux_info {
Hao Luod4ccaf52022-08-24 16:31:13 -07001905 /* for map_elem iter */
Yonghong Songa5cbe052020-07-23 11:41:12 -07001906 struct bpf_map *map;
Hao Luod4ccaf52022-08-24 16:31:13 -07001907
1908 /* for cgroup iter */
1909 struct {
1910 struct cgroup *start; /* starting cgroup */
1911 enum bpf_cgroup_iter_order order;
1912 } cgroup;
Kui-Feng Leef0d74c42022-09-26 11:49:53 -07001913 struct {
1914 enum bpf_iter_task_type type;
1915 u32 pid;
1916 } task;
Yonghong Songf9c79272020-07-23 11:41:10 -07001917};
1918
Yonghong Song5e7b3022020-08-04 22:50:56 -07001919typedef int (*bpf_iter_attach_target_t)(struct bpf_prog *prog,
1920 union bpf_iter_link_info *linfo,
1921 struct bpf_iter_aux_info *aux);
1922typedef void (*bpf_iter_detach_target_t)(struct bpf_iter_aux_info *aux);
Yonghong Song6b0a2492020-08-21 11:44:18 -07001923typedef void (*bpf_iter_show_fdinfo_t) (const struct bpf_iter_aux_info *aux,
1924 struct seq_file *seq);
1925typedef int (*bpf_iter_fill_link_info_t)(const struct bpf_iter_aux_info *aux,
1926 struct bpf_link_info *info);
Martin KaFai Lau3cee6fb2021-07-01 13:06:19 -07001927typedef const struct bpf_func_proto *
1928(*bpf_iter_get_func_proto_t)(enum bpf_func_id func_id,
1929 const struct bpf_prog *prog);
Yonghong Songa5cbe052020-07-23 11:41:12 -07001930
Yonghong Songcf83b2d2020-10-27 23:10:54 -07001931enum bpf_iter_feature {
1932 BPF_ITER_RESCHED = BIT(0),
1933};
1934
Yonghong Song3c32cc12020-05-13 11:02:21 -07001935#define BPF_ITER_CTX_ARG_MAX 2
Yonghong Songae243452020-05-09 10:58:59 -07001936struct bpf_iter_reg {
1937 const char *target;
Yonghong Song5e7b3022020-08-04 22:50:56 -07001938 bpf_iter_attach_target_t attach_target;
1939 bpf_iter_detach_target_t detach_target;
Yonghong Song6b0a2492020-08-21 11:44:18 -07001940 bpf_iter_show_fdinfo_t show_fdinfo;
1941 bpf_iter_fill_link_info_t fill_link_info;
Martin KaFai Lau3cee6fb2021-07-01 13:06:19 -07001942 bpf_iter_get_func_proto_t get_func_proto;
Yonghong Song3c32cc12020-05-13 11:02:21 -07001943 u32 ctx_arg_info_size;
Yonghong Songcf83b2d2020-10-27 23:10:54 -07001944 u32 feature;
Yonghong Song3c32cc12020-05-13 11:02:21 -07001945 struct bpf_ctx_arg_aux ctx_arg_info[BPF_ITER_CTX_ARG_MAX];
Yonghong Song14fc6bd62020-07-23 11:41:09 -07001946 const struct bpf_iter_seq_info *seq_info;
Yonghong Songae243452020-05-09 10:58:59 -07001947};
1948
Yonghong Songe5158d92020-05-09 10:59:07 -07001949struct bpf_iter_meta {
1950 __bpf_md_ptr(struct seq_file *, seq);
1951 u64 session_id;
1952 u64 seq_num;
1953};
1954
Yonghong Songa5cbe052020-07-23 11:41:12 -07001955struct bpf_iter__bpf_map_elem {
1956 __bpf_md_ptr(struct bpf_iter_meta *, meta);
1957 __bpf_md_ptr(struct bpf_map *, map);
1958 __bpf_md_ptr(void *, key);
1959 __bpf_md_ptr(void *, value);
1960};
1961
Yonghong Song15172a42020-05-13 11:02:19 -07001962int bpf_iter_reg_target(const struct bpf_iter_reg *reg_info);
Yonghong Songab2ee4f2020-05-13 11:02:20 -07001963void bpf_iter_unreg_target(const struct bpf_iter_reg *reg_info);
Yonghong Song15d83c42020-05-09 10:59:00 -07001964bool bpf_iter_prog_supported(struct bpf_prog *prog);
Martin KaFai Lau3cee6fb2021-07-01 13:06:19 -07001965const struct bpf_func_proto *
1966bpf_iter_get_func_proto(enum bpf_func_id func_id, const struct bpf_prog *prog);
Alexei Starovoitovaf2ac3e2021-05-13 17:36:05 -07001967int bpf_iter_link_attach(const union bpf_attr *attr, bpfptr_t uattr, struct bpf_prog *prog);
Yonghong Songac51d992020-05-09 10:59:05 -07001968int bpf_iter_new_fd(struct bpf_link *link);
Yonghong Song367ec3e2020-05-09 10:59:06 -07001969bool bpf_link_is_iter(struct bpf_link *link);
Yonghong Songe5158d92020-05-09 10:59:07 -07001970struct bpf_prog *bpf_iter_get_info(struct bpf_iter_meta *meta, bool in_stop);
1971int bpf_iter_run_prog(struct bpf_prog *prog, void *ctx);
Yonghong Songb76f2222020-08-21 11:44:19 -07001972void bpf_iter_map_show_fdinfo(const struct bpf_iter_aux_info *aux,
1973 struct seq_file *seq);
1974int bpf_iter_map_fill_link_info(const struct bpf_iter_aux_info *aux,
1975 struct bpf_link_info *info);
Yonghong Songae243452020-05-09 10:58:59 -07001976
Yonghong Song314ee052021-02-26 12:49:27 -08001977int map_set_for_each_callback_args(struct bpf_verifier_env *env,
1978 struct bpf_func_state *caller,
1979 struct bpf_func_state *callee);
1980
Alexei Starovoitov15a07b32016-02-01 22:39:55 -08001981int bpf_percpu_hash_copy(struct bpf_map *map, void *key, void *value);
1982int bpf_percpu_array_copy(struct bpf_map *map, void *key, void *value);
1983int bpf_percpu_hash_update(struct bpf_map *map, void *key, void *value,
1984 u64 flags);
1985int bpf_percpu_array_update(struct bpf_map *map, void *key, void *value,
1986 u64 flags);
Daniel Borkmannd056a782016-06-15 22:47:13 +02001987
Alexei Starovoitov557c0c62016-03-07 21:57:17 -08001988int bpf_stackmap_copy(struct bpf_map *map, void *key, void *value);
Alexei Starovoitov15a07b32016-02-01 22:39:55 -08001989
Daniel Borkmannd056a782016-06-15 22:47:13 +02001990int bpf_fd_array_map_update_elem(struct bpf_map *map, struct file *map_file,
1991 void *key, void *value, u64 map_flags);
Martin KaFai Lau14dc6f02017-06-27 23:08:34 -07001992int bpf_fd_array_map_lookup_elem(struct bpf_map *map, void *key, u32 *value);
Martin KaFai Laubcc6b1b2017-03-22 10:00:34 -07001993int bpf_fd_htab_map_update_elem(struct bpf_map *map, struct file *map_file,
1994 void *key, void *value, u64 map_flags);
Martin KaFai Lau14dc6f02017-06-27 23:08:34 -07001995int bpf_fd_htab_map_lookup_elem(struct bpf_map *map, void *key, u32 *value);
Daniel Borkmannd056a782016-06-15 22:47:13 +02001996
Chenbo Feng6e71b042017-10-18 13:00:22 -07001997int bpf_get_file_flag(int flags);
Alexei Starovoitovaf2ac3e2021-05-13 17:36:05 -07001998int bpf_check_uarg_tail_zero(bpfptr_t uaddr, size_t expected_size,
Martin KaFai Laudcab51f2018-05-22 15:03:31 -07001999 size_t actual_size);
Chenbo Feng6e71b042017-10-18 13:00:22 -07002000
Daniel Borkmann61e021f32015-03-02 15:21:55 +01002001/* verify correctness of eBPF program */
Alexei Starovoitovaf2ac3e2021-05-13 17:36:05 -07002002int bpf_check(struct bpf_prog **fp, union bpf_attr *attr, bpfptr_t uattr);
Andrii Nakryikoa643bff2021-01-11 23:55:14 -08002003
2004#ifndef CONFIG_BPF_JIT_ALWAYS_ON
Alexei Starovoitov1ea47e02017-12-14 17:55:13 -08002005void bpf_patch_call_args(struct bpf_insn *insn, u32 stack_depth);
Andrii Nakryikoa643bff2021-01-11 23:55:14 -08002006#endif
John Fastabend46f55cf2017-07-17 21:56:48 -07002007
Alan Maguire76654e62020-09-28 12:31:03 +01002008struct btf *bpf_get_btf_vmlinux(void);
2009
John Fastabend46f55cf2017-07-17 21:56:48 -07002010/* Map specifics */
Toke Høiland-Jørgensend53ad5d2022-01-03 16:08:09 +01002011struct xdp_frame;
Toshiaki Makita6d5fc192018-06-14 11:07:42 +09002012struct sk_buff;
Björn Töpele6a47502021-03-08 12:29:06 +01002013struct bpf_dtab_netdev;
2014struct bpf_cpu_map_entry;
Jesper Dangaard Brouer67f29e02018-05-24 16:45:46 +02002015
Toke Høiland-Jørgensen1d233882020-01-16 16:14:45 +01002016void __dev_flush(void);
Toke Høiland-Jørgensend53ad5d2022-01-03 16:08:09 +01002017int dev_xdp_enqueue(struct net_device *dev, struct xdp_frame *xdpf,
Toke Høiland-Jørgensen1d233882020-01-16 16:14:45 +01002018 struct net_device *dev_rx);
Toke Høiland-Jørgensend53ad5d2022-01-03 16:08:09 +01002019int dev_map_enqueue(struct bpf_dtab_netdev *dst, struct xdp_frame *xdpf,
Jesper Dangaard Brouer38edddb2018-05-24 16:45:57 +02002020 struct net_device *dev_rx);
Toke Høiland-Jørgensend53ad5d2022-01-03 16:08:09 +01002021int dev_map_enqueue_multi(struct xdp_frame *xdpf, struct net_device *dev_rx,
Hangbin Liue624d4e2021-05-19 17:07:45 +08002022 struct bpf_map *map, bool exclude_ingress);
Toshiaki Makita6d5fc192018-06-14 11:07:42 +09002023int dev_map_generic_redirect(struct bpf_dtab_netdev *dst, struct sk_buff *skb,
2024 struct bpf_prog *xdp_prog);
Hangbin Liue624d4e2021-05-19 17:07:45 +08002025int dev_map_redirect_multi(struct net_device *dev, struct sk_buff *skb,
2026 struct bpf_prog *xdp_prog, struct bpf_map *map,
2027 bool exclude_ingress);
John Fastabend46f55cf2017-07-17 21:56:48 -07002028
Björn Töpelcdfafe92019-12-19 07:10:04 +01002029void __cpu_map_flush(void);
Toke Høiland-Jørgensend53ad5d2022-01-03 16:08:09 +01002030int cpu_map_enqueue(struct bpf_cpu_map_entry *rcpu, struct xdp_frame *xdpf,
Jesper Dangaard Brouer9c270af2017-10-16 12:19:34 +02002031 struct net_device *dev_rx);
Kumar Kartikeya Dwivedi11941f82021-07-02 16:48:23 +05302032int cpu_map_generic_redirect(struct bpf_cpu_map_entry *rcpu,
2033 struct sk_buff *skb);
Jesper Dangaard Brouer9c270af2017-10-16 12:19:34 +02002034
Martin KaFai Lau96eabe72017-08-18 11:28:00 -07002035/* Return map's numa specified by userspace */
2036static inline int bpf_map_attr_numa_node(const union bpf_attr *attr)
2037{
2038 return (attr->map_flags & BPF_F_NUMA_NODE) ?
2039 attr->numa_node : NUMA_NO_NODE;
2040}
2041
Al Viro040ee692017-12-02 20:20:38 -05002042struct bpf_prog *bpf_prog_get_type_path(const char *name, enum bpf_prog_type type);
Martin KaFai Lau5dc4c4b2018-08-08 01:01:24 -07002043int array_map_alloc_check(union bpf_attr *attr);
Al Viro040ee692017-12-02 20:20:38 -05002044
Stanislav Fomichevc6958652019-04-11 09:12:02 -07002045int bpf_prog_test_run_xdp(struct bpf_prog *prog, const union bpf_attr *kattr,
2046 union bpf_attr __user *uattr);
2047int bpf_prog_test_run_skb(struct bpf_prog *prog, const union bpf_attr *kattr,
2048 union bpf_attr __user *uattr);
KP Singhda00d2f2020-03-04 20:18:52 +01002049int bpf_prog_test_run_tracing(struct bpf_prog *prog,
2050 const union bpf_attr *kattr,
2051 union bpf_attr __user *uattr);
Stanislav Fomichevc6958652019-04-11 09:12:02 -07002052int bpf_prog_test_run_flow_dissector(struct bpf_prog *prog,
2053 const union bpf_attr *kattr,
2054 union bpf_attr __user *uattr);
Song Liu1b4d60e2020-09-25 13:54:29 -07002055int bpf_prog_test_run_raw_tp(struct bpf_prog *prog,
2056 const union bpf_attr *kattr,
2057 union bpf_attr __user *uattr);
Lorenz Bauer7c32e8f2021-03-03 10:18:13 +00002058int bpf_prog_test_run_sk_lookup(struct bpf_prog *prog,
2059 const union bpf_attr *kattr,
2060 union bpf_attr __user *uattr);
Alexei Starovoitov9e15db62019-10-15 20:25:00 -07002061bool btf_ctx_access(int off, int size, enum bpf_access_type type,
2062 const struct bpf_prog *prog,
2063 struct bpf_insn_access_aux *info);
Hou Tao35346ab2021-10-25 14:40:23 +08002064
2065static inline bool bpf_tracing_ctx_access(int off, int size,
2066 enum bpf_access_type type)
2067{
2068 if (off < 0 || off >= sizeof(__u64) * MAX_BPF_FUNC_ARGS)
2069 return false;
2070 if (type != BPF_READ)
2071 return false;
2072 if (off % size != 0)
2073 return false;
2074 return true;
2075}
2076
2077static inline bool bpf_tracing_btf_ctx_access(int off, int size,
2078 enum bpf_access_type type,
2079 const struct bpf_prog *prog,
2080 struct bpf_insn_access_aux *info)
2081{
2082 if (!bpf_tracing_ctx_access(off, size, type))
2083 return false;
2084 return btf_ctx_access(off, size, type, prog, info);
2085}
2086
Andrii Nakryiko22dc4a02020-12-03 12:46:29 -08002087int btf_struct_access(struct bpf_verifier_log *log, const struct btf *btf,
Alexei Starovoitov9e15db62019-10-15 20:25:00 -07002088 const struct btf_type *t, int off, int size,
2089 enum bpf_access_type atype,
Yonghong Songc6f1bfe2022-01-27 07:46:06 -08002090 u32 *next_btf_id, enum bpf_type_flag *flag);
Jiri Olsafaaf4a72020-08-25 21:21:18 +02002091bool btf_struct_ids_match(struct bpf_verifier_log *log,
Andrii Nakryiko22dc4a02020-12-03 12:46:29 -08002092 const struct btf *btf, u32 id, int off,
Kumar Kartikeya Dwivedi2ab3b382022-04-25 03:18:57 +05302093 const struct btf *need_btf, u32 need_type_id,
2094 bool strict);
Alexei Starovoitov9e15db62019-10-15 20:25:00 -07002095
Alexei Starovoitovfec56f52019-11-14 10:57:04 -08002096int btf_distill_func_proto(struct bpf_verifier_log *log,
2097 struct btf *btf,
2098 const struct btf_type *func_proto,
2099 const char *func_name,
2100 struct btf_func_model *m);
2101
Benjamin Tissoireseb1f7f72022-09-06 17:13:02 +02002102struct bpf_kfunc_arg_meta {
2103 u64 r0_size;
2104 bool r0_rdonly;
2105 int ref_obj_id;
2106 u32 flags;
2107};
2108
Alexei Starovoitov51c39bb2020-01-09 22:41:20 -08002109struct bpf_reg_state;
Martin KaFai Lau34747c42021-03-24 18:51:36 -07002110int btf_check_subprog_arg_match(struct bpf_verifier_env *env, int subprog,
2111 struct bpf_reg_state *regs);
Benjamin Tissoires95f2f262022-09-06 17:12:58 +02002112int btf_check_subprog_call(struct bpf_verifier_env *env, int subprog,
2113 struct bpf_reg_state *regs);
Martin KaFai Laue6ac2452021-03-24 18:51:42 -07002114int btf_check_kfunc_arg_match(struct bpf_verifier_env *env,
2115 const struct btf *btf, u32 func_id,
Kumar Kartikeya Dwivedia4703e32022-07-21 15:42:35 +02002116 struct bpf_reg_state *regs,
Benjamin Tissoireseb1f7f72022-09-06 17:13:02 +02002117 struct bpf_kfunc_arg_meta *meta);
Alexei Starovoitov51c39bb2020-01-09 22:41:20 -08002118int btf_prepare_func_args(struct bpf_verifier_env *env, int subprog,
2119 struct bpf_reg_state *reg);
Toke Høiland-Jørgensenefc68152020-09-25 23:25:01 +02002120int btf_check_type_match(struct bpf_verifier_log *log, const struct bpf_prog *prog,
Alexei Starovoitovbe8704f2020-01-20 16:53:46 -08002121 struct btf *btf, const struct btf_type *t);
Alexei Starovoitov8c1b6e62019-11-14 10:57:16 -08002122
Björn Töpel7e6897f2019-12-13 18:51:09 +01002123struct bpf_prog *bpf_prog_by_id(u32 id);
Alexei Starovoitov005142b2020-08-18 21:27:56 -07002124struct bpf_link *bpf_link_by_id(u32 id);
Björn Töpel7e6897f2019-12-13 18:51:09 +01002125
Stanislav Fomichev68908962020-04-24 16:59:41 -07002126const struct bpf_func_proto *bpf_base_func_proto(enum bpf_func_id func_id);
Song Liua10787e2021-02-25 15:43:14 -08002127void bpf_task_storage_free(struct task_struct *task);
Martin KaFai Laue6ac2452021-03-24 18:51:42 -07002128bool bpf_prog_has_kfunc_call(const struct bpf_prog *prog);
2129const struct btf_func_model *
2130bpf_jit_find_kfunc_model(const struct bpf_prog *prog,
2131 const struct bpf_insn *insn);
Alexei Starovoitovfbd94c72021-12-01 10:10:28 -08002132struct bpf_core_ctx {
2133 struct bpf_verifier_log *log;
2134 const struct btf *btf;
2135};
2136
2137int bpf_core_apply(struct bpf_core_ctx *ctx, const struct bpf_core_relo *relo,
2138 int relo_idx, void *insn);
2139
Josh Poimboeuf44a39182022-02-18 11:49:08 -08002140static inline bool unprivileged_ebpf_enabled(void)
2141{
2142 return !sysctl_unprivileged_bpf_disabled;
2143}
2144
Martin KaFai Lau24426652022-08-16 23:17:17 -07002145/* Not all bpf prog type has the bpf_ctx.
2146 * For the bpf prog type that has initialized the bpf_ctx,
2147 * this function can be used to decide if a kernel function
2148 * is called by a bpf program.
2149 */
2150static inline bool has_current_bpf_ctx(void)
2151{
2152 return !!current->bpf_ctx;
2153}
Jiri Olsa05b24ff2022-09-16 09:19:14 +02002154
2155void notrace bpf_prog_inc_misses_counter(struct bpf_prog *prog);
Jesper Dangaard Brouer9c270af2017-10-16 12:19:34 +02002156#else /* !CONFIG_BPF_SYSCALL */
Daniel Borkmann0fc174d2015-03-01 12:31:44 +01002157static inline struct bpf_prog *bpf_prog_get(u32 ufd)
2158{
2159 return ERR_PTR(-EOPNOTSUPP);
2160}
2161
Jakub Kicinski248f3462017-11-03 13:56:20 -07002162static inline struct bpf_prog *bpf_prog_get_type_dev(u32 ufd,
2163 enum bpf_prog_type type,
Jakub Kicinski288b3de52017-11-20 15:21:54 -08002164 bool attach_drv)
Jakub Kicinski248f3462017-11-03 13:56:20 -07002165{
2166 return ERR_PTR(-EOPNOTSUPP);
2167}
2168
Andrii Nakryiko85192dbf2019-11-17 09:28:03 -08002169static inline void bpf_prog_add(struct bpf_prog *prog, int i)
Brenden Blancocc2e0b32016-07-20 07:55:52 -07002170{
Brenden Blancocc2e0b32016-07-20 07:55:52 -07002171}
Daniel Borkmann113214b2016-06-30 17:24:44 +02002172
Daniel Borkmannc5405942016-11-09 22:02:34 +01002173static inline void bpf_prog_sub(struct bpf_prog *prog, int i)
2174{
2175}
2176
Daniel Borkmann0fc174d2015-03-01 12:31:44 +01002177static inline void bpf_prog_put(struct bpf_prog *prog)
2178{
2179}
Daniel Borkmann6d67942dd2016-11-19 01:45:03 +01002180
Andrii Nakryiko85192dbf2019-11-17 09:28:03 -08002181static inline void bpf_prog_inc(struct bpf_prog *prog)
Alexei Starovoitovaa6a5f32016-09-01 18:37:24 -07002182{
Alexei Starovoitovaa6a5f32016-09-01 18:37:24 -07002183}
Daniel Borkmann5ccb0712016-12-18 01:52:58 +01002184
John Fastabenda6f6df62017-08-15 22:32:22 -07002185static inline struct bpf_prog *__must_check
2186bpf_prog_inc_not_zero(struct bpf_prog *prog)
2187{
2188 return ERR_PTR(-EOPNOTSUPP);
2189}
2190
Andrii Nakryiko6cc7d1e2020-07-21 23:45:54 -07002191static inline void bpf_link_init(struct bpf_link *link, enum bpf_link_type type,
2192 const struct bpf_link_ops *ops,
2193 struct bpf_prog *prog)
2194{
2195}
2196
2197static inline int bpf_link_prime(struct bpf_link *link,
2198 struct bpf_link_primer *primer)
2199{
2200 return -EOPNOTSUPP;
2201}
2202
2203static inline int bpf_link_settle(struct bpf_link_primer *primer)
2204{
2205 return -EOPNOTSUPP;
2206}
2207
2208static inline void bpf_link_cleanup(struct bpf_link_primer *primer)
2209{
2210}
2211
2212static inline void bpf_link_inc(struct bpf_link *link)
2213{
2214}
2215
2216static inline void bpf_link_put(struct bpf_link *link)
2217{
2218}
2219
Chenbo Feng6e71b042017-10-18 13:00:22 -07002220static inline int bpf_obj_get_user(const char __user *pathname, int flags)
Shmulik Ladkani98589a02017-10-09 15:27:15 +03002221{
2222 return -EOPNOTSUPP;
2223}
2224
Toke Høiland-Jørgensen1d233882020-01-16 16:14:45 +01002225static inline void __dev_flush(void)
John Fastabend46f55cf2017-07-17 21:56:48 -07002226{
2227}
Jesper Dangaard Brouer9c270af2017-10-16 12:19:34 +02002228
Toke Høiland-Jørgensend53ad5d2022-01-03 16:08:09 +01002229struct xdp_frame;
Jesper Dangaard Brouer67f29e02018-05-24 16:45:46 +02002230struct bpf_dtab_netdev;
Björn Töpele6a47502021-03-08 12:29:06 +01002231struct bpf_cpu_map_entry;
Jesper Dangaard Brouer67f29e02018-05-24 16:45:46 +02002232
2233static inline
Toke Høiland-Jørgensend53ad5d2022-01-03 16:08:09 +01002234int dev_xdp_enqueue(struct net_device *dev, struct xdp_frame *xdpf,
Toke Høiland-Jørgensen1d233882020-01-16 16:14:45 +01002235 struct net_device *dev_rx)
2236{
2237 return 0;
2238}
2239
2240static inline
Toke Høiland-Jørgensend53ad5d2022-01-03 16:08:09 +01002241int dev_map_enqueue(struct bpf_dtab_netdev *dst, struct xdp_frame *xdpf,
Jesper Dangaard Brouer38edddb2018-05-24 16:45:57 +02002242 struct net_device *dev_rx)
Jesper Dangaard Brouer67f29e02018-05-24 16:45:46 +02002243{
2244 return 0;
2245}
2246
Hangbin Liue624d4e2021-05-19 17:07:45 +08002247static inline
Toke Høiland-Jørgensend53ad5d2022-01-03 16:08:09 +01002248int dev_map_enqueue_multi(struct xdp_frame *xdpf, struct net_device *dev_rx,
Hangbin Liue624d4e2021-05-19 17:07:45 +08002249 struct bpf_map *map, bool exclude_ingress)
2250{
2251 return 0;
2252}
2253
Toshiaki Makita6d5fc192018-06-14 11:07:42 +09002254struct sk_buff;
2255
2256static inline int dev_map_generic_redirect(struct bpf_dtab_netdev *dst,
2257 struct sk_buff *skb,
2258 struct bpf_prog *xdp_prog)
2259{
2260 return 0;
2261}
2262
Hangbin Liue624d4e2021-05-19 17:07:45 +08002263static inline
2264int dev_map_redirect_multi(struct net_device *dev, struct sk_buff *skb,
2265 struct bpf_prog *xdp_prog, struct bpf_map *map,
2266 bool exclude_ingress)
2267{
2268 return 0;
2269}
2270
Björn Töpelcdfafe92019-12-19 07:10:04 +01002271static inline void __cpu_map_flush(void)
Jesper Dangaard Brouer9c270af2017-10-16 12:19:34 +02002272{
2273}
2274
Jesper Dangaard Brouer9c270af2017-10-16 12:19:34 +02002275static inline int cpu_map_enqueue(struct bpf_cpu_map_entry *rcpu,
Toke Høiland-Jørgensend53ad5d2022-01-03 16:08:09 +01002276 struct xdp_frame *xdpf,
Jesper Dangaard Brouer9c270af2017-10-16 12:19:34 +02002277 struct net_device *dev_rx)
2278{
2279 return 0;
2280}
Al Viro040ee692017-12-02 20:20:38 -05002281
Kumar Kartikeya Dwivedi11941f82021-07-02 16:48:23 +05302282static inline int cpu_map_generic_redirect(struct bpf_cpu_map_entry *rcpu,
2283 struct sk_buff *skb)
2284{
2285 return -EOPNOTSUPP;
2286}
2287
Al Viro040ee692017-12-02 20:20:38 -05002288static inline struct bpf_prog *bpf_prog_get_type_path(const char *name,
2289 enum bpf_prog_type type)
2290{
2291 return ERR_PTR(-EOPNOTSUPP);
2292}
Stanislav Fomichevc6958652019-04-11 09:12:02 -07002293
2294static inline int bpf_prog_test_run_xdp(struct bpf_prog *prog,
2295 const union bpf_attr *kattr,
2296 union bpf_attr __user *uattr)
2297{
2298 return -ENOTSUPP;
2299}
2300
2301static inline int bpf_prog_test_run_skb(struct bpf_prog *prog,
2302 const union bpf_attr *kattr,
2303 union bpf_attr __user *uattr)
2304{
2305 return -ENOTSUPP;
2306}
2307
KP Singhda00d2f2020-03-04 20:18:52 +01002308static inline int bpf_prog_test_run_tracing(struct bpf_prog *prog,
2309 const union bpf_attr *kattr,
2310 union bpf_attr __user *uattr)
2311{
2312 return -ENOTSUPP;
2313}
2314
Stanislav Fomichevc6958652019-04-11 09:12:02 -07002315static inline int bpf_prog_test_run_flow_dissector(struct bpf_prog *prog,
2316 const union bpf_attr *kattr,
2317 union bpf_attr __user *uattr)
2318{
2319 return -ENOTSUPP;
2320}
Daniel Borkmann6332be02019-11-22 21:07:55 +01002321
Lorenz Bauer7c32e8f2021-03-03 10:18:13 +00002322static inline int bpf_prog_test_run_sk_lookup(struct bpf_prog *prog,
2323 const union bpf_attr *kattr,
2324 union bpf_attr __user *uattr)
2325{
2326 return -ENOTSUPP;
2327}
2328
Daniel Borkmann6332be02019-11-22 21:07:55 +01002329static inline void bpf_map_put(struct bpf_map *map)
2330{
2331}
Björn Töpel7e6897f2019-12-13 18:51:09 +01002332
2333static inline struct bpf_prog *bpf_prog_by_id(u32 id)
2334{
2335 return ERR_PTR(-ENOTSUPP);
2336}
Stanislav Fomichev68908962020-04-24 16:59:41 -07002337
Daniel Xud4f7bdb2022-09-07 10:40:37 -06002338static inline int btf_struct_access(struct bpf_verifier_log *log,
2339 const struct btf *btf,
2340 const struct btf_type *t, int off, int size,
2341 enum bpf_access_type atype,
2342 u32 *next_btf_id, enum bpf_type_flag *flag)
2343{
2344 return -EACCES;
2345}
2346
Stanislav Fomichev68908962020-04-24 16:59:41 -07002347static inline const struct bpf_func_proto *
2348bpf_base_func_proto(enum bpf_func_id func_id)
2349{
2350 return NULL;
2351}
Song Liua10787e2021-02-25 15:43:14 -08002352
2353static inline void bpf_task_storage_free(struct task_struct *task)
2354{
2355}
Martin KaFai Laue6ac2452021-03-24 18:51:42 -07002356
2357static inline bool bpf_prog_has_kfunc_call(const struct bpf_prog *prog)
2358{
2359 return false;
2360}
2361
2362static inline const struct btf_func_model *
2363bpf_jit_find_kfunc_model(const struct bpf_prog *prog,
2364 const struct bpf_insn *insn)
2365{
2366 return NULL;
2367}
Josh Poimboeuf44a39182022-02-18 11:49:08 -08002368
2369static inline bool unprivileged_ebpf_enabled(void)
2370{
2371 return false;
2372}
2373
Martin KaFai Lau24426652022-08-16 23:17:17 -07002374static inline bool has_current_bpf_ctx(void)
2375{
2376 return false;
2377}
Jiri Olsa05b24ff2022-09-16 09:19:14 +02002378
2379static inline void bpf_prog_inc_misses_counter(struct bpf_prog *prog)
2380{
2381}
Daniel Borkmann61e021f32015-03-02 15:21:55 +01002382#endif /* CONFIG_BPF_SYSCALL */
Alexei Starovoitov09756af2014-09-26 00:17:00 -07002383
Andrii Nakryiko541c3ba2021-01-11 23:55:18 -08002384void __bpf_free_used_btfs(struct bpf_prog_aux *aux,
2385 struct btf_mod_pair *used_btfs, u32 len);
2386
Jakub Kicinski479321e2017-11-20 15:21:56 -08002387static inline struct bpf_prog *bpf_prog_get_type(u32 ufd,
2388 enum bpf_prog_type type)
2389{
2390 return bpf_prog_get_type_dev(ufd, type, false);
2391}
2392
Andrii Nakryiko936f8942021-01-11 23:55:16 -08002393void __bpf_free_used_maps(struct bpf_prog_aux *aux,
2394 struct bpf_map **used_maps, u32 len);
2395
Al Viro040ee692017-12-02 20:20:38 -05002396bool bpf_prog_get_ok(struct bpf_prog *, enum bpf_prog_type *, bool);
2397
Jakub Kicinskiab3f0062017-11-03 13:56:17 -07002398int bpf_prog_offload_compile(struct bpf_prog *prog);
2399void bpf_prog_offload_destroy(struct bpf_prog *prog);
Jakub Kicinski675fc272017-12-27 18:39:09 -08002400int bpf_prog_offload_info_fill(struct bpf_prog_info *info,
2401 struct bpf_prog *prog);
Jakub Kicinskiab3f0062017-11-03 13:56:17 -07002402
Jakub Kicinski52775b32018-01-17 19:13:28 -08002403int bpf_map_offload_info_fill(struct bpf_map_info *info, struct bpf_map *map);
2404
Jakub Kicinskia3884572018-01-11 20:29:09 -08002405int bpf_map_offload_lookup_elem(struct bpf_map *map, void *key, void *value);
2406int bpf_map_offload_update_elem(struct bpf_map *map,
2407 void *key, void *value, u64 flags);
2408int bpf_map_offload_delete_elem(struct bpf_map *map, void *key);
2409int bpf_map_offload_get_next_key(struct bpf_map *map,
2410 void *key, void *next_key);
2411
Jakub Kicinski09728262018-07-17 10:53:23 -07002412bool bpf_offload_prog_map_match(struct bpf_prog *prog, struct bpf_map *map);
Jakub Kicinskia3884572018-01-11 20:29:09 -08002413
Quentin Monnet1385d752018-11-09 13:03:25 +00002414struct bpf_offload_dev *
Jakub Kicinskidd27c2e2019-02-12 00:20:39 -08002415bpf_offload_dev_create(const struct bpf_prog_offload_ops *ops, void *priv);
Jakub Kicinski602144c2018-07-17 10:53:25 -07002416void bpf_offload_dev_destroy(struct bpf_offload_dev *offdev);
Jakub Kicinskidd27c2e2019-02-12 00:20:39 -08002417void *bpf_offload_dev_priv(struct bpf_offload_dev *offdev);
Jakub Kicinski602144c2018-07-17 10:53:25 -07002418int bpf_offload_dev_netdev_register(struct bpf_offload_dev *offdev,
2419 struct net_device *netdev);
2420void bpf_offload_dev_netdev_unregister(struct bpf_offload_dev *offdev,
2421 struct net_device *netdev);
Jakub Kicinskifd4f2272018-07-17 10:53:26 -07002422bool bpf_offload_dev_match(struct bpf_prog *prog, struct net_device *netdev);
Jakub Kicinski9fd7c552018-07-17 10:53:24 -07002423
Josh Poimboeuf2147c432022-04-25 16:40:02 -07002424void unpriv_ebpf_notify(int new_state);
2425
Jakub Kicinskiab3f0062017-11-03 13:56:17 -07002426#if defined(CONFIG_NET) && defined(CONFIG_BPF_SYSCALL)
2427int bpf_prog_offload_init(struct bpf_prog *prog, union bpf_attr *attr);
2428
Jakub Kicinski0d830032018-05-08 19:37:06 -07002429static inline bool bpf_prog_is_dev_bound(const struct bpf_prog_aux *aux)
Jakub Kicinskiab3f0062017-11-03 13:56:17 -07002430{
Jakub Kicinski9a18eed2017-12-27 18:39:04 -08002431 return aux->offload_requested;
Jakub Kicinskiab3f0062017-11-03 13:56:17 -07002432}
Jakub Kicinskia3884572018-01-11 20:29:09 -08002433
2434static inline bool bpf_map_is_dev_bound(struct bpf_map *map)
2435{
2436 return unlikely(map->ops == &bpf_map_offload_ops);
2437}
2438
2439struct bpf_map *bpf_map_offload_map_alloc(union bpf_attr *attr);
2440void bpf_map_offload_map_free(struct bpf_map *map);
Alexei Starovoitov79a7f8b2021-05-13 17:36:03 -07002441int bpf_prog_test_run_syscall(struct bpf_prog *prog,
2442 const union bpf_attr *kattr,
2443 union bpf_attr __user *uattr);
Cong Wang17edea22021-07-04 12:02:42 -07002444
2445int sock_map_get_from_fd(const union bpf_attr *attr, struct bpf_prog *prog);
2446int sock_map_prog_detach(const union bpf_attr *attr, enum bpf_prog_type ptype);
2447int sock_map_update_elem_sys(struct bpf_map *map, void *key, void *value, u64 flags);
Di Zhu748cd572022-01-19 09:40:04 +08002448int sock_map_bpf_prog_query(const union bpf_attr *attr,
2449 union bpf_attr __user *uattr);
2450
Cong Wang17edea22021-07-04 12:02:42 -07002451void sock_map_unhash(struct sock *sk);
Wang Yufend8616ee2022-05-24 15:53:11 +08002452void sock_map_destroy(struct sock *sk);
Cong Wang17edea22021-07-04 12:02:42 -07002453void sock_map_close(struct sock *sk, long timeout);
Jakub Kicinskiab3f0062017-11-03 13:56:17 -07002454#else
2455static inline int bpf_prog_offload_init(struct bpf_prog *prog,
2456 union bpf_attr *attr)
2457{
2458 return -EOPNOTSUPP;
2459}
2460
2461static inline bool bpf_prog_is_dev_bound(struct bpf_prog_aux *aux)
2462{
2463 return false;
2464}
Jakub Kicinskia3884572018-01-11 20:29:09 -08002465
2466static inline bool bpf_map_is_dev_bound(struct bpf_map *map)
2467{
2468 return false;
2469}
2470
2471static inline struct bpf_map *bpf_map_offload_map_alloc(union bpf_attr *attr)
2472{
2473 return ERR_PTR(-EOPNOTSUPP);
2474}
2475
2476static inline void bpf_map_offload_map_free(struct bpf_map *map)
2477{
2478}
Alexei Starovoitov79a7f8b2021-05-13 17:36:03 -07002479
2480static inline int bpf_prog_test_run_syscall(struct bpf_prog *prog,
2481 const union bpf_attr *kattr,
2482 union bpf_attr __user *uattr)
2483{
2484 return -ENOTSUPP;
2485}
Sean Youngfdb5c452018-06-19 00:04:24 +01002486
Cong Wang88759602021-02-23 10:49:26 -08002487#ifdef CONFIG_BPF_SYSCALL
Daniel Borkmann604326b2018-10-13 02:45:58 +02002488static inline int sock_map_get_from_fd(const union bpf_attr *attr,
2489 struct bpf_prog *prog)
Sean Youngfdb5c452018-06-19 00:04:24 +01002490{
2491 return -EINVAL;
2492}
Lorenz Bauerbb0de312020-06-29 10:56:28 +01002493
2494static inline int sock_map_prog_detach(const union bpf_attr *attr,
2495 enum bpf_prog_type ptype)
2496{
2497 return -EOPNOTSUPP;
2498}
Lorenz Bauer13b79d32020-08-21 11:29:45 +01002499
2500static inline int sock_map_update_elem_sys(struct bpf_map *map, void *key, void *value,
2501 u64 flags)
2502{
2503 return -EOPNOTSUPP;
2504}
Di Zhu748cd572022-01-19 09:40:04 +08002505
2506static inline int sock_map_bpf_prog_query(const union bpf_attr *attr,
2507 union bpf_attr __user *uattr)
2508{
2509 return -EINVAL;
2510}
Cong Wang17edea22021-07-04 12:02:42 -07002511#endif /* CONFIG_BPF_SYSCALL */
2512#endif /* CONFIG_NET && CONFIG_BPF_SYSCALL */
John Fastabend6bdc9c42017-08-16 15:02:32 -07002513
Cong Wang17edea22021-07-04 12:02:42 -07002514#if defined(CONFIG_INET) && defined(CONFIG_BPF_SYSCALL)
2515void bpf_sk_reuseport_detach(struct sock *sk);
2516int bpf_fd_reuseport_array_lookup_elem(struct bpf_map *map, void *key,
2517 void *value);
2518int bpf_fd_reuseport_array_update_elem(struct bpf_map *map, void *key,
2519 void *value, u64 map_flags);
2520#else
2521static inline void bpf_sk_reuseport_detach(struct sock *sk)
2522{
2523}
2524
2525#ifdef CONFIG_BPF_SYSCALL
Martin KaFai Lau5dc4c4b2018-08-08 01:01:24 -07002526static inline int bpf_fd_reuseport_array_lookup_elem(struct bpf_map *map,
2527 void *key, void *value)
2528{
2529 return -EOPNOTSUPP;
2530}
2531
2532static inline int bpf_fd_reuseport_array_update_elem(struct bpf_map *map,
2533 void *key, void *value,
2534 u64 map_flags)
2535{
2536 return -EOPNOTSUPP;
2537}
2538#endif /* CONFIG_BPF_SYSCALL */
2539#endif /* defined(CONFIG_INET) && defined(CONFIG_BPF_SYSCALL) */
2540
Alexei Starovoitovd0003ec2014-11-13 17:36:49 -08002541/* verifier prototypes for helper functions called from eBPF programs */
Daniel Borkmanna2c83ff2015-03-01 12:31:42 +01002542extern const struct bpf_func_proto bpf_map_lookup_elem_proto;
2543extern const struct bpf_func_proto bpf_map_update_elem_proto;
2544extern const struct bpf_func_proto bpf_map_delete_elem_proto;
Mauricio Vasquez Bf1a2e442018-10-18 15:16:25 +02002545extern const struct bpf_func_proto bpf_map_push_elem_proto;
2546extern const struct bpf_func_proto bpf_map_pop_elem_proto;
2547extern const struct bpf_func_proto bpf_map_peek_elem_proto;
Feng Zhou07343112022-05-11 17:38:53 +08002548extern const struct bpf_func_proto bpf_map_lookup_percpu_elem_proto;
Alexei Starovoitovd0003ec2014-11-13 17:36:49 -08002549
Daniel Borkmann03e69b52015-03-14 02:27:16 +01002550extern const struct bpf_func_proto bpf_get_prandom_u32_proto;
Daniel Borkmannc04167c2015-03-14 02:27:17 +01002551extern const struct bpf_func_proto bpf_get_smp_processor_id_proto;
Daniel Borkmann2d0e30c2016-10-21 12:46:33 +02002552extern const struct bpf_func_proto bpf_get_numa_node_id_proto;
Alexei Starovoitov04fd61ab2015-05-19 16:59:03 -07002553extern const struct bpf_func_proto bpf_tail_call_proto;
Daniel Borkmann17ca8cb2015-05-29 23:23:06 +02002554extern const struct bpf_func_proto bpf_ktime_get_ns_proto;
Maciej Żenczykowski71d19212020-04-26 09:15:25 -07002555extern const struct bpf_func_proto bpf_ktime_get_boot_ns_proto;
Jesper Dangaard Brouerc8996c92022-08-09 08:08:02 +02002556extern const struct bpf_func_proto bpf_ktime_get_tai_ns_proto;
Alexei Starovoitovffeedaf2015-06-12 19:39:12 -07002557extern const struct bpf_func_proto bpf_get_current_pid_tgid_proto;
2558extern const struct bpf_func_proto bpf_get_current_uid_gid_proto;
2559extern const struct bpf_func_proto bpf_get_current_comm_proto;
Alexei Starovoitovd5a3b1f2016-02-17 19:58:58 -08002560extern const struct bpf_func_proto bpf_get_stackid_proto;
Yonghong Songc195651e2018-04-28 22:28:08 -07002561extern const struct bpf_func_proto bpf_get_stack_proto;
Song Liufa28dcb2020-06-29 23:28:44 -07002562extern const struct bpf_func_proto bpf_get_task_stack_proto;
Song Liu7b04d6d2020-07-23 11:06:44 -07002563extern const struct bpf_func_proto bpf_get_stackid_proto_pe;
2564extern const struct bpf_func_proto bpf_get_stack_proto_pe;
John Fastabend174a79f2017-08-15 22:32:47 -07002565extern const struct bpf_func_proto bpf_sock_map_update_proto;
John Fastabend81110382018-05-14 10:00:17 -07002566extern const struct bpf_func_proto bpf_sock_hash_update_proto;
Yonghong Songbf6fa2c82018-06-03 15:59:41 -07002567extern const struct bpf_func_proto bpf_get_current_cgroup_id_proto;
Daniel Borkmann0f09abd2020-03-27 16:58:54 +01002568extern const struct bpf_func_proto bpf_get_current_ancestor_cgroup_id_proto;
Stanislav Fomichevbed89182022-08-23 15:25:52 -07002569extern const struct bpf_func_proto bpf_get_cgroup_classid_curr_proto;
Daniel Borkmann604326b2018-10-13 02:45:58 +02002570extern const struct bpf_func_proto bpf_msg_redirect_hash_proto;
2571extern const struct bpf_func_proto bpf_msg_redirect_map_proto;
2572extern const struct bpf_func_proto bpf_sk_redirect_hash_proto;
2573extern const struct bpf_func_proto bpf_sk_redirect_map_proto;
Alexei Starovoitovd83525c2019-01-31 15:40:04 -08002574extern const struct bpf_func_proto bpf_spin_lock_proto;
2575extern const struct bpf_func_proto bpf_spin_unlock_proto;
Roman Gushchincd339432018-08-02 14:27:24 -07002576extern const struct bpf_func_proto bpf_get_local_storage_proto;
Andrey Ignatovd7a4cb92019-03-18 17:55:26 -07002577extern const struct bpf_func_proto bpf_strtol_proto;
2578extern const struct bpf_func_proto bpf_strtoul_proto;
Stanislav Fomichev0d01da62019-06-27 13:38:47 -07002579extern const struct bpf_func_proto bpf_tcp_sock_proto;
Martin KaFai Lau5576b992020-01-22 15:36:46 -08002580extern const struct bpf_func_proto bpf_jiffies64_proto;
Carlos Neirab4490c52020-03-04 17:41:56 -03002581extern const struct bpf_func_proto bpf_get_ns_current_pid_tgid_proto;
Stanislav Fomichev0456ea12020-04-20 10:46:10 -07002582extern const struct bpf_func_proto bpf_event_output_data_proto;
Andrii Nakryiko457f44362020-05-29 00:54:20 -07002583extern const struct bpf_func_proto bpf_ringbuf_output_proto;
2584extern const struct bpf_func_proto bpf_ringbuf_reserve_proto;
2585extern const struct bpf_func_proto bpf_ringbuf_submit_proto;
2586extern const struct bpf_func_proto bpf_ringbuf_discard_proto;
2587extern const struct bpf_func_proto bpf_ringbuf_query_proto;
Joanne Koongbc34dee2022-05-23 14:07:09 -07002588extern const struct bpf_func_proto bpf_ringbuf_reserve_dynptr_proto;
2589extern const struct bpf_func_proto bpf_ringbuf_submit_dynptr_proto;
2590extern const struct bpf_func_proto bpf_ringbuf_discard_dynptr_proto;
Yonghong Songaf7ec132020-06-23 16:08:09 -07002591extern const struct bpf_func_proto bpf_skc_to_tcp6_sock_proto;
Yonghong Song478cfbd2020-06-23 16:08:11 -07002592extern const struct bpf_func_proto bpf_skc_to_tcp_sock_proto;
2593extern const struct bpf_func_proto bpf_skc_to_tcp_timewait_sock_proto;
2594extern const struct bpf_func_proto bpf_skc_to_tcp_request_sock_proto;
Yonghong Song0d4fad3e52020-06-23 16:08:15 -07002595extern const struct bpf_func_proto bpf_skc_to_udp6_sock_proto;
Hengqi Chen9eeb3aa2021-10-21 21:47:51 +08002596extern const struct bpf_func_proto bpf_skc_to_unix_sock_proto;
Geliang Tang3bc253c2022-05-19 16:30:10 -07002597extern const struct bpf_func_proto bpf_skc_to_mptcp_sock_proto;
Alexei Starovoitov07be4c42020-08-27 15:01:12 -07002598extern const struct bpf_func_proto bpf_copy_from_user_proto;
Alan Maguirec4d0bfb2020-09-28 12:31:05 +01002599extern const struct bpf_func_proto bpf_snprintf_btf_proto;
Florent Revest7b155232021-04-19 17:52:40 +02002600extern const struct bpf_func_proto bpf_snprintf_proto;
Hao Luoeaa6bcb2020-09-29 16:50:47 -07002601extern const struct bpf_func_proto bpf_per_cpu_ptr_proto;
Hao Luo63d9b802020-09-29 16:50:48 -07002602extern const struct bpf_func_proto bpf_this_cpu_ptr_proto;
Dmitrii Banshchikovd0551262020-11-17 18:45:49 +00002603extern const struct bpf_func_proto bpf_ktime_get_coarse_ns_proto;
Florent Revestb60da492020-12-08 18:36:23 +01002604extern const struct bpf_func_proto bpf_sock_from_file_proto;
Florent Revestc5dbb892021-02-10 12:14:03 +01002605extern const struct bpf_func_proto bpf_get_socket_ptr_cookie_proto;
Song Liua10787e2021-02-25 15:43:14 -08002606extern const struct bpf_func_proto bpf_task_storage_get_proto;
2607extern const struct bpf_func_proto bpf_task_storage_delete_proto;
Yonghong Song69c087b2021-02-26 12:49:25 -08002608extern const struct bpf_func_proto bpf_for_each_map_elem_proto;
Alexei Starovoitov3d784172021-05-13 17:36:11 -07002609extern const struct bpf_func_proto bpf_btf_find_by_name_kind_proto;
Martin KaFai Lau3cee6fb2021-07-01 13:06:19 -07002610extern const struct bpf_func_proto bpf_sk_setsockopt_proto;
2611extern const struct bpf_func_proto bpf_sk_getsockopt_proto;
Stanislav Fomichev9113d7e2022-06-28 10:43:09 -07002612extern const struct bpf_func_proto bpf_unlocked_sk_setsockopt_proto;
2613extern const struct bpf_func_proto bpf_unlocked_sk_getsockopt_proto;
Song Liu7c7e3d32021-11-05 16:23:29 -07002614extern const struct bpf_func_proto bpf_find_vma_proto;
Joanne Koonge6f2dd02021-11-29 19:06:19 -08002615extern const struct bpf_func_proto bpf_loop_proto;
Kenny Yu376040e2022-01-24 10:54:01 -08002616extern const struct bpf_func_proto bpf_copy_from_user_task_proto;
Stanislav Fomichev69fd3372022-06-28 10:43:06 -07002617extern const struct bpf_func_proto bpf_set_retval_proto;
2618extern const struct bpf_func_proto bpf_get_retval_proto;
David Vernet20571562022-09-19 19:00:58 -05002619extern const struct bpf_func_proto bpf_user_ringbuf_drain_proto;
Roman Gushchincd339432018-08-02 14:27:24 -07002620
Jiri Olsa958a3f22020-05-31 17:42:55 +02002621const struct bpf_func_proto *tracing_prog_func_proto(
2622 enum bpf_func_id func_id, const struct bpf_prog *prog);
2623
Daniel Borkmann3ad00402015-10-08 01:20:39 +02002624/* Shared helpers among cBPF and eBPF. */
2625void bpf_user_rnd_init_once(void);
2626u64 bpf_user_rnd_u32(u64 r1, u64 r2, u64 r3, u64 r4, u64 r5);
Stanislav Fomichev68908962020-04-24 16:59:41 -07002627u64 bpf_get_raw_cpu_id(u64 r1, u64 r2, u64 r3, u64 r4, u64 r5);
Daniel Borkmann3ad00402015-10-08 01:20:39 +02002628
Joe Stringerc64b7982018-10-02 13:35:33 -07002629#if defined(CONFIG_NET)
Martin KaFai Lau46f8bc92019-02-09 23:22:20 -08002630bool bpf_sock_common_is_valid_access(int off, int size,
2631 enum bpf_access_type type,
2632 struct bpf_insn_access_aux *info);
Joe Stringerc64b7982018-10-02 13:35:33 -07002633bool bpf_sock_is_valid_access(int off, int size, enum bpf_access_type type,
2634 struct bpf_insn_access_aux *info);
2635u32 bpf_sock_convert_ctx_access(enum bpf_access_type type,
2636 const struct bpf_insn *si,
2637 struct bpf_insn *insn_buf,
2638 struct bpf_prog *prog,
2639 u32 *target_size);
2640#else
Martin KaFai Lau46f8bc92019-02-09 23:22:20 -08002641static inline bool bpf_sock_common_is_valid_access(int off, int size,
2642 enum bpf_access_type type,
2643 struct bpf_insn_access_aux *info)
2644{
2645 return false;
2646}
Joe Stringerc64b7982018-10-02 13:35:33 -07002647static inline bool bpf_sock_is_valid_access(int off, int size,
2648 enum bpf_access_type type,
2649 struct bpf_insn_access_aux *info)
2650{
2651 return false;
2652}
2653static inline u32 bpf_sock_convert_ctx_access(enum bpf_access_type type,
2654 const struct bpf_insn *si,
2655 struct bpf_insn *insn_buf,
2656 struct bpf_prog *prog,
2657 u32 *target_size)
2658{
2659 return 0;
2660}
2661#endif
2662
Martin KaFai Lau655a51e2019-02-09 23:22:24 -08002663#ifdef CONFIG_INET
Alexei Starovoitov91cc1a92019-11-14 10:57:15 -08002664struct sk_reuseport_kern {
2665 struct sk_buff *skb;
2666 struct sock *sk;
2667 struct sock *selected_sk;
Kuniyuki Iwashimad5e4ddaeb2021-06-12 21:32:22 +09002668 struct sock *migrating_sk;
Alexei Starovoitov91cc1a92019-11-14 10:57:15 -08002669 void *data_end;
2670 u32 hash;
2671 u32 reuseport_id;
2672 bool bind_inany;
2673};
Martin KaFai Lau655a51e2019-02-09 23:22:24 -08002674bool bpf_tcp_sock_is_valid_access(int off, int size, enum bpf_access_type type,
2675 struct bpf_insn_access_aux *info);
2676
2677u32 bpf_tcp_sock_convert_ctx_access(enum bpf_access_type type,
2678 const struct bpf_insn *si,
2679 struct bpf_insn *insn_buf,
2680 struct bpf_prog *prog,
2681 u32 *target_size);
YueHaibing7f942082019-06-12 17:18:47 +08002682
2683bool bpf_xdp_sock_is_valid_access(int off, int size, enum bpf_access_type type,
2684 struct bpf_insn_access_aux *info);
2685
2686u32 bpf_xdp_sock_convert_ctx_access(enum bpf_access_type type,
2687 const struct bpf_insn *si,
2688 struct bpf_insn *insn_buf,
2689 struct bpf_prog *prog,
2690 u32 *target_size);
Martin KaFai Lau655a51e2019-02-09 23:22:24 -08002691#else
2692static inline bool bpf_tcp_sock_is_valid_access(int off, int size,
2693 enum bpf_access_type type,
2694 struct bpf_insn_access_aux *info)
2695{
2696 return false;
2697}
2698
2699static inline u32 bpf_tcp_sock_convert_ctx_access(enum bpf_access_type type,
2700 const struct bpf_insn *si,
2701 struct bpf_insn *insn_buf,
2702 struct bpf_prog *prog,
2703 u32 *target_size)
2704{
2705 return 0;
2706}
YueHaibing7f942082019-06-12 17:18:47 +08002707static inline bool bpf_xdp_sock_is_valid_access(int off, int size,
2708 enum bpf_access_type type,
2709 struct bpf_insn_access_aux *info)
2710{
2711 return false;
2712}
2713
2714static inline u32 bpf_xdp_sock_convert_ctx_access(enum bpf_access_type type,
2715 const struct bpf_insn *si,
2716 struct bpf_insn *insn_buf,
2717 struct bpf_prog *prog,
2718 u32 *target_size)
2719{
2720 return 0;
2721}
Martin KaFai Lau655a51e2019-02-09 23:22:24 -08002722#endif /* CONFIG_INET */
2723
Alexei Starovoitov5964b202019-11-14 10:57:03 -08002724enum bpf_text_poke_type {
Daniel Borkmannb553a6e2019-11-24 01:39:42 +01002725 BPF_MOD_CALL,
2726 BPF_MOD_JUMP,
Alexei Starovoitov5964b202019-11-14 10:57:03 -08002727};
Daniel Borkmann4b3da772019-11-22 21:07:54 +01002728
Alexei Starovoitov5964b202019-11-14 10:57:03 -08002729int bpf_arch_text_poke(void *ip, enum bpf_text_poke_type t,
2730 void *addr1, void *addr2);
2731
Jiri Olsa57a6b0a2023-12-06 09:30:40 +01002732void bpf_arch_poke_desc_update(struct bpf_jit_poke_descriptor *poke,
2733 struct bpf_prog *new, struct bpf_prog *old);
2734
Song Liuebc14152022-02-04 10:57:39 -08002735void *bpf_arch_text_copy(void *dst, void *src, size_t len);
Song Liufe736562022-05-20 16:57:53 -07002736int bpf_arch_text_invalidate(void *dst, size_t len);
Song Liuebc14152022-02-04 10:57:39 -08002737
Jiri Olsaeae2e832020-08-25 21:21:19 +02002738struct btf_id_set;
Lorenz Bauer2af30f12020-09-21 13:12:17 +01002739bool btf_id_set_contains(const struct btf_id_set *set, u32 id);
Jiri Olsaeae2e832020-08-25 21:21:19 +02002740
Dave Marchevsky335ff492021-09-17 11:29:03 -07002741#define MAX_BPRINTF_VARARGS 12
Jiri Olsaf3e97582022-12-15 22:44:30 +01002742#define MAX_BPRINTF_BUF 1024
Dave Marchevsky335ff492021-09-17 11:29:03 -07002743
Jiri Olsaf7bbad92022-12-15 22:44:28 +01002744struct bpf_bprintf_data {
2745 u32 *bin_args;
Jiri Olsaf3e97582022-12-15 22:44:30 +01002746 char *buf;
Jiri Olsaf7bbad92022-12-15 22:44:28 +01002747 bool get_bin_args;
Jiri Olsaf3e97582022-12-15 22:44:30 +01002748 bool get_buf;
Jiri Olsaf7bbad92022-12-15 22:44:28 +01002749};
2750
Florent Revest48cac3f2021-04-27 19:43:13 +02002751int bpf_bprintf_prepare(char *fmt, u32 fmt_size, const u64 *raw_args,
Jiri Olsaf7bbad92022-12-15 22:44:28 +01002752 u32 num_args, struct bpf_bprintf_data *data);
Jiri Olsa95b74762022-12-15 22:44:29 +01002753void bpf_bprintf_cleanup(struct bpf_bprintf_data *data);
Florent Revestd9c9e4d2021-04-19 17:52:38 +02002754
Joanne Koong97e03f52022-05-23 14:07:07 -07002755/* the implementation of the opaque uapi struct bpf_dynptr */
2756struct bpf_dynptr_kern {
2757 void *data;
2758 /* Size represents the number of usable bytes of dynptr data.
2759 * If for example the offset is at 4 for a local dynptr whose data is
2760 * of type u64, the number of usable bytes is 4.
2761 *
2762 * The upper 8 bits are reserved. It is as follows:
2763 * Bits 0 - 23 = size
2764 * Bits 24 - 30 = dynptr type
2765 * Bit 31 = whether dynptr is read-only
2766 */
2767 u32 size;
2768 u32 offset;
2769} __aligned(8);
2770
2771enum bpf_dynptr_type {
2772 BPF_DYNPTR_TYPE_INVALID,
2773 /* Points to memory that is local to the bpf program */
2774 BPF_DYNPTR_TYPE_LOCAL,
David Vernet20571562022-09-19 19:00:58 -05002775 /* Underlying data is a kernel-produced ringbuf record */
Joanne Koongbc34dee2022-05-23 14:07:09 -07002776 BPF_DYNPTR_TYPE_RINGBUF,
Joanne Koong97e03f52022-05-23 14:07:07 -07002777};
2778
Joanne Koongbc34dee2022-05-23 14:07:09 -07002779void bpf_dynptr_init(struct bpf_dynptr_kern *ptr, void *data,
2780 enum bpf_dynptr_type type, u32 offset, u32 size);
2781void bpf_dynptr_set_null(struct bpf_dynptr_kern *ptr);
2782int bpf_dynptr_check_size(u32 size);
Roberto Sassu51df4862022-09-20 09:59:43 +02002783u32 bpf_dynptr_get_size(struct bpf_dynptr_kern *ptr);
Joanne Koongbc34dee2022-05-23 14:07:09 -07002784
Stanislav Fomichevc0e19f22022-06-28 10:43:07 -07002785#ifdef CONFIG_BPF_LSM
2786void bpf_cgroup_atype_get(u32 attach_btf_id, int cgroup_atype);
2787void bpf_cgroup_atype_put(int cgroup_atype);
2788#else
2789static inline void bpf_cgroup_atype_get(u32 attach_btf_id, int cgroup_atype) {}
2790static inline void bpf_cgroup_atype_put(int cgroup_atype) {}
2791#endif /* CONFIG_BPF_LSM */
2792
Roberto Sassuf3cf4132022-09-20 09:59:45 +02002793struct key;
2794
2795#ifdef CONFIG_KEYS
2796struct bpf_key {
2797 struct key *key;
2798 bool has_ref;
2799};
2800#endif /* CONFIG_KEYS */
Alexei Starovoitov99c55f72014-09-26 00:16:57 -07002801#endif /* _LINUX_BPF_H */