From 42ddff55d4ab08defc25d8f59a1d41d536ae5fad Mon Sep 17 00:00:00 2001
From: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Date: Fri, 26 Nov 2010 09:59:21 +0100
Subject: documentation: introduce a FAQ section

Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
---
 docs/buildroot.html | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/buildroot.html b/docs/buildroot.html
index 144461298..d9df668d3 100644
--- a/docs/buildroot.html
+++ b/docs/buildroot.html
@@ -32,6 +32,7 @@
       <li><a href="#downloaded_packages">Location of downloaded packages</a></li>
       <li><a href="#add_packages">Adding new packages to Buildroot</a></li>
       <li><a href="#board_support">Creating your own board support</a></li>
+      <li><a href="#faq">Frequently asked questions</a></li>
       <li><a href="#links">Resources</a></li>
     </ul>
 
@@ -1593,6 +1594,11 @@ LIBFOO_POST_PATCH_HOOKS += LIBFOO_POST_PATCH_FIXUP
     <p>If you package software that might be useful for other people, don't
     forget to send a patch to Buildroot developers!</p>
 
+    <h2 id="faq">Frequently asked questions</h2>
+
+    <ul>
+    </ul>
+
     <h2 id="links">Resources</h2>
 
     <p>To learn more about Buildroot you can visit these websites:</p>
-- 
cgit v1.2.3


From 5a51a370f0327936b597f106c82d47af5cfbe76a Mon Sep 17 00:00:00 2001
From: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Date: Fri, 26 Nov 2010 10:03:55 +0100
Subject: documentation: add FAQ entry concerning serial port configuration

Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
---
 docs/buildroot.html | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/buildroot.html b/docs/buildroot.html
index d9df668d3..bb02f17c5 100644
--- a/docs/buildroot.html
+++ b/docs/buildroot.html
@@ -1597,8 +1597,31 @@ LIBFOO_POST_PATCH_HOOKS += LIBFOO_POST_PATCH_FIXUP
     <h2 id="faq">Frequently asked questions</h2>
 
     <ul>
+      <li><a href="#faq-boot-hangs">The boot hangs
+      after <code>Starting network...</code></a></li>
     </ul>
 
+    <h3 id="faq-boot-hangs">The boot hangs after <code>Starting
+    network...</code></h3>
+
+    <p>If the boot process seems to hang after the following messages
+    (messages not necessarly exactly similar, depending on the list of
+    packages selected):</p>
+
+    <pre>Freeing init memory: 3972K
+Initializing random number generator... done.
+Starting network...
+Starting dropbear sshd: generating rsa key... generating dsa key... OK</pre>
+
+    <p>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, <code>Target options</code>, enable <code>Generic
+    serial port config</code>, and select the serial port and speed
+    you would like to use for the shell. This will automatically tune
+    the <code>/etc/inittab</code> file of the generated system so that
+    a shell starts on the correct serial port.</p>
+
     <h2 id="links">Resources</h2>
 
     <p>To learn more about Buildroot you can visit these websites:</p>
-- 
cgit v1.2.3


From 706683b8b912aa3304d71652d7a4a74d8b74f58e Mon Sep 17 00:00:00 2001
From: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Date: Fri, 26 Nov 2010 10:06:58 +0100
Subject: documentation: add FAQ entry about glibc-static issue on Fedora

Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
---
 docs/buildroot.html | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/buildroot.html b/docs/buildroot.html
index bb02f17c5..f471962ad 100644
--- a/docs/buildroot.html
+++ b/docs/buildroot.html
@@ -1599,6 +1599,8 @@ LIBFOO_POST_PATCH_HOOKS += LIBFOO_POST_PATCH_FIXUP
     <ul>
       <li><a href="#faq-boot-hangs">The boot hangs
       after <code>Starting network...</code></a></li>
+      <li><a href="#module-init-tools-doesnt-build">module-init-tools
+      fails to build with <code>cannot find -lc</code></a></li>
     </ul>
 
     <h3 id="faq-boot-hangs">The boot hangs after <code>Starting
@@ -1622,6 +1624,19 @@ Starting dropbear sshd: generating rsa key... generating dsa key... OK</pre>
     the <code>/etc/inittab</code> file of the generated system so that
     a shell starts on the correct serial port.</p>
 
+    <h3 id="module-init-tools-doesnt-build">module-init-tools
+      fails to build with <code>cannot find -lc</code></h3>
+
+    <p>If the build of <i>module-init-tools</i> for the host fails
+    with:</p>
+
+    <pre>/usr/bin/ld: cannot find -lc </pre>
+
+    <p>then probably you are running a Fedora (or similar)
+    distribution, and you should install the <code>glibc-static</code>
+    package. This is because the <i>module-init-tools</i> build
+    process wants to link statically against the C library.</p>
+
     <h2 id="links">Resources</h2>
 
     <p>To learn more about Buildroot you can visit these websites:</p>
-- 
cgit v1.2.3