2001-05-28 Philip Blundell <philb@gnu.org>
[binutils.git] / gprof / bsd_callg_bl.c
blob5be63b9a24c2e29bc22d525e10cd7ad4fa36efca
1 /* ==> Do not modify this file!! It is created automatically
2 from bsd_callg_bl.m using the gen-c-prog.awk script. <== */
4 #include <stdio.h>
6 void
7 bsd_callg_blurb (file)
8 FILE *file;
10 fputs ("\n", file);
11 fputs ("\n", file);
12 fputs ("\n", file);
13 fputs ("call graph profile:\n", file);
14 fputs (" The sum of self and descendents is the major sort\n", file);
15 fputs (" for this listing.\n", file);
16 fputs ("\n", file);
17 fputs (" function entries:\n", file);
18 fputs ("\n", file);
19 fputs ("index the index of the function in the call graph\n", file);
20 fputs (" listing, as an aid to locating it (see below).\n", file);
21 fputs ("\n", file);
22 fputs ("%time the percentage of the total time of the program\n", file);
23 fputs (" accounted for by this function and its\n", file);
24 fputs (" descendents.\n", file);
25 fputs ("\n", file);
26 fputs ("self the number of seconds spent in this function\n", file);
27 fputs (" itself.\n", file);
28 fputs ("\n", file);
29 fputs ("descendents\n", file);
30 fputs (" the number of seconds spent in the descendents of\n", file);
31 fputs (" this function on behalf of this function.\n", file);
32 fputs ("\n", file);
33 fputs ("called the number of times this function is called (other\n", file);
34 fputs (" than recursive calls).\n", file);
35 fputs ("\n", file);
36 fputs ("self the number of times this function calls itself\n", file);
37 fputs (" recursively.\n", file);
38 fputs ("\n", file);
39 fputs ("name the name of the function, with an indication of\n", file);
40 fputs (" its membership in a cycle, if any.\n", file);
41 fputs ("\n", file);
42 fputs ("index the index of the function in the call graph\n", file);
43 fputs (" listing, as an aid to locating it.\n", file);
44 fputs ("\n", file);
45 fputs ("\n", file);
46 fputs ("\n", file);
47 fputs (" parent listings:\n", file);
48 fputs ("\n", file);
49 fputs ("self* the number of seconds of this function's self time\n", file);
50 fputs (" which is due to calls from this parent.\n", file);
51 fputs ("\n", file);
52 fputs ("descendents*\n", file);
53 fputs (" the number of seconds of this function's\n", file);
54 fputs (" descendent time which is due to calls from this\n", file);
55 fputs (" parent.\n", file);
56 fputs ("\n", file);
57 fputs ("called** the number of times this function is called by\n", file);
58 fputs (" this parent. This is the numerator of the\n", file);
59 fputs (" fraction which divides up the function's time to\n", file);
60 fputs (" its parents.\n", file);
61 fputs ("\n", file);
62 fputs ("total* the number of times this function was called by\n", file);
63 fputs (" all of its parents. This is the denominator of\n", file);
64 fputs (" the propagation fraction.\n", file);
65 fputs ("\n", file);
66 fputs ("parents the name of this parent, with an indication of the\n", file);
67 fputs (" parent's membership in a cycle, if any.\n", file);
68 fputs ("\n", file);
69 fputs ("index the index of this parent in the call graph\n", file);
70 fputs (" listing, as an aid in locating it.\n", file);
71 fputs ("\n", file);
72 fputs ("\n", file);
73 fputs ("\n", file);
74 fputs (" children listings:\n", file);
75 fputs ("\n", file);
76 fputs ("self* the number of seconds of this child's self time\n", file);
77 fputs (" which is due to being called by this function.\n", file);
78 fputs ("\n", file);
79 fputs ("descendent*\n", file);
80 fputs (" the number of seconds of this child's descendent's\n", file);
81 fputs (" time which is due to being called by this\n", file);
82 fputs (" function.\n", file);
83 fputs ("\n", file);
84 fputs ("called** the number of times this child is called by this\n", file);
85 fputs (" function. This is the numerator of the\n", file);
86 fputs (" propagation fraction for this child.\n", file);
87 fputs ("\n", file);
88 fputs ("total* the number of times this child is called by all\n", file);
89 fputs (" functions. This is the denominator of the\n", file);
90 fputs (" propagation fraction.\n", file);
91 fputs ("\n", file);
92 fputs ("children the name of this child, and an indication of its\n", file);
93 fputs (" membership in a cycle, if any.\n", file);
94 fputs ("\n", file);
95 fputs ("index the index of this child in the call graph listing,\n", file);
96 fputs (" as an aid to locating it.\n", file);
97 fputs ("\n", file);
98 fputs ("\n", file);
99 fputs ("\n", file);
100 fputs (" * these fields are omitted for parents (or\n", file);
101 fputs (" children) in the same cycle as the function. If\n", file);
102 fputs (" the function (or child) is a member of a cycle,\n", file);
103 fputs (" the propagated times and propagation denominator\n", file);
104 fputs (" represent the self time and descendent time of the\n", file);
105 fputs (" cycle as a whole.\n", file);
106 fputs ("\n", file);
107 fputs (" ** static-only parents and children are indicated\n", file);
108 fputs (" by a call count of 0.\n", file);
109 fputs ("\n", file);
110 fputs ("\n", file);
111 fputs ("\n", file);
112 fputs (" cycle listings:\n", file);
113 fputs (" the cycle as a whole is listed with the same\n", file);
114 fputs (" fields as a function entry. Below it are listed\n", file);
115 fputs (" the members of the cycle, and their contributions\n", file);
116 fputs (" to the time and call counts of the cycle.\n", file);
117 fputs ("\f\n", file);