blob: 74de5645da5a5bf9a12933425ba8446f3899d2a7 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
//===-- OperatingSystem.h ----------------------------------------------*- C++ -*-===//
//
// The LLVM Compiler Infrastructure
//
// This file is distributed under the University of Illinois Open Source
// License. See LICENSE.TXT for details.
//
//===----------------------------------------------------------------------===//
#ifndef liblldb_OperatingSystem_h_
#define liblldb_OperatingSystem_h_
// C Includes
// C++ Includes
// Other libraries and framework includes
#include "lldb/lldb-private.h"
#include "lldb/Core/PluginInterface.h"
namespace lldb_private {
//----------------------------------------------------------------------
/// @class OperatingSystem OperatingSystem.h "lldb/Target/OperatingSystem.h"
/// @brief A plug-in interface definition class for halted OS helpers.
///
/// Halted OS plug-ins can be used by any process to locate and create
/// OS objects, like threads, during the lifetime of a debug session.
/// This is commonly used when attaching to an operating system that is
/// halted, such as when debugging over JTAG or connecting to low level
/// kernel debug services.
//----------------------------------------------------------------------
class OperatingSystem :
public PluginInterface
{
public:
//------------------------------------------------------------------
/// Find a halted OS plugin for a given process.
///
/// Scans the installed OperatingSystem plug-ins and tries to find
/// an instance that matches the current target triple and
/// executable.
///
/// @param[in] process
/// The process for which to try and locate a halted OS
/// plug-in instance.
///
/// @param[in] plugin_name
/// An optional name of a specific halted OS plug-in that
/// should be used. If NULL, pick the best plug-in.
//------------------------------------------------------------------
static OperatingSystem*
FindPlugin (Process *process, const char *plugin_name);
//------------------------------------------------------------------
// Class Methods
//------------------------------------------------------------------
OperatingSystem (Process *process);
~OperatingSystem() override;
//------------------------------------------------------------------
// Plug-in Methods
//------------------------------------------------------------------
virtual bool
UpdateThreadList (ThreadList &old_thread_list,
ThreadList &real_thread_list,
ThreadList &new_thread_list) = 0;
virtual void
ThreadWasSelected (Thread *thread) = 0;
virtual lldb::RegisterContextSP
CreateRegisterContextForThread (Thread *thread, lldb::addr_t reg_data_addr) = 0;
virtual lldb::StopInfoSP
CreateThreadStopReason (Thread *thread) = 0;
virtual lldb::ThreadSP
CreateThread (lldb::tid_t tid, lldb::addr_t context)
{
return lldb::ThreadSP();
}
virtual bool
IsOperatingSystemPluginThread (const lldb::ThreadSP &thread_sp);
protected:
//------------------------------------------------------------------
// Member variables.
//------------------------------------------------------------------
Process* m_process; ///< The process that this dynamic loader plug-in is tracking.
private:
DISALLOW_COPY_AND_ASSIGN (OperatingSystem);
};
} // namespace lldb_private
#endif // liblldb_OperatingSystem_h_
|