~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/include/linux/btf.h

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /include/linux/btf.h (Version linux-6.12-rc7) and /include/linux/btf.h (Version linux-6.1.116)


  1 /* SPDX-License-Identifier: GPL-2.0 */              1 /* SPDX-License-Identifier: GPL-2.0 */
  2 /* Copyright (c) 2018 Facebook */                   2 /* Copyright (c) 2018 Facebook */
  3                                                     3 
  4 #ifndef _LINUX_BTF_H                                4 #ifndef _LINUX_BTF_H
  5 #define _LINUX_BTF_H 1                              5 #define _LINUX_BTF_H 1
  6                                                     6 
  7 #include <linux/types.h>                            7 #include <linux/types.h>
  8 #include <linux/bpfptr.h>                           8 #include <linux/bpfptr.h>
  9 #include <linux/bsearch.h>                     << 
 10 #include <linux/btf_ids.h>                     << 
 11 #include <uapi/linux/btf.h>                         9 #include <uapi/linux/btf.h>
 12 #include <uapi/linux/bpf.h>                        10 #include <uapi/linux/bpf.h>
 13                                                    11 
 14 #define BTF_TYPE_EMIT(type) ((void)(type *)0)      12 #define BTF_TYPE_EMIT(type) ((void)(type *)0)
 15 #define BTF_TYPE_EMIT_ENUM(enum_val) ((void)en     13 #define BTF_TYPE_EMIT_ENUM(enum_val) ((void)enum_val)
 16                                                    14 
 17 /* These need to be macros, as the expressions     15 /* These need to be macros, as the expressions are used in assembler input */
 18 #define KF_ACQUIRE      (1 << 0) /* kfunc is a     16 #define KF_ACQUIRE      (1 << 0) /* kfunc is an acquire function */
 19 #define KF_RELEASE      (1 << 1) /* kfunc is a     17 #define KF_RELEASE      (1 << 1) /* kfunc is a release function */
 20 #define KF_RET_NULL     (1 << 2) /* kfunc retu     18 #define KF_RET_NULL     (1 << 2) /* kfunc returns a pointer that may be NULL */
 21 /* Trusted arguments are those which are guara !!  19 #define KF_KPTR_GET     (1 << 3) /* kfunc returns reference to a kptr */
 22  * the kfunc. It is used to enforce that point !!  20 /* Trusted arguments are those which are meant to be referenced arguments with
 23  * kfuncs, or from the main kernel on a tracep !!  21  * unchanged offset. It is used to enforce that pointers obtained from acquire
 24  * invocation, remain unmodified when being pa !!  22  * kfuncs remain unmodified when being passed to helpers taking trusted args.
 25  * args.                                       !!  23  *
 26  *                                             !!  24  * Consider
 27  * Consider, for example, the following new ta !!  25  *      struct foo {
 28  *                                             !!  26  *              int data;
 29  *      SEC("tp_btf/task_newtask")             !!  27  *              struct foo *next;
 30  *      int BPF_PROG(new_task_tp, struct task_ !!  28  *      };
 31  *      {                                      !!  29  *
 32  *              ...                            !!  30  *      struct bar {
 33  *      }                                      !!  31  *              int data;
 34  *                                             !!  32  *              struct foo f;
 35  * And the following kfunc:                    !!  33  *      };
 36  *                                             !!  34  *
 37  *      BTF_ID_FLAGS(func, bpf_task_acquire, K !!  35  *      struct foo *f = alloc_foo(); // Acquire kfunc
 38  *                                             !!  36  *      struct bar *b = alloc_bar(); // Acquire kfunc
 39  * All invocations to the kfunc must pass the  !!  37  *
 40  *                                             !!  38  * If a kfunc set_foo_data() wants to operate only on the allocated object, it
 41  *      bpf_task_acquire(task);             // !!  39  * will set the KF_TRUSTED_ARGS flag, which will prevent unsafe usage like:
 42  *      bpf_task_acquire(task->last_wakee); // !!  40  *
 43  *                                             !!  41  *      set_foo_data(f, 42);       // Allowed
 44  * Programs may also pass referenced tasks dir !!  42  *      set_foo_data(f->next, 42); // Rejected, non-referenced pointer
 45  *                                             !!  43  *      set_foo_data(&f->next, 42);// Rejected, referenced, but wrong type
 46  *      struct task_struct *acquired;          !!  44  *      set_foo_data(&b->f, 42);   // Rejected, referenced, but bad offset
 47  *                                             !!  45  *
 48  *      acquired = bpf_task_acquire(task);     !!  46  * In the final case, usually for the purposes of type matching, it is deduced
 49  *      bpf_task_acquire(acquired);            !!  47  * by looking at the type of the member at the offset, but due to the
 50  *      bpf_task_acquire(task);                !!  48  * requirement of trusted argument, this deduction will be strict and not done
 51  *      bpf_task_acquire(acquired->last_wakee) !!  49  * for this case.
 52  *                                             << 
 53  * Programs may _not_, however, pass a task fr << 
 54  * kprobe/kretprobe to the kfunc, as BPF canno << 
 55  * pointers are guaranteed to be safe. For exa << 
 56  * would be rejected:                          << 
 57  *                                             << 
 58  * SEC("kretprobe/free_task")                  << 
 59  * int BPF_PROG(free_task_probe, struct task_s << 
 60  * {                                           << 
 61  *      struct task_struct *acquired;          << 
 62  *                                             << 
 63  *      acquired = bpf_task_acquire(acquired); << 
 64  *      bpf_task_release(acquired);            << 
 65  *                                             << 
 66  *      return 0;                              << 
 67  * }                                           << 
 68  */                                                50  */
 69 #define KF_TRUSTED_ARGS (1 << 4) /* kfunc only     51 #define KF_TRUSTED_ARGS (1 << 4) /* kfunc only takes trusted pointer arguments */
 70 #define KF_SLEEPABLE    (1 << 5) /* kfunc may      52 #define KF_SLEEPABLE    (1 << 5) /* kfunc may sleep */
 71 #define KF_DESTRUCTIVE  (1 << 6) /* kfunc perf     53 #define KF_DESTRUCTIVE  (1 << 6) /* kfunc performs destructive actions */
 72 #define KF_RCU          (1 << 7) /* kfunc take << 
 73 /* only one of KF_ITER_{NEW,NEXT,DESTROY} coul << 
 74 #define KF_ITER_NEW     (1 << 8) /* kfunc impl << 
 75 #define KF_ITER_NEXT    (1 << 9) /* kfunc impl << 
 76 #define KF_ITER_DESTROY (1 << 10) /* kfunc imp << 
 77 #define KF_RCU_PROTECTED (1 << 11) /* kfunc sh << 
 78                                                << 
 79 /*                                             << 
 80  * Tag marking a kernel function as a kfunc. T << 
 81  * amount of copy-paste that kfunc authors hav << 
 82  * as to avoid issues such as the compiler inl << 
 83  * kfunc, or a global kfunc in an LTO build.   << 
 84  */                                            << 
 85 #define __bpf_kfunc __used __retain noinline   << 
 86                                                << 
 87 #define __bpf_kfunc_start_defs()               << 
 88         __diag_push();                         << 
 89         __diag_ignore_all("-Wmissing-declarati << 
 90                           "Global kfuncs as th << 
 91         __diag_ignore_all("-Wmissing-prototype << 
 92                           "Global kfuncs as th << 
 93                                                << 
 94 #define __bpf_kfunc_end_defs() __diag_pop()    << 
 95 #define __bpf_hook_start() __bpf_kfunc_start_d << 
 96 #define __bpf_hook_end() __bpf_kfunc_end_defs( << 
 97                                                    54 
 98 /*                                                 55 /*
 99  * Return the name of the passed struct, if ex     56  * Return the name of the passed struct, if exists, or halt the build if for
100  * example the structure gets renamed. In this     57  * example the structure gets renamed. In this way, developers have to revisit
101  * the code using that structure name, and upd     58  * the code using that structure name, and update it accordingly.
102  */                                                59  */
103 #define stringify_struct(x)                        60 #define stringify_struct(x)                     \
104         ({ BUILD_BUG_ON(sizeof(struct x) < 0);     61         ({ BUILD_BUG_ON(sizeof(struct x) < 0);  \
105            __stringify(x); })                      62            __stringify(x); })
106                                                    63 
107 struct btf;                                        64 struct btf;
108 struct btf_member;                                 65 struct btf_member;
109 struct btf_type;                                   66 struct btf_type;
110 union bpf_attr;                                    67 union bpf_attr;
111 struct btf_show;                                   68 struct btf_show;
112 struct btf_id_set;                                 69 struct btf_id_set;
113 struct bpf_prog;                               << 
114                                                << 
115 typedef int (*btf_kfunc_filter_t)(const struct << 
116                                                    70 
117 struct btf_kfunc_id_set {                          71 struct btf_kfunc_id_set {
118         struct module *owner;                      72         struct module *owner;
119         struct btf_id_set8 *set;                   73         struct btf_id_set8 *set;
120         btf_kfunc_filter_t filter;             << 
121 };                                                 74 };
122                                                    75 
123 struct btf_id_dtor_kfunc {                         76 struct btf_id_dtor_kfunc {
124         u32 btf_id;                                77         u32 btf_id;
125         u32 kfunc_btf_id;                          78         u32 kfunc_btf_id;
126 };                                                 79 };
127                                                    80 
128 struct btf_struct_meta {                       !!  81 typedef void (*btf_dtor_kfunc_t)(void *);
129         u32 btf_id;                            << 
130         struct btf_record *record;             << 
131 };                                             << 
132                                                << 
133 struct btf_struct_metas {                      << 
134         u32 cnt;                               << 
135         struct btf_struct_meta types[];        << 
136 };                                             << 
137                                                    82 
138 extern const struct file_operations btf_fops;      83 extern const struct file_operations btf_fops;
139                                                    84 
140 const char *btf_get_name(const struct btf *btf << 
141 void btf_get(struct btf *btf);                     85 void btf_get(struct btf *btf);
142 void btf_put(struct btf *btf);                     86 void btf_put(struct btf *btf);
143 const struct btf_header *btf_header(const stru !!  87 int btf_new_fd(const union bpf_attr *attr, bpfptr_t uattr);
144 int btf_new_fd(const union bpf_attr *attr, bpf << 
145 struct btf *btf_get_by_fd(int fd);                 88 struct btf *btf_get_by_fd(int fd);
146 int btf_get_info_by_fd(const struct btf *btf,      89 int btf_get_info_by_fd(const struct btf *btf,
147                        const union bpf_attr *a     90                        const union bpf_attr *attr,
148                        union bpf_attr __user *     91                        union bpf_attr __user *uattr);
149 /* Figure out the size of a type_id.  If type_     92 /* Figure out the size of a type_id.  If type_id is a modifier
150  * (e.g. const), it will be resolved to find o     93  * (e.g. const), it will be resolved to find out the type with size.
151  *                                                 94  *
152  * For example:                                    95  * For example:
153  * In describing "const void *",  type_id is "     96  * In describing "const void *",  type_id is "const" and "const"
154  * refers to "void *".  The return type will b     97  * refers to "void *".  The return type will be "void *".
155  *                                                 98  *
156  * If type_id is a simple "int", then return t     99  * If type_id is a simple "int", then return type will be "int".
157  *                                                100  *
158  * @btf: struct btf object                        101  * @btf: struct btf object
159  * @type_id: Find out the size of type_id. The    102  * @type_id: Find out the size of type_id. The type_id of the return
160  *           type is set to *type_id.             103  *           type is set to *type_id.
161  * @ret_size: It can be NULL.  If not NULL, th    104  * @ret_size: It can be NULL.  If not NULL, the size of the return
162  *            type is set to *ret_size.           105  *            type is set to *ret_size.
163  * Return: The btf_type (resolved to another t    106  * Return: The btf_type (resolved to another type with size info if needed).
164  *         NULL is returned if type_id itself     107  *         NULL is returned if type_id itself does not have size info
165  *         (e.g. void) or it cannot be resolve    108  *         (e.g. void) or it cannot be resolved to another type that
166  *         has size info.                         109  *         has size info.
167  *         *type_id and *ret_size will not be     110  *         *type_id and *ret_size will not be changed in the
168  *         NULL return case.                      111  *         NULL return case.
169  */                                               112  */
170 const struct btf_type *btf_type_id_size(const     113 const struct btf_type *btf_type_id_size(const struct btf *btf,
171                                         u32 *t    114                                         u32 *type_id,
172                                         u32 *r    115                                         u32 *ret_size);
173                                                   116 
174 /*                                                117 /*
175  * Options to control show behaviour.             118  * Options to control show behaviour.
176  *      - BTF_SHOW_COMPACT: no formatting arou    119  *      - BTF_SHOW_COMPACT: no formatting around type information
177  *      - BTF_SHOW_NONAME: no struct/union mem    120  *      - BTF_SHOW_NONAME: no struct/union member names/types
178  *      - BTF_SHOW_PTR_RAW: show raw (unobfusc    121  *      - BTF_SHOW_PTR_RAW: show raw (unobfuscated) pointer values;
179  *        equivalent to %px.                      122  *        equivalent to %px.
180  *      - BTF_SHOW_ZERO: show zero-valued stru    123  *      - BTF_SHOW_ZERO: show zero-valued struct/union members; they
181  *        are not displayed by default            124  *        are not displayed by default
182  *      - BTF_SHOW_UNSAFE: skip use of bpf_pro    125  *      - BTF_SHOW_UNSAFE: skip use of bpf_probe_read() to safely read
183  *        data before displaying it.              126  *        data before displaying it.
184  */                                               127  */
185 #define BTF_SHOW_COMPACT        BTF_F_COMPACT     128 #define BTF_SHOW_COMPACT        BTF_F_COMPACT
186 #define BTF_SHOW_NONAME         BTF_F_NONAME      129 #define BTF_SHOW_NONAME         BTF_F_NONAME
187 #define BTF_SHOW_PTR_RAW        BTF_F_PTR_RAW     130 #define BTF_SHOW_PTR_RAW        BTF_F_PTR_RAW
188 #define BTF_SHOW_ZERO           BTF_F_ZERO        131 #define BTF_SHOW_ZERO           BTF_F_ZERO
189 #define BTF_SHOW_UNSAFE         (1ULL << 4)       132 #define BTF_SHOW_UNSAFE         (1ULL << 4)
190                                                   133 
191 void btf_type_seq_show(const struct btf *btf,     134 void btf_type_seq_show(const struct btf *btf, u32 type_id, void *obj,
192                        struct seq_file *m);       135                        struct seq_file *m);
193 int btf_type_seq_show_flags(const struct btf *    136 int btf_type_seq_show_flags(const struct btf *btf, u32 type_id, void *obj,
194                             struct seq_file *m    137                             struct seq_file *m, u64 flags);
195                                                   138 
196 /*                                                139 /*
197  * Copy len bytes of string representation of     140  * Copy len bytes of string representation of obj of BTF type_id into buf.
198  *                                                141  *
199  * @btf: struct btf object                        142  * @btf: struct btf object
200  * @type_id: type id of type obj points to        143  * @type_id: type id of type obj points to
201  * @obj: pointer to typed data                    144  * @obj: pointer to typed data
202  * @buf: buffer to write to                       145  * @buf: buffer to write to
203  * @len: maximum length to write to buf           146  * @len: maximum length to write to buf
204  * @flags: show options (see above)               147  * @flags: show options (see above)
205  *                                                148  *
206  * Return: length that would have been/was cop    149  * Return: length that would have been/was copied as per snprintf, or
207  *         negative error.                        150  *         negative error.
208  */                                               151  */
209 int btf_type_snprintf_show(const struct btf *b    152 int btf_type_snprintf_show(const struct btf *btf, u32 type_id, void *obj,
210                            char *buf, int len,    153                            char *buf, int len, u64 flags);
211                                                   154 
212 int btf_get_fd_by_id(u32 id);                     155 int btf_get_fd_by_id(u32 id);
213 u32 btf_obj_id(const struct btf *btf);            156 u32 btf_obj_id(const struct btf *btf);
214 bool btf_is_kernel(const struct btf *btf);        157 bool btf_is_kernel(const struct btf *btf);
215 bool btf_is_module(const struct btf *btf);        158 bool btf_is_module(const struct btf *btf);
216 bool btf_is_vmlinux(const struct btf *btf);    << 
217 struct module *btf_try_get_module(const struct    159 struct module *btf_try_get_module(const struct btf *btf);
218 u32 btf_nr_types(const struct btf *btf);          160 u32 btf_nr_types(const struct btf *btf);
219 struct btf *btf_base_btf(const struct btf *btf << 
220 bool btf_member_is_reg_int(const struct btf *b    161 bool btf_member_is_reg_int(const struct btf *btf, const struct btf_type *s,
221                            const struct btf_me    162                            const struct btf_member *m,
222                            u32 expected_offset    163                            u32 expected_offset, u32 expected_size);
223 struct btf_record *btf_parse_fields(const stru !! 164 int btf_find_spin_lock(const struct btf *btf, const struct btf_type *t);
224                                     u32 field_ !! 165 int btf_find_timer(const struct btf *btf, const struct btf_type *t);
225 int btf_check_and_fixup_fields(const struct bt !! 166 struct bpf_map_value_off *btf_parse_kptrs(const struct btf *btf,
                                                   >> 167                                           const struct btf_type *t);
226 bool btf_type_is_void(const struct btf_type *t    168 bool btf_type_is_void(const struct btf_type *t);
227 s32 btf_find_by_name_kind(const struct btf *bt    169 s32 btf_find_by_name_kind(const struct btf *btf, const char *name, u8 kind);
228 s32 bpf_find_btf_id(const char *name, u32 kind << 
229 const struct btf_type *btf_type_skip_modifiers    170 const struct btf_type *btf_type_skip_modifiers(const struct btf *btf,
230                                                   171                                                u32 id, u32 *res_id);
231 const struct btf_type *btf_type_resolve_ptr(co    172 const struct btf_type *btf_type_resolve_ptr(const struct btf *btf,
232                                             u3    173                                             u32 id, u32 *res_id);
233 const struct btf_type *btf_type_resolve_func_p    174 const struct btf_type *btf_type_resolve_func_ptr(const struct btf *btf,
234                                                   175                                                  u32 id, u32 *res_id);
235 const struct btf_type *                           176 const struct btf_type *
236 btf_resolve_size(const struct btf *btf, const     177 btf_resolve_size(const struct btf *btf, const struct btf_type *type,
237                  u32 *type_size);                 178                  u32 *type_size);
238 const char *btf_type_str(const struct btf_type    179 const char *btf_type_str(const struct btf_type *t);
239                                                   180 
240 #define for_each_member(i, struct_type, member    181 #define for_each_member(i, struct_type, member)                 \
241         for (i = 0, member = btf_type_member(s    182         for (i = 0, member = btf_type_member(struct_type);      \
242              i < btf_type_vlen(struct_type);      183              i < btf_type_vlen(struct_type);                    \
243              i++, member++)                       184              i++, member++)
244                                                   185 
245 #define for_each_vsi(i, datasec_type, member)     186 #define for_each_vsi(i, datasec_type, member)                   \
246         for (i = 0, member = btf_type_var_seci    187         for (i = 0, member = btf_type_var_secinfo(datasec_type);        \
247              i < btf_type_vlen(datasec_type);     188              i < btf_type_vlen(datasec_type);                   \
248              i++, member++)                       189              i++, member++)
249                                                   190 
250 static inline bool btf_type_is_ptr(const struc    191 static inline bool btf_type_is_ptr(const struct btf_type *t)
251 {                                                 192 {
252         return BTF_INFO_KIND(t->info) == BTF_K    193         return BTF_INFO_KIND(t->info) == BTF_KIND_PTR;
253 }                                                 194 }
254                                                   195 
255 static inline bool btf_type_is_int(const struc    196 static inline bool btf_type_is_int(const struct btf_type *t)
256 {                                                 197 {
257         return BTF_INFO_KIND(t->info) == BTF_K    198         return BTF_INFO_KIND(t->info) == BTF_KIND_INT;
258 }                                                 199 }
259                                                   200 
260 static inline bool btf_type_is_small_int(const    201 static inline bool btf_type_is_small_int(const struct btf_type *t)
261 {                                                 202 {
262         return btf_type_is_int(t) && t->size <    203         return btf_type_is_int(t) && t->size <= sizeof(u64);
263 }                                                 204 }
264                                                   205 
265 static inline u8 btf_int_encoding(const struct << 
266 {                                              << 
267         return BTF_INT_ENCODING(*(u32 *)(t + 1 << 
268 }                                              << 
269                                                << 
270 static inline bool btf_type_is_signed_int(cons << 
271 {                                              << 
272         return btf_type_is_int(t) && (btf_int_ << 
273 }                                              << 
274                                                << 
275 static inline bool btf_type_is_enum(const stru    206 static inline bool btf_type_is_enum(const struct btf_type *t)
276 {                                                 207 {
277         return BTF_INFO_KIND(t->info) == BTF_K    208         return BTF_INFO_KIND(t->info) == BTF_KIND_ENUM;
278 }                                                 209 }
279                                                   210 
280 static inline bool btf_is_any_enum(const struc    211 static inline bool btf_is_any_enum(const struct btf_type *t)
281 {                                                 212 {
282         return BTF_INFO_KIND(t->info) == BTF_K    213         return BTF_INFO_KIND(t->info) == BTF_KIND_ENUM ||
283                BTF_INFO_KIND(t->info) == BTF_K    214                BTF_INFO_KIND(t->info) == BTF_KIND_ENUM64;
284 }                                                 215 }
285                                                   216 
286 static inline bool btf_kind_core_compat(const     217 static inline bool btf_kind_core_compat(const struct btf_type *t1,
287                                         const     218                                         const struct btf_type *t2)
288 {                                                 219 {
289         return BTF_INFO_KIND(t1->info) == BTF_    220         return BTF_INFO_KIND(t1->info) == BTF_INFO_KIND(t2->info) ||
290                (btf_is_any_enum(t1) && btf_is_    221                (btf_is_any_enum(t1) && btf_is_any_enum(t2));
291 }                                                 222 }
292                                                   223 
293 static inline bool str_is_empty(const char *s)    224 static inline bool str_is_empty(const char *s)
294 {                                                 225 {
295         return !s || !s[0];                       226         return !s || !s[0];
296 }                                                 227 }
297                                                   228 
298 static inline u16 btf_kind(const struct btf_ty    229 static inline u16 btf_kind(const struct btf_type *t)
299 {                                                 230 {
300         return BTF_INFO_KIND(t->info);            231         return BTF_INFO_KIND(t->info);
301 }                                                 232 }
302                                                   233 
303 static inline bool btf_is_enum(const struct bt    234 static inline bool btf_is_enum(const struct btf_type *t)
304 {                                                 235 {
305         return btf_kind(t) == BTF_KIND_ENUM;      236         return btf_kind(t) == BTF_KIND_ENUM;
306 }                                                 237 }
307                                                   238 
308 static inline bool btf_is_enum64(const struct     239 static inline bool btf_is_enum64(const struct btf_type *t)
309 {                                                 240 {
310         return btf_kind(t) == BTF_KIND_ENUM64;    241         return btf_kind(t) == BTF_KIND_ENUM64;
311 }                                                 242 }
312                                                   243 
313 static inline u64 btf_enum64_value(const struc    244 static inline u64 btf_enum64_value(const struct btf_enum64 *e)
314 {                                                 245 {
315         return ((u64)e->val_hi32 << 32) | e->v    246         return ((u64)e->val_hi32 << 32) | e->val_lo32;
316 }                                                 247 }
317                                                   248 
318 static inline bool btf_is_composite(const stru    249 static inline bool btf_is_composite(const struct btf_type *t)
319 {                                                 250 {
320         u16 kind = btf_kind(t);                   251         u16 kind = btf_kind(t);
321                                                   252 
322         return kind == BTF_KIND_STRUCT || kind    253         return kind == BTF_KIND_STRUCT || kind == BTF_KIND_UNION;
323 }                                                 254 }
324                                                   255 
325 static inline bool btf_is_array(const struct b    256 static inline bool btf_is_array(const struct btf_type *t)
326 {                                                 257 {
327         return btf_kind(t) == BTF_KIND_ARRAY;     258         return btf_kind(t) == BTF_KIND_ARRAY;
328 }                                                 259 }
329                                                   260 
330 static inline bool btf_is_int(const struct btf    261 static inline bool btf_is_int(const struct btf_type *t)
331 {                                                 262 {
332         return btf_kind(t) == BTF_KIND_INT;       263         return btf_kind(t) == BTF_KIND_INT;
333 }                                                 264 }
334                                                   265 
335 static inline bool btf_is_ptr(const struct btf    266 static inline bool btf_is_ptr(const struct btf_type *t)
336 {                                                 267 {
337         return btf_kind(t) == BTF_KIND_PTR;       268         return btf_kind(t) == BTF_KIND_PTR;
338 }                                                 269 }
339                                                   270 
340 static inline u8 btf_int_offset(const struct b    271 static inline u8 btf_int_offset(const struct btf_type *t)
341 {                                                 272 {
342         return BTF_INT_OFFSET(*(u32 *)(t + 1))    273         return BTF_INT_OFFSET(*(u32 *)(t + 1));
343 }                                                 274 }
344                                                   275 
345 static inline __u8 btf_int_bits(const struct b !! 276 static inline u8 btf_int_encoding(const struct btf_type *t)
346 {                                                 277 {
347         return BTF_INT_BITS(*(__u32 *)(t + 1)) !! 278         return BTF_INT_ENCODING(*(u32 *)(t + 1));
348 }                                                 279 }
349                                                   280 
350 static inline bool btf_type_is_scalar(const st    281 static inline bool btf_type_is_scalar(const struct btf_type *t)
351 {                                                 282 {
352         return btf_type_is_int(t) || btf_type_    283         return btf_type_is_int(t) || btf_type_is_enum(t);
353 }                                                 284 }
354                                                   285 
355 static inline bool btf_type_is_typedef(const s    286 static inline bool btf_type_is_typedef(const struct btf_type *t)
356 {                                                 287 {
357         return BTF_INFO_KIND(t->info) == BTF_K    288         return BTF_INFO_KIND(t->info) == BTF_KIND_TYPEDEF;
358 }                                                 289 }
359                                                   290 
360 static inline bool btf_type_is_volatile(const  << 
361 {                                              << 
362         return BTF_INFO_KIND(t->info) == BTF_K << 
363 }                                              << 
364                                                << 
365 static inline bool btf_type_is_func(const stru    291 static inline bool btf_type_is_func(const struct btf_type *t)
366 {                                                 292 {
367         return BTF_INFO_KIND(t->info) == BTF_K    293         return BTF_INFO_KIND(t->info) == BTF_KIND_FUNC;
368 }                                                 294 }
369                                                   295 
370 static inline bool btf_type_is_func_proto(cons    296 static inline bool btf_type_is_func_proto(const struct btf_type *t)
371 {                                                 297 {
372         return BTF_INFO_KIND(t->info) == BTF_K    298         return BTF_INFO_KIND(t->info) == BTF_KIND_FUNC_PROTO;
373 }                                                 299 }
374                                                   300 
375 static inline bool btf_type_is_var(const struc    301 static inline bool btf_type_is_var(const struct btf_type *t)
376 {                                                 302 {
377         return BTF_INFO_KIND(t->info) == BTF_K    303         return BTF_INFO_KIND(t->info) == BTF_KIND_VAR;
378 }                                                 304 }
379                                                   305 
380 static inline bool btf_type_is_type_tag(const     306 static inline bool btf_type_is_type_tag(const struct btf_type *t)
381 {                                                 307 {
382         return BTF_INFO_KIND(t->info) == BTF_K    308         return BTF_INFO_KIND(t->info) == BTF_KIND_TYPE_TAG;
383 }                                                 309 }
384                                                   310 
385 /* union is only a special case of struct:        311 /* union is only a special case of struct:
386  * all its offsetof(member) == 0                  312  * all its offsetof(member) == 0
387  */                                               313  */
388 static inline bool btf_type_is_struct(const st    314 static inline bool btf_type_is_struct(const struct btf_type *t)
389 {                                                 315 {
390         u8 kind = BTF_INFO_KIND(t->info);         316         u8 kind = BTF_INFO_KIND(t->info);
391                                                   317 
392         return kind == BTF_KIND_STRUCT || kind    318         return kind == BTF_KIND_STRUCT || kind == BTF_KIND_UNION;
393 }                                                 319 }
394                                                   320 
395 static inline bool __btf_type_is_struct(const  << 
396 {                                              << 
397         return BTF_INFO_KIND(t->info) == BTF_K << 
398 }                                              << 
399                                                << 
400 static inline bool btf_type_is_array(const str << 
401 {                                              << 
402         return BTF_INFO_KIND(t->info) == BTF_K << 
403 }                                              << 
404                                                << 
405 static inline u16 btf_type_vlen(const struct b    321 static inline u16 btf_type_vlen(const struct btf_type *t)
406 {                                                 322 {
407         return BTF_INFO_VLEN(t->info);            323         return BTF_INFO_VLEN(t->info);
408 }                                                 324 }
409                                                   325 
410 static inline u16 btf_vlen(const struct btf_ty    326 static inline u16 btf_vlen(const struct btf_type *t)
411 {                                                 327 {
412         return btf_type_vlen(t);                  328         return btf_type_vlen(t);
413 }                                                 329 }
414                                                   330 
415 static inline u16 btf_func_linkage(const struc    331 static inline u16 btf_func_linkage(const struct btf_type *t)
416 {                                                 332 {
417         return BTF_INFO_VLEN(t->info);            333         return BTF_INFO_VLEN(t->info);
418 }                                                 334 }
419                                                   335 
420 static inline bool btf_type_kflag(const struct    336 static inline bool btf_type_kflag(const struct btf_type *t)
421 {                                                 337 {
422         return BTF_INFO_KFLAG(t->info);           338         return BTF_INFO_KFLAG(t->info);
423 }                                                 339 }
424                                                   340 
425 static inline u32 __btf_member_bit_offset(cons    341 static inline u32 __btf_member_bit_offset(const struct btf_type *struct_type,
426                                           cons    342                                           const struct btf_member *member)
427 {                                                 343 {
428         return btf_type_kflag(struct_type) ? B    344         return btf_type_kflag(struct_type) ? BTF_MEMBER_BIT_OFFSET(member->offset)
429                                            : m    345                                            : member->offset;
430 }                                                 346 }
431                                                   347 
432 static inline u32 __btf_member_bitfield_size(c    348 static inline u32 __btf_member_bitfield_size(const struct btf_type *struct_type,
433                                              c    349                                              const struct btf_member *member)
434 {                                                 350 {
435         return btf_type_kflag(struct_type) ? B    351         return btf_type_kflag(struct_type) ? BTF_MEMBER_BITFIELD_SIZE(member->offset)
436                                            : 0    352                                            : 0;
437 }                                                 353 }
438                                                   354 
439 static inline struct btf_member *btf_members(c    355 static inline struct btf_member *btf_members(const struct btf_type *t)
440 {                                                 356 {
441         return (struct btf_member *)(t + 1);      357         return (struct btf_member *)(t + 1);
442 }                                                 358 }
443                                                   359 
444 static inline u32 btf_member_bit_offset(const     360 static inline u32 btf_member_bit_offset(const struct btf_type *t, u32 member_idx)
445 {                                                 361 {
446         const struct btf_member *m = btf_membe    362         const struct btf_member *m = btf_members(t) + member_idx;
447                                                   363 
448         return __btf_member_bit_offset(t, m);     364         return __btf_member_bit_offset(t, m);
449 }                                                 365 }
450                                                   366 
451 static inline u32 btf_member_bitfield_size(con    367 static inline u32 btf_member_bitfield_size(const struct btf_type *t, u32 member_idx)
452 {                                                 368 {
453         const struct btf_member *m = btf_membe    369         const struct btf_member *m = btf_members(t) + member_idx;
454                                                   370 
455         return __btf_member_bitfield_size(t, m    371         return __btf_member_bitfield_size(t, m);
456 }                                                 372 }
457                                                   373 
458 static inline const struct btf_member *btf_typ    374 static inline const struct btf_member *btf_type_member(const struct btf_type *t)
459 {                                                 375 {
460         return (const struct btf_member *)(t +    376         return (const struct btf_member *)(t + 1);
461 }                                                 377 }
462                                                   378 
463 static inline struct btf_array *btf_array(cons    379 static inline struct btf_array *btf_array(const struct btf_type *t)
464 {                                                 380 {
465         return (struct btf_array *)(t + 1);       381         return (struct btf_array *)(t + 1);
466 }                                                 382 }
467                                                   383 
468 static inline struct btf_enum *btf_enum(const     384 static inline struct btf_enum *btf_enum(const struct btf_type *t)
469 {                                                 385 {
470         return (struct btf_enum *)(t + 1);        386         return (struct btf_enum *)(t + 1);
471 }                                                 387 }
472                                                   388 
473 static inline struct btf_enum64 *btf_enum64(co    389 static inline struct btf_enum64 *btf_enum64(const struct btf_type *t)
474 {                                                 390 {
475         return (struct btf_enum64 *)(t + 1);      391         return (struct btf_enum64 *)(t + 1);
476 }                                                 392 }
477                                                   393 
478 static inline const struct btf_var_secinfo *bt    394 static inline const struct btf_var_secinfo *btf_type_var_secinfo(
479                 const struct btf_type *t)         395                 const struct btf_type *t)
480 {                                                 396 {
481         return (const struct btf_var_secinfo *    397         return (const struct btf_var_secinfo *)(t + 1);
482 }                                                 398 }
483                                                   399 
484 static inline struct btf_param *btf_params(con    400 static inline struct btf_param *btf_params(const struct btf_type *t)
485 {                                                 401 {
486         return (struct btf_param *)(t + 1);       402         return (struct btf_param *)(t + 1);
487 }                                                 403 }
488                                                   404 
489 static inline struct btf_decl_tag *btf_decl_ta << 
490 {                                              << 
491         return (struct btf_decl_tag *)(t + 1); << 
492 }                                              << 
493                                                << 
494 static inline int btf_id_cmp_func(const void * << 
495 {                                              << 
496         const int *pa = a, *pb = b;            << 
497                                                << 
498         return *pa - *pb;                      << 
499 }                                              << 
500                                                << 
501 static inline bool btf_id_set_contains(const s << 
502 {                                              << 
503         return bsearch(&id, set->ids, set->cnt << 
504 }                                              << 
505                                                << 
506 static inline void *btf_id_set8_contains(const << 
507 {                                              << 
508         return bsearch(&id, set->pairs, set->c << 
509 }                                              << 
510                                                << 
511 bool btf_param_match_suffix(const struct btf * << 
512                             const struct btf_p << 
513                             const char *suffix << 
514 int btf_ctx_arg_offset(const struct btf *btf,  << 
515                        u32 arg_no);            << 
516                                                << 
517 struct bpf_verifier_log;                       << 
518                                                << 
519 #if defined(CONFIG_BPF_JIT) && defined(CONFIG_ << 
520 struct bpf_struct_ops;                         << 
521 int __register_bpf_struct_ops(struct bpf_struc << 
522 const struct bpf_struct_ops_desc *bpf_struct_o << 
523 const struct bpf_struct_ops_desc *bpf_struct_o << 
524 #else                                          << 
525 static inline const struct bpf_struct_ops_desc << 
526 {                                              << 
527         return NULL;                           << 
528 }                                              << 
529 #endif                                         << 
530                                                << 
531 enum btf_field_iter_kind {                     << 
532         BTF_FIELD_ITER_IDS,                    << 
533         BTF_FIELD_ITER_STRS,                   << 
534 };                                             << 
535                                                << 
536 struct btf_field_desc {                        << 
537         /* once-per-type offsets */            << 
538         int t_off_cnt, t_offs[2];              << 
539         /* member struct size, or zero, if no  << 
540         int m_sz;                              << 
541         /* repeated per-member offsets */      << 
542         int m_off_cnt, m_offs[1];              << 
543 };                                             << 
544                                                << 
545 struct btf_field_iter {                        << 
546         struct btf_field_desc desc;            << 
547         void *p;                               << 
548         int m_idx;                             << 
549         int off_idx;                           << 
550         int vlen;                              << 
551 };                                             << 
552                                                << 
553 #ifdef CONFIG_BPF_SYSCALL                         405 #ifdef CONFIG_BPF_SYSCALL
554 const struct btf_type *btf_type_by_id(const st !! 406 struct bpf_prog;
555 void btf_set_base_btf(struct btf *btf, const s << 
556 int btf_relocate(struct btf *btf, const struct << 
557 int btf_field_iter_init(struct btf_field_iter  << 
558                         enum btf_field_iter_ki << 
559 __u32 *btf_field_iter_next(struct btf_field_it << 
560                                                   407 
                                                   >> 408 const struct btf_type *btf_type_by_id(const struct btf *btf, u32 type_id);
561 const char *btf_name_by_offset(const struct bt    409 const char *btf_name_by_offset(const struct btf *btf, u32 offset);
562 const char *btf_str_by_offset(const struct btf << 
563 struct btf *btf_parse_vmlinux(void);              410 struct btf *btf_parse_vmlinux(void);
564 struct btf *bpf_prog_get_target_btf(const stru    411 struct btf *bpf_prog_get_target_btf(const struct bpf_prog *prog);
565 u32 *btf_kfunc_id_set_contains(const struct bt !! 412 u32 *btf_kfunc_id_set_contains(const struct btf *btf,
566                                const struct bp !! 413                                enum bpf_prog_type prog_type,
567 u32 *btf_kfunc_is_modify_return(const struct b !! 414                                u32 kfunc_btf_id);
568                                 const struct b << 
569 int register_btf_kfunc_id_set(enum bpf_prog_ty    415 int register_btf_kfunc_id_set(enum bpf_prog_type prog_type,
570                               const struct btf    416                               const struct btf_kfunc_id_set *s);
571 int register_btf_fmodret_id_set(const struct b << 
572 s32 btf_find_dtor_kfunc(struct btf *btf, u32 b    417 s32 btf_find_dtor_kfunc(struct btf *btf, u32 btf_id);
573 int register_btf_id_dtor_kfuncs(const struct b    418 int register_btf_id_dtor_kfuncs(const struct btf_id_dtor_kfunc *dtors, u32 add_cnt,
574                                 struct module     419                                 struct module *owner);
575 struct btf_struct_meta *btf_find_struct_meta(c << 
576 bool btf_is_projection_of(const char *pname, c << 
577 bool btf_is_prog_ctx_type(struct bpf_verifier_ << 
578                            const struct btf_ty << 
579                            int arg);           << 
580 int get_kern_ctx_btf_id(struct bpf_verifier_lo << 
581 bool btf_types_are_same(const struct btf *btf1 << 
582                         const struct btf *btf2 << 
583 int btf_check_iter_arg(struct btf *btf, const  << 
584 #else                                             420 #else
585 static inline const struct btf_type *btf_type_    421 static inline const struct btf_type *btf_type_by_id(const struct btf *btf,
586                                                   422                                                     u32 type_id)
587 {                                                 423 {
588         return NULL;                              424         return NULL;
589 }                                                 425 }
590                                                << 
591 static inline void btf_set_base_btf(struct btf << 
592 {                                              << 
593 }                                              << 
594                                                << 
595 static inline int btf_relocate(void *log, stru << 
596                                __u32 **map_ids << 
597 {                                              << 
598         return -EOPNOTSUPP;                    << 
599 }                                              << 
600                                                << 
601 static inline int btf_field_iter_init(struct b << 
602                                       enum btf << 
603 {                                              << 
604         return -EOPNOTSUPP;                    << 
605 }                                              << 
606                                                << 
607 static inline __u32 *btf_field_iter_next(struc << 
608 {                                              << 
609         return NULL;                           << 
610 }                                              << 
611                                                << 
612 static inline const char *btf_name_by_offset(c    426 static inline const char *btf_name_by_offset(const struct btf *btf,
613                                              u    427                                              u32 offset)
614 {                                                 428 {
615         return NULL;                              429         return NULL;
616 }                                                 430 }
617 static inline u32 *btf_kfunc_id_set_contains(c    431 static inline u32 *btf_kfunc_id_set_contains(const struct btf *btf,
618                                              u !! 432                                              enum bpf_prog_type prog_type,
619                                              s !! 433                                              u32 kfunc_btf_id)
620                                                << 
621 {                                                 434 {
622         return NULL;                              435         return NULL;
623 }                                                 436 }
624 static inline int register_btf_kfunc_id_set(en    437 static inline int register_btf_kfunc_id_set(enum bpf_prog_type prog_type,
625                                             co    438                                             const struct btf_kfunc_id_set *s)
626 {                                                 439 {
627         return 0;                                 440         return 0;
628 }                                                 441 }
629 static inline s32 btf_find_dtor_kfunc(struct b    442 static inline s32 btf_find_dtor_kfunc(struct btf *btf, u32 btf_id)
630 {                                                 443 {
631         return -ENOENT;                           444         return -ENOENT;
632 }                                                 445 }
633 static inline int register_btf_id_dtor_kfuncs(    446 static inline int register_btf_id_dtor_kfuncs(const struct btf_id_dtor_kfunc *dtors,
634                                                   447                                               u32 add_cnt, struct module *owner)
635 {                                                 448 {
636         return 0;                                 449         return 0;
637 }                                              << 
638 static inline struct btf_struct_meta *btf_find << 
639 {                                              << 
640         return NULL;                           << 
641 }                                              << 
642 static inline bool                             << 
643 btf_is_prog_ctx_type(struct bpf_verifier_log * << 
644                      const struct btf_type *t, << 
645                      int arg)                  << 
646 {                                              << 
647         return false;                          << 
648 }                                              << 
649 static inline int get_kern_ctx_btf_id(struct b << 
650                                       enum bpf << 
651         return -EINVAL;                        << 
652 }                                              << 
653 static inline bool btf_types_are_same(const st << 
654                                       const st << 
655 {                                              << 
656         return false;                          << 
657 }                                              << 
658 static inline int btf_check_iter_arg(struct bt << 
659 {                                              << 
660         return -EOPNOTSUPP;                    << 
661 }                                                 450 }
662 #endif                                            451 #endif
663                                                   452 
664 static inline bool btf_type_is_struct_ptr(stru    453 static inline bool btf_type_is_struct_ptr(struct btf *btf, const struct btf_type *t)
665 {                                                 454 {
666         if (!btf_type_is_ptr(t))                  455         if (!btf_type_is_ptr(t))
667                 return false;                     456                 return false;
668                                                   457 
669         t = btf_type_skip_modifiers(btf, t->ty    458         t = btf_type_skip_modifiers(btf, t->type, NULL);
670                                                   459 
671         return btf_type_is_struct(t);             460         return btf_type_is_struct(t);
672 }                                                 461 }
673                                                   462 
674 #endif                                            463 #endif
675                                                   464 

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php