Skip to main content

Debug Accelerator

The Corellium Debug Accelerator reduces the effect of network latency and makes the debugging experience feel more natural, resulting in an improvement in debugging speed of up to 10x. This tool is available for MacOS, Linux and Windows.

Usage on macOS and Linux

  1. Download the Linux binary or the macOS installation package.

    • On Linux, set the Debug Accelerator binary as executable.

      chmod u+x /path/to/debug_accelerator_linux_x86_64
    • On macOS, run the installer for Debug Accelerator for macOS. Click through the prompts and complete the installation. The executable will be installed under /usr/local/bin/. macOS installer

  2. Connect to the Virtual Device's VPN. Refer to our VPN article for more details.

  3. Make note of your device's Services IP from the Connect tab. In our example, we use 10.11.1.1.

  4. Run the Debug Accelerator, referencing <services_ip>:4000 for the remote host and port then 127.0.0.1:4000 for the local host and port. Look for a response: Listening on '127.0.0.1:4000'.

    /path/to/debug_accelerator 10.11.1.1:4000 127.0.0.1:4000
  5. Slightly modify the gdb command from the AVH device's Connect, referencing the localhost IP.

    lldb --one-line "gdb-remote 127.0.0.1:4000"

That's it! You should notice a significant performance improvement when debugging.

Usage on Windows

  1. Install LLVM for your system type.

  2. Connect to the Virtual Device's VPN. Refer to our VPN article for more details.

  3. Make note of your device's Services IP from the Connect tab. In our example, we use 10.11.1.11.

  4. Download and run the installer for Debug Accelerator for Windows. The executable will be installed under C:\Program Files\Corellium\Debug Accelerator. Windows MSI Installer

  5. Run Debug Accelerator and configure Remote to <services_ip>:4000 and Local to 127.0.0.1:4000. Configure on Windows

  6. The program will continue running in the background. Right-click on the systray icon, click Log..., and look for a line that says Listening on '127.0.0.1:4000'. Click log on Windows

  7. From PowerShell or Windows Command Prompt, modify the lldb command provided for the device through the web interface with your localhost IP and port 4000.

    lldb --one-line "gdb-remote 127.0.0.1:4000"

That's it! You should notice a significant performance improvement when debugging.

Demo

Here's the type of speed you can expect without the Debug Accelerator...

Speed of standard debugging

...and with the Debug Accelerator.

Speed of Debug Accelerator