From 77e09a2d02efbb2d6aa9758b503e37cbe7655f7f Mon Sep 17 00:00:00 2001 From: Jordan Wiens Date: Wed, 25 Oct 2017 11:57:40 -0400 Subject: additional debian sym link instructions --- docs/guide/troubleshooting.md | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'docs') diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md index a640d47e..c1b3a910 100644 --- a/docs/guide/troubleshooting.md +++ b/docs/guide/troubleshooting.md @@ -72,6 +72,14 @@ $ ln -s libssl.so libssl.so.1.0.0 $ ln -s libcrypto.so libcrypto.so.1.0.0 ``` +Alternatively, you might need to (as root): + +``` +apt-get install libssl-dev +ln -s /usr/lib/x86_64-linux-gnu/libcrypto.so.1.0.2 /usr/lib/x86_64-linux-gnu/libcrypto.so.1.0.0 +ln -s /usr/lib/x86_64-linux-gnu/libssl.so.1.0.2 /usr/lib/x86_64-linux-gnu/libssl.so.1.0.0 +``` + ### Gentoo One Gentoo user [reported][issue672] a failed SSL certificate when trying to update. The solution was to copy over `/etc/ssl/certs/ca-certificates.crt` from another Linux distribution. -- cgit v1.3.1 From a774e47ee36a5d4418c9aec13e5612f158a825d3 Mon Sep 17 00:00:00 2001 From: Jordan Wiens Date: Mon, 30 Oct 2017 21:21:48 -0400 Subject: add current_llil and current_mlil scripting console aliases --- docs/getting-started.md | 2 ++ python/scriptingprovider.py | 2 ++ 2 files changed, 4 insertions(+) (limited to 'docs') diff --git a/docs/getting-started.md b/docs/getting-started.md index 692c1e67..39809747 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -210,6 +210,8 @@ By default the interactive python prompt has a number of convenient helper funct - `bv` / `current_view` / : the current [BinaryView](https://api.binary.ninja/binaryninja.BinaryView.html) - `current_function`: the current [Function](https://api.binary.ninja/binaryninja.Function.html) - `current_basic_block`: the current [BasicBlock](https://api.binary.ninja/binaryninja.BasicBlock.html) +- `current_llil`: the current [LowLevelILBasicBlock](https://api.binary.ninja/binaryninja.lowlevelil.LowLevelILBasicBlock.html) +- `current_mlil`: the current [MediumLevelILBasicBlock](https://api.binary.ninja/binaryninja.mediumlevelil.MediumLevelILBasicBlock.html) - `current_selection`: a tuple of the start and end addresses of the current selection - `write_at_cursor(data)`: function that writes data to the start of the current selection - `get_selected_data()`: function that returns the data in the current selection diff --git a/python/scriptingprovider.py b/python/scriptingprovider.py index ed9688b9..211d2fb7 100644 --- a/python/scriptingprovider.py +++ b/python/scriptingprovider.py @@ -540,6 +540,8 @@ class PythonScriptingInstance(ScriptingInstance): self.locals["current_address"] = self.active_addr self.locals["here"] = self.active_addr self.locals["current_selection"] = (self.active_selection_begin, self.active_selection_end) + self.locals["current_llil"] = self.active_func.low_level_il + self.locals["current_mlil"] = self.active_func.medium_level_il self.interpreter.runsource(code) -- cgit v1.3.1 From 1476607ebb677b4c7316957505c9aa95c7d08788 Mon Sep 17 00:00:00 2001 From: Jordan Wiens Date: Fri, 3 Nov 2017 15:51:47 -0400 Subject: fix docs for plugin manager example --- docs/guide/plugins.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs') diff --git a/docs/guide/plugins.md b/docs/guide/plugins.md index 9c67d44f..442d6fe4 100644 --- a/docs/guide/plugins.md +++ b/docs/guide/plugins.md @@ -36,9 +36,9 @@ Binary Ninja now offers a [PluginManager API] which can simplify the process of ['__class__', '__delattr__', '__dict__', '__doc__', '__format__', '__getattribute__', '__hash__', '__init__', '__module__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__', 'add_repository', 'check_for_updates', 'default_repository', 'disable_plugin', 'enable_plugin', 'handle', 'install_plugin', 'plugins', 'repositories', 'uninstall_plugin', 'update_plugin'] >>> mgr.plugins {'default': [, , , , , , , , , , , ]} ->>> mgr.install_plugin(easypatch) +>>> mgr.install_plugin("easypatch") True ->>> mgr.enable(easypatch) +>>> mgr.enable_plugin("easypatch") True ``` -- cgit v1.3.1 From 3764c6efde43547a112e637c1bb80ec5dbf1919c Mon Sep 17 00:00:00 2001 From: Jordan Wiens Date: Tue, 21 Nov 2017 14:30:40 -0500 Subject: @GeneralBisons suggested fix until libcurl/libssl are included --- docs/guide/troubleshooting.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md index c1b3a910..593e50b4 100644 --- a/docs/guide/troubleshooting.md +++ b/docs/guide/troubleshooting.md @@ -67,9 +67,9 @@ QT_PLUGIN_PATH=./qt ./binaryninja For Debian variants that (Kali, eg) don't match packages with Ubuntu LTS or the latest stable, the following might fix problems with libssl and libcrypto: ``` -$ cd binaryninja/plugins -$ ln -s libssl.so libssl.so.1.0.0 -$ ln -s libcrypto.so libcrypto.so.1.0.0 +$ cd binaryninja +$ ln -s plugins/libssl.so libssl.so.1.0.0 +$ ln -s plugins/libcrypto.so libcrypto.so.1.0.0 ``` Alternatively, you might need to (as root): -- cgit v1.3.1 From 7dee9c4f68147bd88d1c60577912c3a91c510331 Mon Sep 17 00:00:00 2001 From: Jordan Wiens Date: Wed, 29 Nov 2017 10:55:05 -0500 Subject: update OS X troubleshooting docs for old unsupported versions --- docs/guide/troubleshooting.md | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'docs') diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md index 593e50b4..5e310dfb 100644 --- a/docs/guide/troubleshooting.md +++ b/docs/guide/troubleshooting.md @@ -36,6 +36,16 @@ Next, if running a python plugin, make sure the python requirements are met by y - If experiencing problems with Windows UAC permissions during an update, the easiest fix is to completely un-install and [recover][recover] the latest installer and license. Preferences are saved outside the installation folder and are preserved, though you might want to remove your [license](/getting-started/#license). - If you need to change the email address on your license, contact [support]. +## OS X + +While OS X is generally the most trouble-free environment for Binary Ninja, very old versions may have problems with the RPATH for our binaries and libraries. There are two solutions. First, run Binary Ninja with: + +``` +DYLD_LIBRARY_PATH="/Applications/Binary Ninja.app/Contents/MacOS" /Applications/Binary\ Ninja.app/Contents/MacOS/binaryninja +``` + +Or second, modify the binary itself using the [install_name_tool](https://blogs.oracle.com/dipol/dynamic-libraries,-rpath,-and-mac-os). + ## Linux Given the diversity of Linux distributions, some work-arounds are required to run Binary Ninja on platforms that are not [officially supported][faq]. -- cgit v1.3.1 From 89a1e8d47efbf85055b5053823d77d67c54e074e Mon Sep 17 00:00:00 2001 From: Peter LaFosse Date: Fri, 15 Dec 2017 16:12:34 -0500 Subject: Adding documentation for linux CA path settings --- docs/getting-started.md | 2 ++ 1 file changed, 2 insertions(+) (limited to 'docs') diff --git a/docs/getting-started.md b/docs/getting-started.md index 39809747..88945f7b 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -255,6 +255,8 @@ Settings are stored in the _user_ directory in the file `settings.json`. Each to |Plugin | Setting | Type | Default | Description | |------:|-------------------------:|-------------:|-----------------------------------------------:|:----------------------------------------------------------------------------------------------| +| core | linux\_ca\_bundle | string | "" | Certificate authority (.pem or .crt) file to be used for secure downloads | +| core | linux\_ca\_dir | string | "" | Certificate authority directory (for distributions without a CA bundle) | | ui | activeContent | boolean | True | Allow Binary Ninja to connect to the web to check for updates | | ui | colorblind | boolean | True | Choose colors that are visible to those with red/green colorblind | | ui | debug | boolean | False | Enable developer debugging features (Additional views: Lifted IL, and SSA forms) | -- cgit v1.3.1