blob: 84ad532f28547c2a96c5998ec9a79422bc37503d [file] [log] [blame]
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001/* SPDX-License-Identifier: GPL-2.0 */
2/* Copyright (c) 2018 Facebook */
3
4#include <uapi/linux/btf.h>
5#include <uapi/linux/types.h>
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07006#include <linux/seq_file.h>
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07007#include <linux/compiler.h>
8#include <linux/errno.h>
9#include <linux/slab.h>
Martin KaFai Lauf56a6532018-04-18 15:56:01 -070010#include <linux/anon_inodes.h>
11#include <linux/file.h>
Martin KaFai Lau69b693f2018-04-18 15:55:57 -070012#include <linux/uaccess.h>
13#include <linux/kernel.h>
Martin KaFai Lau78958fc2018-05-04 14:49:51 -070014#include <linux/idr.h>
Martin KaFai Lauf80442a2018-05-22 14:57:18 -070015#include <linux/sort.h>
Martin KaFai Lau69b693f2018-04-18 15:55:57 -070016#include <linux/bpf_verifier.h>
17#include <linux/btf.h>
18
19/* BTF (BPF Type Format) is the meta data format which describes
20 * the data types of BPF program/map. Hence, it basically focus
21 * on the C programming language which the modern BPF is primary
22 * using.
23 *
24 * ELF Section:
25 * ~~~~~~~~~~~
26 * The BTF data is stored under the ".BTF" ELF section
27 *
28 * struct btf_type:
29 * ~~~~~~~~~~~~~~~
30 * Each 'struct btf_type' object describes a C data type.
31 * Depending on the type it is describing, a 'struct btf_type'
32 * object may be followed by more data. F.e.
33 * To describe an array, 'struct btf_type' is followed by
34 * 'struct btf_array'.
35 *
36 * 'struct btf_type' and any extra data following it are
37 * 4 bytes aligned.
38 *
39 * Type section:
40 * ~~~~~~~~~~~~~
41 * The BTF type section contains a list of 'struct btf_type' objects.
42 * Each one describes a C type. Recall from the above section
43 * that a 'struct btf_type' object could be immediately followed by extra
44 * data in order to desribe some particular C types.
45 *
46 * type_id:
47 * ~~~~~~~
48 * Each btf_type object is identified by a type_id. The type_id
49 * is implicitly implied by the location of the btf_type object in
50 * the BTF type section. The first one has type_id 1. The second
51 * one has type_id 2...etc. Hence, an earlier btf_type has
52 * a smaller type_id.
53 *
54 * A btf_type object may refer to another btf_type object by using
55 * type_id (i.e. the "type" in the "struct btf_type").
56 *
57 * NOTE that we cannot assume any reference-order.
58 * A btf_type object can refer to an earlier btf_type object
59 * but it can also refer to a later btf_type object.
60 *
61 * For example, to describe "const void *". A btf_type
62 * object describing "const" may refer to another btf_type
63 * object describing "void *". This type-reference is done
64 * by specifying type_id:
65 *
66 * [1] CONST (anon) type_id=2
67 * [2] PTR (anon) type_id=0
68 *
69 * The above is the btf_verifier debug log:
70 * - Each line started with "[?]" is a btf_type object
71 * - [?] is the type_id of the btf_type object.
72 * - CONST/PTR is the BTF_KIND_XXX
73 * - "(anon)" is the name of the type. It just
74 * happens that CONST and PTR has no name.
75 * - type_id=XXX is the 'u32 type' in btf_type
76 *
77 * NOTE: "void" has type_id 0
78 *
79 * String section:
80 * ~~~~~~~~~~~~~~
81 * The BTF string section contains the names used by the type section.
82 * Each string is referred by an "offset" from the beginning of the
83 * string section.
84 *
85 * Each string is '\0' terminated.
86 *
87 * The first character in the string section must be '\0'
88 * which is used to mean 'anonymous'. Some btf_type may not
89 * have a name.
90 */
91
92/* BTF verification:
93 *
94 * To verify BTF data, two passes are needed.
95 *
96 * Pass #1
97 * ~~~~~~~
98 * The first pass is to collect all btf_type objects to
99 * an array: "btf->types".
100 *
101 * Depending on the C type that a btf_type is describing,
102 * a btf_type may be followed by extra data. We don't know
103 * how many btf_type is there, and more importantly we don't
104 * know where each btf_type is located in the type section.
105 *
106 * Without knowing the location of each type_id, most verifications
107 * cannot be done. e.g. an earlier btf_type may refer to a later
108 * btf_type (recall the "const void *" above), so we cannot
109 * check this type-reference in the first pass.
110 *
111 * In the first pass, it still does some verifications (e.g.
112 * checking the name is a valid offset to the string section).
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700113 *
114 * Pass #2
115 * ~~~~~~~
116 * The main focus is to resolve a btf_type that is referring
117 * to another type.
118 *
119 * We have to ensure the referring type:
120 * 1) does exist in the BTF (i.e. in btf->types[])
121 * 2) does not cause a loop:
122 * struct A {
123 * struct B b;
124 * };
125 *
126 * struct B {
127 * struct A a;
128 * };
129 *
130 * btf_type_needs_resolve() decides if a btf_type needs
131 * to be resolved.
132 *
133 * The needs_resolve type implements the "resolve()" ops which
134 * essentially does a DFS and detects backedge.
135 *
136 * During resolve (or DFS), different C types have different
137 * "RESOLVED" conditions.
138 *
139 * When resolving a BTF_KIND_STRUCT, we need to resolve all its
140 * members because a member is always referring to another
141 * type. A struct's member can be treated as "RESOLVED" if
142 * it is referring to a BTF_KIND_PTR. Otherwise, the
143 * following valid C struct would be rejected:
144 *
145 * struct A {
146 * int m;
147 * struct A *a;
148 * };
149 *
150 * When resolving a BTF_KIND_PTR, it needs to keep resolving if
151 * it is referring to another BTF_KIND_PTR. Otherwise, we cannot
152 * detect a pointer loop, e.g.:
153 * BTF_KIND_CONST -> BTF_KIND_PTR -> BTF_KIND_CONST -> BTF_KIND_PTR +
154 * ^ |
155 * +-----------------------------------------+
156 *
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700157 */
158
159#define BITS_PER_U64 (sizeof(u64) * BITS_PER_BYTE)
160#define BITS_PER_BYTE_MASK (BITS_PER_BYTE - 1)
161#define BITS_PER_BYTE_MASKED(bits) ((bits) & BITS_PER_BYTE_MASK)
162#define BITS_ROUNDDOWN_BYTES(bits) ((bits) >> 3)
163#define BITS_ROUNDUP_BYTES(bits) \
164 (BITS_ROUNDDOWN_BYTES(bits) + !!BITS_PER_BYTE_MASKED(bits))
165
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -0700166#define BTF_INFO_MASK 0x0f00ffff
167#define BTF_INT_MASK 0x0fffffff
168#define BTF_TYPE_ID_VALID(type_id) ((type_id) <= BTF_MAX_TYPE)
169#define BTF_STR_OFFSET_VALID(name_off) ((name_off) <= BTF_MAX_NAME_OFFSET)
170
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700171/* 16MB for 64k structs and each has 16 members and
172 * a few MB spaces for the string section.
173 * The hard limit is S32_MAX.
174 */
175#define BTF_MAX_SIZE (16 * 1024 * 1024)
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700176
177#define for_each_member(i, struct_type, member) \
178 for (i = 0, member = btf_type_member(struct_type); \
179 i < btf_type_vlen(struct_type); \
180 i++, member++)
181
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700182#define for_each_member_from(i, from, struct_type, member) \
183 for (i = from, member = btf_type_member(struct_type) + from; \
184 i < btf_type_vlen(struct_type); \
185 i++, member++)
186
Martin KaFai Lau78958fc2018-05-04 14:49:51 -0700187static DEFINE_IDR(btf_idr);
188static DEFINE_SPINLOCK(btf_idr_lock);
189
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700190struct btf {
Martin KaFai Lauf80442a2018-05-22 14:57:18 -0700191 void *data;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700192 struct btf_type **types;
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700193 u32 *resolved_ids;
194 u32 *resolved_sizes;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700195 const char *strings;
196 void *nohdr_data;
Martin KaFai Lauf80442a2018-05-22 14:57:18 -0700197 struct btf_header hdr;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700198 u32 nr_types;
199 u32 types_size;
200 u32 data_size;
Martin KaFai Lauf56a6532018-04-18 15:56:01 -0700201 refcount_t refcnt;
Martin KaFai Lau78958fc2018-05-04 14:49:51 -0700202 u32 id;
203 struct rcu_head rcu;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700204};
205
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700206enum verifier_phase {
207 CHECK_META,
208 CHECK_TYPE,
209};
210
211struct resolve_vertex {
212 const struct btf_type *t;
213 u32 type_id;
214 u16 next_member;
215};
216
217enum visit_state {
218 NOT_VISITED,
219 VISITED,
220 RESOLVED,
221};
222
223enum resolve_mode {
224 RESOLVE_TBD, /* To Be Determined */
225 RESOLVE_PTR, /* Resolving for Pointer */
226 RESOLVE_STRUCT_OR_ARRAY, /* Resolving for struct/union
227 * or array
228 */
229};
230
231#define MAX_RESOLVE_DEPTH 32
232
Martin KaFai Lauf80442a2018-05-22 14:57:18 -0700233struct btf_sec_info {
234 u32 off;
235 u32 len;
236};
237
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700238struct btf_verifier_env {
239 struct btf *btf;
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700240 u8 *visit_states;
241 struct resolve_vertex stack[MAX_RESOLVE_DEPTH];
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700242 struct bpf_verifier_log log;
243 u32 log_type_id;
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700244 u32 top_stack;
245 enum verifier_phase phase;
246 enum resolve_mode resolve_mode;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700247};
248
249static const char * const btf_kind_str[NR_BTF_KINDS] = {
250 [BTF_KIND_UNKN] = "UNKNOWN",
251 [BTF_KIND_INT] = "INT",
252 [BTF_KIND_PTR] = "PTR",
253 [BTF_KIND_ARRAY] = "ARRAY",
254 [BTF_KIND_STRUCT] = "STRUCT",
255 [BTF_KIND_UNION] = "UNION",
256 [BTF_KIND_ENUM] = "ENUM",
257 [BTF_KIND_FWD] = "FWD",
258 [BTF_KIND_TYPEDEF] = "TYPEDEF",
259 [BTF_KIND_VOLATILE] = "VOLATILE",
260 [BTF_KIND_CONST] = "CONST",
261 [BTF_KIND_RESTRICT] = "RESTRICT",
262};
263
264struct btf_kind_operations {
265 s32 (*check_meta)(struct btf_verifier_env *env,
266 const struct btf_type *t,
267 u32 meta_left);
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700268 int (*resolve)(struct btf_verifier_env *env,
269 const struct resolve_vertex *v);
Martin KaFai Lau179cde82018-04-18 15:55:59 -0700270 int (*check_member)(struct btf_verifier_env *env,
271 const struct btf_type *struct_type,
272 const struct btf_member *member,
273 const struct btf_type *member_type);
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700274 void (*log_details)(struct btf_verifier_env *env,
275 const struct btf_type *t);
Martin KaFai Laub00b8da2018-04-18 15:56:00 -0700276 void (*seq_show)(const struct btf *btf, const struct btf_type *t,
277 u32 type_id, void *data, u8 bits_offsets,
278 struct seq_file *m);
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700279};
280
281static const struct btf_kind_operations * const kind_ops[NR_BTF_KINDS];
282static struct btf_type btf_void;
283
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700284static bool btf_type_is_modifier(const struct btf_type *t)
285{
286 /* Some of them is not strictly a C modifier
287 * but they are grouped into the same bucket
288 * for BTF concern:
289 * A type (t) that refers to another
290 * type through t->type AND its size cannot
291 * be determined without following the t->type.
292 *
293 * ptr does not fall into this bucket
294 * because its size is always sizeof(void *).
295 */
296 switch (BTF_INFO_KIND(t->info)) {
297 case BTF_KIND_TYPEDEF:
298 case BTF_KIND_VOLATILE:
299 case BTF_KIND_CONST:
300 case BTF_KIND_RESTRICT:
301 return true;
302 }
303
304 return false;
305}
306
307static bool btf_type_is_void(const struct btf_type *t)
308{
309 /* void => no type and size info.
310 * Hence, FWD is also treated as void.
311 */
312 return t == &btf_void || BTF_INFO_KIND(t->info) == BTF_KIND_FWD;
313}
314
315static bool btf_type_is_void_or_null(const struct btf_type *t)
316{
317 return !t || btf_type_is_void(t);
318}
319
320/* union is only a special case of struct:
321 * all its offsetof(member) == 0
322 */
323static bool btf_type_is_struct(const struct btf_type *t)
324{
325 u8 kind = BTF_INFO_KIND(t->info);
326
327 return kind == BTF_KIND_STRUCT || kind == BTF_KIND_UNION;
328}
329
330static bool btf_type_is_array(const struct btf_type *t)
331{
332 return BTF_INFO_KIND(t->info) == BTF_KIND_ARRAY;
333}
334
335static bool btf_type_is_ptr(const struct btf_type *t)
336{
337 return BTF_INFO_KIND(t->info) == BTF_KIND_PTR;
338}
339
340static bool btf_type_is_int(const struct btf_type *t)
341{
342 return BTF_INFO_KIND(t->info) == BTF_KIND_INT;
343}
344
345/* What types need to be resolved?
346 *
347 * btf_type_is_modifier() is an obvious one.
348 *
349 * btf_type_is_struct() because its member refers to
350 * another type (through member->type).
351
352 * btf_type_is_array() because its element (array->type)
353 * refers to another type. Array can be thought of a
354 * special case of struct while array just has the same
355 * member-type repeated by array->nelems of times.
356 */
357static bool btf_type_needs_resolve(const struct btf_type *t)
358{
359 return btf_type_is_modifier(t) ||
360 btf_type_is_ptr(t) ||
361 btf_type_is_struct(t) ||
362 btf_type_is_array(t);
363}
364
365/* t->size can be used */
366static bool btf_type_has_size(const struct btf_type *t)
367{
368 switch (BTF_INFO_KIND(t->info)) {
369 case BTF_KIND_INT:
370 case BTF_KIND_STRUCT:
371 case BTF_KIND_UNION:
372 case BTF_KIND_ENUM:
373 return true;
374 }
375
376 return false;
377}
378
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700379static const char *btf_int_encoding_str(u8 encoding)
380{
381 if (encoding == 0)
382 return "(none)";
383 else if (encoding == BTF_INT_SIGNED)
384 return "SIGNED";
385 else if (encoding == BTF_INT_CHAR)
386 return "CHAR";
387 else if (encoding == BTF_INT_BOOL)
388 return "BOOL";
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700389 else
390 return "UNKN";
391}
392
393static u16 btf_type_vlen(const struct btf_type *t)
394{
395 return BTF_INFO_VLEN(t->info);
396}
397
398static u32 btf_type_int(const struct btf_type *t)
399{
400 return *(u32 *)(t + 1);
401}
402
403static const struct btf_array *btf_type_array(const struct btf_type *t)
404{
405 return (const struct btf_array *)(t + 1);
406}
407
408static const struct btf_member *btf_type_member(const struct btf_type *t)
409{
410 return (const struct btf_member *)(t + 1);
411}
412
413static const struct btf_enum *btf_type_enum(const struct btf_type *t)
414{
415 return (const struct btf_enum *)(t + 1);
416}
417
418static const struct btf_kind_operations *btf_type_ops(const struct btf_type *t)
419{
420 return kind_ops[BTF_INFO_KIND(t->info)];
421}
422
423static bool btf_name_offset_valid(const struct btf *btf, u32 offset)
424{
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -0700425 return BTF_STR_OFFSET_VALID(offset) &&
426 offset < btf->hdr.str_len;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700427}
428
429static const char *btf_name_by_offset(const struct btf *btf, u32 offset)
430{
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -0700431 if (!offset)
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700432 return "(anon)";
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -0700433 else if (offset < btf->hdr.str_len)
434 return &btf->strings[offset];
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700435 else
436 return "(invalid-name-offset)";
437}
438
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700439static const struct btf_type *btf_type_by_id(const struct btf *btf, u32 type_id)
440{
441 if (type_id > btf->nr_types)
442 return NULL;
443
444 return btf->types[type_id];
445}
446
Martin KaFai Lau4ef5f572018-05-22 14:57:19 -0700447/*
448 * Regular int is not a bit field and it must be either
449 * u8/u16/u32/u64.
450 */
451static bool btf_type_int_is_regular(const struct btf_type *t)
452{
453 u16 nr_bits, nr_bytes;
454 u32 int_data;
455
456 int_data = btf_type_int(t);
457 nr_bits = BTF_INT_BITS(int_data);
458 nr_bytes = BITS_ROUNDUP_BYTES(nr_bits);
459 if (BITS_PER_BYTE_MASKED(nr_bits) ||
460 BTF_INT_OFFSET(int_data) ||
461 (nr_bytes != sizeof(u8) && nr_bytes != sizeof(u16) &&
462 nr_bytes != sizeof(u32) && nr_bytes != sizeof(u64))) {
463 return false;
464 }
465
466 return true;
467}
468
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700469__printf(2, 3) static void __btf_verifier_log(struct bpf_verifier_log *log,
470 const char *fmt, ...)
471{
472 va_list args;
473
474 va_start(args, fmt);
475 bpf_verifier_vlog(log, fmt, args);
476 va_end(args);
477}
478
479__printf(2, 3) static void btf_verifier_log(struct btf_verifier_env *env,
480 const char *fmt, ...)
481{
482 struct bpf_verifier_log *log = &env->log;
483 va_list args;
484
485 if (!bpf_verifier_log_needed(log))
486 return;
487
488 va_start(args, fmt);
489 bpf_verifier_vlog(log, fmt, args);
490 va_end(args);
491}
492
493__printf(4, 5) static void __btf_verifier_log_type(struct btf_verifier_env *env,
494 const struct btf_type *t,
495 bool log_details,
496 const char *fmt, ...)
497{
498 struct bpf_verifier_log *log = &env->log;
499 u8 kind = BTF_INFO_KIND(t->info);
500 struct btf *btf = env->btf;
501 va_list args;
502
503 if (!bpf_verifier_log_needed(log))
504 return;
505
506 __btf_verifier_log(log, "[%u] %s %s%s",
507 env->log_type_id,
508 btf_kind_str[kind],
Martin KaFai Laufbcf93e2018-04-21 09:48:23 -0700509 btf_name_by_offset(btf, t->name_off),
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700510 log_details ? " " : "");
511
512 if (log_details)
513 btf_type_ops(t)->log_details(env, t);
514
515 if (fmt && *fmt) {
516 __btf_verifier_log(log, " ");
517 va_start(args, fmt);
518 bpf_verifier_vlog(log, fmt, args);
519 va_end(args);
520 }
521
522 __btf_verifier_log(log, "\n");
523}
524
525#define btf_verifier_log_type(env, t, ...) \
526 __btf_verifier_log_type((env), (t), true, __VA_ARGS__)
527#define btf_verifier_log_basic(env, t, ...) \
528 __btf_verifier_log_type((env), (t), false, __VA_ARGS__)
529
530__printf(4, 5)
531static void btf_verifier_log_member(struct btf_verifier_env *env,
532 const struct btf_type *struct_type,
533 const struct btf_member *member,
534 const char *fmt, ...)
535{
536 struct bpf_verifier_log *log = &env->log;
537 struct btf *btf = env->btf;
538 va_list args;
539
540 if (!bpf_verifier_log_needed(log))
541 return;
542
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700543 /* The CHECK_META phase already did a btf dump.
544 *
545 * If member is logged again, it must hit an error in
546 * parsing this member. It is useful to print out which
547 * struct this member belongs to.
548 */
549 if (env->phase != CHECK_META)
550 btf_verifier_log_type(env, struct_type, NULL);
551
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700552 __btf_verifier_log(log, "\t%s type_id=%u bits_offset=%u",
Martin KaFai Laufbcf93e2018-04-21 09:48:23 -0700553 btf_name_by_offset(btf, member->name_off),
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700554 member->type, member->offset);
555
556 if (fmt && *fmt) {
557 __btf_verifier_log(log, " ");
558 va_start(args, fmt);
559 bpf_verifier_vlog(log, fmt, args);
560 va_end(args);
561 }
562
563 __btf_verifier_log(log, "\n");
564}
565
Martin KaFai Lauf80442a2018-05-22 14:57:18 -0700566static void btf_verifier_log_hdr(struct btf_verifier_env *env,
567 u32 btf_data_size)
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700568{
569 struct bpf_verifier_log *log = &env->log;
570 const struct btf *btf = env->btf;
571 const struct btf_header *hdr;
572
573 if (!bpf_verifier_log_needed(log))
574 return;
575
Martin KaFai Lauf80442a2018-05-22 14:57:18 -0700576 hdr = &btf->hdr;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700577 __btf_verifier_log(log, "magic: 0x%x\n", hdr->magic);
578 __btf_verifier_log(log, "version: %u\n", hdr->version);
579 __btf_verifier_log(log, "flags: 0x%x\n", hdr->flags);
Martin KaFai Lauf80442a2018-05-22 14:57:18 -0700580 __btf_verifier_log(log, "hdr_len: %u\n", hdr->hdr_len);
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700581 __btf_verifier_log(log, "type_off: %u\n", hdr->type_off);
Martin KaFai Lauf80442a2018-05-22 14:57:18 -0700582 __btf_verifier_log(log, "type_len: %u\n", hdr->type_len);
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700583 __btf_verifier_log(log, "str_off: %u\n", hdr->str_off);
584 __btf_verifier_log(log, "str_len: %u\n", hdr->str_len);
Martin KaFai Lauf80442a2018-05-22 14:57:18 -0700585 __btf_verifier_log(log, "btf_total_size: %u\n", btf_data_size);
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700586}
587
588static int btf_add_type(struct btf_verifier_env *env, struct btf_type *t)
589{
590 struct btf *btf = env->btf;
591
592 /* < 2 because +1 for btf_void which is always in btf->types[0].
593 * btf_void is not accounted in btf->nr_types because btf_void
594 * does not come from the BTF file.
595 */
596 if (btf->types_size - btf->nr_types < 2) {
597 /* Expand 'types' array */
598
599 struct btf_type **new_types;
600 u32 expand_by, new_size;
601
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -0700602 if (btf->types_size == BTF_MAX_TYPE) {
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700603 btf_verifier_log(env, "Exceeded max num of types");
604 return -E2BIG;
605 }
606
607 expand_by = max_t(u32, btf->types_size >> 2, 16);
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -0700608 new_size = min_t(u32, BTF_MAX_TYPE,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700609 btf->types_size + expand_by);
610
611 new_types = kvzalloc(new_size * sizeof(*new_types),
612 GFP_KERNEL | __GFP_NOWARN);
613 if (!new_types)
614 return -ENOMEM;
615
616 if (btf->nr_types == 0)
617 new_types[0] = &btf_void;
618 else
619 memcpy(new_types, btf->types,
620 sizeof(*btf->types) * (btf->nr_types + 1));
621
622 kvfree(btf->types);
623 btf->types = new_types;
624 btf->types_size = new_size;
625 }
626
627 btf->types[++(btf->nr_types)] = t;
628
629 return 0;
630}
631
Martin KaFai Lau78958fc2018-05-04 14:49:51 -0700632static int btf_alloc_id(struct btf *btf)
633{
634 int id;
635
636 idr_preload(GFP_KERNEL);
637 spin_lock_bh(&btf_idr_lock);
638 id = idr_alloc_cyclic(&btf_idr, btf, 1, INT_MAX, GFP_ATOMIC);
639 if (id > 0)
640 btf->id = id;
641 spin_unlock_bh(&btf_idr_lock);
642 idr_preload_end();
643
644 if (WARN_ON_ONCE(!id))
645 return -ENOSPC;
646
647 return id > 0 ? 0 : id;
648}
649
650static void btf_free_id(struct btf *btf)
651{
652 unsigned long flags;
653
654 /*
655 * In map-in-map, calling map_delete_elem() on outer
656 * map will call bpf_map_put on the inner map.
657 * It will then eventually call btf_free_id()
658 * on the inner map. Some of the map_delete_elem()
659 * implementation may have irq disabled, so
660 * we need to use the _irqsave() version instead
661 * of the _bh() version.
662 */
663 spin_lock_irqsave(&btf_idr_lock, flags);
664 idr_remove(&btf_idr, btf->id);
665 spin_unlock_irqrestore(&btf_idr_lock, flags);
666}
667
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700668static void btf_free(struct btf *btf)
669{
670 kvfree(btf->types);
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700671 kvfree(btf->resolved_sizes);
672 kvfree(btf->resolved_ids);
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700673 kvfree(btf->data);
674 kfree(btf);
675}
676
Martin KaFai Lau78958fc2018-05-04 14:49:51 -0700677static void btf_free_rcu(struct rcu_head *rcu)
Martin KaFai Lauf56a6532018-04-18 15:56:01 -0700678{
Martin KaFai Lau78958fc2018-05-04 14:49:51 -0700679 struct btf *btf = container_of(rcu, struct btf, rcu);
680
681 btf_free(btf);
Martin KaFai Lauf56a6532018-04-18 15:56:01 -0700682}
683
684void btf_put(struct btf *btf)
685{
Martin KaFai Lau78958fc2018-05-04 14:49:51 -0700686 if (btf && refcount_dec_and_test(&btf->refcnt)) {
687 btf_free_id(btf);
688 call_rcu(&btf->rcu, btf_free_rcu);
689 }
Martin KaFai Lauf56a6532018-04-18 15:56:01 -0700690}
691
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700692static int env_resolve_init(struct btf_verifier_env *env)
693{
694 struct btf *btf = env->btf;
695 u32 nr_types = btf->nr_types;
696 u32 *resolved_sizes = NULL;
697 u32 *resolved_ids = NULL;
698 u8 *visit_states = NULL;
699
700 /* +1 for btf_void */
701 resolved_sizes = kvzalloc((nr_types + 1) * sizeof(*resolved_sizes),
702 GFP_KERNEL | __GFP_NOWARN);
703 if (!resolved_sizes)
704 goto nomem;
705
706 resolved_ids = kvzalloc((nr_types + 1) * sizeof(*resolved_ids),
707 GFP_KERNEL | __GFP_NOWARN);
708 if (!resolved_ids)
709 goto nomem;
710
711 visit_states = kvzalloc((nr_types + 1) * sizeof(*visit_states),
712 GFP_KERNEL | __GFP_NOWARN);
713 if (!visit_states)
714 goto nomem;
715
716 btf->resolved_sizes = resolved_sizes;
717 btf->resolved_ids = resolved_ids;
718 env->visit_states = visit_states;
719
720 return 0;
721
722nomem:
723 kvfree(resolved_sizes);
724 kvfree(resolved_ids);
725 kvfree(visit_states);
726 return -ENOMEM;
727}
728
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700729static void btf_verifier_env_free(struct btf_verifier_env *env)
730{
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700731 kvfree(env->visit_states);
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700732 kfree(env);
733}
734
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700735static bool env_type_is_resolve_sink(const struct btf_verifier_env *env,
736 const struct btf_type *next_type)
737{
738 switch (env->resolve_mode) {
739 case RESOLVE_TBD:
740 /* int, enum or void is a sink */
741 return !btf_type_needs_resolve(next_type);
742 case RESOLVE_PTR:
743 /* int, enum, void, struct or array is a sink for ptr */
744 return !btf_type_is_modifier(next_type) &&
745 !btf_type_is_ptr(next_type);
746 case RESOLVE_STRUCT_OR_ARRAY:
747 /* int, enum, void or ptr is a sink for struct and array */
748 return !btf_type_is_modifier(next_type) &&
749 !btf_type_is_array(next_type) &&
750 !btf_type_is_struct(next_type);
751 default:
Arnd Bergmann53c80362018-05-25 23:33:19 +0200752 BUG();
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700753 }
754}
755
756static bool env_type_is_resolved(const struct btf_verifier_env *env,
757 u32 type_id)
758{
759 return env->visit_states[type_id] == RESOLVED;
760}
761
762static int env_stack_push(struct btf_verifier_env *env,
763 const struct btf_type *t, u32 type_id)
764{
765 struct resolve_vertex *v;
766
767 if (env->top_stack == MAX_RESOLVE_DEPTH)
768 return -E2BIG;
769
770 if (env->visit_states[type_id] != NOT_VISITED)
771 return -EEXIST;
772
773 env->visit_states[type_id] = VISITED;
774
775 v = &env->stack[env->top_stack++];
776 v->t = t;
777 v->type_id = type_id;
778 v->next_member = 0;
779
780 if (env->resolve_mode == RESOLVE_TBD) {
781 if (btf_type_is_ptr(t))
782 env->resolve_mode = RESOLVE_PTR;
783 else if (btf_type_is_struct(t) || btf_type_is_array(t))
784 env->resolve_mode = RESOLVE_STRUCT_OR_ARRAY;
785 }
786
787 return 0;
788}
789
790static void env_stack_set_next_member(struct btf_verifier_env *env,
791 u16 next_member)
792{
793 env->stack[env->top_stack - 1].next_member = next_member;
794}
795
796static void env_stack_pop_resolved(struct btf_verifier_env *env,
797 u32 resolved_type_id,
798 u32 resolved_size)
799{
800 u32 type_id = env->stack[--(env->top_stack)].type_id;
801 struct btf *btf = env->btf;
802
803 btf->resolved_sizes[type_id] = resolved_size;
804 btf->resolved_ids[type_id] = resolved_type_id;
805 env->visit_states[type_id] = RESOLVED;
806}
807
808static const struct resolve_vertex *env_stack_peak(struct btf_verifier_env *env)
809{
810 return env->top_stack ? &env->stack[env->top_stack - 1] : NULL;
811}
812
813/* The input param "type_id" must point to a needs_resolve type */
814static const struct btf_type *btf_type_id_resolve(const struct btf *btf,
815 u32 *type_id)
816{
817 *type_id = btf->resolved_ids[*type_id];
818 return btf_type_by_id(btf, *type_id);
819}
820
821const struct btf_type *btf_type_id_size(const struct btf *btf,
822 u32 *type_id, u32 *ret_size)
823{
824 const struct btf_type *size_type;
825 u32 size_type_id = *type_id;
826 u32 size = 0;
827
828 size_type = btf_type_by_id(btf, size_type_id);
829 if (btf_type_is_void_or_null(size_type))
830 return NULL;
831
832 if (btf_type_has_size(size_type)) {
833 size = size_type->size;
834 } else if (btf_type_is_array(size_type)) {
835 size = btf->resolved_sizes[size_type_id];
836 } else if (btf_type_is_ptr(size_type)) {
837 size = sizeof(void *);
838 } else {
839 if (WARN_ON_ONCE(!btf_type_is_modifier(size_type)))
840 return NULL;
841
842 size = btf->resolved_sizes[size_type_id];
843 size_type_id = btf->resolved_ids[size_type_id];
844 size_type = btf_type_by_id(btf, size_type_id);
845 if (btf_type_is_void(size_type))
846 return NULL;
847 }
848
849 *type_id = size_type_id;
850 if (ret_size)
851 *ret_size = size;
852
853 return size_type;
854}
855
Martin KaFai Lau179cde82018-04-18 15:55:59 -0700856static int btf_df_check_member(struct btf_verifier_env *env,
857 const struct btf_type *struct_type,
858 const struct btf_member *member,
859 const struct btf_type *member_type)
860{
861 btf_verifier_log_basic(env, struct_type,
862 "Unsupported check_member");
863 return -EINVAL;
864}
865
Martin KaFai Laueb3f5952018-04-18 15:55:58 -0700866static int btf_df_resolve(struct btf_verifier_env *env,
867 const struct resolve_vertex *v)
868{
869 btf_verifier_log_basic(env, v->t, "Unsupported resolve");
870 return -EINVAL;
871}
872
Martin KaFai Laub00b8da2018-04-18 15:56:00 -0700873static void btf_df_seq_show(const struct btf *btf, const struct btf_type *t,
874 u32 type_id, void *data, u8 bits_offsets,
875 struct seq_file *m)
876{
877 seq_printf(m, "<unsupported kind:%u>", BTF_INFO_KIND(t->info));
878}
879
Martin KaFai Lau179cde82018-04-18 15:55:59 -0700880static int btf_int_check_member(struct btf_verifier_env *env,
881 const struct btf_type *struct_type,
882 const struct btf_member *member,
883 const struct btf_type *member_type)
884{
885 u32 int_data = btf_type_int(member_type);
886 u32 struct_bits_off = member->offset;
887 u32 struct_size = struct_type->size;
888 u32 nr_copy_bits;
889 u32 bytes_offset;
890
891 if (U32_MAX - struct_bits_off < BTF_INT_OFFSET(int_data)) {
892 btf_verifier_log_member(env, struct_type, member,
893 "bits_offset exceeds U32_MAX");
894 return -EINVAL;
895 }
896
897 struct_bits_off += BTF_INT_OFFSET(int_data);
898 bytes_offset = BITS_ROUNDDOWN_BYTES(struct_bits_off);
899 nr_copy_bits = BTF_INT_BITS(int_data) +
900 BITS_PER_BYTE_MASKED(struct_bits_off);
901
902 if (nr_copy_bits > BITS_PER_U64) {
903 btf_verifier_log_member(env, struct_type, member,
904 "nr_copy_bits exceeds 64");
905 return -EINVAL;
906 }
907
908 if (struct_size < bytes_offset ||
909 struct_size - bytes_offset < BITS_ROUNDUP_BYTES(nr_copy_bits)) {
910 btf_verifier_log_member(env, struct_type, member,
911 "Member exceeds struct_size");
912 return -EINVAL;
913 }
914
915 return 0;
916}
917
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700918static s32 btf_int_check_meta(struct btf_verifier_env *env,
919 const struct btf_type *t,
920 u32 meta_left)
921{
922 u32 int_data, nr_bits, meta_needed = sizeof(int_data);
923 u16 encoding;
924
925 if (meta_left < meta_needed) {
926 btf_verifier_log_basic(env, t,
927 "meta_left:%u meta_needed:%u",
928 meta_left, meta_needed);
929 return -EINVAL;
930 }
931
932 if (btf_type_vlen(t)) {
933 btf_verifier_log_type(env, t, "vlen != 0");
934 return -EINVAL;
935 }
936
937 int_data = btf_type_int(t);
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -0700938 if (int_data & ~BTF_INT_MASK) {
939 btf_verifier_log_basic(env, t, "Invalid int_data:%x",
940 int_data);
941 return -EINVAL;
942 }
943
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700944 nr_bits = BTF_INT_BITS(int_data) + BTF_INT_OFFSET(int_data);
945
946 if (nr_bits > BITS_PER_U64) {
947 btf_verifier_log_type(env, t, "nr_bits exceeds %zu",
948 BITS_PER_U64);
949 return -EINVAL;
950 }
951
952 if (BITS_ROUNDUP_BYTES(nr_bits) > t->size) {
953 btf_verifier_log_type(env, t, "nr_bits exceeds type_size");
954 return -EINVAL;
955 }
956
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -0700957 /*
958 * Only one of the encoding bits is allowed and it
959 * should be sufficient for the pretty print purpose (i.e. decoding).
960 * Multiple bits can be allowed later if it is found
961 * to be insufficient.
962 */
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700963 encoding = BTF_INT_ENCODING(int_data);
964 if (encoding &&
965 encoding != BTF_INT_SIGNED &&
966 encoding != BTF_INT_CHAR &&
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -0700967 encoding != BTF_INT_BOOL) {
Martin KaFai Lau69b693f2018-04-18 15:55:57 -0700968 btf_verifier_log_type(env, t, "Unsupported encoding");
969 return -ENOTSUPP;
970 }
971
972 btf_verifier_log_type(env, t, NULL);
973
974 return meta_needed;
975}
976
977static void btf_int_log(struct btf_verifier_env *env,
978 const struct btf_type *t)
979{
980 int int_data = btf_type_int(t);
981
982 btf_verifier_log(env,
983 "size=%u bits_offset=%u nr_bits=%u encoding=%s",
984 t->size, BTF_INT_OFFSET(int_data),
985 BTF_INT_BITS(int_data),
986 btf_int_encoding_str(BTF_INT_ENCODING(int_data)));
987}
988
Martin KaFai Laub00b8da2018-04-18 15:56:00 -0700989static void btf_int_bits_seq_show(const struct btf *btf,
990 const struct btf_type *t,
991 void *data, u8 bits_offset,
992 struct seq_file *m)
993{
994 u32 int_data = btf_type_int(t);
995 u16 nr_bits = BTF_INT_BITS(int_data);
996 u16 total_bits_offset;
997 u16 nr_copy_bytes;
998 u16 nr_copy_bits;
999 u8 nr_upper_bits;
1000 union {
1001 u64 u64_num;
1002 u8 u8_nums[8];
1003 } print_num;
1004
1005 total_bits_offset = bits_offset + BTF_INT_OFFSET(int_data);
1006 data += BITS_ROUNDDOWN_BYTES(total_bits_offset);
1007 bits_offset = BITS_PER_BYTE_MASKED(total_bits_offset);
1008 nr_copy_bits = nr_bits + bits_offset;
1009 nr_copy_bytes = BITS_ROUNDUP_BYTES(nr_copy_bits);
1010
1011 print_num.u64_num = 0;
1012 memcpy(&print_num.u64_num, data, nr_copy_bytes);
1013
1014 /* Ditch the higher order bits */
1015 nr_upper_bits = BITS_PER_BYTE_MASKED(nr_copy_bits);
1016 if (nr_upper_bits) {
1017 /* We need to mask out some bits of the upper byte. */
1018 u8 mask = (1 << nr_upper_bits) - 1;
1019
1020 print_num.u8_nums[nr_copy_bytes - 1] &= mask;
1021 }
1022
1023 print_num.u64_num >>= bits_offset;
1024
1025 seq_printf(m, "0x%llx", print_num.u64_num);
1026}
1027
1028static void btf_int_seq_show(const struct btf *btf, const struct btf_type *t,
1029 u32 type_id, void *data, u8 bits_offset,
1030 struct seq_file *m)
1031{
1032 u32 int_data = btf_type_int(t);
1033 u8 encoding = BTF_INT_ENCODING(int_data);
1034 bool sign = encoding & BTF_INT_SIGNED;
1035 u32 nr_bits = BTF_INT_BITS(int_data);
1036
1037 if (bits_offset || BTF_INT_OFFSET(int_data) ||
1038 BITS_PER_BYTE_MASKED(nr_bits)) {
1039 btf_int_bits_seq_show(btf, t, data, bits_offset, m);
1040 return;
1041 }
1042
1043 switch (nr_bits) {
1044 case 64:
1045 if (sign)
1046 seq_printf(m, "%lld", *(s64 *)data);
1047 else
1048 seq_printf(m, "%llu", *(u64 *)data);
1049 break;
1050 case 32:
1051 if (sign)
1052 seq_printf(m, "%d", *(s32 *)data);
1053 else
1054 seq_printf(m, "%u", *(u32 *)data);
1055 break;
1056 case 16:
1057 if (sign)
1058 seq_printf(m, "%d", *(s16 *)data);
1059 else
1060 seq_printf(m, "%u", *(u16 *)data);
1061 break;
1062 case 8:
1063 if (sign)
1064 seq_printf(m, "%d", *(s8 *)data);
1065 else
1066 seq_printf(m, "%u", *(u8 *)data);
1067 break;
1068 default:
1069 btf_int_bits_seq_show(btf, t, data, bits_offset, m);
1070 }
1071}
1072
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001073static const struct btf_kind_operations int_ops = {
1074 .check_meta = btf_int_check_meta,
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001075 .resolve = btf_df_resolve,
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001076 .check_member = btf_int_check_member,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001077 .log_details = btf_int_log,
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07001078 .seq_show = btf_int_seq_show,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001079};
1080
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001081static int btf_modifier_check_member(struct btf_verifier_env *env,
1082 const struct btf_type *struct_type,
1083 const struct btf_member *member,
1084 const struct btf_type *member_type)
1085{
1086 const struct btf_type *resolved_type;
1087 u32 resolved_type_id = member->type;
1088 struct btf_member resolved_member;
1089 struct btf *btf = env->btf;
1090
1091 resolved_type = btf_type_id_size(btf, &resolved_type_id, NULL);
1092 if (!resolved_type) {
1093 btf_verifier_log_member(env, struct_type, member,
1094 "Invalid member");
1095 return -EINVAL;
1096 }
1097
1098 resolved_member = *member;
1099 resolved_member.type = resolved_type_id;
1100
1101 return btf_type_ops(resolved_type)->check_member(env, struct_type,
1102 &resolved_member,
1103 resolved_type);
1104}
1105
1106static int btf_ptr_check_member(struct btf_verifier_env *env,
1107 const struct btf_type *struct_type,
1108 const struct btf_member *member,
1109 const struct btf_type *member_type)
1110{
1111 u32 struct_size, struct_bits_off, bytes_offset;
1112
1113 struct_size = struct_type->size;
1114 struct_bits_off = member->offset;
1115 bytes_offset = BITS_ROUNDDOWN_BYTES(struct_bits_off);
1116
1117 if (BITS_PER_BYTE_MASKED(struct_bits_off)) {
1118 btf_verifier_log_member(env, struct_type, member,
1119 "Member is not byte aligned");
1120 return -EINVAL;
1121 }
1122
1123 if (struct_size - bytes_offset < sizeof(void *)) {
1124 btf_verifier_log_member(env, struct_type, member,
1125 "Member exceeds struct_size");
1126 return -EINVAL;
1127 }
1128
1129 return 0;
1130}
1131
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001132static int btf_ref_type_check_meta(struct btf_verifier_env *env,
1133 const struct btf_type *t,
1134 u32 meta_left)
1135{
1136 if (btf_type_vlen(t)) {
1137 btf_verifier_log_type(env, t, "vlen != 0");
1138 return -EINVAL;
1139 }
1140
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -07001141 if (!BTF_TYPE_ID_VALID(t->type)) {
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001142 btf_verifier_log_type(env, t, "Invalid type_id");
1143 return -EINVAL;
1144 }
1145
1146 btf_verifier_log_type(env, t, NULL);
1147
1148 return 0;
1149}
1150
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001151static int btf_modifier_resolve(struct btf_verifier_env *env,
1152 const struct resolve_vertex *v)
1153{
1154 const struct btf_type *t = v->t;
1155 const struct btf_type *next_type;
1156 u32 next_type_id = t->type;
1157 struct btf *btf = env->btf;
1158 u32 next_type_size = 0;
1159
1160 next_type = btf_type_by_id(btf, next_type_id);
1161 if (!next_type) {
1162 btf_verifier_log_type(env, v->t, "Invalid type_id");
1163 return -EINVAL;
1164 }
1165
1166 /* "typedef void new_void", "const void"...etc */
1167 if (btf_type_is_void(next_type))
1168 goto resolved;
1169
1170 if (!env_type_is_resolve_sink(env, next_type) &&
1171 !env_type_is_resolved(env, next_type_id))
1172 return env_stack_push(env, next_type, next_type_id);
1173
1174 /* Figure out the resolved next_type_id with size.
1175 * They will be stored in the current modifier's
1176 * resolved_ids and resolved_sizes such that it can
1177 * save us a few type-following when we use it later (e.g. in
1178 * pretty print).
1179 */
1180 if (!btf_type_id_size(btf, &next_type_id, &next_type_size) &&
1181 !btf_type_is_void(btf_type_id_resolve(btf, &next_type_id))) {
1182 btf_verifier_log_type(env, v->t, "Invalid type_id");
1183 return -EINVAL;
1184 }
1185
1186resolved:
1187 env_stack_pop_resolved(env, next_type_id, next_type_size);
1188
1189 return 0;
1190}
1191
1192static int btf_ptr_resolve(struct btf_verifier_env *env,
1193 const struct resolve_vertex *v)
1194{
1195 const struct btf_type *next_type;
1196 const struct btf_type *t = v->t;
1197 u32 next_type_id = t->type;
1198 struct btf *btf = env->btf;
1199 u32 next_type_size = 0;
1200
1201 next_type = btf_type_by_id(btf, next_type_id);
1202 if (!next_type) {
1203 btf_verifier_log_type(env, v->t, "Invalid type_id");
1204 return -EINVAL;
1205 }
1206
1207 /* "void *" */
1208 if (btf_type_is_void(next_type))
1209 goto resolved;
1210
1211 if (!env_type_is_resolve_sink(env, next_type) &&
1212 !env_type_is_resolved(env, next_type_id))
1213 return env_stack_push(env, next_type, next_type_id);
1214
1215 /* If the modifier was RESOLVED during RESOLVE_STRUCT_OR_ARRAY,
1216 * the modifier may have stopped resolving when it was resolved
1217 * to a ptr (last-resolved-ptr).
1218 *
1219 * We now need to continue from the last-resolved-ptr to
1220 * ensure the last-resolved-ptr will not referring back to
1221 * the currenct ptr (t).
1222 */
1223 if (btf_type_is_modifier(next_type)) {
1224 const struct btf_type *resolved_type;
1225 u32 resolved_type_id;
1226
1227 resolved_type_id = next_type_id;
1228 resolved_type = btf_type_id_resolve(btf, &resolved_type_id);
1229
1230 if (btf_type_is_ptr(resolved_type) &&
1231 !env_type_is_resolve_sink(env, resolved_type) &&
1232 !env_type_is_resolved(env, resolved_type_id))
1233 return env_stack_push(env, resolved_type,
1234 resolved_type_id);
1235 }
1236
1237 if (!btf_type_id_size(btf, &next_type_id, &next_type_size) &&
1238 !btf_type_is_void(btf_type_id_resolve(btf, &next_type_id))) {
1239 btf_verifier_log_type(env, v->t, "Invalid type_id");
1240 return -EINVAL;
1241 }
1242
1243resolved:
1244 env_stack_pop_resolved(env, next_type_id, 0);
1245
1246 return 0;
1247}
1248
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07001249static void btf_modifier_seq_show(const struct btf *btf,
1250 const struct btf_type *t,
1251 u32 type_id, void *data,
1252 u8 bits_offset, struct seq_file *m)
1253{
1254 t = btf_type_id_resolve(btf, &type_id);
1255
1256 btf_type_ops(t)->seq_show(btf, t, type_id, data, bits_offset, m);
1257}
1258
1259static void btf_ptr_seq_show(const struct btf *btf, const struct btf_type *t,
1260 u32 type_id, void *data, u8 bits_offset,
1261 struct seq_file *m)
1262{
1263 /* It is a hashed value */
1264 seq_printf(m, "%p", *(void **)data);
1265}
1266
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001267static void btf_ref_type_log(struct btf_verifier_env *env,
1268 const struct btf_type *t)
1269{
1270 btf_verifier_log(env, "type_id=%u", t->type);
1271}
1272
1273static struct btf_kind_operations modifier_ops = {
1274 .check_meta = btf_ref_type_check_meta,
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001275 .resolve = btf_modifier_resolve,
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001276 .check_member = btf_modifier_check_member,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001277 .log_details = btf_ref_type_log,
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07001278 .seq_show = btf_modifier_seq_show,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001279};
1280
1281static struct btf_kind_operations ptr_ops = {
1282 .check_meta = btf_ref_type_check_meta,
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001283 .resolve = btf_ptr_resolve,
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001284 .check_member = btf_ptr_check_member,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001285 .log_details = btf_ref_type_log,
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07001286 .seq_show = btf_ptr_seq_show,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001287};
1288
1289static struct btf_kind_operations fwd_ops = {
1290 .check_meta = btf_ref_type_check_meta,
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001291 .resolve = btf_df_resolve,
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001292 .check_member = btf_df_check_member,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001293 .log_details = btf_ref_type_log,
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07001294 .seq_show = btf_df_seq_show,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001295};
1296
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001297static int btf_array_check_member(struct btf_verifier_env *env,
1298 const struct btf_type *struct_type,
1299 const struct btf_member *member,
1300 const struct btf_type *member_type)
1301{
1302 u32 struct_bits_off = member->offset;
1303 u32 struct_size, bytes_offset;
1304 u32 array_type_id, array_size;
1305 struct btf *btf = env->btf;
1306
1307 if (BITS_PER_BYTE_MASKED(struct_bits_off)) {
1308 btf_verifier_log_member(env, struct_type, member,
1309 "Member is not byte aligned");
1310 return -EINVAL;
1311 }
1312
1313 array_type_id = member->type;
1314 btf_type_id_size(btf, &array_type_id, &array_size);
1315 struct_size = struct_type->size;
1316 bytes_offset = BITS_ROUNDDOWN_BYTES(struct_bits_off);
1317 if (struct_size - bytes_offset < array_size) {
1318 btf_verifier_log_member(env, struct_type, member,
1319 "Member exceeds struct_size");
1320 return -EINVAL;
1321 }
1322
1323 return 0;
1324}
1325
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001326static s32 btf_array_check_meta(struct btf_verifier_env *env,
1327 const struct btf_type *t,
1328 u32 meta_left)
1329{
1330 const struct btf_array *array = btf_type_array(t);
1331 u32 meta_needed = sizeof(*array);
1332
1333 if (meta_left < meta_needed) {
1334 btf_verifier_log_basic(env, t,
1335 "meta_left:%u meta_needed:%u",
1336 meta_left, meta_needed);
1337 return -EINVAL;
1338 }
1339
1340 if (btf_type_vlen(t)) {
1341 btf_verifier_log_type(env, t, "vlen != 0");
1342 return -EINVAL;
1343 }
1344
Martin KaFai Laub9308ae2018-06-02 09:06:50 -07001345 if (t->size) {
1346 btf_verifier_log_type(env, t, "size != 0");
1347 return -EINVAL;
1348 }
1349
Martin KaFai Lau4ef5f572018-05-22 14:57:19 -07001350 /* Array elem type and index type cannot be in type void,
1351 * so !array->type and !array->index_type are not allowed.
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001352 */
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -07001353 if (!array->type || !BTF_TYPE_ID_VALID(array->type)) {
Martin KaFai Lau4ef5f572018-05-22 14:57:19 -07001354 btf_verifier_log_type(env, t, "Invalid elem");
1355 return -EINVAL;
1356 }
1357
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -07001358 if (!array->index_type || !BTF_TYPE_ID_VALID(array->index_type)) {
Martin KaFai Lau4ef5f572018-05-22 14:57:19 -07001359 btf_verifier_log_type(env, t, "Invalid index");
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001360 return -EINVAL;
1361 }
1362
1363 btf_verifier_log_type(env, t, NULL);
1364
1365 return meta_needed;
1366}
1367
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001368static int btf_array_resolve(struct btf_verifier_env *env,
1369 const struct resolve_vertex *v)
1370{
1371 const struct btf_array *array = btf_type_array(v->t);
Martin KaFai Lau4ef5f572018-05-22 14:57:19 -07001372 const struct btf_type *elem_type, *index_type;
1373 u32 elem_type_id, index_type_id;
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001374 struct btf *btf = env->btf;
1375 u32 elem_size;
1376
Martin KaFai Lau4ef5f572018-05-22 14:57:19 -07001377 /* Check array->index_type */
1378 index_type_id = array->index_type;
1379 index_type = btf_type_by_id(btf, index_type_id);
1380 if (btf_type_is_void_or_null(index_type)) {
1381 btf_verifier_log_type(env, v->t, "Invalid index");
1382 return -EINVAL;
1383 }
1384
1385 if (!env_type_is_resolve_sink(env, index_type) &&
1386 !env_type_is_resolved(env, index_type_id))
1387 return env_stack_push(env, index_type, index_type_id);
1388
1389 index_type = btf_type_id_size(btf, &index_type_id, NULL);
1390 if (!index_type || !btf_type_is_int(index_type) ||
1391 !btf_type_int_is_regular(index_type)) {
1392 btf_verifier_log_type(env, v->t, "Invalid index");
1393 return -EINVAL;
1394 }
1395
1396 /* Check array->type */
1397 elem_type_id = array->type;
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001398 elem_type = btf_type_by_id(btf, elem_type_id);
1399 if (btf_type_is_void_or_null(elem_type)) {
1400 btf_verifier_log_type(env, v->t,
1401 "Invalid elem");
1402 return -EINVAL;
1403 }
1404
1405 if (!env_type_is_resolve_sink(env, elem_type) &&
1406 !env_type_is_resolved(env, elem_type_id))
1407 return env_stack_push(env, elem_type, elem_type_id);
1408
1409 elem_type = btf_type_id_size(btf, &elem_type_id, &elem_size);
1410 if (!elem_type) {
1411 btf_verifier_log_type(env, v->t, "Invalid elem");
1412 return -EINVAL;
1413 }
1414
Martin KaFai Lau4ef5f572018-05-22 14:57:19 -07001415 if (btf_type_is_int(elem_type) && !btf_type_int_is_regular(elem_type)) {
1416 btf_verifier_log_type(env, v->t, "Invalid array of int");
1417 return -EINVAL;
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001418 }
1419
1420 if (array->nelems && elem_size > U32_MAX / array->nelems) {
1421 btf_verifier_log_type(env, v->t,
1422 "Array size overflows U32_MAX");
1423 return -EINVAL;
1424 }
1425
1426 env_stack_pop_resolved(env, elem_type_id, elem_size * array->nelems);
1427
1428 return 0;
1429}
1430
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001431static void btf_array_log(struct btf_verifier_env *env,
1432 const struct btf_type *t)
1433{
1434 const struct btf_array *array = btf_type_array(t);
1435
1436 btf_verifier_log(env, "type_id=%u index_type_id=%u nr_elems=%u",
1437 array->type, array->index_type, array->nelems);
1438}
1439
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07001440static void btf_array_seq_show(const struct btf *btf, const struct btf_type *t,
1441 u32 type_id, void *data, u8 bits_offset,
1442 struct seq_file *m)
1443{
1444 const struct btf_array *array = btf_type_array(t);
1445 const struct btf_kind_operations *elem_ops;
1446 const struct btf_type *elem_type;
1447 u32 i, elem_size, elem_type_id;
1448
1449 elem_type_id = array->type;
1450 elem_type = btf_type_id_size(btf, &elem_type_id, &elem_size);
1451 elem_ops = btf_type_ops(elem_type);
1452 seq_puts(m, "[");
1453 for (i = 0; i < array->nelems; i++) {
1454 if (i)
1455 seq_puts(m, ",");
1456
1457 elem_ops->seq_show(btf, elem_type, elem_type_id, data,
1458 bits_offset, m);
1459 data += elem_size;
1460 }
1461 seq_puts(m, "]");
1462}
1463
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001464static struct btf_kind_operations array_ops = {
1465 .check_meta = btf_array_check_meta,
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001466 .resolve = btf_array_resolve,
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001467 .check_member = btf_array_check_member,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001468 .log_details = btf_array_log,
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07001469 .seq_show = btf_array_seq_show,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001470};
1471
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001472static int btf_struct_check_member(struct btf_verifier_env *env,
1473 const struct btf_type *struct_type,
1474 const struct btf_member *member,
1475 const struct btf_type *member_type)
1476{
1477 u32 struct_bits_off = member->offset;
1478 u32 struct_size, bytes_offset;
1479
1480 if (BITS_PER_BYTE_MASKED(struct_bits_off)) {
1481 btf_verifier_log_member(env, struct_type, member,
1482 "Member is not byte aligned");
1483 return -EINVAL;
1484 }
1485
1486 struct_size = struct_type->size;
1487 bytes_offset = BITS_ROUNDDOWN_BYTES(struct_bits_off);
1488 if (struct_size - bytes_offset < member_type->size) {
1489 btf_verifier_log_member(env, struct_type, member,
1490 "Member exceeds struct_size");
1491 return -EINVAL;
1492 }
1493
1494 return 0;
1495}
1496
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001497static s32 btf_struct_check_meta(struct btf_verifier_env *env,
1498 const struct btf_type *t,
1499 u32 meta_left)
1500{
1501 bool is_union = BTF_INFO_KIND(t->info) == BTF_KIND_UNION;
1502 const struct btf_member *member;
1503 struct btf *btf = env->btf;
1504 u32 struct_size = t->size;
1505 u32 meta_needed;
1506 u16 i;
1507
1508 meta_needed = btf_type_vlen(t) * sizeof(*member);
1509 if (meta_left < meta_needed) {
1510 btf_verifier_log_basic(env, t,
1511 "meta_left:%u meta_needed:%u",
1512 meta_left, meta_needed);
1513 return -EINVAL;
1514 }
1515
1516 btf_verifier_log_type(env, t, NULL);
1517
1518 for_each_member(i, t, member) {
Martin KaFai Laufbcf93e2018-04-21 09:48:23 -07001519 if (!btf_name_offset_valid(btf, member->name_off)) {
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001520 btf_verifier_log_member(env, t, member,
1521 "Invalid member name_offset:%u",
Martin KaFai Laufbcf93e2018-04-21 09:48:23 -07001522 member->name_off);
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001523 return -EINVAL;
1524 }
1525
1526 /* A member cannot be in type void */
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -07001527 if (!member->type || !BTF_TYPE_ID_VALID(member->type)) {
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001528 btf_verifier_log_member(env, t, member,
1529 "Invalid type_id");
1530 return -EINVAL;
1531 }
1532
1533 if (is_union && member->offset) {
1534 btf_verifier_log_member(env, t, member,
1535 "Invalid member bits_offset");
1536 return -EINVAL;
1537 }
1538
1539 if (BITS_ROUNDUP_BYTES(member->offset) > struct_size) {
1540 btf_verifier_log_member(env, t, member,
1541 "Memmber bits_offset exceeds its struct size");
1542 return -EINVAL;
1543 }
1544
1545 btf_verifier_log_member(env, t, member, NULL);
1546 }
1547
1548 return meta_needed;
1549}
1550
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001551static int btf_struct_resolve(struct btf_verifier_env *env,
1552 const struct resolve_vertex *v)
1553{
1554 const struct btf_member *member;
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001555 int err;
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001556 u16 i;
1557
1558 /* Before continue resolving the next_member,
1559 * ensure the last member is indeed resolved to a
1560 * type with size info.
1561 */
1562 if (v->next_member) {
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001563 const struct btf_type *last_member_type;
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001564 const struct btf_member *last_member;
1565 u16 last_member_type_id;
1566
1567 last_member = btf_type_member(v->t) + v->next_member - 1;
1568 last_member_type_id = last_member->type;
1569 if (WARN_ON_ONCE(!env_type_is_resolved(env,
1570 last_member_type_id)))
1571 return -EINVAL;
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001572
1573 last_member_type = btf_type_by_id(env->btf,
1574 last_member_type_id);
1575 err = btf_type_ops(last_member_type)->check_member(env, v->t,
1576 last_member,
1577 last_member_type);
1578 if (err)
1579 return err;
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001580 }
1581
1582 for_each_member_from(i, v->next_member, v->t, member) {
1583 u32 member_type_id = member->type;
1584 const struct btf_type *member_type = btf_type_by_id(env->btf,
1585 member_type_id);
1586
1587 if (btf_type_is_void_or_null(member_type)) {
1588 btf_verifier_log_member(env, v->t, member,
1589 "Invalid member");
1590 return -EINVAL;
1591 }
1592
1593 if (!env_type_is_resolve_sink(env, member_type) &&
1594 !env_type_is_resolved(env, member_type_id)) {
1595 env_stack_set_next_member(env, i + 1);
1596 return env_stack_push(env, member_type, member_type_id);
1597 }
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001598
1599 err = btf_type_ops(member_type)->check_member(env, v->t,
1600 member,
1601 member_type);
1602 if (err)
1603 return err;
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001604 }
1605
1606 env_stack_pop_resolved(env, 0, 0);
1607
1608 return 0;
1609}
1610
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001611static void btf_struct_log(struct btf_verifier_env *env,
1612 const struct btf_type *t)
1613{
1614 btf_verifier_log(env, "size=%u vlen=%u", t->size, btf_type_vlen(t));
1615}
1616
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07001617static void btf_struct_seq_show(const struct btf *btf, const struct btf_type *t,
1618 u32 type_id, void *data, u8 bits_offset,
1619 struct seq_file *m)
1620{
1621 const char *seq = BTF_INFO_KIND(t->info) == BTF_KIND_UNION ? "|" : ",";
1622 const struct btf_member *member;
1623 u32 i;
1624
1625 seq_puts(m, "{");
1626 for_each_member(i, t, member) {
1627 const struct btf_type *member_type = btf_type_by_id(btf,
1628 member->type);
1629 u32 member_offset = member->offset;
1630 u32 bytes_offset = BITS_ROUNDDOWN_BYTES(member_offset);
1631 u8 bits8_offset = BITS_PER_BYTE_MASKED(member_offset);
1632 const struct btf_kind_operations *ops;
1633
1634 if (i)
1635 seq_puts(m, seq);
1636
1637 ops = btf_type_ops(member_type);
1638 ops->seq_show(btf, member_type, member->type,
1639 data + bytes_offset, bits8_offset, m);
1640 }
1641 seq_puts(m, "}");
1642}
1643
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001644static struct btf_kind_operations struct_ops = {
1645 .check_meta = btf_struct_check_meta,
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001646 .resolve = btf_struct_resolve,
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001647 .check_member = btf_struct_check_member,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001648 .log_details = btf_struct_log,
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07001649 .seq_show = btf_struct_seq_show,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001650};
1651
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001652static int btf_enum_check_member(struct btf_verifier_env *env,
1653 const struct btf_type *struct_type,
1654 const struct btf_member *member,
1655 const struct btf_type *member_type)
1656{
1657 u32 struct_bits_off = member->offset;
1658 u32 struct_size, bytes_offset;
1659
1660 if (BITS_PER_BYTE_MASKED(struct_bits_off)) {
1661 btf_verifier_log_member(env, struct_type, member,
1662 "Member is not byte aligned");
1663 return -EINVAL;
1664 }
1665
1666 struct_size = struct_type->size;
1667 bytes_offset = BITS_ROUNDDOWN_BYTES(struct_bits_off);
1668 if (struct_size - bytes_offset < sizeof(int)) {
1669 btf_verifier_log_member(env, struct_type, member,
1670 "Member exceeds struct_size");
1671 return -EINVAL;
1672 }
1673
1674 return 0;
1675}
1676
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001677static s32 btf_enum_check_meta(struct btf_verifier_env *env,
1678 const struct btf_type *t,
1679 u32 meta_left)
1680{
1681 const struct btf_enum *enums = btf_type_enum(t);
1682 struct btf *btf = env->btf;
1683 u16 i, nr_enums;
1684 u32 meta_needed;
1685
1686 nr_enums = btf_type_vlen(t);
1687 meta_needed = nr_enums * sizeof(*enums);
1688
1689 if (meta_left < meta_needed) {
1690 btf_verifier_log_basic(env, t,
1691 "meta_left:%u meta_needed:%u",
1692 meta_left, meta_needed);
1693 return -EINVAL;
1694 }
1695
1696 if (t->size != sizeof(int)) {
1697 btf_verifier_log_type(env, t, "Expected size:%zu",
1698 sizeof(int));
1699 return -EINVAL;
1700 }
1701
1702 btf_verifier_log_type(env, t, NULL);
1703
1704 for (i = 0; i < nr_enums; i++) {
Martin KaFai Laufbcf93e2018-04-21 09:48:23 -07001705 if (!btf_name_offset_valid(btf, enums[i].name_off)) {
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001706 btf_verifier_log(env, "\tInvalid name_offset:%u",
Martin KaFai Laufbcf93e2018-04-21 09:48:23 -07001707 enums[i].name_off);
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001708 return -EINVAL;
1709 }
1710
1711 btf_verifier_log(env, "\t%s val=%d\n",
Martin KaFai Laufbcf93e2018-04-21 09:48:23 -07001712 btf_name_by_offset(btf, enums[i].name_off),
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001713 enums[i].val);
1714 }
1715
1716 return meta_needed;
1717}
1718
1719static void btf_enum_log(struct btf_verifier_env *env,
1720 const struct btf_type *t)
1721{
1722 btf_verifier_log(env, "size=%u vlen=%u", t->size, btf_type_vlen(t));
1723}
1724
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07001725static void btf_enum_seq_show(const struct btf *btf, const struct btf_type *t,
1726 u32 type_id, void *data, u8 bits_offset,
1727 struct seq_file *m)
1728{
1729 const struct btf_enum *enums = btf_type_enum(t);
1730 u32 i, nr_enums = btf_type_vlen(t);
1731 int v = *(int *)data;
1732
1733 for (i = 0; i < nr_enums; i++) {
1734 if (v == enums[i].val) {
1735 seq_printf(m, "%s",
Martin KaFai Laufbcf93e2018-04-21 09:48:23 -07001736 btf_name_by_offset(btf, enums[i].name_off));
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07001737 return;
1738 }
1739 }
1740
1741 seq_printf(m, "%d", v);
1742}
1743
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001744static struct btf_kind_operations enum_ops = {
1745 .check_meta = btf_enum_check_meta,
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001746 .resolve = btf_df_resolve,
Martin KaFai Lau179cde82018-04-18 15:55:59 -07001747 .check_member = btf_enum_check_member,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001748 .log_details = btf_enum_log,
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07001749 .seq_show = btf_enum_seq_show,
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001750};
1751
1752static const struct btf_kind_operations * const kind_ops[NR_BTF_KINDS] = {
1753 [BTF_KIND_INT] = &int_ops,
1754 [BTF_KIND_PTR] = &ptr_ops,
1755 [BTF_KIND_ARRAY] = &array_ops,
1756 [BTF_KIND_STRUCT] = &struct_ops,
1757 [BTF_KIND_UNION] = &struct_ops,
1758 [BTF_KIND_ENUM] = &enum_ops,
1759 [BTF_KIND_FWD] = &fwd_ops,
1760 [BTF_KIND_TYPEDEF] = &modifier_ops,
1761 [BTF_KIND_VOLATILE] = &modifier_ops,
1762 [BTF_KIND_CONST] = &modifier_ops,
1763 [BTF_KIND_RESTRICT] = &modifier_ops,
1764};
1765
1766static s32 btf_check_meta(struct btf_verifier_env *env,
1767 const struct btf_type *t,
1768 u32 meta_left)
1769{
1770 u32 saved_meta_left = meta_left;
1771 s32 var_meta_size;
1772
1773 if (meta_left < sizeof(*t)) {
1774 btf_verifier_log(env, "[%u] meta_left:%u meta_needed:%zu",
1775 env->log_type_id, meta_left, sizeof(*t));
1776 return -EINVAL;
1777 }
1778 meta_left -= sizeof(*t);
1779
Martin KaFai Lauaea2f7b82018-05-22 14:57:20 -07001780 if (t->info & ~BTF_INFO_MASK) {
1781 btf_verifier_log(env, "[%u] Invalid btf_info:%x",
1782 env->log_type_id, t->info);
1783 return -EINVAL;
1784 }
1785
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001786 if (BTF_INFO_KIND(t->info) > BTF_KIND_MAX ||
1787 BTF_INFO_KIND(t->info) == BTF_KIND_UNKN) {
1788 btf_verifier_log(env, "[%u] Invalid kind:%u",
1789 env->log_type_id, BTF_INFO_KIND(t->info));
1790 return -EINVAL;
1791 }
1792
Martin KaFai Laufbcf93e2018-04-21 09:48:23 -07001793 if (!btf_name_offset_valid(env->btf, t->name_off)) {
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001794 btf_verifier_log(env, "[%u] Invalid name_offset:%u",
Martin KaFai Laufbcf93e2018-04-21 09:48:23 -07001795 env->log_type_id, t->name_off);
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001796 return -EINVAL;
1797 }
1798
1799 var_meta_size = btf_type_ops(t)->check_meta(env, t, meta_left);
1800 if (var_meta_size < 0)
1801 return var_meta_size;
1802
1803 meta_left -= var_meta_size;
1804
1805 return saved_meta_left - meta_left;
1806}
1807
1808static int btf_check_all_metas(struct btf_verifier_env *env)
1809{
1810 struct btf *btf = env->btf;
1811 struct btf_header *hdr;
1812 void *cur, *end;
1813
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07001814 hdr = &btf->hdr;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001815 cur = btf->nohdr_data + hdr->type_off;
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07001816 end = btf->nohdr_data + hdr->type_len;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001817
1818 env->log_type_id = 1;
1819 while (cur < end) {
1820 struct btf_type *t = cur;
1821 s32 meta_size;
1822
1823 meta_size = btf_check_meta(env, t, end - cur);
1824 if (meta_size < 0)
1825 return meta_size;
1826
1827 btf_add_type(env, t);
1828 cur += meta_size;
1829 env->log_type_id++;
1830 }
1831
1832 return 0;
1833}
1834
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001835static int btf_resolve(struct btf_verifier_env *env,
1836 const struct btf_type *t, u32 type_id)
1837{
1838 const struct resolve_vertex *v;
1839 int err = 0;
1840
1841 env->resolve_mode = RESOLVE_TBD;
1842 env_stack_push(env, t, type_id);
1843 while (!err && (v = env_stack_peak(env))) {
1844 env->log_type_id = v->type_id;
1845 err = btf_type_ops(v->t)->resolve(env, v);
1846 }
1847
1848 env->log_type_id = type_id;
1849 if (err == -E2BIG)
1850 btf_verifier_log_type(env, t,
1851 "Exceeded max resolving depth:%u",
1852 MAX_RESOLVE_DEPTH);
1853 else if (err == -EEXIST)
1854 btf_verifier_log_type(env, t, "Loop detected");
1855
1856 return err;
1857}
1858
1859static bool btf_resolve_valid(struct btf_verifier_env *env,
1860 const struct btf_type *t,
1861 u32 type_id)
1862{
1863 struct btf *btf = env->btf;
1864
1865 if (!env_type_is_resolved(env, type_id))
1866 return false;
1867
1868 if (btf_type_is_struct(t))
1869 return !btf->resolved_ids[type_id] &&
1870 !btf->resolved_sizes[type_id];
1871
1872 if (btf_type_is_modifier(t) || btf_type_is_ptr(t)) {
1873 t = btf_type_id_resolve(btf, &type_id);
1874 return t && !btf_type_is_modifier(t);
1875 }
1876
1877 if (btf_type_is_array(t)) {
1878 const struct btf_array *array = btf_type_array(t);
1879 const struct btf_type *elem_type;
1880 u32 elem_type_id = array->type;
1881 u32 elem_size;
1882
1883 elem_type = btf_type_id_size(btf, &elem_type_id, &elem_size);
1884 return elem_type && !btf_type_is_modifier(elem_type) &&
1885 (array->nelems * elem_size ==
1886 btf->resolved_sizes[type_id]);
1887 }
1888
1889 return false;
1890}
1891
1892static int btf_check_all_types(struct btf_verifier_env *env)
1893{
1894 struct btf *btf = env->btf;
1895 u32 type_id;
1896 int err;
1897
1898 err = env_resolve_init(env);
1899 if (err)
1900 return err;
1901
1902 env->phase++;
1903 for (type_id = 1; type_id <= btf->nr_types; type_id++) {
1904 const struct btf_type *t = btf_type_by_id(btf, type_id);
1905
1906 env->log_type_id = type_id;
1907 if (btf_type_needs_resolve(t) &&
1908 !env_type_is_resolved(env, type_id)) {
1909 err = btf_resolve(env, t, type_id);
1910 if (err)
1911 return err;
1912 }
1913
1914 if (btf_type_needs_resolve(t) &&
1915 !btf_resolve_valid(env, t, type_id)) {
1916 btf_verifier_log_type(env, t, "Invalid resolve state");
1917 return -EINVAL;
1918 }
1919 }
1920
1921 return 0;
1922}
1923
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001924static int btf_parse_type_sec(struct btf_verifier_env *env)
1925{
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07001926 const struct btf_header *hdr = &env->btf->hdr;
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001927 int err;
1928
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07001929 /* Type section must align to 4 bytes */
1930 if (hdr->type_off & (sizeof(u32) - 1)) {
1931 btf_verifier_log(env, "Unaligned type_off");
1932 return -EINVAL;
1933 }
1934
1935 if (!hdr->type_len) {
1936 btf_verifier_log(env, "No type found");
1937 return -EINVAL;
1938 }
1939
Martin KaFai Laueb3f5952018-04-18 15:55:58 -07001940 err = btf_check_all_metas(env);
1941 if (err)
1942 return err;
1943
1944 return btf_check_all_types(env);
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001945}
1946
1947static int btf_parse_str_sec(struct btf_verifier_env *env)
1948{
1949 const struct btf_header *hdr;
1950 struct btf *btf = env->btf;
1951 const char *start, *end;
1952
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07001953 hdr = &btf->hdr;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001954 start = btf->nohdr_data + hdr->str_off;
1955 end = start + hdr->str_len;
1956
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07001957 if (end != btf->data + btf->data_size) {
1958 btf_verifier_log(env, "String section is not at the end");
1959 return -EINVAL;
1960 }
1961
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07001962 if (!hdr->str_len || hdr->str_len - 1 > BTF_MAX_NAME_OFFSET ||
1963 start[0] || end[-1]) {
1964 btf_verifier_log(env, "Invalid string section");
1965 return -EINVAL;
1966 }
1967
1968 btf->strings = start;
1969
1970 return 0;
1971}
1972
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07001973static const size_t btf_sec_info_offset[] = {
1974 offsetof(struct btf_header, type_off),
1975 offsetof(struct btf_header, str_off),
1976};
1977
1978static int btf_sec_info_cmp(const void *a, const void *b)
1979{
1980 const struct btf_sec_info *x = a;
1981 const struct btf_sec_info *y = b;
1982
1983 return (int)(x->off - y->off) ? : (int)(x->len - y->len);
1984}
1985
1986static int btf_check_sec_info(struct btf_verifier_env *env,
1987 u32 btf_data_size)
1988{
Martin KaFai Laua2889a42018-05-23 11:32:36 -07001989 struct btf_sec_info secs[ARRAY_SIZE(btf_sec_info_offset)];
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07001990 u32 total, expected_total, i;
1991 const struct btf_header *hdr;
1992 const struct btf *btf;
1993
1994 btf = env->btf;
1995 hdr = &btf->hdr;
1996
1997 /* Populate the secs from hdr */
Martin KaFai Laua2889a42018-05-23 11:32:36 -07001998 for (i = 0; i < ARRAY_SIZE(btf_sec_info_offset); i++)
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07001999 secs[i] = *(struct btf_sec_info *)((void *)hdr +
2000 btf_sec_info_offset[i]);
2001
Martin KaFai Laua2889a42018-05-23 11:32:36 -07002002 sort(secs, ARRAY_SIZE(btf_sec_info_offset),
2003 sizeof(struct btf_sec_info), btf_sec_info_cmp, NULL);
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07002004
2005 /* Check for gaps and overlap among sections */
2006 total = 0;
2007 expected_total = btf_data_size - hdr->hdr_len;
Martin KaFai Laua2889a42018-05-23 11:32:36 -07002008 for (i = 0; i < ARRAY_SIZE(btf_sec_info_offset); i++) {
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07002009 if (expected_total < secs[i].off) {
2010 btf_verifier_log(env, "Invalid section offset");
2011 return -EINVAL;
2012 }
2013 if (total < secs[i].off) {
2014 /* gap */
2015 btf_verifier_log(env, "Unsupported section found");
2016 return -EINVAL;
2017 }
2018 if (total > secs[i].off) {
2019 btf_verifier_log(env, "Section overlap found");
2020 return -EINVAL;
2021 }
2022 if (expected_total - total < secs[i].len) {
2023 btf_verifier_log(env,
2024 "Total section length too long");
2025 return -EINVAL;
2026 }
2027 total += secs[i].len;
2028 }
2029
2030 /* There is data other than hdr and known sections */
2031 if (expected_total != total) {
2032 btf_verifier_log(env, "Unsupported section found");
2033 return -EINVAL;
2034 }
2035
2036 return 0;
2037}
2038
2039static int btf_parse_hdr(struct btf_verifier_env *env, void __user *btf_data,
2040 u32 btf_data_size)
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07002041{
2042 const struct btf_header *hdr;
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07002043 u32 hdr_len, hdr_copy;
2044 /*
2045 * Minimal part of the "struct btf_header" that
2046 * contains the hdr_len.
2047 */
2048 struct btf_min_header {
2049 u16 magic;
2050 u8 version;
2051 u8 flags;
2052 u32 hdr_len;
2053 } __user *min_hdr;
2054 struct btf *btf;
2055 int err;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07002056
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07002057 btf = env->btf;
2058 min_hdr = btf_data;
2059
2060 if (btf_data_size < sizeof(*min_hdr)) {
2061 btf_verifier_log(env, "hdr_len not found");
2062 return -EINVAL;
2063 }
2064
2065 if (get_user(hdr_len, &min_hdr->hdr_len))
2066 return -EFAULT;
2067
2068 if (btf_data_size < hdr_len) {
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07002069 btf_verifier_log(env, "btf_header not found");
2070 return -EINVAL;
2071 }
2072
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07002073 err = bpf_check_uarg_tail_zero(btf_data, sizeof(btf->hdr), hdr_len);
2074 if (err) {
2075 if (err == -E2BIG)
2076 btf_verifier_log(env, "Unsupported btf_header");
2077 return err;
2078 }
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07002079
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07002080 hdr_copy = min_t(u32, hdr_len, sizeof(btf->hdr));
2081 if (copy_from_user(&btf->hdr, btf_data, hdr_copy))
2082 return -EFAULT;
2083
2084 hdr = &btf->hdr;
2085
2086 btf_verifier_log_hdr(env, btf_data_size);
2087
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07002088 if (hdr->magic != BTF_MAGIC) {
2089 btf_verifier_log(env, "Invalid magic");
2090 return -EINVAL;
2091 }
2092
2093 if (hdr->version != BTF_VERSION) {
2094 btf_verifier_log(env, "Unsupported version");
2095 return -ENOTSUPP;
2096 }
2097
2098 if (hdr->flags) {
2099 btf_verifier_log(env, "Unsupported flags");
2100 return -ENOTSUPP;
2101 }
2102
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07002103 if (btf_data_size == hdr->hdr_len) {
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07002104 btf_verifier_log(env, "No data");
2105 return -EINVAL;
2106 }
2107
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07002108 err = btf_check_sec_info(env, btf_data_size);
2109 if (err)
2110 return err;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07002111
2112 return 0;
2113}
2114
2115static struct btf *btf_parse(void __user *btf_data, u32 btf_data_size,
2116 u32 log_level, char __user *log_ubuf, u32 log_size)
2117{
2118 struct btf_verifier_env *env = NULL;
2119 struct bpf_verifier_log *log;
2120 struct btf *btf = NULL;
2121 u8 *data;
2122 int err;
2123
2124 if (btf_data_size > BTF_MAX_SIZE)
2125 return ERR_PTR(-E2BIG);
2126
2127 env = kzalloc(sizeof(*env), GFP_KERNEL | __GFP_NOWARN);
2128 if (!env)
2129 return ERR_PTR(-ENOMEM);
2130
2131 log = &env->log;
2132 if (log_level || log_ubuf || log_size) {
2133 /* user requested verbose verifier output
2134 * and supplied buffer to store the verification trace
2135 */
2136 log->level = log_level;
2137 log->ubuf = log_ubuf;
2138 log->len_total = log_size;
2139
2140 /* log attributes have to be sane */
2141 if (log->len_total < 128 || log->len_total > UINT_MAX >> 8 ||
2142 !log->level || !log->ubuf) {
2143 err = -EINVAL;
2144 goto errout;
2145 }
2146 }
2147
2148 btf = kzalloc(sizeof(*btf), GFP_KERNEL | __GFP_NOWARN);
2149 if (!btf) {
2150 err = -ENOMEM;
2151 goto errout;
2152 }
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07002153 env->btf = btf;
2154
2155 err = btf_parse_hdr(env, btf_data, btf_data_size);
2156 if (err)
2157 goto errout;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07002158
2159 data = kvmalloc(btf_data_size, GFP_KERNEL | __GFP_NOWARN);
2160 if (!data) {
2161 err = -ENOMEM;
2162 goto errout;
2163 }
2164
2165 btf->data = data;
2166 btf->data_size = btf_data_size;
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07002167 btf->nohdr_data = btf->data + btf->hdr.hdr_len;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07002168
2169 if (copy_from_user(data, btf_data, btf_data_size)) {
2170 err = -EFAULT;
2171 goto errout;
2172 }
2173
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07002174 err = btf_parse_str_sec(env);
2175 if (err)
2176 goto errout;
2177
2178 err = btf_parse_type_sec(env);
2179 if (err)
2180 goto errout;
2181
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07002182 if (log->level && bpf_verifier_log_full(log)) {
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07002183 err = -ENOSPC;
2184 goto errout;
2185 }
2186
Martin KaFai Lauf80442a2018-05-22 14:57:18 -07002187 btf_verifier_env_free(env);
2188 refcount_set(&btf->refcnt, 1);
2189 return btf;
Martin KaFai Lau69b693f2018-04-18 15:55:57 -07002190
2191errout:
2192 btf_verifier_env_free(env);
2193 if (btf)
2194 btf_free(btf);
2195 return ERR_PTR(err);
2196}
Martin KaFai Laub00b8da2018-04-18 15:56:00 -07002197
2198void btf_type_seq_show(const struct btf *btf, u32 type_id, void *obj,
2199 struct seq_file *m)
2200{
2201 const struct btf_type *t = btf_type_by_id(btf, type_id);
2202
2203 btf_type_ops(t)->seq_show(btf, t, type_id, obj, 0, m);
2204}
Martin KaFai Lauf56a6532018-04-18 15:56:01 -07002205
2206static int btf_release(struct inode *inode, struct file *filp)
2207{
2208 btf_put(filp->private_data);
2209 return 0;
2210}
2211
Martin KaFai Lau60197cf2018-04-18 15:56:02 -07002212const struct file_operations btf_fops = {
Martin KaFai Lauf56a6532018-04-18 15:56:01 -07002213 .release = btf_release,
2214};
2215
Martin KaFai Lau78958fc2018-05-04 14:49:51 -07002216static int __btf_new_fd(struct btf *btf)
2217{
2218 return anon_inode_getfd("btf", &btf_fops, btf, O_RDONLY | O_CLOEXEC);
2219}
2220
Martin KaFai Lauf56a6532018-04-18 15:56:01 -07002221int btf_new_fd(const union bpf_attr *attr)
2222{
2223 struct btf *btf;
Martin KaFai Lau78958fc2018-05-04 14:49:51 -07002224 int ret;
Martin KaFai Lauf56a6532018-04-18 15:56:01 -07002225
2226 btf = btf_parse(u64_to_user_ptr(attr->btf),
2227 attr->btf_size, attr->btf_log_level,
2228 u64_to_user_ptr(attr->btf_log_buf),
2229 attr->btf_log_size);
2230 if (IS_ERR(btf))
2231 return PTR_ERR(btf);
2232
Martin KaFai Lau78958fc2018-05-04 14:49:51 -07002233 ret = btf_alloc_id(btf);
2234 if (ret) {
2235 btf_free(btf);
2236 return ret;
2237 }
2238
2239 /*
2240 * The BTF ID is published to the userspace.
2241 * All BTF free must go through call_rcu() from
2242 * now on (i.e. free by calling btf_put()).
2243 */
2244
2245 ret = __btf_new_fd(btf);
2246 if (ret < 0)
Martin KaFai Lauf56a6532018-04-18 15:56:01 -07002247 btf_put(btf);
2248
Martin KaFai Lau78958fc2018-05-04 14:49:51 -07002249 return ret;
Martin KaFai Lauf56a6532018-04-18 15:56:01 -07002250}
2251
2252struct btf *btf_get_by_fd(int fd)
2253{
2254 struct btf *btf;
2255 struct fd f;
2256
2257 f = fdget(fd);
2258
2259 if (!f.file)
2260 return ERR_PTR(-EBADF);
2261
2262 if (f.file->f_op != &btf_fops) {
2263 fdput(f);
2264 return ERR_PTR(-EINVAL);
2265 }
2266
2267 btf = f.file->private_data;
Martin KaFai Lau78958fc2018-05-04 14:49:51 -07002268 refcount_inc(&btf->refcnt);
Martin KaFai Lauf56a6532018-04-18 15:56:01 -07002269 fdput(f);
2270
2271 return btf;
2272}
Martin KaFai Lau60197cf2018-04-18 15:56:02 -07002273
2274int btf_get_info_by_fd(const struct btf *btf,
2275 const union bpf_attr *attr,
2276 union bpf_attr __user *uattr)
2277{
Martin KaFai Lau62dab842018-05-04 14:49:52 -07002278 struct bpf_btf_info __user *uinfo;
2279 struct bpf_btf_info info = {};
2280 u32 info_copy, btf_copy;
2281 void __user *ubtf;
2282 u32 uinfo_len;
Martin KaFai Lau60197cf2018-04-18 15:56:02 -07002283
Martin KaFai Lau62dab842018-05-04 14:49:52 -07002284 uinfo = u64_to_user_ptr(attr->info.info);
2285 uinfo_len = attr->info.info_len;
2286
2287 info_copy = min_t(u32, uinfo_len, sizeof(info));
2288 if (copy_from_user(&info, uinfo, info_copy))
2289 return -EFAULT;
2290
2291 info.id = btf->id;
2292 ubtf = u64_to_user_ptr(info.btf);
2293 btf_copy = min_t(u32, btf->data_size, info.btf_size);
2294 if (copy_to_user(ubtf, btf->data, btf_copy))
2295 return -EFAULT;
2296 info.btf_size = btf->data_size;
2297
2298 if (copy_to_user(uinfo, &info, info_copy) ||
2299 put_user(info_copy, &uattr->info.info_len))
Martin KaFai Lau60197cf2018-04-18 15:56:02 -07002300 return -EFAULT;
2301
2302 return 0;
2303}
Martin KaFai Lau78958fc2018-05-04 14:49:51 -07002304
2305int btf_get_fd_by_id(u32 id)
2306{
2307 struct btf *btf;
2308 int fd;
2309
2310 rcu_read_lock();
2311 btf = idr_find(&btf_idr, id);
2312 if (!btf || !refcount_inc_not_zero(&btf->refcnt))
2313 btf = ERR_PTR(-ENOENT);
2314 rcu_read_unlock();
2315
2316 if (IS_ERR(btf))
2317 return PTR_ERR(btf);
2318
2319 fd = __btf_new_fd(btf);
2320 if (fd < 0)
2321 btf_put(btf);
2322
2323 return fd;
2324}
2325
2326u32 btf_id(const struct btf *btf)
2327{
2328 return btf->id;
2329}