/hyperpwn

A more friendly debugger UI for GEF or pwndbg

Primary LanguageJavaScriptMIT LicenseMIT

Hyperpwn

Build Status XO code style

Hyperpwn is a Hyper plugin to improve the display when debugging with GDB.

Hyperpwn needs GEF to be loaded in GDB as a backend. Hyperpwn handles with its context data, seperates them to different windows to get a clearer display and can easily replay previous states.

Install

Firstly, you need to install Hyper on your computer.

Hyperpwn relies on hyperinator. You need to install both hyperinator and hyperpwn plugins to use Hyperpwn.

You can install them by command line:

$ hyper i hyperinator
$ hyper i hyperpwn

Or edit ~/.hyper.js manually and add them to plugins:

plugins: [
  "hyperinator", "hyperpwn"
],

Usage

Just run gdb in Hyper terminal.

If GEF is loaded, Hyperpwn will automatically create a config file in ~/.hyperinator, load it and handle with the context data.

You can edit the config file to change the layout and parts to display.

Shortcuts

  • display previous state: ctrl+shift+pageup
  • display next state: ctrl+shift+pagedown

Configuration

Default configuration:

module.exports = {
  config: {
    // other configs...
    hyperpwn: {
      hotkeys: {
        prev: 'ctrl+shift+pageup',
        next: 'ctrl+shift+pagedown'
      },
      showHeaders: true,
      headerStyle: {
        position: 'absolute',
        top: 0,
        right: 0,
        fontSize: '10px'
      }
    }
  }
  //...
};

Notice

  • Make sure you have enabled the display of legend in the backend (which is the default behavior).
  • You can try to change context.nb_lines_code, context.nb_lines_code_prev or other configs in GEF to get a better display.