[deliverable/binutils-gdb.git] / gprof / bsd_callg_bl.m



call graph profile:
          The sum of self and descendents is the major sort
          for this listing.

          function entries:

index     the index of the function in the call graph
          listing, as an aid to locating it (see below).

%time     the percentage of the total time of the program
          accounted for by this function and its
          descendents.

self      the number of seconds spent in this function
          itself.

descendents
          the number of seconds spent in the descendents of
          this function on behalf of this function.

called    the number of times this function is called (other
          than recursive calls).

self      the number of times this function calls itself
          recursively.

name      the name of the function, with an indication of
          its membership in a cycle, if any.

index     the index of the function in the call graph
          listing, as an aid to locating it.


          parent listings:

self*     the number of seconds of this function's self time
          which is due to calls from this parent.

descendents*
          the number of seconds of this function's
          descendent time which is due to calls from this
          parent.

called**  the number of times this function is called by
          this parent.  This is the numerator of the
          fraction which divides up the function's time to
          its parents.

total*    the number of times this function was called by
          all of its parents.  This is the denominator of
          the propagation fraction.

parents   the name of this parent, with an indication of the
          parent's membership in a cycle, if any.

index     the index of this parent in the call graph
          listing, as an aid in locating it.


          children listings:

self*     the number of seconds of this child's self time
          which is due to being called by this function.

descendent*
          the number of seconds of this child's descendent's
          time which is due to being called by this
          function.

called**  the number of times this child is called by this
          function.  This is the numerator of the
          propagation fraction for this child.

total*    the number of times this child is called by all
          functions.  This is the denominator of the
          propagation fraction.

children  the name of this child, and an indication of its
          membership in a cycle, if any.

index     the index of this child in the call graph listing,
          as an aid to locating it.


          * these fields are omitted for parents (or
          children) in the same cycle as the function.  If
          the function (or child) is a member of a cycle,
          the propagated times and propagation denominator
          represent the self time and descendent time of the
          cycle as a whole.

          ** static-only parents and children are indicated
          by a call count of 0.


          cycle listings:
          the cycle as a whole is listed with the same
          fields as a function entry.  Below it are listed
          the members of the cycle, and their contributions
          to the time and call counts of the cycle.
\f
Commit	Line	Data
252b5132 RH	1
	2
	3
	4	call graph profile:
	5	The sum of self and descendents is the major sort
	6	for this listing.
	7
	8	function entries:
	9
	10	index the index of the function in the call graph
	11	listing, as an aid to locating it (see below).
	12
	13	%time the percentage of the total time of the program
	14	accounted for by this function and its
	15	descendents.
	16
	17	self the number of seconds spent in this function
	18	itself.
	19
	20	descendents
	21	the number of seconds spent in the descendents of
	22	this function on behalf of this function.
	23
	24	called the number of times this function is called (other
	25	than recursive calls).
	26
	27	self the number of times this function calls itself
	28	recursively.
	29
	30	name the name of the function, with an indication of
	31	its membership in a cycle, if any.
	32
	33	index the index of the function in the call graph
	34	listing, as an aid to locating it.
	35
	36
	37
	38	parent listings:
	39
	40	self* the number of seconds of this function's self time
	41	which is due to calls from this parent.
	42
	43	descendents*
	44	the number of seconds of this function's
	45	descendent time which is due to calls from this
	46	parent.
	47
	48	called** the number of times this function is called by
	49	this parent. This is the numerator of the
	50	fraction which divides up the function's time to
	51	its parents.
	52
	53	total* the number of times this function was called by
	54	all of its parents. This is the denominator of
	55	the propagation fraction.
	56
	57	parents the name of this parent, with an indication of the
	58	parent's membership in a cycle, if any.
	59
	60	index the index of this parent in the call graph
	61	listing, as an aid in locating it.
	62
	63
	64
65	children listings:
66
67	self* the number of seconds of this child's self time
68	which is due to being called by this function.
69
70	descendent*
71	the number of seconds of this child's descendent's
72	time which is due to being called by this
73	function.
74
75	called** the number of times this child is called by this
76	function. This is the numerator of the
77	propagation fraction for this child.
78
79	total* the number of times this child is called by all
80	functions. This is the denominator of the
81	propagation fraction.
82
83	children the name of this child, and an indication of its
84	membership in a cycle, if any.
85
86	index the index of this child in the call graph listing,
87	as an aid to locating it.
88
89
90
91	* these fields are omitted for parents (or
92	children) in the same cycle as the function. If
93	the function (or child) is a member of a cycle,
94	the propagated times and propagation denominator
95	represent the self time and descendent time of the
96	cycle as a whole.
97
98	** static-only parents and children are indicated
99	by a call count of 0.
100
101
102
103	cycle listings:
104	the cycle as a whole is listed with the same
105	fields as a function entry. Below it are listed
106	the members of the cycle, and their contributions
107	to the time and call counts of the cycle.
108	\f