[a9e389d] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?> |
---|
[bd48e48] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" |
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ |
---|
[a9e389d] | 4 | <!ENTITY % general-entities SYSTEM "../../general.ent"> |
---|
| 5 | %general-entities; |
---|
| 6 | ]> |
---|
| 7 | |
---|
| 8 | <sect1 id="ch-cross-tools-uclibc" role="wrap"> |
---|
| 9 | <?dbhtml filename="uclibc.html"?> |
---|
| 10 | |
---|
| 11 | <title>uClibc-&uclibc-version;</title> |
---|
| 12 | |
---|
| 13 | <indexterm zone="ch-cross-tools-uclibc"> |
---|
| 14 | <primary sortas="a-uClibc">uClibc</primary> |
---|
| 15 | <secondary>cross tools</secondary> |
---|
| 16 | </indexterm> |
---|
| 17 | |
---|
| 18 | <sect2 role="package"> |
---|
| 19 | <title/> |
---|
| 20 | |
---|
| 21 | <para>The uClibc package contains the main C library. This library provides |
---|
| 22 | the basic routines for allocating memory, searching directories, opening and |
---|
| 23 | closing files, reading and writing files, string handling, pattern matching, |
---|
| 24 | arithmetic, and so on.</para> |
---|
| 25 | |
---|
| 26 | </sect2> |
---|
| 27 | |
---|
| 28 | <sect2 role="installation"> |
---|
| 29 | <title>Installation of uClibc</title> |
---|
| 30 | |
---|
[0bd108d] | 31 | <para os="c">By default uClibc symlinks the headers to the source directory. |
---|
[e57d05e] | 32 | This is not acceptable in our build scenario, so we modify the Makefiles |
---|
| 33 | so that the headers will be copied instead:</para> |
---|
[0bd108d] | 34 | |
---|
[8550e7a] | 35 | <screen os="d"><userinput>cp Makefile{,.orig} |
---|
[be76242] | 36 | sed -e 's/$(LN) -fs/cp/g' Makefile.orig > Makefile |
---|
[0bd108d] | 37 | for file in `find libc/sysdeps/linux -name Makefile`; do |
---|
[3ca2208] | 38 | cp $file{,.orig} |
---|
| 39 | sed -e 's/$(LN) -fs/cp/g' -e 's@../libc/@$(TOPDIR)libc/@g' \ |
---|
| 40 | $file.orig > $file |
---|
[0bd108d] | 41 | done</userinput></screen> |
---|
| 42 | |
---|
| 43 | <note os="e"> |
---|
[e57d05e] | 44 | <para>Below we are just telling uClibc to use its default configuration. |
---|
| 45 | For those for more adventureous, you can use make menuconfig, and |
---|
| 46 | do a more custom build for your uClibc installation.</para> |
---|
[e2d2a2d] | 47 | </note> |
---|
[a9e389d] | 48 | |
---|
[e57d05e] | 49 | <para os="f">Create the default configuration:</para> |
---|
[a9e389d] | 50 | |
---|
[4884635] | 51 | <screen os="g"><userinput>make defconfig ARCH=i386</userinput></screen> |
---|
[e2d2a2d] | 52 | |
---|
[0bd108d] | 53 | <para os="h">We will need to edit the configuration file, to make sure everything gets |
---|
[e57d05e] | 54 | compiled and put into its proper location:</para> |
---|
[a9e389d] | 55 | |
---|
[8550e7a] | 56 | <screen os="i"><userinput>cp .config{,.orig} |
---|
[a9e389d] | 57 | sed -e "/^CROSS_COMPILER_PREFIX/s:=.*:=\"${CLFS_TARGET}-\":" \ |
---|
[961b7c5] | 58 | -e "/^KERNEL_HEADERS/s:=.*:=\"${CLFS}/usr/include\":" \ |
---|
[a9e389d] | 59 | -e "/^SHARED_LIB_LOADER_PREFIX/s:=.*:=\"/lib\":" \ |
---|
| 60 | -e "/^DEVEL_PREFIX/s:=.*:=\"/usr\":" \ |
---|
| 61 | -e "/^RUNTIME_PREFIX/s:=.*:=\"/\":" \ |
---|
| 62 | .config.orig > .config</userinput></screen> |
---|
| 63 | |
---|
[0bd108d] | 64 | <para os="j">We will need to make sure that some settings in uClibc are set so we |
---|
[e666df1] | 65 | can utilize all the features of BusyBox:</para> |
---|
[a9e389d] | 66 | |
---|
[ffd218b] | 67 | <screen os="k"><userinput>UCLIBC_OPTIONS="DO_C99_MATH UCLIBC_HAS_RPC UCLIBC_HAS_CTYPE_CHECKED |
---|
[3ca2208] | 68 | UCLIBC_HAS_WCHAR UCLIBC_HAS_HEXADECIMAL_FLOATS LDSO_PRELOAD_FILE_SUPPORT |
---|
| 69 | UCLIBC_HAS_FOPEN_EXCLUSIVE_MODE UCLIBC_HAS_PRINTF_M_SPEC UCLIBC_HAS_IPV6 |
---|
| 70 | UCLIBC_HAS_GLIBC_CUSTOM_PRINTF UCLIBC_USE_NETLINK UCLIBC_HAS_FTW" |
---|
[e666df1] | 71 | for config in $UCLIBC_OPTIONS; do |
---|
[3ca2208] | 72 | cp .config{,.orig} |
---|
| 73 | sed -e "s:# ${config} is not set:${config}=y:" .config.orig > .config |
---|
[e666df1] | 74 | done |
---|
[b277e24] | 75 | UCLIBC_OPTIONS="UCLIBC_HAS_CTYPE_UNSAFE" |
---|
| 76 | for config in $UCLIBC_OPTIONS; do |
---|
[3ca2208] | 77 | cp .config{,.orig} |
---|
| 78 | sed -e "s:${config}=y:# ${config} is not set:" .config.orig > .config |
---|
[b277e24] | 79 | done |
---|
[be76242] | 80 | echo "UCLIBC_HAS_FULL_RPC=y" >> .config |
---|
| 81 | echo "UCLIBC_HAS_REENTRANT_RPC=y" >> .config</userinput></screen> |
---|
[a9e389d] | 82 | |
---|
[f23b5ee] | 83 | <para os="l">We have made some changes to our config, let's make sure |
---|
| 84 | that we didn't miss and dependencies:</para> |
---|
[e666df1] | 85 | |
---|
[c06227f] | 86 | <screen os="m"><userinput>make oldconfig</userinput></screen> |
---|
[e666df1] | 87 | |
---|
[f23b5ee] | 88 | <para os="n">Compile the package:</para> |
---|
| 89 | |
---|
[c06227f] | 90 | <screen os="o"><userinput>make CC="${CC} ${BUILD}"</userinput></screen> |
---|
[f23b5ee] | 91 | |
---|
[f540eb0] | 92 | <para os="p">Install the package:</para> |
---|
[a9e389d] | 93 | |
---|
[f540eb0] | 94 | <screen os="q"><userinput>make PREFIX=${CLFS} install</userinput></screen> |
---|
[a9e389d] | 95 | |
---|
| 96 | </sect2> |
---|
| 97 | |
---|
| 98 | <sect2 id="contents-uclibc" role="content"> |
---|
| 99 | <title>Contents of uClibc</title> |
---|
| 100 | |
---|
| 101 | <segmentedlist> |
---|
| 102 | <segtitle>Installed uClibc</segtitle> |
---|
| 103 | |
---|
| 104 | <seglistitem> |
---|
| 105 | <seg>To Be Written</seg> |
---|
| 106 | </seglistitem> |
---|
| 107 | </segmentedlist> |
---|
[6561a0f] | 108 | <!-- |
---|
[a9e389d] | 109 | <variablelist> |
---|
| 110 | <bridgehead renderas="sect3">Short Descriptions</bridgehead> |
---|
| 111 | <?dbfo list-presentation="list"?> |
---|
| 112 | <?dbhtml list-presentation="table"?> |
---|
| 113 | |
---|
[6561a0f] | 114 | <varlistentry id="uclibc"> |
---|
[a9e389d] | 115 | <term><filename |
---|
| 116 | class="headerfile">/usr/include/{asm,linux}/*.h</filename></term> |
---|
| 117 | <listitem> |
---|
| 118 | <para>The Linux API headers</para> |
---|
| 119 | <indexterm zone="ch-system-linux-headers linux-headers"> |
---|
| 120 | <primary |
---|
| 121 | sortas="e-/usr/include/{asm,linux}/*.h">/usr/include/{asm,linux}/*.h</primary> |
---|
| 122 | </indexterm> |
---|
| 123 | </listitem> |
---|
| 124 | </varlistentry> |
---|
| 125 | </variablelist> |
---|
[6561a0f] | 126 | --> |
---|
[a9e389d] | 127 | |
---|
| 128 | </sect2> |
---|
| 129 | </sect1> |
---|