From 24b329b4a1f568f77ce6a44b31cfaab1867b8ff4 Mon Sep 17 00:00:00 2001 From: Jordan Wiens Date: Sat, 29 Oct 2016 12:59:53 -0400 Subject: add KDE notes to troubleshooting --- docs/guide/troubleshooting.md | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) (limited to 'docs/guide') diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md index 68a4d328..4f761cfd 100644 --- a/docs/guide/troubleshooting.md +++ b/docs/guide/troubleshooting.md @@ -12,19 +12,33 @@ - If experiencing problems with Windows UAC permissions during an update, the easiest fix is to completely un-install and re-download the latest installer. Preferences are saved outside the installation folder and are preserved, though you might want to remove your [license](/getting-started/index.html#license). - If you need to change the email address on your license, contact [support]. -## Arch Linux +## Linux -Arch Linux is not an officially supported operating system, but many of our users have run it, and there are a few pitfalls to watch out for. +Given the diversity of Linux distributions, some work-arounds are required to run Binary Ninja on platforms that are not [officially supported][faq]. + +### Arch Linux - Install python2 from the [official repositories][archrepo] - Install the [libcurl-compat] library from AUR, and run Binary Ninja via `LD_PRELOAD=libcurl.so.3 ~/binaryninja/binaryninja` +### KDE + +To run Binary Ninja in a KDE based environment, set the `QT_PLUGIN_PATH` to the `QT` sub-folder: + +``` +cd ~/binaryninja +QT_PLUGIN_PATH=./qt ./binaryninja +``` + + ## API - - If the GUI launches but the license file is not valid, check that you're using the right version of Python. Only a 64-bit Python 2.7 is supported at this time. + - If the GUI launches but the license file is not valid when launched from the command-line, check that you're using the right version of Python. Only a 64-bit Python 2.7 is supported at this time. Additionally, the [personal][purchase] edition does not support headless operation. [known issues]: https://github.com/Vector35/binaryninja-api/issues?q=is%3Aissue [libcurl-compat]: https://aur.archlinux.org/packages/libcurl-compat/ [archrepo]: https://wiki.archlinux.org/index.php/Official_repositories [recover]: https://binary.ninja/recover.html [support]: https://binary.ninja/support.html +[faq]: https://binary.ninja/faq.html +[purchase]: https://binary.ninja/purchase.html -- cgit v1.3.1 From 0d81eb27c3ca11d00b76c942a9160e598a10fefb Mon Sep 17 00:00:00 2001 From: Jordan Wiens Date: Sun, 20 Nov 2016 08:44:25 -0500 Subject: add link to recovery page to license troubleshooting --- docs/guide/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/guide') diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md index 4f761cfd..a74ecb68 100644 --- a/docs/guide/troubleshooting.md +++ b/docs/guide/troubleshooting.md @@ -9,7 +9,7 @@ ## License Problems -- If experiencing problems with Windows UAC permissions during an update, the easiest fix is to completely un-install and re-download the latest installer. Preferences are saved outside the installation folder and are preserved, though you might want to remove your [license](/getting-started/index.html#license). +- 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/index.html#license). - If you need to change the email address on your license, contact [support]. ## Linux -- cgit v1.3.1 From 116b681381d5079f5c4b52a78eeaa53731a05053 Mon Sep 17 00:00:00 2001 From: lucasduffey Date: Wed, 16 Nov 2016 10:31:09 -0800 Subject: Update troubleshooting.md --- docs/guide/troubleshooting.md | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'docs/guide') diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md index a74ecb68..af91f6f1 100644 --- a/docs/guide/troubleshooting.md +++ b/docs/guide/troubleshooting.md @@ -7,6 +7,12 @@ - Did you read all the items on this page? - Then you should contact [support]! +## Bug Reproduction +Running Binary Ninja with debug logging will make your bug report more useful. +``` +./binaryninja --debug --stderr-log +``` + ## License Problems - 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/index.html#license). -- cgit v1.3.1 From 1fa976a5f67879bff72ed440ec6966cd99f04dc1 Mon Sep 17 00:00:00 2001 From: gynophage Date: Wed, 16 Nov 2016 13:36:00 -0500 Subject: Zoom --- docs/guide/interface.md | 2 ++ 1 file changed, 2 insertions(+) (limited to 'docs/guide') diff --git a/docs/guide/interface.md b/docs/guide/interface.md index 460b8df3..74bf141c 100644 --- a/docs/guide/interface.md +++ b/docs/guide/interface.md @@ -2,6 +2,8 @@ ## UI +### Zoom +You can change the zoom of level of the graph view by holding CTRL and scrolling with the mouse. ## Views -- cgit v1.3.1 From 431dad36edd8c55a0c32759c7b939a5d017d5c46 Mon Sep 17 00:00:00 2001 From: Jordan Wiens Date: Fri, 17 Feb 2017 15:25:26 -0500 Subject: update aur link --- docs/guide/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/guide') diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md index af91f6f1..423a325c 100644 --- a/docs/guide/troubleshooting.md +++ b/docs/guide/troubleshooting.md @@ -42,7 +42,7 @@ QT_PLUGIN_PATH=./qt ./binaryninja - If the GUI launches but the license file is not valid when launched from the command-line, check that you're using the right version of Python. Only a 64-bit Python 2.7 is supported at this time. Additionally, the [personal][purchase] edition does not support headless operation. [known issues]: https://github.com/Vector35/binaryninja-api/issues?q=is%3Aissue -[libcurl-compat]: https://aur.archlinux.org/packages/libcurl-compat/ +[libcurl-compat]: https://www.archlinux.org/packages/community/x86_64/libcurl-compat/ [archrepo]: https://wiki.archlinux.org/index.php/Official_repositories [recover]: https://binary.ninja/recover.html [support]: https://binary.ninja/support.html -- cgit v1.3.1 From 27f1271083efb09efc6405f91be893ab38dad9a0 Mon Sep 17 00:00:00 2001 From: Jordan Wiens Date: Fri, 3 Mar 2017 18:10:53 -0500 Subject: add more linux troubleshooting --- docs/guide/troubleshooting.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) (limited to 'docs/guide') diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md index 423a325c..560b0f1f 100644 --- a/docs/guide/troubleshooting.md +++ b/docs/guide/troubleshooting.md @@ -22,10 +22,18 @@ Running Binary Ninja with debug logging will make your bug report more useful. Given the diversity of Linux distributions, some work-arounds are required to run Binary Ninja on platforms that are not [officially supported][faq]. +### Headless Ubuntu + +If you're having trouble getting Binary Ninja installed in a headless server install where you want to be able to X-Forward the GUI on a remote machine, the following should meet requiremetns (for at least 14.04 LTS): + +``` +apt-get install libgl1-mesa-glx libfontconfig1 libxrender1 libegl1-mesa libxi6 libnspr4 libsm6 +``` + ### Arch Linux - - Install python2 from the [official repositories][archrepo] - - Install the [libcurl-compat] library from AUR, and run Binary Ninja via `LD_PRELOAD=libcurl.so.3 ~/binaryninja/binaryninja` + - Install python2 from the [official repositories][archrepo] (`sudo pacman -S python2`) and create a sym link: `sudo ln -s /usr/lib/libpython2.7.so.1.0 /usr/lib/libpython2.7.so.1` + - Install the [libcurl-compat] library with `sudo pacman -S libcurl-compat`, and run Binary Ninja via `LD_PRELOAD=libcurl.so.3 ~/binaryninja/binaryninja` ### KDE -- cgit v1.3.1