Commit 37f64ed0 authored by Peter Korsgaard's avatar Peter Korsgaard
Browse files

Merge branch 'for-2010.11/faq' of git://git.busybox.net/~tpetazzoni/git/buildroot

parents 13a51114 706683b8
Loading
Loading
Loading
Loading
+44 −0
Original line number Diff line number Diff line
@@ -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>