1 /* Output BTF format from GCC.
2 Copyright (C) 2021-2023 Free Software Foundation, Inc.
4 This file is part of GCC.
6 GCC is free software; you can redistribute it and/or modify it under
7 the terms of the GNU General Public License as published by the Free
8 Software Foundation; either version 3, or (at your option) any later
11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING3. If not see
18 <http://www.gnu.org/licenses/>. */
20 /* This file contains routines to output the BPF Type Format (BTF). The BTF
21 debug format is very similar to CTF; as a result, the structure of this file
22 closely resembles that of ctfout.cc, and the same CTF container objects are
27 #include "coretypes.h"
32 #include "dwarf2asm.h"
35 #include "diagnostic-core.h"
38 #include "dwarf2out.h" /* For lookup_decl_die. */
40 static int btf_label_num
;
42 static GTY (()) section
* btf_info_section
;
44 /* BTF debug info section. */
46 #ifndef BTF_INFO_SECTION_NAME
47 #define BTF_INFO_SECTION_NAME ".BTF"
50 #define BTF_INFO_SECTION_FLAGS (SECTION_DEBUG)
52 /* Maximum size (in bytes) for an artifically generated BTF label. */
54 #define MAX_BTF_LABEL_BYTES 40
56 static char btf_info_section_label
[MAX_BTF_LABEL_BYTES
];
58 #ifndef BTF_INFO_SECTION_LABEL
59 #define BTF_INFO_SECTION_LABEL "Lbtf"
62 /* BTF encodes void as type id 0. */
64 #define BTF_VOID_TYPEID 0
65 #define BTF_INIT_TYPEID 1
67 #define BTF_INVALID_TYPEID 0xFFFFFFFF
69 /* Mapping of CTF variables to the IDs they will be assigned when they are
70 converted to BTF_KIND_VAR type records. Strictly accounts for the index
71 from the start of the variable type entries, does not include the number
72 of types emitted prior to the variable records. */
73 static GTY (()) hash_map
<ctf_dvdef_ref
, unsigned> *btf_var_ids
;
75 /* Mapping of type IDs from original CTF ID to BTF ID. Types do not map
76 1-to-1 from CTF to BTF. To avoid polluting the CTF container when updating
77 type references-by-ID, we use this map instead. */
78 static ctf_id_t
* btf_id_map
= NULL
;
80 /* Information for creating the BTF_KIND_DATASEC records. */
81 typedef struct btf_datasec
83 const char *name
; /* Section name, e.g. ".bss". */
84 uint32_t name_offset
; /* Offset to name in string table. */
85 vec
<struct btf_var_secinfo
> entries
; /* Variable entries in this section. */
88 /* One BTF_KIND_DATASEC record is created for each output data section which
89 will hold at least one variable. */
90 static vec
<btf_datasec_t
> datasecs
;
92 /* Holes occur for types which are present in the CTF container, but are either
93 non-representable or redundant in BTF. */
94 static vec
<ctf_id_t
> holes
;
96 /* CTF definition(s) of void. Only one definition of void should be generated.
97 We should not encounter more than one definition of void, but use a vector
99 static vec
<ctf_id_t
> voids
;
101 /* Functions in BTF have two separate type records - one for the prototype
102 (BTF_KIND_FUNC_PROTO), as well as a BTF_KIND_FUNC. CTF_K_FUNCTION types
103 map closely to BTF_KIND_FUNC_PROTO, but the BTF_KIND_FUNC records must be
104 created. This vector holds them. */
105 static GTY (()) vec
<ctf_dtdef_ref
, va_gc
> *funcs
;
107 /* The number of BTF variables added to the TU CTF container. */
108 static unsigned int num_vars_added
= 0;
110 /* The number of BTF types added to the TU CTF container. */
111 static unsigned int num_types_added
= 0;
113 /* The number of types synthesized for BTF that do not correspond to
115 static unsigned int num_types_created
= 0;
117 /* Map a CTF type kind to the corresponding BTF type kind. */
120 get_btf_kind (uint32_t ctf_kind
)
122 /* N.B. the values encoding kinds are not in general the same for the
123 same kind between CTF and BTF. e.g. CTF_K_CONST != BTF_KIND_CONST. */
126 case CTF_K_INTEGER
: return BTF_KIND_INT
;
127 case CTF_K_FLOAT
: return BTF_KIND_FLOAT
;
128 case CTF_K_POINTER
: return BTF_KIND_PTR
;
129 case CTF_K_ARRAY
: return BTF_KIND_ARRAY
;
130 case CTF_K_FUNCTION
: return BTF_KIND_FUNC_PROTO
;
131 case CTF_K_STRUCT
: return BTF_KIND_STRUCT
;
132 case CTF_K_UNION
: return BTF_KIND_UNION
;
133 case CTF_K_ENUM
: return BTF_KIND_ENUM
;
134 case CTF_K_FORWARD
: return BTF_KIND_FWD
;
135 case CTF_K_TYPEDEF
: return BTF_KIND_TYPEDEF
;
136 case CTF_K_VOLATILE
: return BTF_KIND_VOLATILE
;
137 case CTF_K_CONST
: return BTF_KIND_CONST
;
138 case CTF_K_RESTRICT
: return BTF_KIND_RESTRICT
;
141 return BTF_KIND_UNKN
;
144 /* Allocate the btf_id_map, and initialize elements to BTF_INVALID_TYPEID. */
147 init_btf_id_map (size_t len
)
149 btf_id_map
= XNEWVEC (ctf_id_t
, len
);
151 btf_id_map
[0] = BTF_VOID_TYPEID
;
152 for (size_t i
= 1; i
< len
; i
++)
153 btf_id_map
[i
] = BTF_INVALID_TYPEID
;
156 /* Return the BTF type ID of CTF type ID KEY, or BTF_INVALID_TYPEID if the CTF
157 type with ID KEY does not map to a BTF type. */
160 get_btf_id (ctf_id_t key
)
162 return btf_id_map
[key
];
165 /* Set the CTF type ID KEY to map to BTF type ID VAL. */
168 set_btf_id (ctf_id_t key
, ctf_id_t val
)
170 btf_id_map
[key
] = val
;
173 /* Return TRUE iff the given CTF type ID maps to a BTF type which will
176 btf_emit_id_p (ctf_id_t id
)
178 return ((btf_id_map
[id
] != BTF_VOID_TYPEID
)
179 && (btf_id_map
[id
] <= BTF_MAX_TYPE
));
182 /* Each BTF type can be followed additional, variable-length information
183 completing the description of the type. Calculate the number of bytes
184 of variable information required to encode a given type. */
187 btf_calc_num_vbytes (ctf_dtdef_ref dtd
)
189 uint64_t vlen_bytes
= 0;
191 uint32_t kind
= get_btf_kind (CTF_V2_INFO_KIND (dtd
->dtd_data
.ctti_info
));
192 uint32_t vlen
= CTF_V2_INFO_VLEN (dtd
->dtd_data
.ctti_info
);
199 case BTF_KIND_TYPEDEF
:
200 case BTF_KIND_VOLATILE
:
202 case BTF_KIND_RESTRICT
:
204 /* These kinds have no vlen data. */
208 /* Size 0 integers represent redundant definitions of void that will
209 not be emitted. Don't allocate space for them. */
210 if (dtd
->dtd_data
.ctti_size
== 0)
213 vlen_bytes
+= sizeof (uint32_t);
217 vlen_bytes
+= sizeof (struct btf_array
);
220 case BTF_KIND_STRUCT
:
222 vlen_bytes
+= vlen
* sizeof (struct btf_member
);
226 vlen_bytes
+= (dtd
->dtd_data
.ctti_size
== 0x8)
227 ? vlen
* sizeof (struct btf_enum64
)
228 : vlen
* sizeof (struct btf_enum
);
231 case BTF_KIND_FUNC_PROTO
:
232 vlen_bytes
+= vlen
* sizeof (struct btf_param
);
236 vlen_bytes
+= sizeof (struct btf_var
);
239 case BTF_KIND_DATASEC
:
240 vlen_bytes
+= vlen
* sizeof (struct btf_var_secinfo
);
249 /* Initialize BTF section (.BTF) for output. */
252 init_btf_sections (void)
254 btf_info_section
= get_section (BTF_INFO_SECTION_NAME
, BTF_INFO_SECTION_FLAGS
,
257 ASM_GENERATE_INTERNAL_LABEL (btf_info_section_label
,
258 BTF_INFO_SECTION_LABEL
, btf_label_num
++);
261 /* Push a BTF datasec variable entry INFO into the datasec named SECNAME,
262 creating the datasec if it does not already exist. */
265 btf_datasec_push_entry (ctf_container_ref ctfc
, const char *secname
,
266 struct btf_var_secinfo info
)
271 for (size_t i
= 0; i
< datasecs
.length (); i
++)
272 if (strcmp (datasecs
[i
].name
, secname
) == 0)
274 datasecs
[i
].entries
.safe_push (info
);
278 /* If we don't already have a datasec record for secname, make one. */
281 ctf_add_string (ctfc
, secname
, &str_off
, CTF_AUX_STRTAB
);
282 if (strcmp (secname
, ""))
283 ctfc
->ctfc_aux_strlen
+= strlen (secname
) + 1;
287 ds
.name_offset
= str_off
;
289 ds
.entries
.create (0);
290 ds
.entries
.safe_push (info
);
292 datasecs
.safe_push (ds
);
296 /* Return the section name, as of interest to btf_collect_datasec, for the
297 given symtab node. Note that this deliberately returns NULL for objects
298 which do not go in a section btf_collect_datasec cares about. */
300 get_section_name (symtab_node
*node
)
302 const char *section_name
= node
->get_section ();
304 if (section_name
== NULL
)
306 switch (categorize_decl_for_section (node
->decl
, 0))
309 section_name
= ".bss";
312 section_name
= ".data";
315 section_name
= ".rodata";
324 /* Construct all BTF_KIND_DATASEC records for CTFC. One such record is created
325 for each non-empty data-containing section in the output. Each record is
326 followed by a variable number of entries describing the variables stored
330 btf_collect_datasec (ctf_container_ref ctfc
)
333 FOR_EACH_FUNCTION (func
)
335 dw_die_ref die
= lookup_decl_die (func
->decl
);
339 ctf_dtdef_ref dtd
= ctf_dtd_lookup (ctfc
, die
);
343 /* Functions actually get two types: a BTF_KIND_FUNC_PROTO, and
344 also a BTF_KIND_FUNC. But the CTF container only allocates one
345 type per function, which matches closely with BTF_KIND_FUNC_PROTO.
346 For each such function, also allocate a BTF_KIND_FUNC entry.
347 These will be output later. */
348 ctf_dtdef_ref func_dtd
= ggc_cleared_alloc
<ctf_dtdef_t
> ();
349 func_dtd
->dtd_data
= dtd
->dtd_data
;
350 func_dtd
->dtd_data
.ctti_type
= dtd
->dtd_type
;
351 func_dtd
->linkage
= dtd
->linkage
;
352 func_dtd
->dtd_type
= num_types_added
+ num_types_created
;
354 /* Only the BTF_KIND_FUNC type actually references the name. The
355 BTF_KIND_FUNC_PROTO is always anonymous. */
356 dtd
->dtd_data
.ctti_name
= 0;
358 vec_safe_push (funcs
, func_dtd
);
361 /* Mark any 'extern' funcs and add DATASEC entries for them. */
362 if (DECL_EXTERNAL (func
->decl
))
364 func_dtd
->linkage
= BTF_FUNC_EXTERN
;
366 const char *section_name
= get_section_name (func
);
367 /* Note: get_section_name () returns NULL for functions in text
368 section. This is intentional, since we do not want to generate
369 DATASEC entries for them. */
370 if (section_name
== NULL
)
373 struct btf_var_secinfo info
;
375 /* +1 for the sentinel type not in the types map. */
376 info
.type
= func_dtd
->dtd_type
+ 1;
378 /* Both zero at compile time. */
382 btf_datasec_push_entry (ctfc
, section_name
, info
);
387 FOR_EACH_VARIABLE (node
)
389 dw_die_ref die
= lookup_decl_die (node
->decl
);
393 ctf_dvdef_ref dvd
= ctf_dvd_lookup (ctfc
, die
);
397 /* Mark extern variables. */
398 if (DECL_EXTERNAL (node
->decl
))
399 dvd
->dvd_visibility
= BTF_VAR_GLOBAL_EXTERN
;
401 const char *section_name
= get_section_name (node
);
402 if (section_name
== NULL
)
405 struct btf_var_secinfo info
;
408 unsigned int *var_id
= btf_var_ids
->get (dvd
);
410 /* +1 for the sentinel type not in the types map. */
411 info
.type
= *var_id
+ num_types_added
+ 1;
416 tree size
= DECL_SIZE_UNIT (node
->decl
);
417 if (tree_fits_uhwi_p (size
))
418 info
.size
= tree_to_uhwi (size
);
419 else if (VOID_TYPE_P (TREE_TYPE (node
->decl
)))
422 /* Offset is left as 0 at compile time, to be filled in by loaders such
426 btf_datasec_push_entry (ctfc
, section_name
, info
);
429 num_types_created
+= datasecs
.length ();
432 /* Return true if the type ID is that of a type which will not be emitted (for
433 example, if it is not representable in BTF). */
436 btf_removed_type_p (ctf_id_t id
)
438 return holes
.contains (id
);
441 /* Adjust the given type ID to account for holes and duplicate definitions of
445 btf_adjust_type_id (ctf_id_t id
)
450 /* Do not adjust invalid type markers. */
451 if (id
== BTF_INVALID_TYPEID
)
454 for (n
= 0; n
< voids
.length (); n
++)
456 return BTF_VOID_TYPEID
;
458 for (n
= 0; n
< holes
.length (); n
++)
462 else if (holes
[n
] == id
)
463 return BTF_VOID_TYPEID
;
469 /* Postprocessing callback routine for types. */
472 btf_dtd_postprocess_cb (ctf_dtdef_ref
*slot
, ctf_container_ref arg_ctfc
)
474 ctf_dtdef_ref ctftype
= (ctf_dtdef_ref
) * slot
;
476 size_t index
= ctftype
->dtd_type
;
477 gcc_assert (index
<= arg_ctfc
->ctfc_types
->elements ());
479 uint32_t ctf_kind
, btf_kind
;
481 ctf_kind
= CTF_V2_INFO_KIND (ctftype
->dtd_data
.ctti_info
);
482 btf_kind
= get_btf_kind (ctf_kind
);
484 if (btf_kind
== BTF_KIND_UNKN
)
485 /* This type is not representable in BTF. Create a hole. */
486 holes
.safe_push (ctftype
->dtd_type
);
488 else if (btf_kind
== BTF_KIND_INT
&& ctftype
->dtd_data
.ctti_size
== 0)
490 /* This is a (redundant) definition of void. */
491 voids
.safe_push (ctftype
->dtd_type
);
492 holes
.safe_push (ctftype
->dtd_type
);
495 arg_ctfc
->ctfc_types_list
[index
] = ctftype
;
500 /* Preprocessing callback routine for variables. */
503 btf_dvd_emit_preprocess_cb (ctf_dvdef_ref
*slot
, ctf_container_ref arg_ctfc
)
505 ctf_dvdef_ref var
= (ctf_dvdef_ref
) * slot
;
507 /* If this is an extern variable declaration with a defining declaration
508 later, skip it so that only the defining declaration is emitted.
509 This is the same case, fix and reasoning as in CTF; see PR105089. */
510 if (ctf_dvd_ignore_lookup (arg_ctfc
, var
->dvd_key
))
513 /* Do not add variables which refer to unsupported types. */
514 if (!voids
.contains (var
->dvd_type
) && btf_removed_type_p (var
->dvd_type
))
517 arg_ctfc
->ctfc_vars_list
[num_vars_added
] = var
;
518 btf_var_ids
->put (var
, num_vars_added
);
526 /* Preprocessing callback routine for types. */
529 btf_dtd_emit_preprocess_cb (ctf_container_ref ctfc
, ctf_dtdef_ref dtd
)
531 if (!btf_emit_id_p (dtd
->dtd_type
))
534 ctfc
->ctfc_num_vlen_bytes
+= btf_calc_num_vbytes (dtd
);
537 /* Preprocess the CTF information to prepare for BTF output. BTF is almost a
538 subset of CTF, with many small differences in encoding, and lacking support
539 for some types (notably floating point formats).
541 During the preprocessing pass:
542 - Ascertain that the sorted list of types has been prepared. For the BTF
543 generation process, this is taken care of by the btf_init_postprocess ().
545 - BTF_KIND_FUNC and BTF_KIND_DATASEC records are constructed. These types do
546 not have analogues in CTF (the analogous type to CTF_K_FUNCTION is
547 BTF_KIND_FUNC_PROTO), but can be relatively easily deduced from CTF
550 - Construct BTF_KIND_VAR records, representing variables.
552 - Calculate the total size in bytes of variable-length information following
553 BTF type records. This is used for outputting the BTF header.
555 After preprocessing, all BTF information is ready to be output:
556 - ctfc->ctfc_types_list holdstypes converted from CTF types. This does not
557 include KIND_VAR, KIND_FUNC, nor KIND_DATASEC types. These types have been
558 re-encoded to the appropriate representation in BTF.
559 - ctfc->ctfc_vars_list holds all variables which should be output.
560 Variables of unsupported types are not present in this list.
561 - Vector 'funcs' holds all BTF_KIND_FUNC types, one to match each
563 - Vector 'datasecs' holds all BTF_KIND_DATASEC types. */
566 btf_emit_preprocess (ctf_container_ref ctfc
)
568 size_t num_ctf_types
= ctfc
->ctfc_types
->elements ();
569 size_t num_ctf_vars
= ctfc
->ctfc_vars
->elements ();
574 gcc_assert (ctfc
->ctfc_types_list
);
575 /* Preprocess the types. */
576 for (i
= 1; i
<= num_ctf_types
; i
++)
577 btf_dtd_emit_preprocess_cb (ctfc
, ctfc
->ctfc_types_list
[i
]);
580 btf_var_ids
= hash_map
<ctf_dvdef_ref
, unsigned int>::create_ggc (100);
584 /* Allocate and construct the list of variables. While BTF variables are
585 not distinct from types (in that variables are simply types with
586 BTF_KIND_VAR), it is simpler to maintain a separate list of variables
587 and append them to the types list during output. */
588 ctfc
->ctfc_vars_list
= ggc_vec_alloc
<ctf_dvdef_ref
>(num_ctf_vars
);
589 ctfc
->ctfc_vars
->traverse
<ctf_container_ref
, btf_dvd_emit_preprocess_cb
>
592 ctfc
->ctfc_num_vlen_bytes
+= (num_vars_added
* sizeof (struct btf_var
));
595 btf_collect_datasec (ctfc
);
598 /* Return true iff DMD is a member description of a bit-field which can be
599 validly represented in BTF. */
602 btf_dmd_representable_bitfield_p (ctf_container_ref ctfc
, ctf_dmdef_t
*dmd
)
604 ctf_dtdef_ref ref_type
= ctfc
->ctfc_types_list
[dmd
->dmd_type
];
606 if (CTF_V2_INFO_KIND (ref_type
->dtd_data
.ctti_info
) == CTF_K_SLICE
)
608 unsigned short word_offset
= ref_type
->dtd_u
.dtu_slice
.cts_offset
;
609 unsigned short bits
= ref_type
->dtd_u
.dtu_slice
.cts_bits
;
610 uint64_t sou_offset
= dmd
->dmd_offset
;
612 if ((bits
> 0xff) || ((sou_offset
+ word_offset
) > 0xffffff))
621 /* BTF asm helper routines. */
623 /* Asm'out a BTF type. This routine is responsible for the bulk of the task
624 of converting CTF types to their BTF representation. */
627 btf_asm_type (ctf_container_ref ctfc
, ctf_dtdef_ref dtd
)
629 uint32_t btf_kind
, btf_kflag
, btf_vlen
, btf_size_type
;
630 uint32_t ctf_info
= dtd
->dtd_data
.ctti_info
;
632 btf_kind
= get_btf_kind (CTF_V2_INFO_KIND (ctf_info
));
633 btf_size_type
= dtd
->dtd_data
.ctti_type
;
634 btf_vlen
= CTF_V2_INFO_VLEN (ctf_info
);
636 /* By now any unrepresentable types have been removed. */
637 gcc_assert (btf_kind
!= BTF_KIND_UNKN
);
639 /* Size 0 integers are redundant definitions of void. None should remain
640 in the types list by this point. */
641 gcc_assert (btf_kind
!= BTF_KIND_INT
|| btf_size_type
>= 1);
643 /* Re-encode the ctti_info to BTF. */
644 /* kflag is 1 for structs/unions with a bitfield member.
645 kflag is 1 for forwards to unions.
646 kflag is 0 in all other cases. */
649 if (btf_kind
== BTF_KIND_STRUCT
|| btf_kind
== BTF_KIND_UNION
)
651 /* If a struct/union has ANY bitfield members, set kflag=1.
652 Note that we must also change the encoding of every member to encode
653 both member bitfield size (stealing most-significant 8 bits) and bit
654 offset (LS 24 bits). This is done during preprocessing. */
656 for (dmd
= dtd
->dtd_u
.dtu_members
;
657 dmd
!= NULL
; dmd
= (ctf_dmdef_t
*) ctf_dmd_list_next (dmd
))
659 /* Set kflag if this member is a representable bitfield. */
660 if (btf_dmd_representable_bitfield_p (ctfc
, dmd
))
663 /* Struct members that refer to unsupported types or bitfield formats
664 shall be skipped. These are marked during preprocessing. */
665 else if (!btf_emit_id_p (dmd
->dmd_type
))
670 /* BTF forwards make use of KIND_FLAG to distinguish between forwards to
671 structs and forwards to unions. The dwarf2ctf conversion process stores
672 the kind of the forward in ctti_type, but for BTF this must be 0 for
673 forwards, with only the KIND_FLAG to distinguish.
674 At time of writing, BTF forwards to enums are unspecified. */
675 if (btf_kind
== BTF_KIND_FWD
)
677 if (dtd
->dtd_data
.ctti_type
== CTF_K_UNION
)
683 if (btf_kind
== BTF_KIND_ENUM
)
685 btf_kflag
= dtd
->dtd_enum_unsigned
686 ? BTF_KF_ENUM_UNSIGNED
687 : BTF_KF_ENUM_SIGNED
;
688 if (dtd
->dtd_data
.ctti_size
== 0x8)
689 btf_kind
= BTF_KIND_ENUM64
;
692 dw2_asm_output_data (4, dtd
->dtd_data
.ctti_name
, "btt_name");
693 dw2_asm_output_data (4, BTF_TYPE_INFO (btf_kind
, btf_kflag
, btf_vlen
),
694 "btt_info: kind=%u, kflag=%u, vlen=%u",
695 btf_kind
, btf_kflag
, btf_vlen
);
700 case BTF_KIND_STRUCT
:
703 case BTF_KIND_DATASEC
:
704 case BTF_KIND_ENUM64
:
705 dw2_asm_output_data (4, dtd
->dtd_data
.ctti_size
, "btt_size: %uB",
706 dtd
->dtd_data
.ctti_size
);
712 dw2_asm_output_data (4, get_btf_id (dtd
->dtd_data
.ctti_type
), "btt_type");
715 /* Asm'out the variable information following a BTF_KIND_ARRAY. */
718 btf_asm_array (ctf_dtdef_ref dtd
)
720 dw2_asm_output_data (4, get_btf_id (dtd
->dtd_u
.dtu_arr
.ctr_contents
),
722 dw2_asm_output_data (4, get_btf_id (dtd
->dtd_u
.dtu_arr
.ctr_index
),
724 dw2_asm_output_data (4, dtd
->dtd_u
.dtu_arr
.ctr_nelems
, "bta_nelems");
727 /* Asm'out a BTF_KIND_VAR. */
730 btf_asm_varent (ctf_dvdef_ref var
)
732 dw2_asm_output_data (4, var
->dvd_name_offset
, "btv_name");
733 dw2_asm_output_data (4, BTF_TYPE_INFO (BTF_KIND_VAR
, 0, 0), "btv_info");
734 dw2_asm_output_data (4, get_btf_id (var
->dvd_type
), "btv_type");
735 dw2_asm_output_data (4, var
->dvd_visibility
, "btv_linkage");
738 /* Asm'out a member description following a BTF_KIND_STRUCT or
742 btf_asm_sou_member (ctf_container_ref ctfc
, ctf_dmdef_t
* dmd
)
744 ctf_dtdef_ref ref_type
= ctfc
->ctfc_types_list
[dmd
->dmd_type
];
746 /* Re-encode bitfields to BTF representation. */
747 if (CTF_V2_INFO_KIND (ref_type
->dtd_data
.ctti_info
) == CTF_K_SLICE
)
749 ctf_id_t base_type
= ref_type
->dtd_u
.dtu_slice
.cts_type
;
750 unsigned short word_offset
= ref_type
->dtd_u
.dtu_slice
.cts_offset
;
751 unsigned short bits
= ref_type
->dtd_u
.dtu_slice
.cts_bits
;
752 uint64_t sou_offset
= dmd
->dmd_offset
;
754 /* Pack the bit offset and bitfield size together. */
755 sou_offset
+= word_offset
;
757 /* If this bitfield cannot be represented, do not output anything.
758 The parent struct/union 'vlen' field has already been updated. */
759 if ((bits
> 0xff) || (sou_offset
> 0xffffff))
762 sou_offset
&= 0x00ffffff;
763 sou_offset
|= ((bits
& 0xff) << 24);
765 /* Refer to the base type of the slice. */
766 dw2_asm_output_data (4, dmd
->dmd_name_offset
, "btm_name_off");
767 dw2_asm_output_data (4, get_btf_id (base_type
), "btm_type");
768 dw2_asm_output_data (4, sou_offset
, "btm_offset");
772 dw2_asm_output_data (4, dmd
->dmd_name_offset
, "btm_name_off");
773 dw2_asm_output_data (4, get_btf_id (dmd
->dmd_type
), "btm_type");
774 dw2_asm_output_data (4, dmd
->dmd_offset
, "btm_offset");
778 /* Asm'out an enum constant following a BTF_KIND_ENUM{,64}. */
781 btf_asm_enum_const (unsigned int size
, ctf_dmdef_t
* dmd
)
783 dw2_asm_output_data (4, dmd
->dmd_name_offset
, "bte_name");
785 dw2_asm_output_data (size
, dmd
->dmd_value
, "bte_value");
788 dw2_asm_output_data (4, dmd
->dmd_value
& 0xffffffff, "bte_value_lo32");
789 dw2_asm_output_data (4, (dmd
->dmd_value
>> 32) & 0xffffffff, "bte_value_hi32");
793 /* Asm'out a function parameter description following a BTF_KIND_FUNC_PROTO. */
796 btf_asm_func_arg (ctf_func_arg_t
* farg
, size_t stroffset
)
798 /* If the function arg does not have a name, refer to the null string at
799 the start of the string table. This ensures correct encoding for varargs
801 if ((farg
->farg_name
!= NULL
) && strcmp (farg
->farg_name
, ""))
802 dw2_asm_output_data (4, farg
->farg_name_offset
+ stroffset
, "farg_name");
804 dw2_asm_output_data (4, 0, "farg_name");
806 dw2_asm_output_data (4, (btf_removed_type_p (farg
->farg_type
)
808 : get_btf_id (farg
->farg_type
)),
812 /* Asm'out a BTF_KIND_FUNC type. */
815 btf_asm_func_type (ctf_dtdef_ref dtd
)
817 dw2_asm_output_data (4, dtd
->dtd_data
.ctti_name
, "btt_name");
818 dw2_asm_output_data (4, BTF_TYPE_INFO (BTF_KIND_FUNC
, 0,
820 "btt_info: kind=%u, kflag=%u, linkage=%u",
821 BTF_KIND_FUNC
, 0, dtd
->linkage
);
822 dw2_asm_output_data (4, get_btf_id (dtd
->dtd_data
.ctti_type
), "btt_type");
825 /* Asm'out a variable entry following a BTF_KIND_DATASEC. */
828 btf_asm_datasec_entry (struct btf_var_secinfo info
)
830 dw2_asm_output_data (4, info
.type
, "bts_type");
831 dw2_asm_output_data (4, info
.offset
, "bts_offset");
832 dw2_asm_output_data (4, info
.size
, "bts_size");
835 /* Asm'out a whole BTF_KIND_DATASEC, including its variable entries. */
838 btf_asm_datasec_type (btf_datasec_t ds
, size_t stroffset
)
840 dw2_asm_output_data (4, ds
.name_offset
+ stroffset
, "btt_name");
841 dw2_asm_output_data (4, BTF_TYPE_INFO (BTF_KIND_DATASEC
, 0,
842 ds
.entries
.length ()),
844 /* Note: the "total section size in bytes" is emitted as 0 and patched by
845 loaders such as libbpf. */
846 dw2_asm_output_data (4, 0, "btt_size");
847 for (size_t i
= 0; i
< ds
.entries
.length (); i
++)
848 btf_asm_datasec_entry (ds
.entries
[i
]);
851 /* Compute and output the header information for a .BTF section. */
854 output_btf_header (ctf_container_ref ctfc
)
856 switch_to_section (btf_info_section
);
857 ASM_OUTPUT_LABEL (asm_out_file
, btf_info_section_label
);
859 /* BTF magic number, version, flags, and header length. */
860 dw2_asm_output_data (2, BTF_MAGIC
, "btf_magic");
861 dw2_asm_output_data (1, BTF_VERSION
, "btf_version");
862 dw2_asm_output_data (1, 0, "btf_flags");
863 dw2_asm_output_data (4, sizeof (struct btf_header
), "btf_hdr_len");
865 uint32_t type_off
= 0, type_len
= 0;
866 uint32_t str_off
= 0, str_len
= 0;
867 uint32_t datasec_vlen_bytes
= 0;
869 if (!ctfc_is_empty_container (ctfc
))
871 for (size_t i
= 0; i
< datasecs
.length (); i
++)
873 datasec_vlen_bytes
+= ((datasecs
[i
].entries
.length ())
874 * sizeof (struct btf_var_secinfo
));
877 /* Total length (bytes) of the types section. */
878 type_len
= (num_types_added
* sizeof (struct btf_type
))
879 + (num_types_created
* sizeof (struct btf_type
))
881 + ctfc
->ctfc_num_vlen_bytes
;
883 str_off
= type_off
+ type_len
;
885 str_len
= ctfc
->ctfc_strtable
.ctstab_len
886 + ctfc
->ctfc_aux_strtable
.ctstab_len
;
889 /* Offset of type section. */
890 dw2_asm_output_data (4, type_off
, "type_off");
891 /* Length of type section in bytes. */
892 dw2_asm_output_data (4, type_len
, "type_len");
893 /* Offset of string section. */
894 dw2_asm_output_data (4, str_off
, "str_off");
895 /* Length of string section in bytes. */
896 dw2_asm_output_data (4, str_len
, "str_len");
899 /* Output all BTF_KIND_VARs in CTFC. */
902 output_btf_vars (ctf_container_ref ctfc
)
905 size_t num_ctf_vars
= num_vars_added
;
908 for (i
= 0; i
< num_ctf_vars
; i
++)
909 btf_asm_varent (ctfc
->ctfc_vars_list
[i
]);
913 /* Output BTF string records. The BTF strings section is a concatenation
914 of the standard and auxilliary string tables in the ctf container. */
917 output_btf_strs (ctf_container_ref ctfc
)
919 ctf_string_t
* ctf_string
= ctfc
->ctfc_strtable
.ctstab_head
;
923 dw2_asm_output_nstring (ctf_string
->cts_str
, -1, "btf_string");
924 ctf_string
= ctf_string
->cts_next
;
927 ctf_string
= ctfc
->ctfc_aux_strtable
.ctstab_head
;
930 dw2_asm_output_nstring (ctf_string
->cts_str
, -1, "btf_aux_string");
931 ctf_string
= ctf_string
->cts_next
;
935 /* Output all (representable) members of a BTF_KIND_STRUCT or
936 BTF_KIND_UNION type. */
939 output_asm_btf_sou_fields (ctf_container_ref ctfc
, ctf_dtdef_ref dtd
)
943 for (dmd
= dtd
->dtd_u
.dtu_members
;
944 dmd
!= NULL
; dmd
= (ctf_dmdef_t
*) ctf_dmd_list_next (dmd
))
945 btf_asm_sou_member (ctfc
, dmd
);
948 /* Output all enumerator constants following a BTF_KIND_ENUM{,64}. */
951 output_asm_btf_enum_list (ctf_container_ref
ARG_UNUSED (ctfc
),
956 for (dmd
= dtd
->dtd_u
.dtu_members
;
957 dmd
!= NULL
; dmd
= (ctf_dmdef_t
*) ctf_dmd_list_next (dmd
))
958 btf_asm_enum_const (dtd
->dtd_data
.ctti_size
, dmd
);
961 /* Output all function arguments following a BTF_KIND_FUNC_PROTO. */
964 output_asm_btf_func_args_list (ctf_container_ref ctfc
,
967 size_t farg_name_offset
= ctfc_get_strtab_len (ctfc
, CTF_STRTAB
);
968 ctf_func_arg_t
* farg
;
969 for (farg
= dtd
->dtd_u
.dtu_argv
;
970 farg
!= NULL
; farg
= (ctf_func_arg_t
*) ctf_farg_list_next (farg
))
971 btf_asm_func_arg (farg
, farg_name_offset
);
974 /* Output the variable portion of a BTF type record. The information depends
975 on the kind of the type. */
978 output_asm_btf_vlen_bytes (ctf_container_ref ctfc
, ctf_dtdef_ref dtd
)
980 uint32_t btf_kind
, encoding
;
982 btf_kind
= get_btf_kind (CTF_V2_INFO_KIND (dtd
->dtd_data
.ctti_info
));
984 if (btf_kind
== BTF_KIND_UNKN
)
990 /* Redundant definitions of void may still be hanging around in the type
991 list as size 0 integers. Skip emitting them. */
992 if (dtd
->dtd_data
.ctti_size
< 1)
995 /* In BTF the CHAR `encoding' seems to not be used, so clear it
997 dtd
->dtd_u
.dtu_enc
.cte_format
&= ~BTF_INT_CHAR
;
999 encoding
= BTF_INT_DATA (dtd
->dtd_u
.dtu_enc
.cte_format
,
1000 dtd
->dtd_u
.dtu_enc
.cte_offset
,
1001 dtd
->dtd_u
.dtu_enc
.cte_bits
);
1003 dw2_asm_output_data (4, encoding
, "bti_encoding");
1006 case BTF_KIND_ARRAY
:
1007 btf_asm_array (dtd
);
1010 case BTF_KIND_STRUCT
:
1011 case BTF_KIND_UNION
:
1012 output_asm_btf_sou_fields (ctfc
, dtd
);
1016 output_asm_btf_enum_list (ctfc
, dtd
);
1019 case BTF_KIND_FUNC_PROTO
:
1020 output_asm_btf_func_args_list (ctfc
, dtd
);
1024 /* BTF Variables are handled by output_btf_vars and btf_asm_varent.
1025 There should be no BTF_KIND_VAR types at this point. */
1028 case BTF_KIND_DATASEC
:
1029 /* The BTF_KIND_DATASEC records are handled by output_btf_datasec_types
1030 and btf_asm_datasec_type. There should be no BTF_KIND_DATASEC types
1035 /* All other BTF type kinds have no variable length data. */
1040 /* Output a whole BTF type record for TYPE, including the fixed and variable
1044 output_asm_btf_type (ctf_container_ref ctfc
, ctf_dtdef_ref type
)
1046 if (btf_emit_id_p (type
->dtd_type
))
1048 btf_asm_type (ctfc
, type
);
1049 output_asm_btf_vlen_bytes (ctfc
, type
);
1053 /* Output all BTF types in the container. This does not include synthesized
1054 types: BTF_KIND_VAR, BTF_KIND_FUNC, nor BTF_KIND_DATASEC. */
1057 output_btf_types (ctf_container_ref ctfc
)
1060 size_t num_types
= ctfc
->ctfc_types
->elements ();
1063 for (i
= 1; i
<= num_types
; i
++)
1064 output_asm_btf_type (ctfc
, ctfc
->ctfc_types_list
[i
]);
1068 /* Output all BTF_KIND_FUNC type records. */
1071 output_btf_func_types (void)
1073 for (size_t i
= 0; i
< vec_safe_length (funcs
); i
++)
1074 btf_asm_func_type ((*funcs
)[i
]);
1077 /* Output all BTF_KIND_DATASEC records. */
1080 output_btf_datasec_types (ctf_container_ref ctfc
)
1082 size_t name_offset
= ctfc_get_strtab_len (ctfc
, CTF_STRTAB
);
1084 for (size_t i
= 0; i
< datasecs
.length(); i
++)
1085 btf_asm_datasec_type (datasecs
[i
], name_offset
);
1088 /* Postprocess the CTF debug data post initialization.
1090 During the postprocess pass:
1092 - Prepare the sorted list of BTF types.
1094 The sorted list of BTF types is, firstly, used for lookup (during the BTF
1095 generation process) of CTF/BTF types given a typeID.
1097 Secondly, in the emitted BTF section, BTF Types need to be in the sorted
1098 order of their type IDs. The BTF types section is viewed as an array,
1099 with type IDs used to index into that array. It is essential that every
1100 type be placed at the exact index corresponding to its ID, or else
1101 references to that type from other types will no longer be correct.
1103 - References to void types are converted to reference BTF_VOID_TYPEID. In
1104 CTF, a distinct type is used to encode void.
1106 - Bitfield struct/union members are converted to BTF encoding. CTF uses
1107 slices to encode bitfields, but BTF does not have slices and encodes
1108 bitfield information directly in the variable-length btf_member
1109 descriptions following the struct or union type.
1111 - Unrepresentable types are removed. We cannot have any invalid BTF types
1112 appearing in the output so they must be removed, and type ids of other
1113 types and references adjust accordingly. This also involves ensuring that
1114 BTF descriptions of struct members referring to unrepresentable types are
1115 not emitted, as they would be nonsensical.
1117 - Adjust inner- and inter-type references-by-ID to account for removed
1118 types, and construct the types list. */
1121 btf_init_postprocess (void)
1123 ctf_container_ref tu_ctfc
= ctf_get_tu_ctfc ();
1128 num_types_added
= 0;
1129 num_types_created
= 0;
1131 /* Workaround for 'const void' variables. These variables are sometimes used
1132 in eBPF programs to address kernel symbols. DWARF does not generate const
1133 qualifier on void type, so we would incorrectly emit these variables
1134 without the const qualifier.
1135 Unfortunately we need the TREE node to know it was const, and we need
1136 to create the const modifier type (if needed) now, before making the types
1137 list. So we can't avoid iterating with FOR_EACH_VARIABLE here, and then
1138 again when creating the DATASEC entries. */
1139 ctf_id_t constvoid_id
= CTF_NULL_TYPEID
;
1141 FOR_EACH_VARIABLE (var
)
1146 tree type
= TREE_TYPE (var
->decl
);
1147 if (type
&& VOID_TYPE_P (type
) && TYPE_READONLY (type
))
1149 dw_die_ref die
= lookup_decl_die (var
->decl
);
1153 ctf_dvdef_ref dvd
= ctf_dvd_lookup (tu_ctfc
, die
);
1157 /* Create the 'const' modifier type for void. */
1158 if (constvoid_id
== CTF_NULL_TYPEID
)
1159 constvoid_id
= ctf_add_reftype (tu_ctfc
, CTF_ADD_ROOT
,
1160 dvd
->dvd_type
, CTF_K_CONST
, NULL
);
1161 dvd
->dvd_type
= constvoid_id
;
1166 size_t num_ctf_types
= tu_ctfc
->ctfc_types
->elements ();
1170 init_btf_id_map (num_ctf_types
+ 1);
1172 /* Allocate the types list and traverse all types, placing each type
1173 at the index according to its ID. Add 1 because type ID 0 always
1175 tu_ctfc
->ctfc_types_list
1176 = ggc_vec_alloc
<ctf_dtdef_ref
>(num_ctf_types
+ 1);
1177 tu_ctfc
->ctfc_types
->traverse
<ctf_container_ref
, btf_dtd_postprocess_cb
>
1180 /* Build mapping of CTF type ID -> BTF type ID, and count total number
1181 of valid BTF types added. */
1182 for (i
= 1; i
<= num_ctf_types
; i
++)
1184 ctf_dtdef_ref dtd
= tu_ctfc
->ctfc_types_list
[i
];
1185 ctf_id_t btfid
= btf_adjust_type_id (dtd
->dtd_type
);
1186 set_btf_id (dtd
->dtd_type
, btfid
);
1187 if (btfid
< BTF_MAX_TYPE
&& (btfid
!= BTF_VOID_TYPEID
))
1193 /* Process and output all BTF data. Entry point of btfout. */
1196 btf_output (const char * filename
)
1198 ctf_container_ref tu_ctfc
= ctf_get_tu_ctfc ();
1200 init_btf_sections ();
1202 datasecs
.create (0);
1203 vec_alloc (funcs
, 16);
1205 ctf_add_cuname (tu_ctfc
, filename
);
1207 btf_emit_preprocess (tu_ctfc
);
1209 output_btf_header (tu_ctfc
);
1210 output_btf_types (tu_ctfc
);
1211 output_btf_vars (tu_ctfc
);
1212 output_btf_func_types ();
1213 output_btf_datasec_types (tu_ctfc
);
1214 output_btf_strs (tu_ctfc
);
1217 /* Reset all state for BTF generation so that we can rerun the compiler within
1218 the same process. */
1223 btf_info_section
= NULL
;
1225 /* Clear preprocessing state. */
1227 num_types_added
= 0;
1228 num_types_created
= 0;
1232 for (size_t i
= 0; i
< datasecs
.length (); i
++)
1233 datasecs
[i
].entries
.release ();
1234 datasecs
.release ();
1238 btf_var_ids
->empty ();
1244 ctf_container_ref tu_ctfc
= ctf_get_tu_ctfc ();
1245 ctfc_delete_container (tu_ctfc
);
1249 #include "gt-btfout.h"