mirror of
https://github.com/llvm/llvm-project.git
synced 2025-05-02 18:36:06 +00:00
a62586846f
Summary: Forewarning: This patch looks big in #LOC changed. I promise it's not that bad, it just moves a lot of content from one file to another. I've gone ahead and left inline comments on Phabricator for sections where this has happened. This patch: 1. Introduces the crash handler API (crash_handler_api.h). 2. Moves information required for out-of-process crash handling into an AllocatorState. This is a trivially-copied POD struct that designed to be recovered from a deceased process, and used by the crash handler to create a GWP-ASan report (along with the other trivially-copied Metadata struct). 3. Implements the crash handler API using the AllocatorState and Metadata. 4. Adds tests for the crash handler. 5. Reimplements the (now optionally linked by the supporting allocator) in-process crash handler (i.e. the segv handler) using the new crash handler API. 6. Minor updates Scudo & Scudo Standalone to fix compatibility. 7. Changed capitalisation of errors (e.g. /s/Use after free/Use After Free). Reviewers: cryptoad, eugenis, jfb Reviewed By: eugenis Subscribers: merge_guards_bot, pcc, jfb, dexonsmith, mgorny, cryptoad, #sanitizers, llvm-commits Tags: #sanitizers, #llvm Differential Revision: https://reviews.llvm.org/D73557
58 lines
2.4 KiB
C++
58 lines
2.4 KiB
C++
//===-- options.h -----------------------------------------------*- C++ -*-===//
|
|
//
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef GWP_ASAN_OPTIONS_H_
|
|
#define GWP_ASAN_OPTIONS_H_
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
namespace gwp_asan {
|
|
namespace options {
|
|
// ================================ Requirements ===============================
|
|
// This function is required to be either implemented by the supporting
|
|
// allocator, or one of the two provided implementations may be used
|
|
// (RTGwpAsanBacktraceLibc or RTGwpAsanBacktraceSanitizerCommon).
|
|
// ================================ Description ================================
|
|
// This function shall collect the backtrace for the calling thread and place
|
|
// the result in `TraceBuffer`. This function should elide itself and all frames
|
|
// below itself from `TraceBuffer`, i.e. the caller's frame should be in
|
|
// TraceBuffer[0], and subsequent frames 1..n into TraceBuffer[1..n], where a
|
|
// maximum of `Size` frames are stored. Returns the number of frames stored into
|
|
// `TraceBuffer`, and zero on failure. If the return value of this function is
|
|
// equal to `Size`, it may indicate that the backtrace is truncated.
|
|
// =================================== Notes ===================================
|
|
// This function may directly or indirectly call malloc(), as the
|
|
// GuardedPoolAllocator contains a reentrancy barrier to prevent infinite
|
|
// recursion. Any allocation made inside this function will be served by the
|
|
// supporting allocator, and will not have GWP-ASan protections.
|
|
typedef size_t (*Backtrace_t)(uintptr_t *TraceBuffer, size_t Size);
|
|
|
|
struct Options {
|
|
Backtrace_t Backtrace = nullptr;
|
|
|
|
// Read the options from the included definitions file.
|
|
#define GWP_ASAN_OPTION(Type, Name, DefaultValue, Description) \
|
|
Type Name = DefaultValue;
|
|
#include "gwp_asan/options.inc"
|
|
#undef GWP_ASAN_OPTION
|
|
|
|
void setDefaults() {
|
|
#define GWP_ASAN_OPTION(Type, Name, DefaultValue, Description) \
|
|
Name = DefaultValue;
|
|
#include "gwp_asan/options.inc"
|
|
#undef GWP_ASAN_OPTION
|
|
|
|
Backtrace = nullptr;
|
|
}
|
|
};
|
|
} // namespace options
|
|
} // namespace gwp_asan
|
|
|
|
#endif // GWP_ASAN_OPTIONS_H_
|