proc ¤

The event types that make sense for us to track in the process driver aren't the same as the ones in the rest of Pwndbg, so we just expose the native events in process driver, and let the rest of the REPL deal with any complexities that might arise from the translation.

This is mostly intended to keep the complexity of generating the START and NEW_THREAD events correctly out of the process driver.

Methods:

• created –

  This function is called when a process is created or attached to.

• suspended –

  This function is called when the execution of a process is suspended.

• resumed –

  This function is called when the execution of a process is resumed.

• exited –

  This function is called when a process terminates or is detached from.

• modules_loaded –

  This function is called when a new modules have been loaded.

created()

suspended()

resumed()

exited()

modules_loaded()

Drives the execution of a process, responding to its events and handling its I/O, and exposes a simple synchronous interface to the REPL interface.

Methods:

• has_process –

  Whether there's an active process in this driver.

• has_connection –

  Whether this driver's connected to a target. All drivers that have an

• cancel –

  Request that a currently ongoing operation be cancelled.

• interrupt –

  Interrupts the currently running process.

• cont –

  Continues execution of the process this object is driving, and returns

• run_lldb_command –

  Runs the given LLDB command and ataches I/O if necessary.

• run_coroutine –

  Runs the given coroutine and allows it to control the execution of the

• launch –

  Launches the process and handles startup events. Always stops on first

• attach –

  Attach to a process and handles startup events. Always stops on first

• connect –

  Connects to a remote proces with the given URL using the plugin with the

Attributes:

• io (IODriver) –
• process (SBProcess) –
• listener (SBListener) –
• debug (bool) –
• eh (EventHandler) –
• cancellation_requested (bool) –

io: IODriver = None

process: SBProcess = None

listener: SBListener = None

debug: bool = debug

eh: EventHandler = event_handler

cancellation_requested: bool = False

has_process() -> bool

has_connection() -> bool

cancel() -> None

interrupt() -> None

cont() -> None

run_lldb_command(command: str, target: BinaryIO) -> None

run_coroutine(coroutine: Coroutine[Any, Any, None]) -> bool

launch(
    target: SBTarget,
    io: IODriver,
    env: list[str],
    args: list[str],
    working_dir: str,
) -> SBError

attach(target: SBTarget, io: IODriver, info: SBAttachInfo) -> SBError

connect(target: SBTarget, io: IODriver, url: str, plugin: str) -> SBError