libsanitizer/sanitizer_common/sanitizer_interface_internal.h

   1 //===-- sanitizer_interface_internal.h --------------------------*- C++ -*-===//
   2 //
   3 // This file is distributed under the University of Illinois Open Source
   4 // License. See LICENSE.TXT for details.
   5 //
   6 //===----------------------------------------------------------------------===//
   7 //
   8 // This file is shared between run-time libraries of sanitizers.
   9 //
  10 // This header declares the sanitizer runtime interface functions.
  11 // The runtime library has to define these functions so the instrumented program
  12 // could call them.
  13 //
  14 // See also include/sanitizer/common_interface_defs.h
  15 //===----------------------------------------------------------------------===//
  16 #ifndef SANITIZER_INTERFACE_INTERNAL_H
  17 #define SANITIZER_INTERFACE_INTERNAL_H
  18
  19 #include "sanitizer_internal_defs.h"
  20
  21 extern "C" {
  22   // Tell the tools to write their reports to "path.<pid>" instead of stderr.
  23   // The special values are "stdout" and "stderr".
  24   SANITIZER_INTERFACE_ATTRIBUTE
  25   void __sanitizer_set_report_path(const char *path);
  26   // Tell the tools to write their reports to the provided file descriptor
  27   // (casted to void *).
  28   SANITIZER_INTERFACE_ATTRIBUTE
  29   void __sanitizer_set_report_fd(void *fd);
  30
  31   typedef struct {
  32       int coverage_sandboxed;
  33       __sanitizer::sptr coverage_fd;
  34       unsigned int coverage_max_block_size;
  35   } __sanitizer_sandbox_arguments;
  36
  37   // Notify the tools that the sandbox is going to be turned on.
  38   SANITIZER_INTERFACE_ATTRIBUTE SANITIZER_WEAK_ATTRIBUTE void
  39       __sanitizer_sandbox_on_notify(__sanitizer_sandbox_arguments *args);
  40
  41   // This function is called by the tool when it has just finished reporting
  42   // an error. 'error_summary' is a one-line string that summarizes
  43   // the error message. This function can be overridden by the client.
  44   SANITIZER_INTERFACE_ATTRIBUTE SANITIZER_WEAK_ATTRIBUTE
  45   void __sanitizer_report_error_summary(const char *error_summary);
  46
  47   SANITIZER_INTERFACE_ATTRIBUTE void __sanitizer_cov_dump();
  48   SANITIZER_INTERFACE_ATTRIBUTE void __sanitizer_cov_init();
  49   SANITIZER_INTERFACE_ATTRIBUTE void __sanitizer_cov(__sanitizer::u32 *guard);
  50   SANITIZER_INTERFACE_ATTRIBUTE
  51   void __sanitizer_annotate_contiguous_container(const void *beg,
  52                                                  const void *end,
  53                                                  const void *old_mid,
  54                                                  const void *new_mid);
  55   SANITIZER_INTERFACE_ATTRIBUTE
  56   int __sanitizer_verify_contiguous_container(const void *beg, const void *mid,
  57                                               const void *end);
  58   SANITIZER_INTERFACE_ATTRIBUTE
  59   const void *__sanitizer_contiguous_container_find_bad_address(
  60       const void *beg, const void *mid, const void *end);
  61   } // extern "C"
  62
  63 #endif  // SANITIZER_INTERFACE_INTERNAL_H