source: cross-tools/x86/glibc-headers.xml@ c48c555

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

r766@server (orig r764): jim | 2005-11-28 15:07:41 -0800

r807@server: jim | 2005-11-28 15:07:12 -0800
Text updates to Glibc


  • Property mode set to 100644
File size: 5.7 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-glibc-headers" role="wrap">
9 <?dbhtml filename="glibc-headers.html"?>
10
11 <title>Glibc-&glibc-version; Headers</title>
12
13 <indexterm zone="ch-cross-tools-glibc-headers">
14 <primary sortas="a-Glibc">Glibc</primary>
15 <secondary>cross tools, headers</secondary>
16 </indexterm>
17
18 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
19 href="../../final-system/common/glibc.xml"
20 xpointer="xpointer(//*[@role='package'])"/>
21
22 <sect2 role="installation">
23 <title>Installation of Glibc Headers</title>
24
25 <para os="s1">The following sed removes a dependency of gcc 3.4.x from
26 the glibc we are using in cross-lfs. The reason we are changing it is
27 because this only installs the headers, no compiling takes place. In the
28 next glibc chapter, we use the gcc that's build right after this chapter.</para>
29
30<screen os="s2"><userinput>cp configure{,.orig}
31sed -e 's/3.4/3.[0-9]/g' configure.orig > configure</userinput></screen>
32
33 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
34 href="../../final-system/common/glibc.xml"
35 xpointer="xpointer(//*[@os='e'])"/>
36
37 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
38 href="../../final-system/common/glibc.xml"
39 xpointer="xpointer(//*[@os='f'])"/>
40
41 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
42 href="../../final-system/common/glibc.xml"
43 xpointer="xpointer(//*[@os='g'])"/>
44
45<screen os="s3"><userinput>CC=gcc ../glibc-&glibc-version;/configure --prefix=/tools \
46 --host=${LFS_TARGET} --build=${LFS_HOST} \
47 --disable-sanity-checks --enable-kernel=2.6.0 \
48 --with-headers=/tools/include \
49 --with-binutils=/cross-tools/${LFS_TARGET}/bin</userinput></screen>
50
51 <warning os="e1">
52 <para><emphasis>Any</emphasis> error message you see about nptl at this point
53 can safely be ignored.</para>
54 </warning>
55
56 <variablelist os="ca">
57 <title>The meaning of the configure options:</title>
58
59 <varlistentry os="ca1">
60 <term><parameter>CC=gcc</parameter></term>
61 <listitem>
62 <para>Tells GLIBC to use the hosts GCC compiler.</para>
63 </listitem>
64 </varlistentry>
65
66 <varlistentry os="ca2">
67 <term><parameter>--prefix=/tools</parameter></term>
68 <listitem>
69 <para>This tells the configure script to prepare to install the
70 package in the <filename class="directory">/tools</filename>
71 directory.</para>
72 </listitem>
73 </varlistentry>
74
75 <varlistentry os="ca3">
76 <term><parameter>--host=${LFS_HOST}</parameter></term>
77 <listitem>
78 <para>When used injunction with --target, this creates a cross-architecture
79 executable that creates files for ${LFS_TARGET} but runs on ${LFS_HOST).</para>
80 </listitem>
81 </varlistentry>
82
83 <varlistentry os="ca4">
84 <term><parameter>--target=${LFS_TARGET}</parameter></term>
85 <listitem>
86 <para>When used injunction with --host, this creates a cross-architecture
87 executable that creates files for ${LFS_TARGET} but runs on ${LFS_HOST).</para>
88 </listitem>
89 </varlistentry>
90
91 <varlistentry os="ca5">
92 <term><parameter>--disable-sanity-checks</parameter></term>
93 <listitem>
94 <para>This switch disables any checks that are in place.</para>
95 </listitem>
96 </varlistentry>
97
98 <varlistentry os="ca6">
99 <term><parameter>--enable-kernel=2.6.0</parameter></term>
100 <listitem>
101 <para>This tells Glibc to compile the library with support
102 for 2.6.x Linux kernels.</para>
103 </listitem>
104 </varlistentry>
105
106 <varlistentry os="ca7">
107 <term><parameter>--with-headers=/tools/include</parameter></term>
108 <listitem>
109 <para>This tells Glibc to compile itself against the headers
110 recently installed to the <filename class="directory">/tools</filename>
111 directory, so that it knows exactly what features the kernel has
112 and can optimize itself accordingly.</para>
113 </listitem>
114 </varlistentry>
115
116 <varlistentry os="ca8">
117 <term><parameter>--with-binutils=/cross-tools/${LFS_TARGET}/bin</parameter></term>
118 <listitem>
119 <para>This tells GLIBC to use the binutils for our specific target architecture.</para>
120 </listitem>
121 </varlistentry>
122
123 </variablelist>
124
125 <para os="cb">Now, install the headers:</para>
126
127<screen os="cd"><userinput>make install-headers</userinput></screen>
128
129 <para os="ce">Some files aren't installed by the above command, then
130 we will copy the header files we need:</para>
131
132 <para os="cf">First we will copy a common file over to <filename
133 class="directory">/tools/include</filename>:</para>
134
135<screen os="cg"><userinput>install -d /tools/include/bits
136cp bits/stdio_lim.h /tools/include/bits</userinput></screen>
137
138 <para os="ch">Now we will create a blank stub file:</para>
139
140<screen os="ci"><userinput>touch /tools/include/gnu/stubs.h</userinput></screen>
141
142 <para os="cj">For NPTL we use the following command:</para>
143
144<screen os="ck"><userinput>cp ../glibc-&glibc-version;/nptl/sysdeps/pthread/pthread.h /tools/include/</userinput></screen>
145
146 <para os="cl">Now we copy the architecture specific header over:</para>
147
148<screen os="cm"><userinput>cp ../glibc-&glibc-version;/nptl/sysdeps/unix/sysv/linux/i386/bits/pthreadtypes.h /tools/include/bits/</userinput></screen>
149
150 </sect2>
151
152 <sect2 role="content">
153 <title/>
154
155 <para>Details on this package are located in <xref
156 linkend="contents-glibc" role="."/></para>
157
158 </sect2>
159
160</sect1>
Note: See TracBrowser for help on using the repository browser.