6024e5c395
clang 20.0.0 (based on r547379) from build 12806354. Bug: http://b/379133546 Test: N/A Change-Id: I2eb8938af55d809de674be63cb30cf27e801862b Upstream-Commit: ad834e67b1105d15ef907f6255d4c96e8e733f57
73 lines
2.5 KiB
C++
73 lines
2.5 KiB
C++
//===-- OperatingSystem.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 LLDB_TARGET_OPERATINGSYSTEM_H
|
|
#define LLDB_TARGET_OPERATINGSYSTEM_H
|
|
|
|
#include "lldb/Core/PluginInterface.h"
|
|
#include "lldb/lldb-private.h"
|
|
|
|
namespace lldb_private {
|
|
|
|
/// \class OperatingSystem OperatingSystem.h "lldb/Target/OperatingSystem.h"
|
|
/// 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);
|
|
|
|
OperatingSystem(Process *process);
|
|
|
|
// 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.
|
|
};
|
|
|
|
} // namespace lldb_private
|
|
|
|
#endif // LLDB_TARGET_OPERATINGSYSTEM_H
|