1 /* Compact ANSI-C Type Format (CTF) support in GDB.
3 Copyright (C) 2019-2024 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
20 /* This file format can be used to compactly represent the information needed
21 by a debugger to interpret the ANSI-C types used by a given program.
22 Traditionally, this kind of information is generated by the compiler when
23 invoked with the -g flag and is stored in "stabs" strings or in the more
24 modern DWARF format. A new -gtLEVEL option has been added in gcc to generate
25 such information. CTF provides a representation of only the information
26 that is relevant to debugging a complex, optimized C program such as the
27 operating system kernel in a form that is significantly more compact than
28 the equivalent stabs or DWARF representation. The format is data-model
29 independent, so consumers do not need different code depending on whether
30 they are 32-bit or 64-bit programs. CTF assumes that a standard ELF symbol
31 table is available for use in the debugger, and uses the structure and data
32 of the symbol table to avoid storing redundant information. The CTF data
33 may be compressed on disk or in memory, indicated by a bit in the header.
34 CTF may be interpreted in a raw disk file, or it may be stored in an ELF
35 section, typically named .ctf. Data structures are aligned so that a raw
36 CTF file or CTF ELF section may be manipulated using mmap(2).
38 The CTF file or section itself has the following structure:
40 +--------+--------+---------+----------+----------+-------+--------+
41 | file | type | data | function | variable | data | string |
42 | header | labels | objects | info | info | types | table |
43 +--------+--------+---------+----------+----------+-------+--------+
45 The file header stores a magic number and version information, encoding
46 flags, and the byte offset of each of the sections relative to the end of the
47 header itself. If the CTF data has been uniquified against another set of
48 CTF data, a reference to that data also appears in the header. This
49 reference is the name of the label corresponding to the types uniquified
52 Following the header is a list of labels, used to group the types included in
53 the data types section. Each label is accompanied by a type ID i. A given
54 label refers to the group of types whose IDs are in the range [0, i].
56 Data object and function records are stored in the same order as they appear
57 in the corresponding symbol table, except that symbols marked SHN_UNDEF are
58 not stored and symbols that have no type data are padded out with zeroes.
59 For each data object, the type ID (a small integer) is recorded. For each
60 function, the type ID of the return type and argument types is recorded.
62 Variable records (as distinct from data objects) provide a modicum of support
63 for non-ELF systems, mapping a variable name to a CTF type ID. The variable
64 names are sorted into ASCIIbetical order, permitting binary searching.
66 The data types section is a list of variable size records that represent each
67 type, in order by their ID. The types themselves form a directed graph,
68 where each node may contain one or more outgoing edges to other type nodes,
71 Strings are recorded as a string table ID (0 or 1) and a byte offset into the
72 string table. String table 0 is the internal CTF string table. String table
73 1 is the external string table, which is the string table associated with the
74 ELF symbol table for this object. CTF does not record any strings that are
75 already in the symbol table, and the CTF string table does not contain any
76 duplicated strings. */
79 #include "complaints.h"
89 static const registry
<objfile
>::key
<htab
, htab_deleter
> ctf_tid_key
;
93 explicit ctf_fp_info (ctf_dict_t
*cfp
) : fp (cfp
) {}
98 /* Cleanup function for the ctf_dict_key data. */
99 ctf_fp_info::~ctf_fp_info ()
104 ctf_archive_t
*arc
= ctf_get_arc (fp
);
109 static const registry
<objfile
>::key
<ctf_fp_info
> ctf_dict_key
;
111 /* A CTF context consists of a file pointer and an objfile pointer. */
117 psymtab_storage
*partial_symtabs
;
120 struct buildsym_compunit
*builder
;
123 /* A partial symtab, specialized for this module. */
124 struct ctf_psymtab
: public standard_psymtab
126 ctf_psymtab (const char *filename
,
127 psymtab_storage
*partial_symtabs
,
128 objfile_per_bfd_storage
*objfile_per_bfd
,
129 unrelocated_addr addr
)
130 : standard_psymtab (filename
, partial_symtabs
, objfile_per_bfd
, addr
)
134 void read_symtab (struct objfile
*) override
;
135 void expand_psymtab (struct objfile
*) override
;
137 struct ctf_context context
;
140 /* The routines that read and process fields/members of a C struct, union,
141 or enumeration, pass lists of data member fields in an instance of a
142 ctf_field_info structure. It is derived from dwarf2read.c. */
146 struct field field
{};
149 struct ctf_field_info
151 /* List of data member fields. */
152 std::vector
<struct ctf_nextfield
> fields
;
155 struct ctf_context
*cur_context
;
160 /* typedefs defined inside this class. TYPEDEF_FIELD_LIST contains head
161 of a NULL terminated list of TYPEDEF_FIELD_LIST_COUNT elements. */
162 std::vector
<struct decl_field
> typedef_field_list
;
164 /* Nested types defined by this struct and the number of elements in
166 std::vector
<struct decl_field
> nested_types_list
;
169 /* Data held for a translation unit. */
171 struct ctf_per_tu_data
176 psymtab_storage
*pss
;
177 psymbol_functions
*psf
;
180 /* Local function prototypes */
182 static int ctf_add_type_cb (ctf_id_t tid
, void *arg
);
184 static struct type
*read_array_type (struct ctf_context
*cp
, ctf_id_t tid
);
186 static struct type
*read_pointer_type (struct ctf_context
*cp
, ctf_id_t tid
,
189 static struct type
*read_structure_type (struct ctf_context
*cp
, ctf_id_t tid
);
191 static struct type
*read_enum_type (struct ctf_context
*cp
, ctf_id_t tid
);
193 static struct type
*read_typedef_type (struct ctf_context
*cp
, ctf_id_t tid
,
194 ctf_id_t btid
, const char *name
);
196 static struct type
*read_type_record (struct ctf_context
*cp
, ctf_id_t tid
);
198 static void process_structure_type (struct ctf_context
*cp
, ctf_id_t tid
);
200 static void process_struct_members (struct ctf_context
*cp
, ctf_id_t tid
,
203 static struct type
*read_forward_type (struct ctf_context
*cp
, ctf_id_t tid
);
205 static struct symbol
*new_symbol (struct ctf_context
*cp
, struct type
*type
,
208 struct ctf_tid_and_type
214 /* Hash function for a ctf_tid_and_type. */
217 tid_and_type_hash (const void *item
)
219 const struct ctf_tid_and_type
*ids
220 = (const struct ctf_tid_and_type
*) item
;
225 /* Equality function for a ctf_tid_and_type. */
228 tid_and_type_eq (const void *item_lhs
, const void *item_rhs
)
230 const struct ctf_tid_and_type
*ids_lhs
231 = (const struct ctf_tid_and_type
*) item_lhs
;
232 const struct ctf_tid_and_type
*ids_rhs
233 = (const struct ctf_tid_and_type
*) item_rhs
;
235 return ids_lhs
->tid
== ids_rhs
->tid
;
238 /* Set the type associated with TID to TYP. */
241 set_tid_type (struct objfile
*of
, ctf_id_t tid
, struct type
*typ
)
245 htab
= ctf_tid_key
.get (of
);
248 htab
= htab_create_alloc (1, tid_and_type_hash
,
250 NULL
, xcalloc
, xfree
);
251 ctf_tid_key
.set (of
, htab
);
254 struct ctf_tid_and_type
**slot
, ids
;
257 slot
= (struct ctf_tid_and_type
**) htab_find_slot (htab
, &ids
, INSERT
);
258 if (*slot
== nullptr)
259 *slot
= XOBNEW (&of
->objfile_obstack
, struct ctf_tid_and_type
);
264 /* Look up the type for TID in tid_and_type hash, return NULL if hash is
265 empty or TID does not have a saved type. */
268 get_tid_type (struct objfile
*of
, ctf_id_t tid
)
270 struct ctf_tid_and_type
*slot
, ids
;
273 htab
= ctf_tid_key
.get (of
);
279 slot
= (struct ctf_tid_and_type
*) htab_find (htab
, &ids
);
286 /* Fetch the type for TID in CCP OF's tid_and_type hash, add the type to
287 * context CCP if hash is empty or TID does not have a saved type. */
290 fetch_tid_type (struct ctf_context
*ccp
, ctf_id_t tid
)
292 struct objfile
*of
= ccp
->of
;
295 typ
= get_tid_type (of
, tid
);
298 ctf_add_type_cb (tid
, ccp
);
299 typ
= get_tid_type (of
, tid
);
305 /* Return the size of storage in bits for INTEGER, FLOAT, or ENUM. */
308 get_bitsize (ctf_dict_t
*fp
, ctf_id_t tid
, uint32_t kind
)
312 if ((kind
== CTF_K_INTEGER
|| kind
== CTF_K_ENUM
313 || kind
== CTF_K_FLOAT
)
314 && ctf_type_reference (fp
, tid
) != CTF_ERR
315 && ctf_type_encoding (fp
, tid
, &cet
) != CTF_ERR
)
321 /* Set SYM's address, with NAME, from its minimal symbol entry. */
324 set_symbol_address (struct objfile
*of
, struct symbol
*sym
, const char *name
)
326 struct bound_minimal_symbol msym
;
328 msym
= lookup_minimal_symbol (name
, nullptr, of
);
329 if (msym
.minsym
!= NULL
)
331 sym
->set_value_address (msym
.value_address ());
332 sym
->set_aclass_index (LOC_STATIC
);
333 sym
->set_section_index (msym
.minsym
->section_index ());
337 /* Create the vector of fields, and attach it to TYPE. */
340 attach_fields_to_type (struct ctf_field_info
*fip
, struct type
*type
)
342 int nfields
= fip
->fields
.size ();
347 /* Record the field count, allocate space for the array of fields. */
348 type
->alloc_fields (nfields
);
350 /* Copy the saved-up fields into the field vector. */
351 for (int i
= 0; i
< nfields
; ++i
)
353 struct ctf_nextfield
&field
= fip
->fields
[i
];
354 type
->field (i
) = field
.field
;
358 /* Allocate a floating-point type of size BITS and name NAME. Pass NAME_HINT
359 (which may be different from NAME) to the architecture back-end to allow
360 it to guess the correct format if necessary. */
363 ctf_init_float_type (struct objfile
*objfile
,
366 const char *name_hint
)
368 struct gdbarch
*gdbarch
= objfile
->arch ();
369 const struct floatformat
**format
;
372 type_allocator
alloc (objfile
, language_c
);
373 format
= gdbarch_floatformat_for_type (gdbarch
, name_hint
, bits
);
374 if (format
!= nullptr)
375 type
= init_float_type (alloc
, bits
, name
, format
);
377 type
= alloc
.new_type (TYPE_CODE_ERROR
, bits
, name
);
382 /* Callback to add member NAME to a struct/union type. TID is the type
383 of struct/union member, OFFSET is the offset of member in bits,
384 and ARG contains the ctf_field_info. */
387 ctf_add_member_cb (const char *name
,
389 unsigned long offset
,
392 struct ctf_field_info
*fip
= (struct ctf_field_info
*) arg
;
393 struct ctf_context
*ccp
= fip
->cur_context
;
394 struct ctf_nextfield new_field
;
399 fp
= &new_field
.field
;
402 kind
= ctf_type_kind (ccp
->fp
, tid
);
403 t
= fetch_tid_type (ccp
, tid
);
406 t
= read_type_record (ccp
, tid
);
409 complaint (_("ctf_add_member_cb: %s has NO type (%ld)"), name
, tid
);
410 t
= builtin_type (ccp
->of
)->builtin_error
;
411 set_tid_type (ccp
->of
, tid
, t
);
415 if (kind
== CTF_K_STRUCT
|| kind
== CTF_K_UNION
)
416 process_struct_members (ccp
, tid
, t
);
419 fp
->set_loc_bitpos (offset
/ TARGET_CHAR_BIT
);
420 fp
->set_bitsize (get_bitsize (ccp
->fp
, tid
, kind
));
422 fip
->fields
.emplace_back (new_field
);
427 /* Callback to add member NAME of EVAL to an enumeration type.
428 ARG contains the ctf_field_info. */
431 ctf_add_enum_member_cb (const char *name
, int enum_value
, void *arg
)
433 struct ctf_field_info
*fip
= (struct ctf_field_info
*) arg
;
434 struct ctf_nextfield new_field
;
436 struct ctf_context
*ccp
= fip
->cur_context
;
438 fp
= &new_field
.field
;
440 fp
->set_type (nullptr);
441 fp
->set_loc_enumval (enum_value
);
446 struct symbol
*sym
= new (&ccp
->of
->objfile_obstack
) symbol
;
447 OBJSTAT (ccp
->of
, n_syms
++);
449 sym
->set_language (language_c
, &ccp
->of
->objfile_obstack
);
450 sym
->compute_and_set_names (name
, false, ccp
->of
->per_bfd
);
451 sym
->set_aclass_index (LOC_CONST
);
452 sym
->set_domain (VAR_DOMAIN
);
453 sym
->set_type (fip
->ptype
);
454 add_symbol_to_list (sym
, ccp
->builder
->get_global_symbols ());
457 fip
->fields
.emplace_back (new_field
);
462 /* Add a new symbol entry, with its name from TID, its access index and
463 domain from TID's kind, and its type from TYPE. */
465 static struct symbol
*
466 new_symbol (struct ctf_context
*ccp
, struct type
*type
, ctf_id_t tid
)
468 struct objfile
*objfile
= ccp
->of
;
469 ctf_dict_t
*fp
= ccp
->fp
;
470 struct symbol
*sym
= nullptr;
472 const char *name
= ctf_type_name_raw (fp
, tid
);
475 sym
= new (&objfile
->objfile_obstack
) symbol
;
476 OBJSTAT (objfile
, n_syms
++);
478 sym
->set_language (language_c
, &objfile
->objfile_obstack
);
479 sym
->compute_and_set_names (name
, false, objfile
->per_bfd
);
480 sym
->set_domain (VAR_DOMAIN
);
481 sym
->set_aclass_index (LOC_OPTIMIZED_OUT
);
484 sym
->set_type (type
);
486 uint32_t kind
= ctf_type_kind (fp
, tid
);
492 sym
->set_aclass_index (LOC_TYPEDEF
);
493 sym
->set_domain (STRUCT_DOMAIN
);
496 sym
->set_aclass_index (LOC_STATIC
);
497 set_symbol_address (objfile
, sym
, sym
->linkage_name ());
500 if (sym
->type ()->code () == TYPE_CODE_VOID
)
501 sym
->set_type (builtin_type (objfile
)->builtin_int
);
506 sym
->set_aclass_index (LOC_TYPEDEF
);
507 sym
->set_domain (TYPE_DOMAIN
);
520 add_symbol_to_list (sym
, ccp
->builder
->get_file_symbols ());
526 /* Given a TID of kind CTF_K_INTEGER or CTF_K_FLOAT, find a representation
527 and create the symbol for it. */
530 read_base_type (struct ctf_context
*ccp
, ctf_id_t tid
)
532 struct objfile
*of
= ccp
->of
;
533 ctf_dict_t
*fp
= ccp
->fp
;
535 struct type
*type
= nullptr;
539 if (ctf_type_encoding (fp
, tid
, &cet
))
541 complaint (_("ctf_type_encoding read_base_type failed - %s"),
542 ctf_errmsg (ctf_errno (fp
)));
546 name
= ctf_type_name_raw (fp
, tid
);
547 if (name
== nullptr || strlen (name
) == 0)
549 name
= ctf_type_aname (fp
, tid
);
551 complaint (_("ctf_type_aname read_base_type failed - %s"),
552 ctf_errmsg (ctf_errno (fp
)));
555 type_allocator
alloc (of
, language_c
);
556 kind
= ctf_type_kind (fp
, tid
);
557 if (kind
== CTF_K_INTEGER
)
559 uint32_t issigned
, ischar
, isbool
;
560 struct gdbarch
*gdbarch
= of
->arch ();
562 issigned
= cet
.cte_format
& CTF_INT_SIGNED
;
563 ischar
= cet
.cte_format
& CTF_INT_CHAR
;
564 isbool
= cet
.cte_format
& CTF_INT_BOOL
;
566 type
= init_character_type (alloc
, TARGET_CHAR_BIT
, !issigned
, name
);
568 type
= init_boolean_type (alloc
, gdbarch_int_bit (gdbarch
),
573 if (cet
.cte_bits
&& ((cet
.cte_bits
% TARGET_CHAR_BIT
) == 0))
576 bits
= gdbarch_int_bit (gdbarch
);
577 type
= init_integer_type (alloc
, bits
, !issigned
, name
);
580 else if (kind
== CTF_K_FLOAT
)
583 isflt
= !((cet
.cte_format
& CTF_FP_IMAGRY
) == CTF_FP_IMAGRY
584 || (cet
.cte_format
& CTF_FP_DIMAGRY
) == CTF_FP_DIMAGRY
585 || (cet
.cte_format
& CTF_FP_LDIMAGRY
) == CTF_FP_LDIMAGRY
);
587 type
= ctf_init_float_type (of
, cet
.cte_bits
, name
, name
);
591 = ctf_init_float_type (of
, cet
.cte_bits
/ 2, NULL
, name
);
592 type
= init_complex_type (name
, t
);
597 complaint (_("read_base_type: unsupported base kind (%d)"), kind
);
598 type
= alloc
.new_type (TYPE_CODE_ERROR
, cet
.cte_bits
, name
);
601 if (name
!= nullptr && strcmp (name
, "char") == 0)
602 type
->set_has_no_signedness (true);
604 return set_tid_type (of
, tid
, type
);
608 process_base_type (struct ctf_context
*ccp
, ctf_id_t tid
)
612 type
= read_base_type (ccp
, tid
);
613 new_symbol (ccp
, type
, tid
);
616 /* Start a structure or union scope (definition) with TID to create a type
617 for the structure or union.
619 Fill in the type's name and general properties. The members will not be
620 processed, nor a symbol table entry be done until process_structure_type
621 (assuming the type has a name). */
624 read_structure_type (struct ctf_context
*ccp
, ctf_id_t tid
)
626 struct objfile
*of
= ccp
->of
;
627 ctf_dict_t
*fp
= ccp
->fp
;
631 type
= type_allocator (of
, language_c
).new_type ();
633 const char *name
= ctf_type_name_raw (fp
, tid
);
634 if (name
!= nullptr && strlen (name
) != 0)
635 type
->set_name (name
);
637 kind
= ctf_type_kind (fp
, tid
);
638 if (kind
== CTF_K_UNION
)
639 type
->set_code (TYPE_CODE_UNION
);
641 type
->set_code (TYPE_CODE_STRUCT
);
643 type
->set_length (ctf_type_size (fp
, tid
));
644 set_type_align (type
, ctf_type_align (fp
, tid
));
646 return set_tid_type (ccp
->of
, tid
, type
);
649 /* Given a tid of CTF_K_STRUCT or CTF_K_UNION, process all its members
650 and create the symbol for it. */
653 process_struct_members (struct ctf_context
*ccp
,
657 struct ctf_field_info fi
;
659 fi
.cur_context
= ccp
;
660 if (ctf_member_iter (ccp
->fp
, tid
, ctf_add_member_cb
, &fi
) == CTF_ERR
)
661 complaint (_("ctf_member_iter process_struct_members failed - %s"),
662 ctf_errmsg (ctf_errno (ccp
->fp
)));
664 /* Attach fields to the type. */
665 attach_fields_to_type (&fi
, type
);
667 new_symbol (ccp
, type
, tid
);
671 process_structure_type (struct ctf_context
*ccp
, ctf_id_t tid
)
675 type
= read_structure_type (ccp
, tid
);
676 process_struct_members (ccp
, tid
, type
);
679 /* Create a function type for TID and set its return type. */
682 read_func_kind_type (struct ctf_context
*ccp
, ctf_id_t tid
)
684 struct objfile
*of
= ccp
->of
;
685 ctf_dict_t
*fp
= ccp
->fp
;
686 struct type
*type
, *rettype
, *atype
;
690 type
= type_allocator (of
, language_c
).new_type ();
692 type
->set_code (TYPE_CODE_FUNC
);
693 if (ctf_func_type_info (fp
, tid
, &cfi
) < 0)
695 const char *fname
= ctf_type_name_raw (fp
, tid
);
696 error (_("Error getting function type info: %s"),
697 fname
== nullptr ? "noname" : fname
);
699 rettype
= fetch_tid_type (ccp
, cfi
.ctc_return
);
700 type
->set_target_type (rettype
);
701 set_type_align (type
, ctf_type_align (fp
, tid
));
703 /* Set up function's arguments. */
705 type
->set_num_fields (argc
);
706 if ((cfi
.ctc_flags
& CTF_FUNC_VARARG
) != 0)
707 type
->set_has_varargs (true);
711 std::vector
<ctf_id_t
> argv (argc
);
712 if (ctf_func_type_args (fp
, tid
, argc
, argv
.data ()) == CTF_ERR
)
715 type
->alloc_fields (argc
);
716 struct type
*void_type
= builtin_type (of
)->builtin_void
;
717 /* If failed to find the argument type, fill it with void_type. */
718 for (int iparam
= 0; iparam
< argc
; iparam
++)
720 atype
= fetch_tid_type (ccp
, argv
[iparam
]);
721 if (atype
!= nullptr)
722 type
->field (iparam
).set_type (atype
);
724 type
->field (iparam
).set_type (void_type
);
728 return set_tid_type (of
, tid
, type
);
731 /* Given a TID of CTF_K_ENUM, process all the members of the
732 enumeration, and create the symbol for the enumeration type. */
735 read_enum_type (struct ctf_context
*ccp
, ctf_id_t tid
)
737 struct objfile
*of
= ccp
->of
;
738 ctf_dict_t
*fp
= ccp
->fp
;
741 type
= type_allocator (of
, language_c
).new_type ();
743 const char *name
= ctf_type_name_raw (fp
, tid
);
744 if (name
!= nullptr && strlen (name
) != 0)
745 type
->set_name (name
);
747 type
->set_code (TYPE_CODE_ENUM
);
748 type
->set_length (ctf_type_size (fp
, tid
));
749 /* Set the underlying type based on its ctf_type_size bits. */
750 type
->set_target_type (objfile_int_type (of
, type
->length (), false));
751 set_type_align (type
, ctf_type_align (fp
, tid
));
753 return set_tid_type (of
, tid
, type
);
757 process_enum_type (struct ctf_context
*ccp
, ctf_id_t tid
)
760 struct ctf_field_info fi
;
762 type
= read_enum_type (ccp
, tid
);
764 fi
.cur_context
= ccp
;
766 if (ctf_enum_iter (ccp
->fp
, tid
, ctf_add_enum_member_cb
, &fi
) == CTF_ERR
)
767 complaint (_("ctf_enum_iter process_enum_type failed - %s"),
768 ctf_errmsg (ctf_errno (ccp
->fp
)));
770 /* Attach fields to the type. */
771 attach_fields_to_type (&fi
, type
);
773 new_symbol (ccp
, type
, tid
);
776 /* Add given cv-qualifiers CNST+VOLTL to the BASE_TYPE of array TID. */
779 add_array_cv_type (struct ctf_context
*ccp
,
781 struct type
*base_type
,
785 struct type
*el_type
, *inner_array
;
787 base_type
= copy_type (base_type
);
788 inner_array
= base_type
;
790 while (inner_array
->target_type ()->code () == TYPE_CODE_ARRAY
)
792 inner_array
->set_target_type (copy_type (inner_array
->target_type ()));
793 inner_array
= inner_array
->target_type ();
796 el_type
= inner_array
->target_type ();
797 cnst
|= TYPE_CONST (el_type
);
798 voltl
|= TYPE_VOLATILE (el_type
);
799 inner_array
->set_target_type (make_cv_type (cnst
, voltl
, el_type
, nullptr));
801 return set_tid_type (ccp
->of
, tid
, base_type
);
804 /* Read all information from a TID of CTF_K_ARRAY. */
807 read_array_type (struct ctf_context
*ccp
, ctf_id_t tid
)
809 struct objfile
*objfile
= ccp
->of
;
810 ctf_dict_t
*fp
= ccp
->fp
;
811 struct type
*element_type
, *range_type
, *idx_type
;
815 if (ctf_array_info (fp
, tid
, &ar
) == CTF_ERR
)
817 complaint (_("ctf_array_info read_array_type failed - %s"),
818 ctf_errmsg (ctf_errno (fp
)));
822 element_type
= fetch_tid_type (ccp
, ar
.ctr_contents
);
823 if (element_type
== nullptr)
826 idx_type
= fetch_tid_type (ccp
, ar
.ctr_index
);
827 if (idx_type
== nullptr)
828 idx_type
= builtin_type (objfile
)->builtin_int
;
830 type_allocator
alloc (objfile
, language_c
);
831 range_type
= create_static_range_type (alloc
, idx_type
, 0, ar
.ctr_nelems
- 1);
832 type
= create_array_type (alloc
, element_type
, range_type
);
833 if (ar
.ctr_nelems
<= 1) /* Check if undefined upper bound. */
835 range_type
->bounds ()->high
.set_undefined ();
836 type
->set_length (0);
837 type
->set_target_is_stub (true);
840 type
->set_length (ctf_type_size (fp
, tid
));
842 set_type_align (type
, ctf_type_align (fp
, tid
));
844 return set_tid_type (objfile
, tid
, type
);
847 /* Read TID of kind CTF_K_CONST with base type BTID. */
850 read_const_type (struct ctf_context
*ccp
, ctf_id_t tid
, ctf_id_t btid
)
852 struct objfile
*objfile
= ccp
->of
;
853 struct type
*base_type
, *cv_type
;
855 base_type
= fetch_tid_type (ccp
, btid
);
856 if (base_type
== nullptr)
858 base_type
= read_type_record (ccp
, btid
);
859 if (base_type
== nullptr)
861 complaint (_("read_const_type: NULL base type (%ld)"), btid
);
862 base_type
= builtin_type (objfile
)->builtin_error
;
865 cv_type
= make_cv_type (1, TYPE_VOLATILE (base_type
), base_type
, 0);
867 return set_tid_type (objfile
, tid
, cv_type
);
870 /* Read TID of kind CTF_K_VOLATILE with base type BTID. */
873 read_volatile_type (struct ctf_context
*ccp
, ctf_id_t tid
, ctf_id_t btid
)
875 struct objfile
*objfile
= ccp
->of
;
876 ctf_dict_t
*fp
= ccp
->fp
;
877 struct type
*base_type
, *cv_type
;
879 base_type
= fetch_tid_type (ccp
, btid
);
880 if (base_type
== nullptr)
882 base_type
= read_type_record (ccp
, btid
);
883 if (base_type
== nullptr)
885 complaint (_("read_volatile_type: NULL base type (%ld)"), btid
);
886 base_type
= builtin_type (objfile
)->builtin_error
;
890 if (ctf_type_kind (fp
, btid
) == CTF_K_ARRAY
)
891 return add_array_cv_type (ccp
, tid
, base_type
, 0, 1);
892 cv_type
= make_cv_type (TYPE_CONST (base_type
), 1, base_type
, 0);
894 return set_tid_type (objfile
, tid
, cv_type
);
897 /* Read TID of kind CTF_K_RESTRICT with base type BTID. */
900 read_restrict_type (struct ctf_context
*ccp
, ctf_id_t tid
, ctf_id_t btid
)
902 struct objfile
*objfile
= ccp
->of
;
903 struct type
*base_type
, *cv_type
;
905 base_type
= fetch_tid_type (ccp
, btid
);
906 if (base_type
== nullptr)
908 base_type
= read_type_record (ccp
, btid
);
909 if (base_type
== nullptr)
911 complaint (_("read_restrict_type: NULL base type (%ld)"), btid
);
912 base_type
= builtin_type (objfile
)->builtin_error
;
915 cv_type
= make_restrict_type (base_type
);
917 return set_tid_type (objfile
, tid
, cv_type
);
920 /* Read TID of kind CTF_K_TYPEDEF with its NAME and base type BTID. */
923 read_typedef_type (struct ctf_context
*ccp
, ctf_id_t tid
,
924 ctf_id_t btid
, const char *name
)
926 struct objfile
*objfile
= ccp
->of
;
927 struct type
*this_type
, *target_type
;
929 char *aname
= obstack_strdup (&objfile
->objfile_obstack
, name
);
930 this_type
= type_allocator (objfile
, language_c
).new_type (TYPE_CODE_TYPEDEF
,
932 set_tid_type (objfile
, tid
, this_type
);
933 target_type
= fetch_tid_type (ccp
, btid
);
934 if (target_type
!= this_type
)
935 this_type
->set_target_type (target_type
);
937 this_type
->set_target_type (nullptr);
939 this_type
->set_target_is_stub (this_type
->target_type () != nullptr);
941 return set_tid_type (objfile
, tid
, this_type
);
944 /* Read TID of kind CTF_K_POINTER with base type BTID. */
947 read_pointer_type (struct ctf_context
*ccp
, ctf_id_t tid
, ctf_id_t btid
)
949 struct objfile
*of
= ccp
->of
;
950 struct type
*target_type
, *type
;
952 target_type
= fetch_tid_type (ccp
, btid
);
953 if (target_type
== nullptr)
955 target_type
= read_type_record (ccp
, btid
);
956 if (target_type
== nullptr)
958 complaint (_("read_pointer_type: NULL target type (%ld)"), btid
);
959 target_type
= builtin_type (ccp
->of
)->builtin_error
;
963 type
= lookup_pointer_type (target_type
);
964 set_type_align (type
, ctf_type_align (ccp
->fp
, tid
));
966 return set_tid_type (of
, tid
, type
);
969 /* Read information from a TID of CTF_K_FORWARD. */
972 read_forward_type (struct ctf_context
*ccp
, ctf_id_t tid
)
974 struct objfile
*of
= ccp
->of
;
975 ctf_dict_t
*fp
= ccp
->fp
;
979 type
= type_allocator (of
, language_c
).new_type ();
981 const char *name
= ctf_type_name_raw (fp
, tid
);
982 if (name
!= nullptr && strlen (name
) != 0)
983 type
->set_name (name
);
985 kind
= ctf_type_kind_forwarded (fp
, tid
);
986 if (kind
== CTF_K_UNION
)
987 type
->set_code (TYPE_CODE_UNION
);
989 type
->set_code (TYPE_CODE_STRUCT
);
991 type
->set_length (0);
992 type
->set_is_stub (true);
994 return set_tid_type (of
, tid
, type
);
997 /* Read information associated with type TID. */
1000 read_type_record (struct ctf_context
*ccp
, ctf_id_t tid
)
1002 ctf_dict_t
*fp
= ccp
->fp
;
1004 struct type
*type
= nullptr;
1007 kind
= ctf_type_kind (fp
, tid
);
1012 type
= read_structure_type (ccp
, tid
);
1015 type
= read_enum_type (ccp
, tid
);
1017 case CTF_K_FUNCTION
:
1018 type
= read_func_kind_type (ccp
, tid
);
1021 btid
= ctf_type_reference (fp
, tid
);
1022 type
= read_const_type (ccp
, tid
, btid
);
1026 const char *name
= ctf_type_name_raw (fp
, tid
);
1027 btid
= ctf_type_reference (fp
, tid
);
1028 type
= read_typedef_type (ccp
, tid
, btid
, name
);
1031 case CTF_K_VOLATILE
:
1032 btid
= ctf_type_reference (fp
, tid
);
1033 type
= read_volatile_type (ccp
, tid
, btid
);
1035 case CTF_K_RESTRICT
:
1036 btid
= ctf_type_reference (fp
, tid
);
1037 type
= read_restrict_type (ccp
, tid
, btid
);
1040 btid
= ctf_type_reference (fp
, tid
);
1041 type
= read_pointer_type (ccp
, tid
, btid
);
1045 type
= read_base_type (ccp
, tid
);
1048 type
= read_array_type (ccp
, tid
);
1051 type
= read_forward_type (ccp
, tid
);
1062 /* Callback to add type TID to the symbol table. */
1065 ctf_add_type_cb (ctf_id_t tid
, void *arg
)
1067 struct ctf_context
*ccp
= (struct ctf_context
*) arg
;
1071 /* Check if tid's type has already been defined. */
1072 type
= get_tid_type (ccp
->of
, tid
);
1073 if (type
!= nullptr)
1076 ctf_id_t btid
= ctf_type_reference (ccp
->fp
, tid
);
1077 kind
= ctf_type_kind (ccp
->fp
, tid
);
1082 process_structure_type (ccp
, tid
);
1085 process_enum_type (ccp
, tid
);
1087 case CTF_K_FUNCTION
:
1088 type
= read_func_kind_type (ccp
, tid
);
1089 new_symbol (ccp
, type
, tid
);
1093 process_base_type (ccp
, tid
);
1096 new_symbol (ccp
, read_type_record (ccp
, tid
), tid
);
1099 type
= read_const_type (ccp
, tid
, btid
);
1100 new_symbol (ccp
, type
, tid
);
1102 case CTF_K_VOLATILE
:
1103 type
= read_volatile_type (ccp
, tid
, btid
);
1104 new_symbol (ccp
, type
, tid
);
1106 case CTF_K_RESTRICT
:
1107 type
= read_restrict_type (ccp
, tid
, btid
);
1108 new_symbol (ccp
, type
, tid
);
1111 type
= read_pointer_type (ccp
, tid
, btid
);
1112 new_symbol (ccp
, type
, tid
);
1115 type
= read_array_type (ccp
, tid
);
1116 new_symbol (ccp
, type
, tid
);
1127 /* Callback to add variable NAME with TID to the symbol table. */
1130 ctf_add_var_cb (const char *name
, ctf_id_t id
, void *arg
)
1132 struct ctf_context
*ccp
= (struct ctf_context
*) arg
;
1133 struct symbol
*sym
= nullptr;
1137 type
= get_tid_type (ccp
->of
, id
);
1139 kind
= ctf_type_kind (ccp
->fp
, id
);
1142 case CTF_K_FUNCTION
:
1143 if (name
!= nullptr && strcmp (name
, "main") == 0)
1144 set_objfile_main_name (ccp
->of
, name
, language_c
);
1148 case CTF_K_VOLATILE
:
1149 case CTF_K_RESTRICT
:
1154 if (type
!= nullptr)
1156 sym
= new_symbol (ccp
, type
, id
);
1158 sym
->compute_and_set_names (name
, false, ccp
->of
->per_bfd
);
1164 if (type
== nullptr)
1166 complaint (_("ctf_add_var_cb: %s has NO type (%ld)"), name
, id
);
1167 type
= builtin_type (ccp
->of
)->builtin_error
;
1169 sym
= new (&ccp
->of
->objfile_obstack
) symbol
;
1170 OBJSTAT (ccp
->of
, n_syms
++);
1171 sym
->set_type (type
);
1172 sym
->set_domain (VAR_DOMAIN
);
1173 sym
->set_aclass_index (LOC_OPTIMIZED_OUT
);
1174 sym
->compute_and_set_names (name
, false, ccp
->of
->per_bfd
);
1175 add_symbol_to_list (sym
, ccp
->builder
->get_file_symbols ());
1178 complaint (_("ctf_add_var_cb: kind unsupported (%d)"), kind
);
1183 set_symbol_address (ccp
->of
, sym
, name
);
1188 /* Add entries in either data objects or function info section, controlled
1192 add_stt_entries (struct ctf_context
*ccp
, int functions
)
1194 ctf_next_t
*i
= nullptr;
1197 struct symbol
*sym
= nullptr;
1200 while ((tid
= ctf_symbol_next (ccp
->fp
, &i
, &tname
, functions
)) != CTF_ERR
)
1202 type
= get_tid_type (ccp
->of
, tid
);
1203 if (type
== nullptr)
1205 sym
= new (&ccp
->of
->objfile_obstack
) symbol
;
1206 OBJSTAT (ccp
->of
, n_syms
++);
1207 sym
->set_type (type
);
1208 sym
->set_domain (VAR_DOMAIN
);
1209 sym
->set_aclass_index (LOC_STATIC
);
1210 sym
->compute_and_set_names (tname
, false, ccp
->of
->per_bfd
);
1211 add_symbol_to_list (sym
, ccp
->builder
->get_global_symbols ());
1212 set_symbol_address (ccp
->of
, sym
, tname
);
1216 /* Add entries in data objects section. */
1219 add_stt_obj (struct ctf_context
*ccp
)
1221 add_stt_entries (ccp
, 0);
1224 /* Add entries in function info section. */
1227 add_stt_func (struct ctf_context
*ccp
)
1229 add_stt_entries (ccp
, 1);
1232 /* Get text section base for OBJFILE, TSIZE contains the size. */
1235 get_objfile_text_range (struct objfile
*of
, size_t *tsize
)
1237 bfd
*abfd
= of
->obfd
.get ();
1238 const asection
*codes
;
1240 codes
= bfd_get_section_by_name (abfd
, ".text");
1241 *tsize
= codes
? bfd_section_size (codes
) : 0;
1242 return of
->text_section_offset ();
1245 /* Start a symtab for OBJFILE in CTF format. */
1248 ctf_start_compunit_symtab (ctf_psymtab
*pst
,
1249 struct objfile
*of
, CORE_ADDR text_offset
)
1251 struct ctf_context
*ccp
;
1253 ccp
= &pst
->context
;
1254 ccp
->builder
= new buildsym_compunit
1255 (of
, pst
->filename
, nullptr,
1256 language_c
, text_offset
);
1257 ccp
->builder
->record_debugformat ("ctf");
1260 /* Finish reading symbol/type definitions in CTF format.
1261 END_ADDR is the end address of the file's text. */
1263 static struct compunit_symtab
*
1264 ctf_end_compunit_symtab (ctf_psymtab
*pst
,
1267 struct ctf_context
*ccp
;
1269 ccp
= &pst
->context
;
1270 struct compunit_symtab
*result
1271 = ccp
->builder
->end_compunit_symtab (end_addr
);
1272 delete ccp
->builder
;
1273 ccp
->builder
= nullptr;
1277 /* Add all members of an enum with type TID to partial symbol table. */
1280 ctf_psymtab_add_enums (struct ctf_context
*ccp
, ctf_id_t tid
)
1284 ctf_next_t
*i
= nullptr;
1286 while ((ename
= ctf_enum_next (ccp
->fp
, tid
, &i
, &val
)) != nullptr)
1288 ccp
->pst
->add_psymbol (ename
, true,
1289 VAR_DOMAIN
, LOC_CONST
, -1,
1290 psymbol_placement::GLOBAL
,
1291 unrelocated_addr (0),
1292 language_c
, ccp
->partial_symtabs
, ccp
->of
);
1294 if (ctf_errno (ccp
->fp
) != ECTF_NEXT_END
)
1295 complaint (_("ctf_enum_next ctf_psymtab_add_enums failed - %s"),
1296 ctf_errmsg (ctf_errno (ccp
->fp
)));
1299 /* Add entries in either data objects or function info section, controlled
1300 by FUNCTIONS, to psymtab. */
1303 ctf_psymtab_add_stt_entries (ctf_dict_t
*cfp
, ctf_psymtab
*pst
,
1304 struct objfile
*of
, int functions
)
1306 ctf_next_t
*i
= nullptr;
1310 while ((tid
= ctf_symbol_next (cfp
, &i
, &tname
, functions
)) != CTF_ERR
)
1312 uint32_t kind
= ctf_type_kind (cfp
, tid
);
1313 address_class aclass
;
1314 domain_enum tdomain
;
1320 tdomain
= STRUCT_DOMAIN
;
1323 tdomain
= VAR_DOMAIN
;
1327 if (kind
== CTF_K_FUNCTION
)
1328 aclass
= LOC_STATIC
;
1329 else if (kind
== CTF_K_CONST
)
1332 aclass
= LOC_TYPEDEF
;
1334 pst
->add_psymbol (tname
, true,
1335 tdomain
, aclass
, -1,
1336 psymbol_placement::GLOBAL
,
1337 unrelocated_addr (0),
1338 language_c
, pst
->context
.partial_symtabs
, of
);
1342 /* Add entries in data objects section to psymtab. */
1345 ctf_psymtab_add_stt_obj (ctf_dict_t
*cfp
, ctf_psymtab
*pst
,
1348 ctf_psymtab_add_stt_entries (cfp
, pst
, of
, 0);
1351 /* Add entries in function info section to psymtab. */
1354 ctf_psymtab_add_stt_func (ctf_dict_t
*cfp
, ctf_psymtab
*pst
,
1357 ctf_psymtab_add_stt_entries (cfp
, pst
, of
, 1);
1360 /* Read in full symbols for PST, and anything it depends on. */
1363 ctf_psymtab::expand_psymtab (struct objfile
*objfile
)
1365 struct ctf_context
*ccp
;
1367 gdb_assert (!readin
);
1371 /* Iterate over entries in data types section. */
1372 if (ctf_type_iter (ccp
->fp
, ctf_add_type_cb
, ccp
) == CTF_ERR
)
1373 complaint (_("ctf_type_iter psymtab_to_symtab failed - %s"),
1374 ctf_errmsg (ctf_errno (ccp
->fp
)));
1377 /* Iterate over entries in variable info section. */
1378 if (ctf_variable_iter (ccp
->fp
, ctf_add_var_cb
, ccp
) == CTF_ERR
)
1379 complaint (_("ctf_variable_iter psymtab_to_symtab failed - %s"),
1380 ctf_errmsg (ctf_errno (ccp
->fp
)));
1382 /* Add entries in data objects and function info sections. */
1389 /* Expand partial symbol table PST into a full symbol table.
1393 ctf_psymtab::read_symtab (struct objfile
*objfile
)
1396 warning (_("bug: psymtab for %s is already read in."), filename
);
1401 gdb_printf (_("Reading in CTF data for %s..."), filename
);
1402 gdb_flush (gdb_stdout
);
1405 /* Start a symtab. */
1406 CORE_ADDR offset
; /* Start of text segment. */
1409 offset
= get_objfile_text_range (objfile
, &tsize
);
1410 ctf_start_compunit_symtab (this, objfile
, offset
);
1411 expand_psymtab (objfile
);
1413 set_text_low (unrelocated_addr (0));
1414 set_text_high (unrelocated_addr (tsize
));
1415 compunit_symtab
= ctf_end_compunit_symtab (this, offset
+ tsize
);
1417 /* Finish up the debug error message. */
1419 gdb_printf (_("done.\n"));
1423 /* Allocate a new partial_symtab NAME.
1425 Each source file that has not been fully read in is represented by
1426 a partial_symtab. This contains the information on where in the
1427 executable the debugging symbols for a specific file are, and a
1428 list of names of global symbols which are located in this file.
1429 They are all chained on partial symtab lists.
1431 Even after the source file has been read into a symtab, the
1432 partial_symtab remains around. They are allocated on an obstack,
1435 static ctf_psymtab
*
1436 create_partial_symtab (const char *name
,
1439 psymtab_storage
*partial_symtabs
,
1440 struct objfile
*objfile
)
1444 pst
= new ctf_psymtab (name
, partial_symtabs
, objfile
->per_bfd
,
1445 unrelocated_addr (0));
1447 pst
->context
.arc
= arc
;
1448 pst
->context
.fp
= cfp
;
1449 pst
->context
.of
= objfile
;
1450 pst
->context
.partial_symtabs
= partial_symtabs
;
1451 pst
->context
.pst
= pst
;
1452 pst
->context
.builder
= nullptr;
1457 /* Callback to add type TID to partial symbol table. */
1460 ctf_psymtab_type_cb (ctf_id_t tid
, void *arg
)
1462 struct ctf_context
*ccp
;
1466 ccp
= (struct ctf_context
*) arg
;
1468 domain_enum domain
= UNDEF_DOMAIN
;
1469 enum address_class aclass
= LOC_UNDEF
;
1470 kind
= ctf_type_kind (ccp
->fp
, tid
);
1474 ctf_psymtab_add_enums (ccp
, tid
);
1478 domain
= STRUCT_DOMAIN
;
1479 aclass
= LOC_TYPEDEF
;
1481 case CTF_K_FUNCTION
:
1483 domain
= VAR_DOMAIN
;
1484 aclass
= LOC_STATIC
;
1485 section
= SECT_OFF_TEXT (ccp
->of
);
1488 domain
= VAR_DOMAIN
;
1489 aclass
= LOC_STATIC
;
1493 case CTF_K_VOLATILE
:
1494 case CTF_K_RESTRICT
:
1495 domain
= VAR_DOMAIN
;
1496 aclass
= LOC_TYPEDEF
;
1500 domain
= VAR_DOMAIN
;
1501 aclass
= LOC_TYPEDEF
;
1508 const char *name
= ctf_type_name_raw (ccp
->fp
, tid
);
1509 if (name
== nullptr || strlen (name
) == 0)
1512 ccp
->pst
->add_psymbol (name
, false,
1513 domain
, aclass
, section
,
1514 psymbol_placement::STATIC
,
1515 unrelocated_addr (0),
1516 language_c
, ccp
->partial_symtabs
, ccp
->of
);
1521 /* Callback to add variable NAME with ID to partial symbol table. */
1524 ctf_psymtab_var_cb (const char *name
, ctf_id_t id
, void *arg
)
1526 struct ctf_context
*ccp
= (struct ctf_context
*) arg
;
1528 ccp
->pst
->add_psymbol (name
, true,
1529 VAR_DOMAIN
, LOC_STATIC
, -1,
1530 psymbol_placement::GLOBAL
,
1531 unrelocated_addr (0),
1532 language_c
, ccp
->partial_symtabs
, ccp
->of
);
1536 /* Setup partial_symtab's describing each source file for which
1537 debugging information is available. */
1540 scan_partial_symbols (ctf_dict_t
*cfp
, psymtab_storage
*partial_symtabs
,
1541 struct ctf_per_tu_data
*tup
, const char *fname
)
1543 struct objfile
*of
= tup
->of
;
1544 bool isparent
= false;
1546 if (strcmp (fname
, ".ctf") == 0)
1548 fname
= bfd_get_filename (of
->obfd
.get ());
1552 ctf_psymtab
*pst
= create_partial_symtab (fname
, tup
->arc
, cfp
,
1553 partial_symtabs
, of
);
1555 struct ctf_context
*ccx
= &pst
->context
;
1556 if (isparent
== false)
1559 if (ctf_type_iter (cfp
, ctf_psymtab_type_cb
, ccx
) == CTF_ERR
)
1560 complaint (_("ctf_type_iter scan_partial_symbols failed - %s"),
1561 ctf_errmsg (ctf_errno (cfp
)));
1563 if (ctf_variable_iter (cfp
, ctf_psymtab_var_cb
, ccx
) == CTF_ERR
)
1564 complaint (_("ctf_variable_iter scan_partial_symbols failed - %s"),
1565 ctf_errmsg (ctf_errno (cfp
)));
1567 /* Scan CTF object and function sections which correspond to each
1568 STT_FUNC or STT_OBJECT entry in the symbol table,
1569 pick up what init_symtab has done. */
1570 ctf_psymtab_add_stt_obj (cfp
, pst
, of
);
1571 ctf_psymtab_add_stt_func (cfp
, pst
, of
);
1576 /* Callback to build the psymtab for archive member NAME. */
1579 build_ctf_archive_member (ctf_dict_t
*ctf
, const char *name
, void *arg
)
1581 struct ctf_per_tu_data
*tup
= (struct ctf_per_tu_data
*) arg
;
1582 ctf_dict_t
*parent
= tup
->fp
;
1584 if (strcmp (name
, ".ctf") != 0)
1585 ctf_import (ctf
, parent
);
1589 gdb_printf (_("Scanning archive member %s..."), name
);
1590 gdb_flush (gdb_stdout
);
1593 psymtab_storage
*pss
= tup
->psf
->get_partial_symtabs ().get ();
1594 scan_partial_symbols (ctf
, pss
, tup
, name
);
1599 /* Read CTF debugging information from a BFD section. This is
1600 called from elfread.c. It does a quick pass through the
1601 .ctf section to set up the partial symbol table. */
1604 elfctf_build_psymtabs (struct objfile
*of
)
1606 struct ctf_per_tu_data pcu
;
1607 bfd
*abfd
= of
->obfd
.get ();
1610 ctf_archive_t
*arc
= ctf_bfdopen (abfd
, &err
);
1612 error (_("ctf_bfdopen failed on %s - %s"),
1613 bfd_get_filename (abfd
), ctf_errmsg (err
));
1615 ctf_dict_t
*fp
= ctf_dict_open (arc
, NULL
, &err
);
1617 error (_("ctf_dict_open failed on %s - %s"),
1618 bfd_get_filename (abfd
), ctf_errmsg (err
));
1619 ctf_dict_key
.emplace (of
, fp
);
1625 psymbol_functions
*psf
= new psymbol_functions ();
1626 of
->qf
.emplace_front (psf
);
1629 if (ctf_archive_iter (arc
, build_ctf_archive_member
, &pcu
) < 0)
1630 error (_("ctf_archive_iter failed in input file %s: - %s"),
1631 bfd_get_filename (abfd
), ctf_errmsg (err
));
1637 elfctf_build_psymtabs (struct objfile
*of
)
1639 /* Nothing to do if CTF is disabled. */
1642 #endif /* ENABLE_LIBCTF */