97 lines · python
1from abc import ABCMeta, abstractmethod2 3import lldb4 5 6class ScriptedPlatform(metaclass=ABCMeta):7 8 """9 The base class for a scripted platform.10 11 Most of the base class methods are `@abstractmethod` that need to be12 overwritten by the inheriting class.13 """14 15 processes = None16 17 @abstractmethod18 def __init__(self, exe_ctx, args):19 """Construct a scripted platform.20 21 Args:22 exe_ctx (lldb.SBExecutionContext): The execution context for the scripted platform23 args (lldb.SBStructuredData): A Dictionary holding arbitrary24 key/value pairs used by the scripted platform.25 """26 processes = []27 28 @abstractmethod29 def list_processes(self):30 """Get a list of processes that are running or that can be attached to on the platform.31 32 .. code-block:: python33 34 processes = {35 420: {36 name: a.out,37 arch: aarch64,38 pid: 420,39 parent_pid: 42 (optional),40 uid: 0 (optional),41 gid: 0 (optional),42 },43 }44 45 Returns:46 Dict: The processes represented as a dictionary, with at least the47 process ID, name, architecture. Optionally, the user can also48 provide the parent process ID and the user and group IDs.49 The dictionary can be empty.50 """51 pass52 53 def get_process_info(self, pid):54 """Get the dictionary describing the process.55 56 Returns:57 Dict: The dictionary of process info that matched process ID.58 None if the process doesn't exists59 """60 pass61 62 @abstractmethod63 def attach_to_process(self, attach_info):64 """Attach to a process.65 66 Args:67 attach_info (lldb.SBAttachInfo): The information related to attach to a process.68 69 Returns:70 lldb.SBError: A status object notifying if the attach succeeded.71 """72 pass73 74 @abstractmethod75 def launch_process(self, launch_info):76 """Launch a process.77 78 Args:79 launch_info (lldb.SBLaunchInfo): The information related to the process launch.80 81 Returns:82 lldb.SBError: A status object notifying if the launch succeeded.83 """84 pass85 86 @abstractmethod87 def kill_process(self, pid):88 """Kill a process.89 90 Args:91 pid (int): Process ID for the process to be killed.92 93 Returns:94 lldb.SBError: A status object notifying if the shutdown succeeded.95 """96 pass97