bb79b06f4e
Summary: Merge "exitcode" flag from ASan, LSan, TSan and "exit_code" from MSan into one entity. Additionally, make sure sanitizer_common now uses the value of common_flags()->exitcode when dying on error, so that this flag will automatically work for other sanitizers (UBSan and DFSan) as well. User-visible changes: * "exit_code" MSan runtime flag is now deprecated. If explicitly specified, this flag will take precedence over "exitcode". The users are encouraged to migrate to the new version. * __asan_set_error_exit_code() and __msan_set_exit_code() functions are removed. With few exceptions, we don't support changing runtime flags during program execution - we can't make them thread-safe. The users should use __sanitizer_set_death_callback() that would call _exit() with proper exit code instead. * Plugin tools (LSan and UBSan) now inherit the exit code of the parent tool. In particular, this means that ASan would now crash the program with exit code "1" instead of "23" if it detects leaks. Reviewers: kcc, eugenis Subscribers: llvm-commits Differential Revision: http://reviews.llvm.org/D12120 llvm-svn: 245734
85 lines
3.5 KiB
C++
85 lines
3.5 KiB
C++
//===-- sanitizer/lsan_interface.h ------------------------------*- C++ -*-===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This file is a part of LeakSanitizer.
|
|
//
|
|
// Public interface header.
|
|
//===----------------------------------------------------------------------===//
|
|
#ifndef SANITIZER_LSAN_INTERFACE_H
|
|
#define SANITIZER_LSAN_INTERFACE_H
|
|
|
|
#include <sanitizer/common_interface_defs.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
// Allocations made between calls to __lsan_disable() and __lsan_enable() will
|
|
// be treated as non-leaks. Disable/enable pairs may be nested.
|
|
void __lsan_disable();
|
|
void __lsan_enable();
|
|
|
|
// The heap object into which p points will be treated as a non-leak.
|
|
void __lsan_ignore_object(const void *p);
|
|
|
|
// Memory regions registered through this interface will be treated as sources
|
|
// of live pointers during leak checking. Useful if you store pointers in
|
|
// mapped memory.
|
|
// Points of note:
|
|
// - __lsan_unregister_root_region() must be called with the same pointer and
|
|
// size that have earlier been passed to __lsan_register_root_region()
|
|
// - LSan will skip any inaccessible memory when scanning a root region. E.g.,
|
|
// if you map memory within a larger region that you have mprotect'ed, you can
|
|
// register the entire large region.
|
|
// - the implementation is not optimized for performance. This interface is
|
|
// intended to be used for a small number of relatively static regions.
|
|
void __lsan_register_root_region(const void *p, size_t size);
|
|
void __lsan_unregister_root_region(const void *p, size_t size);
|
|
|
|
// Check for leaks now. This function behaves identically to the default
|
|
// end-of-process leak check. In particular, it will terminate the process if
|
|
// leaks are found and the exitcode runtime flag is non-zero.
|
|
// Subsequent calls to this function will have no effect and end-of-process
|
|
// leak check will not run. Effectively, end-of-process leak check is moved to
|
|
// the time of first invocation of this function.
|
|
// By calling this function early during process shutdown, you can instruct
|
|
// LSan to ignore shutdown-only leaks which happen later on.
|
|
void __lsan_do_leak_check();
|
|
|
|
// Check for leaks now. Returns zero if no leaks have been found or if leak
|
|
// detection is disabled, non-zero otherwise.
|
|
// This function may be called repeatedly, e.g. to periodically check a
|
|
// long-running process. It prints a leak report if appropriate, but does not
|
|
// terminate the process. It does not affect the behavior of
|
|
// __lsan_do_leak_check() or the end-of-process leak check, and is not
|
|
// affected by them.
|
|
int __lsan_do_recoverable_leak_check();
|
|
|
|
// The user may optionally provide this function to disallow leak checking
|
|
// for the program it is linked into (if the return value is non-zero). This
|
|
// function must be defined as returning a constant value; any behavior beyond
|
|
// that is unsupported.
|
|
int __lsan_is_turned_off();
|
|
|
|
// This function may be optionally provided by the user and should return
|
|
// a string containing LSan suppressions.
|
|
const char *__lsan_default_suppressions();
|
|
#ifdef __cplusplus
|
|
} // extern "C"
|
|
|
|
namespace __lsan {
|
|
class ScopedDisabler {
|
|
public:
|
|
ScopedDisabler() { __lsan_disable(); }
|
|
~ScopedDisabler() { __lsan_enable(); }
|
|
};
|
|
} // namespace __lsan
|
|
#endif
|
|
|
|
#endif // SANITIZER_LSAN_INTERFACE_H
|