* blurbs.c: New file, created from gprof.flat and gprof.callg by
[deliverable/binutils-gdb.git] / gprof / blurbs.c
1 /* ==> Do not modify this file!! It is created automatically
2 by make-c-prog.awk; modify make-c-prog.awk instead. <== */
3
4 #include <stdio.h>
5
6 void
7 flat_blurb (file)
8 FILE *file;
9 {
10 fputs ("\n", file);
11 fputs ("\n", file);
12 fputs ("\n", file);
13 fputs ("flat profile:\n", file);
14 fputs ("\n", file);
15 fputs (" % the percentage of the total running time of the\n", file);
16 fputs ("time program used by this function.\n", file);
17 fputs ("\n", file);
18 fputs ("cumulative a running sum of the number of seconds accounted\n", file);
19 fputs (" seconds for by this function and those listed above it.\n", file);
20 fputs ("\n", file);
21 fputs (" self the number of seconds accounted for by this\n", file);
22 fputs ("seconds function alone. This is the major sort for this\n", file);
23 fputs (" listing.\n", file);
24 fputs ("\n", file);
25 fputs ("calls the number of times this function was invoked, if\n", file);
26 fputs (" this function is profiled, else blank.\n", file);
27 fputs (" \n", file);
28 fputs (" self the average number of milliseconds spent in this\n", file);
29 fputs ("ms/call function per call, if this function is profiled,\n", file);
30 fputs (" else blank.\n", file);
31 fputs ("\n", file);
32 fputs (" total the average number of milliseconds spent in this\n", file);
33 fputs ("ms/call function and its descendents per call, if this \n", file);
34 fputs (" function is profiled, else blank.\n", file);
35 fputs ("\n", file);
36 fputs ("name the name of the function. This is the minor sort\n", file);
37 fputs (" for this listing. The index shows the location of\n", file);
38 fputs (" the function in the gprof listing. If the index is\n", file);
39 fputs (" in parenthesis it shows where it would appear in\n", file);
40 fputs (" the gprof listing if it were to be printed.\n", file);
41 fputs ("\f\n", file);
42 }
43
44 void
45 callg_blurb (file)
46 FILE *file;
47 {
48 fputs ("\n", file);
49 fputs ("\n", file);
50 fputs ("\n", file);
51 fputs ("call graph profile:\n", file);
52 fputs (" The sum of self and descendents is the major sort\n", file);
53 fputs (" for this listing.\n", file);
54 fputs ("\n", file);
55 fputs (" function entries:\n", file);
56 fputs ("\n", file);
57 fputs ("index the index of the function in the call graph\n", file);
58 fputs (" listing, as an aid to locating it (see below).\n", file);
59 fputs ("\n", file);
60 fputs ("%time the percentage of the total time of the program\n", file);
61 fputs (" accounted for by this function and its\n", file);
62 fputs (" descendents.\n", file);
63 fputs ("\n", file);
64 fputs ("self the number of seconds spent in this function\n", file);
65 fputs (" itself.\n", file);
66 fputs ("\n", file);
67 fputs ("descendents\n", file);
68 fputs (" the number of seconds spent in the descendents of\n", file);
69 fputs (" this function on behalf of this function.\n", file);
70 fputs ("\n", file);
71 fputs ("called the number of times this function is called (other\n", file);
72 fputs (" than recursive calls).\n", file);
73 fputs ("\n", file);
74 fputs ("self the number of times this function calls itself\n", file);
75 fputs (" recursively.\n", file);
76 fputs ("\n", file);
77 fputs ("name the name of the function, with an indication of\n", file);
78 fputs (" its membership in a cycle, if any.\n", file);
79 fputs ("\n", file);
80 fputs ("index the index of the function in the call graph\n", file);
81 fputs (" listing, as an aid to locating it.\n", file);
82 fputs ("\n", file);
83 fputs ("\n", file);
84 fputs ("\n", file);
85 fputs (" parent listings:\n", file);
86 fputs ("\n", file);
87 fputs ("self* the number of seconds of this function's self time\n", file);
88 fputs (" which is due to calls from this parent.\n", file);
89 fputs ("\n", file);
90 fputs ("descendents*\n", file);
91 fputs (" the number of seconds of this function's\n", file);
92 fputs (" descendent time which is due to calls from this\n", file);
93 fputs (" parent.\n", file);
94 fputs ("\n", file);
95 fputs ("called** the number of times this function is called by\n", file);
96 fputs (" this parent. This is the numerator of the\n", file);
97 fputs (" fraction which divides up the function's time to\n", file);
98 fputs (" its parents.\n", file);
99 fputs ("\n", file);
100 fputs ("total* the number of times this function was called by\n", file);
101 fputs (" all of its parents. This is the denominator of\n", file);
102 fputs (" the propagation fraction.\n", file);
103 fputs ("\n", file);
104 fputs ("parents the name of this parent, with an indication of the\n", file);
105 fputs (" parent's membership in a cycle, if any.\n", file);
106 fputs ("\n", file);
107 fputs ("index the index of this parent in the call graph\n", file);
108 fputs (" listing, as an aid in locating it.\n", file);
109 fputs ("\n", file);
110 fputs ("\n", file);
111 fputs ("\n", file);
112 fputs (" children listings:\n", file);
113 fputs ("\n", file);
114 fputs ("self* the number of seconds of this child's self time\n", file);
115 fputs (" which is due to being called by this function.\n", file);
116 fputs ("\n", file);
117 fputs ("descendent*\n", file);
118 fputs (" the number of seconds of this child's descendent's\n", file);
119 fputs (" time which is due to being called by this\n", file);
120 fputs (" function.\n", file);
121 fputs ("\n", file);
122 fputs ("called** the number of times this child is called by this\n", file);
123 fputs (" function. This is the numerator of the\n", file);
124 fputs (" propagation fraction for this child.\n", file);
125 fputs ("\n", file);
126 fputs ("total* the number of times this child is called by all\n", file);
127 fputs (" functions. This is the denominator of the\n", file);
128 fputs (" propagation fraction.\n", file);
129 fputs ("\n", file);
130 fputs ("children the name of this child, and an indication of its\n", file);
131 fputs (" membership in a cycle, if any.\n", file);
132 fputs ("\n", file);
133 fputs ("index the index of this child in the call graph listing,\n", file);
134 fputs (" as an aid to locating it.\n", file);
135 fputs ("\n", file);
136 fputs ("\n", file);
137 fputs ("\n", file);
138 fputs (" * these fields are omitted for parents (or\n", file);
139 fputs (" children) in the same cycle as the function. If\n", file);
140 fputs (" the function (or child) is a member of a cycle,\n", file);
141 fputs (" the propagated times and propagation denominator\n", file);
142 fputs (" represent the self time and descendent time of the\n", file);
143 fputs (" cycle as a whole.\n", file);
144 fputs ("\n", file);
145 fputs (" ** static-only parents and children are indicated\n", file);
146 fputs (" by a call count of 0.\n", file);
147 fputs ("\n", file);
148 fputs ("\n", file);
149 fputs ("\n", file);
150 fputs (" cycle listings:\n", file);
151 fputs (" the cycle as a whole is listed with the same\n", file);
152 fputs (" fields as a function entry. Below it are listed\n", file);
153 fputs (" the members of the cycle, and their contributions\n", file);
154 fputs (" to the time and call counts of the cycle.\n", file);
155 fputs ("\f\n", file);
156 }
This page took 0.035105 seconds and 4 git commands to generate.