1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* Copyright (c) 2011-2014 PLUMgrid, http://plumgrid.com 3 */ 4 #ifndef _LINUX_BPF_H 5 #define _LINUX_BPF_H 1 6 7 #include <uapi/linux/bpf.h> 8 #include <uapi/linux/filter.h> 9 10 #include <linux/workqueue.h> 11 #include <linux/file.h> 12 #include <linux/percpu.h> 13 #include <linux/err.h> 14 #include <linux/rbtree_latch.h> 15 #include <linux/numa.h> 16 #include <linux/mm_types.h> 17 #include <linux/wait.h> 18 #include <linux/refcount.h> 19 #include <linux/mutex.h> 20 #include <linux/module.h> 21 #include <linux/kallsyms.h> 22 #include <linux/capability.h> 23 #include <linux/sched/mm.h> 24 #include <linux/slab.h> 25 #include <linux/percpu-refcount.h> 26 #include <linux/stddef.h> 27 #include <linux/bpfptr.h> 28 #include <linux/btf.h> 29 #include <linux/rcupdate_trace.h> 30 #include <linux/static_call.h> 31 #include <linux/memcontrol.h> 32 #include <linux/cfi.h> 33 34 struct bpf_verifier_env; 35 struct bpf_verifier_log; 36 struct perf_event; 37 struct bpf_prog; 38 struct bpf_prog_aux; 39 struct bpf_map; 40 struct bpf_arena; 41 struct sock; 42 struct seq_file; 43 struct btf; 44 struct btf_type; 45 struct exception_table_entry; 46 struct seq_operations; 47 struct bpf_iter_aux_info; 48 struct bpf_local_storage; 49 struct bpf_local_storage_map; 50 struct kobject; 51 struct mem_cgroup; 52 struct module; 53 struct bpf_func_state; 54 struct ftrace_ops; 55 struct cgroup; 56 struct bpf_token; 57 struct user_namespace; 58 struct super_block; 59 struct inode; 60 61 extern struct idr btf_idr; 62 extern spinlock_t btf_idr_lock; 63 extern struct kobject *btf_kobj; 64 extern struct bpf_mem_alloc bpf_global_ma, bpf_global_percpu_ma; 65 extern bool bpf_global_ma_set; 66 67 typedef u64 (*bpf_callback_t)(u64, u64, u64, u64, u64); 68 typedef int (*bpf_iter_init_seq_priv_t)(void *private_data, 69 struct bpf_iter_aux_info *aux); 70 typedef void (*bpf_iter_fini_seq_priv_t)(void *private_data); 71 typedef unsigned int (*bpf_func_t)(const void *, 72 const struct bpf_insn *); 73 struct bpf_iter_seq_info { 74 const struct seq_operations *seq_ops; 75 bpf_iter_init_seq_priv_t init_seq_private; 76 bpf_iter_fini_seq_priv_t fini_seq_private; 77 u32 seq_priv_size; 78 }; 79 80 /* map is generic key/value storage optionally accessible by eBPF programs */ 81 struct bpf_map_ops { 82 /* funcs callable from userspace (via syscall) */ 83 int (*map_alloc_check)(union bpf_attr *attr); 84 struct bpf_map *(*map_alloc)(union bpf_attr *attr); 85 void (*map_release)(struct bpf_map *map, struct file *map_file); 86 void (*map_free)(struct bpf_map *map); 87 int (*map_get_next_key)(struct bpf_map *map, void *key, void *next_key); 88 void (*map_release_uref)(struct bpf_map *map); 89 void *(*map_lookup_elem_sys_only)(struct bpf_map *map, void *key); 90 int (*map_lookup_batch)(struct bpf_map *map, const union bpf_attr *attr, 91 union bpf_attr __user *uattr); 92 int (*map_lookup_and_delete_elem)(struct bpf_map *map, void *key, 93 void *value, u64 flags); 94 int (*map_lookup_and_delete_batch)(struct bpf_map *map, 95 const union bpf_attr *attr, 96 union bpf_attr __user *uattr); 97 int (*map_update_batch)(struct bpf_map *map, struct file *map_file, 98 const union bpf_attr *attr, 99 union bpf_attr __user *uattr); 100 int (*map_delete_batch)(struct bpf_map *map, const union bpf_attr *attr, 101 union bpf_attr __user *uattr); 102 103 /* funcs callable from userspace and from eBPF programs */ 104 void *(*map_lookup_elem)(struct bpf_map *map, void *key); 105 long (*map_update_elem)(struct bpf_map *map, void *key, void *value, u64 flags); 106 long (*map_delete_elem)(struct bpf_map *map, void *key); 107 long (*map_push_elem)(struct bpf_map *map, void *value, u64 flags); 108 long (*map_pop_elem)(struct bpf_map *map, void *value); 109 long (*map_peek_elem)(struct bpf_map *map, void *value); 110 void *(*map_lookup_percpu_elem)(struct bpf_map *map, void *key, u32 cpu); 111 112 /* funcs called by prog_array and perf_event_array map */ 113 void *(*map_fd_get_ptr)(struct bpf_map *map, struct file *map_file, 114 int fd); 115 /* If need_defer is true, the implementation should guarantee that 116 * the to-be-put element is still alive before the bpf program, which 117 * may manipulate it, exists. 118 */ 119 void (*map_fd_put_ptr)(struct bpf_map *map, void *ptr, bool need_defer); 120 int (*map_gen_lookup)(struct bpf_map *map, struct bpf_insn *insn_buf); 121 u32 (*map_fd_sys_lookup_elem)(void *ptr); 122 void (*map_seq_show_elem)(struct bpf_map *map, void *key, 123 struct seq_file *m); 124 int (*map_check_btf)(const struct bpf_map *map, 125 const struct btf *btf, 126 const struct btf_type *key_type, 127 const struct btf_type *value_type); 128 129 /* Prog poke tracking helpers. */ 130 int (*map_poke_track)(struct bpf_map *map, struct bpf_prog_aux *aux); 131 void (*map_poke_untrack)(struct bpf_map *map, struct bpf_prog_aux *aux); 132 void (*map_poke_run)(struct bpf_map *map, u32 key, struct bpf_prog *old, 133 struct bpf_prog *new); 134 135 /* Direct value access helpers. */ 136 int (*map_direct_value_addr)(const struct bpf_map *map, 137 u64 *imm, u32 off); 138 int (*map_direct_value_meta)(const struct bpf_map *map, 139 u64 imm, u32 *off); 140 int (*map_mmap)(struct bpf_map *map, struct vm_area_struct *vma); 141 __poll_t (*map_poll)(struct bpf_map *map, struct file *filp, 142 struct poll_table_struct *pts); 143 unsigned long (*map_get_unmapped_area)(struct file *filep, unsigned long addr, 144 unsigned long len, unsigned long pgoff, 145 unsigned long flags); 146 147 /* Functions called by bpf_local_storage maps */ 148 int (*map_local_storage_charge)(struct bpf_local_storage_map *smap, 149 void *owner, u32 size); 150 void (*map_local_storage_uncharge)(struct bpf_local_storage_map *smap, 151 void *owner, u32 size); 152 struct bpf_local_storage __rcu ** (*map_owner_storage_ptr)(void *owner); 153 154 /* Misc helpers.*/ 155 long (*map_redirect)(struct bpf_map *map, u64 key, u64 flags); 156 157 /* map_meta_equal must be implemented for maps that can be 158 * used as an inner map. It is a runtime check to ensure 159 * an inner map can be inserted to an outer map. 160 * 161 * Some properties of the inner map has been used during the 162 * verification time. When inserting an inner map at the runtime, 163 * map_meta_equal has to ensure the inserting map has the same 164 * properties that the verifier has used earlier. 165 */ 166 bool (*map_meta_equal)(const struct bpf_map *meta0, 167 const struct bpf_map *meta1); 168 169 170 int (*map_set_for_each_callback_args)(struct bpf_verifier_env *env, 171 struct bpf_func_state *caller, 172 struct bpf_func_state *callee); 173 long (*map_for_each_callback)(struct bpf_map *map, 174 bpf_callback_t callback_fn, 175 void *callback_ctx, u64 flags); 176 177 u64 (*map_mem_usage)(const struct bpf_map *map); 178 179 /* BTF id of struct allocated by map_alloc */ 180 int *map_btf_id; 181 182 /* bpf_iter info used to open a seq_file */ 183 const struct bpf_iter_seq_info *iter_seq_info; 184 }; 185 186 enum { 187 /* Support at most 11 fields in a BTF type */ 188 BTF_FIELDS_MAX = 11, 189 }; 190 191 enum btf_field_type { 192 BPF_SPIN_LOCK = (1 << 0), 193 BPF_TIMER = (1 << 1), 194 BPF_KPTR_UNREF = (1 << 2), 195 BPF_KPTR_REF = (1 << 3), 196 BPF_KPTR_PERCPU = (1 << 4), 197 BPF_KPTR = BPF_KPTR_UNREF | BPF_KPTR_REF | BPF_KPTR_PERCPU, 198 BPF_LIST_HEAD = (1 << 5), 199 BPF_LIST_NODE = (1 << 6), 200 BPF_RB_ROOT = (1 << 7), 201 BPF_RB_NODE = (1 << 8), 202 BPF_GRAPH_NODE = BPF_RB_NODE | BPF_LIST_NODE, 203 BPF_GRAPH_ROOT = BPF_RB_ROOT | BPF_LIST_HEAD, 204 BPF_REFCOUNT = (1 << 9), 205 BPF_WORKQUEUE = (1 << 10), 206 BPF_UPTR = (1 << 11), 207 }; 208 209 typedef void (*btf_dtor_kfunc_t)(void *); 210 211 struct btf_field_kptr { 212 struct btf *btf; 213 struct module *module; 214 /* dtor used if btf_is_kernel(btf), otherwise the type is 215 * program-allocated, dtor is NULL, and __bpf_obj_drop_impl is used 216 */ 217 btf_dtor_kfunc_t dtor; 218 u32 btf_id; 219 }; 220 221 struct btf_field_graph_root { 222 struct btf *btf; 223 u32 value_btf_id; 224 u32 node_offset; 225 struct btf_record *value_rec; 226 }; 227 228 struct btf_field { 229 u32 offset; 230 u32 size; 231 enum btf_field_type type; 232 union { 233 struct btf_field_kptr kptr; 234 struct btf_field_graph_root graph_root; 235 }; 236 }; 237 238 struct btf_record { 239 u32 cnt; 240 u32 field_mask; 241 int spin_lock_off; 242 int timer_off; 243 int wq_off; 244 int refcount_off; 245 struct btf_field fields[]; 246 }; 247 248 /* Non-opaque version of bpf_rb_node in uapi/linux/bpf.h */ 249 struct bpf_rb_node_kern { 250 struct rb_node rb_node; 251 void *owner; 252 } __attribute__((aligned(8))); 253 254 /* Non-opaque version of bpf_list_node in uapi/linux/bpf.h */ 255 struct bpf_list_node_kern { 256 struct list_head list_head; 257 void *owner; 258 } __attribute__((aligned(8))); 259 260 struct bpf_map { 261 const struct bpf_map_ops *ops; 262 struct bpf_map *inner_map_meta; 263 #ifdef CONFIG_SECURITY 264 void *security; 265 #endif 266 enum bpf_map_type map_type; 267 u32 key_size; 268 u32 value_size; 269 u32 max_entries; 270 u64 map_extra; /* any per-map-type extra fields */ 271 u32 map_flags; 272 u32 id; 273 struct btf_record *record; 274 int numa_node; 275 u32 btf_key_type_id; 276 u32 btf_value_type_id; 277 u32 btf_vmlinux_value_type_id; 278 struct btf *btf; 279 #ifdef CONFIG_MEMCG 280 struct obj_cgroup *objcg; 281 #endif 282 char name[BPF_OBJ_NAME_LEN]; 283 struct mutex freeze_mutex; 284 atomic64_t refcnt; 285 atomic64_t usercnt; 286 /* rcu is used before freeing and work is only used during freeing */ 287 union { 288 struct work_struct work; 289 struct rcu_head rcu; 290 }; 291 atomic64_t writecnt; 292 /* 'Ownership' of program-containing map is claimed by the first program 293 * that is going to use this map or by the first program which FD is 294 * stored in the map to make sure that all callers and callees have the 295 * same prog type, JITed flag and xdp_has_frags flag. 296 */ 297 struct { 298 const struct btf_type *attach_func_proto; 299 spinlock_t lock; 300 enum bpf_prog_type type; 301 bool jited; 302 bool xdp_has_frags; 303 } owner; 304 bool bypass_spec_v1; 305 bool frozen; /* write-once; write-protected by freeze_mutex */ 306 bool free_after_mult_rcu_gp; 307 bool free_after_rcu_gp; 308 atomic64_t sleepable_refcnt; 309 s64 __percpu *elem_count; 310 }; 311 312 static inline const char *btf_field_type_name(enum btf_field_type type) 313 { 314 switch (type) { 315 case BPF_SPIN_LOCK: 316 return "bpf_spin_lock"; 317 case BPF_TIMER: 318 return "bpf_timer"; 319 case BPF_WORKQUEUE: 320 return "bpf_wq"; 321 case BPF_KPTR_UNREF: 322 case BPF_KPTR_REF: 323 return "kptr"; 324 case BPF_KPTR_PERCPU: 325 return "percpu_kptr"; 326 case BPF_UPTR: 327 return "uptr"; 328 case BPF_LIST_HEAD: 329 return "bpf_list_head"; 330 case BPF_LIST_NODE: 331 return "bpf_list_node"; 332 case BPF_RB_ROOT: 333 return "bpf_rb_root"; 334 case BPF_RB_NODE: 335 return "bpf_rb_node"; 336 case BPF_REFCOUNT: 337 return "bpf_refcount"; 338 default: 339 WARN_ON_ONCE(1); 340 return "unknown"; 341 } 342 } 343 344 static inline u32 btf_field_type_size(enum btf_field_type type) 345 { 346 switch (type) { 347 case BPF_SPIN_LOCK: 348 return sizeof(struct bpf_spin_lock); 349 case BPF_TIMER: 350 return sizeof(struct bpf_timer); 351 case BPF_WORKQUEUE: 352 return sizeof(struct bpf_wq); 353 case BPF_KPTR_UNREF: 354 case BPF_KPTR_REF: 355 case BPF_KPTR_PERCPU: 356 case BPF_UPTR: 357 return sizeof(u64); 358 case BPF_LIST_HEAD: 359 return sizeof(struct bpf_list_head); 360 case BPF_LIST_NODE: 361 return sizeof(struct bpf_list_node); 362 case BPF_RB_ROOT: 363 return sizeof(struct bpf_rb_root); 364 case BPF_RB_NODE: 365 return sizeof(struct bpf_rb_node); 366 case BPF_REFCOUNT: 367 return sizeof(struct bpf_refcount); 368 default: 369 WARN_ON_ONCE(1); 370 return 0; 371 } 372 } 373 374 static inline u32 btf_field_type_align(enum btf_field_type type) 375 { 376 switch (type) { 377 case BPF_SPIN_LOCK: 378 return __alignof__(struct bpf_spin_lock); 379 case BPF_TIMER: 380 return __alignof__(struct bpf_timer); 381 case BPF_WORKQUEUE: 382 return __alignof__(struct bpf_wq); 383 case BPF_KPTR_UNREF: 384 case BPF_KPTR_REF: 385 case BPF_KPTR_PERCPU: 386 case BPF_UPTR: 387 return __alignof__(u64); 388 case BPF_LIST_HEAD: 389 return __alignof__(struct bpf_list_head); 390 case BPF_LIST_NODE: 391 return __alignof__(struct bpf_list_node); 392 case BPF_RB_ROOT: 393 return __alignof__(struct bpf_rb_root); 394 case BPF_RB_NODE: 395 return __alignof__(struct bpf_rb_node); 396 case BPF_REFCOUNT: 397 return __alignof__(struct bpf_refcount); 398 default: 399 WARN_ON_ONCE(1); 400 return 0; 401 } 402 } 403 404 static inline void bpf_obj_init_field(const struct btf_field *field, void *addr) 405 { 406 memset(addr, 0, field->size); 407 408 switch (field->type) { 409 case BPF_REFCOUNT: 410 refcount_set((refcount_t *)addr, 1); 411 break; 412 case BPF_RB_NODE: 413 RB_CLEAR_NODE((struct rb_node *)addr); 414 break; 415 case BPF_LIST_HEAD: 416 case BPF_LIST_NODE: 417 INIT_LIST_HEAD((struct list_head *)addr); 418 break; 419 case BPF_RB_ROOT: 420 /* RB_ROOT_CACHED 0-inits, no need to do anything after memset */ 421 case BPF_SPIN_LOCK: 422 case BPF_TIMER: 423 case BPF_WORKQUEUE: 424 case BPF_KPTR_UNREF: 425 case BPF_KPTR_REF: 426 case BPF_KPTR_PERCPU: 427 case BPF_UPTR: 428 break; 429 default: 430 WARN_ON_ONCE(1); 431 return; 432 } 433 } 434 435 static inline bool btf_record_has_field(const struct btf_record *rec, enum btf_field_type type) 436 { 437 if (IS_ERR_OR_NULL(rec)) 438 return false; 439 return rec->field_mask & type; 440 } 441 442 static inline void bpf_obj_init(const struct btf_record *rec, void *obj) 443 { 444 int i; 445 446 if (IS_ERR_OR_NULL(rec)) 447 return; 448 for (i = 0; i < rec->cnt; i++) 449 bpf_obj_init_field(&rec->fields[i], obj + rec->fields[i].offset); 450 } 451 452 /* 'dst' must be a temporary buffer and should not point to memory that is being 453 * used in parallel by a bpf program or bpf syscall, otherwise the access from 454 * the bpf program or bpf syscall may be corrupted by the reinitialization, 455 * leading to weird problems. Even 'dst' is newly-allocated from bpf memory 456 * allocator, it is still possible for 'dst' to be used in parallel by a bpf 457 * program or bpf syscall. 458 */ 459 static inline void check_and_init_map_value(struct bpf_map *map, void *dst) 460 { 461 bpf_obj_init(map->record, dst); 462 } 463 464 /* memcpy that is used with 8-byte aligned pointers, power-of-8 size and 465 * forced to use 'long' read/writes to try to atomically copy long counters. 466 * Best-effort only. No barriers here, since it _will_ race with concurrent 467 * updates from BPF programs. Called from bpf syscall and mostly used with 468 * size 8 or 16 bytes, so ask compiler to inline it. 469 */ 470 static inline void bpf_long_memcpy(void *dst, const void *src, u32 size) 471 { 472 const long *lsrc = src; 473 long *ldst = dst; 474 475 size /= sizeof(long); 476 while (size--) 477 data_race(*ldst++ = *lsrc++); 478 } 479 480 /* copy everything but bpf_spin_lock, bpf_timer, and kptrs. There could be one of each. */ 481 static inline void bpf_obj_memcpy(struct btf_record *rec, 482 void *dst, void *src, u32 size, 483 bool long_memcpy) 484 { 485 u32 curr_off = 0; 486 int i; 487 488 if (IS_ERR_OR_NULL(rec)) { 489 if (long_memcpy) 490 bpf_long_memcpy(dst, src, round_up(size, 8)); 491 else 492 memcpy(dst, src, size); 493 return; 494 } 495 496 for (i = 0; i < rec->cnt; i++) { 497 u32 next_off = rec->fields[i].offset; 498 u32 sz = next_off - curr_off; 499 500 memcpy(dst + curr_off, src + curr_off, sz); 501 curr_off += rec->fields[i].size + sz; 502 } 503 memcpy(dst + curr_off, src + curr_off, size - curr_off); 504 } 505 506 static inline void copy_map_value(struct bpf_map *map, void *dst, void *src) 507 { 508 bpf_obj_memcpy(map->record, dst, src, map->value_size, false); 509 } 510 511 static inline void copy_map_value_long(struct bpf_map *map, void *dst, void *src) 512 { 513 bpf_obj_memcpy(map->record, dst, src, map->value_size, true); 514 } 515 516 static inline void bpf_obj_swap_uptrs(const struct btf_record *rec, void *dst, void *src) 517 { 518 unsigned long *src_uptr, *dst_uptr; 519 const struct btf_field *field; 520 int i; 521 522 if (!btf_record_has_field(rec, BPF_UPTR)) 523 return; 524 525 for (i = 0, field = rec->fields; i < rec->cnt; i++, field++) { 526 if (field->type != BPF_UPTR) 527 continue; 528 529 src_uptr = src + field->offset; 530 dst_uptr = dst + field->offset; 531 swap(*src_uptr, *dst_uptr); 532 } 533 } 534 535 static inline void bpf_obj_memzero(struct btf_record *rec, void *dst, u32 size) 536 { 537 u32 curr_off = 0; 538 int i; 539 540 if (IS_ERR_OR_NULL(rec)) { 541 memset(dst, 0, size); 542 return; 543 } 544 545 for (i = 0; i < rec->cnt; i++) { 546 u32 next_off = rec->fields[i].offset; 547 u32 sz = next_off - curr_off; 548 549 memset(dst + curr_off, 0, sz); 550 curr_off += rec->fields[i].size + sz; 551 } 552 memset(dst + curr_off, 0, size - curr_off); 553 } 554 555 static inline void zero_map_value(struct bpf_map *map, void *dst) 556 { 557 bpf_obj_memzero(map->record, dst, map->value_size); 558 } 559 560 void copy_map_value_locked(struct bpf_map *map, void *dst, void *src, 561 bool lock_src); 562 void bpf_timer_cancel_and_free(void *timer); 563 void bpf_wq_cancel_and_free(void *timer); 564 void bpf_list_head_free(const struct btf_field *field, void *list_head, 565 struct bpf_spin_lock *spin_lock); 566 void bpf_rb_root_free(const struct btf_field *field, void *rb_root, 567 struct bpf_spin_lock *spin_lock); 568 u64 bpf_arena_get_kern_vm_start(struct bpf_arena *arena); 569 u64 bpf_arena_get_user_vm_start(struct bpf_arena *arena); 570 int bpf_obj_name_cpy(char *dst, const char *src, unsigned int size); 571 572 struct bpf_offload_dev; 573 struct bpf_offloaded_map; 574 575 struct bpf_map_dev_ops { 576 int (*map_get_next_key)(struct bpf_offloaded_map *map, 577 void *key, void *next_key); 578 int (*map_lookup_elem)(struct bpf_offloaded_map *map, 579 void *key, void *value); 580 int (*map_update_elem)(struct bpf_offloaded_map *map, 581 void *key, void *value, u64 flags); 582 int (*map_delete_elem)(struct bpf_offloaded_map *map, void *key); 583 }; 584 585 struct bpf_offloaded_map { 586 struct bpf_map map; 587 struct net_device *netdev; 588 const struct bpf_map_dev_ops *dev_ops; 589 void *dev_priv; 590 struct list_head offloads; 591 }; 592 593 static inline struct bpf_offloaded_map *map_to_offmap(struct bpf_map *map) 594 { 595 return container_of(map, struct bpf_offloaded_map, map); 596 } 597 598 static inline bool bpf_map_offload_neutral(const struct bpf_map *map) 599 { 600 return map->map_type == BPF_MAP_TYPE_PERF_EVENT_ARRAY; 601 } 602 603 static inline bool bpf_map_support_seq_show(const struct bpf_map *map) 604 { 605 return (map->btf_value_type_id || map->btf_vmlinux_value_type_id) && 606 map->ops->map_seq_show_elem; 607 } 608 609 int map_check_no_btf(const struct bpf_map *map, 610 const struct btf *btf, 611 const struct btf_type *key_type, 612 const struct btf_type *value_type); 613 614 bool bpf_map_meta_equal(const struct bpf_map *meta0, 615 const struct bpf_map *meta1); 616 617 extern const struct bpf_map_ops bpf_map_offload_ops; 618 619 /* bpf_type_flag contains a set of flags that are applicable to the values of 620 * arg_type, ret_type and reg_type. For example, a pointer value may be null, 621 * or a memory is read-only. We classify types into two categories: base types 622 * and extended types. Extended types are base types combined with a type flag. 623 * 624 * Currently there are no more than 32 base types in arg_type, ret_type and 625 * reg_types. 626 */ 627 #define BPF_BASE_TYPE_BITS 8 628 629 enum bpf_type_flag { 630 /* PTR may be NULL. */ 631 PTR_MAYBE_NULL = BIT(0 + BPF_BASE_TYPE_BITS), 632 633 /* MEM is read-only. When applied on bpf_arg, it indicates the arg is 634 * compatible with both mutable and immutable memory. 635 */ 636 MEM_RDONLY = BIT(1 + BPF_BASE_TYPE_BITS), 637 638 /* MEM points to BPF ring buffer reservation. */ 639 MEM_RINGBUF = BIT(2 + BPF_BASE_TYPE_BITS), 640 641 /* MEM is in user address space. */ 642 MEM_USER = BIT(3 + BPF_BASE_TYPE_BITS), 643 644 /* MEM is a percpu memory. MEM_PERCPU tags PTR_TO_BTF_ID. When tagged 645 * with MEM_PERCPU, PTR_TO_BTF_ID _cannot_ be directly accessed. In 646 * order to drop this tag, it must be passed into bpf_per_cpu_ptr() 647 * or bpf_this_cpu_ptr(), which will return the pointer corresponding 648 * to the specified cpu. 649 */ 650 MEM_PERCPU = BIT(4 + BPF_BASE_TYPE_BITS), 651 652 /* Indicates that the argument will be released. */ 653 OBJ_RELEASE = BIT(5 + BPF_BASE_TYPE_BITS), 654 655 /* PTR is not trusted. This is only used with PTR_TO_BTF_ID, to mark 656 * unreferenced and referenced kptr loaded from map value using a load 657 * instruction, so that they can only be dereferenced but not escape the 658 * BPF program into the kernel (i.e. cannot be passed as arguments to 659 * kfunc or bpf helpers). 660 */ 661 PTR_UNTRUSTED = BIT(6 + BPF_BASE_TYPE_BITS), 662 663 /* MEM can be uninitialized. */ 664 MEM_UNINIT = BIT(7 + BPF_BASE_TYPE_BITS), 665 666 /* DYNPTR points to memory local to the bpf program. */ 667 DYNPTR_TYPE_LOCAL = BIT(8 + BPF_BASE_TYPE_BITS), 668 669 /* DYNPTR points to a kernel-produced ringbuf record. */ 670 DYNPTR_TYPE_RINGBUF = BIT(9 + BPF_BASE_TYPE_BITS), 671 672 /* Size is known at compile time. */ 673 MEM_FIXED_SIZE = BIT(10 + BPF_BASE_TYPE_BITS), 674 675 /* MEM is of an allocated object of type in program BTF. This is used to 676 * tag PTR_TO_BTF_ID allocated using bpf_obj_new. 677 */ 678 MEM_ALLOC = BIT(11 + BPF_BASE_TYPE_BITS), 679 680 /* PTR was passed from the kernel in a trusted context, and may be 681 * passed to KF_TRUSTED_ARGS kfuncs or BPF helper functions. 682 * Confusingly, this is _not_ the opposite of PTR_UNTRUSTED above. 683 * PTR_UNTRUSTED refers to a kptr that was read directly from a map 684 * without invoking bpf_kptr_xchg(). What we really need to know is 685 * whether a pointer is safe to pass to a kfunc or BPF helper function. 686 * While PTR_UNTRUSTED pointers are unsafe to pass to kfuncs and BPF 687 * helpers, they do not cover all possible instances of unsafe 688 * pointers. For example, a pointer that was obtained from walking a 689 * struct will _not_ get the PTR_UNTRUSTED type modifier, despite the 690 * fact that it may be NULL, invalid, etc. This is due to backwards 691 * compatibility requirements, as this was the behavior that was first 692 * introduced when kptrs were added. The behavior is now considered 693 * deprecated, and PTR_UNTRUSTED will eventually be removed. 694 * 695 * PTR_TRUSTED, on the other hand, is a pointer that the kernel 696 * guarantees to be valid and safe to pass to kfuncs and BPF helpers. 697 * For example, pointers passed to tracepoint arguments are considered 698 * PTR_TRUSTED, as are pointers that are passed to struct_ops 699 * callbacks. As alluded to above, pointers that are obtained from 700 * walking PTR_TRUSTED pointers are _not_ trusted. For example, if a 701 * struct task_struct *task is PTR_TRUSTED, then accessing 702 * task->last_wakee will lose the PTR_TRUSTED modifier when it's stored 703 * in a BPF register. Similarly, pointers passed to certain programs 704 * types such as kretprobes are not guaranteed to be valid, as they may 705 * for example contain an object that was recently freed. 706 */ 707 PTR_TRUSTED = BIT(12 + BPF_BASE_TYPE_BITS), 708 709 /* MEM is tagged with rcu and memory access needs rcu_read_lock protection. */ 710 MEM_RCU = BIT(13 + BPF_BASE_TYPE_BITS), 711 712 /* Used to tag PTR_TO_BTF_ID | MEM_ALLOC references which are non-owning. 713 * Currently only valid for linked-list and rbtree nodes. If the nodes 714 * have a bpf_refcount_field, they must be tagged MEM_RCU as well. 715 */ 716 NON_OWN_REF = BIT(14 + BPF_BASE_TYPE_BITS), 717 718 /* DYNPTR points to sk_buff */ 719 DYNPTR_TYPE_SKB = BIT(15 + BPF_BASE_TYPE_BITS), 720 721 /* DYNPTR points to xdp_buff */ 722 DYNPTR_TYPE_XDP = BIT(16 + BPF_BASE_TYPE_BITS), 723 724 /* Memory must be aligned on some architectures, used in combination with 725 * MEM_FIXED_SIZE. 726 */ 727 MEM_ALIGNED = BIT(17 + BPF_BASE_TYPE_BITS), 728 729 /* MEM is being written to, often combined with MEM_UNINIT. Non-presence 730 * of MEM_WRITE means that MEM is only being read. MEM_WRITE without the 731 * MEM_UNINIT means that memory needs to be initialized since it is also 732 * read. 733 */ 734 MEM_WRITE = BIT(18 + BPF_BASE_TYPE_BITS), 735 736 __BPF_TYPE_FLAG_MAX, 737 __BPF_TYPE_LAST_FLAG = __BPF_TYPE_FLAG_MAX - 1, 738 }; 739 740 #define DYNPTR_TYPE_FLAG_MASK (DYNPTR_TYPE_LOCAL | DYNPTR_TYPE_RINGBUF | DYNPTR_TYPE_SKB \ 741 | DYNPTR_TYPE_XDP) 742 743 /* Max number of base types. */ 744 #define BPF_BASE_TYPE_LIMIT (1UL << BPF_BASE_TYPE_BITS) 745 746 /* Max number of all types. */ 747 #define BPF_TYPE_LIMIT (__BPF_TYPE_LAST_FLAG | (__BPF_TYPE_LAST_FLAG - 1)) 748 749 /* function argument constraints */ 750 enum bpf_arg_type { 751 ARG_DONTCARE = 0, /* unused argument in helper function */ 752 753 /* the following constraints used to prototype 754 * bpf_map_lookup/update/delete_elem() functions 755 */ 756 ARG_CONST_MAP_PTR, /* const argument used as pointer to bpf_map */ 757 ARG_PTR_TO_MAP_KEY, /* pointer to stack used as map key */ 758 ARG_PTR_TO_MAP_VALUE, /* pointer to stack used as map value */ 759 760 /* Used to prototype bpf_memcmp() and other functions that access data 761 * on eBPF program stack 762 */ 763 ARG_PTR_TO_MEM, /* pointer to valid memory (stack, packet, map value) */ 764 ARG_PTR_TO_ARENA, 765 766 ARG_CONST_SIZE, /* number of bytes accessed from memory */ 767 ARG_CONST_SIZE_OR_ZERO, /* number of bytes accessed from memory or 0 */ 768 769 ARG_PTR_TO_CTX, /* pointer to context */ 770 ARG_ANYTHING, /* any (initialized) argument is ok */ 771 ARG_PTR_TO_SPIN_LOCK, /* pointer to bpf_spin_lock */ 772 ARG_PTR_TO_SOCK_COMMON, /* pointer to sock_common */ 773 ARG_PTR_TO_SOCKET, /* pointer to bpf_sock (fullsock) */ 774 ARG_PTR_TO_BTF_ID, /* pointer to in-kernel struct */ 775 ARG_PTR_TO_RINGBUF_MEM, /* pointer to dynamically reserved ringbuf memory */ 776 ARG_CONST_ALLOC_SIZE_OR_ZERO, /* number of allocated bytes requested */ 777 ARG_PTR_TO_BTF_ID_SOCK_COMMON, /* pointer to in-kernel sock_common or bpf-mirrored bpf_sock */ 778 ARG_PTR_TO_PERCPU_BTF_ID, /* pointer to in-kernel percpu type */ 779 ARG_PTR_TO_FUNC, /* pointer to a bpf program function */ 780 ARG_PTR_TO_STACK, /* pointer to stack */ 781 ARG_PTR_TO_CONST_STR, /* pointer to a null terminated read-only string */ 782 ARG_PTR_TO_TIMER, /* pointer to bpf_timer */ 783 ARG_KPTR_XCHG_DEST, /* pointer to destination that kptrs are bpf_kptr_xchg'd into */ 784 ARG_PTR_TO_DYNPTR, /* pointer to bpf_dynptr. See bpf_type_flag for dynptr type */ 785 __BPF_ARG_TYPE_MAX, 786 787 /* Extended arg_types. */ 788 ARG_PTR_TO_MAP_VALUE_OR_NULL = PTR_MAYBE_NULL | ARG_PTR_TO_MAP_VALUE, 789 ARG_PTR_TO_MEM_OR_NULL = PTR_MAYBE_NULL | ARG_PTR_TO_MEM, 790 ARG_PTR_TO_CTX_OR_NULL = PTR_MAYBE_NULL | ARG_PTR_TO_CTX, 791 ARG_PTR_TO_SOCKET_OR_NULL = PTR_MAYBE_NULL | ARG_PTR_TO_SOCKET, 792 ARG_PTR_TO_STACK_OR_NULL = PTR_MAYBE_NULL | ARG_PTR_TO_STACK, 793 ARG_PTR_TO_BTF_ID_OR_NULL = PTR_MAYBE_NULL | ARG_PTR_TO_BTF_ID, 794 /* Pointer to memory does not need to be initialized, since helper function 795 * fills all bytes or clears them in error case. 796 */ 797 ARG_PTR_TO_UNINIT_MEM = MEM_UNINIT | MEM_WRITE | ARG_PTR_TO_MEM, 798 /* Pointer to valid memory of size known at compile time. */ 799 ARG_PTR_TO_FIXED_SIZE_MEM = MEM_FIXED_SIZE | ARG_PTR_TO_MEM, 800 801 /* This must be the last entry. Its purpose is to ensure the enum is 802 * wide enough to hold the higher bits reserved for bpf_type_flag. 803 */ 804 __BPF_ARG_TYPE_LIMIT = BPF_TYPE_LIMIT, 805 }; 806 static_assert(__BPF_ARG_TYPE_MAX <= BPF_BASE_TYPE_LIMIT); 807 808 /* type of values returned from helper functions */ 809 enum bpf_return_type { 810 RET_INTEGER, /* function returns integer */ 811 RET_VOID, /* function doesn't return anything */ 812 RET_PTR_TO_MAP_VALUE, /* returns a pointer to map elem value */ 813 RET_PTR_TO_SOCKET, /* returns a pointer to a socket */ 814 RET_PTR_TO_TCP_SOCK, /* returns a pointer to a tcp_sock */ 815 RET_PTR_TO_SOCK_COMMON, /* returns a pointer to a sock_common */ 816 RET_PTR_TO_MEM, /* returns a pointer to memory */ 817 RET_PTR_TO_MEM_OR_BTF_ID, /* returns a pointer to a valid memory or a btf_id */ 818 RET_PTR_TO_BTF_ID, /* returns a pointer to a btf_id */ 819 __BPF_RET_TYPE_MAX, 820 821 /* Extended ret_types. */ 822 RET_PTR_TO_MAP_VALUE_OR_NULL = PTR_MAYBE_NULL | RET_PTR_TO_MAP_VALUE, 823 RET_PTR_TO_SOCKET_OR_NULL = PTR_MAYBE_NULL | RET_PTR_TO_SOCKET, 824 RET_PTR_TO_TCP_SOCK_OR_NULL = PTR_MAYBE_NULL | RET_PTR_TO_TCP_SOCK, 825 RET_PTR_TO_SOCK_COMMON_OR_NULL = PTR_MAYBE_NULL | RET_PTR_TO_SOCK_COMMON, 826 RET_PTR_TO_RINGBUF_MEM_OR_NULL = PTR_MAYBE_NULL | MEM_RINGBUF | RET_PTR_TO_MEM, 827 RET_PTR_TO_DYNPTR_MEM_OR_NULL = PTR_MAYBE_NULL | RET_PTR_TO_MEM, 828 RET_PTR_TO_BTF_ID_OR_NULL = PTR_MAYBE_NULL | RET_PTR_TO_BTF_ID, 829 RET_PTR_TO_BTF_ID_TRUSTED = PTR_TRUSTED | RET_PTR_TO_BTF_ID, 830 831 /* This must be the last entry. Its purpose is to ensure the enum is 832 * wide enough to hold the higher bits reserved for bpf_type_flag. 833 */ 834 __BPF_RET_TYPE_LIMIT = BPF_TYPE_LIMIT, 835 }; 836 static_assert(__BPF_RET_TYPE_MAX <= BPF_BASE_TYPE_LIMIT); 837 838 /* eBPF function prototype used by verifier to allow BPF_CALLs from eBPF programs 839 * to in-kernel helper functions and for adjusting imm32 field in BPF_CALL 840 * instructions after verifying 841 */ 842 struct bpf_func_proto { 843 u64 (*func)(u64 r1, u64 r2, u64 r3, u64 r4, u64 r5); 844 bool gpl_only; 845 bool pkt_access; 846 bool might_sleep; 847 /* set to true if helper follows contract for llvm 848 * attribute bpf_fastcall: 849 * - void functions do not scratch r0 850 * - functions taking N arguments scratch only registers r1-rN 851 */ 852 bool allow_fastcall; 853 enum bpf_return_type ret_type; 854 union { 855 struct { 856 enum bpf_arg_type arg1_type; 857 enum bpf_arg_type arg2_type; 858 enum bpf_arg_type arg3_type; 859 enum bpf_arg_type arg4_type; 860 enum bpf_arg_type arg5_type; 861 }; 862 enum bpf_arg_type arg_type[5]; 863 }; 864 union { 865 struct { 866 u32 *arg1_btf_id; 867 u32 *arg2_btf_id; 868 u32 *arg3_btf_id; 869 u32 *arg4_btf_id; 870 u32 *arg5_btf_id; 871 }; 872 u32 *arg_btf_id[5]; 873 struct { 874 size_t arg1_size; 875 size_t arg2_size; 876 size_t arg3_size; 877 size_t arg4_size; 878 size_t arg5_size; 879 }; 880 size_t arg_size[5]; 881 }; 882 int *ret_btf_id; /* return value btf_id */ 883 bool (*allowed)(const struct bpf_prog *prog); 884 }; 885 886 /* bpf_context is intentionally undefined structure. Pointer to bpf_context is 887 * the first argument to eBPF programs. 888 * For socket filters: 'struct bpf_context *' == 'struct sk_buff *' 889 */ 890 struct bpf_context; 891 892 enum bpf_access_type { 893 BPF_READ = 1, 894 BPF_WRITE = 2 895 }; 896 897 /* types of values stored in eBPF registers */ 898 /* Pointer types represent: 899 * pointer 900 * pointer + imm 901 * pointer + (u16) var 902 * pointer + (u16) var + imm 903 * if (range > 0) then [ptr, ptr + range - off) is safe to access 904 * if (id > 0) means that some 'var' was added 905 * if (off > 0) means that 'imm' was added 906 */ 907 enum bpf_reg_type { 908 NOT_INIT = 0, /* nothing was written into register */ 909 SCALAR_VALUE, /* reg doesn't contain a valid pointer */ 910 PTR_TO_CTX, /* reg points to bpf_context */ 911 CONST_PTR_TO_MAP, /* reg points to struct bpf_map */ 912 PTR_TO_MAP_VALUE, /* reg points to map element value */ 913 PTR_TO_MAP_KEY, /* reg points to a map element key */ 914 PTR_TO_STACK, /* reg == frame_pointer + offset */ 915 PTR_TO_PACKET_META, /* skb->data - meta_len */ 916 PTR_TO_PACKET, /* reg points to skb->data */ 917 PTR_TO_PACKET_END, /* skb->data + headlen */ 918 PTR_TO_FLOW_KEYS, /* reg points to bpf_flow_keys */ 919 PTR_TO_SOCKET, /* reg points to struct bpf_sock */ 920 PTR_TO_SOCK_COMMON, /* reg points to sock_common */ 921 PTR_TO_TCP_SOCK, /* reg points to struct tcp_sock */ 922 PTR_TO_TP_BUFFER, /* reg points to a writable raw tp's buffer */ 923 PTR_TO_XDP_SOCK, /* reg points to struct xdp_sock */ 924 /* PTR_TO_BTF_ID points to a kernel struct that does not need 925 * to be null checked by the BPF program. This does not imply the 926 * pointer is _not_ null and in practice this can easily be a null 927 * pointer when reading pointer chains. The assumption is program 928 * context will handle null pointer dereference typically via fault 929 * handling. The verifier must keep this in mind and can make no 930 * assumptions about null or non-null when doing branch analysis. 931 * Further, when passed into helpers the helpers can not, without 932 * additional context, assume the value is non-null. 933 */ 934 PTR_TO_BTF_ID, 935 PTR_TO_MEM, /* reg points to valid memory region */ 936 PTR_TO_ARENA, 937 PTR_TO_BUF, /* reg points to a read/write buffer */ 938 PTR_TO_FUNC, /* reg points to a bpf program function */ 939 CONST_PTR_TO_DYNPTR, /* reg points to a const struct bpf_dynptr */ 940 __BPF_REG_TYPE_MAX, 941 942 /* Extended reg_types. */ 943 PTR_TO_MAP_VALUE_OR_NULL = PTR_MAYBE_NULL | PTR_TO_MAP_VALUE, 944 PTR_TO_SOCKET_OR_NULL = PTR_MAYBE_NULL | PTR_TO_SOCKET, 945 PTR_TO_SOCK_COMMON_OR_NULL = PTR_MAYBE_NULL | PTR_TO_SOCK_COMMON, 946 PTR_TO_TCP_SOCK_OR_NULL = PTR_MAYBE_NULL | PTR_TO_TCP_SOCK, 947 /* PTR_TO_BTF_ID_OR_NULL points to a kernel struct that has not 948 * been checked for null. Used primarily to inform the verifier 949 * an explicit null check is required for this struct. 950 */ 951 PTR_TO_BTF_ID_OR_NULL = PTR_MAYBE_NULL | PTR_TO_BTF_ID, 952 953 /* This must be the last entry. Its purpose is to ensure the enum is 954 * wide enough to hold the higher bits reserved for bpf_type_flag. 955 */ 956 __BPF_REG_TYPE_LIMIT = BPF_TYPE_LIMIT, 957 }; 958 static_assert(__BPF_REG_TYPE_MAX <= BPF_BASE_TYPE_LIMIT); 959 960 /* The information passed from prog-specific *_is_valid_access 961 * back to the verifier. 962 */ 963 struct bpf_insn_access_aux { 964 enum bpf_reg_type reg_type; 965 bool is_ldsx; 966 union { 967 int ctx_field_size; 968 struct { 969 struct btf *btf; 970 u32 btf_id; 971 u32 ref_obj_id; 972 }; 973 }; 974 struct bpf_verifier_log *log; /* for verbose logs */ 975 bool is_retval; /* is accessing function return value ? */ 976 }; 977 978 static inline void 979 bpf_ctx_record_field_size(struct bpf_insn_access_aux *aux, u32 size) 980 { 981 aux->ctx_field_size = size; 982 } 983 984 static bool bpf_is_ldimm64(const struct bpf_insn *insn) 985 { 986 return insn->code == (BPF_LD | BPF_IMM | BPF_DW); 987 } 988 989 static inline bool bpf_pseudo_func(const struct bpf_insn *insn) 990 { 991 return bpf_is_ldimm64(insn) && insn->src_reg == BPF_PSEUDO_FUNC; 992 } 993 994 struct bpf_prog_ops { 995 int (*test_run)(struct bpf_prog *prog, const union bpf_attr *kattr, 996 union bpf_attr __user *uattr); 997 }; 998 999 struct bpf_reg_state; 1000 struct bpf_verifier_ops { 1001 /* return eBPF function prototype for verification */ 1002 const struct bpf_func_proto * 1003 (*get_func_proto)(enum bpf_func_id func_id, 1004 const struct bpf_prog *prog); 1005 1006 /* return true if 'size' wide access at offset 'off' within bpf_context 1007 * with 'type' (read or write) is allowed 1008 */ 1009 bool (*is_valid_access)(int off, int size, enum bpf_access_type type, 1010 const struct bpf_prog *prog, 1011 struct bpf_insn_access_aux *info); 1012 int (*gen_prologue)(struct bpf_insn *insn, bool direct_write, 1013 const struct bpf_prog *prog); 1014 int (*gen_epilogue)(struct bpf_insn *insn, const struct bpf_prog *prog, 1015 s16 ctx_stack_off); 1016 int (*gen_ld_abs)(const struct bpf_insn *orig, 1017 struct bpf_insn *insn_buf); 1018 u32 (*convert_ctx_access)(enum bpf_access_type type, 1019 const struct bpf_insn *src, 1020 struct bpf_insn *dst, 1021 struct bpf_prog *prog, u32 *target_size); 1022 int (*btf_struct_access)(struct bpf_verifier_log *log, 1023 const struct bpf_reg_state *reg, 1024 int off, int size); 1025 }; 1026 1027 struct bpf_prog_offload_ops { 1028 /* verifier basic callbacks */ 1029 int (*insn_hook)(struct bpf_verifier_env *env, 1030 int insn_idx, int prev_insn_idx); 1031 int (*finalize)(struct bpf_verifier_env *env); 1032 /* verifier optimization callbacks (called after .finalize) */ 1033 int (*replace_insn)(struct bpf_verifier_env *env, u32 off, 1034 struct bpf_insn *insn); 1035 int (*remove_insns)(struct bpf_verifier_env *env, u32 off, u32 cnt); 1036 /* program management callbacks */ 1037 int (*prepare)(struct bpf_prog *prog); 1038 int (*translate)(struct bpf_prog *prog); 1039 void (*destroy)(struct bpf_prog *prog); 1040 }; 1041 1042 struct bpf_prog_offload { 1043 struct bpf_prog *prog; 1044 struct net_device *netdev; 1045 struct bpf_offload_dev *offdev; 1046 void *dev_priv; 1047 struct list_head offloads; 1048 bool dev_state; 1049 bool opt_failed; 1050 void *jited_image; 1051 u32 jited_len; 1052 }; 1053 1054 enum bpf_cgroup_storage_type { 1055 BPF_CGROUP_STORAGE_SHARED, 1056 BPF_CGROUP_STORAGE_PERCPU, 1057 __BPF_CGROUP_STORAGE_MAX 1058 }; 1059 1060 #define MAX_BPF_CGROUP_STORAGE_TYPE __BPF_CGROUP_STORAGE_MAX 1061 1062 /* The longest tracepoint has 12 args. 1063 * See include/trace/bpf_probe.h 1064 */ 1065 #define MAX_BPF_FUNC_ARGS 12 1066 1067 /* The maximum number of arguments passed through registers 1068 * a single function may have. 1069 */ 1070 #define MAX_BPF_FUNC_REG_ARGS 5 1071 1072 /* The argument is a structure. */ 1073 #define BTF_FMODEL_STRUCT_ARG BIT(0) 1074 1075 /* The argument is signed. */ 1076 #define BTF_FMODEL_SIGNED_ARG BIT(1) 1077 1078 struct btf_func_model { 1079 u8 ret_size; 1080 u8 ret_flags; 1081 u8 nr_args; 1082 u8 arg_size[MAX_BPF_FUNC_ARGS]; 1083 u8 arg_flags[MAX_BPF_FUNC_ARGS]; 1084 }; 1085 1086 /* Restore arguments before returning from trampoline to let original function 1087 * continue executing. This flag is used for fentry progs when there are no 1088 * fexit progs. 1089 */ 1090 #define BPF_TRAMP_F_RESTORE_REGS BIT(0) 1091 /* Call original function after fentry progs, but before fexit progs. 1092 * Makes sense for fentry/fexit, normal calls and indirect calls. 1093 */ 1094 #define BPF_TRAMP_F_CALL_ORIG BIT(1) 1095 /* Skip current frame and return to parent. Makes sense for fentry/fexit 1096 * programs only. Should not be used with normal calls and indirect calls. 1097 */ 1098 #define BPF_TRAMP_F_SKIP_FRAME BIT(2) 1099 /* Store IP address of the caller on the trampoline stack, 1100 * so it's available for trampoline's programs. 1101 */ 1102 #define BPF_TRAMP_F_IP_ARG BIT(3) 1103 /* Return the return value of fentry prog. Only used by bpf_struct_ops. */ 1104 #define BPF_TRAMP_F_RET_FENTRY_RET BIT(4) 1105 1106 /* Get original function from stack instead of from provided direct address. 1107 * Makes sense for trampolines with fexit or fmod_ret programs. 1108 */ 1109 #define BPF_TRAMP_F_ORIG_STACK BIT(5) 1110 1111 /* This trampoline is on a function with another ftrace_ops with IPMODIFY, 1112 * e.g., a live patch. This flag is set and cleared by ftrace call backs, 1113 */ 1114 #define BPF_TRAMP_F_SHARE_IPMODIFY BIT(6) 1115 1116 /* Indicate that current trampoline is in a tail call context. Then, it has to 1117 * cache and restore tail_call_cnt to avoid infinite tail call loop. 1118 */ 1119 #define BPF_TRAMP_F_TAIL_CALL_CTX BIT(7) 1120 1121 /* 1122 * Indicate the trampoline should be suitable to receive indirect calls; 1123 * without this indirectly calling the generated code can result in #UD/#CP, 1124 * depending on the CFI options. 1125 * 1126 * Used by bpf_struct_ops. 1127 * 1128 * Incompatible with FENTRY usage, overloads @func_addr argument. 1129 */ 1130 #define BPF_TRAMP_F_INDIRECT BIT(8) 1131 1132 /* Each call __bpf_prog_enter + call bpf_func + call __bpf_prog_exit is ~50 1133 * bytes on x86. 1134 */ 1135 enum { 1136 #if defined(__s390x__) 1137 BPF_MAX_TRAMP_LINKS = 27, 1138 #else 1139 BPF_MAX_TRAMP_LINKS = 38, 1140 #endif 1141 }; 1142 1143 struct bpf_tramp_links { 1144 struct bpf_tramp_link *links[BPF_MAX_TRAMP_LINKS]; 1145 int nr_links; 1146 }; 1147 1148 struct bpf_tramp_run_ctx; 1149 1150 /* Different use cases for BPF trampoline: 1151 * 1. replace nop at the function entry (kprobe equivalent) 1152 * flags = BPF_TRAMP_F_RESTORE_REGS 1153 * fentry = a set of programs to run before returning from trampoline 1154 * 1155 * 2. replace nop at the function entry (kprobe + kretprobe equivalent) 1156 * flags = BPF_TRAMP_F_CALL_ORIG | BPF_TRAMP_F_SKIP_FRAME 1157 * orig_call = fentry_ip + MCOUNT_INSN_SIZE 1158 * fentry = a set of program to run before calling original function 1159 * fexit = a set of program to run after original function 1160 * 1161 * 3. replace direct call instruction anywhere in the function body 1162 * or assign a function pointer for indirect call (like tcp_congestion_ops->cong_avoid) 1163 * With flags = 0 1164 * fentry = a set of programs to run before returning from trampoline 1165 * With flags = BPF_TRAMP_F_CALL_ORIG 1166 * orig_call = original callback addr or direct function addr 1167 * fentry = a set of program to run before calling original function 1168 * fexit = a set of program to run after original function 1169 */ 1170 struct bpf_tramp_image; 1171 int arch_prepare_bpf_trampoline(struct bpf_tramp_image *im, void *image, void *image_end, 1172 const struct btf_func_model *m, u32 flags, 1173 struct bpf_tramp_links *tlinks, 1174 void *func_addr); 1175 void *arch_alloc_bpf_trampoline(unsigned int size); 1176 void arch_free_bpf_trampoline(void *image, unsigned int size); 1177 int __must_check arch_protect_bpf_trampoline(void *image, unsigned int size); 1178 int arch_bpf_trampoline_size(const struct btf_func_model *m, u32 flags, 1179 struct bpf_tramp_links *tlinks, void *func_addr); 1180 1181 u64 notrace __bpf_prog_enter_sleepable_recur(struct bpf_prog *prog, 1182 struct bpf_tramp_run_ctx *run_ctx); 1183 void notrace __bpf_prog_exit_sleepable_recur(struct bpf_prog *prog, u64 start, 1184 struct bpf_tramp_run_ctx *run_ctx); 1185 void notrace __bpf_tramp_enter(struct bpf_tramp_image *tr); 1186 void notrace __bpf_tramp_exit(struct bpf_tramp_image *tr); 1187 typedef u64 (*bpf_trampoline_enter_t)(struct bpf_prog *prog, 1188 struct bpf_tramp_run_ctx *run_ctx); 1189 typedef void (*bpf_trampoline_exit_t)(struct bpf_prog *prog, u64 start, 1190 struct bpf_tramp_run_ctx *run_ctx); 1191 bpf_trampoline_enter_t bpf_trampoline_enter(const struct bpf_prog *prog); 1192 bpf_trampoline_exit_t bpf_trampoline_exit(const struct bpf_prog *prog); 1193 1194 struct bpf_ksym { 1195 unsigned long start; 1196 unsigned long end; 1197 char name[KSYM_NAME_LEN]; 1198 struct list_head lnode; 1199 struct latch_tree_node tnode; 1200 bool prog; 1201 }; 1202 1203 enum bpf_tramp_prog_type { 1204 BPF_TRAMP_FENTRY, 1205 BPF_TRAMP_FEXIT, 1206 BPF_TRAMP_MODIFY_RETURN, 1207 BPF_TRAMP_MAX, 1208 BPF_TRAMP_REPLACE, /* more than MAX */ 1209 }; 1210 1211 struct bpf_tramp_image { 1212 void *image; 1213 int size; 1214 struct bpf_ksym ksym; 1215 struct percpu_ref pcref; 1216 void *ip_after_call; 1217 void *ip_epilogue; 1218 union { 1219 struct rcu_head rcu; 1220 struct work_struct work; 1221 }; 1222 }; 1223 1224 struct bpf_trampoline { 1225 /* hlist for trampoline_table */ 1226 struct hlist_node hlist; 1227 struct ftrace_ops *fops; 1228 /* serializes access to fields of this trampoline */ 1229 struct mutex mutex; 1230 refcount_t refcnt; 1231 u32 flags; 1232 u64 key; 1233 struct { 1234 struct btf_func_model model; 1235 void *addr; 1236 bool ftrace_managed; 1237 } func; 1238 /* if !NULL this is BPF_PROG_TYPE_EXT program that extends another BPF 1239 * program by replacing one of its functions. func.addr is the address 1240 * of the function it replaced. 1241 */ 1242 struct bpf_prog *extension_prog; 1243 /* list of BPF programs using this trampoline */ 1244 struct hlist_head progs_hlist[BPF_TRAMP_MAX]; 1245 /* Number of attached programs. A counter per kind. */ 1246 int progs_cnt[BPF_TRAMP_MAX]; 1247 /* Executable image of trampoline */ 1248 struct bpf_tramp_image *cur_image; 1249 }; 1250 1251 struct bpf_attach_target_info { 1252 struct btf_func_model fmodel; 1253 long tgt_addr; 1254 struct module *tgt_mod; 1255 const char *tgt_name; 1256 const struct btf_type *tgt_type; 1257 }; 1258 1259 #define BPF_DISPATCHER_MAX 48 /* Fits in 2048B */ 1260 1261 struct bpf_dispatcher_prog { 1262 struct bpf_prog *prog; 1263 refcount_t users; 1264 }; 1265 1266 struct bpf_dispatcher { 1267 /* dispatcher mutex */ 1268 struct mutex mutex; 1269 void *func; 1270 struct bpf_dispatcher_prog progs[BPF_DISPATCHER_MAX]; 1271 int num_progs; 1272 void *image; 1273 void *rw_image; 1274 u32 image_off; 1275 struct bpf_ksym ksym; 1276 #ifdef CONFIG_HAVE_STATIC_CALL 1277 struct static_call_key *sc_key; 1278 void *sc_tramp; 1279 #endif 1280 }; 1281 1282 #ifndef __bpfcall 1283 #define __bpfcall __nocfi 1284 #endif 1285 1286 static __always_inline __bpfcall unsigned int bpf_dispatcher_nop_func( 1287 const void *ctx, 1288 const struct bpf_insn *insnsi, 1289 bpf_func_t bpf_func) 1290 { 1291 return bpf_func(ctx, insnsi); 1292 } 1293 1294 /* the implementation of the opaque uapi struct bpf_dynptr */ 1295 struct bpf_dynptr_kern { 1296 void *data; 1297 /* Size represents the number of usable bytes of dynptr data. 1298 * If for example the offset is at 4 for a local dynptr whose data is 1299 * of type u64, the number of usable bytes is 4. 1300 * 1301 * The upper 8 bits are reserved. It is as follows: 1302 * Bits 0 - 23 = size 1303 * Bits 24 - 30 = dynptr type 1304 * Bit 31 = whether dynptr is read-only 1305 */ 1306 u32 size; 1307 u32 offset; 1308 } __aligned(8); 1309 1310 enum bpf_dynptr_type { 1311 BPF_DYNPTR_TYPE_INVALID, 1312 /* Points to memory that is local to the bpf program */ 1313 BPF_DYNPTR_TYPE_LOCAL, 1314 /* Underlying data is a ringbuf record */ 1315 BPF_DYNPTR_TYPE_RINGBUF, 1316 /* Underlying data is a sk_buff */ 1317 BPF_DYNPTR_TYPE_SKB, 1318 /* Underlying data is a xdp_buff */ 1319 BPF_DYNPTR_TYPE_XDP, 1320 }; 1321 1322 int bpf_dynptr_check_size(u32 size); 1323 u32 __bpf_dynptr_size(const struct bpf_dynptr_kern *ptr); 1324 const void *__bpf_dynptr_data(const struct bpf_dynptr_kern *ptr, u32 len); 1325 void *__bpf_dynptr_data_rw(const struct bpf_dynptr_kern *ptr, u32 len); 1326 bool __bpf_dynptr_is_rdonly(const struct bpf_dynptr_kern *ptr); 1327 1328 #ifdef CONFIG_BPF_JIT 1329 int bpf_trampoline_link_prog(struct bpf_tramp_link *link, 1330 struct bpf_trampoline *tr, 1331 struct bpf_prog *tgt_prog); 1332 int bpf_trampoline_unlink_prog(struct bpf_tramp_link *link, 1333 struct bpf_trampoline *tr, 1334 struct bpf_prog *tgt_prog); 1335 struct bpf_trampoline *bpf_trampoline_get(u64 key, 1336 struct bpf_attach_target_info *tgt_info); 1337 void bpf_trampoline_put(struct bpf_trampoline *tr); 1338 int arch_prepare_bpf_dispatcher(void *image, void *buf, s64 *funcs, int num_funcs); 1339 1340 /* 1341 * When the architecture supports STATIC_CALL replace the bpf_dispatcher_fn 1342 * indirection with a direct call to the bpf program. If the architecture does 1343 * not have STATIC_CALL, avoid a double-indirection. 1344 */ 1345 #ifdef CONFIG_HAVE_STATIC_CALL 1346 1347 #define __BPF_DISPATCHER_SC_INIT(_name) \ 1348 .sc_key = &STATIC_CALL_KEY(_name), \ 1349 .sc_tramp = STATIC_CALL_TRAMP_ADDR(_name), 1350 1351 #define __BPF_DISPATCHER_SC(name) \ 1352 DEFINE_STATIC_CALL(bpf_dispatcher_##name##_call, bpf_dispatcher_nop_func) 1353 1354 #define __BPF_DISPATCHER_CALL(name) \ 1355 static_call(bpf_dispatcher_##name##_call)(ctx, insnsi, bpf_func) 1356 1357 #define __BPF_DISPATCHER_UPDATE(_d, _new) \ 1358 __static_call_update((_d)->sc_key, (_d)->sc_tramp, (_new)) 1359 1360 #else 1361 #define __BPF_DISPATCHER_SC_INIT(name) 1362 #define __BPF_DISPATCHER_SC(name) 1363 #define __BPF_DISPATCHER_CALL(name) bpf_func(ctx, insnsi) 1364 #define __BPF_DISPATCHER_UPDATE(_d, _new) 1365 #endif 1366 1367 #define BPF_DISPATCHER_INIT(_name) { \ 1368 .mutex = __MUTEX_INITIALIZER(_name.mutex), \ 1369 .func = &_name##_func, \ 1370 .progs = {}, \ 1371 .num_progs = 0, \ 1372 .image = NULL, \ 1373 .image_off = 0, \ 1374 .ksym = { \ 1375 .name = #_name, \ 1376 .lnode = LIST_HEAD_INIT(_name.ksym.lnode), \ 1377 }, \ 1378 __BPF_DISPATCHER_SC_INIT(_name##_call) \ 1379 } 1380 1381 #define DEFINE_BPF_DISPATCHER(name) \ 1382 __BPF_DISPATCHER_SC(name); \ 1383 noinline __bpfcall unsigned int bpf_dispatcher_##name##_func( \ 1384 const void *ctx, \ 1385 const struct bpf_insn *insnsi, \ 1386 bpf_func_t bpf_func) \ 1387 { \ 1388 return __BPF_DISPATCHER_CALL(name); \ 1389 } \ 1390 EXPORT_SYMBOL(bpf_dispatcher_##name##_func); \ 1391 struct bpf_dispatcher bpf_dispatcher_##name = \ 1392 BPF_DISPATCHER_INIT(bpf_dispatcher_##name); 1393 1394 #define DECLARE_BPF_DISPATCHER(name) \ 1395 unsigned int bpf_dispatcher_##name##_func( \ 1396 const void *ctx, \ 1397 const struct bpf_insn *insnsi, \ 1398 bpf_func_t bpf_func); \ 1399 extern struct bpf_dispatcher bpf_dispatcher_##name; 1400 1401 #define BPF_DISPATCHER_FUNC(name) bpf_dispatcher_##name##_func 1402 #define BPF_DISPATCHER_PTR(name) (&bpf_dispatcher_##name) 1403 void bpf_dispatcher_change_prog(struct bpf_dispatcher *d, struct bpf_prog *from, 1404 struct bpf_prog *to); 1405 /* Called only from JIT-enabled code, so there's no need for stubs. */ 1406 void bpf_image_ksym_init(void *data, unsigned int size, struct bpf_ksym *ksym); 1407 void bpf_image_ksym_add(struct bpf_ksym *ksym); 1408 void bpf_image_ksym_del(struct bpf_ksym *ksym); 1409 void bpf_ksym_add(struct bpf_ksym *ksym); 1410 void bpf_ksym_del(struct bpf_ksym *ksym); 1411 int bpf_jit_charge_modmem(u32 size); 1412 void bpf_jit_uncharge_modmem(u32 size); 1413 bool bpf_prog_has_trampoline(const struct bpf_prog *prog); 1414 #else 1415 static inline int bpf_trampoline_link_prog(struct bpf_tramp_link *link, 1416 struct bpf_trampoline *tr, 1417 struct bpf_prog *tgt_prog) 1418 { 1419 return -ENOTSUPP; 1420 } 1421 static inline int bpf_trampoline_unlink_prog(struct bpf_tramp_link *link, 1422 struct bpf_trampoline *tr, 1423 struct bpf_prog *tgt_prog) 1424 { 1425 return -ENOTSUPP; 1426 } 1427 static inline struct bpf_trampoline *bpf_trampoline_get(u64 key, 1428 struct bpf_attach_target_info *tgt_info) 1429 { 1430 return NULL; 1431 } 1432 static inline void bpf_trampoline_put(struct bpf_trampoline *tr) {} 1433 #define DEFINE_BPF_DISPATCHER(name) 1434 #define DECLARE_BPF_DISPATCHER(name) 1435 #define BPF_DISPATCHER_FUNC(name) bpf_dispatcher_nop_func 1436 #define BPF_DISPATCHER_PTR(name) NULL 1437 static inline void bpf_dispatcher_change_prog(struct bpf_dispatcher *d, 1438 struct bpf_prog *from, 1439 struct bpf_prog *to) {} 1440 static inline bool is_bpf_image_address(unsigned long address) 1441 { 1442 return false; 1443 } 1444 static inline bool bpf_prog_has_trampoline(const struct bpf_prog *prog) 1445 { 1446 return false; 1447 } 1448 #endif 1449 1450 struct bpf_func_info_aux { 1451 u16 linkage; 1452 bool unreliable; 1453 bool called : 1; 1454 bool verified : 1; 1455 }; 1456 1457 enum bpf_jit_poke_reason { 1458 BPF_POKE_REASON_TAIL_CALL, 1459 }; 1460 1461 /* Descriptor of pokes pointing /into/ the JITed image. */ 1462 struct bpf_jit_poke_descriptor { 1463 void *tailcall_target; 1464 void *tailcall_bypass; 1465 void *bypass_addr; 1466 void *aux; 1467 union { 1468 struct { 1469 struct bpf_map *map; 1470 u32 key; 1471 } tail_call; 1472 }; 1473 bool tailcall_target_stable; 1474 u8 adj_off; 1475 u16 reason; 1476 u32 insn_idx; 1477 }; 1478 1479 /* reg_type info for ctx arguments */ 1480 struct bpf_ctx_arg_aux { 1481 u32 offset; 1482 enum bpf_reg_type reg_type; 1483 struct btf *btf; 1484 u32 btf_id; 1485 u32 ref_obj_id; 1486 bool refcounted; 1487 }; 1488 1489 struct btf_mod_pair { 1490 struct btf *btf; 1491 struct module *module; 1492 }; 1493 1494 struct bpf_kfunc_desc_tab; 1495 1496 struct bpf_prog_aux { 1497 atomic64_t refcnt; 1498 u32 used_map_cnt; 1499 u32 used_btf_cnt; 1500 u32 max_ctx_offset; 1501 u32 max_pkt_offset; 1502 u32 max_tp_access; 1503 u32 stack_depth; 1504 u32 id; 1505 u32 func_cnt; /* used by non-func prog as the number of func progs */ 1506 u32 real_func_cnt; /* includes hidden progs, only used for JIT and freeing progs */ 1507 u32 func_idx; /* 0 for non-func prog, the index in func array for func prog */ 1508 u32 attach_btf_id; /* in-kernel BTF type id to attach to */ 1509 u32 ctx_arg_info_size; 1510 u32 max_rdonly_access; 1511 u32 max_rdwr_access; 1512 struct btf *attach_btf; 1513 struct bpf_ctx_arg_aux *ctx_arg_info; 1514 void __percpu *priv_stack_ptr; 1515 struct mutex dst_mutex; /* protects dst_* pointers below, *after* prog becomes visible */ 1516 struct bpf_prog *dst_prog; 1517 struct bpf_trampoline *dst_trampoline; 1518 enum bpf_prog_type saved_dst_prog_type; 1519 enum bpf_attach_type saved_dst_attach_type; 1520 bool verifier_zext; /* Zero extensions has been inserted by verifier. */ 1521 bool dev_bound; /* Program is bound to the netdev. */ 1522 bool offload_requested; /* Program is bound and offloaded to the netdev. */ 1523 bool attach_btf_trace; /* true if attaching to BTF-enabled raw tp */ 1524 bool attach_tracing_prog; /* true if tracing another tracing program */ 1525 bool func_proto_unreliable; 1526 bool tail_call_reachable; 1527 bool xdp_has_frags; 1528 bool exception_cb; 1529 bool exception_boundary; 1530 bool is_extended; /* true if extended by freplace program */ 1531 bool jits_use_priv_stack; 1532 bool priv_stack_requested; 1533 bool changes_pkt_data; 1534 bool might_sleep; 1535 u64 prog_array_member_cnt; /* counts how many times as member of prog_array */ 1536 struct mutex ext_mutex; /* mutex for is_extended and prog_array_member_cnt */ 1537 struct bpf_arena *arena; 1538 void (*recursion_detected)(struct bpf_prog *prog); /* callback if recursion is detected */ 1539 /* BTF_KIND_FUNC_PROTO for valid attach_btf_id */ 1540 const struct btf_type *attach_func_proto; 1541 /* function name for valid attach_btf_id */ 1542 const char *attach_func_name; 1543 struct bpf_prog **func; 1544 void *jit_data; /* JIT specific data. arch dependent */ 1545 struct bpf_jit_poke_descriptor *poke_tab; 1546 struct bpf_kfunc_desc_tab *kfunc_tab; 1547 struct bpf_kfunc_btf_tab *kfunc_btf_tab; 1548 u32 size_poke_tab; 1549 #ifdef CONFIG_FINEIBT 1550 struct bpf_ksym ksym_prefix; 1551 #endif 1552 struct bpf_ksym ksym; 1553 const struct bpf_prog_ops *ops; 1554 struct bpf_map **used_maps; 1555 struct mutex used_maps_mutex; /* mutex for used_maps and used_map_cnt */ 1556 struct btf_mod_pair *used_btfs; 1557 struct bpf_prog *prog; 1558 struct user_struct *user; 1559 u64 load_time; /* ns since boottime */ 1560 u32 verified_insns; 1561 int cgroup_atype; /* enum cgroup_bpf_attach_type */ 1562 struct bpf_map *cgroup_storage[MAX_BPF_CGROUP_STORAGE_TYPE]; 1563 char name[BPF_OBJ_NAME_LEN]; 1564 u64 (*bpf_exception_cb)(u64 cookie, u64 sp, u64 bp, u64, u64); 1565 #ifdef CONFIG_SECURITY 1566 void *security; 1567 #endif 1568 struct bpf_token *token; 1569 struct bpf_prog_offload *offload; 1570 struct btf *btf; 1571 struct bpf_func_info *func_info; 1572 struct bpf_func_info_aux *func_info_aux; 1573 /* bpf_line_info loaded from userspace. linfo->insn_off 1574 * has the xlated insn offset. 1575 * Both the main and sub prog share the same linfo. 1576 * The subprog can access its first linfo by 1577 * using the linfo_idx. 1578 */ 1579 struct bpf_line_info *linfo; 1580 /* jited_linfo is the jited addr of the linfo. It has a 1581 * one to one mapping to linfo: 1582 * jited_linfo[i] is the jited addr for the linfo[i]->insn_off. 1583 * Both the main and sub prog share the same jited_linfo. 1584 * The subprog can access its first jited_linfo by 1585 * using the linfo_idx. 1586 */ 1587 void **jited_linfo; 1588 u32 func_info_cnt; 1589 u32 nr_linfo; 1590 /* subprog can use linfo_idx to access its first linfo and 1591 * jited_linfo. 1592 * main prog always has linfo_idx == 0 1593 */ 1594 u32 linfo_idx; 1595 struct module *mod; 1596 u32 num_exentries; 1597 struct exception_table_entry *extable; 1598 union { 1599 struct work_struct work; 1600 struct rcu_head rcu; 1601 }; 1602 }; 1603 1604 struct bpf_prog { 1605 u16 pages; /* Number of allocated pages */ 1606 u16 jited:1, /* Is our filter JIT'ed? */ 1607 jit_requested:1,/* archs need to JIT the prog */ 1608 gpl_compatible:1, /* Is filter GPL compatible? */ 1609 cb_access:1, /* Is control block accessed? */ 1610 dst_needed:1, /* Do we need dst entry? */ 1611 blinding_requested:1, /* needs constant blinding */ 1612 blinded:1, /* Was blinded */ 1613 is_func:1, /* program is a bpf function */ 1614 kprobe_override:1, /* Do we override a kprobe? */ 1615 has_callchain_buf:1, /* callchain buffer allocated? */ 1616 enforce_expected_attach_type:1, /* Enforce expected_attach_type checking at attach time */ 1617 call_get_stack:1, /* Do we call bpf_get_stack() or bpf_get_stackid() */ 1618 call_get_func_ip:1, /* Do we call get_func_ip() */ 1619 tstamp_type_access:1, /* Accessed __sk_buff->tstamp_type */ 1620 sleepable:1; /* BPF program is sleepable */ 1621 enum bpf_prog_type type; /* Type of BPF program */ 1622 enum bpf_attach_type expected_attach_type; /* For some prog types */ 1623 u32 len; /* Number of filter blocks */ 1624 u32 jited_len; /* Size of jited insns in bytes */ 1625 u8 tag[BPF_TAG_SIZE]; 1626 struct bpf_prog_stats __percpu *stats; 1627 int __percpu *active; 1628 unsigned int (*bpf_func)(const void *ctx, 1629 const struct bpf_insn *insn); 1630 struct bpf_prog_aux *aux; /* Auxiliary fields */ 1631 struct sock_fprog_kern *orig_prog; /* Original BPF program */ 1632 /* Instructions for interpreter */ 1633 union { 1634 DECLARE_FLEX_ARRAY(struct sock_filter, insns); 1635 DECLARE_FLEX_ARRAY(struct bpf_insn, insnsi); 1636 }; 1637 }; 1638 1639 struct bpf_array_aux { 1640 /* Programs with direct jumps into programs part of this array. */ 1641 struct list_head poke_progs; 1642 struct bpf_map *map; 1643 struct mutex poke_mutex; 1644 struct work_struct work; 1645 }; 1646 1647 struct bpf_link { 1648 atomic64_t refcnt; 1649 u32 id; 1650 enum bpf_link_type type; 1651 const struct bpf_link_ops *ops; 1652 struct bpf_prog *prog; 1653 /* whether BPF link itself has "sleepable" semantics, which can differ 1654 * from underlying BPF program having a "sleepable" semantics, as BPF 1655 * link's semantics is determined by target attach hook 1656 */ 1657 bool sleepable; 1658 /* rcu is used before freeing, work can be used to schedule that 1659 * RCU-based freeing before that, so they never overlap 1660 */ 1661 union { 1662 struct rcu_head rcu; 1663 struct work_struct work; 1664 }; 1665 }; 1666 1667 struct bpf_link_ops { 1668 void (*release)(struct bpf_link *link); 1669 /* deallocate link resources callback, called without RCU grace period 1670 * waiting 1671 */ 1672 void (*dealloc)(struct bpf_link *link); 1673 /* deallocate link resources callback, called after RCU grace period; 1674 * if either the underlying BPF program is sleepable or BPF link's 1675 * target hook is sleepable, we'll go through tasks trace RCU GP and 1676 * then "classic" RCU GP; this need for chaining tasks trace and 1677 * classic RCU GPs is designated by setting bpf_link->sleepable flag 1678 */ 1679 void (*dealloc_deferred)(struct bpf_link *link); 1680 int (*detach)(struct bpf_link *link); 1681 int (*update_prog)(struct bpf_link *link, struct bpf_prog *new_prog, 1682 struct bpf_prog *old_prog); 1683 void (*show_fdinfo)(const struct bpf_link *link, struct seq_file *seq); 1684 int (*fill_link_info)(const struct bpf_link *link, 1685 struct bpf_link_info *info); 1686 int (*update_map)(struct bpf_link *link, struct bpf_map *new_map, 1687 struct bpf_map *old_map); 1688 __poll_t (*poll)(struct file *file, struct poll_table_struct *pts); 1689 }; 1690 1691 struct bpf_tramp_link { 1692 struct bpf_link link; 1693 struct hlist_node tramp_hlist; 1694 u64 cookie; 1695 }; 1696 1697 struct bpf_shim_tramp_link { 1698 struct bpf_tramp_link link; 1699 struct bpf_trampoline *trampoline; 1700 }; 1701 1702 struct bpf_tracing_link { 1703 struct bpf_tramp_link link; 1704 enum bpf_attach_type attach_type; 1705 struct bpf_trampoline *trampoline; 1706 struct bpf_prog *tgt_prog; 1707 }; 1708 1709 struct bpf_raw_tp_link { 1710 struct bpf_link link; 1711 struct bpf_raw_event_map *btp; 1712 u64 cookie; 1713 }; 1714 1715 struct bpf_link_primer { 1716 struct bpf_link *link; 1717 struct file *file; 1718 int fd; 1719 u32 id; 1720 }; 1721 1722 struct bpf_mount_opts { 1723 kuid_t uid; 1724 kgid_t gid; 1725 umode_t mode; 1726 1727 /* BPF token-related delegation options */ 1728 u64 delegate_cmds; 1729 u64 delegate_maps; 1730 u64 delegate_progs; 1731 u64 delegate_attachs; 1732 }; 1733 1734 struct bpf_token { 1735 struct work_struct work; 1736 atomic64_t refcnt; 1737 struct user_namespace *userns; 1738 u64 allowed_cmds; 1739 u64 allowed_maps; 1740 u64 allowed_progs; 1741 u64 allowed_attachs; 1742 #ifdef CONFIG_SECURITY 1743 void *security; 1744 #endif 1745 }; 1746 1747 struct bpf_struct_ops_value; 1748 struct btf_member; 1749 1750 #define BPF_STRUCT_OPS_MAX_NR_MEMBERS 64 1751 /** 1752 * struct bpf_struct_ops - A structure of callbacks allowing a subsystem to 1753 * define a BPF_MAP_TYPE_STRUCT_OPS map type composed 1754 * of BPF_PROG_TYPE_STRUCT_OPS progs. 1755 * @verifier_ops: A structure of callbacks that are invoked by the verifier 1756 * when determining whether the struct_ops progs in the 1757 * struct_ops map are valid. 1758 * @init: A callback that is invoked a single time, and before any other 1759 * callback, to initialize the structure. A nonzero return value means 1760 * the subsystem could not be initialized. 1761 * @check_member: When defined, a callback invoked by the verifier to allow 1762 * the subsystem to determine if an entry in the struct_ops map 1763 * is valid. A nonzero return value means that the map is 1764 * invalid and should be rejected by the verifier. 1765 * @init_member: A callback that is invoked for each member of the struct_ops 1766 * map to allow the subsystem to initialize the member. A nonzero 1767 * value means the member could not be initialized. This callback 1768 * is exclusive with the @type, @type_id, @value_type, and 1769 * @value_id fields. 1770 * @reg: A callback that is invoked when the struct_ops map has been 1771 * initialized and is being attached to. Zero means the struct_ops map 1772 * has been successfully registered and is live. A nonzero return value 1773 * means the struct_ops map could not be registered. 1774 * @unreg: A callback that is invoked when the struct_ops map should be 1775 * unregistered. 1776 * @update: A callback that is invoked when the live struct_ops map is being 1777 * updated to contain new values. This callback is only invoked when 1778 * the struct_ops map is loaded with BPF_F_LINK. If not defined, the 1779 * it is assumed that the struct_ops map cannot be updated. 1780 * @validate: A callback that is invoked after all of the members have been 1781 * initialized. This callback should perform static checks on the 1782 * map, meaning that it should either fail or succeed 1783 * deterministically. A struct_ops map that has been validated may 1784 * not necessarily succeed in being registered if the call to @reg 1785 * fails. For example, a valid struct_ops map may be loaded, but 1786 * then fail to be registered due to there being another active 1787 * struct_ops map on the system in the subsystem already. For this 1788 * reason, if this callback is not defined, the check is skipped as 1789 * the struct_ops map will have final verification performed in 1790 * @reg. 1791 * @type: BTF type. 1792 * @value_type: Value type. 1793 * @name: The name of the struct bpf_struct_ops object. 1794 * @func_models: Func models 1795 * @type_id: BTF type id. 1796 * @value_id: BTF value id. 1797 */ 1798 struct bpf_struct_ops { 1799 const struct bpf_verifier_ops *verifier_ops; 1800 int (*init)(struct btf *btf); 1801 int (*check_member)(const struct btf_type *t, 1802 const struct btf_member *member, 1803 const struct bpf_prog *prog); 1804 int (*init_member)(const struct btf_type *t, 1805 const struct btf_member *member, 1806 void *kdata, const void *udata); 1807 int (*reg)(void *kdata, struct bpf_link *link); 1808 void (*unreg)(void *kdata, struct bpf_link *link); 1809 int (*update)(void *kdata, void *old_kdata, struct bpf_link *link); 1810 int (*validate)(void *kdata); 1811 void *cfi_stubs; 1812 struct module *owner; 1813 const char *name; 1814 struct btf_func_model func_models[BPF_STRUCT_OPS_MAX_NR_MEMBERS]; 1815 }; 1816 1817 /* Every member of a struct_ops type has an instance even a member is not 1818 * an operator (function pointer). The "info" field will be assigned to 1819 * prog->aux->ctx_arg_info of BPF struct_ops programs to provide the 1820 * argument information required by the verifier to verify the program. 1821 * 1822 * btf_ctx_access() will lookup prog->aux->ctx_arg_info to find the 1823 * corresponding entry for an given argument. 1824 */ 1825 struct bpf_struct_ops_arg_info { 1826 struct bpf_ctx_arg_aux *info; 1827 u32 cnt; 1828 }; 1829 1830 struct bpf_struct_ops_desc { 1831 struct bpf_struct_ops *st_ops; 1832 1833 const struct btf_type *type; 1834 const struct btf_type *value_type; 1835 u32 type_id; 1836 u32 value_id; 1837 1838 /* Collection of argument information for each member */ 1839 struct bpf_struct_ops_arg_info *arg_info; 1840 }; 1841 1842 enum bpf_struct_ops_state { 1843 BPF_STRUCT_OPS_STATE_INIT, 1844 BPF_STRUCT_OPS_STATE_INUSE, 1845 BPF_STRUCT_OPS_STATE_TOBEFREE, 1846 BPF_STRUCT_OPS_STATE_READY, 1847 }; 1848 1849 struct bpf_struct_ops_common_value { 1850 refcount_t refcnt; 1851 enum bpf_struct_ops_state state; 1852 }; 1853 1854 #if defined(CONFIG_BPF_JIT) && defined(CONFIG_BPF_SYSCALL) 1855 /* This macro helps developer to register a struct_ops type and generate 1856 * type information correctly. Developers should use this macro to register 1857 * a struct_ops type instead of calling __register_bpf_struct_ops() directly. 1858 */ 1859 #define register_bpf_struct_ops(st_ops, type) \ 1860 ({ \ 1861 struct bpf_struct_ops_##type { \ 1862 struct bpf_struct_ops_common_value common; \ 1863 struct type data ____cacheline_aligned_in_smp; \ 1864 }; \ 1865 BTF_TYPE_EMIT(struct bpf_struct_ops_##type); \ 1866 __register_bpf_struct_ops(st_ops); \ 1867 }) 1868 #define BPF_MODULE_OWNER ((void *)((0xeB9FUL << 2) + POISON_POINTER_DELTA)) 1869 bool bpf_struct_ops_get(const void *kdata); 1870 void bpf_struct_ops_put(const void *kdata); 1871 int bpf_struct_ops_supported(const struct bpf_struct_ops *st_ops, u32 moff); 1872 int bpf_struct_ops_map_sys_lookup_elem(struct bpf_map *map, void *key, 1873 void *value); 1874 int bpf_struct_ops_prepare_trampoline(struct bpf_tramp_links *tlinks, 1875 struct bpf_tramp_link *link, 1876 const struct btf_func_model *model, 1877 void *stub_func, 1878 void **image, u32 *image_off, 1879 bool allow_alloc); 1880 void bpf_struct_ops_image_free(void *image); 1881 static inline bool bpf_try_module_get(const void *data, struct module *owner) 1882 { 1883 if (owner == BPF_MODULE_OWNER) 1884 return bpf_struct_ops_get(data); 1885 else 1886 return try_module_get(owner); 1887 } 1888 static inline void bpf_module_put(const void *data, struct module *owner) 1889 { 1890 if (owner == BPF_MODULE_OWNER) 1891 bpf_struct_ops_put(data); 1892 else 1893 module_put(owner); 1894 } 1895 int bpf_struct_ops_link_create(union bpf_attr *attr); 1896 1897 #ifdef CONFIG_NET 1898 /* Define it here to avoid the use of forward declaration */ 1899 struct bpf_dummy_ops_state { 1900 int val; 1901 }; 1902 1903 struct bpf_dummy_ops { 1904 int (*test_1)(struct bpf_dummy_ops_state *cb); 1905 int (*test_2)(struct bpf_dummy_ops_state *cb, int a1, unsigned short a2, 1906 char a3, unsigned long a4); 1907 int (*test_sleepable)(struct bpf_dummy_ops_state *cb); 1908 }; 1909 1910 int bpf_struct_ops_test_run(struct bpf_prog *prog, const union bpf_attr *kattr, 1911 union bpf_attr __user *uattr); 1912 #endif 1913 int bpf_struct_ops_desc_init(struct bpf_struct_ops_desc *st_ops_desc, 1914 struct btf *btf, 1915 struct bpf_verifier_log *log); 1916 void bpf_map_struct_ops_info_fill(struct bpf_map_info *info, struct bpf_map *map); 1917 void bpf_struct_ops_desc_release(struct bpf_struct_ops_desc *st_ops_desc); 1918 #else 1919 #define register_bpf_struct_ops(st_ops, type) ({ (void *)(st_ops); 0; }) 1920 static inline bool bpf_try_module_get(const void *data, struct module *owner) 1921 { 1922 return try_module_get(owner); 1923 } 1924 static inline void bpf_module_put(const void *data, struct module *owner) 1925 { 1926 module_put(owner); 1927 } 1928 static inline int bpf_struct_ops_supported(const struct bpf_struct_ops *st_ops, u32 moff) 1929 { 1930 return -ENOTSUPP; 1931 } 1932 static inline int bpf_struct_ops_map_sys_lookup_elem(struct bpf_map *map, 1933 void *key, 1934 void *value) 1935 { 1936 return -EINVAL; 1937 } 1938 static inline int bpf_struct_ops_link_create(union bpf_attr *attr) 1939 { 1940 return -EOPNOTSUPP; 1941 } 1942 static inline void bpf_map_struct_ops_info_fill(struct bpf_map_info *info, struct bpf_map *map) 1943 { 1944 } 1945 1946 static inline void bpf_struct_ops_desc_release(struct bpf_struct_ops_desc *st_ops_desc) 1947 { 1948 } 1949 1950 #endif 1951 1952 int bpf_prog_ctx_arg_info_init(struct bpf_prog *prog, 1953 const struct bpf_ctx_arg_aux *info, u32 cnt); 1954 1955 #if defined(CONFIG_CGROUP_BPF) && defined(CONFIG_BPF_LSM) 1956 int bpf_trampoline_link_cgroup_shim(struct bpf_prog *prog, 1957 int cgroup_atype); 1958 void bpf_trampoline_unlink_cgroup_shim(struct bpf_prog *prog); 1959 #else 1960 static inline int bpf_trampoline_link_cgroup_shim(struct bpf_prog *prog, 1961 int cgroup_atype) 1962 { 1963 return -EOPNOTSUPP; 1964 } 1965 static inline void bpf_trampoline_unlink_cgroup_shim(struct bpf_prog *prog) 1966 { 1967 } 1968 #endif 1969 1970 struct bpf_array { 1971 struct bpf_map map; 1972 u32 elem_size; 1973 u32 index_mask; 1974 struct bpf_array_aux *aux; 1975 union { 1976 DECLARE_FLEX_ARRAY(char, value) __aligned(8); 1977 DECLARE_FLEX_ARRAY(void *, ptrs) __aligned(8); 1978 DECLARE_FLEX_ARRAY(void __percpu *, pptrs) __aligned(8); 1979 }; 1980 }; 1981 1982 #define BPF_COMPLEXITY_LIMIT_INSNS 1000000 /* yes. 1M insns */ 1983 #define MAX_TAIL_CALL_CNT 33 1984 1985 /* Maximum number of loops for bpf_loop and bpf_iter_num. 1986 * It's enum to expose it (and thus make it discoverable) through BTF. 1987 */ 1988 enum { 1989 BPF_MAX_LOOPS = 8 * 1024 * 1024, 1990 }; 1991 1992 #define BPF_F_ACCESS_MASK (BPF_F_RDONLY | \ 1993 BPF_F_RDONLY_PROG | \ 1994 BPF_F_WRONLY | \ 1995 BPF_F_WRONLY_PROG) 1996 1997 #define BPF_MAP_CAN_READ BIT(0) 1998 #define BPF_MAP_CAN_WRITE BIT(1) 1999 2000 /* Maximum number of user-producer ring buffer samples that can be drained in 2001 * a call to bpf_user_ringbuf_drain(). 2002 */ 2003 #define BPF_MAX_USER_RINGBUF_SAMPLES (128 * 1024) 2004 2005 static inline u32 bpf_map_flags_to_cap(struct bpf_map *map) 2006 { 2007 u32 access_flags = map->map_flags & (BPF_F_RDONLY_PROG | BPF_F_WRONLY_PROG); 2008 2009 /* Combination of BPF_F_RDONLY_PROG | BPF_F_WRONLY_PROG is 2010 * not possible. 2011 */ 2012 if (access_flags & BPF_F_RDONLY_PROG) 2013 return BPF_MAP_CAN_READ; 2014 else if (access_flags & BPF_F_WRONLY_PROG) 2015 return BPF_MAP_CAN_WRITE; 2016 else 2017 return BPF_MAP_CAN_READ | BPF_MAP_CAN_WRITE; 2018 } 2019 2020 static inline bool bpf_map_flags_access_ok(u32 access_flags) 2021 { 2022 return (access_flags & (BPF_F_RDONLY_PROG | BPF_F_WRONLY_PROG)) != 2023 (BPF_F_RDONLY_PROG | BPF_F_WRONLY_PROG); 2024 } 2025 2026 struct bpf_event_entry { 2027 struct perf_event *event; 2028 struct file *perf_file; 2029 struct file *map_file; 2030 struct rcu_head rcu; 2031 }; 2032 2033 static inline bool map_type_contains_progs(struct bpf_map *map) 2034 { 2035 return map->map_type == BPF_MAP_TYPE_PROG_ARRAY || 2036 map->map_type == BPF_MAP_TYPE_DEVMAP || 2037 map->map_type == BPF_MAP_TYPE_CPUMAP; 2038 } 2039 2040 bool bpf_prog_map_compatible(struct bpf_map *map, const struct bpf_prog *fp); 2041 int bpf_prog_calc_tag(struct bpf_prog *fp); 2042 2043 const struct bpf_func_proto *bpf_get_trace_printk_proto(void); 2044 const struct bpf_func_proto *bpf_get_trace_vprintk_proto(void); 2045 2046 typedef unsigned long (*bpf_ctx_copy_t)(void *dst, const void *src, 2047 unsigned long off, unsigned long len); 2048 typedef u32 (*bpf_convert_ctx_access_t)(enum bpf_access_type type, 2049 const struct bpf_insn *src, 2050 struct bpf_insn *dst, 2051 struct bpf_prog *prog, 2052 u32 *target_size); 2053 2054 u64 bpf_event_output(struct bpf_map *map, u64 flags, void *meta, u64 meta_size, 2055 void *ctx, u64 ctx_size, bpf_ctx_copy_t ctx_copy); 2056 2057 /* an array of programs to be executed under rcu_lock. 2058 * 2059 * Typical usage: 2060 * ret = bpf_prog_run_array(rcu_dereference(&bpf_prog_array), ctx, bpf_prog_run); 2061 * 2062 * the structure returned by bpf_prog_array_alloc() should be populated 2063 * with program pointers and the last pointer must be NULL. 2064 * The user has to keep refcnt on the program and make sure the program 2065 * is removed from the array before bpf_prog_put(). 2066 * The 'struct bpf_prog_array *' should only be replaced with xchg() 2067 * since other cpus are walking the array of pointers in parallel. 2068 */ 2069 struct bpf_prog_array_item { 2070 struct bpf_prog *prog; 2071 union { 2072 struct bpf_cgroup_storage *cgroup_storage[MAX_BPF_CGROUP_STORAGE_TYPE]; 2073 u64 bpf_cookie; 2074 }; 2075 }; 2076 2077 struct bpf_prog_array { 2078 struct rcu_head rcu; 2079 struct bpf_prog_array_item items[]; 2080 }; 2081 2082 struct bpf_empty_prog_array { 2083 struct bpf_prog_array hdr; 2084 struct bpf_prog *null_prog; 2085 }; 2086 2087 /* to avoid allocating empty bpf_prog_array for cgroups that 2088 * don't have bpf program attached use one global 'bpf_empty_prog_array' 2089 * It will not be modified the caller of bpf_prog_array_alloc() 2090 * (since caller requested prog_cnt == 0) 2091 * that pointer should be 'freed' by bpf_prog_array_free() 2092 */ 2093 extern struct bpf_empty_prog_array bpf_empty_prog_array; 2094 2095 struct bpf_prog_array *bpf_prog_array_alloc(u32 prog_cnt, gfp_t flags); 2096 void bpf_prog_array_free(struct bpf_prog_array *progs); 2097 /* Use when traversal over the bpf_prog_array uses tasks_trace rcu */ 2098 void bpf_prog_array_free_sleepable(struct bpf_prog_array *progs); 2099 int bpf_prog_array_length(struct bpf_prog_array *progs); 2100 bool bpf_prog_array_is_empty(struct bpf_prog_array *array); 2101 int bpf_prog_array_copy_to_user(struct bpf_prog_array *progs, 2102 __u32 __user *prog_ids, u32 cnt); 2103 2104 void bpf_prog_array_delete_safe(struct bpf_prog_array *progs, 2105 struct bpf_prog *old_prog); 2106 int bpf_prog_array_delete_safe_at(struct bpf_prog_array *array, int index); 2107 int bpf_prog_array_update_at(struct bpf_prog_array *array, int index, 2108 struct bpf_prog *prog); 2109 int bpf_prog_array_copy_info(struct bpf_prog_array *array, 2110 u32 *prog_ids, u32 request_cnt, 2111 u32 *prog_cnt); 2112 int bpf_prog_array_copy(struct bpf_prog_array *old_array, 2113 struct bpf_prog *exclude_prog, 2114 struct bpf_prog *include_prog, 2115 u64 bpf_cookie, 2116 struct bpf_prog_array **new_array); 2117 2118 struct bpf_run_ctx {}; 2119 2120 struct bpf_cg_run_ctx { 2121 struct bpf_run_ctx run_ctx; 2122 const struct bpf_prog_array_item *prog_item; 2123 int retval; 2124 }; 2125 2126 struct bpf_trace_run_ctx { 2127 struct bpf_run_ctx run_ctx; 2128 u64 bpf_cookie; 2129 bool is_uprobe; 2130 }; 2131 2132 struct bpf_tramp_run_ctx { 2133 struct bpf_run_ctx run_ctx; 2134 u64 bpf_cookie; 2135 struct bpf_run_ctx *saved_run_ctx; 2136 }; 2137 2138 static inline struct bpf_run_ctx *bpf_set_run_ctx(struct bpf_run_ctx *new_ctx) 2139 { 2140 struct bpf_run_ctx *old_ctx = NULL; 2141 2142 #ifdef CONFIG_BPF_SYSCALL 2143 old_ctx = current->bpf_ctx; 2144 current->bpf_ctx = new_ctx; 2145 #endif 2146 return old_ctx; 2147 } 2148 2149 static inline void bpf_reset_run_ctx(struct bpf_run_ctx *old_ctx) 2150 { 2151 #ifdef CONFIG_BPF_SYSCALL 2152 current->bpf_ctx = old_ctx; 2153 #endif 2154 } 2155 2156 /* BPF program asks to bypass CAP_NET_BIND_SERVICE in bind. */ 2157 #define BPF_RET_BIND_NO_CAP_NET_BIND_SERVICE (1 << 0) 2158 /* BPF program asks to set CN on the packet. */ 2159 #define BPF_RET_SET_CN (1 << 0) 2160 2161 typedef u32 (*bpf_prog_run_fn)(const struct bpf_prog *prog, const void *ctx); 2162 2163 static __always_inline u32 2164 bpf_prog_run_array(const struct bpf_prog_array *array, 2165 const void *ctx, bpf_prog_run_fn run_prog) 2166 { 2167 const struct bpf_prog_array_item *item; 2168 const struct bpf_prog *prog; 2169 struct bpf_run_ctx *old_run_ctx; 2170 struct bpf_trace_run_ctx run_ctx; 2171 u32 ret = 1; 2172 2173 RCU_LOCKDEP_WARN(!rcu_read_lock_held(), "no rcu lock held"); 2174 2175 if (unlikely(!array)) 2176 return ret; 2177 2178 run_ctx.is_uprobe = false; 2179 2180 migrate_disable(); 2181 old_run_ctx = bpf_set_run_ctx(&run_ctx.run_ctx); 2182 item = &array->items[0]; 2183 while ((prog = READ_ONCE(item->prog))) { 2184 run_ctx.bpf_cookie = item->bpf_cookie; 2185 ret &= run_prog(prog, ctx); 2186 item++; 2187 } 2188 bpf_reset_run_ctx(old_run_ctx); 2189 migrate_enable(); 2190 return ret; 2191 } 2192 2193 /* Notes on RCU design for bpf_prog_arrays containing sleepable programs: 2194 * 2195 * We use the tasks_trace rcu flavor read section to protect the bpf_prog_array 2196 * overall. As a result, we must use the bpf_prog_array_free_sleepable 2197 * in order to use the tasks_trace rcu grace period. 2198 * 2199 * When a non-sleepable program is inside the array, we take the rcu read 2200 * section and disable preemption for that program alone, so it can access 2201 * rcu-protected dynamically sized maps. 2202 */ 2203 static __always_inline u32 2204 bpf_prog_run_array_uprobe(const struct bpf_prog_array *array, 2205 const void *ctx, bpf_prog_run_fn run_prog) 2206 { 2207 const struct bpf_prog_array_item *item; 2208 const struct bpf_prog *prog; 2209 struct bpf_run_ctx *old_run_ctx; 2210 struct bpf_trace_run_ctx run_ctx; 2211 u32 ret = 1; 2212 2213 might_fault(); 2214 RCU_LOCKDEP_WARN(!rcu_read_lock_trace_held(), "no rcu lock held"); 2215 2216 if (unlikely(!array)) 2217 return ret; 2218 2219 migrate_disable(); 2220 2221 run_ctx.is_uprobe = true; 2222 2223 old_run_ctx = bpf_set_run_ctx(&run_ctx.run_ctx); 2224 item = &array->items[0]; 2225 while ((prog = READ_ONCE(item->prog))) { 2226 if (!prog->sleepable) 2227 rcu_read_lock(); 2228 2229 run_ctx.bpf_cookie = item->bpf_cookie; 2230 ret &= run_prog(prog, ctx); 2231 item++; 2232 2233 if (!prog->sleepable) 2234 rcu_read_unlock(); 2235 } 2236 bpf_reset_run_ctx(old_run_ctx); 2237 migrate_enable(); 2238 return ret; 2239 } 2240 2241 #ifdef CONFIG_BPF_SYSCALL 2242 DECLARE_PER_CPU(int, bpf_prog_active); 2243 extern struct mutex bpf_stats_enabled_mutex; 2244 2245 /* 2246 * Block execution of BPF programs attached to instrumentation (perf, 2247 * kprobes, tracepoints) to prevent deadlocks on map operations as any of 2248 * these events can happen inside a region which holds a map bucket lock 2249 * and can deadlock on it. 2250 */ 2251 static inline void bpf_disable_instrumentation(void) 2252 { 2253 migrate_disable(); 2254 this_cpu_inc(bpf_prog_active); 2255 } 2256 2257 static inline void bpf_enable_instrumentation(void) 2258 { 2259 this_cpu_dec(bpf_prog_active); 2260 migrate_enable(); 2261 } 2262 2263 extern const struct super_operations bpf_super_ops; 2264 extern const struct file_operations bpf_map_fops; 2265 extern const struct file_operations bpf_prog_fops; 2266 extern const struct file_operations bpf_iter_fops; 2267 2268 #define BPF_PROG_TYPE(_id, _name, prog_ctx_type, kern_ctx_type) \ 2269 extern const struct bpf_prog_ops _name ## _prog_ops; \ 2270 extern const struct bpf_verifier_ops _name ## _verifier_ops; 2271 #define BPF_MAP_TYPE(_id, _ops) \ 2272 extern const struct bpf_map_ops _ops; 2273 #define BPF_LINK_TYPE(_id, _name) 2274 #include <linux/bpf_types.h> 2275 #undef BPF_PROG_TYPE 2276 #undef BPF_MAP_TYPE 2277 #undef BPF_LINK_TYPE 2278 2279 extern const struct bpf_prog_ops bpf_offload_prog_ops; 2280 extern const struct bpf_verifier_ops tc_cls_act_analyzer_ops; 2281 extern const struct bpf_verifier_ops xdp_analyzer_ops; 2282 2283 struct bpf_prog *bpf_prog_get(u32 ufd); 2284 struct bpf_prog *bpf_prog_get_type_dev(u32 ufd, enum bpf_prog_type type, 2285 bool attach_drv); 2286 void bpf_prog_add(struct bpf_prog *prog, int i); 2287 void bpf_prog_sub(struct bpf_prog *prog, int i); 2288 void bpf_prog_inc(struct bpf_prog *prog); 2289 struct bpf_prog * __must_check bpf_prog_inc_not_zero(struct bpf_prog *prog); 2290 void bpf_prog_put(struct bpf_prog *prog); 2291 2292 void bpf_prog_free_id(struct bpf_prog *prog); 2293 void bpf_map_free_id(struct bpf_map *map); 2294 2295 struct btf_field *btf_record_find(const struct btf_record *rec, 2296 u32 offset, u32 field_mask); 2297 void btf_record_free(struct btf_record *rec); 2298 void bpf_map_free_record(struct bpf_map *map); 2299 struct btf_record *btf_record_dup(const struct btf_record *rec); 2300 bool btf_record_equal(const struct btf_record *rec_a, const struct btf_record *rec_b); 2301 void bpf_obj_free_timer(const struct btf_record *rec, void *obj); 2302 void bpf_obj_free_workqueue(const struct btf_record *rec, void *obj); 2303 void bpf_obj_free_fields(const struct btf_record *rec, void *obj); 2304 void __bpf_obj_drop_impl(void *p, const struct btf_record *rec, bool percpu); 2305 2306 struct bpf_map *bpf_map_get(u32 ufd); 2307 struct bpf_map *bpf_map_get_with_uref(u32 ufd); 2308 2309 /* 2310 * The __bpf_map_get() and __btf_get_by_fd() functions parse a file 2311 * descriptor and return a corresponding map or btf object. 2312 * Their names are double underscored to emphasize the fact that they 2313 * do not increase refcnt. To also increase refcnt use corresponding 2314 * bpf_map_get() and btf_get_by_fd() functions. 2315 */ 2316 2317 static inline struct bpf_map *__bpf_map_get(struct fd f) 2318 { 2319 if (fd_empty(f)) 2320 return ERR_PTR(-EBADF); 2321 if (unlikely(fd_file(f)->f_op != &bpf_map_fops)) 2322 return ERR_PTR(-EINVAL); 2323 return fd_file(f)->private_data; 2324 } 2325 2326 static inline struct btf *__btf_get_by_fd(struct fd f) 2327 { 2328 if (fd_empty(f)) 2329 return ERR_PTR(-EBADF); 2330 if (unlikely(fd_file(f)->f_op != &btf_fops)) 2331 return ERR_PTR(-EINVAL); 2332 return fd_file(f)->private_data; 2333 } 2334 2335 void bpf_map_inc(struct bpf_map *map); 2336 void bpf_map_inc_with_uref(struct bpf_map *map); 2337 struct bpf_map *__bpf_map_inc_not_zero(struct bpf_map *map, bool uref); 2338 struct bpf_map * __must_check bpf_map_inc_not_zero(struct bpf_map *map); 2339 void bpf_map_put_with_uref(struct bpf_map *map); 2340 void bpf_map_put(struct bpf_map *map); 2341 void *bpf_map_area_alloc(u64 size, int numa_node); 2342 void *bpf_map_area_mmapable_alloc(u64 size, int numa_node); 2343 void bpf_map_area_free(void *base); 2344 bool bpf_map_write_active(const struct bpf_map *map); 2345 void bpf_map_init_from_attr(struct bpf_map *map, union bpf_attr *attr); 2346 int generic_map_lookup_batch(struct bpf_map *map, 2347 const union bpf_attr *attr, 2348 union bpf_attr __user *uattr); 2349 int generic_map_update_batch(struct bpf_map *map, struct file *map_file, 2350 const union bpf_attr *attr, 2351 union bpf_attr __user *uattr); 2352 int generic_map_delete_batch(struct bpf_map *map, 2353 const union bpf_attr *attr, 2354 union bpf_attr __user *uattr); 2355 struct bpf_map *bpf_map_get_curr_or_next(u32 *id); 2356 struct bpf_prog *bpf_prog_get_curr_or_next(u32 *id); 2357 2358 int bpf_map_alloc_pages(const struct bpf_map *map, gfp_t gfp, int nid, 2359 unsigned long nr_pages, struct page **page_array); 2360 #ifdef CONFIG_MEMCG 2361 void *bpf_map_kmalloc_node(const struct bpf_map *map, size_t size, gfp_t flags, 2362 int node); 2363 void *bpf_map_kzalloc(const struct bpf_map *map, size_t size, gfp_t flags); 2364 void *bpf_map_kvcalloc(struct bpf_map *map, size_t n, size_t size, 2365 gfp_t flags); 2366 void __percpu *bpf_map_alloc_percpu(const struct bpf_map *map, size_t size, 2367 size_t align, gfp_t flags); 2368 #else 2369 /* 2370 * These specialized allocators have to be macros for their allocations to be 2371 * accounted separately (to have separate alloc_tag). 2372 */ 2373 #define bpf_map_kmalloc_node(_map, _size, _flags, _node) \ 2374 kmalloc_node(_size, _flags, _node) 2375 #define bpf_map_kzalloc(_map, _size, _flags) \ 2376 kzalloc(_size, _flags) 2377 #define bpf_map_kvcalloc(_map, _n, _size, _flags) \ 2378 kvcalloc(_n, _size, _flags) 2379 #define bpf_map_alloc_percpu(_map, _size, _align, _flags) \ 2380 __alloc_percpu_gfp(_size, _align, _flags) 2381 #endif 2382 2383 static inline int 2384 bpf_map_init_elem_count(struct bpf_map *map) 2385 { 2386 size_t size = sizeof(*map->elem_count), align = size; 2387 gfp_t flags = GFP_USER | __GFP_NOWARN; 2388 2389 map->elem_count = bpf_map_alloc_percpu(map, size, align, flags); 2390 if (!map->elem_count) 2391 return -ENOMEM; 2392 2393 return 0; 2394 } 2395 2396 static inline void 2397 bpf_map_free_elem_count(struct bpf_map *map) 2398 { 2399 free_percpu(map->elem_count); 2400 } 2401 2402 static inline void bpf_map_inc_elem_count(struct bpf_map *map) 2403 { 2404 this_cpu_inc(*map->elem_count); 2405 } 2406 2407 static inline void bpf_map_dec_elem_count(struct bpf_map *map) 2408 { 2409 this_cpu_dec(*map->elem_count); 2410 } 2411 2412 extern int sysctl_unprivileged_bpf_disabled; 2413 2414 bool bpf_token_capable(const struct bpf_token *token, int cap); 2415 2416 static inline bool bpf_allow_ptr_leaks(const struct bpf_token *token) 2417 { 2418 return bpf_token_capable(token, CAP_PERFMON); 2419 } 2420 2421 static inline bool bpf_allow_uninit_stack(const struct bpf_token *token) 2422 { 2423 return bpf_token_capable(token, CAP_PERFMON); 2424 } 2425 2426 static inline bool bpf_bypass_spec_v1(const struct bpf_token *token) 2427 { 2428 return cpu_mitigations_off() || bpf_token_capable(token, CAP_PERFMON); 2429 } 2430 2431 static inline bool bpf_bypass_spec_v4(const struct bpf_token *token) 2432 { 2433 return cpu_mitigations_off() || bpf_token_capable(token, CAP_PERFMON); 2434 } 2435 2436 int bpf_map_new_fd(struct bpf_map *map, int flags); 2437 int bpf_prog_new_fd(struct bpf_prog *prog); 2438 2439 void bpf_link_init(struct bpf_link *link, enum bpf_link_type type, 2440 const struct bpf_link_ops *ops, struct bpf_prog *prog); 2441 void bpf_link_init_sleepable(struct bpf_link *link, enum bpf_link_type type, 2442 const struct bpf_link_ops *ops, struct bpf_prog *prog, 2443 bool sleepable); 2444 int bpf_link_prime(struct bpf_link *link, struct bpf_link_primer *primer); 2445 int bpf_link_settle(struct bpf_link_primer *primer); 2446 void bpf_link_cleanup(struct bpf_link_primer *primer); 2447 void bpf_link_inc(struct bpf_link *link); 2448 struct bpf_link *bpf_link_inc_not_zero(struct bpf_link *link); 2449 void bpf_link_put(struct bpf_link *link); 2450 int bpf_link_new_fd(struct bpf_link *link); 2451 struct bpf_link *bpf_link_get_from_fd(u32 ufd); 2452 struct bpf_link *bpf_link_get_curr_or_next(u32 *id); 2453 2454 void bpf_token_inc(struct bpf_token *token); 2455 void bpf_token_put(struct bpf_token *token); 2456 int bpf_token_create(union bpf_attr *attr); 2457 struct bpf_token *bpf_token_get_from_fd(u32 ufd); 2458 2459 bool bpf_token_allow_cmd(const struct bpf_token *token, enum bpf_cmd cmd); 2460 bool bpf_token_allow_map_type(const struct bpf_token *token, enum bpf_map_type type); 2461 bool bpf_token_allow_prog_type(const struct bpf_token *token, 2462 enum bpf_prog_type prog_type, 2463 enum bpf_attach_type attach_type); 2464 2465 int bpf_obj_pin_user(u32 ufd, int path_fd, const char __user *pathname); 2466 int bpf_obj_get_user(int path_fd, const char __user *pathname, int flags); 2467 struct inode *bpf_get_inode(struct super_block *sb, const struct inode *dir, 2468 umode_t mode); 2469 2470 #define BPF_ITER_FUNC_PREFIX "bpf_iter_" 2471 #define DEFINE_BPF_ITER_FUNC(target, args...) \ 2472 extern int bpf_iter_ ## target(args); \ 2473 int __init bpf_iter_ ## target(args) { return 0; } 2474 2475 /* 2476 * The task type of iterators. 2477 * 2478 * For BPF task iterators, they can be parameterized with various 2479 * parameters to visit only some of tasks. 2480 * 2481 * BPF_TASK_ITER_ALL (default) 2482 * Iterate over resources of every task. 2483 * 2484 * BPF_TASK_ITER_TID 2485 * Iterate over resources of a task/tid. 2486 * 2487 * BPF_TASK_ITER_TGID 2488 * Iterate over resources of every task of a process / task group. 2489 */ 2490 enum bpf_iter_task_type { 2491 BPF_TASK_ITER_ALL = 0, 2492 BPF_TASK_ITER_TID, 2493 BPF_TASK_ITER_TGID, 2494 }; 2495 2496 struct bpf_iter_aux_info { 2497 /* for map_elem iter */ 2498 struct bpf_map *map; 2499 2500 /* for cgroup iter */ 2501 struct { 2502 struct cgroup *start; /* starting cgroup */ 2503 enum bpf_cgroup_iter_order order; 2504 } cgroup; 2505 struct { 2506 enum bpf_iter_task_type type; 2507 u32 pid; 2508 } task; 2509 }; 2510 2511 typedef int (*bpf_iter_attach_target_t)(struct bpf_prog *prog, 2512 union bpf_iter_link_info *linfo, 2513 struct bpf_iter_aux_info *aux); 2514 typedef void (*bpf_iter_detach_target_t)(struct bpf_iter_aux_info *aux); 2515 typedef void (*bpf_iter_show_fdinfo_t) (const struct bpf_iter_aux_info *aux, 2516 struct seq_file *seq); 2517 typedef int (*bpf_iter_fill_link_info_t)(const struct bpf_iter_aux_info *aux, 2518 struct bpf_link_info *info); 2519 typedef const struct bpf_func_proto * 2520 (*bpf_iter_get_func_proto_t)(enum bpf_func_id func_id, 2521 const struct bpf_prog *prog); 2522 2523 enum bpf_iter_feature { 2524 BPF_ITER_RESCHED = BIT(0), 2525 }; 2526 2527 #define BPF_ITER_CTX_ARG_MAX 2 2528 struct bpf_iter_reg { 2529 const char *target; 2530 bpf_iter_attach_target_t attach_target; 2531 bpf_iter_detach_target_t detach_target; 2532 bpf_iter_show_fdinfo_t show_fdinfo; 2533 bpf_iter_fill_link_info_t fill_link_info; 2534 bpf_iter_get_func_proto_t get_func_proto; 2535 u32 ctx_arg_info_size; 2536 u32 feature; 2537 struct bpf_ctx_arg_aux ctx_arg_info[BPF_ITER_CTX_ARG_MAX]; 2538 const struct bpf_iter_seq_info *seq_info; 2539 }; 2540 2541 struct bpf_iter_meta { 2542 __bpf_md_ptr(struct seq_file *, seq); 2543 u64 session_id; 2544 u64 seq_num; 2545 }; 2546 2547 struct bpf_iter__bpf_map_elem { 2548 __bpf_md_ptr(struct bpf_iter_meta *, meta); 2549 __bpf_md_ptr(struct bpf_map *, map); 2550 __bpf_md_ptr(void *, key); 2551 __bpf_md_ptr(void *, value); 2552 }; 2553 2554 int bpf_iter_reg_target(const struct bpf_iter_reg *reg_info); 2555 void bpf_iter_unreg_target(const struct bpf_iter_reg *reg_info); 2556 int bpf_iter_prog_supported(struct bpf_prog *prog); 2557 const struct bpf_func_proto * 2558 bpf_iter_get_func_proto(enum bpf_func_id func_id, const struct bpf_prog *prog); 2559 int bpf_iter_link_attach(const union bpf_attr *attr, bpfptr_t uattr, struct bpf_prog *prog); 2560 int bpf_iter_new_fd(struct bpf_link *link); 2561 bool bpf_link_is_iter(struct bpf_link *link); 2562 struct bpf_prog *bpf_iter_get_info(struct bpf_iter_meta *meta, bool in_stop); 2563 int bpf_iter_run_prog(struct bpf_prog *prog, void *ctx); 2564 void bpf_iter_map_show_fdinfo(const struct bpf_iter_aux_info *aux, 2565 struct seq_file *seq); 2566 int bpf_iter_map_fill_link_info(const struct bpf_iter_aux_info *aux, 2567 struct bpf_link_info *info); 2568 2569 int map_set_for_each_callback_args(struct bpf_verifier_env *env, 2570 struct bpf_func_state *caller, 2571 struct bpf_func_state *callee); 2572 2573 int bpf_percpu_hash_copy(struct bpf_map *map, void *key, void *value); 2574 int bpf_percpu_array_copy(struct bpf_map *map, void *key, void *value); 2575 int bpf_percpu_hash_update(struct bpf_map *map, void *key, void *value, 2576 u64 flags); 2577 int bpf_percpu_array_update(struct bpf_map *map, void *key, void *value, 2578 u64 flags); 2579 2580 int bpf_stackmap_copy(struct bpf_map *map, void *key, void *value); 2581 2582 int bpf_fd_array_map_update_elem(struct bpf_map *map, struct file *map_file, 2583 void *key, void *value, u64 map_flags); 2584 int bpf_fd_array_map_lookup_elem(struct bpf_map *map, void *key, u32 *value); 2585 int bpf_fd_htab_map_update_elem(struct bpf_map *map, struct file *map_file, 2586 void *key, void *value, u64 map_flags); 2587 int bpf_fd_htab_map_lookup_elem(struct bpf_map *map, void *key, u32 *value); 2588 2589 int bpf_get_file_flag(int flags); 2590 int bpf_check_uarg_tail_zero(bpfptr_t uaddr, size_t expected_size, 2591 size_t actual_size); 2592 2593 /* verify correctness of eBPF program */ 2594 int bpf_check(struct bpf_prog **fp, union bpf_attr *attr, bpfptr_t uattr, u32 uattr_size); 2595 2596 #ifndef CONFIG_BPF_JIT_ALWAYS_ON 2597 void bpf_patch_call_args(struct bpf_insn *insn, u32 stack_depth); 2598 #endif 2599 2600 struct btf *bpf_get_btf_vmlinux(void); 2601 2602 /* Map specifics */ 2603 struct xdp_frame; 2604 struct sk_buff; 2605 struct bpf_dtab_netdev; 2606 struct bpf_cpu_map_entry; 2607 2608 void __dev_flush(struct list_head *flush_list); 2609 int dev_xdp_enqueue(struct net_device *dev, struct xdp_frame *xdpf, 2610 struct net_device *dev_rx); 2611 int dev_map_enqueue(struct bpf_dtab_netdev *dst, struct xdp_frame *xdpf, 2612 struct net_device *dev_rx); 2613 int dev_map_enqueue_multi(struct xdp_frame *xdpf, struct net_device *dev_rx, 2614 struct bpf_map *map, bool exclude_ingress); 2615 int dev_map_generic_redirect(struct bpf_dtab_netdev *dst, struct sk_buff *skb, 2616 const struct bpf_prog *xdp_prog); 2617 int dev_map_redirect_multi(struct net_device *dev, struct sk_buff *skb, 2618 const struct bpf_prog *xdp_prog, 2619 struct bpf_map *map, bool exclude_ingress); 2620 2621 void __cpu_map_flush(struct list_head *flush_list); 2622 int cpu_map_enqueue(struct bpf_cpu_map_entry *rcpu, struct xdp_frame *xdpf, 2623 struct net_device *dev_rx); 2624 int cpu_map_generic_redirect(struct bpf_cpu_map_entry *rcpu, 2625 struct sk_buff *skb); 2626 2627 /* Return map's numa specified by userspace */ 2628 static inline int bpf_map_attr_numa_node(const union bpf_attr *attr) 2629 { 2630 return (attr->map_flags & BPF_F_NUMA_NODE) ? 2631 attr->numa_node : NUMA_NO_NODE; 2632 } 2633 2634 struct bpf_prog *bpf_prog_get_type_path(const char *name, enum bpf_prog_type type); 2635 int array_map_alloc_check(union bpf_attr *attr); 2636 2637 int bpf_prog_test_run_xdp(struct bpf_prog *prog, const union bpf_attr *kattr, 2638 union bpf_attr __user *uattr); 2639 int bpf_prog_test_run_skb(struct bpf_prog *prog, const union bpf_attr *kattr, 2640 union bpf_attr __user *uattr); 2641 int bpf_prog_test_run_tracing(struct bpf_prog *prog, 2642 const union bpf_attr *kattr, 2643 union bpf_attr __user *uattr); 2644 int bpf_prog_test_run_flow_dissector(struct bpf_prog *prog, 2645 const union bpf_attr *kattr, 2646 union bpf_attr __user *uattr); 2647 int bpf_prog_test_run_raw_tp(struct bpf_prog *prog, 2648 const union bpf_attr *kattr, 2649 union bpf_attr __user *uattr); 2650 int bpf_prog_test_run_sk_lookup(struct bpf_prog *prog, 2651 const union bpf_attr *kattr, 2652 union bpf_attr __user *uattr); 2653 int bpf_prog_test_run_nf(struct bpf_prog *prog, 2654 const union bpf_attr *kattr, 2655 union bpf_attr __user *uattr); 2656 bool btf_ctx_access(int off, int size, enum bpf_access_type type, 2657 const struct bpf_prog *prog, 2658 struct bpf_insn_access_aux *info); 2659 2660 static inline bool bpf_tracing_ctx_access(int off, int size, 2661 enum bpf_access_type type) 2662 { 2663 if (off < 0 || off >= sizeof(__u64) * MAX_BPF_FUNC_ARGS) 2664 return false; 2665 if (type != BPF_READ) 2666 return false; 2667 if (off % size != 0) 2668 return false; 2669 return true; 2670 } 2671 2672 static inline bool bpf_tracing_btf_ctx_access(int off, int size, 2673 enum bpf_access_type type, 2674 const struct bpf_prog *prog, 2675 struct bpf_insn_access_aux *info) 2676 { 2677 if (!bpf_tracing_ctx_access(off, size, type)) 2678 return false; 2679 return btf_ctx_access(off, size, type, prog, info); 2680 } 2681 2682 int btf_struct_access(struct bpf_verifier_log *log, 2683 const struct bpf_reg_state *reg, 2684 int off, int size, enum bpf_access_type atype, 2685 u32 *next_btf_id, enum bpf_type_flag *flag, const char **field_name); 2686 bool btf_struct_ids_match(struct bpf_verifier_log *log, 2687 const struct btf *btf, u32 id, int off, 2688 const struct btf *need_btf, u32 need_type_id, 2689 bool strict); 2690 2691 int btf_distill_func_proto(struct bpf_verifier_log *log, 2692 struct btf *btf, 2693 const struct btf_type *func_proto, 2694 const char *func_name, 2695 struct btf_func_model *m); 2696 2697 struct bpf_reg_state; 2698 int btf_prepare_func_args(struct bpf_verifier_env *env, int subprog); 2699 int btf_check_type_match(struct bpf_verifier_log *log, const struct bpf_prog *prog, 2700 struct btf *btf, const struct btf_type *t); 2701 const char *btf_find_decl_tag_value(const struct btf *btf, const struct btf_type *pt, 2702 int comp_idx, const char *tag_key); 2703 int btf_find_next_decl_tag(const struct btf *btf, const struct btf_type *pt, 2704 int comp_idx, const char *tag_key, int last_id); 2705 2706 struct bpf_prog *bpf_prog_by_id(u32 id); 2707 struct bpf_link *bpf_link_by_id(u32 id); 2708 2709 const struct bpf_func_proto *bpf_base_func_proto(enum bpf_func_id func_id, 2710 const struct bpf_prog *prog); 2711 void bpf_task_storage_free(struct task_struct *task); 2712 void bpf_cgrp_storage_free(struct cgroup *cgroup); 2713 bool bpf_prog_has_kfunc_call(const struct bpf_prog *prog); 2714 const struct btf_func_model * 2715 bpf_jit_find_kfunc_model(const struct bpf_prog *prog, 2716 const struct bpf_insn *insn); 2717 int bpf_get_kfunc_addr(const struct bpf_prog *prog, u32 func_id, 2718 u16 btf_fd_idx, u8 **func_addr); 2719 2720 struct bpf_core_ctx { 2721 struct bpf_verifier_log *log; 2722 const struct btf *btf; 2723 }; 2724 2725 bool btf_nested_type_is_trusted(struct bpf_verifier_log *log, 2726 const struct bpf_reg_state *reg, 2727 const char *field_name, u32 btf_id, const char *suffix); 2728 2729 bool btf_type_ids_nocast_alias(struct bpf_verifier_log *log, 2730 const struct btf *reg_btf, u32 reg_id, 2731 const struct btf *arg_btf, u32 arg_id); 2732 2733 int bpf_core_apply(struct bpf_core_ctx *ctx, const struct bpf_core_relo *relo, 2734 int relo_idx, void *insn); 2735 2736 static inline bool unprivileged_ebpf_enabled(void) 2737 { 2738 return !sysctl_unprivileged_bpf_disabled; 2739 } 2740 2741 /* Not all bpf prog type has the bpf_ctx. 2742 * For the bpf prog type that has initialized the bpf_ctx, 2743 * this function can be used to decide if a kernel function 2744 * is called by a bpf program. 2745 */ 2746 static inline bool has_current_bpf_ctx(void) 2747 { 2748 return !!current->bpf_ctx; 2749 } 2750 2751 void notrace bpf_prog_inc_misses_counter(struct bpf_prog *prog); 2752 2753 void bpf_dynptr_init(struct bpf_dynptr_kern *ptr, void *data, 2754 enum bpf_dynptr_type type, u32 offset, u32 size); 2755 void bpf_dynptr_set_null(struct bpf_dynptr_kern *ptr); 2756 void bpf_dynptr_set_rdonly(struct bpf_dynptr_kern *ptr); 2757 2758 #else /* !CONFIG_BPF_SYSCALL */ 2759 static inline struct bpf_prog *bpf_prog_get(u32 ufd) 2760 { 2761 return ERR_PTR(-EOPNOTSUPP); 2762 } 2763 2764 static inline struct bpf_prog *bpf_prog_get_type_dev(u32 ufd, 2765 enum bpf_prog_type type, 2766 bool attach_drv) 2767 { 2768 return ERR_PTR(-EOPNOTSUPP); 2769 } 2770 2771 static inline void bpf_prog_add(struct bpf_prog *prog, int i) 2772 { 2773 } 2774 2775 static inline void bpf_prog_sub(struct bpf_prog *prog, int i) 2776 { 2777 } 2778 2779 static inline void bpf_prog_put(struct bpf_prog *prog) 2780 { 2781 } 2782 2783 static inline void bpf_prog_inc(struct bpf_prog *prog) 2784 { 2785 } 2786 2787 static inline struct bpf_prog *__must_check 2788 bpf_prog_inc_not_zero(struct bpf_prog *prog) 2789 { 2790 return ERR_PTR(-EOPNOTSUPP); 2791 } 2792 2793 static inline void bpf_link_init(struct bpf_link *link, enum bpf_link_type type, 2794 const struct bpf_link_ops *ops, 2795 struct bpf_prog *prog) 2796 { 2797 } 2798 2799 static inline void bpf_link_init_sleepable(struct bpf_link *link, enum bpf_link_type type, 2800 const struct bpf_link_ops *ops, struct bpf_prog *prog, 2801 bool sleepable) 2802 { 2803 } 2804 2805 static inline int bpf_link_prime(struct bpf_link *link, 2806 struct bpf_link_primer *primer) 2807 { 2808 return -EOPNOTSUPP; 2809 } 2810 2811 static inline int bpf_link_settle(struct bpf_link_primer *primer) 2812 { 2813 return -EOPNOTSUPP; 2814 } 2815 2816 static inline void bpf_link_cleanup(struct bpf_link_primer *primer) 2817 { 2818 } 2819 2820 static inline void bpf_link_inc(struct bpf_link *link) 2821 { 2822 } 2823 2824 static inline struct bpf_link *bpf_link_inc_not_zero(struct bpf_link *link) 2825 { 2826 return NULL; 2827 } 2828 2829 static inline void bpf_link_put(struct bpf_link *link) 2830 { 2831 } 2832 2833 static inline int bpf_obj_get_user(const char __user *pathname, int flags) 2834 { 2835 return -EOPNOTSUPP; 2836 } 2837 2838 static inline bool bpf_token_capable(const struct bpf_token *token, int cap) 2839 { 2840 return capable(cap) || (cap != CAP_SYS_ADMIN && capable(CAP_SYS_ADMIN)); 2841 } 2842 2843 static inline void bpf_token_inc(struct bpf_token *token) 2844 { 2845 } 2846 2847 static inline void bpf_token_put(struct bpf_token *token) 2848 { 2849 } 2850 2851 static inline struct bpf_token *bpf_token_get_from_fd(u32 ufd) 2852 { 2853 return ERR_PTR(-EOPNOTSUPP); 2854 } 2855 2856 static inline void __dev_flush(struct list_head *flush_list) 2857 { 2858 } 2859 2860 struct xdp_frame; 2861 struct bpf_dtab_netdev; 2862 struct bpf_cpu_map_entry; 2863 2864 static inline 2865 int dev_xdp_enqueue(struct net_device *dev, struct xdp_frame *xdpf, 2866 struct net_device *dev_rx) 2867 { 2868 return 0; 2869 } 2870 2871 static inline 2872 int dev_map_enqueue(struct bpf_dtab_netdev *dst, struct xdp_frame *xdpf, 2873 struct net_device *dev_rx) 2874 { 2875 return 0; 2876 } 2877 2878 static inline 2879 int dev_map_enqueue_multi(struct xdp_frame *xdpf, struct net_device *dev_rx, 2880 struct bpf_map *map, bool exclude_ingress) 2881 { 2882 return 0; 2883 } 2884 2885 struct sk_buff; 2886 2887 static inline int dev_map_generic_redirect(struct bpf_dtab_netdev *dst, 2888 struct sk_buff *skb, 2889 const struct bpf_prog *xdp_prog) 2890 { 2891 return 0; 2892 } 2893 2894 static inline 2895 int dev_map_redirect_multi(struct net_device *dev, struct sk_buff *skb, 2896 const struct bpf_prog *xdp_prog, 2897 struct bpf_map *map, bool exclude_ingress) 2898 { 2899 return 0; 2900 } 2901 2902 static inline void __cpu_map_flush(struct list_head *flush_list) 2903 { 2904 } 2905 2906 static inline int cpu_map_enqueue(struct bpf_cpu_map_entry *rcpu, 2907 struct xdp_frame *xdpf, 2908 struct net_device *dev_rx) 2909 { 2910 return 0; 2911 } 2912 2913 static inline int cpu_map_generic_redirect(struct bpf_cpu_map_entry *rcpu, 2914 struct sk_buff *skb) 2915 { 2916 return -EOPNOTSUPP; 2917 } 2918 2919 static inline struct bpf_prog *bpf_prog_get_type_path(const char *name, 2920 enum bpf_prog_type type) 2921 { 2922 return ERR_PTR(-EOPNOTSUPP); 2923 } 2924 2925 static inline int bpf_prog_test_run_xdp(struct bpf_prog *prog, 2926 const union bpf_attr *kattr, 2927 union bpf_attr __user *uattr) 2928 { 2929 return -ENOTSUPP; 2930 } 2931 2932 static inline int bpf_prog_test_run_skb(struct bpf_prog *prog, 2933 const union bpf_attr *kattr, 2934 union bpf_attr __user *uattr) 2935 { 2936 return -ENOTSUPP; 2937 } 2938 2939 static inline int bpf_prog_test_run_tracing(struct bpf_prog *prog, 2940 const union bpf_attr *kattr, 2941 union bpf_attr __user *uattr) 2942 { 2943 return -ENOTSUPP; 2944 } 2945 2946 static inline int bpf_prog_test_run_flow_dissector(struct bpf_prog *prog, 2947 const union bpf_attr *kattr, 2948 union bpf_attr __user *uattr) 2949 { 2950 return -ENOTSUPP; 2951 } 2952 2953 static inline int bpf_prog_test_run_sk_lookup(struct bpf_prog *prog, 2954 const union bpf_attr *kattr, 2955 union bpf_attr __user *uattr) 2956 { 2957 return -ENOTSUPP; 2958 } 2959 2960 static inline void bpf_map_put(struct bpf_map *map) 2961 { 2962 } 2963 2964 static inline struct bpf_prog *bpf_prog_by_id(u32 id) 2965 { 2966 return ERR_PTR(-ENOTSUPP); 2967 } 2968 2969 static inline int btf_struct_access(struct bpf_verifier_log *log, 2970 const struct bpf_reg_state *reg, 2971 int off, int size, enum bpf_access_type atype, 2972 u32 *next_btf_id, enum bpf_type_flag *flag, 2973 const char **field_name) 2974 { 2975 return -EACCES; 2976 } 2977 2978 static inline const struct bpf_func_proto * 2979 bpf_base_func_proto(enum bpf_func_id func_id, const struct bpf_prog *prog) 2980 { 2981 return NULL; 2982 } 2983 2984 static inline void bpf_task_storage_free(struct task_struct *task) 2985 { 2986 } 2987 2988 static inline bool bpf_prog_has_kfunc_call(const struct bpf_prog *prog) 2989 { 2990 return false; 2991 } 2992 2993 static inline const struct btf_func_model * 2994 bpf_jit_find_kfunc_model(const struct bpf_prog *prog, 2995 const struct bpf_insn *insn) 2996 { 2997 return NULL; 2998 } 2999 3000 static inline int 3001 bpf_get_kfunc_addr(const struct bpf_prog *prog, u32 func_id, 3002 u16 btf_fd_idx, u8 **func_addr) 3003 { 3004 return -ENOTSUPP; 3005 } 3006 3007 static inline bool unprivileged_ebpf_enabled(void) 3008 { 3009 return false; 3010 } 3011 3012 static inline bool has_current_bpf_ctx(void) 3013 { 3014 return false; 3015 } 3016 3017 static inline void bpf_prog_inc_misses_counter(struct bpf_prog *prog) 3018 { 3019 } 3020 3021 static inline void bpf_cgrp_storage_free(struct cgroup *cgroup) 3022 { 3023 } 3024 3025 static inline void bpf_dynptr_init(struct bpf_dynptr_kern *ptr, void *data, 3026 enum bpf_dynptr_type type, u32 offset, u32 size) 3027 { 3028 } 3029 3030 static inline void bpf_dynptr_set_null(struct bpf_dynptr_kern *ptr) 3031 { 3032 } 3033 3034 static inline void bpf_dynptr_set_rdonly(struct bpf_dynptr_kern *ptr) 3035 { 3036 } 3037 #endif /* CONFIG_BPF_SYSCALL */ 3038 3039 static __always_inline int 3040 bpf_probe_read_kernel_common(void *dst, u32 size, const void *unsafe_ptr) 3041 { 3042 int ret = -EFAULT; 3043 3044 if (IS_ENABLED(CONFIG_BPF_EVENTS)) 3045 ret = copy_from_kernel_nofault(dst, unsafe_ptr, size); 3046 if (unlikely(ret < 0)) 3047 memset(dst, 0, size); 3048 return ret; 3049 } 3050 3051 void __bpf_free_used_btfs(struct btf_mod_pair *used_btfs, u32 len); 3052 3053 static inline struct bpf_prog *bpf_prog_get_type(u32 ufd, 3054 enum bpf_prog_type type) 3055 { 3056 return bpf_prog_get_type_dev(ufd, type, false); 3057 } 3058 3059 void __bpf_free_used_maps(struct bpf_prog_aux *aux, 3060 struct bpf_map **used_maps, u32 len); 3061 3062 bool bpf_prog_get_ok(struct bpf_prog *, enum bpf_prog_type *, bool); 3063 3064 int bpf_prog_offload_compile(struct bpf_prog *prog); 3065 void bpf_prog_dev_bound_destroy(struct bpf_prog *prog); 3066 int bpf_prog_offload_info_fill(struct bpf_prog_info *info, 3067 struct bpf_prog *prog); 3068 3069 int bpf_map_offload_info_fill(struct bpf_map_info *info, struct bpf_map *map); 3070 3071 int bpf_map_offload_lookup_elem(struct bpf_map *map, void *key, void *value); 3072 int bpf_map_offload_update_elem(struct bpf_map *map, 3073 void *key, void *value, u64 flags); 3074 int bpf_map_offload_delete_elem(struct bpf_map *map, void *key); 3075 int bpf_map_offload_get_next_key(struct bpf_map *map, 3076 void *key, void *next_key); 3077 3078 bool bpf_offload_prog_map_match(struct bpf_prog *prog, struct bpf_map *map); 3079 3080 struct bpf_offload_dev * 3081 bpf_offload_dev_create(const struct bpf_prog_offload_ops *ops, void *priv); 3082 void bpf_offload_dev_destroy(struct bpf_offload_dev *offdev); 3083 void *bpf_offload_dev_priv(struct bpf_offload_dev *offdev); 3084 int bpf_offload_dev_netdev_register(struct bpf_offload_dev *offdev, 3085 struct net_device *netdev); 3086 void bpf_offload_dev_netdev_unregister(struct bpf_offload_dev *offdev, 3087 struct net_device *netdev); 3088 bool bpf_offload_dev_match(struct bpf_prog *prog, struct net_device *netdev); 3089 3090 void unpriv_ebpf_notify(int new_state); 3091 3092 #if defined(CONFIG_NET) && defined(CONFIG_BPF_SYSCALL) 3093 int bpf_dev_bound_kfunc_check(struct bpf_verifier_log *log, 3094 struct bpf_prog_aux *prog_aux); 3095 void *bpf_dev_bound_resolve_kfunc(struct bpf_prog *prog, u32 func_id); 3096 int bpf_prog_dev_bound_init(struct bpf_prog *prog, union bpf_attr *attr); 3097 int bpf_prog_dev_bound_inherit(struct bpf_prog *new_prog, struct bpf_prog *old_prog); 3098 void bpf_dev_bound_netdev_unregister(struct net_device *dev); 3099 3100 static inline bool bpf_prog_is_dev_bound(const struct bpf_prog_aux *aux) 3101 { 3102 return aux->dev_bound; 3103 } 3104 3105 static inline bool bpf_prog_is_offloaded(const struct bpf_prog_aux *aux) 3106 { 3107 return aux->offload_requested; 3108 } 3109 3110 bool bpf_prog_dev_bound_match(const struct bpf_prog *lhs, const struct bpf_prog *rhs); 3111 3112 static inline bool bpf_map_is_offloaded(struct bpf_map *map) 3113 { 3114 return unlikely(map->ops == &bpf_map_offload_ops); 3115 } 3116 3117 struct bpf_map *bpf_map_offload_map_alloc(union bpf_attr *attr); 3118 void bpf_map_offload_map_free(struct bpf_map *map); 3119 u64 bpf_map_offload_map_mem_usage(const struct bpf_map *map); 3120 int bpf_prog_test_run_syscall(struct bpf_prog *prog, 3121 const union bpf_attr *kattr, 3122 union bpf_attr __user *uattr); 3123 3124 int sock_map_get_from_fd(const union bpf_attr *attr, struct bpf_prog *prog); 3125 int sock_map_prog_detach(const union bpf_attr *attr, enum bpf_prog_type ptype); 3126 int sock_map_update_elem_sys(struct bpf_map *map, void *key, void *value, u64 flags); 3127 int sock_map_bpf_prog_query(const union bpf_attr *attr, 3128 union bpf_attr __user *uattr); 3129 int sock_map_link_create(const union bpf_attr *attr, struct bpf_prog *prog); 3130 3131 void sock_map_unhash(struct sock *sk); 3132 void sock_map_destroy(struct sock *sk); 3133 void sock_map_close(struct sock *sk, long timeout); 3134 #else 3135 static inline int bpf_dev_bound_kfunc_check(struct bpf_verifier_log *log, 3136 struct bpf_prog_aux *prog_aux) 3137 { 3138 return -EOPNOTSUPP; 3139 } 3140 3141 static inline void *bpf_dev_bound_resolve_kfunc(struct bpf_prog *prog, 3142 u32 func_id) 3143 { 3144 return NULL; 3145 } 3146 3147 static inline int bpf_prog_dev_bound_init(struct bpf_prog *prog, 3148 union bpf_attr *attr) 3149 { 3150 return -EOPNOTSUPP; 3151 } 3152 3153 static inline int bpf_prog_dev_bound_inherit(struct bpf_prog *new_prog, 3154 struct bpf_prog *old_prog) 3155 { 3156 return -EOPNOTSUPP; 3157 } 3158 3159 static inline void bpf_dev_bound_netdev_unregister(struct net_device *dev) 3160 { 3161 } 3162 3163 static inline bool bpf_prog_is_dev_bound(const struct bpf_prog_aux *aux) 3164 { 3165 return false; 3166 } 3167 3168 static inline bool bpf_prog_is_offloaded(struct bpf_prog_aux *aux) 3169 { 3170 return false; 3171 } 3172 3173 static inline bool bpf_prog_dev_bound_match(const struct bpf_prog *lhs, const struct bpf_prog *rhs) 3174 { 3175 return false; 3176 } 3177 3178 static inline bool bpf_map_is_offloaded(struct bpf_map *map) 3179 { 3180 return false; 3181 } 3182 3183 static inline struct bpf_map *bpf_map_offload_map_alloc(union bpf_attr *attr) 3184 { 3185 return ERR_PTR(-EOPNOTSUPP); 3186 } 3187 3188 static inline void bpf_map_offload_map_free(struct bpf_map *map) 3189 { 3190 } 3191 3192 static inline u64 bpf_map_offload_map_mem_usage(const struct bpf_map *map) 3193 { 3194 return 0; 3195 } 3196 3197 static inline int bpf_prog_test_run_syscall(struct bpf_prog *prog, 3198 const union bpf_attr *kattr, 3199 union bpf_attr __user *uattr) 3200 { 3201 return -ENOTSUPP; 3202 } 3203 3204 #ifdef CONFIG_BPF_SYSCALL 3205 static inline int sock_map_get_from_fd(const union bpf_attr *attr, 3206 struct bpf_prog *prog) 3207 { 3208 return -EINVAL; 3209 } 3210 3211 static inline int sock_map_prog_detach(const union bpf_attr *attr, 3212 enum bpf_prog_type ptype) 3213 { 3214 return -EOPNOTSUPP; 3215 } 3216 3217 static inline int sock_map_update_elem_sys(struct bpf_map *map, void *key, void *value, 3218 u64 flags) 3219 { 3220 return -EOPNOTSUPP; 3221 } 3222 3223 static inline int sock_map_bpf_prog_query(const union bpf_attr *attr, 3224 union bpf_attr __user *uattr) 3225 { 3226 return -EINVAL; 3227 } 3228 3229 static inline int sock_map_link_create(const union bpf_attr *attr, struct bpf_prog *prog) 3230 { 3231 return -EOPNOTSUPP; 3232 } 3233 #endif /* CONFIG_BPF_SYSCALL */ 3234 #endif /* CONFIG_NET && CONFIG_BPF_SYSCALL */ 3235 3236 static __always_inline void 3237 bpf_prog_inc_misses_counters(const struct bpf_prog_array *array) 3238 { 3239 const struct bpf_prog_array_item *item; 3240 struct bpf_prog *prog; 3241 3242 if (unlikely(!array)) 3243 return; 3244 3245 item = &array->items[0]; 3246 while ((prog = READ_ONCE(item->prog))) { 3247 bpf_prog_inc_misses_counter(prog); 3248 item++; 3249 } 3250 } 3251 3252 #if defined(CONFIG_INET) && defined(CONFIG_BPF_SYSCALL) 3253 void bpf_sk_reuseport_detach(struct sock *sk); 3254 int bpf_fd_reuseport_array_lookup_elem(struct bpf_map *map, void *key, 3255 void *value); 3256 int bpf_fd_reuseport_array_update_elem(struct bpf_map *map, void *key, 3257 void *value, u64 map_flags); 3258 #else 3259 static inline void bpf_sk_reuseport_detach(struct sock *sk) 3260 { 3261 } 3262 3263 #ifdef CONFIG_BPF_SYSCALL 3264 static inline int bpf_fd_reuseport_array_lookup_elem(struct bpf_map *map, 3265 void *key, void *value) 3266 { 3267 return -EOPNOTSUPP; 3268 } 3269 3270 static inline int bpf_fd_reuseport_array_update_elem(struct bpf_map *map, 3271 void *key, void *value, 3272 u64 map_flags) 3273 { 3274 return -EOPNOTSUPP; 3275 } 3276 #endif /* CONFIG_BPF_SYSCALL */ 3277 #endif /* defined(CONFIG_INET) && defined(CONFIG_BPF_SYSCALL) */ 3278 3279 /* verifier prototypes for helper functions called from eBPF programs */ 3280 extern const struct bpf_func_proto bpf_map_lookup_elem_proto; 3281 extern const struct bpf_func_proto bpf_map_update_elem_proto; 3282 extern const struct bpf_func_proto bpf_map_delete_elem_proto; 3283 extern const struct bpf_func_proto bpf_map_push_elem_proto; 3284 extern const struct bpf_func_proto bpf_map_pop_elem_proto; 3285 extern const struct bpf_func_proto bpf_map_peek_elem_proto; 3286 extern const struct bpf_func_proto bpf_map_lookup_percpu_elem_proto; 3287 3288 extern const struct bpf_func_proto bpf_get_prandom_u32_proto; 3289 extern const struct bpf_func_proto bpf_get_smp_processor_id_proto; 3290 extern const struct bpf_func_proto bpf_get_numa_node_id_proto; 3291 extern const struct bpf_func_proto bpf_tail_call_proto; 3292 extern const struct bpf_func_proto bpf_ktime_get_ns_proto; 3293 extern const struct bpf_func_proto bpf_ktime_get_boot_ns_proto; 3294 extern const struct bpf_func_proto bpf_ktime_get_tai_ns_proto; 3295 extern const struct bpf_func_proto bpf_get_current_pid_tgid_proto; 3296 extern const struct bpf_func_proto bpf_get_current_uid_gid_proto; 3297 extern const struct bpf_func_proto bpf_get_current_comm_proto; 3298 extern const struct bpf_func_proto bpf_get_stackid_proto; 3299 extern const struct bpf_func_proto bpf_get_stack_proto; 3300 extern const struct bpf_func_proto bpf_get_stack_sleepable_proto; 3301 extern const struct bpf_func_proto bpf_get_task_stack_proto; 3302 extern const struct bpf_func_proto bpf_get_task_stack_sleepable_proto; 3303 extern const struct bpf_func_proto bpf_get_stackid_proto_pe; 3304 extern const struct bpf_func_proto bpf_get_stack_proto_pe; 3305 extern const struct bpf_func_proto bpf_sock_map_update_proto; 3306 extern const struct bpf_func_proto bpf_sock_hash_update_proto; 3307 extern const struct bpf_func_proto bpf_get_current_cgroup_id_proto; 3308 extern const struct bpf_func_proto bpf_get_current_ancestor_cgroup_id_proto; 3309 extern const struct bpf_func_proto bpf_get_cgroup_classid_curr_proto; 3310 extern const struct bpf_func_proto bpf_current_task_under_cgroup_proto; 3311 extern const struct bpf_func_proto bpf_msg_redirect_hash_proto; 3312 extern const struct bpf_func_proto bpf_msg_redirect_map_proto; 3313 extern const struct bpf_func_proto bpf_sk_redirect_hash_proto; 3314 extern const struct bpf_func_proto bpf_sk_redirect_map_proto; 3315 extern const struct bpf_func_proto bpf_spin_lock_proto; 3316 extern const struct bpf_func_proto bpf_spin_unlock_proto; 3317 extern const struct bpf_func_proto bpf_get_local_storage_proto; 3318 extern const struct bpf_func_proto bpf_strtol_proto; 3319 extern const struct bpf_func_proto bpf_strtoul_proto; 3320 extern const struct bpf_func_proto bpf_tcp_sock_proto; 3321 extern const struct bpf_func_proto bpf_jiffies64_proto; 3322 extern const struct bpf_func_proto bpf_get_ns_current_pid_tgid_proto; 3323 extern const struct bpf_func_proto bpf_event_output_data_proto; 3324 extern const struct bpf_func_proto bpf_ringbuf_output_proto; 3325 extern const struct bpf_func_proto bpf_ringbuf_reserve_proto; 3326 extern const struct bpf_func_proto bpf_ringbuf_submit_proto; 3327 extern const struct bpf_func_proto bpf_ringbuf_discard_proto; 3328 extern const struct bpf_func_proto bpf_ringbuf_query_proto; 3329 extern const struct bpf_func_proto bpf_ringbuf_reserve_dynptr_proto; 3330 extern const struct bpf_func_proto bpf_ringbuf_submit_dynptr_proto; 3331 extern const struct bpf_func_proto bpf_ringbuf_discard_dynptr_proto; 3332 extern const struct bpf_func_proto bpf_skc_to_tcp6_sock_proto; 3333 extern const struct bpf_func_proto bpf_skc_to_tcp_sock_proto; 3334 extern const struct bpf_func_proto bpf_skc_to_tcp_timewait_sock_proto; 3335 extern const struct bpf_func_proto bpf_skc_to_tcp_request_sock_proto; 3336 extern const struct bpf_func_proto bpf_skc_to_udp6_sock_proto; 3337 extern const struct bpf_func_proto bpf_skc_to_unix_sock_proto; 3338 extern const struct bpf_func_proto bpf_skc_to_mptcp_sock_proto; 3339 extern const struct bpf_func_proto bpf_copy_from_user_proto; 3340 extern const struct bpf_func_proto bpf_snprintf_btf_proto; 3341 extern const struct bpf_func_proto bpf_snprintf_proto; 3342 extern const struct bpf_func_proto bpf_per_cpu_ptr_proto; 3343 extern const struct bpf_func_proto bpf_this_cpu_ptr_proto; 3344 extern const struct bpf_func_proto bpf_ktime_get_coarse_ns_proto; 3345 extern const struct bpf_func_proto bpf_sock_from_file_proto; 3346 extern const struct bpf_func_proto bpf_get_socket_ptr_cookie_proto; 3347 extern const struct bpf_func_proto bpf_task_storage_get_recur_proto; 3348 extern const struct bpf_func_proto bpf_task_storage_get_proto; 3349 extern const struct bpf_func_proto bpf_task_storage_delete_recur_proto; 3350 extern const struct bpf_func_proto bpf_task_storage_delete_proto; 3351 extern const struct bpf_func_proto bpf_for_each_map_elem_proto; 3352 extern const struct bpf_func_proto bpf_btf_find_by_name_kind_proto; 3353 extern const struct bpf_func_proto bpf_sk_setsockopt_proto; 3354 extern const struct bpf_func_proto bpf_sk_getsockopt_proto; 3355 extern const struct bpf_func_proto bpf_unlocked_sk_setsockopt_proto; 3356 extern const struct bpf_func_proto bpf_unlocked_sk_getsockopt_proto; 3357 extern const struct bpf_func_proto bpf_find_vma_proto; 3358 extern const struct bpf_func_proto bpf_loop_proto; 3359 extern const struct bpf_func_proto bpf_copy_from_user_task_proto; 3360 extern const struct bpf_func_proto bpf_set_retval_proto; 3361 extern const struct bpf_func_proto bpf_get_retval_proto; 3362 extern const struct bpf_func_proto bpf_user_ringbuf_drain_proto; 3363 extern const struct bpf_func_proto bpf_cgrp_storage_get_proto; 3364 extern const struct bpf_func_proto bpf_cgrp_storage_delete_proto; 3365 3366 const struct bpf_func_proto *tracing_prog_func_proto( 3367 enum bpf_func_id func_id, const struct bpf_prog *prog); 3368 3369 /* Shared helpers among cBPF and eBPF. */ 3370 void bpf_user_rnd_init_once(void); 3371 u64 bpf_user_rnd_u32(u64 r1, u64 r2, u64 r3, u64 r4, u64 r5); 3372 u64 bpf_get_raw_cpu_id(u64 r1, u64 r2, u64 r3, u64 r4, u64 r5); 3373 3374 #if defined(CONFIG_NET) 3375 bool bpf_sock_common_is_valid_access(int off, int size, 3376 enum bpf_access_type type, 3377 struct bpf_insn_access_aux *info); 3378 bool bpf_sock_is_valid_access(int off, int size, enum bpf_access_type type, 3379 struct bpf_insn_access_aux *info); 3380 u32 bpf_sock_convert_ctx_access(enum bpf_access_type type, 3381 const struct bpf_insn *si, 3382 struct bpf_insn *insn_buf, 3383 struct bpf_prog *prog, 3384 u32 *target_size); 3385 int bpf_dynptr_from_skb_rdonly(struct __sk_buff *skb, u64 flags, 3386 struct bpf_dynptr *ptr); 3387 #else 3388 static inline bool bpf_sock_common_is_valid_access(int off, int size, 3389 enum bpf_access_type type, 3390 struct bpf_insn_access_aux *info) 3391 { 3392 return false; 3393 } 3394 static inline bool bpf_sock_is_valid_access(int off, int size, 3395 enum bpf_access_type type, 3396 struct bpf_insn_access_aux *info) 3397 { 3398 return false; 3399 } 3400 static inline u32 bpf_sock_convert_ctx_access(enum bpf_access_type type, 3401 const struct bpf_insn *si, 3402 struct bpf_insn *insn_buf, 3403 struct bpf_prog *prog, 3404 u32 *target_size) 3405 { 3406 return 0; 3407 } 3408 static inline int bpf_dynptr_from_skb_rdonly(struct __sk_buff *skb, u64 flags, 3409 struct bpf_dynptr *ptr) 3410 { 3411 return -EOPNOTSUPP; 3412 } 3413 #endif 3414 3415 #ifdef CONFIG_INET 3416 struct sk_reuseport_kern { 3417 struct sk_buff *skb; 3418 struct sock *sk; 3419 struct sock *selected_sk; 3420 struct sock *migrating_sk; 3421 void *data_end; 3422 u32 hash; 3423 u32 reuseport_id; 3424 bool bind_inany; 3425 }; 3426 bool bpf_tcp_sock_is_valid_access(int off, int size, enum bpf_access_type type, 3427 struct bpf_insn_access_aux *info); 3428 3429 u32 bpf_tcp_sock_convert_ctx_access(enum bpf_access_type type, 3430 const struct bpf_insn *si, 3431 struct bpf_insn *insn_buf, 3432 struct bpf_prog *prog, 3433 u32 *target_size); 3434 3435 bool bpf_xdp_sock_is_valid_access(int off, int size, enum bpf_access_type type, 3436 struct bpf_insn_access_aux *info); 3437 3438 u32 bpf_xdp_sock_convert_ctx_access(enum bpf_access_type type, 3439 const struct bpf_insn *si, 3440 struct bpf_insn *insn_buf, 3441 struct bpf_prog *prog, 3442 u32 *target_size); 3443 #else 3444 static inline bool bpf_tcp_sock_is_valid_access(int off, int size, 3445 enum bpf_access_type type, 3446 struct bpf_insn_access_aux *info) 3447 { 3448 return false; 3449 } 3450 3451 static inline u32 bpf_tcp_sock_convert_ctx_access(enum bpf_access_type type, 3452 const struct bpf_insn *si, 3453 struct bpf_insn *insn_buf, 3454 struct bpf_prog *prog, 3455 u32 *target_size) 3456 { 3457 return 0; 3458 } 3459 static inline bool bpf_xdp_sock_is_valid_access(int off, int size, 3460 enum bpf_access_type type, 3461 struct bpf_insn_access_aux *info) 3462 { 3463 return false; 3464 } 3465 3466 static inline u32 bpf_xdp_sock_convert_ctx_access(enum bpf_access_type type, 3467 const struct bpf_insn *si, 3468 struct bpf_insn *insn_buf, 3469 struct bpf_prog *prog, 3470 u32 *target_size) 3471 { 3472 return 0; 3473 } 3474 #endif /* CONFIG_INET */ 3475 3476 enum bpf_text_poke_type { 3477 BPF_MOD_CALL, 3478 BPF_MOD_JUMP, 3479 }; 3480 3481 int bpf_arch_text_poke(void *ip, enum bpf_text_poke_type t, 3482 void *addr1, void *addr2); 3483 3484 void bpf_arch_poke_desc_update(struct bpf_jit_poke_descriptor *poke, 3485 struct bpf_prog *new, struct bpf_prog *old); 3486 3487 void *bpf_arch_text_copy(void *dst, void *src, size_t len); 3488 int bpf_arch_text_invalidate(void *dst, size_t len); 3489 3490 struct btf_id_set; 3491 bool btf_id_set_contains(const struct btf_id_set *set, u32 id); 3492 3493 #define MAX_BPRINTF_VARARGS 12 3494 #define MAX_BPRINTF_BUF 1024 3495 3496 struct bpf_bprintf_data { 3497 u32 *bin_args; 3498 char *buf; 3499 bool get_bin_args; 3500 bool get_buf; 3501 }; 3502 3503 int bpf_bprintf_prepare(char *fmt, u32 fmt_size, const u64 *raw_args, 3504 u32 num_args, struct bpf_bprintf_data *data); 3505 void bpf_bprintf_cleanup(struct bpf_bprintf_data *data); 3506 3507 #ifdef CONFIG_BPF_LSM 3508 void bpf_cgroup_atype_get(u32 attach_btf_id, int cgroup_atype); 3509 void bpf_cgroup_atype_put(int cgroup_atype); 3510 #else 3511 static inline void bpf_cgroup_atype_get(u32 attach_btf_id, int cgroup_atype) {} 3512 static inline void bpf_cgroup_atype_put(int cgroup_atype) {} 3513 #endif /* CONFIG_BPF_LSM */ 3514 3515 struct key; 3516 3517 #ifdef CONFIG_KEYS 3518 struct bpf_key { 3519 struct key *key; 3520 bool has_ref; 3521 }; 3522 #endif /* CONFIG_KEYS */ 3523 3524 static inline bool type_is_alloc(u32 type) 3525 { 3526 return type & MEM_ALLOC; 3527 } 3528 3529 static inline gfp_t bpf_memcg_flags(gfp_t flags) 3530 { 3531 if (memcg_bpf_enabled()) 3532 return flags | __GFP_ACCOUNT; 3533 return flags; 3534 } 3535 3536 static inline bool bpf_is_subprog(const struct bpf_prog *prog) 3537 { 3538 return prog->aux->func_idx != 0; 3539 } 3540 3541 #endif /* _LINUX_BPF_H */ 3542