Skip to main content

Debug Accelerator

The AVH Debug Accelerator reduces the effect of network latency. It improves the debugging speed by upto 10x, and makes the debugging experience more natural.

Use Debug Accelerator 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 Connect to your AVH VPN 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. The command examples all reference lldb but gdb can be used as well.

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

  6. You will notice a significant performance improvement when debugging.

    • Speed when using standard debugging:

      Speed of standard debugging

    • Speed when using Debug Accelerator:

      Speed of Debug Accelerator

Use Debug Accelerator on Windows CLI​

  1. Install LLVM for your system type.

  2. Connect to the Virtual Device's VPN. Refer to Connect to your AVH VPN 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"

  8. You should notice a significant performance improvement when debugging.