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
27 /* AIX defines hz as a macro. */
46 * who am i, for error messages.
62 typedef unsigned char UNIT[2]; /* unit of profiling */
64 #define A_OUTNAME "a.out"
67 #define GMONNAME "gmon.out"
68 #define GMONSUM "gmon.sum"
70 extern int bsd_style_output;
71 extern int discard_underscores;
75 * with pointers to the namelist entry of the parent and the child,
76 * a count of how many times this arc was traversed,
77 * and pointers to the next parent of this child and
78 * the next child of this parent.
81 struct nl *arc_parentp; /* pointer to parent's nl entry */
82 struct nl *arc_childp; /* pointer to child's nl entry */
83 long arc_count; /* how calls from parent to child */
84 double arc_time; /* time inherited along arc */
85 double arc_childtime; /* childtime inherited along arc */
86 struct arcstruct *arc_parentlist; /* parents-of-this-child list */
87 struct arcstruct *arc_childlist; /* children-of-this-parent list */
89 typedef struct arcstruct arctype;
93 * for each external in the specified file we gather
94 * its address, the number of calls and compute its share of cpu time.
97 CONST char *name; /* the name */
98 unsigned long value; /* the pc entry point */
99 unsigned long svalue; /* entry point aligned to histograms */
100 double time; /* ticks in this routine */
101 double childtime; /* cumulative ticks in children */
102 long ncall; /* how many times called */
103 long selfcalls; /* how many calls to self */
104 double propfraction; /* what % of time propagates */
105 double propself; /* how much self time propagates */
106 double propchild; /* how much child time propagates */
107 bool printflag; /* should this be printed? */
108 int index; /* index in the graph list */
109 int toporder; /* graph call chain top-sort order */
110 int cycleno; /* internal number of cycle on */
111 struct nl *cyclehead; /* pointer to head of cycle */
112 struct nl *cnext; /* pointer to next member of cycle */
113 arctype *parents; /* list of caller arcs */
114 arctype *children; /* list of callee arcs */
116 typedef struct nl nltype;
118 nltype *nl; /* the whole namelist */
119 nltype *npe; /* the virtual end of the namelist */
120 int nname; /* the number of function names */
123 * flag which marks a nl entry as topologically ``busy''
124 * flag which marks a nl entry as topologically ``not_numbered''
130 * namelist entries for cycle headers.
131 * the number of discovered cycles.
133 nltype *cyclenl; /* cycle header namelist */
134 int ncycle; /* number of cycles discovered */
137 * The header on the gmon.out file.
138 * gmon.out consists of one of these headers,
139 * and then an array of ncnt samples
140 * representing the discretized program counter values.
141 * this should be a struct phdr, but since everything is done
142 * as UNITs, this is in UNITs too.
162 * Each discretized pc sample has
163 * a count of the number of samples in its range
167 unsigned long s_lowpc; /* lowpc from the profile file */
168 unsigned long s_highpc; /* highpc from the profile file */
169 unsigned lowpc, highpc; /* range profiled, in UNIT's */
170 unsigned sampbytes; /* number of bytes of samples */
171 int nsamples; /* number of samples */
172 double actime; /* accumulated time thus far for putprofline */
173 double totime; /* total time for all routines */
174 double printtime; /* total of time being printed */
175 double scale; /* scale factor converting samples to pc
176 values: each sample covers scale bytes */
177 char *strtab; /* string table in core */
178 off_t ssiz; /* size of the string table */
179 unsigned char *textspace; /* text space of a.out in core */
182 * option flags, from a to z.
184 bool aflag; /* suppress static functions */
185 bool bflag; /* blurbs, too */
186 bool cflag; /* discovered call graph, too */
187 bool dflag; /* debugging options */
188 bool eflag; /* specific functions excluded */
189 bool Eflag; /* functions excluded with time */
190 bool fflag; /* specific functions requested */
191 bool Fflag; /* functions requested with time */
192 bool kflag; /* arcs to be deleted */
193 bool sflag; /* sum multiple gmon.out files */
194 bool zflag; /* zero time/called functions, too */
197 * structure for various string lists
200 struct stringlist *next;
203 struct stringlist *elist;
204 struct stringlist *Elist;
205 struct stringlist *flist;
206 struct stringlist *Flist;
207 struct stringlist *kfromlist;
208 struct stringlist *ktolist;
211 * function declarations
217 arctype *arclookup();
268 unsigned long reladdr();
284 #define GREATERTHAN 1
291 #define SAMPLEDEBUG 32
293 #define CALLDEBUG 128
294 #define LOOKUPDEBUG 256
295 #define PROPDEBUG 512
296 #define ANYDEBUG 1024