Skip to content

decompiler-integration¤

usage: decompiler-integration [-h]
                              {connect,c,disconnect,d,sync,s,jump,j,install,decomp,list,l,setbase}
                              ...

Control Pwndbg decompiler integration.

Alias: di

Positional arguments¤

Positional Argument Help
command

Optional arguments¤

Short Long Help
-h --help show this help message and exit

decompiler-integration connect¤

usage: decompiler-integration connect [-h]

Connect to the decompiler.

The host and port to connect to are governed by the decompiler-host and decompiler-port config variables. Try help set decompiler-host.

Alias: c

Optional arguments¤

Short Long Help
-h --help show this help message and exit

decompiler-integration disconnect¤

usage: decompiler-integration disconnect [-h]

Disconnect from the decompiler.

Alias: d

Optional arguments¤

Short Long Help
-h --help show this help message and exit

decompiler-integration sync¤

usage: decompiler-integration sync [-h]

Sync data from the decompiler.

Check out help set decompiler-auto-sync.

Alias: s

Optional arguments¤

Short Long Help
-h --help show this help message and exit

decompiler-integration jump¤

usage: decompiler-integration jump [-h] [addr]

Make the decompiler's cursor jump to the PC.

Check out help set decompiler-auto-jump.

Alias: j

Positional arguments¤

Positional Argument Help
jump_addr Address to jump to. (default: pc)

Optional arguments¤

Short Long Help
-h --help show this help message and exit

decompiler-integration install¤

usage: decompiler-integration install [-h] which ...

Install/update the decompiler plugins.

You need a decompiler plugin installed to allow the decompiler to communicate back to Pwndbg. The decompiler plugins are from decomp2dbg (<3).

If you already have decomp2dbg installed, this command will overwrite that installation in order to pin the proper version that Pwndbg needs. You will still be able to use decomp2dbg outside of Pwndbg.

You should take care not to invoke source /path/to/decomp2dbg/d2d.py in your ~/.gdbinit because we implement the debugger-side logic independently, and it might conflict.

Positional arguments¤

Positional Argument Help
install_sub

Optional arguments¤

Short Long Help
-h --help show this help message and exit

decompiler-integration install ida¤

usage: decompiler-integration install ida [-h]

Install the IDA decompiler plugin.

Optional arguments¤

Short Long Help
-h --help show this help message and exit

decompiler-integration install binja¤

usage: decompiler-integration install binja [-h]

Install the Binary Ninja decompiler plugin.

Optional arguments¤

Short Long Help
-h --help show this help message and exit

decompiler-integration install ghidra¤

usage: decompiler-integration install ghidra [-h]

Install the Ghidra decompiler plugin.

Optional arguments¤

Short Long Help
-h --help show this help message and exit

decompiler-integration install angr¤

usage: decompiler-integration install angr [-h]

Install the angr-managment decompiler plugin.

Optional arguments¤

Short Long Help
-h --help show this help message and exit

decompiler-integration decomp¤

usage: decompiler-integration decomp [-h]

Just use the decomp command.

Optional arguments¤

Short Long Help
-h --help show this help message and exit

decompiler-integration list¤

usage: decompiler-integration list [-h] [-a]

List the variables for the current stack frame.

Will not be accurate in a function's prologue (before the stack pointer has been adjusted). The "frame" for the purposes of this command is (usually) the location of the saved return address.

Alias: l

Optional arguments¤

Short Long Help
-h --help show this help message and exit
-a --all List decompiler stack variables from all stack frames in this thread.

decompiler-integration setbase¤

usage: decompiler-integration setbase [-h] addr

Manually set the base memory address of the decompiled binary.

Normally, Pwndbg will use the file path that the decompiler reports for the binary and check it against all files mapped into memory to find the correct base address.

If for some reason the file names differ or your binary does not show up in the memory mappings, you can manually set the base address using this command. This is commonly needed when debugging a kernel module.

If you wish to re-enable automatic base address detection, set this value to -1 (or restart Pwndbg).

Positional arguments¤

Positional Argument Help
binary_addr Memory address of the decompiled binary in the address space

Optional arguments¤

Short Long Help
-h --help show this help message and exit