(linenum→info "unix/slp.c:2238")

binutils/2.18/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 ("^L\n", file);
  120: }
Syntax (Markdown)