]>
git.ipfire.org Git - thirdparty/binutils-gdb.git/blob - gprof/gprof.h
2 * Copyright (c) 1983 Regents of the University of California.
5 * Redistribution and use in source and binary forms are permitted
6 * provided that: (1) source distributions retain this entire copyright
7 * notice and comment, and (2) distributions including binaries display
8 * the following acknowledgement: ``This product includes software
9 * developed by the University of California, Berkeley and its contributors''
10 * in the documentation or other materials provided with the distribution
11 * and in all advertising materials mentioning features or use of this
12 * software. Neither the name of the University nor the names of its
13 * contributors may be used to endorse or promote products derived
14 * from this software without specific prior written permission.
15 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
16 * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
17 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
19 * @(#)gprof.h 5.9 (Berkeley) 6/1/90
24 #include <sys/types.h>
45 * who am i, for error messages.
61 typedef u_short UNIT
; /* unit of profiling */
63 #define A_OUTNAME "a.out"
66 #define GMONNAME "gmon.out"
67 #define GMONSUM "gmon.sum"
71 * with pointers to the namelist entry of the parent and the child,
72 * a count of how many times this arc was traversed,
73 * and pointers to the next parent of this child and
74 * the next child of this parent.
77 struct nl
*arc_parentp
; /* pointer to parent's nl entry */
78 struct nl
*arc_childp
; /* pointer to child's nl entry */
79 long arc_count
; /* how calls from parent to child */
80 double arc_time
; /* time inherited along arc */
81 double arc_childtime
; /* childtime inherited along arc */
82 struct arcstruct
*arc_parentlist
; /* parents-of-this-child list */
83 struct arcstruct
*arc_childlist
; /* children-of-this-parent list */
85 typedef struct arcstruct arctype
;
89 * for each external in the specified file we gather
90 * its address, the number of calls and compute its share of cpu time.
93 char *name
; /* the name */
94 unsigned long value
; /* the pc entry point */
95 unsigned long svalue
; /* entry point aligned to histograms */
96 double time
; /* ticks in this routine */
97 double childtime
; /* cumulative ticks in children */
98 long ncall
; /* how many times called */
99 long selfcalls
; /* how many calls to self */
100 double propfraction
; /* what % of time propagates */
101 double propself
; /* how much self time propagates */
102 double propchild
; /* how much child time propagates */
103 bool printflag
; /* should this be printed? */
104 int index
; /* index in the graph list */
105 int toporder
; /* graph call chain top-sort order */
106 int cycleno
; /* internal number of cycle on */
107 struct nl
*cyclehead
; /* pointer to head of cycle */
108 struct nl
*cnext
; /* pointer to next member of cycle */
109 arctype
*parents
; /* list of caller arcs */
110 arctype
*children
; /* list of callee arcs */
112 typedef struct nl nltype
;
114 nltype
*nl
; /* the whole namelist */
115 nltype
*npe
; /* the virtual end of the namelist */
116 int nname
; /* the number of function names */
119 * flag which marks a nl entry as topologically ``busy''
120 * flag which marks a nl entry as topologically ``not_numbered''
126 * namelist entries for cycle headers.
127 * the number of discovered cycles.
129 nltype
*cyclenl
; /* cycle header namelist */
130 int ncycle
; /* number of cycles discovered */
133 * The header on the gmon.out file.
134 * gmon.out consists of one of these headers,
135 * and then an array of ncnt samples
136 * representing the discretized program counter values.
137 * this should be a struct phdr, but since everything is done
138 * as UNITs, this is in UNITs too.
151 * Each discretized pc sample has
152 * a count of the number of samples in its range
156 unsigned long s_lowpc
; /* lowpc from the profile file */
157 unsigned long s_highpc
; /* highpc from the profile file */
158 unsigned lowpc
, highpc
; /* range profiled, in UNIT's */
159 unsigned sampbytes
; /* number of bytes of samples */
160 int nsamples
; /* number of samples */
161 double actime
; /* accumulated time thus far for putprofline */
162 double totime
; /* total time for all routines */
163 double printtime
; /* total of time being printed */
164 double scale
; /* scale factor converting samples to pc
165 values: each sample covers scale bytes */
166 char *strtab
; /* string table in core */
167 off_t ssiz
; /* size of the string table */
168 unsigned char *textspace
; /* text space of a.out in core */
171 * option flags, from a to z.
173 bool aflag
; /* suppress static functions */
174 bool bflag
; /* blurbs, too */
175 bool cflag
; /* discovered call graph, too */
176 bool dflag
; /* debugging options */
177 bool eflag
; /* specific functions excluded */
178 bool Eflag
; /* functions excluded with time */
179 bool fflag
; /* specific functions requested */
180 bool Fflag
; /* functions requested with time */
181 bool kflag
; /* arcs to be deleted */
182 bool sflag
; /* sum multiple gmon.out files */
183 bool zflag
; /* zero time/called functions, too */
186 * structure for various string lists
189 struct stringlist
*next
;
192 struct stringlist
*elist
;
193 struct stringlist
*Elist
;
194 struct stringlist
*flist
;
195 struct stringlist
*Flist
;
196 struct stringlist
*kfromlist
;
197 struct stringlist
*ktolist
;
200 * function declarations
206 arctype
*arclookup();
256 unsigned long reladdr();
272 #define GREATERTHAN 1
279 #define SAMPLEDEBUG 32
281 #define CALLDEBUG 128
282 #define LOOKUPDEBUG 256
283 #define PROPDEBUG 512
284 #define ANYDEBUG 1024