Skip to content
This repository has been archived by the owner on Jun 24, 2023. It is now read-only.

Commit

Permalink
Updated documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
hugsy committed May 18, 2020
1 parent 431f0ff commit 0885ec3
Show file tree
Hide file tree
Showing 2 changed files with 43 additions and 31 deletions.
33 changes: 25 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Author: **@hugsy**

Interface [GDB-GEF](https://github.com/hugsy/gef) with [Binary Ninja](https://binary.ninja)
Interface easily [GDB-GEF](https://github.com/hugsy/gef) with [Binary Ninja](https://binary.ninja)



Expand All @@ -17,42 +17,59 @@ It will spawn a threaded XMLRPC server from your current BN session making it po
[![](https://i.imgur.com/xvoUACt.png)](https://www.youtube.com/watch?v=QJKmcZumWyA)


### Installation

### GUI installation
#### GUI installation

(soon available directly from the Plugin Manager)
In Binary Ninja, press `Ctrl-Shift-M` to open the Plugin Manager. Then search for `GEF-Binja` and install it.


### Manual installation
#### Manual installation

#### Linux
##### Linux

```bash
$ git clone https://github.com/hugsy/gef-binja/ "~/.binaryninja/plugins/gef-binja"
```

#### Windows
##### Windows

```powershell
PS :\> git clone https://github.com/hugsy/gef-binja "$Env:APPDATA\Binary Ninja\plugins\gef-binja"
```


#### Darwin
##### Darwin

Untested but should work

```bash
$ git clone https://github.com/hugsy/gef-binja/ "~/Library/Application Support/Binary Ninja/plugins/gef-binja"
```

#### GEF Installation

If you don't have [`gef`](https://github.com/hugsy/gef) on the host where your GDB is running, the quickest way to install it is by running the following command from a shell prompt:


```bash
wget -q -O- https://github.com/hugsy/gef/raw/master/scripts/gef.sh | sh
```

In GDB, configure `gef` to connect to Binary Ninja:

```
gef➤ gef config ida-interact
```

*Note*: the config option is called `ida-interact` because GEF uses the same protocol for both communication with Binja and IDA.


## Minimum Version

This plugin requires the following minimum version of Binary Ninja:

* 1200
* 1300



Expand Down
41 changes: 18 additions & 23 deletions plugin.json
Original file line number Diff line number Diff line change
@@ -1,25 +1,20 @@
{
"pluginmetadataversion" : 2,
"name": "GEF-Binja",
"type": ["ui", "helper"],
"api": ["python3"],
"description": "Interface Binary Ninja with GDB-GEF easily.",
"longdescription": "gef-binja: This script is the server-side of the XML-RPC defined for gef for BinaryNinja. It will spawn a threaded XMLRPC server from your current BN session making it possible for gef to interact with Binary Ninja.",
"license": {
"name": "MIT",
"text": "Copyright (c) 2013-2020 crazy rabbidz\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE."
},
"platforms" : ["Darwin", "Linux", "Windows"],
"installinstructions" : {
"Linux" : "",
"Windows" : "",
"Darwin" : "should work, but untested"
},
"dependencies": {
"apt": ["gdb-multiarch"],
"other": ["This plugin will interact with a [GEF instance](https://github.com/hugsy/gef)."]
},
"version": "0.2",
"author": "hugsy",
"minimumbinaryninjaversion": 1200
"pluginmetadataversion" : 2,
"name": "GEF-Binja",
"type": ["ui", "helper"],
"api": ["python3"],
"description": "Interface Binary Ninja with GDB-GEF easily.",
"longdescription": "gef-binja: This script is the server-side of the XML-RPC defined for gef for BinaryNinja. It will spawn a threaded XMLRPC server from your current BN session making it possible for gef to interact with Binary Ninja.",
"license": {
"name": "MIT",
"text": "Copyright (c) 2013-2020 crazy rabbidz\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE."
},
"platforms" : ["Darwin", "Linux", "Windows"],
"dependencies": {
"apt": ["gdb-multiarch"],
"other": ["This plugin will interact with a [GEF instance](https://github.com/hugsy/gef)."]
},
"version": "0.2",
"author": "hugsy",
"minimumbinaryninjaversion": 1300
}

0 comments on commit 0885ec3

Please sign in to comment.