LLDB mainline
StopInfoMachException.h
Go to the documentation of this file.
1//===-- StopInfoMachException.h ---------------------------------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8
9#ifndef LLDB_SOURCE_PLUGINS_PROCESS_UTILITY_STOPINFOMACHEXCEPTION_H
10#define LLDB_SOURCE_PLUGINS_PROCESS_UTILITY_STOPINFOMACHEXCEPTION_H
11
12#include <optional>
13#include <string>
14
16
17#if defined(__APPLE__)
18// Needed for the EXC_* defines
19#include <mach/exception.h>
20#endif
21
22namespace lldb_private {
23
25 /// Determine the pointer-authentication related failure that caused this
26 /// exception. Returns true and fills out the failure description if there
27 /// is auth-related failure, and returns false otherwise.
29
30public:
31 // Constructors and Destructors
32 StopInfoMachException(Thread &thread, uint32_t exc_type,
33 uint32_t exc_data_count, uint64_t exc_code,
34 uint64_t exc_subcode)
35 : StopInfo(thread, exc_type), m_exc_data_count(exc_data_count),
36 m_exc_code(exc_code), m_exc_subcode(exc_subcode) {}
37
38 ~StopInfoMachException() override = default;
39
42 }
43
44 const char *GetDescription() override;
45
46#if defined(__APPLE__)
47 struct MachException {
48 static const char *Name(exception_type_t exc_type);
49 static std::optional<exception_type_t> ExceptionCode(const char *name);
50 };
51#endif
52
53 // Since some mach exceptions will be reported as breakpoints, signals,
54 // or trace, we use this static accessor which will translate the mach
55 // exception into the correct StopInfo.
57 Thread &thread, uint32_t exc_type, uint32_t exc_data_count,
58 uint64_t exc_code, uint64_t exc_sub_code, uint64_t exc_sub_sub_code,
59 bool pc_already_adjusted = true, bool adjust_pc_if_needed = false);
60
61protected:
63 uint64_t m_exc_code;
64 uint64_t m_exc_subcode;
65};
66
67} // namespace lldb_private
68
69#endif // LLDB_SOURCE_PLUGINS_PROCESS_UTILITY_STOPINFOMACHEXCEPTION_H
"lldb/Target/ExecutionContext.h" A class that contains an execution context.
StopInfoMachException(Thread &thread, uint32_t exc_type, uint32_t exc_data_count, uint64_t exc_code, uint64_t exc_subcode)
bool DeterminePtrauthFailure(ExecutionContext &exe_ctx)
Determine the pointer-authentication related failure that caused this exception.
lldb::StopReason GetStopReason() const override
static lldb::StopInfoSP CreateStopReasonWithMachException(Thread &thread, uint32_t exc_type, uint32_t exc_data_count, uint64_t exc_code, uint64_t exc_sub_code, uint64_t exc_sub_sub_code, bool pc_already_adjusted=true, bool adjust_pc_if_needed=false)
~StopInfoMachException() override=default
friend class Thread
Definition: StopInfo.h:198
A class that represents a running process on the host machine.
Definition: SBAttachInfo.h:14
std::shared_ptr< lldb_private::StopInfo > StopInfoSP
Definition: lldb-forward.h:415
StopReason
Thread stop reasons.
@ eStopReasonException