Home | History | Annotate | Line # | Download | only in gprof
bsd_callg_bl.c revision 1.1.1.4.2.1 
      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);
    120   fputs ("Copyright (C) 2012-2020 Free Software Foundation, Inc.\n", file);
    121   fputs ("\n", file);
    122   fputs ("Copying and distribution of this file, with or without modification,\n", file);
    123   fputs ("are permitted in any medium without royalty provided the copyright\n", file);
    124   fputs ("notice and this notice are preserved.\n", file);
    125 }
    126