source: clfs-embedded/BOOK/cross-tools/mips/uclibc.xml @ 99fc891

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
]>

<sect1 id="ch-cross-tools-uclibc" role="wrap">
  <?dbhtml filename="uclibc.html"?>

  <title>uClibc-&uclibc-version;</title>

  <indexterm zone="ch-cross-tools-uclibc">
    <primary sortas="a-uClibc">uClibc</primary>
    <secondary>cross tools</secondary>
  </indexterm>

  <sect2 role="package">
    <title/>

    <para>The uClibc package contains the main C library. This library provides
    the basic routines for allocating memory, searching directories, opening and
    closing files, reading and writing files, string handling, pattern matching,
    arithmetic, and so on.</para>

    <para>THIS IS JUST A PLACEHOLDER, YOU *WILL* NEED TO DO 'make menuconfig' SELECT MIPS ARCHITECTURE AND THE SPECIFIC MIPS YOU ARE USING!</para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of uClibc</title>

    <para os="a">Since we are cross-compiling, we need to make sure when we
    configuration for our architecture we get the correct information. The
    following sed makes sure we are using the proper settings for our
    architecture: (This is a place holder for the other architectures). Make sure you select the MIPS architecture and the correct processor/endianness.</para>

<screen os="b"><userinput>make menuconfig</userinput></screen>

    <note os="c">
      <para>Below we are just telling uClibc to use the default configuration of
      uClibc. For those for more adventureous, you can use make menuconfig, and
      do a more custom build of your uClibc.</para>
    </note>

    <para os="d">Create default configuration:</para>

<screen os="e"><userinput>make defconfig</userinput></screen>

   <para os="f">We will need to edit the configuration file, to make sure everything gets
   compiled and put into it's proper locations:</para>

<screen os="g"><userinput>cp .config .config.orig
sed -e "/^CROSS_COMPILER_PREFIX/s:=.*:=\"${CLFS_TARGET}-\":" \
    -e "/^KERNEL_SOURCE/s:=.*:=\"${CLFS}/usr\":" \
    -e "/^SHARED_LIB_LOADER_PREFIX/s:=.*:=\"/lib\":" \
    -e "/^DEVEL_PREFIX/s:=.*:=\"/usr\":" \
    -e "/^RUNTIME_PREFIX/s:=.*:=\"/\":" \
    .config.orig > .config</userinput></screen>

    <para os="h">We will need to make sure that some settings in uClibc are set so we
    can utilize all the features of BusyBox:</para>

<screen os="i"><userinput>UCLIBC_OPTIONS="DO_C99_MATH UCLIBC_HAS_RPC UCLIBC_HAS_CTYPE_CHECKED UCLIBC_HAS_WCHAR UCLIBC_HAS_HEXADECIMAL_FLOATS
                UCLIBC_HAS_FOPEN_EXCLUSIVE_MODE UCLIBC_HAS_PRINTF_M_SPEC UCLIBC_HAS_FTW UCLIBC_HAS_IPV6"
for config in $UCLIBC_OPTIONS; do
        cp .config .config.orig
        sed -e "s:# ${config} is not set:${config}=y:" .config.orig > .config
done
echo "UCLIBC_HAS_FULL_RPC=y" >> .config</userinput></screen>

    <para os="j">Compile the package:</para>

<screen os="k"><userinput>make</userinput></screen>

   <para os="l">We will remove the files that were copied over from our Linux Headers during
   the building of uClibc. These files were copied into the include directory of the source
   directory of uClibc:</para>

<screen os="m"><userinput>rm include/{asm,asm-generic,linux}</userinput></screen>

    <para os="n">Install the package:</para>

<screen os="o"><userinput>make PREFIX=${CLFS} install</userinput></screen>

  </sect2>

  <sect2 id="contents-uclibc" role="content">
    <title>Contents of uClibc</title>

    <segmentedlist>
      <segtitle>Installed uClibc</segtitle>

      <seglistitem>
        <seg>To Be Written</seg>
      </seglistitem>
    </segmentedlist>
<!--
    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

     <varlistentry id="uclibc">
        <term><filename
        class="headerfile">/usr/include/{asm,linux}/*.h</filename></term>
        <listitem>
          <para>The Linux API headers</para>
          <indexterm zone="ch-system-linux-headers linux-headers">
            <primary
            sortas="e-/usr/include/{asm,linux}/*.h">/usr/include/{asm,linux}/*.h</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    </variablelist>
-->

  </sect2>
</sect1>