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