coveragedb.h

   1 // coveragedb.cxx
   2 // Copyright (C) 2007 Red Hat Inc.
   3 //
   4 // This file is part of systemtap, and is free software.  You can
   5 // redistribute it and/or modify it under the terms of the GNU General
   6 // Public License (GPL); either version 2, or (at your option) any
   7 // later version.
   8
   9 #ifndef COVERAGEDB_H
  10 #define COVERAGEDB_H
  11
  12 #include "session.h"
  13
  14 #include <string>
  15
  16
  17 /*
  18
  19 tuples: file, line number, column, type of object, name
  20 values: number of times object "pulled_in", number of times "removed",
  21 times executed
  22
  23 if (compiled == 0) object never compiled
  24 if (compiled > 0) object compiled
  25
  26 The following are not currently implemented.
  27 if (executed == 0) never executed
  28 if (executed > 0) executed
  29
  30
  31 Want to make sure that the data base accurately reflects testing.
  32 1) atomic updates, either commit all or none of information
  33 2) only update coverage db compile info, if compile successful
  34 3) only update coverage db execute info, if instrumentation run suscessfully
  35
  36
  37 Would like to have something that looks for interesting features in db:
  38
  39 list which things are not compile
  40 list which things are not exectuted
  41
  42 ratio of compiled/total (overall, by file, by line)
  43 ratio of executed/total (overall, by file, by line)
  44
  45 */
  46
  47 enum db_type {
  48   db_type_probe = 1,
  49   db_type_function = 2,
  50   db_type_local = 3,
  51   db_type_global = 4,
  52 };
  53
  54 class coverage_element {
  55 public:
  56   std::string file;
  57   int line;
  58   int col;
  59   int type;
  60   std::string name;
  61   std::string parent;
  62   int compiled;
  63   int executed;
  64
  65   coverage_element() { line = 0; col = 0;
  66           compiled = 0; executed = 0; }
  67
  68   coverage_element(source_loc &place) {
  69           file = place.file; line = place.line; col = place.column;
  70           compiled = 0; executed = 0; }
  71 };
  72
  73
  74
  75 void print_coverage_info(systemtap_session &s);
  76 void update_coverage_db(systemtap_session &s);
  77
  78 #endif
  79