1*fae548d3Szrj
2*fae548d3Szrj This table describes the call tree of the program, and was sorted by
3*fae548d3Szrj the total amount of time spent in each function and its children.
4*fae548d3Szrj
5*fae548d3Szrj Each entry in this table consists of several lines.  The line with the
6*fae548d3Szrj index number at the left hand margin lists the current function.
7*fae548d3Szrj The lines above it list the functions that called this function,
8*fae548d3Szrj and the lines below it list the functions this one called.
9*fae548d3Szrj This line lists:
10*fae548d3Szrj     index	A unique number given to each element of the table.
11*fae548d3Szrj		Index numbers are sorted numerically.
12*fae548d3Szrj		The index number is printed next to every function name so
13*fae548d3Szrj		it is easier to look up where the function is in the table.
14*fae548d3Szrj
15*fae548d3Szrj     % time	This is the percentage of the `total' time that was spent
16*fae548d3Szrj		in this function and its children.  Note that due to
17*fae548d3Szrj		different viewpoints, functions excluded by options, etc,
18*fae548d3Szrj		these numbers will NOT add up to 100%.
19*fae548d3Szrj
20*fae548d3Szrj     self	This is the total amount of time spent in this function.
21*fae548d3Szrj
22*fae548d3Szrj     children	This is the total amount of time propagated into this
23*fae548d3Szrj		function by its children.
24*fae548d3Szrj
25*fae548d3Szrj     called	This is the number of times the function was called.
26*fae548d3Szrj		If the function called itself recursively, the number
27*fae548d3Szrj		only includes non-recursive calls, and is followed by
28*fae548d3Szrj		a `+' and the number of recursive calls.
29*fae548d3Szrj
30*fae548d3Szrj     name	The name of the current function.  The index number is
31*fae548d3Szrj		printed after it.  If the function is a member of a
32*fae548d3Szrj		cycle, the cycle number is printed between the
33*fae548d3Szrj		function's name and the index number.
34*fae548d3Szrj
35*fae548d3Szrj
36*fae548d3Szrj For the function's parents, the fields have the following meanings:
37*fae548d3Szrj
38*fae548d3Szrj     self	This is the amount of time that was propagated directly
39*fae548d3Szrj		from the function into this parent.
40*fae548d3Szrj
41*fae548d3Szrj     children	This is the amount of time that was propagated from
42*fae548d3Szrj		the function's children into this parent.
43*fae548d3Szrj
44*fae548d3Szrj     called	This is the number of times this parent called the
45*fae548d3Szrj		function `/' the total number of times the function
46*fae548d3Szrj		was called.  Recursive calls to the function are not
47*fae548d3Szrj		included in the number after the `/'.
48*fae548d3Szrj
49*fae548d3Szrj     name	This is the name of the parent.  The parent's index
50*fae548d3Szrj		number is printed after it.  If the parent is a
51*fae548d3Szrj		member of a cycle, the cycle number is printed between
52*fae548d3Szrj		the name and the index number.
53*fae548d3Szrj
54*fae548d3Szrj If the parents of the function cannot be determined, the word
55*fae548d3Szrj `<spontaneous>' is printed in the `name' field, and all the other
56*fae548d3Szrj fields are blank.
57*fae548d3Szrj
58*fae548d3Szrj For the function's children, the fields have the following meanings:
59*fae548d3Szrj
60*fae548d3Szrj     self	This is the amount of time that was propagated directly
61*fae548d3Szrj		from the child into the function.
62*fae548d3Szrj
63*fae548d3Szrj     children	This is the amount of time that was propagated from the
64*fae548d3Szrj		child's children to the function.
65*fae548d3Szrj
66*fae548d3Szrj     called	This is the number of times the function called
67*fae548d3Szrj		this child `/' the total number of times the child
68*fae548d3Szrj		was called.  Recursive calls by the child are not
69*fae548d3Szrj		listed in the number after the `/'.
70*fae548d3Szrj
71*fae548d3Szrj     name	This is the name of the child.  The child's index
72*fae548d3Szrj		number is printed after it.  If the child is a
73*fae548d3Szrj		member of a cycle, the cycle number is printed
74*fae548d3Szrj		between the name and the index number.
75*fae548d3Szrj
76*fae548d3Szrj If there are any cycles (circles) in the call graph, there is an
77*fae548d3Szrj entry for the cycle-as-a-whole.  This entry shows who called the
78*fae548d3Szrj cycle (as parents) and the members of the cycle (as children.)
79*fae548d3Szrj The `+' recursive calls entry shows the number of function calls that
80*fae548d3Szrj were internal to the cycle, and the calls entry for each member shows,
81*fae548d3Szrj for that member, how many times it was called from other members of
82*fae548d3Szrj the cycle.
83*fae548d3Szrj
84*fae548d3SzrjCopyright (C) 2012-2020 Free Software Foundation, Inc.
85*fae548d3Szrj
86*fae548d3SzrjCopying and distribution of this file, with or without modification,
87*fae548d3Szrjare permitted in any medium without royalty provided the copyright
88*fae548d3Szrjnotice and this notice are preserved.
89