source: clfs-embedded/BOOK/cross-tools/x86/uclibc.xml @ 128905d

Last change on this file since 128905d was 128905d, checked in by Jim Gifford <clfs@…>, 14 years ago

Fix Validation Errors

  • Property mode set to 100644
File size: 4.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
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
31    <note os="e">
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>
35    </note>
36
37    <para os="f">Create the default configuration:</para>
38
39<screen os="g"><userinput>make defconfig ARCH=i386</userinput></screen>
40
41   <para os="h">We will need to edit the configuration file, to make sure everything gets
42   compiled and put into its proper location:</para>
43
44<screen os="i"><userinput>cp .config{,.orig}
45sed -e "/^CROSS_COMPILER_PREFIX/s:=.*:=\"${CLFS_TARGET}-\":" \
46    -e "/^KERNEL_HEADERS/s:=.*:=\"${CLFS}/usr/include\":" \
47    -e "/^SHARED_LIB_LOADER_PREFIX/s:=.*:=\"/lib\":" \
48    -e "/^DEVEL_PREFIX/s:=.*:=\"/usr\":" \
49    -e "/^RUNTIME_PREFIX/s:=.*:=\"/\":" \
50    .config.orig > .config</userinput></screen>
51
52    <para os="j">We will need to make sure that some settings in uClibc are set so we
53    can utilize all the features of BusyBox:</para>
54
55<screen os="k"><userinput>UCLIBC_OPTIONS="DO_C99_MATH UCLIBC_HAS_RPC UCLIBC_HAS_CTYPE_CHECKED
56    UCLIBC_HAS_WCHAR UCLIBC_HAS_HEXADECIMAL_FLOATS LDSO_PRELOAD_FILE_SUPPORT
57    UCLIBC_HAS_FOPEN_EXCLUSIVE_MODE UCLIBC_HAS_PRINTF_M_SPEC UCLIBC_HAS_IPV6
58    UCLIBC_HAS_GLIBC_CUSTOM_PRINTF UCLIBC_USE_NETLINK UCLIBC_HAS_FTW"
59for config in $UCLIBC_OPTIONS; do
60    cp .config{,.orig}
61    sed -e "s:# ${config} is not set:${config}=y:" .config.orig > .config
62done
63UCLIBC_OPTIONS="UCLIBC_HAS_CTYPE_UNSAFE"
64for config in $UCLIBC_OPTIONS; do
65    cp .config{,.orig}
66    sed -e "s:${config}=y:# ${config} is not set:" .config.orig > .config
67done
68echo "UCLIBC_HAS_FULL_RPC=y" &gt;&gt; .config
69echo "UCLIBC_HAS_REENTRANT_RPC=y" &gt;&gt; .config</userinput></screen>
70
71    <para os="l">We have made some changes to our config, let's make sure
72    that we didn't miss and dependencies:</para>
73
74<screen os="m"><userinput>make oldconfig</userinput></screen>
75
76    <para os="n">Compile the package:</para>
77
78<screen os="o"><userinput>make CC="${CLFS_TARGET}-gcc ${BUILD}"</userinput></screen>
79
80    <para os="p">Install the package:</para>
81
82<screen os="q"><userinput>make PREFIX=${CLFS} install</userinput></screen>
83
84  </sect2>
85
86  <sect2 id="contents-uclibc" role="content">
87    <title>Contents of uClibc</title>
88
89    <segmentedlist>
90      <segtitle>Installed uClibc</segtitle>
91
92      <seglistitem>
93        <seg>To Be Written</seg>
94      </seglistitem>
95    </segmentedlist>
96<!--
97    <variablelist>
98      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
99      <?dbfo list-presentation="list"?>
100      <?dbhtml list-presentation="table"?>
101
102     <varlistentry id="uclibc">
103        <term><filename
104        class="headerfile">/usr/include/{asm,linux}/*.h</filename></term>
105        <listitem>
106          <para>The Linux API headers</para>
107          <indexterm zone="ch-system-linux-headers linux-headers">
108            <primary
109            sortas="e-/usr/include/{asm,linux}/*.h">/usr/include/{asm,linux}/*.h</primary>
110          </indexterm>
111        </listitem>
112      </varlistentry>
113    </variablelist>
114-->
115
116  </sect2>
117</sect1>
Note: See TracBrowser for help on using the repository browser.