diff options
authorThomas Petazzoni <>2012-07-17 17:42:04 (GMT)
committerThomas Petazzoni <>2012-07-17 17:42:04 (GMT)
commitc6580011f12e6ca8f7eb87af11d4e9d6def4316f (patch)
parent2e03375d317c369c1f676b090f5bb10efa52ecec (diff)
doc: Add FAQ entries from the old HTML-only documentation
Signed-off-by: Thomas Petazzoni <>
2 files changed, 40 insertions, 0 deletions
diff --git a/docs/manual/faq.txt b/docs/manual/faq.txt
new file mode 100644
index 0000000..575d019
--- /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 732b50c..de4b594 100644
--- a/docs/manual/manual.txt
+++ b/docs/manual/manual.txt
@@ -31,4 +31,6 @@ include::download-location.txt[]