1 // SPDX-License-Identifier: GPL-2.0-only
2 /* Copyright (c) 2011-2014 PLUMgrid, http://plumgrid.com
6 #include <linux/bpf-cgroup.h>
7 #include <linux/cgroup.h>
8 #include <linux/rcupdate.h>
9 #include <linux/random.h>
10 #include <linux/smp.h>
11 #include <linux/topology.h>
12 #include <linux/ktime.h>
13 #include <linux/sched.h>
14 #include <linux/uidgid.h>
15 #include <linux/filter.h>
16 #include <linux/ctype.h>
17 #include <linux/jiffies.h>
18 #include <linux/pid_namespace.h>
19 #include <linux/poison.h>
20 #include <linux/proc_ns.h>
21 #include <linux/sched/task.h>
22 #include <linux/security.h>
23 #include <linux/btf_ids.h>
24 #include <linux/bpf_mem_alloc.h>
25 #include <linux/kasan.h>
27 #include "../../lib/kstrtox.h"
29 /* If kernel subsystem is allowing eBPF programs to call this function,
30 * inside its own verifier_ops->get_func_proto() callback it should return
31 * bpf_map_lookup_elem_proto, so that verifier can properly check the arguments
33 * Different map implementations will rely on rcu in map methods
34 * lookup/update/delete, therefore eBPF programs must run under rcu lock
35 * if program is allowed to access maps, so check rcu_read_lock_held() or
36 * rcu_read_lock_trace_held() in all three functions.
38 BPF_CALL_2(bpf_map_lookup_elem, struct bpf_map *, map, void *, key)
40 WARN_ON_ONCE(!rcu_read_lock_held() && !rcu_read_lock_trace_held() &&
41 !rcu_read_lock_bh_held());
42 return (unsigned long) map->ops->map_lookup_elem(map, key);
45 const struct bpf_func_proto bpf_map_lookup_elem_proto = {
46 .func = bpf_map_lookup_elem,
49 .ret_type = RET_PTR_TO_MAP_VALUE_OR_NULL,
50 .arg1_type = ARG_CONST_MAP_PTR,
51 .arg2_type = ARG_PTR_TO_MAP_KEY,
54 BPF_CALL_4(bpf_map_update_elem, struct bpf_map *, map, void *, key,
55 void *, value, u64, flags)
57 WARN_ON_ONCE(!rcu_read_lock_held() && !rcu_read_lock_trace_held() &&
58 !rcu_read_lock_bh_held());
59 return map->ops->map_update_elem(map, key, value, flags);
62 const struct bpf_func_proto bpf_map_update_elem_proto = {
63 .func = bpf_map_update_elem,
66 .ret_type = RET_INTEGER,
67 .arg1_type = ARG_CONST_MAP_PTR,
68 .arg2_type = ARG_PTR_TO_MAP_KEY,
69 .arg3_type = ARG_PTR_TO_MAP_VALUE,
70 .arg4_type = ARG_ANYTHING,
73 BPF_CALL_2(bpf_map_delete_elem, struct bpf_map *, map, void *, key)
75 WARN_ON_ONCE(!rcu_read_lock_held() && !rcu_read_lock_trace_held() &&
76 !rcu_read_lock_bh_held());
77 return map->ops->map_delete_elem(map, key);
80 const struct bpf_func_proto bpf_map_delete_elem_proto = {
81 .func = bpf_map_delete_elem,
84 .ret_type = RET_INTEGER,
85 .arg1_type = ARG_CONST_MAP_PTR,
86 .arg2_type = ARG_PTR_TO_MAP_KEY,
89 BPF_CALL_3(bpf_map_push_elem, struct bpf_map *, map, void *, value, u64, flags)
91 return map->ops->map_push_elem(map, value, flags);
94 const struct bpf_func_proto bpf_map_push_elem_proto = {
95 .func = bpf_map_push_elem,
98 .ret_type = RET_INTEGER,
99 .arg1_type = ARG_CONST_MAP_PTR,
100 .arg2_type = ARG_PTR_TO_MAP_VALUE,
101 .arg3_type = ARG_ANYTHING,
104 BPF_CALL_2(bpf_map_pop_elem, struct bpf_map *, map, void *, value)
106 return map->ops->map_pop_elem(map, value);
109 const struct bpf_func_proto bpf_map_pop_elem_proto = {
110 .func = bpf_map_pop_elem,
112 .ret_type = RET_INTEGER,
113 .arg1_type = ARG_CONST_MAP_PTR,
114 .arg2_type = ARG_PTR_TO_MAP_VALUE | MEM_UNINIT,
117 BPF_CALL_2(bpf_map_peek_elem, struct bpf_map *, map, void *, value)
119 return map->ops->map_peek_elem(map, value);
122 const struct bpf_func_proto bpf_map_peek_elem_proto = {
123 .func = bpf_map_peek_elem,
125 .ret_type = RET_INTEGER,
126 .arg1_type = ARG_CONST_MAP_PTR,
127 .arg2_type = ARG_PTR_TO_MAP_VALUE | MEM_UNINIT,
130 BPF_CALL_3(bpf_map_lookup_percpu_elem, struct bpf_map *, map, void *, key, u32, cpu)
132 WARN_ON_ONCE(!rcu_read_lock_held() && !rcu_read_lock_bh_held());
133 return (unsigned long) map->ops->map_lookup_percpu_elem(map, key, cpu);
136 const struct bpf_func_proto bpf_map_lookup_percpu_elem_proto = {
137 .func = bpf_map_lookup_percpu_elem,
140 .ret_type = RET_PTR_TO_MAP_VALUE_OR_NULL,
141 .arg1_type = ARG_CONST_MAP_PTR,
142 .arg2_type = ARG_PTR_TO_MAP_KEY,
143 .arg3_type = ARG_ANYTHING,
146 const struct bpf_func_proto bpf_get_prandom_u32_proto = {
147 .func = bpf_user_rnd_u32,
149 .ret_type = RET_INTEGER,
152 BPF_CALL_0(bpf_get_smp_processor_id)
154 return smp_processor_id();
157 const struct bpf_func_proto bpf_get_smp_processor_id_proto = {
158 .func = bpf_get_smp_processor_id,
160 .ret_type = RET_INTEGER,
163 BPF_CALL_0(bpf_get_numa_node_id)
165 return numa_node_id();
168 const struct bpf_func_proto bpf_get_numa_node_id_proto = {
169 .func = bpf_get_numa_node_id,
171 .ret_type = RET_INTEGER,
174 BPF_CALL_0(bpf_ktime_get_ns)
176 /* NMI safe access to clock monotonic */
177 return ktime_get_mono_fast_ns();
180 const struct bpf_func_proto bpf_ktime_get_ns_proto = {
181 .func = bpf_ktime_get_ns,
183 .ret_type = RET_INTEGER,
186 BPF_CALL_0(bpf_ktime_get_boot_ns)
188 /* NMI safe access to clock boottime */
189 return ktime_get_boot_fast_ns();
192 const struct bpf_func_proto bpf_ktime_get_boot_ns_proto = {
193 .func = bpf_ktime_get_boot_ns,
195 .ret_type = RET_INTEGER,
198 BPF_CALL_0(bpf_ktime_get_coarse_ns)
200 return ktime_get_coarse_ns();
203 const struct bpf_func_proto bpf_ktime_get_coarse_ns_proto = {
204 .func = bpf_ktime_get_coarse_ns,
206 .ret_type = RET_INTEGER,
209 BPF_CALL_0(bpf_ktime_get_tai_ns)
211 /* NMI safe access to clock tai */
212 return ktime_get_tai_fast_ns();
215 const struct bpf_func_proto bpf_ktime_get_tai_ns_proto = {
216 .func = bpf_ktime_get_tai_ns,
218 .ret_type = RET_INTEGER,
221 BPF_CALL_0(bpf_get_current_pid_tgid)
223 struct task_struct *task = current;
228 return (u64) task->tgid << 32 | task->pid;
231 const struct bpf_func_proto bpf_get_current_pid_tgid_proto = {
232 .func = bpf_get_current_pid_tgid,
234 .ret_type = RET_INTEGER,
237 BPF_CALL_0(bpf_get_current_uid_gid)
239 struct task_struct *task = current;
246 current_uid_gid(&uid, &gid);
247 return (u64) from_kgid(&init_user_ns, gid) << 32 |
248 from_kuid(&init_user_ns, uid);
251 const struct bpf_func_proto bpf_get_current_uid_gid_proto = {
252 .func = bpf_get_current_uid_gid,
254 .ret_type = RET_INTEGER,
257 BPF_CALL_2(bpf_get_current_comm, char *, buf, u32, size)
259 struct task_struct *task = current;
264 /* Verifier guarantees that size > 0 */
265 strscpy_pad(buf, task->comm, size);
268 memset(buf, 0, size);
272 const struct bpf_func_proto bpf_get_current_comm_proto = {
273 .func = bpf_get_current_comm,
275 .ret_type = RET_INTEGER,
276 .arg1_type = ARG_PTR_TO_UNINIT_MEM,
277 .arg2_type = ARG_CONST_SIZE,
280 #if defined(CONFIG_QUEUED_SPINLOCKS) || defined(CONFIG_BPF_ARCH_SPINLOCK)
282 static inline void __bpf_spin_lock(struct bpf_spin_lock *lock)
284 arch_spinlock_t *l = (void *)lock;
287 arch_spinlock_t lock;
288 } u = { .lock = __ARCH_SPIN_LOCK_UNLOCKED };
290 compiletime_assert(u.val == 0, "__ARCH_SPIN_LOCK_UNLOCKED not 0");
291 BUILD_BUG_ON(sizeof(*l) != sizeof(__u32));
292 BUILD_BUG_ON(sizeof(*lock) != sizeof(__u32));
297 static inline void __bpf_spin_unlock(struct bpf_spin_lock *lock)
299 arch_spinlock_t *l = (void *)lock;
307 static inline void __bpf_spin_lock(struct bpf_spin_lock *lock)
309 atomic_t *l = (void *)lock;
311 BUILD_BUG_ON(sizeof(*l) != sizeof(*lock));
313 atomic_cond_read_relaxed(l, !VAL);
314 } while (atomic_xchg(l, 1));
317 static inline void __bpf_spin_unlock(struct bpf_spin_lock *lock)
319 atomic_t *l = (void *)lock;
321 atomic_set_release(l, 0);
326 static DEFINE_PER_CPU(unsigned long, irqsave_flags);
328 static inline void __bpf_spin_lock_irqsave(struct bpf_spin_lock *lock)
332 local_irq_save(flags);
333 __bpf_spin_lock(lock);
334 __this_cpu_write(irqsave_flags, flags);
337 NOTRACE_BPF_CALL_1(bpf_spin_lock, struct bpf_spin_lock *, lock)
339 __bpf_spin_lock_irqsave(lock);
343 const struct bpf_func_proto bpf_spin_lock_proto = {
344 .func = bpf_spin_lock,
346 .ret_type = RET_VOID,
347 .arg1_type = ARG_PTR_TO_SPIN_LOCK,
348 .arg1_btf_id = BPF_PTR_POISON,
351 static inline void __bpf_spin_unlock_irqrestore(struct bpf_spin_lock *lock)
355 flags = __this_cpu_read(irqsave_flags);
356 __bpf_spin_unlock(lock);
357 local_irq_restore(flags);
360 NOTRACE_BPF_CALL_1(bpf_spin_unlock, struct bpf_spin_lock *, lock)
362 __bpf_spin_unlock_irqrestore(lock);
366 const struct bpf_func_proto bpf_spin_unlock_proto = {
367 .func = bpf_spin_unlock,
369 .ret_type = RET_VOID,
370 .arg1_type = ARG_PTR_TO_SPIN_LOCK,
371 .arg1_btf_id = BPF_PTR_POISON,
374 void copy_map_value_locked(struct bpf_map *map, void *dst, void *src,
377 struct bpf_spin_lock *lock;
380 lock = src + map->record->spin_lock_off;
382 lock = dst + map->record->spin_lock_off;
384 __bpf_spin_lock_irqsave(lock);
385 copy_map_value(map, dst, src);
386 __bpf_spin_unlock_irqrestore(lock);
390 BPF_CALL_0(bpf_jiffies64)
392 return get_jiffies_64();
395 const struct bpf_func_proto bpf_jiffies64_proto = {
396 .func = bpf_jiffies64,
398 .ret_type = RET_INTEGER,
401 #ifdef CONFIG_CGROUPS
402 BPF_CALL_0(bpf_get_current_cgroup_id)
408 cgrp = task_dfl_cgroup(current);
409 cgrp_id = cgroup_id(cgrp);
415 const struct bpf_func_proto bpf_get_current_cgroup_id_proto = {
416 .func = bpf_get_current_cgroup_id,
418 .ret_type = RET_INTEGER,
421 BPF_CALL_1(bpf_get_current_ancestor_cgroup_id, int, ancestor_level)
424 struct cgroup *ancestor;
428 cgrp = task_dfl_cgroup(current);
429 ancestor = cgroup_ancestor(cgrp, ancestor_level);
430 cgrp_id = ancestor ? cgroup_id(ancestor) : 0;
436 const struct bpf_func_proto bpf_get_current_ancestor_cgroup_id_proto = {
437 .func = bpf_get_current_ancestor_cgroup_id,
439 .ret_type = RET_INTEGER,
440 .arg1_type = ARG_ANYTHING,
442 #endif /* CONFIG_CGROUPS */
444 #define BPF_STRTOX_BASE_MASK 0x1F
446 static int __bpf_strtoull(const char *buf, size_t buf_len, u64 flags,
447 unsigned long long *res, bool *is_negative)
449 unsigned int base = flags & BPF_STRTOX_BASE_MASK;
450 const char *cur_buf = buf;
451 size_t cur_len = buf_len;
452 unsigned int consumed;
456 if (!buf || !buf_len || !res || !is_negative)
459 if (base != 0 && base != 8 && base != 10 && base != 16)
462 if (flags & ~BPF_STRTOX_BASE_MASK)
465 while (cur_buf < buf + buf_len && isspace(*cur_buf))
468 *is_negative = (cur_buf < buf + buf_len && *cur_buf == '-');
472 consumed = cur_buf - buf;
477 cur_len = min(cur_len, sizeof(str) - 1);
478 memcpy(str, cur_buf, cur_len);
482 cur_buf = _parse_integer_fixup_radix(cur_buf, &base);
483 val_len = _parse_integer(cur_buf, base, res);
485 if (val_len & KSTRTOX_OVERFLOW)
492 consumed += cur_buf - str;
497 static int __bpf_strtoll(const char *buf, size_t buf_len, u64 flags,
500 unsigned long long _res;
504 err = __bpf_strtoull(buf, buf_len, flags, &_res, &is_negative);
508 if ((long long)-_res > 0)
512 if ((long long)_res < 0)
519 BPF_CALL_4(bpf_strtol, const char *, buf, size_t, buf_len, u64, flags,
525 err = __bpf_strtoll(buf, buf_len, flags, &_res);
528 if (_res != (long)_res)
534 const struct bpf_func_proto bpf_strtol_proto = {
537 .ret_type = RET_INTEGER,
538 .arg1_type = ARG_PTR_TO_MEM | MEM_RDONLY,
539 .arg2_type = ARG_CONST_SIZE,
540 .arg3_type = ARG_ANYTHING,
541 .arg4_type = ARG_PTR_TO_LONG,
544 BPF_CALL_4(bpf_strtoul, const char *, buf, size_t, buf_len, u64, flags,
545 unsigned long *, res)
547 unsigned long long _res;
551 err = __bpf_strtoull(buf, buf_len, flags, &_res, &is_negative);
556 if (_res != (unsigned long)_res)
562 const struct bpf_func_proto bpf_strtoul_proto = {
565 .ret_type = RET_INTEGER,
566 .arg1_type = ARG_PTR_TO_MEM | MEM_RDONLY,
567 .arg2_type = ARG_CONST_SIZE,
568 .arg3_type = ARG_ANYTHING,
569 .arg4_type = ARG_PTR_TO_LONG,
572 BPF_CALL_3(bpf_strncmp, const char *, s1, u32, s1_sz, const char *, s2)
574 return strncmp(s1, s2, s1_sz);
577 static const struct bpf_func_proto bpf_strncmp_proto = {
580 .ret_type = RET_INTEGER,
581 .arg1_type = ARG_PTR_TO_MEM | MEM_RDONLY,
582 .arg2_type = ARG_CONST_SIZE,
583 .arg3_type = ARG_PTR_TO_CONST_STR,
586 BPF_CALL_4(bpf_get_ns_current_pid_tgid, u64, dev, u64, ino,
587 struct bpf_pidns_info *, nsdata, u32, size)
589 struct task_struct *task = current;
590 struct pid_namespace *pidns;
593 if (unlikely(size != sizeof(struct bpf_pidns_info)))
596 if (unlikely((u64)(dev_t)dev != dev))
602 pidns = task_active_pid_ns(task);
603 if (unlikely(!pidns)) {
608 if (!ns_match(&pidns->ns, (dev_t)dev, ino))
611 nsdata->pid = task_pid_nr_ns(task, pidns);
612 nsdata->tgid = task_tgid_nr_ns(task, pidns);
615 memset((void *)nsdata, 0, (size_t) size);
619 const struct bpf_func_proto bpf_get_ns_current_pid_tgid_proto = {
620 .func = bpf_get_ns_current_pid_tgid,
622 .ret_type = RET_INTEGER,
623 .arg1_type = ARG_ANYTHING,
624 .arg2_type = ARG_ANYTHING,
625 .arg3_type = ARG_PTR_TO_UNINIT_MEM,
626 .arg4_type = ARG_CONST_SIZE,
629 static const struct bpf_func_proto bpf_get_raw_smp_processor_id_proto = {
630 .func = bpf_get_raw_cpu_id,
632 .ret_type = RET_INTEGER,
635 BPF_CALL_5(bpf_event_output_data, void *, ctx, struct bpf_map *, map,
636 u64, flags, void *, data, u64, size)
638 if (unlikely(flags & ~(BPF_F_INDEX_MASK)))
641 return bpf_event_output(map, flags, data, size, NULL, 0, NULL);
644 const struct bpf_func_proto bpf_event_output_data_proto = {
645 .func = bpf_event_output_data,
647 .ret_type = RET_INTEGER,
648 .arg1_type = ARG_PTR_TO_CTX,
649 .arg2_type = ARG_CONST_MAP_PTR,
650 .arg3_type = ARG_ANYTHING,
651 .arg4_type = ARG_PTR_TO_MEM | MEM_RDONLY,
652 .arg5_type = ARG_CONST_SIZE_OR_ZERO,
655 BPF_CALL_3(bpf_copy_from_user, void *, dst, u32, size,
656 const void __user *, user_ptr)
658 int ret = copy_from_user(dst, user_ptr, size);
661 memset(dst, 0, size);
668 const struct bpf_func_proto bpf_copy_from_user_proto = {
669 .func = bpf_copy_from_user,
672 .ret_type = RET_INTEGER,
673 .arg1_type = ARG_PTR_TO_UNINIT_MEM,
674 .arg2_type = ARG_CONST_SIZE_OR_ZERO,
675 .arg3_type = ARG_ANYTHING,
678 BPF_CALL_5(bpf_copy_from_user_task, void *, dst, u32, size,
679 const void __user *, user_ptr, struct task_struct *, tsk, u64, flags)
683 /* flags is not used yet */
690 ret = access_process_vm(tsk, (unsigned long)user_ptr, dst, size, 0);
694 memset(dst, 0, size);
695 /* Return -EFAULT for partial read */
696 return ret < 0 ? ret : -EFAULT;
699 const struct bpf_func_proto bpf_copy_from_user_task_proto = {
700 .func = bpf_copy_from_user_task,
703 .ret_type = RET_INTEGER,
704 .arg1_type = ARG_PTR_TO_UNINIT_MEM,
705 .arg2_type = ARG_CONST_SIZE_OR_ZERO,
706 .arg3_type = ARG_ANYTHING,
707 .arg4_type = ARG_PTR_TO_BTF_ID,
708 .arg4_btf_id = &btf_tracing_ids[BTF_TRACING_TYPE_TASK],
709 .arg5_type = ARG_ANYTHING
712 BPF_CALL_2(bpf_per_cpu_ptr, const void *, ptr, u32, cpu)
714 if (cpu >= nr_cpu_ids)
715 return (unsigned long)NULL;
717 return (unsigned long)per_cpu_ptr((const void __percpu *)ptr, cpu);
720 const struct bpf_func_proto bpf_per_cpu_ptr_proto = {
721 .func = bpf_per_cpu_ptr,
723 .ret_type = RET_PTR_TO_MEM_OR_BTF_ID | PTR_MAYBE_NULL | MEM_RDONLY,
724 .arg1_type = ARG_PTR_TO_PERCPU_BTF_ID,
725 .arg2_type = ARG_ANYTHING,
728 BPF_CALL_1(bpf_this_cpu_ptr, const void *, percpu_ptr)
730 return (unsigned long)this_cpu_ptr((const void __percpu *)percpu_ptr);
733 const struct bpf_func_proto bpf_this_cpu_ptr_proto = {
734 .func = bpf_this_cpu_ptr,
736 .ret_type = RET_PTR_TO_MEM_OR_BTF_ID | MEM_RDONLY,
737 .arg1_type = ARG_PTR_TO_PERCPU_BTF_ID,
740 static int bpf_trace_copy_string(char *buf, void *unsafe_ptr, char fmt_ptype,
743 void __user *user_ptr = (__force void __user *)unsafe_ptr;
749 #ifdef CONFIG_ARCH_HAS_NON_OVERLAPPING_ADDRESS_SPACE
750 if ((unsigned long)unsafe_ptr < TASK_SIZE)
751 return strncpy_from_user_nofault(buf, user_ptr, bufsz);
755 return strncpy_from_kernel_nofault(buf, unsafe_ptr, bufsz);
757 return strncpy_from_user_nofault(buf, user_ptr, bufsz);
763 /* Per-cpu temp buffers used by printf-like helpers to store the bprintf binary
764 * arguments representation.
766 #define MAX_BPRINTF_BIN_ARGS 512
768 /* Support executing three nested bprintf helper calls on a given CPU */
769 #define MAX_BPRINTF_NEST_LEVEL 3
770 struct bpf_bprintf_buffers {
771 char bin_args[MAX_BPRINTF_BIN_ARGS];
772 char buf[MAX_BPRINTF_BUF];
775 static DEFINE_PER_CPU(struct bpf_bprintf_buffers[MAX_BPRINTF_NEST_LEVEL], bpf_bprintf_bufs);
776 static DEFINE_PER_CPU(int, bpf_bprintf_nest_level);
778 static int try_get_buffers(struct bpf_bprintf_buffers **bufs)
783 nest_level = this_cpu_inc_return(bpf_bprintf_nest_level);
784 if (WARN_ON_ONCE(nest_level > MAX_BPRINTF_NEST_LEVEL)) {
785 this_cpu_dec(bpf_bprintf_nest_level);
789 *bufs = this_cpu_ptr(&bpf_bprintf_bufs[nest_level - 1]);
794 void bpf_bprintf_cleanup(struct bpf_bprintf_data *data)
796 if (!data->bin_args && !data->buf)
798 if (WARN_ON_ONCE(this_cpu_read(bpf_bprintf_nest_level) == 0))
800 this_cpu_dec(bpf_bprintf_nest_level);
805 * bpf_bprintf_prepare - Generic pass on format strings for bprintf-like helpers
807 * Returns a negative value if fmt is an invalid format string or 0 otherwise.
809 * This can be used in two ways:
810 * - Format string verification only: when data->get_bin_args is false
811 * - Arguments preparation: in addition to the above verification, it writes in
812 * data->bin_args a binary representation of arguments usable by bstr_printf
813 * where pointers from BPF have been sanitized.
815 * In argument preparation mode, if 0 is returned, safe temporary buffers are
816 * allocated and bpf_bprintf_cleanup should be called to free them after use.
818 int bpf_bprintf_prepare(char *fmt, u32 fmt_size, const u64 *raw_args,
819 u32 num_args, struct bpf_bprintf_data *data)
821 bool get_buffers = (data->get_bin_args && num_args) || data->get_buf;
822 char *unsafe_ptr = NULL, *tmp_buf = NULL, *tmp_buf_end, *fmt_end;
823 struct bpf_bprintf_buffers *buffers = NULL;
824 size_t sizeof_cur_arg, sizeof_cur_ip;
825 int err, i, num_spec = 0;
827 char fmt_ptype, cur_ip[16], ip_spec[] = "%pXX";
829 fmt_end = strnchr(fmt, fmt_size, 0);
832 fmt_size = fmt_end - fmt;
834 if (get_buffers && try_get_buffers(&buffers))
837 if (data->get_bin_args) {
839 tmp_buf = buffers->bin_args;
840 tmp_buf_end = tmp_buf + MAX_BPRINTF_BIN_ARGS;
841 data->bin_args = (u32 *)tmp_buf;
845 data->buf = buffers->buf;
847 for (i = 0; i < fmt_size; i++) {
848 if ((!isprint(fmt[i]) && !isspace(fmt[i])) || !isascii(fmt[i])) {
856 if (fmt[i + 1] == '%') {
861 if (num_spec >= num_args) {
866 /* The string is zero-terminated so if fmt[i] != 0, we can
867 * always access fmt[i + 1], in the worst case it will be a 0
871 /* skip optional "[0 +-][num]" width formatting field */
872 while (fmt[i] == '0' || fmt[i] == '+' || fmt[i] == '-' ||
875 if (fmt[i] >= '1' && fmt[i] <= '9') {
877 while (fmt[i] >= '0' && fmt[i] <= '9')
882 sizeof_cur_arg = sizeof(long);
884 if ((fmt[i + 1] == 'k' || fmt[i + 1] == 'u') &&
886 fmt_ptype = fmt[i + 1];
891 if (fmt[i + 1] == 0 || isspace(fmt[i + 1]) ||
892 ispunct(fmt[i + 1]) || fmt[i + 1] == 'K' ||
893 fmt[i + 1] == 'x' || fmt[i + 1] == 's' ||
895 /* just kernel pointers */
897 cur_arg = raw_args[num_spec];
902 if (fmt[i + 1] == 'B') {
904 err = snprintf(tmp_buf,
905 (tmp_buf_end - tmp_buf),
907 (void *)(long)raw_args[num_spec]);
908 tmp_buf += (err + 1);
916 /* only support "%pI4", "%pi4", "%pI6" and "%pi6". */
917 if ((fmt[i + 1] != 'i' && fmt[i + 1] != 'I') ||
918 (fmt[i + 2] != '4' && fmt[i + 2] != '6')) {
927 sizeof_cur_ip = (fmt[i] == '4') ? 4 : 16;
928 if (tmp_buf_end - tmp_buf < sizeof_cur_ip) {
933 unsafe_ptr = (char *)(long)raw_args[num_spec];
934 err = copy_from_kernel_nofault(cur_ip, unsafe_ptr,
937 memset(cur_ip, 0, sizeof_cur_ip);
939 /* hack: bstr_printf expects IP addresses to be
940 * pre-formatted as strings, ironically, the easiest way
941 * to do that is to call snprintf.
943 ip_spec[2] = fmt[i - 1];
945 err = snprintf(tmp_buf, tmp_buf_end - tmp_buf,
952 } else if (fmt[i] == 's') {
955 if (fmt[i + 1] != 0 &&
956 !isspace(fmt[i + 1]) &&
957 !ispunct(fmt[i + 1])) {
965 if (tmp_buf_end == tmp_buf) {
970 unsafe_ptr = (char *)(long)raw_args[num_spec];
971 err = bpf_trace_copy_string(tmp_buf, unsafe_ptr,
973 tmp_buf_end - tmp_buf);
983 } else if (fmt[i] == 'c') {
987 if (tmp_buf_end == tmp_buf) {
992 *tmp_buf = raw_args[num_spec];
999 sizeof_cur_arg = sizeof(int);
1001 if (fmt[i] == 'l') {
1002 sizeof_cur_arg = sizeof(long);
1005 if (fmt[i] == 'l') {
1006 sizeof_cur_arg = sizeof(long long);
1010 if (fmt[i] != 'i' && fmt[i] != 'd' && fmt[i] != 'u' &&
1011 fmt[i] != 'x' && fmt[i] != 'X') {
1017 cur_arg = raw_args[num_spec];
1020 tmp_buf = PTR_ALIGN(tmp_buf, sizeof(u32));
1021 if (tmp_buf_end - tmp_buf < sizeof_cur_arg) {
1026 if (sizeof_cur_arg == 8) {
1027 *(u32 *)tmp_buf = *(u32 *)&cur_arg;
1028 *(u32 *)(tmp_buf + 4) = *((u32 *)&cur_arg + 1);
1030 *(u32 *)tmp_buf = (u32)(long)cur_arg;
1032 tmp_buf += sizeof_cur_arg;
1040 bpf_bprintf_cleanup(data);
1044 BPF_CALL_5(bpf_snprintf, char *, str, u32, str_size, char *, fmt,
1045 const void *, args, u32, data_len)
1047 struct bpf_bprintf_data data = {
1048 .get_bin_args = true,
1052 if (data_len % 8 || data_len > MAX_BPRINTF_VARARGS * 8 ||
1053 (data_len && !args))
1055 num_args = data_len / 8;
1057 /* ARG_PTR_TO_CONST_STR guarantees that fmt is zero-terminated so we
1058 * can safely give an unbounded size.
1060 err = bpf_bprintf_prepare(fmt, UINT_MAX, args, num_args, &data);
1064 err = bstr_printf(str, str_size, fmt, data.bin_args);
1066 bpf_bprintf_cleanup(&data);
1071 const struct bpf_func_proto bpf_snprintf_proto = {
1072 .func = bpf_snprintf,
1074 .ret_type = RET_INTEGER,
1075 .arg1_type = ARG_PTR_TO_MEM_OR_NULL,
1076 .arg2_type = ARG_CONST_SIZE_OR_ZERO,
1077 .arg3_type = ARG_PTR_TO_CONST_STR,
1078 .arg4_type = ARG_PTR_TO_MEM | PTR_MAYBE_NULL | MEM_RDONLY,
1079 .arg5_type = ARG_CONST_SIZE_OR_ZERO,
1082 /* BPF map elements can contain 'struct bpf_timer'.
1083 * Such map owns all of its BPF timers.
1084 * 'struct bpf_timer' is allocated as part of map element allocation
1085 * and it's zero initialized.
1086 * That space is used to keep 'struct bpf_timer_kern'.
1087 * bpf_timer_init() allocates 'struct bpf_hrtimer', inits hrtimer, and
1088 * remembers 'struct bpf_map *' pointer it's part of.
1089 * bpf_timer_set_callback() increments prog refcnt and assign bpf callback_fn.
1090 * bpf_timer_start() arms the timer.
1091 * If user space reference to a map goes to zero at this point
1092 * ops->map_release_uref callback is responsible for cancelling the timers,
1093 * freeing their memory, and decrementing prog's refcnts.
1094 * bpf_timer_cancel() cancels the timer and decrements prog's refcnt.
1095 * Inner maps can contain bpf timers as well. ops->map_release_uref is
1096 * freeing the timers when inner map is replaced or deleted by user space.
1098 struct bpf_hrtimer {
1099 struct hrtimer timer;
1100 struct bpf_map *map;
1101 struct bpf_prog *prog;
1102 void __rcu *callback_fn;
1104 struct rcu_head rcu;
1107 /* the actual struct hidden inside uapi struct bpf_timer */
1108 struct bpf_timer_kern {
1109 struct bpf_hrtimer *timer;
1110 /* bpf_spin_lock is used here instead of spinlock_t to make
1111 * sure that it always fits into space reserved by struct bpf_timer
1112 * regardless of LOCKDEP and spinlock debug flags.
1114 struct bpf_spin_lock lock;
1115 } __attribute__((aligned(8)));
1117 static DEFINE_PER_CPU(struct bpf_hrtimer *, hrtimer_running);
1119 static enum hrtimer_restart bpf_timer_cb(struct hrtimer *hrtimer)
1121 struct bpf_hrtimer *t = container_of(hrtimer, struct bpf_hrtimer, timer);
1122 struct bpf_map *map = t->map;
1123 void *value = t->value;
1124 bpf_callback_t callback_fn;
1128 BTF_TYPE_EMIT(struct bpf_timer);
1129 callback_fn = rcu_dereference_check(t->callback_fn, rcu_read_lock_bh_held());
1133 /* bpf_timer_cb() runs in hrtimer_run_softirq. It doesn't migrate and
1134 * cannot be preempted by another bpf_timer_cb() on the same cpu.
1135 * Remember the timer this callback is servicing to prevent
1136 * deadlock if callback_fn() calls bpf_timer_cancel() or
1137 * bpf_map_delete_elem() on the same timer.
1139 this_cpu_write(hrtimer_running, t);
1140 if (map->map_type == BPF_MAP_TYPE_ARRAY) {
1141 struct bpf_array *array = container_of(map, struct bpf_array, map);
1143 /* compute the key */
1144 idx = ((char *)value - array->value) / array->elem_size;
1146 } else { /* hash or lru */
1147 key = value - round_up(map->key_size, 8);
1150 callback_fn((u64)(long)map, (u64)(long)key, (u64)(long)value, 0, 0);
1151 /* The verifier checked that return value is zero. */
1153 this_cpu_write(hrtimer_running, NULL);
1155 return HRTIMER_NORESTART;
1158 BPF_CALL_3(bpf_timer_init, struct bpf_timer_kern *, timer, struct bpf_map *, map,
1161 clockid_t clockid = flags & (MAX_CLOCKS - 1);
1162 struct bpf_hrtimer *t;
1165 BUILD_BUG_ON(MAX_CLOCKS != 16);
1166 BUILD_BUG_ON(sizeof(struct bpf_timer_kern) > sizeof(struct bpf_timer));
1167 BUILD_BUG_ON(__alignof__(struct bpf_timer_kern) != __alignof__(struct bpf_timer));
1172 if (flags >= MAX_CLOCKS ||
1173 /* similar to timerfd except _ALARM variants are not supported */
1174 (clockid != CLOCK_MONOTONIC &&
1175 clockid != CLOCK_REALTIME &&
1176 clockid != CLOCK_BOOTTIME))
1178 __bpf_spin_lock_irqsave(&timer->lock);
1184 /* allocate hrtimer via map_kmalloc to use memcg accounting */
1185 t = bpf_map_kmalloc_node(map, sizeof(*t), GFP_ATOMIC, map->numa_node);
1190 t->value = (void *)timer - map->record->timer_off;
1193 rcu_assign_pointer(t->callback_fn, NULL);
1194 hrtimer_init(&t->timer, clockid, HRTIMER_MODE_REL_SOFT);
1195 t->timer.function = bpf_timer_cb;
1196 WRITE_ONCE(timer->timer, t);
1197 /* Guarantee the order between timer->timer and map->usercnt. So
1198 * when there are concurrent uref release and bpf timer init, either
1199 * bpf_timer_cancel_and_free() called by uref release reads a no-NULL
1200 * timer or atomic64_read() below returns a zero usercnt.
1203 if (!atomic64_read(&map->usercnt)) {
1204 /* maps with timers must be either held by user space
1205 * or pinned in bpffs.
1207 WRITE_ONCE(timer->timer, NULL);
1212 __bpf_spin_unlock_irqrestore(&timer->lock);
1216 static const struct bpf_func_proto bpf_timer_init_proto = {
1217 .func = bpf_timer_init,
1219 .ret_type = RET_INTEGER,
1220 .arg1_type = ARG_PTR_TO_TIMER,
1221 .arg2_type = ARG_CONST_MAP_PTR,
1222 .arg3_type = ARG_ANYTHING,
1225 BPF_CALL_3(bpf_timer_set_callback, struct bpf_timer_kern *, timer, void *, callback_fn,
1226 struct bpf_prog_aux *, aux)
1228 struct bpf_prog *prev, *prog = aux->prog;
1229 struct bpf_hrtimer *t;
1234 __bpf_spin_lock_irqsave(&timer->lock);
1240 if (!atomic64_read(&t->map->usercnt)) {
1241 /* maps with timers must be either held by user space
1242 * or pinned in bpffs. Otherwise timer might still be
1243 * running even when bpf prog is detached and user space
1244 * is gone, since map_release_uref won't ever be called.
1251 /* Bump prog refcnt once. Every bpf_timer_set_callback()
1252 * can pick different callback_fn-s within the same prog.
1254 prog = bpf_prog_inc_not_zero(prog);
1256 ret = PTR_ERR(prog);
1260 /* Drop prev prog refcnt when swapping with new prog */
1264 rcu_assign_pointer(t->callback_fn, callback_fn);
1266 __bpf_spin_unlock_irqrestore(&timer->lock);
1270 static const struct bpf_func_proto bpf_timer_set_callback_proto = {
1271 .func = bpf_timer_set_callback,
1273 .ret_type = RET_INTEGER,
1274 .arg1_type = ARG_PTR_TO_TIMER,
1275 .arg2_type = ARG_PTR_TO_FUNC,
1278 BPF_CALL_3(bpf_timer_start, struct bpf_timer_kern *, timer, u64, nsecs, u64, flags)
1280 struct bpf_hrtimer *t;
1282 enum hrtimer_mode mode;
1286 if (flags & ~(BPF_F_TIMER_ABS | BPF_F_TIMER_CPU_PIN))
1288 __bpf_spin_lock_irqsave(&timer->lock);
1290 if (!t || !t->prog) {
1295 if (flags & BPF_F_TIMER_ABS)
1296 mode = HRTIMER_MODE_ABS_SOFT;
1298 mode = HRTIMER_MODE_REL_SOFT;
1300 if (flags & BPF_F_TIMER_CPU_PIN)
1301 mode |= HRTIMER_MODE_PINNED;
1303 hrtimer_start(&t->timer, ns_to_ktime(nsecs), mode);
1305 __bpf_spin_unlock_irqrestore(&timer->lock);
1309 static const struct bpf_func_proto bpf_timer_start_proto = {
1310 .func = bpf_timer_start,
1312 .ret_type = RET_INTEGER,
1313 .arg1_type = ARG_PTR_TO_TIMER,
1314 .arg2_type = ARG_ANYTHING,
1315 .arg3_type = ARG_ANYTHING,
1318 static void drop_prog_refcnt(struct bpf_hrtimer *t)
1320 struct bpf_prog *prog = t->prog;
1325 rcu_assign_pointer(t->callback_fn, NULL);
1329 BPF_CALL_1(bpf_timer_cancel, struct bpf_timer_kern *, timer)
1331 struct bpf_hrtimer *t;
1337 __bpf_spin_lock_irqsave(&timer->lock);
1343 if (this_cpu_read(hrtimer_running) == t) {
1344 /* If bpf callback_fn is trying to bpf_timer_cancel()
1345 * its own timer the hrtimer_cancel() will deadlock
1346 * since it waits for callback_fn to finish
1351 drop_prog_refcnt(t);
1353 __bpf_spin_unlock_irqrestore(&timer->lock);
1354 /* Cancel the timer and wait for associated callback to finish
1355 * if it was running.
1357 ret = ret ?: hrtimer_cancel(&t->timer);
1362 static const struct bpf_func_proto bpf_timer_cancel_proto = {
1363 .func = bpf_timer_cancel,
1365 .ret_type = RET_INTEGER,
1366 .arg1_type = ARG_PTR_TO_TIMER,
1369 /* This function is called by map_delete/update_elem for individual element and
1370 * by ops->map_release_uref when the user space reference to a map reaches zero.
1372 void bpf_timer_cancel_and_free(void *val)
1374 struct bpf_timer_kern *timer = val;
1375 struct bpf_hrtimer *t;
1377 /* Performance optimization: read timer->timer without lock first. */
1378 if (!READ_ONCE(timer->timer))
1381 __bpf_spin_lock_irqsave(&timer->lock);
1382 /* re-read it under lock */
1386 drop_prog_refcnt(t);
1387 /* The subsequent bpf_timer_start/cancel() helpers won't be able to use
1388 * this timer, since it won't be initialized.
1390 WRITE_ONCE(timer->timer, NULL);
1392 __bpf_spin_unlock_irqrestore(&timer->lock);
1395 /* Cancel the timer and wait for callback to complete if it was running.
1396 * If hrtimer_cancel() can be safely called it's safe to call kfree(t)
1397 * right after for both preallocated and non-preallocated maps.
1398 * The timer->timer = NULL was already done and no code path can
1399 * see address 't' anymore.
1401 * Check that bpf_map_delete/update_elem() wasn't called from timer
1402 * callback_fn. In such case don't call hrtimer_cancel() (since it will
1403 * deadlock) and don't call hrtimer_try_to_cancel() (since it will just
1404 * return -1). Though callback_fn is still running on this cpu it's
1405 * safe to do kfree(t) because bpf_timer_cb() read everything it needed
1406 * from 't'. The bpf subprog callback_fn won't be able to access 't',
1407 * since timer->timer = NULL was already done. The timer will be
1408 * effectively cancelled because bpf_timer_cb() will return
1409 * HRTIMER_NORESTART.
1411 if (this_cpu_read(hrtimer_running) != t)
1412 hrtimer_cancel(&t->timer);
1416 BPF_CALL_2(bpf_kptr_xchg, void *, map_value, void *, ptr)
1418 unsigned long *kptr = map_value;
1420 /* This helper may be inlined by verifier. */
1421 return xchg(kptr, (unsigned long)ptr);
1424 /* Unlike other PTR_TO_BTF_ID helpers the btf_id in bpf_kptr_xchg()
1425 * helper is determined dynamically by the verifier. Use BPF_PTR_POISON to
1426 * denote type that verifier will determine.
1428 static const struct bpf_func_proto bpf_kptr_xchg_proto = {
1429 .func = bpf_kptr_xchg,
1431 .ret_type = RET_PTR_TO_BTF_ID_OR_NULL,
1432 .ret_btf_id = BPF_PTR_POISON,
1433 .arg1_type = ARG_PTR_TO_KPTR,
1434 .arg2_type = ARG_PTR_TO_BTF_ID_OR_NULL | OBJ_RELEASE,
1435 .arg2_btf_id = BPF_PTR_POISON,
1438 /* Since the upper 8 bits of dynptr->size is reserved, the
1439 * maximum supported size is 2^24 - 1.
1441 #define DYNPTR_MAX_SIZE ((1UL << 24) - 1)
1442 #define DYNPTR_TYPE_SHIFT 28
1443 #define DYNPTR_SIZE_MASK 0xFFFFFF
1444 #define DYNPTR_RDONLY_BIT BIT(31)
1446 static bool __bpf_dynptr_is_rdonly(const struct bpf_dynptr_kern *ptr)
1448 return ptr->size & DYNPTR_RDONLY_BIT;
1451 void bpf_dynptr_set_rdonly(struct bpf_dynptr_kern *ptr)
1453 ptr->size |= DYNPTR_RDONLY_BIT;
1456 static void bpf_dynptr_set_type(struct bpf_dynptr_kern *ptr, enum bpf_dynptr_type type)
1458 ptr->size |= type << DYNPTR_TYPE_SHIFT;
1461 static enum bpf_dynptr_type bpf_dynptr_get_type(const struct bpf_dynptr_kern *ptr)
1463 return (ptr->size & ~(DYNPTR_RDONLY_BIT)) >> DYNPTR_TYPE_SHIFT;
1466 u32 __bpf_dynptr_size(const struct bpf_dynptr_kern *ptr)
1468 return ptr->size & DYNPTR_SIZE_MASK;
1471 static void bpf_dynptr_set_size(struct bpf_dynptr_kern *ptr, u32 new_size)
1473 u32 metadata = ptr->size & ~DYNPTR_SIZE_MASK;
1475 ptr->size = new_size | metadata;
1478 int bpf_dynptr_check_size(u32 size)
1480 return size > DYNPTR_MAX_SIZE ? -E2BIG : 0;
1483 void bpf_dynptr_init(struct bpf_dynptr_kern *ptr, void *data,
1484 enum bpf_dynptr_type type, u32 offset, u32 size)
1487 ptr->offset = offset;
1489 bpf_dynptr_set_type(ptr, type);
1492 void bpf_dynptr_set_null(struct bpf_dynptr_kern *ptr)
1494 memset(ptr, 0, sizeof(*ptr));
1497 static int bpf_dynptr_check_off_len(const struct bpf_dynptr_kern *ptr, u32 offset, u32 len)
1499 u32 size = __bpf_dynptr_size(ptr);
1501 if (len > size || offset > size - len)
1507 BPF_CALL_4(bpf_dynptr_from_mem, void *, data, u32, size, u64, flags, struct bpf_dynptr_kern *, ptr)
1511 BTF_TYPE_EMIT(struct bpf_dynptr);
1513 err = bpf_dynptr_check_size(size);
1517 /* flags is currently unsupported */
1523 bpf_dynptr_init(ptr, data, BPF_DYNPTR_TYPE_LOCAL, 0, size);
1528 bpf_dynptr_set_null(ptr);
1532 static const struct bpf_func_proto bpf_dynptr_from_mem_proto = {
1533 .func = bpf_dynptr_from_mem,
1535 .ret_type = RET_INTEGER,
1536 .arg1_type = ARG_PTR_TO_UNINIT_MEM,
1537 .arg2_type = ARG_CONST_SIZE_OR_ZERO,
1538 .arg3_type = ARG_ANYTHING,
1539 .arg4_type = ARG_PTR_TO_DYNPTR | DYNPTR_TYPE_LOCAL | MEM_UNINIT,
1542 BPF_CALL_5(bpf_dynptr_read, void *, dst, u32, len, const struct bpf_dynptr_kern *, src,
1543 u32, offset, u64, flags)
1545 enum bpf_dynptr_type type;
1548 if (!src->data || flags)
1551 err = bpf_dynptr_check_off_len(src, offset, len);
1555 type = bpf_dynptr_get_type(src);
1558 case BPF_DYNPTR_TYPE_LOCAL:
1559 case BPF_DYNPTR_TYPE_RINGBUF:
1560 /* Source and destination may possibly overlap, hence use memmove to
1561 * copy the data. E.g. bpf_dynptr_from_mem may create two dynptr
1562 * pointing to overlapping PTR_TO_MAP_VALUE regions.
1564 memmove(dst, src->data + src->offset + offset, len);
1566 case BPF_DYNPTR_TYPE_SKB:
1567 return __bpf_skb_load_bytes(src->data, src->offset + offset, dst, len);
1568 case BPF_DYNPTR_TYPE_XDP:
1569 return __bpf_xdp_load_bytes(src->data, src->offset + offset, dst, len);
1571 WARN_ONCE(true, "bpf_dynptr_read: unknown dynptr type %d\n", type);
1576 static const struct bpf_func_proto bpf_dynptr_read_proto = {
1577 .func = bpf_dynptr_read,
1579 .ret_type = RET_INTEGER,
1580 .arg1_type = ARG_PTR_TO_UNINIT_MEM,
1581 .arg2_type = ARG_CONST_SIZE_OR_ZERO,
1582 .arg3_type = ARG_PTR_TO_DYNPTR | MEM_RDONLY,
1583 .arg4_type = ARG_ANYTHING,
1584 .arg5_type = ARG_ANYTHING,
1587 BPF_CALL_5(bpf_dynptr_write, const struct bpf_dynptr_kern *, dst, u32, offset, void *, src,
1588 u32, len, u64, flags)
1590 enum bpf_dynptr_type type;
1593 if (!dst->data || __bpf_dynptr_is_rdonly(dst))
1596 err = bpf_dynptr_check_off_len(dst, offset, len);
1600 type = bpf_dynptr_get_type(dst);
1603 case BPF_DYNPTR_TYPE_LOCAL:
1604 case BPF_DYNPTR_TYPE_RINGBUF:
1607 /* Source and destination may possibly overlap, hence use memmove to
1608 * copy the data. E.g. bpf_dynptr_from_mem may create two dynptr
1609 * pointing to overlapping PTR_TO_MAP_VALUE regions.
1611 memmove(dst->data + dst->offset + offset, src, len);
1613 case BPF_DYNPTR_TYPE_SKB:
1614 return __bpf_skb_store_bytes(dst->data, dst->offset + offset, src, len,
1616 case BPF_DYNPTR_TYPE_XDP:
1619 return __bpf_xdp_store_bytes(dst->data, dst->offset + offset, src, len);
1621 WARN_ONCE(true, "bpf_dynptr_write: unknown dynptr type %d\n", type);
1626 static const struct bpf_func_proto bpf_dynptr_write_proto = {
1627 .func = bpf_dynptr_write,
1629 .ret_type = RET_INTEGER,
1630 .arg1_type = ARG_PTR_TO_DYNPTR | MEM_RDONLY,
1631 .arg2_type = ARG_ANYTHING,
1632 .arg3_type = ARG_PTR_TO_MEM | MEM_RDONLY,
1633 .arg4_type = ARG_CONST_SIZE_OR_ZERO,
1634 .arg5_type = ARG_ANYTHING,
1637 BPF_CALL_3(bpf_dynptr_data, const struct bpf_dynptr_kern *, ptr, u32, offset, u32, len)
1639 enum bpf_dynptr_type type;
1645 err = bpf_dynptr_check_off_len(ptr, offset, len);
1649 if (__bpf_dynptr_is_rdonly(ptr))
1652 type = bpf_dynptr_get_type(ptr);
1655 case BPF_DYNPTR_TYPE_LOCAL:
1656 case BPF_DYNPTR_TYPE_RINGBUF:
1657 return (unsigned long)(ptr->data + ptr->offset + offset);
1658 case BPF_DYNPTR_TYPE_SKB:
1659 case BPF_DYNPTR_TYPE_XDP:
1660 /* skb and xdp dynptrs should use bpf_dynptr_slice / bpf_dynptr_slice_rdwr */
1663 WARN_ONCE(true, "bpf_dynptr_data: unknown dynptr type %d\n", type);
1668 static const struct bpf_func_proto bpf_dynptr_data_proto = {
1669 .func = bpf_dynptr_data,
1671 .ret_type = RET_PTR_TO_DYNPTR_MEM_OR_NULL,
1672 .arg1_type = ARG_PTR_TO_DYNPTR | MEM_RDONLY,
1673 .arg2_type = ARG_ANYTHING,
1674 .arg3_type = ARG_CONST_ALLOC_SIZE_OR_ZERO,
1677 const struct bpf_func_proto bpf_get_current_task_proto __weak;
1678 const struct bpf_func_proto bpf_get_current_task_btf_proto __weak;
1679 const struct bpf_func_proto bpf_probe_read_user_proto __weak;
1680 const struct bpf_func_proto bpf_probe_read_user_str_proto __weak;
1681 const struct bpf_func_proto bpf_probe_read_kernel_proto __weak;
1682 const struct bpf_func_proto bpf_probe_read_kernel_str_proto __weak;
1683 const struct bpf_func_proto bpf_task_pt_regs_proto __weak;
1685 const struct bpf_func_proto *
1686 bpf_base_func_proto(enum bpf_func_id func_id, const struct bpf_prog *prog)
1689 case BPF_FUNC_map_lookup_elem:
1690 return &bpf_map_lookup_elem_proto;
1691 case BPF_FUNC_map_update_elem:
1692 return &bpf_map_update_elem_proto;
1693 case BPF_FUNC_map_delete_elem:
1694 return &bpf_map_delete_elem_proto;
1695 case BPF_FUNC_map_push_elem:
1696 return &bpf_map_push_elem_proto;
1697 case BPF_FUNC_map_pop_elem:
1698 return &bpf_map_pop_elem_proto;
1699 case BPF_FUNC_map_peek_elem:
1700 return &bpf_map_peek_elem_proto;
1701 case BPF_FUNC_map_lookup_percpu_elem:
1702 return &bpf_map_lookup_percpu_elem_proto;
1703 case BPF_FUNC_get_prandom_u32:
1704 return &bpf_get_prandom_u32_proto;
1705 case BPF_FUNC_get_smp_processor_id:
1706 return &bpf_get_raw_smp_processor_id_proto;
1707 case BPF_FUNC_get_numa_node_id:
1708 return &bpf_get_numa_node_id_proto;
1709 case BPF_FUNC_tail_call:
1710 return &bpf_tail_call_proto;
1711 case BPF_FUNC_ktime_get_ns:
1712 return &bpf_ktime_get_ns_proto;
1713 case BPF_FUNC_ktime_get_boot_ns:
1714 return &bpf_ktime_get_boot_ns_proto;
1715 case BPF_FUNC_ktime_get_tai_ns:
1716 return &bpf_ktime_get_tai_ns_proto;
1717 case BPF_FUNC_ringbuf_output:
1718 return &bpf_ringbuf_output_proto;
1719 case BPF_FUNC_ringbuf_reserve:
1720 return &bpf_ringbuf_reserve_proto;
1721 case BPF_FUNC_ringbuf_submit:
1722 return &bpf_ringbuf_submit_proto;
1723 case BPF_FUNC_ringbuf_discard:
1724 return &bpf_ringbuf_discard_proto;
1725 case BPF_FUNC_ringbuf_query:
1726 return &bpf_ringbuf_query_proto;
1727 case BPF_FUNC_strncmp:
1728 return &bpf_strncmp_proto;
1729 case BPF_FUNC_strtol:
1730 return &bpf_strtol_proto;
1731 case BPF_FUNC_strtoul:
1732 return &bpf_strtoul_proto;
1737 if (!bpf_token_capable(prog->aux->token, CAP_BPF))
1741 case BPF_FUNC_spin_lock:
1742 return &bpf_spin_lock_proto;
1743 case BPF_FUNC_spin_unlock:
1744 return &bpf_spin_unlock_proto;
1745 case BPF_FUNC_jiffies64:
1746 return &bpf_jiffies64_proto;
1747 case BPF_FUNC_per_cpu_ptr:
1748 return &bpf_per_cpu_ptr_proto;
1749 case BPF_FUNC_this_cpu_ptr:
1750 return &bpf_this_cpu_ptr_proto;
1751 case BPF_FUNC_timer_init:
1752 return &bpf_timer_init_proto;
1753 case BPF_FUNC_timer_set_callback:
1754 return &bpf_timer_set_callback_proto;
1755 case BPF_FUNC_timer_start:
1756 return &bpf_timer_start_proto;
1757 case BPF_FUNC_timer_cancel:
1758 return &bpf_timer_cancel_proto;
1759 case BPF_FUNC_kptr_xchg:
1760 return &bpf_kptr_xchg_proto;
1761 case BPF_FUNC_for_each_map_elem:
1762 return &bpf_for_each_map_elem_proto;
1764 return &bpf_loop_proto;
1765 case BPF_FUNC_user_ringbuf_drain:
1766 return &bpf_user_ringbuf_drain_proto;
1767 case BPF_FUNC_ringbuf_reserve_dynptr:
1768 return &bpf_ringbuf_reserve_dynptr_proto;
1769 case BPF_FUNC_ringbuf_submit_dynptr:
1770 return &bpf_ringbuf_submit_dynptr_proto;
1771 case BPF_FUNC_ringbuf_discard_dynptr:
1772 return &bpf_ringbuf_discard_dynptr_proto;
1773 case BPF_FUNC_dynptr_from_mem:
1774 return &bpf_dynptr_from_mem_proto;
1775 case BPF_FUNC_dynptr_read:
1776 return &bpf_dynptr_read_proto;
1777 case BPF_FUNC_dynptr_write:
1778 return &bpf_dynptr_write_proto;
1779 case BPF_FUNC_dynptr_data:
1780 return &bpf_dynptr_data_proto;
1781 #ifdef CONFIG_CGROUPS
1782 case BPF_FUNC_cgrp_storage_get:
1783 return &bpf_cgrp_storage_get_proto;
1784 case BPF_FUNC_cgrp_storage_delete:
1785 return &bpf_cgrp_storage_delete_proto;
1786 case BPF_FUNC_get_current_cgroup_id:
1787 return &bpf_get_current_cgroup_id_proto;
1788 case BPF_FUNC_get_current_ancestor_cgroup_id:
1789 return &bpf_get_current_ancestor_cgroup_id_proto;
1795 if (!bpf_token_capable(prog->aux->token, CAP_PERFMON))
1799 case BPF_FUNC_trace_printk:
1800 return bpf_get_trace_printk_proto();
1801 case BPF_FUNC_get_current_task:
1802 return &bpf_get_current_task_proto;
1803 case BPF_FUNC_get_current_task_btf:
1804 return &bpf_get_current_task_btf_proto;
1805 case BPF_FUNC_probe_read_user:
1806 return &bpf_probe_read_user_proto;
1807 case BPF_FUNC_probe_read_kernel:
1808 return security_locked_down(LOCKDOWN_BPF_READ_KERNEL) < 0 ?
1809 NULL : &bpf_probe_read_kernel_proto;
1810 case BPF_FUNC_probe_read_user_str:
1811 return &bpf_probe_read_user_str_proto;
1812 case BPF_FUNC_probe_read_kernel_str:
1813 return security_locked_down(LOCKDOWN_BPF_READ_KERNEL) < 0 ?
1814 NULL : &bpf_probe_read_kernel_str_proto;
1815 case BPF_FUNC_snprintf_btf:
1816 return &bpf_snprintf_btf_proto;
1817 case BPF_FUNC_snprintf:
1818 return &bpf_snprintf_proto;
1819 case BPF_FUNC_task_pt_regs:
1820 return &bpf_task_pt_regs_proto;
1821 case BPF_FUNC_trace_vprintk:
1822 return bpf_get_trace_vprintk_proto();
1828 void bpf_list_head_free(const struct btf_field *field, void *list_head,
1829 struct bpf_spin_lock *spin_lock)
1831 struct list_head *head = list_head, *orig_head = list_head;
1833 BUILD_BUG_ON(sizeof(struct list_head) > sizeof(struct bpf_list_head));
1834 BUILD_BUG_ON(__alignof__(struct list_head) > __alignof__(struct bpf_list_head));
1836 /* Do the actual list draining outside the lock to not hold the lock for
1837 * too long, and also prevent deadlocks if tracing programs end up
1838 * executing on entry/exit of functions called inside the critical
1839 * section, and end up doing map ops that call bpf_list_head_free for
1840 * the same map value again.
1842 __bpf_spin_lock_irqsave(spin_lock);
1843 if (!head->next || list_empty(head))
1847 INIT_LIST_HEAD(orig_head);
1848 __bpf_spin_unlock_irqrestore(spin_lock);
1850 while (head != orig_head) {
1853 obj -= field->graph_root.node_offset;
1855 /* The contained type can also have resources, including a
1856 * bpf_list_head which needs to be freed.
1859 __bpf_obj_drop_impl(obj, field->graph_root.value_rec, false);
1864 /* Like rbtree_postorder_for_each_entry_safe, but 'pos' and 'n' are
1865 * 'rb_node *', so field name of rb_node within containing struct is not
1868 * Since bpf_rb_tree's node type has a corresponding struct btf_field with
1869 * graph_root.node_offset, it's not necessary to know field name
1870 * or type of node struct
1872 #define bpf_rbtree_postorder_for_each_entry_safe(pos, n, root) \
1873 for (pos = rb_first_postorder(root); \
1874 pos && ({ n = rb_next_postorder(pos); 1; }); \
1877 void bpf_rb_root_free(const struct btf_field *field, void *rb_root,
1878 struct bpf_spin_lock *spin_lock)
1880 struct rb_root_cached orig_root, *root = rb_root;
1881 struct rb_node *pos, *n;
1884 BUILD_BUG_ON(sizeof(struct rb_root_cached) > sizeof(struct bpf_rb_root));
1885 BUILD_BUG_ON(__alignof__(struct rb_root_cached) > __alignof__(struct bpf_rb_root));
1887 __bpf_spin_lock_irqsave(spin_lock);
1889 *root = RB_ROOT_CACHED;
1890 __bpf_spin_unlock_irqrestore(spin_lock);
1892 bpf_rbtree_postorder_for_each_entry_safe(pos, n, &orig_root.rb_root) {
1894 obj -= field->graph_root.node_offset;
1898 __bpf_obj_drop_impl(obj, field->graph_root.value_rec, false);
1903 __bpf_kfunc_start_defs();
1905 __bpf_kfunc void *bpf_obj_new_impl(u64 local_type_id__k, void *meta__ign)
1907 struct btf_struct_meta *meta = meta__ign;
1908 u64 size = local_type_id__k;
1911 p = bpf_mem_alloc(&bpf_global_ma, size);
1915 bpf_obj_init(meta->record, p);
1919 __bpf_kfunc void *bpf_percpu_obj_new_impl(u64 local_type_id__k, void *meta__ign)
1921 u64 size = local_type_id__k;
1923 /* The verifier has ensured that meta__ign must be NULL */
1924 return bpf_mem_alloc(&bpf_global_percpu_ma, size);
1927 /* Must be called under migrate_disable(), as required by bpf_mem_free */
1928 void __bpf_obj_drop_impl(void *p, const struct btf_record *rec, bool percpu)
1930 struct bpf_mem_alloc *ma;
1932 if (rec && rec->refcount_off >= 0 &&
1933 !refcount_dec_and_test((refcount_t *)(p + rec->refcount_off))) {
1934 /* Object is refcounted and refcount_dec didn't result in 0
1935 * refcount. Return without freeing the object
1941 bpf_obj_free_fields(rec, p);
1944 ma = &bpf_global_percpu_ma;
1946 ma = &bpf_global_ma;
1947 bpf_mem_free_rcu(ma, p);
1950 __bpf_kfunc void bpf_obj_drop_impl(void *p__alloc, void *meta__ign)
1952 struct btf_struct_meta *meta = meta__ign;
1955 __bpf_obj_drop_impl(p, meta ? meta->record : NULL, false);
1958 __bpf_kfunc void bpf_percpu_obj_drop_impl(void *p__alloc, void *meta__ign)
1960 /* The verifier has ensured that meta__ign must be NULL */
1961 bpf_mem_free_rcu(&bpf_global_percpu_ma, p__alloc);
1964 __bpf_kfunc void *bpf_refcount_acquire_impl(void *p__refcounted_kptr, void *meta__ign)
1966 struct btf_struct_meta *meta = meta__ign;
1967 struct bpf_refcount *ref;
1969 /* Could just cast directly to refcount_t *, but need some code using
1970 * bpf_refcount type so that it is emitted in vmlinux BTF
1972 ref = (struct bpf_refcount *)(p__refcounted_kptr + meta->record->refcount_off);
1973 if (!refcount_inc_not_zero((refcount_t *)ref))
1976 /* Verifier strips KF_RET_NULL if input is owned ref, see is_kfunc_ret_null
1979 return (void *)p__refcounted_kptr;
1982 static int __bpf_list_add(struct bpf_list_node_kern *node,
1983 struct bpf_list_head *head,
1984 bool tail, struct btf_record *rec, u64 off)
1986 struct list_head *n = &node->list_head, *h = (void *)head;
1988 /* If list_head was 0-initialized by map, bpf_obj_init_field wasn't
1989 * called on its fields, so init here
1991 if (unlikely(!h->next))
1994 /* node->owner != NULL implies !list_empty(n), no need to separately
1997 if (cmpxchg(&node->owner, NULL, BPF_PTR_POISON)) {
1998 /* Only called from BPF prog, no need to migrate_disable */
1999 __bpf_obj_drop_impl((void *)n - off, rec, false);
2003 tail ? list_add_tail(n, h) : list_add(n, h);
2004 WRITE_ONCE(node->owner, head);
2009 __bpf_kfunc int bpf_list_push_front_impl(struct bpf_list_head *head,
2010 struct bpf_list_node *node,
2011 void *meta__ign, u64 off)
2013 struct bpf_list_node_kern *n = (void *)node;
2014 struct btf_struct_meta *meta = meta__ign;
2016 return __bpf_list_add(n, head, false, meta ? meta->record : NULL, off);
2019 __bpf_kfunc int bpf_list_push_back_impl(struct bpf_list_head *head,
2020 struct bpf_list_node *node,
2021 void *meta__ign, u64 off)
2023 struct bpf_list_node_kern *n = (void *)node;
2024 struct btf_struct_meta *meta = meta__ign;
2026 return __bpf_list_add(n, head, true, meta ? meta->record : NULL, off);
2029 static struct bpf_list_node *__bpf_list_del(struct bpf_list_head *head, bool tail)
2031 struct list_head *n, *h = (void *)head;
2032 struct bpf_list_node_kern *node;
2034 /* If list_head was 0-initialized by map, bpf_obj_init_field wasn't
2035 * called on its fields, so init here
2037 if (unlikely(!h->next))
2042 n = tail ? h->prev : h->next;
2043 node = container_of(n, struct bpf_list_node_kern, list_head);
2044 if (WARN_ON_ONCE(READ_ONCE(node->owner) != head))
2048 WRITE_ONCE(node->owner, NULL);
2049 return (struct bpf_list_node *)n;
2052 __bpf_kfunc struct bpf_list_node *bpf_list_pop_front(struct bpf_list_head *head)
2054 return __bpf_list_del(head, false);
2057 __bpf_kfunc struct bpf_list_node *bpf_list_pop_back(struct bpf_list_head *head)
2059 return __bpf_list_del(head, true);
2062 __bpf_kfunc struct bpf_rb_node *bpf_rbtree_remove(struct bpf_rb_root *root,
2063 struct bpf_rb_node *node)
2065 struct bpf_rb_node_kern *node_internal = (struct bpf_rb_node_kern *)node;
2066 struct rb_root_cached *r = (struct rb_root_cached *)root;
2067 struct rb_node *n = &node_internal->rb_node;
2069 /* node_internal->owner != root implies either RB_EMPTY_NODE(n) or
2070 * n is owned by some other tree. No need to check RB_EMPTY_NODE(n)
2072 if (READ_ONCE(node_internal->owner) != root)
2075 rb_erase_cached(n, r);
2077 WRITE_ONCE(node_internal->owner, NULL);
2078 return (struct bpf_rb_node *)n;
2081 /* Need to copy rbtree_add_cached's logic here because our 'less' is a BPF
2084 static int __bpf_rbtree_add(struct bpf_rb_root *root,
2085 struct bpf_rb_node_kern *node,
2086 void *less, struct btf_record *rec, u64 off)
2088 struct rb_node **link = &((struct rb_root_cached *)root)->rb_root.rb_node;
2089 struct rb_node *parent = NULL, *n = &node->rb_node;
2090 bpf_callback_t cb = (bpf_callback_t)less;
2091 bool leftmost = true;
2093 /* node->owner != NULL implies !RB_EMPTY_NODE(n), no need to separately
2096 if (cmpxchg(&node->owner, NULL, BPF_PTR_POISON)) {
2097 /* Only called from BPF prog, no need to migrate_disable */
2098 __bpf_obj_drop_impl((void *)n - off, rec, false);
2104 if (cb((uintptr_t)node, (uintptr_t)parent, 0, 0, 0)) {
2105 link = &parent->rb_left;
2107 link = &parent->rb_right;
2112 rb_link_node(n, parent, link);
2113 rb_insert_color_cached(n, (struct rb_root_cached *)root, leftmost);
2114 WRITE_ONCE(node->owner, root);
2118 __bpf_kfunc int bpf_rbtree_add_impl(struct bpf_rb_root *root, struct bpf_rb_node *node,
2119 bool (less)(struct bpf_rb_node *a, const struct bpf_rb_node *b),
2120 void *meta__ign, u64 off)
2122 struct btf_struct_meta *meta = meta__ign;
2123 struct bpf_rb_node_kern *n = (void *)node;
2125 return __bpf_rbtree_add(root, n, (void *)less, meta ? meta->record : NULL, off);
2128 __bpf_kfunc struct bpf_rb_node *bpf_rbtree_first(struct bpf_rb_root *root)
2130 struct rb_root_cached *r = (struct rb_root_cached *)root;
2132 return (struct bpf_rb_node *)rb_first_cached(r);
2136 * bpf_task_acquire - Acquire a reference to a task. A task acquired by this
2137 * kfunc which is not stored in a map as a kptr, must be released by calling
2138 * bpf_task_release().
2139 * @p: The task on which a reference is being acquired.
2141 __bpf_kfunc struct task_struct *bpf_task_acquire(struct task_struct *p)
2143 if (refcount_inc_not_zero(&p->rcu_users))
2149 * bpf_task_release - Release the reference acquired on a task.
2150 * @p: The task on which a reference is being released.
2152 __bpf_kfunc void bpf_task_release(struct task_struct *p)
2154 put_task_struct_rcu_user(p);
2157 __bpf_kfunc void bpf_task_release_dtor(void *p)
2159 put_task_struct_rcu_user(p);
2161 CFI_NOSEAL(bpf_task_release_dtor);
2163 #ifdef CONFIG_CGROUPS
2165 * bpf_cgroup_acquire - Acquire a reference to a cgroup. A cgroup acquired by
2166 * this kfunc which is not stored in a map as a kptr, must be released by
2167 * calling bpf_cgroup_release().
2168 * @cgrp: The cgroup on which a reference is being acquired.
2170 __bpf_kfunc struct cgroup *bpf_cgroup_acquire(struct cgroup *cgrp)
2172 return cgroup_tryget(cgrp) ? cgrp : NULL;
2176 * bpf_cgroup_release - Release the reference acquired on a cgroup.
2177 * If this kfunc is invoked in an RCU read region, the cgroup is guaranteed to
2178 * not be freed until the current grace period has ended, even if its refcount
2180 * @cgrp: The cgroup on which a reference is being released.
2182 __bpf_kfunc void bpf_cgroup_release(struct cgroup *cgrp)
2187 __bpf_kfunc void bpf_cgroup_release_dtor(void *cgrp)
2191 CFI_NOSEAL(bpf_cgroup_release_dtor);
2194 * bpf_cgroup_ancestor - Perform a lookup on an entry in a cgroup's ancestor
2195 * array. A cgroup returned by this kfunc which is not subsequently stored in a
2196 * map, must be released by calling bpf_cgroup_release().
2197 * @cgrp: The cgroup for which we're performing a lookup.
2198 * @level: The level of ancestor to look up.
2200 __bpf_kfunc struct cgroup *bpf_cgroup_ancestor(struct cgroup *cgrp, int level)
2202 struct cgroup *ancestor;
2204 if (level > cgrp->level || level < 0)
2207 /* cgrp's refcnt could be 0 here, but ancestors can still be accessed */
2208 ancestor = cgrp->ancestors[level];
2209 if (!cgroup_tryget(ancestor))
2215 * bpf_cgroup_from_id - Find a cgroup from its ID. A cgroup returned by this
2216 * kfunc which is not subsequently stored in a map, must be released by calling
2217 * bpf_cgroup_release().
2220 __bpf_kfunc struct cgroup *bpf_cgroup_from_id(u64 cgid)
2222 struct cgroup *cgrp;
2224 cgrp = cgroup_get_from_id(cgid);
2231 * bpf_task_under_cgroup - wrap task_under_cgroup_hierarchy() as a kfunc, test
2232 * task's membership of cgroup ancestry.
2233 * @task: the task to be tested
2234 * @ancestor: possible ancestor of @task's cgroup
2236 * Tests whether @task's default cgroup hierarchy is a descendant of @ancestor.
2237 * It follows all the same rules as cgroup_is_descendant, and only applies
2238 * to the default hierarchy.
2240 __bpf_kfunc long bpf_task_under_cgroup(struct task_struct *task,
2241 struct cgroup *ancestor)
2246 ret = task_under_cgroup_hierarchy(task, ancestor);
2252 * bpf_task_get_cgroup1 - Acquires the associated cgroup of a task within a
2253 * specific cgroup1 hierarchy. The cgroup1 hierarchy is identified by its
2255 * @task: The target task
2256 * @hierarchy_id: The ID of a cgroup1 hierarchy
2258 * On success, the cgroup is returen. On failure, NULL is returned.
2260 __bpf_kfunc struct cgroup *
2261 bpf_task_get_cgroup1(struct task_struct *task, int hierarchy_id)
2263 struct cgroup *cgrp = task_get_cgroup1(task, hierarchy_id);
2269 #endif /* CONFIG_CGROUPS */
2272 * bpf_task_from_pid - Find a struct task_struct from its pid by looking it up
2273 * in the root pid namespace idr. If a task is returned, it must either be
2274 * stored in a map, or released with bpf_task_release().
2275 * @pid: The pid of the task being looked up.
2277 __bpf_kfunc struct task_struct *bpf_task_from_pid(s32 pid)
2279 struct task_struct *p;
2282 p = find_task_by_pid_ns(pid, &init_pid_ns);
2284 p = bpf_task_acquire(p);
2291 * bpf_dynptr_slice() - Obtain a read-only pointer to the dynptr data.
2292 * @ptr: The dynptr whose data slice to retrieve
2293 * @offset: Offset into the dynptr
2294 * @buffer__opt: User-provided buffer to copy contents into. May be NULL
2295 * @buffer__szk: Size (in bytes) of the buffer if present. This is the
2296 * length of the requested slice. This must be a constant.
2298 * For non-skb and non-xdp type dynptrs, there is no difference between
2299 * bpf_dynptr_slice and bpf_dynptr_data.
2301 * If buffer__opt is NULL, the call will fail if buffer_opt was needed.
2303 * If the intention is to write to the data slice, please use
2304 * bpf_dynptr_slice_rdwr.
2306 * The user must check that the returned pointer is not null before using it.
2308 * Please note that in the case of skb and xdp dynptrs, bpf_dynptr_slice
2309 * does not change the underlying packet data pointers, so a call to
2310 * bpf_dynptr_slice will not invalidate any ctx->data/data_end pointers in
2313 * Return: NULL if the call failed (eg invalid dynptr), pointer to a read-only
2314 * data slice (can be either direct pointer to the data or a pointer to the user
2315 * provided buffer, with its contents containing the data, if unable to obtain
2318 __bpf_kfunc void *bpf_dynptr_slice(const struct bpf_dynptr_kern *ptr, u32 offset,
2319 void *buffer__opt, u32 buffer__szk)
2321 enum bpf_dynptr_type type;
2322 u32 len = buffer__szk;
2328 err = bpf_dynptr_check_off_len(ptr, offset, len);
2332 type = bpf_dynptr_get_type(ptr);
2335 case BPF_DYNPTR_TYPE_LOCAL:
2336 case BPF_DYNPTR_TYPE_RINGBUF:
2337 return ptr->data + ptr->offset + offset;
2338 case BPF_DYNPTR_TYPE_SKB:
2340 return skb_header_pointer(ptr->data, ptr->offset + offset, len, buffer__opt);
2342 return skb_pointer_if_linear(ptr->data, ptr->offset + offset, len);
2343 case BPF_DYNPTR_TYPE_XDP:
2345 void *xdp_ptr = bpf_xdp_pointer(ptr->data, ptr->offset + offset, len);
2346 if (!IS_ERR_OR_NULL(xdp_ptr))
2351 bpf_xdp_copy_buf(ptr->data, ptr->offset + offset, buffer__opt, len, false);
2355 WARN_ONCE(true, "unknown dynptr type %d\n", type);
2361 * bpf_dynptr_slice_rdwr() - Obtain a writable pointer to the dynptr data.
2362 * @ptr: The dynptr whose data slice to retrieve
2363 * @offset: Offset into the dynptr
2364 * @buffer__opt: User-provided buffer to copy contents into. May be NULL
2365 * @buffer__szk: Size (in bytes) of the buffer if present. This is the
2366 * length of the requested slice. This must be a constant.
2368 * For non-skb and non-xdp type dynptrs, there is no difference between
2369 * bpf_dynptr_slice and bpf_dynptr_data.
2371 * If buffer__opt is NULL, the call will fail if buffer_opt was needed.
2373 * The returned pointer is writable and may point to either directly the dynptr
2374 * data at the requested offset or to the buffer if unable to obtain a direct
2375 * data pointer to (example: the requested slice is to the paged area of an skb
2376 * packet). In the case where the returned pointer is to the buffer, the user
2377 * is responsible for persisting writes through calling bpf_dynptr_write(). This
2378 * usually looks something like this pattern:
2380 * struct eth_hdr *eth = bpf_dynptr_slice_rdwr(&dynptr, 0, buffer, sizeof(buffer));
2382 * return TC_ACT_SHOT;
2384 * // mutate eth header //
2386 * if (eth == buffer)
2387 * bpf_dynptr_write(&ptr, 0, buffer, sizeof(buffer), 0);
2389 * Please note that, as in the example above, the user must check that the
2390 * returned pointer is not null before using it.
2392 * Please also note that in the case of skb and xdp dynptrs, bpf_dynptr_slice_rdwr
2393 * does not change the underlying packet data pointers, so a call to
2394 * bpf_dynptr_slice_rdwr will not invalidate any ctx->data/data_end pointers in
2397 * Return: NULL if the call failed (eg invalid dynptr), pointer to a
2398 * data slice (can be either direct pointer to the data or a pointer to the user
2399 * provided buffer, with its contents containing the data, if unable to obtain
2402 __bpf_kfunc void *bpf_dynptr_slice_rdwr(const struct bpf_dynptr_kern *ptr, u32 offset,
2403 void *buffer__opt, u32 buffer__szk)
2405 if (!ptr->data || __bpf_dynptr_is_rdonly(ptr))
2408 /* bpf_dynptr_slice_rdwr is the same logic as bpf_dynptr_slice.
2410 * For skb-type dynptrs, it is safe to write into the returned pointer
2411 * if the bpf program allows skb data writes. There are two possiblities
2412 * that may occur when calling bpf_dynptr_slice_rdwr:
2414 * 1) The requested slice is in the head of the skb. In this case, the
2415 * returned pointer is directly to skb data, and if the skb is cloned, the
2416 * verifier will have uncloned it (see bpf_unclone_prologue()) already.
2417 * The pointer can be directly written into.
2419 * 2) Some portion of the requested slice is in the paged buffer area.
2420 * In this case, the requested data will be copied out into the buffer
2421 * and the returned pointer will be a pointer to the buffer. The skb
2422 * will not be pulled. To persist the write, the user will need to call
2423 * bpf_dynptr_write(), which will pull the skb and commit the write.
2425 * Similarly for xdp programs, if the requested slice is not across xdp
2426 * fragments, then a direct pointer will be returned, otherwise the data
2427 * will be copied out into the buffer and the user will need to call
2428 * bpf_dynptr_write() to commit changes.
2430 return bpf_dynptr_slice(ptr, offset, buffer__opt, buffer__szk);
2433 __bpf_kfunc int bpf_dynptr_adjust(struct bpf_dynptr_kern *ptr, u32 start, u32 end)
2437 if (!ptr->data || start > end)
2440 size = __bpf_dynptr_size(ptr);
2442 if (start > size || end > size)
2445 ptr->offset += start;
2446 bpf_dynptr_set_size(ptr, end - start);
2451 __bpf_kfunc bool bpf_dynptr_is_null(struct bpf_dynptr_kern *ptr)
2456 __bpf_kfunc bool bpf_dynptr_is_rdonly(struct bpf_dynptr_kern *ptr)
2461 return __bpf_dynptr_is_rdonly(ptr);
2464 __bpf_kfunc __u32 bpf_dynptr_size(const struct bpf_dynptr_kern *ptr)
2469 return __bpf_dynptr_size(ptr);
2472 __bpf_kfunc int bpf_dynptr_clone(struct bpf_dynptr_kern *ptr,
2473 struct bpf_dynptr_kern *clone__uninit)
2476 bpf_dynptr_set_null(clone__uninit);
2480 *clone__uninit = *ptr;
2485 __bpf_kfunc void *bpf_cast_to_kern_ctx(void *obj)
2490 __bpf_kfunc void *bpf_rdonly_cast(const void *obj__ign, u32 btf_id__k)
2492 return (void *)obj__ign;
2495 __bpf_kfunc void bpf_rcu_read_lock(void)
2500 __bpf_kfunc void bpf_rcu_read_unlock(void)
2505 struct bpf_throw_ctx {
2506 struct bpf_prog_aux *aux;
2512 static bool bpf_stack_walker(void *cookie, u64 ip, u64 sp, u64 bp)
2514 struct bpf_throw_ctx *ctx = cookie;
2515 struct bpf_prog *prog;
2517 if (!is_bpf_text_address(ip))
2519 prog = bpf_prog_ksym_find(ip);
2521 if (bpf_is_subprog(prog))
2523 ctx->aux = prog->aux;
2529 __bpf_kfunc void bpf_throw(u64 cookie)
2531 struct bpf_throw_ctx ctx = {};
2533 arch_bpf_stack_walk(bpf_stack_walker, &ctx);
2534 WARN_ON_ONCE(!ctx.aux);
2536 WARN_ON_ONCE(!ctx.aux->exception_boundary);
2537 WARN_ON_ONCE(!ctx.bp);
2538 WARN_ON_ONCE(!ctx.cnt);
2539 /* Prevent KASAN false positives for CONFIG_KASAN_STACK by unpoisoning
2540 * deeper stack depths than ctx.sp as we do not return from bpf_throw,
2541 * which skips compiler generated instrumentation to do the same.
2543 kasan_unpoison_task_stack_below((void *)(long)ctx.sp);
2544 ctx.aux->bpf_exception_cb(cookie, ctx.sp, ctx.bp, 0, 0);
2545 WARN(1, "A call to BPF exception callback should never return\n");
2548 __bpf_kfunc_end_defs();
2550 BTF_KFUNCS_START(generic_btf_ids)
2551 #ifdef CONFIG_CRASH_DUMP
2552 BTF_ID_FLAGS(func, crash_kexec, KF_DESTRUCTIVE)
2554 BTF_ID_FLAGS(func, bpf_obj_new_impl, KF_ACQUIRE | KF_RET_NULL)
2555 BTF_ID_FLAGS(func, bpf_percpu_obj_new_impl, KF_ACQUIRE | KF_RET_NULL)
2556 BTF_ID_FLAGS(func, bpf_obj_drop_impl, KF_RELEASE)
2557 BTF_ID_FLAGS(func, bpf_percpu_obj_drop_impl, KF_RELEASE)
2558 BTF_ID_FLAGS(func, bpf_refcount_acquire_impl, KF_ACQUIRE | KF_RET_NULL | KF_RCU)
2559 BTF_ID_FLAGS(func, bpf_list_push_front_impl)
2560 BTF_ID_FLAGS(func, bpf_list_push_back_impl)
2561 BTF_ID_FLAGS(func, bpf_list_pop_front, KF_ACQUIRE | KF_RET_NULL)
2562 BTF_ID_FLAGS(func, bpf_list_pop_back, KF_ACQUIRE | KF_RET_NULL)
2563 BTF_ID_FLAGS(func, bpf_task_acquire, KF_ACQUIRE | KF_RCU | KF_RET_NULL)
2564 BTF_ID_FLAGS(func, bpf_task_release, KF_RELEASE)
2565 BTF_ID_FLAGS(func, bpf_rbtree_remove, KF_ACQUIRE | KF_RET_NULL)
2566 BTF_ID_FLAGS(func, bpf_rbtree_add_impl)
2567 BTF_ID_FLAGS(func, bpf_rbtree_first, KF_RET_NULL)
2569 #ifdef CONFIG_CGROUPS
2570 BTF_ID_FLAGS(func, bpf_cgroup_acquire, KF_ACQUIRE | KF_RCU | KF_RET_NULL)
2571 BTF_ID_FLAGS(func, bpf_cgroup_release, KF_RELEASE)
2572 BTF_ID_FLAGS(func, bpf_cgroup_ancestor, KF_ACQUIRE | KF_RCU | KF_RET_NULL)
2573 BTF_ID_FLAGS(func, bpf_cgroup_from_id, KF_ACQUIRE | KF_RET_NULL)
2574 BTF_ID_FLAGS(func, bpf_task_under_cgroup, KF_RCU)
2575 BTF_ID_FLAGS(func, bpf_task_get_cgroup1, KF_ACQUIRE | KF_RCU | KF_RET_NULL)
2577 BTF_ID_FLAGS(func, bpf_task_from_pid, KF_ACQUIRE | KF_RET_NULL)
2578 BTF_ID_FLAGS(func, bpf_throw)
2579 BTF_KFUNCS_END(generic_btf_ids)
2581 static const struct btf_kfunc_id_set generic_kfunc_set = {
2582 .owner = THIS_MODULE,
2583 .set = &generic_btf_ids,
2587 BTF_ID_LIST(generic_dtor_ids)
2588 BTF_ID(struct, task_struct)
2589 BTF_ID(func, bpf_task_release_dtor)
2590 #ifdef CONFIG_CGROUPS
2591 BTF_ID(struct, cgroup)
2592 BTF_ID(func, bpf_cgroup_release_dtor)
2595 BTF_KFUNCS_START(common_btf_ids)
2596 BTF_ID_FLAGS(func, bpf_cast_to_kern_ctx)
2597 BTF_ID_FLAGS(func, bpf_rdonly_cast)
2598 BTF_ID_FLAGS(func, bpf_rcu_read_lock)
2599 BTF_ID_FLAGS(func, bpf_rcu_read_unlock)
2600 BTF_ID_FLAGS(func, bpf_dynptr_slice, KF_RET_NULL)
2601 BTF_ID_FLAGS(func, bpf_dynptr_slice_rdwr, KF_RET_NULL)
2602 BTF_ID_FLAGS(func, bpf_iter_num_new, KF_ITER_NEW)
2603 BTF_ID_FLAGS(func, bpf_iter_num_next, KF_ITER_NEXT | KF_RET_NULL)
2604 BTF_ID_FLAGS(func, bpf_iter_num_destroy, KF_ITER_DESTROY)
2605 BTF_ID_FLAGS(func, bpf_iter_task_vma_new, KF_ITER_NEW | KF_RCU)
2606 BTF_ID_FLAGS(func, bpf_iter_task_vma_next, KF_ITER_NEXT | KF_RET_NULL)
2607 BTF_ID_FLAGS(func, bpf_iter_task_vma_destroy, KF_ITER_DESTROY)
2608 #ifdef CONFIG_CGROUPS
2609 BTF_ID_FLAGS(func, bpf_iter_css_task_new, KF_ITER_NEW | KF_TRUSTED_ARGS)
2610 BTF_ID_FLAGS(func, bpf_iter_css_task_next, KF_ITER_NEXT | KF_RET_NULL)
2611 BTF_ID_FLAGS(func, bpf_iter_css_task_destroy, KF_ITER_DESTROY)
2612 BTF_ID_FLAGS(func, bpf_iter_css_new, KF_ITER_NEW | KF_TRUSTED_ARGS | KF_RCU_PROTECTED)
2613 BTF_ID_FLAGS(func, bpf_iter_css_next, KF_ITER_NEXT | KF_RET_NULL)
2614 BTF_ID_FLAGS(func, bpf_iter_css_destroy, KF_ITER_DESTROY)
2616 BTF_ID_FLAGS(func, bpf_iter_task_new, KF_ITER_NEW | KF_TRUSTED_ARGS | KF_RCU_PROTECTED)
2617 BTF_ID_FLAGS(func, bpf_iter_task_next, KF_ITER_NEXT | KF_RET_NULL)
2618 BTF_ID_FLAGS(func, bpf_iter_task_destroy, KF_ITER_DESTROY)
2619 BTF_ID_FLAGS(func, bpf_dynptr_adjust)
2620 BTF_ID_FLAGS(func, bpf_dynptr_is_null)
2621 BTF_ID_FLAGS(func, bpf_dynptr_is_rdonly)
2622 BTF_ID_FLAGS(func, bpf_dynptr_size)
2623 BTF_ID_FLAGS(func, bpf_dynptr_clone)
2624 BTF_KFUNCS_END(common_btf_ids)
2626 static const struct btf_kfunc_id_set common_kfunc_set = {
2627 .owner = THIS_MODULE,
2628 .set = &common_btf_ids,
2631 static int __init kfunc_init(void)
2634 const struct btf_id_dtor_kfunc generic_dtors[] = {
2636 .btf_id = generic_dtor_ids[0],
2637 .kfunc_btf_id = generic_dtor_ids[1]
2639 #ifdef CONFIG_CGROUPS
2641 .btf_id = generic_dtor_ids[2],
2642 .kfunc_btf_id = generic_dtor_ids[3]
2647 ret = register_btf_kfunc_id_set(BPF_PROG_TYPE_TRACING, &generic_kfunc_set);
2648 ret = ret ?: register_btf_kfunc_id_set(BPF_PROG_TYPE_SCHED_CLS, &generic_kfunc_set);
2649 ret = ret ?: register_btf_kfunc_id_set(BPF_PROG_TYPE_XDP, &generic_kfunc_set);
2650 ret = ret ?: register_btf_kfunc_id_set(BPF_PROG_TYPE_STRUCT_OPS, &generic_kfunc_set);
2651 ret = ret ?: register_btf_id_dtor_kfuncs(generic_dtors,
2652 ARRAY_SIZE(generic_dtors),
2654 return ret ?: register_btf_kfunc_id_set(BPF_PROG_TYPE_UNSPEC, &common_kfunc_set);
2657 late_initcall(kfunc_init);
2659 /* Get a pointer to dynptr data up to len bytes for read only access. If
2660 * the dynptr doesn't have continuous data up to len bytes, return NULL.
2662 const void *__bpf_dynptr_data(const struct bpf_dynptr_kern *ptr, u32 len)
2664 return bpf_dynptr_slice(ptr, 0, NULL, len);
2667 /* Get a pointer to dynptr data up to len bytes for read write access. If
2668 * the dynptr doesn't have continuous data up to len bytes, or the dynptr
2669 * is read only, return NULL.
2671 void *__bpf_dynptr_data_rw(const struct bpf_dynptr_kern *ptr, u32 len)
2673 if (__bpf_dynptr_is_rdonly(ptr))
2675 return (void *)__bpf_dynptr_data(ptr, len);