Loading...
tools/lldbmacros/usertaskdebugging/target.py xnu-12377.101.15 /dev/null
--- xnu/xnu-12377.101.15/tools/lldbmacros/usertaskdebugging/target.py
+++ /dev/null
@@ -1,142 +0,0 @@
-import binascii
-import logging
-import struct
-
-
-class Process(object):
-    """Base interface for process being debugged. Provides basic functions for gdbserver to interact.
-       Create a class object for your backing system to provide functionality
-
-       Here is the list of must implement functions:
-        + please update hinfo['ostype'] and hinfo['vendor'] if its not in (macosx, ios)
-        + please populate threads_ids_list with ids of threads.
-        - getThreadStopInfo
-        - getProcessInfo
-        - getRegisterDataForThread
-        - getRegisterInfo
-        - readMemory
-    """
-    def __init__(self, cputype, cpusubtype, ptrsize):
-        super().__init__()
-        self.hinfo = {
-            'cputype': cputype, 'cpusubtype': cpusubtype,
-            'triple': None, 'vendor': 'apple', 'ostype': 'macosx',
-            'endian': 'little', 'ptrsize': ptrsize, 'hostname': None, 'os_build': None,
-            'os_kernel': None, 'os_version': None, 'watchpoint_exceptions_received': None,
-            'default_packet_timeout': '10', 'distribution_id': None
-        }
-
-        ## if cputype is arm assume its ios
-        if (cputype & 0xc) != 0xc:
-            self.hinfo['ostype'] = 'ios'
-        self.ptrsize = ptrsize
-        self.threads = {}
-        self.threads_ids_list = []
-
-    def getHostInfo(self):
-        retval = ''
-        for i in list(self.hinfo.keys()):
-            if self.hinfo[i] is None:
-                continue
-            retval += '%s:%s;' % (str(i), str(self.hinfo[i]))
-        return retval
-
-    def getRegisterDataForThread(self, th_id, reg_num):
-        logging.critical("Not Implemented: getRegisterDataForThread")
-        return ''
-
-    def readMemory(self, address, size):
-        logging.critical("readMemory: Not Implemented: readMemory")
-        #E08 means read failed
-        return 'E08'
-
-    def writeMemory(self, address, data, size):
-        """ Unimplemented. address in ptr to save data to. data is native endian stream of bytes,
-        """
-        return 'E09'
-
-    def getRegisterInfo(regnum):
-        #something similar to
-        #"name:x1;bitsize:64;offset:8;encoding:uint;format:hex;gcc:1;dwarf:1;set:General Purpose Registers;"
-        logging.critical("getRegisterInfo: Not Implemented: getRegisterInfo")
-        return 'E45'
-
-    def getProcessInfo(self):
-        logging.critical("Not Implemented: qProcessInfo")
-        return ''
-
-    def getFirstThreadInfo(self):
-        """ describe all thread ids in the process.
-        """
-        thinfo_str = self.getThreadsInfo()
-        if not thinfo_str:
-            logging.warning('getFirstThreadInfo: Process has no threads')
-            return ''
-        return 'm' + thinfo_str
-
-    def getSubsequestThreadInfo(self):
-        """ return 'l' for last because all threads are listed in getFirstThreadInfo call.
-        """
-        return 'l'
-
-    def getSharedLibInfoAddress(self):
-        """ return int data of a hint where shared library is loaded.
-        """
-        logging.critical("Not Implemented: qShlibInfoAddr")
-        raise NotImplementedError('getSharedLibInfoAddress is not Implemented')
-
-    def getSignalInfo(self):
-        # return the signal info in required format.
-        return "T02" + "threads:" + self.getThreadsInfo() + ';'
-
-    def getThreadsInfo(self):
-        """ returns ',' separeted values of thread ids """
-        retval = ''
-        first = True
-        for tid in self.threads_ids_list:
-            if first is True:
-                first = False
-                retval += self.encodeThreadID(tid)
-            else:
-                retval += ',%s' % self.encodeThreadID(tid)
-        return retval
-
-    def getCurrentThreadID(self):
-        """ returns int thread id of the first stopped thread
-            if subclass supports thread switching etc then
-            make sure to re-implement this funciton
-        """
-        if self.threads_ids_list:
-            return self.threads_ids_list[0]
-        return 0
-
-    def getThreadStopInfo(self, th_id):
-        """ returns stop signal and some thread register info.
-        """
-        logging.critical("getThreadStopInfo: Not Implemented. returning basic info.")
-
-        return 'T02thread:%s' % self.encodeThreadID(th_id)
-
-    def encodeRegisterData(self, intdata, bytesize=None):
-        """ return an encoded string for unsigned int intdata
-            based on the bytesize and endianness value
-        """
-        if not bytesize:
-            bytesize = self.ptrsize
-
-        format = '<I'
-        if bytesize > 4:
-            format = '<Q'
-        packed_data = struct.pack(format, intdata)
-        return binascii.hexlify(packed_data).decode()
-
-    def encodePointerRegisterData(self, ptrdata):
-        """ encodes pointer data based on ptrsize defined for the target """
-        return self.encodeRegisterData(ptrdata, bytesize=self.ptrsize)
-
-    def encodeThreadID(self, intdata):
-        format = '>Q'
-        return binascii.hexlify(struct.pack(format, intdata)).decode()
-
-    def encodeByteString(self, bytestr):
-        return binascii.hexlify(bytestr).decode()