summaryrefslogtreecommitdiff
path: root/docs/buildroot.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/buildroot.html')
-rw-r--r--docs/buildroot.html44
1 files changed, 44 insertions, 0 deletions
diff --git a/docs/buildroot.html b/docs/buildroot.html
index 144461298..f471962ad 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,49 @@ 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>
+ <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
+ 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>
+
+ <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>