Merge branch 'vendor/GCC44'
[dragonfly.git] / contrib / binutils-2.21 / gprof / bsd_callg_bl.c
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;
11 {
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);
120 }