intellicrack.bridges.x64dbg

X64dbg bridge for Windows debugging.

This module provides integration with x64dbg for dynamic analysis, debugging, and memory manipulation on Windows systems.

get_capstone()

Get the capstone module if available.

Returns:

The capstone module, or None if not installed.

Return type:

ModuleType | None

get_keystone()

Get the keystone module if available.

Returns:

The keystone module, or None if not installed.

Return type:

ModuleType | None

class X64DbgBridge

Bases: _X64DbgScriptingMixin

Bridge for x64dbg Windows debugger.

Composed from the _X64DbgBridgeBase core class together with topical mixin classes that inherit linearly so cross-references resolve through normal MRO. Each mixin groups one surface area so no single class definition exceeds the public method limit. The public interface, attribute set, and behavior are identical to the pre-refactor monolithic class.

async shutdown()

Shutdown x64dbg and cleanup resources.

Each cleanup phase is wrapped so that a fault in one stage cannot strand a later one. An exception from _close_connection no longer leaks the spawned x64dbg.exe process (audit6.md F-0011): the process-termination block is reached unconditionally, and the bookkeeping state (attached PID, breakpoints, watchpoints, pending step waiters, cached process handles) is always cleared in the finally arm even when termination itself raises. The first captured cleanup exception is re-raised after every other stage has run so callers can observe shutdown failures.

Raises:

• ToolError – Re-raises the first ToolError captured from _close_connection or super().shutdown() after every other cleanup stage has run.

• OSError – Re-raises the first OSError captured from process termination, kill, super().shutdown(), or _release_process_handles.

• KeyError – Re-raises a KeyError from the process manager if it could not unregister the captured PID.

• RuntimeError – Re-raises the first RuntimeError captured from any other cleanup stage (this branch also handles the residual case where cleanup_errors contains an exception class outside the typed-handler tuples).

Return type:

None