source: clfs-embedded/BOOK/cross-tools/common/uclibc.xml @ 0ec3a36

Last change on this file since 0ec3a36 was 0ec3a36, checked in by Maarten Lankhorst <mlankhorst@…>, 13 years ago

add CROSS to building uclibc

  • Property mode set to 100644
File size: 3.7 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="a">
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="p1">The following patch contains a number of updates to the
38    &uclibc-version; branch by the uClibc developers:</para>
39
40<screen os="p2"><userinput>patch -Np1 -i ../&uclibc-branch_update-patch;</userinput></screen>
41
42    <para os="b">Copy the uClibc config file from where you downloaded it:</para>
43
44<screen os="c"><userinput>cp ${CLFS}/sources/uClibc-&uclibc-version;.config .config</userinput></screen>
45
46   <para os="d">We will need to edit the configuration file, to make sure everything gets
47   compiled and it's compiled to the proper architecture:</para>
48
49<screen os="e"><userinput>cp .config{,.orig}
50sed -e "s@# TARGET_${CLFS_ARCH} is not set@TARGET_${CLFS_ARCH}=y@" \
51  -e "s@\(^TARGET_ARCH=\).*@\1\"${CLFS_ARCH}\"@" \
52  -e "s@\(^CROSS_COMPILER_PREFIX=\).*@\1\"${CLFS_TARGET}-\"@" \
53  -e "s@\(^KERNEL_HEADERS=\).*@\1\"${CLFS}/usr/include\"@" \
54  -e "s@.*\(^ARCH_${CLFS_NOT_ENDIAN}_ENDIAN\).*@# \1 is not set@g" \
55  -e "s@.*\(ARCH_${CLFS_ENDIAN}_ENDIAN\).*@\1=y@g" \
56  -e "s@.*\(ARCH_WANTS_${CLFS_ENDIAN}_ENDIAN\).*@\1=y@g" \
57  .config.orig > .config</userinput></screen>
58
59    <para os="f">The config is a basic working system, but there are some
60    options that are architecture specifc that need to be set. The following
61    command will only bring up items that need a value that we did not
62    specify in our Generic config file:</para>
63
64<screen os="g"><userinput>make oldconfig</userinput></screen>
65
66    <para os="h">Compile the package:</para>
67
68<screen os="i"><userinput>make CROSS=${CLFS_TARGET}- CC="${CLFS_TARGET}-gcc ${BUILD}"</userinput></screen>
69
70    <para os="l">Install the package:</para>
71
72<screen os="j"><userinput>make PREFIX=${CLFS} install</userinput></screen>
73
74  </sect2>
75
76  <sect2 id="contents-uclibc" role="content">
77    <title>Contents of uClibc</title>
78
79    <segmentedlist>
80      <segtitle>Installed uClibc</segtitle>
81
82      <seglistitem>
83        <seg>To Be Written</seg>
84      </seglistitem>
85    </segmentedlist>
86<!--
87    <variablelist>
88      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
89      <?dbfo list-presentation="list"?>
90      <?dbhtml list-presentation="table"?>
91
92     <varlistentry id="uclibc">
93        <term><filename
94        class="headerfile">/usr/include/{asm,linux}/*.h</filename></term>
95        <listitem>
96          <para>The Linux API headers</para>
97          <indexterm zone="ch-system-linux-headers linux-headers">
98            <primary
99            sortas="e-/usr/include/{asm,linux}/*.h">/usr/include/{asm,linux}/*.h</primary>
100          </indexterm>
101        </listitem>
102      </varlistentry>
103    </variablelist>
104-->
105
106  </sect2>
107</sect1>
Note: See TracBrowser for help on using the repository browser.