coregrind/pub_core_errormgr.h

   1
   2 /*--------------------------------------------------------------------*/
   3 /*--- ErrorMgr: management of errors and suppressions.             ---*/
   4 /*---                                          pub_core_errormgr.h ---*/
   5 /*--------------------------------------------------------------------*/
   6
   7 /*
   8    This file is part of Valgrind, a dynamic binary instrumentation
   9    framework.
  10
  11    Copyright (C) 2000-2017 Julian Seward
  12       jseward@acm.org
  13
  14    This program is free software; you can redistribute it and/or
  15    modify it under the terms of the GNU General Public License as
  16    published by the Free Software Foundation; either version 2 of the
  17    License, or (at your option) any later version.
  18
  19    This program is distributed in the hope that it will be useful, but
  20    WITHOUT ANY WARRANTY; without even the implied warranty of
  21    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  22    General Public License for more details.
  23
  24    You should have received a copy of the GNU General Public License
  25    along with this program; if not, see <http://www.gnu.org/licenses/>.
  26
  27    The GNU General Public License is contained in the file COPYING.
  28 */
  29
  30 #ifndef __PUB_CORE_ERRORMGR_H
  31 #define __PUB_CORE_ERRORMGR_H
  32
  33 //--------------------------------------------------------------------
  34 // PURPOSE: This module manages errors recording and printing,
  35 // which includes suppression reading and writing.
  36 //--------------------------------------------------------------------
  37
  38 #include "pub_tool_errormgr.h"
  39
  40 // These must be negative, so as to not overlap with tool error kinds.
  41 typedef
  42    enum {
  43       // Nb: thread errors are a relic of the time when Valgrind's core
  44       // could detect them.  This example is left as an example should new
  45       // core errors ever be added.
  46       ThreadErr = -1,
  47       FdBadClose = -2,
  48       FdNotClosed = -3,
  49    }
  50    CoreErrorKind;
  51
  52 /* Add a new suppression file in the list of supp files.
  53    If VG_(load_suppressions) was already called, also load it. */
  54 extern void VG_(add_suppression_file) (const HChar *filename);
  55
  56 extern void VG_(load_suppressions)        ( void );
  57
  58 // if verbosity == 0 && show_error_list == no (0)
  59 //       print nothing.
  60 // else if xml
  61 //       if show_error_list == yes (1)|all(2)
  62 //            print suppressions used (in xml format)
  63 // else
  64 //       print Error summary
  65 //       if show_error_list == yes|all
  66 //            print all errors and suppressions used.
  67 //            if show_error_list == all or also_suppressed,
  68 //                  also print the suppressed errors.
  69 extern void VG_(show_all_errors)          ( Int verbosity,
  70                                             Bool xml,
  71                                             Int show_error_list);
  72
  73 /* Print (in readable format) the last error that occurred. */
  74 extern void VG_(show_last_error)          ( void );
  75
  76 extern void VG_(show_error_counts_as_XML) ( void );
  77
  78 extern Bool VG_(is_action_requested)      ( const HChar* action, Bool* clo );
  79
  80 extern Bool VG_(showing_core_errors)      ( void );
  81
  82 extern UInt VG_(get_n_errs_found)         ( void );
  83 extern UInt VG_(get_n_errs_shown)         ( void );
  84
  85 extern Bool VG_(found_or_suppressed_errs) ( void );
  86
  87 extern void VG_(print_errormgr_stats)     ( void );
  88
  89 #endif   // __PUB_CORE_ERRORMGR_H
  90
  91 /*--------------------------------------------------------------------*/
  92 /*--- end                                                          ---*/
  93 /*--------------------------------------------------------------------*/