You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

124 lines
4.2 KiB
C

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.

/* symtab.h
Copyright (C) 2000-2022 Free Software Foundation, Inc.
This file is part of GNU Binutils.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
MA 02110-1301, USA. */
#ifndef symtab_h
#define symtab_h
/* For a profile to be intelligible to a human user, it is necessary
to map code-addresses into source-code information. Source-code
information can be any combination of: (i) function-name, (ii)
source file-name, and (iii) source line number.
The symbol table is used to map addresses into source-code
information. */
#define NBBS 10
/* Symbol-entry. For each external in the specified file we gather
its address, the number of calls and compute its share of cpu time. */
typedef struct sym
{
/* Common information:
In the symbol-table, fields ADDR and FUNC_NAME are guaranteed
to contain valid information. FILE may be 0, if unknown and
LINE_NUM maybe 0 if unknown. */
bfd_vma addr; /* Address of entry point. */
bfd_vma end_addr; /* End-address. */
const char *name; /* Name of function this sym is from. */
Source_File *file; /* Source file symbol comes from. */
int line_num; /* Source line number. */
unsigned int /* Boolean fields: */
is_func:1, /* Is this a function entry point? */
is_static:1, /* Is this a local (static) symbol? */
is_bb_head:1, /* Is this the head of a basic-blk? */
mapped:1, /* This symbol was mapped to another name. */
has_been_placed:1; /* Have we placed this symbol? */
unsigned long ncalls; /* How many times executed */
int nuses; /* How many times this symbol appears in
a particular context. */
bfd_vma bb_addr[NBBS]; /* Address of basic-block start. */
unsigned long bb_calls[NBBS];/* How many times basic-block was called. */
struct sym *next; /* For building chains of syms. */
struct sym *prev; /* For building chains of syms. */
/* Profile specific information: */
/* Histogram specific information: */
struct
{
double time; /* (Weighted) ticks in this routine. */
bfd_vma scaled_addr; /* Scaled entry point. */
}
hist;
/* Call-graph specific information: */
struct
{
unsigned long self_calls; /* How many calls to self. */
double child_time; /* Cumulative ticks in children. */
int index; /* Index in the graph list. */
int top_order; /* Graph call chain top-sort order. */
bool print_flag; /* Should this be printed? */
struct
{
double fract; /* What % of time propagates. */
double self; /* How much self time propagates. */
double child; /* How much child time propagates. */
}
prop;
struct
{
int num; /* Internal number of cycle on. */
struct sym *head; /* Head of cycle. */
struct sym *next; /* Next member of cycle. */
}
cyc;
struct arc *parents; /* List of caller arcs. */
struct arc *children; /* List of callee arcs. */
}
cg;
}
Sym;
/* Symbol-tables are always assumed to be sorted
in increasing order of addresses. */
typedef struct
{
unsigned int len; /* # of symbols in this table. */
Sym *base; /* First element in symbol table. */
Sym *limit; /* Limit = base + len. */
}
Sym_Table;
extern Sym_Table symtab; /* The symbol table. */
extern void sym_init (Sym *);
extern void symtab_finalize (Sym_Table *);
#ifdef DEBUG
extern Sym *dbg_sym_lookup (Sym_Table *, bfd_vma);
#endif
extern Sym *sym_lookup (Sym_Table *, bfd_vma);
extern void find_call (Sym *, bfd_vma, bfd_vma);
#endif /* symtab_h */