summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorThomas Petazzoni <thomas.petazzoni@free-electrons.com>2012-07-17 19:42:04 +0200
committerThomas Petazzoni <thomas.petazzoni@free-electrons.com>2012-07-17 19:42:04 +0200
commitc6580011f12e6ca8f7eb87af11d4e9d6def4316f (patch)
tree461613aebda672ca6c04898ef50a5250b0ebb2e3 /docs
parent2e03375d317c369c1f676b090f5bb10efa52ecec (diff)
doc: Add FAQ entries from the old HTML-only documentation
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/manual/faq.txt38
-rw-r--r--docs/manual/manual.txt2
2 files changed, 40 insertions, 0 deletions
diff --git a/docs/manual/faq.txt b/docs/manual/faq.txt
new file mode 100644
index 000000000..575d019e9
--- /dev/null
+++ b/docs/manual/faq.txt
@@ -0,0 +1,38 @@
+Frequently Asked Questions
+==========================
+
+The boot hangs after 'Starting network...'
+------------------------------------------
+
+If the boot process seems to hand after the following messages
+(messages not necessarily exactly similar, depending on the list of
+packages selected):
+
+------------------------
+Freeing init memory: 3972K
+Initializing random number generator... done.
+Starting network...
+Starting dropbear sshd: generating rsa key... generating dsa key... OK
+------------------------
+
+then it means that your system is running, but didn't start a shell on
+the serial console. In order to have the system start a shell on your
+serial console, you have to go in the Buildroot configuration, +System
+configuration+, and modify +Port to run a getty (login prompt) on+ and
++Baudrate to use+ as appropriate. This will automatically tune the
++/etc/inittab+ file of the generated system so that a shell starts on
+the correct serial port.
+
+module-init-tools fails to build with 'cannot find -lc'
+-------------------------------------------------------
+
+If the build of +module-init-tools+ for the host fails with:
+
+------------------------
+/usr/bin/ld: cannot find -lc
+------------------------
+
+then probably you are running a Fedora (or similar) distribution, and
+you should install the +glibc-static+ package. This is because the
++module-init-tools+ build process wants to link statically against the
+C library.
diff --git a/docs/manual/manual.txt b/docs/manual/manual.txt
index 732b50cbc..de4b5949b 100644
--- a/docs/manual/manual.txt
+++ b/docs/manual/manual.txt
@@ -31,4 +31,6 @@ include::download-location.txt[]
include::adding-packages.txt[]
+include::faq.txt[]
+
include::appendix.txt[]