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