8b3af63b89
A lot of comments in LLDB are surrounded by an ASCII line to delimit the begging and end of the comment. Its use is not really consistent across the code base, sometimes the lines are longer, sometimes they are shorter and sometimes they are omitted. Furthermore, it looks kind of weird with the 80 column limit, where the comment actually extends past the line, but not by much. Furthermore, when /// is used for Doxygen comments, it looks particularly odd. And when // is used, it incorrectly gives the impression that it's actually a Doxygen comment. I assume these lines were added to improve distinguishing between comments and code. However, given that todays editors and IDEs do a great job at highlighting comments, I think it's worth to drop this for the sake of consistency. The alternative is fixing all the inconsistencies, which would create a lot more churn. Differential revision: https://reviews.llvm.org/D60508 llvm-svn: 358135
110 lines
3.5 KiB
C++
110 lines
3.5 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 __MachTask_h__
|
|
#define __MachTask_h__
|
|
|
|
#include <mach/mach.h>
|
|
#include <sys/socket.h>
|
|
#include <map>
|
|
#include <string>
|
|
#include "DNBDefs.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(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();
|
|
|
|
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
|
|
|
|
typedef std::map<mach_vm_address_t, size_t> allocation_collection;
|
|
allocation_collection m_allocations;
|
|
|
|
private:
|
|
MachTask(const MachTask &); // Outlaw
|
|
MachTask &operator=(const MachTask &rhs); // Outlaw
|
|
};
|
|
|
|
#endif // __MachTask_h__
|