bff4673b41
should not receive as exceptions (some will get converted to BSD signals instead). This is really the only stable way to ensure that a Mach exception gets converted to it's equivalent BSD signal. For programs that rely on BSD signal handlers, this has to happen or you can't even get the program to invoke the signal handler when under the debugger. This builds on a previous solution to this problem which required you start debugserver with the -U flag. This was not very discoverable and required lldb be the one to launch debugserver, which is not always the case. Differential Revision: https://reviews.llvm.org/D125434
119 lines
4.2 KiB
C++
119 lines
4.2 KiB
C++
//===-- MachTask.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
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// MachTask.h
|
|
// debugserver
|
|
//
|
|
// Created by Greg Clayton on 12/5/08.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef LLDB_TOOLS_DEBUGSERVER_SOURCE_MACOSX_MACHTASK_H
|
|
#define LLDB_TOOLS_DEBUGSERVER_SOURCE_MACOSX_MACHTASK_H
|
|
|
|
#include <mach/mach.h>
|
|
#include <sys/socket.h>
|
|
#include <map>
|
|
#include <string>
|
|
#include "DNBDefs.h"
|
|
#include "RNBContext.h"
|
|
#include "MachException.h"
|
|
#include "MachVMMemory.h"
|
|
#include "PThreadMutex.h"
|
|
|
|
class MachProcess;
|
|
|
|
typedef uint64_t MachMallocEventId;
|
|
|
|
enum MachMallocEventType {
|
|
eMachMallocEventTypeAlloc = 2,
|
|
eMachMallocEventTypeDealloc = 4,
|
|
eMachMallocEventTypeOther = 1
|
|
};
|
|
|
|
struct MachMallocEvent {
|
|
mach_vm_address_t m_base_address;
|
|
uint64_t m_size;
|
|
MachMallocEventType m_event_type;
|
|
MachMallocEventId m_event_id;
|
|
};
|
|
|
|
class MachTask {
|
|
public:
|
|
// Constructors and Destructors
|
|
MachTask(MachProcess *process);
|
|
virtual ~MachTask();
|
|
|
|
void Clear();
|
|
|
|
kern_return_t Suspend();
|
|
kern_return_t Resume();
|
|
|
|
nub_size_t ReadMemory(nub_addr_t addr, nub_size_t size, void *buf);
|
|
nub_size_t WriteMemory(nub_addr_t addr, nub_size_t size, const void *buf);
|
|
int GetMemoryRegionInfo(nub_addr_t addr, DNBRegionInfo *region_info);
|
|
std::string GetProfileData(DNBProfileDataScanType scanType);
|
|
|
|
nub_addr_t AllocateMemory(nub_size_t size, uint32_t permissions);
|
|
nub_bool_t DeallocateMemory(nub_addr_t addr);
|
|
|
|
mach_port_t ExceptionPort() const;
|
|
bool ExceptionPortIsValid() const;
|
|
kern_return_t SaveExceptionPortInfo();
|
|
kern_return_t RestoreExceptionPortInfo();
|
|
kern_return_t ShutDownExcecptionThread();
|
|
|
|
bool StartExceptionThread(
|
|
const RNBContext::IgnoredExceptions &ignored_exceptions, DNBError &err);
|
|
nub_addr_t GetDYLDAllImageInfosAddress(DNBError &err);
|
|
kern_return_t BasicInfo(struct task_basic_info *info);
|
|
static kern_return_t BasicInfo(task_t task, struct task_basic_info *info);
|
|
bool IsValid() const;
|
|
static bool IsValid(task_t task);
|
|
static void *ExceptionThread(void *arg);
|
|
void TaskPortChanged(task_t task);
|
|
task_t TaskPort() const { return m_task; }
|
|
task_t TaskPortForProcessID(DNBError &err, bool force = false);
|
|
static task_t TaskPortForProcessID(pid_t pid, DNBError &err,
|
|
uint32_t num_retries = 10,
|
|
uint32_t usec_interval = 10000);
|
|
|
|
MachProcess *Process() { return m_process; }
|
|
const MachProcess *Process() const { return m_process; }
|
|
|
|
nub_size_t PageSize();
|
|
void TaskWillExecProcessesSuspended() { m_exec_will_be_suspended = true; }
|
|
|
|
protected:
|
|
MachProcess *m_process; // The mach process that owns this MachTask
|
|
task_t m_task;
|
|
MachVMMemory m_vm_memory; // Special mach memory reading class that will take
|
|
// care of watching for page and region boundaries
|
|
MachException::PortInfo
|
|
m_exc_port_info; // Saved settings for all exception ports
|
|
pthread_t m_exception_thread; // Thread ID for the exception thread in case we
|
|
// need it
|
|
mach_port_t m_exception_port; // Exception port on which we will receive child
|
|
// exceptions
|
|
bool m_exec_will_be_suspended; // If this task exec's another process, that
|
|
// process will be launched suspended and we will
|
|
// need to execute one extra Resume to get it
|
|
// to progress from dyld_start.
|
|
bool m_do_double_resume; // next time we task_resume(), do it twice to
|
|
// fix a too-high suspend count.
|
|
|
|
typedef std::map<mach_vm_address_t, size_t> allocation_collection;
|
|
allocation_collection m_allocations;
|
|
|
|
private:
|
|
MachTask(const MachTask &) = delete;
|
|
MachTask &operator=(const MachTask &rhs) = delete;
|
|
};
|
|
|
|
#endif // LLDB_TOOLS_DEBUGSERVER_SOURCE_MACOSX_MACHTASK_H
|