Changeset 7afc252 in clfs-embedded for BOOK/cross-tools/x86
- Timestamp:
- Feb 12, 2011, 3:08:06 PM (14 years ago)
- Branches:
- master
- Children:
- f45393b
- Parents:
- 7003296 (diff), bd0ad10 (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the(diff)
links above to see all the changes relative to each parent. - Location:
- BOOK/cross-tools/x86
- Files:
-
- 2 edited
Legend:
- Unmodified
- Added
- Removed
-
BOOK/cross-tools/x86/gcc-final.xml
r7003296 r7afc252 5 5 %general-entities; 6 6 ]> 7 8 <!-- x86 GCC-Final --> 7 9 8 10 <sect1 id="ch-cross-tools-gcc-final" role="wrap"> … … 17 19 18 20 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 19 href="../common/gcc- static.xml"21 href="../common/gcc-final.xml" 20 22 xpointer="xpointer(//*[@role='package'])"/> 21 23 … … 24 26 25 27 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 26 href="../common/gcc- static.xml"28 href="../common/gcc-final.xml" 27 29 xpointer="xpointer(//*[@os='c'])"/> 28 30 29 31 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 30 href="../common/gcc- static.xml"32 href="../common/gcc-final.xml" 31 33 xpointer="xpointer(//*[@os='d'])"/> 32 34 33 35 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 34 href="../common/gcc- static.xml"36 href="../common/gcc-final.xml" 35 37 xpointer="xpointer(//*[@os='e'])"/> 36 38 … … 71 73 72 74 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 73 href="gcc-static.xml" 74 xpointer="xpointer(//*[@os='ag'])"/> 75 76 <screen os="ah"><userinput>make</userinput></screen> 75 href="../common/gcc-final.xml" 76 xpointer="xpointer(//*[@os='ah'])"/> 77 77 78 78 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 79 href="../common/gcc- static.xml"79 href="../common/gcc-final.xml" 80 80 xpointer="xpointer(//*[@os='ai'])"/> 81 81 82 <screen os="aj"><userinput>make install</userinput></screen> 82 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 83 href="../common/gcc-final.xml" 84 xpointer="xpointer(//*[@os='aj'])"/> 85 86 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 87 href="../common/gcc-final.xml" 88 xpointer="xpointer(//*[@os='ak'])"/> 83 89 84 90 </sect2> 85 91 86 <sect2 id="contents-gcc" role="content"> 87 <title>Contents of GCC</title> 88 89 <segmentedlist> 90 <segtitle>Installed programs</segtitle> 91 <segtitle>Installed libraries</segtitle> 92 93 <seglistitem> 94 <seg>cc (link to gcc), gcc, gccbug, and gcov</seg> 95 <seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libmudflap.[a,so], 96 and libmudflapth.[a,so]</seg> 97 </seglistitem> 98 </segmentedlist> 99 100 <variablelist> 101 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 102 <?dbfo list-presentation="list"?> 103 <?dbhtml list-presentation="table"?> 104 105 <varlistentry id="cc"> 106 <term><command>cc</command></term> 107 <listitem> 108 <para>The C compiler</para> 109 <indexterm zone="ch-cross-tools-gcc-final cc"> 110 <primary sortas="b-cc">cc</primary> 111 </indexterm> 112 </listitem> 113 </varlistentry> 114 115 <varlistentry id="gcc"> 116 <term><command>gcc</command></term> 117 <listitem> 118 <para>The C compiler</para> 119 <indexterm zone="ch-cross-tools-gcc-final gcc"> 120 <primary sortas="b-gcc">gcc</primary> 121 </indexterm> 122 </listitem> 123 </varlistentry> 124 125 <varlistentry id="gccbug"> 126 <term><command>gccbug</command></term> 127 <listitem> 128 <para>A shell script used to help create useful bug reports</para> 129 <indexterm zone="ch-cross-tools-gcc-final gccbug"> 130 <primary sortas="b-gccbug">gccbug</primary> 131 </indexterm> 132 </listitem> 133 </varlistentry> 134 135 <varlistentry id="gcov"> 136 <term><command>gcov</command></term> 137 <listitem> 138 <para>A coverage testing tool; it is used to analyze programs to 139 determine where optimizations will have the most effect</para> 140 <indexterm zone="ch-cross-tools-gcc-final gcov"> 141 <primary sortas="b-gcov">gcov</primary> 142 </indexterm> 143 </listitem> 144 </varlistentry> 145 146 <varlistentry id="libgcc"> 147 <term><filename class="libraryfile">libgcc</filename></term> 148 <listitem> 149 <para>Contains run-time support for <command>gcc</command></para> 150 <indexterm zone="ch-cross-tools-gcc-final libgcc"> 151 <primary sortas="c-libgcc*">libgcc*</primary> 152 </indexterm> 153 </listitem> 154 </varlistentry> 155 156 <varlistentry id="libmudflap"> 157 <term><filename class="libraryfile">libmudflap</filename></term> 158 <listitem> 159 <para>The libmudflap libraries are used by GCC for instrumenting 160 pointer and array dereferencing operations.</para> 161 <indexterm zone="ch-cross-tools-gcc-final libmudflap"> 162 <primary sortas="c-libmudflap*">libmudflap*</primary> 163 </indexterm> 164 </listitem> 165 </varlistentry> 166 167 </variablelist> 168 169 </sect2> 92 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 93 href="../common/gcc-final.xml" 94 xpointer="xpointer(//*[@role='content'])"/> 170 95 171 96 </sect1> -
BOOK/cross-tools/x86/gcc-static.xml
r7003296 r7afc252 5 5 %general-entities; 6 6 ]> 7 8 <!-- x86 GCC-Static --> 7 9 8 10 <sect1 id="ch-cross-tools-gcc-static" role="wrap"> … … 16 18 </indexterm> 17 19 18 <sect2 role="package"> 19 <title/> 20 21 <para>The GCC package contains the GNU compiler collection, which includes 22 the C and C++ compilers.</para> 23 24 </sect2> 20 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 21 href="../common/gcc-static.xml" 22 xpointer="xpointer(//*[@role='package'])"/> 25 23 26 24 <sect2 role="installation"> 27 <title>Installation of Cross GCC Compiler with Static libgcc 28 and no Threads</title> 25 26 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 27 href="../common/gcc-static.xml" 28 xpointer="xpointer(//*[@os='a'])"/> 29 29 30 30 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" … … 50 50 --with-arch=${CLFS_CPU} --disable-multilib</userinput></screen> 51 51 52 <variablelist os="af"> 53 <title>The meaning of the configure options:</title> 54 55 <varlistentry os="af1"> 56 <term><parameter>--prefix=${CLFS}/cross-tools</parameter></term> 57 <listitem> 58 <para>This tells the configure script to prepare to install the 59 package in the <filename class="directory">${CLFS}/cross-tools</filename> 60 directory.</para> 61 </listitem> 62 </varlistentry> 63 64 <varlistentry os="af2"> 65 <term><parameter>--build=${CLFS_HOST}</parameter></term> 66 <listitem> 67 <para>This tells the configure script the triplet to use to build GCC. 68 It will use ${CLFS_HOST} as that's where it's being built.</para> 69 </listitem> 70 </varlistentry> 71 72 <varlistentry os="af3"> 73 <term><parameter>--host=${CLFS_HOST}</parameter></term> 74 <listitem> 75 <para>This tells the configure script the triplet of the machine GCC 76 will be executed on when actually cross compiling. It will use 77 ${CLFS_HOST} as that's where GCC will execute when cross compiling 78 software later.</para> 79 </listitem> 80 </varlistentry> 81 82 <varlistentry os="af4"> 83 <term><parameter>--target=${CLFS_TARGET}</parameter></term> 84 <listitem> 85 <para>This tells the configure script the triplet of the machine GCC 86 will build executables for. It will use ${CLFS_TARGET} so that software 87 compiled with this version of GCC can be executed on the embedded machine 88 target.</para> 89 </listitem> 90 </varlistentry> 91 92 <varlistentry os="af5"> 93 <term><parameter>--with-sysroot=${CLFS}</parameter></term> 94 <listitem> 95 <para>This tells configure that ${CLFS} is going to be the root 96 of our system. It will now use the specified sysroot, ${CLFS}, as 97 a prefix of the default search paths.</para> 98 </listitem> 99 </varlistentry> 100 101 <varlistentry os="af6"> 102 <term><parameter>--disable-nls</parameter></term> 103 <listitem> 104 <para>This disables internationalization as i18n is not needed for the 105 cross-compile tools.</para> 106 </listitem> 107 </varlistentry> 108 109 <varlistentry os="af7"> 110 <term><parameter>--disable-shared</parameter></term> 111 <listitem> 112 <para>Disables the creation of the shared libraries.</para> 113 </listitem> 114 </varlistentry> 115 116 <varlistentry os="af8"> 117 <term><parameter>--with-mpfr=${CLFS}/cross-tools</parameter></term> 118 <listitem> 119 <para>Tells configure where to find the 120 <filename class="directory">lib</filename> and 121 <filename class="directory">include</filename> directories 122 that contain MPFR which was built earlier.</para> 123 </listitem> 124 </varlistentry> 125 126 <varlistentry os="af9"> 127 <term><parameter>--with-gmp=${CLFS}/cross-tools</parameter></term> 128 <listitem> 129 <para>Tells configure where to find the 130 <filename class="directory">lib</filename> and 131 <filename class="directory">include</filename> directories 132 that contain GMP which was built earlier.</para> 133 </listitem> 134 </varlistentry> 135 136 <varlistentry os="af10"> 137 <term><parameter>--with-mpc=${CLFS}/cross-tools</parameter></term> 138 <listitem> 139 <para>Tells configure where to find the 140 <filename class="directory">lib</filename> and 141 <filename class="directory">include</filename> directories 142 that contain MPC which was built earlier.</para> 143 </listitem> 144 </varlistentry> 145 146 <varlistentry os="af11"> 147 <term><parameter>--without-headers</parameter></term> 148 <listitem> 149 <para>Tells configure to not use any headers from any C libraries. 150 This is needed as we haven't yet built the C library and to prevent 151 influence from the host environment.</para> 152 </listitem> 153 </varlistentry> 154 155 <varlistentry os="af12"> 156 <term><parameter>--with-newlib</parameter></term> 157 <listitem> 158 <para>Tells configure to build libgcc without needing any C 159 libraries.</para> 160 </listitem> 161 </varlistentry> 162 163 <varlistentry os="af13"> 164 <term><parameter>--disable-decimal-float</parameter></term> 165 <listitem> 166 <para>Tells configure to disable IEEE 754-2008 decimal floating 167 point support. Decimal floating point support isn't needed yet.</para> 168 </listitem> 169 </varlistentry> 170 171 <varlistentry os="af14"> 172 <term><parameter>--disable-libgomp</parameter></term> 173 <listitem> 174 <para>Tells configure to not build the GOMP run-time libraries. 175 GOMP is the GNU implementation of OpenMP, a API for shared-memory 176 parallel programming.</para> 177 </listitem> 178 </varlistentry> 179 180 <varlistentry os="af15"> 181 <term><parameter>--disable-libmudflap</parameter></term> 182 <listitem> 183 <para>Tells configure to not build libmudflap. Mudflap is a 184 library that can be used to help check for proper pointer usage.</para> 185 </listitem> 186 </varlistentry> 187 188 <varlistentry os="af16"> 189 <term><parameter>--disable-libssp</parameter></term> 190 <listitem> 191 <para>Tells configure not to build run-time libraries for stack 192 smashing detection.</para> 193 </listitem> 194 </varlistentry> 195 196 <varlistentry os="af17"> 197 <term><parameter>--disable-threads</parameter></term> 198 <listitem> 199 <para>This will prevent GCC from looking for the multi-thread 200 include files, since they haven't been created for this architecture 201 yet. GCC will be able to find the multi-thread information after 202 the glib headers are created.</para> 203 </listitem> 204 </varlistentry> 205 206 <varlistentry os="af18"> 207 <term><parameter>--enable-languages=c</parameter></term> 208 <listitem> 209 <para>This option ensures that only the C compiler is built.</para> 210 </listitem> 211 </varlistentry> 212 213 <varlistentry os="af19"> 214 <term><parameter>--with-arch=${CLFS_CPU}</parameter></term> 215 <listitem> 216 <para>This option configures the cross compiler to only output 217 instructions for our previously selected CPU.</para> 218 </listitem> 219 </varlistentry> 220 221 <varlistentry os="af20"> 222 <term><parameter>--disable-multilib</parameter></term> 223 <listitem> 224 <para>This option specifies that multiple target libraries should 225 not be built.</para> 226 </listitem> 227 </varlistentry> 228 229 </variablelist> 230 52 <!-- Common configure switches for all archs --> 231 53 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 232 54 href="../common/gcc-static.xml" 233 xpointer="xpointer(//*[@os='ag'])"/> 55 xpointer="xpointer(//*[@os='af'])"/> 56 57 <!-- Specific configure switches for x86 --> 58 <variablelist os="ag"> 59 60 <varlistentry os="ag1"> 61 <term><parameter>--with-arch=${CLFS_CPU}</parameter></term> 62 <listitem> 63 <para>This option configures the cross compiler to only output 64 instructions for our previously selected CPU.</para> 65 </listitem> 66 </varlistentry> 67 68 <varlistentry os="ag2"> 69 <term><parameter>--disable-multilib</parameter></term> 70 <listitem> 71 <para>This option specifies that multiple target libraries should 72 not be built.</para> 73 </listitem> 74 </varlistentry> 75 76 </variablelist> 234 77 235 78 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" … … 245 88 xpointer="xpointer(//*[@os='aj'])"/> 246 89 247 </sect2> 248 249 <sect2 role="content"> 250 <title/> 251 252 <para>Details on this package are located in <xref 253 linkend="contents-gcc" role="."/></para> 90 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 91 href="../common/gcc-static.xml" 92 xpointer="xpointer(//*[@os='ak'])"/> 254 93 255 94 </sect2> 256 95 96 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" 97 href="../common/gcc-static.xml" 98 xpointer="xpointer(//*[@role='content'])"/> 99 257 100 </sect1>
Note:
See TracChangeset
for help on using the changeset viewer.