[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 | <note os="e"> |
---|
[e57d05e] | 32 | <para>Below we are just telling uClibc to use its default configuration. |
---|
| 33 | For those for more adventureous, you can use make menuconfig, and |
---|
| 34 | do a more custom build for your uClibc installation.</para> |
---|
[e2d2a2d] | 35 | </note> |
---|
[a9e389d] | 36 | |
---|
[2567553] | 37 | <para os="p1">The following patch creates a condition in a header so that |
---|
| 38 | the struct flock will not be redefined:</para> |
---|
| 39 | |
---|
| 40 | <screen os="p2"><userinput>patch -Np1 -i ../&uclibc-flock_fixes-patch;</userinput></screen> |
---|
| 41 | |
---|
[e57d05e] | 42 | <para os="f">Create the default configuration:</para> |
---|
[a9e389d] | 43 | |
---|
[4884635] | 44 | <screen os="g"><userinput>make defconfig ARCH=i386</userinput></screen> |
---|
[e2d2a2d] | 45 | |
---|
[0bd108d] | 46 | <para os="h">We will need to edit the configuration file, to make sure everything gets |
---|
[e57d05e] | 47 | compiled and put into its proper location:</para> |
---|
[a9e389d] | 48 | |
---|
[8550e7a] | 49 | <screen os="i"><userinput>cp .config{,.orig} |
---|
[a9e389d] | 50 | sed -e "/^CROSS_COMPILER_PREFIX/s:=.*:=\"${CLFS_TARGET}-\":" \ |
---|
[961b7c5] | 51 | -e "/^KERNEL_HEADERS/s:=.*:=\"${CLFS}/usr/include\":" \ |
---|
[a9e389d] | 52 | -e "/^SHARED_LIB_LOADER_PREFIX/s:=.*:=\"/lib\":" \ |
---|
| 53 | -e "/^DEVEL_PREFIX/s:=.*:=\"/usr\":" \ |
---|
| 54 | -e "/^RUNTIME_PREFIX/s:=.*:=\"/\":" \ |
---|
| 55 | .config.orig > .config</userinput></screen> |
---|
| 56 | |
---|
[0bd108d] | 57 | <para os="j">We will need to make sure that some settings in uClibc are set so we |
---|
[e666df1] | 58 | can utilize all the features of BusyBox:</para> |
---|
[a9e389d] | 59 | |
---|
[ffd218b] | 60 | <screen os="k"><userinput>UCLIBC_OPTIONS="DO_C99_MATH UCLIBC_HAS_RPC UCLIBC_HAS_CTYPE_CHECKED |
---|
[3ca2208] | 61 | UCLIBC_HAS_WCHAR UCLIBC_HAS_HEXADECIMAL_FLOATS LDSO_PRELOAD_FILE_SUPPORT |
---|
| 62 | UCLIBC_HAS_FOPEN_EXCLUSIVE_MODE UCLIBC_HAS_PRINTF_M_SPEC UCLIBC_HAS_IPV6 |
---|
| 63 | UCLIBC_HAS_GLIBC_CUSTOM_PRINTF UCLIBC_USE_NETLINK UCLIBC_HAS_FTW" |
---|
[e666df1] | 64 | for config in $UCLIBC_OPTIONS; do |
---|
[3ca2208] | 65 | cp .config{,.orig} |
---|
| 66 | sed -e "s:# ${config} is not set:${config}=y:" .config.orig > .config |
---|
[e666df1] | 67 | done |
---|
[b277e24] | 68 | UCLIBC_OPTIONS="UCLIBC_HAS_CTYPE_UNSAFE" |
---|
| 69 | for config in $UCLIBC_OPTIONS; do |
---|
[3ca2208] | 70 | cp .config{,.orig} |
---|
| 71 | sed -e "s:${config}=y:# ${config} is not set:" .config.orig > .config |
---|
[b277e24] | 72 | done |
---|
[be76242] | 73 | echo "UCLIBC_HAS_FULL_RPC=y" >> .config |
---|
| 74 | echo "UCLIBC_HAS_REENTRANT_RPC=y" >> .config</userinput></screen> |
---|
[a9e389d] | 75 | |
---|
[f23b5ee] | 76 | <para os="l">We have made some changes to our config, let's make sure |
---|
| 77 | that we didn't miss and dependencies:</para> |
---|
[e666df1] | 78 | |
---|
[c06227f] | 79 | <screen os="m"><userinput>make oldconfig</userinput></screen> |
---|
[e666df1] | 80 | |
---|
[f23b5ee] | 81 | <para os="n">Compile the package:</para> |
---|
| 82 | |
---|
[c06227f] | 83 | <screen os="o"><userinput>make CC="${CC} ${BUILD}"</userinput></screen> |
---|
[f23b5ee] | 84 | |
---|
[f540eb0] | 85 | <para os="p">Install the package:</para> |
---|
[a9e389d] | 86 | |
---|
[f540eb0] | 87 | <screen os="q"><userinput>make PREFIX=${CLFS} install</userinput></screen> |
---|
[a9e389d] | 88 | |
---|
| 89 | </sect2> |
---|
| 90 | |
---|
| 91 | <sect2 id="contents-uclibc" role="content"> |
---|
| 92 | <title>Contents of uClibc</title> |
---|
| 93 | |
---|
| 94 | <segmentedlist> |
---|
| 95 | <segtitle>Installed uClibc</segtitle> |
---|
| 96 | |
---|
| 97 | <seglistitem> |
---|
| 98 | <seg>To Be Written</seg> |
---|
| 99 | </seglistitem> |
---|
| 100 | </segmentedlist> |
---|
[6561a0f] | 101 | <!-- |
---|
[a9e389d] | 102 | <variablelist> |
---|
| 103 | <bridgehead renderas="sect3">Short Descriptions</bridgehead> |
---|
| 104 | <?dbfo list-presentation="list"?> |
---|
| 105 | <?dbhtml list-presentation="table"?> |
---|
| 106 | |
---|
[6561a0f] | 107 | <varlistentry id="uclibc"> |
---|
[a9e389d] | 108 | <term><filename |
---|
| 109 | class="headerfile">/usr/include/{asm,linux}/*.h</filename></term> |
---|
| 110 | <listitem> |
---|
| 111 | <para>The Linux API headers</para> |
---|
| 112 | <indexterm zone="ch-system-linux-headers linux-headers"> |
---|
| 113 | <primary |
---|
| 114 | sortas="e-/usr/include/{asm,linux}/*.h">/usr/include/{asm,linux}/*.h</primary> |
---|
| 115 | </indexterm> |
---|
| 116 | </listitem> |
---|
| 117 | </varlistentry> |
---|
| 118 | </variablelist> |
---|
[6561a0f] | 119 | --> |
---|
[a9e389d] | 120 | |
---|
| 121 | </sect2> |
---|
| 122 | </sect1> |
---|