contrib/binutils-2.24/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.  <== */
   3
   4 #include <stdio.h>
   5 #include "ansidecl.h"
   6
   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   fputs ("Copyright (C) 2012 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 }