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