aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorbnewbold <bnewbold@robocracy.org>2015-06-13 20:43:06 -0700
committerbnewbold <bnewbold@robocracy.org>2015-06-13 20:43:06 -0700
commit53f79bcf6974f4e3d133faa67b300d5cca493575 (patch)
tree61c07a5f0b873bdc3aadc490b61022ef30687196 /docs
parent0eeaea5de43a5b33f55809eba8dc30211e3535a1 (diff)
downloadlibrambutan-53f79bcf6974f4e3d133faa67b300d5cca493575.tar.gz
librambutan-53f79bcf6974f4e3d133faa67b300d5cca493575.zip
docs: add some linux gcc troubleshooting entries
Diffstat (limited to 'docs')
-rw-r--r--docs/source/troubleshooting.rst26
1 files changed, 26 insertions, 0 deletions
diff --git a/docs/source/troubleshooting.rst b/docs/source/troubleshooting.rst
index 0e9e13d..5ddea4b 100644
--- a/docs/source/troubleshooting.rst
+++ b/docs/source/troubleshooting.rst
@@ -155,6 +155,32 @@ Ubuntu 9.10, this goes a little something like::
$ sudo rmmod cdc-acm
$ sudo insmod /lib/modules/2.6.31-20-generic/kernel/drivers/usb/class/cdc-acm.ko
+[Linux] ``bash: arm-none-eabi-gdb: No such file or directory``
+---------------------------------------------------------------
+
+Assuming the ``gdb`` executable actually exists and is on your ``$PATH``, this
+is usually due to the executable not matching the host computer's instruction
+set: for example, you are on a 64-bit machine trying to run a 32-bit
+executable, and are missing some 32-bit libraries. You might need to do the
+"multiarch" dance if you are on a Debian-based distribution.
+
+For more details see this `Ubuntu Q&A entry
+<http://askubuntu.com/questions/133389/no-such-file-or-directory-but-the-file-exists>`_.
+
+[Linux] ``arm-none-eabi-gdb: error while loading shared libraries``
+-------------------------------------------------------------------
+
+The full text is usually something like::
+
+ arm-none-eabi-gdb: error while loading shared libraries: libncurses.so.5: cannot open shared object file: No such file or directory
+
+You need to install ``libncurses5:i386`` (the 32-bit version of this library),
+because the ``arm-none-eabi-*`` toolchain you are using is compiled for a
+32-bit host (eg, i386) and you are on an 64-bit host (eg, x86_64). The reason
+you didn't run in to this earlier while compiling is that most of the toolchain
+doesn't require ``ncurses`` or other libraries, but ``gdb`` (the debugger)
+does.
+
.. _troubleshooting-tips-tricks:
===============