source: clfs-embedded/BOOK/cross-tools/x86/uclibc.xml@ 419755e

Last change on this file since 419755e was 8520e58, checked in by Jim Gifford <clfs@…>, 18 years ago

Text Updates for CLFS Embedded

  • Property mode set to 100644
File size: 4.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/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 <para os="c">By default uClibc symlinks the headers to the source directory.
32 This is not acceptable in our build scenario, so we modify the Makefiles
33 so that the headers will be copied instead:</para>
34
35<screen os="d"><userinput>cp Makefile Makefile.orig
36sed -e 's/$(LN) -fs/cp/g' Makefile.orig > Makefile
37for file in `find libc/sysdeps/linux -name Makefile`; do
38 cp $file $file.orig
39 sed -e 's/$(LN) -fs/cp/g' -e 's@../libc/@$(TOPDIR)libc/@g' $file.orig > $file
40done</userinput></screen>
41
42 <note os="e">
43 <para>Below we are just telling uClibc to use its default configuration.
44 For those for more adventureous, you can use make menuconfig, and
45 do a more custom build for your uClibc installation.</para>
46 </note>
47
48 <para os="f">Create the default configuration:</para>
49
50<screen os="g"><userinput>make defconfig</userinput></screen>
51
52 <para os="h">We will need to edit the configuration file, to make sure everything gets
53 compiled and put into its proper location:</para>
54
55<screen os="i"><userinput>cp .config .config.orig
56sed -e "/^CROSS_COMPILER_PREFIX/s:=.*:=\"${CLFS_TARGET}-\":" \
57 -e "/^KERNEL_SOURCE/s:=.*:=\"${CLFS}/usr\":" \
58 -e "/^SHARED_LIB_LOADER_PREFIX/s:=.*:=\"/lib\":" \
59 -e "/^DEVEL_PREFIX/s:=.*:=\"/usr\":" \
60 -e "/^RUNTIME_PREFIX/s:=.*:=\"/\":" \
61 .config.orig > .config</userinput></screen>
62
63 <para os="j">We will need to make sure that some settings in uClibc are set so we
64 can utilize all the features of BusyBox:</para>
65
66<screen os="k"><userinput>UCLIBC_OPTIONS="DO_C99_MATH UCLIBC_HAS_RPC UCLIBC_HAS_CTYPE_CHECKED
67 UCLIBC_HAS_WCHAR UCLIBC_HAS_HEXADECIMAL_FLOATS UCLIBC_HAS_FOPEN_EXCLUSIVE_MODE
68 UCLIBC_HAS_PRINTF_M_SPEC UCLIBC_HAS_FTW UCLIBC_HAS_IPV6 UCLIBC_HAS_GLIBC_CUSTOM_PRINTF
69 UCLIBC_USE_NETLINK LDSO_PRELOAD_FILE_SUPPORT"
70for config in $UCLIBC_OPTIONS; do
71 cp .config .config.orig
72 sed -e "s:# ${config} is not set:${config}=y:" .config.orig > .config
73done
74echo "UCLIBC_HAS_FULL_RPC=y" >> .config
75echo "UCLIBC_HAS_REENTRANT_RPC=y" >> .config</userinput></screen>
76
77 <para os="l">We have made some changes to our config, let's make sure
78 that we didn't miss and dependencies:</para>
79
80<screen os="m"><userinput>make TARGET_ARCH=i386 oldconfig</userinput></screen>
81
82 <para os="n">Compile the package:</para>
83
84<screen os="o"><userinput>make CC="${CC} ${BUILD}" TARGET_ARCH=i386</userinput></screen>
85
86 <para os="p">The uClibc build system creates symlinks in its
87 <filename class="directory">include</filename> directory pointing to
88 ${CLFS}/usr/include. We will need to remove these symlinks from the source dir:</para>
89
90<screen os="q"><userinput>rm include/{asm,asm-generic,linux}</userinput></screen>
91
92 <para os="r">Install the package:</para>
93
94<screen os="s"><userinput>make PREFIX=${CLFS} install</userinput></screen>
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>
108<!--
109 <variablelist>
110 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
111 <?dbfo list-presentation="list"?>
112 <?dbhtml list-presentation="table"?>
113
114 <varlistentry id="uclibc">
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>
126-->
127
128 </sect2>
129</sect1>
Note: See TracBrowser for help on using the repository browser.