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