xref: /dflybsd-src/contrib/binutils-2.27/gprof/bsd_callg_bl.m (revision e656dc90e3d65d744d534af2f5ea88cf8101ebcf)
1*a9fa9459Szrj
2*a9fa9459Szrj
3*a9fa9459Szrj
4*a9fa9459Szrjcall graph profile:
5*a9fa9459Szrj          The sum of self and descendents is the major sort
6*a9fa9459Szrj          for this listing.
7*a9fa9459Szrj
8*a9fa9459Szrj          function entries:
9*a9fa9459Szrj
10*a9fa9459Szrjindex     the index of the function in the call graph
11*a9fa9459Szrj          listing, as an aid to locating it (see below).
12*a9fa9459Szrj
13*a9fa9459Szrj%time     the percentage of the total time of the program
14*a9fa9459Szrj          accounted for by this function and its
15*a9fa9459Szrj          descendents.
16*a9fa9459Szrj
17*a9fa9459Szrjself      the number of seconds spent in this function
18*a9fa9459Szrj          itself.
19*a9fa9459Szrj
20*a9fa9459Szrjdescendents
21*a9fa9459Szrj          the number of seconds spent in the descendents of
22*a9fa9459Szrj          this function on behalf of this function.
23*a9fa9459Szrj
24*a9fa9459Szrjcalled    the number of times this function is called (other
25*a9fa9459Szrj          than recursive calls).
26*a9fa9459Szrj
27*a9fa9459Szrjself      the number of times this function calls itself
28*a9fa9459Szrj          recursively.
29*a9fa9459Szrj
30*a9fa9459Szrjname      the name of the function, with an indication of
31*a9fa9459Szrj          its membership in a cycle, if any.
32*a9fa9459Szrj
33*a9fa9459Szrjindex     the index of the function in the call graph
34*a9fa9459Szrj          listing, as an aid to locating it.
35*a9fa9459Szrj
36*a9fa9459Szrj
37*a9fa9459Szrj
38*a9fa9459Szrj          parent listings:
39*a9fa9459Szrj
40*a9fa9459Szrjself*     the number of seconds of this function's self time
41*a9fa9459Szrj          which is due to calls from this parent.
42*a9fa9459Szrj
43*a9fa9459Szrjdescendents*
44*a9fa9459Szrj          the number of seconds of this function's
45*a9fa9459Szrj          descendent time which is due to calls from this
46*a9fa9459Szrj          parent.
47*a9fa9459Szrj
48*a9fa9459Szrjcalled**  the number of times this function is called by
49*a9fa9459Szrj          this parent.  This is the numerator of the
50*a9fa9459Szrj          fraction which divides up the function's time to
51*a9fa9459Szrj          its parents.
52*a9fa9459Szrj
53*a9fa9459Szrjtotal*    the number of times this function was called by
54*a9fa9459Szrj          all of its parents.  This is the denominator of
55*a9fa9459Szrj          the propagation fraction.
56*a9fa9459Szrj
57*a9fa9459Szrjparents   the name of this parent, with an indication of the
58*a9fa9459Szrj          parent's membership in a cycle, if any.
59*a9fa9459Szrj
60*a9fa9459Szrjindex     the index of this parent in the call graph
61*a9fa9459Szrj          listing, as an aid in locating it.
62*a9fa9459Szrj
63*a9fa9459Szrj
64*a9fa9459Szrj
65*a9fa9459Szrj          children listings:
66*a9fa9459Szrj
67*a9fa9459Szrjself*     the number of seconds of this child's self time
68*a9fa9459Szrj          which is due to being called by this function.
69*a9fa9459Szrj
70*a9fa9459Szrjdescendent*
71*a9fa9459Szrj          the number of seconds of this child's descendent's
72*a9fa9459Szrj          time which is due to being called by this
73*a9fa9459Szrj          function.
74*a9fa9459Szrj
75*a9fa9459Szrjcalled**  the number of times this child is called by this
76*a9fa9459Szrj          function.  This is the numerator of the
77*a9fa9459Szrj          propagation fraction for this child.
78*a9fa9459Szrj
79*a9fa9459Szrjtotal*    the number of times this child is called by all
80*a9fa9459Szrj          functions.  This is the denominator of the
81*a9fa9459Szrj          propagation fraction.
82*a9fa9459Szrj
83*a9fa9459Szrjchildren  the name of this child, and an indication of its
84*a9fa9459Szrj          membership in a cycle, if any.
85*a9fa9459Szrj
86*a9fa9459Szrjindex     the index of this child in the call graph listing,
87*a9fa9459Szrj          as an aid to locating it.
88*a9fa9459Szrj
89*a9fa9459Szrj
90*a9fa9459Szrj
91*a9fa9459Szrj          * these fields are omitted for parents (or
92*a9fa9459Szrj          children) in the same cycle as the function.  If
93*a9fa9459Szrj          the function (or child) is a member of a cycle,
94*a9fa9459Szrj          the propagated times and propagation denominator
95*a9fa9459Szrj          represent the self time and descendent time of the
96*a9fa9459Szrj          cycle as a whole.
97*a9fa9459Szrj
98*a9fa9459Szrj          ** static-only parents and children are indicated
99*a9fa9459Szrj          by a call count of 0.
100*a9fa9459Szrj
101*a9fa9459Szrj
102*a9fa9459Szrj
103*a9fa9459Szrj          cycle listings:
104*a9fa9459Szrj          the cycle as a whole is listed with the same
105*a9fa9459Szrj          fields as a function entry.  Below it are listed
106*a9fa9459Szrj          the members of the cycle, and their contributions
107*a9fa9459Szrj          to the time and call counts of the cycle.
108*a9fa9459Szrj
109*a9fa9459SzrjCopyright (C) 2012-2016 Free Software Foundation, Inc.
110*a9fa9459Szrj
111*a9fa9459SzrjCopying and distribution of this file, with or without modification,
112*a9fa9459Szrjare permitted in any medium without royalty provided the copyright
113*a9fa9459Szrjnotice and this notice are preserved.
114