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