summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorPeter LaFosse <peter@vector35.com>2018-01-09 16:47:47 -0500
committerPeter LaFosse <peter@vector35.com>2018-01-09 16:47:47 -0500
commit6ef9dd016c957e796f89f94f00c6d71e2f7589e8 (patch)
tree5ab4ab48cf8f47c4e5325f3b3ae4cf9e5e8d5194 /docs
parent16a4d413d58d2cb29be97781bba0b52546afa390 (diff)
parent26edabfdd7211012c7c8a03186d3025eea9aa345 (diff)
Merge branch 'dev'
Diffstat (limited to 'docs')
-rw-r--r--docs/getting-started.md2
-rw-r--r--docs/guide/troubleshooting.md16
2 files changed, 15 insertions, 3 deletions
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) |
diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md
index c1b3a910..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].
@@ -67,9 +77,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):