/[gentoo-x86]/eclass/toolchain-funcs.eclass
Gentoo

Contents of /eclass/toolchain-funcs.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.74 - (hide annotations) (download)
Fri Aug 17 10:14:13 2007 UTC (7 years, 1 month ago) by vapier
Branch: MAIN
Changes since 1.73: +90 -36 lines
add new documentation

1 vapier 1.67 # Copyright 1999-2007 Gentoo Foundation
2 vapier 1.1 # Distributed under the terms of the GNU General Public License v2
3 vapier 1.74 # $Header: /var/cvsroot/gentoo-x86/eclass/toolchain-funcs.eclass,v 1.73 2007/07/22 19:59:48 vapier Exp $
4    
5     # @ECLASS: toolchain-funcs.eclass
6     # @MAINTAINER:
7     # Toolchain Ninjas <toolchain@gentoo.org>
8     # @BLURB: functions to query common info about the toolchain
9     # @DESCRIPTION:
10     # The toolchain-funcs aims to provide a complete suite of functions
11     # for gleaning useful information about the toolchain and to simplify
12     # ugly things like cross-compiling and multilib. All of this is done
13     # in such a way that you can rely on the function always returning
14     # something sane.
15 vapier 1.1
16 vapier 1.69 ___ECLASS_RECUR_TOOLCHAIN_FUNCS="yes"
17     [[ -z ${___ECLASS_RECUR_MULTILIB} ]] && inherit multilib
18 eradicator 1.34
19 vapier 1.1 DESCRIPTION="Based on the ${ECLASS} eclass"
20    
21     tc-getPROG() {
22 vapier 1.33 local var=$1
23     local prog=$2
24 vapier 1.1
25 vapier 1.17 if [[ -n ${!var} ]] ; then
26 vapier 1.1 echo "${!var}"
27     return 0
28     fi
29    
30 eradicator 1.35 local search=
31     [[ -n $3 ]] && search=$(type -p "$3-${prog}")
32     [[ -z ${search} && -n ${CHOST} ]] && search=$(type -p "${CHOST}-${prog}")
33     [[ -n ${search} ]] && prog=${search##*/}
34 vapier 1.1
35 vapier 1.17 export ${var}=${prog}
36 vapier 1.1 echo "${!var}"
37     }
38    
39 vapier 1.74 # @FUNCTION: tc-getAR
40     # @USAGE: [toolchain prefix]
41     # @RETURN: name of the archiver
42 vapier 1.33 tc-getAR() { tc-getPROG AR ar "$@"; }
43 vapier 1.74 # @FUNCTION: tc-getAS
44     # @USAGE: [toolchain prefix]
45     # @RETURN: name of the assembler
46 vapier 1.33 tc-getAS() { tc-getPROG AS as "$@"; }
47 vapier 1.74 # @FUNCTION: tc-getCC
48     # @USAGE: [toolchain prefix]
49     # @RETURN: name of the C compiler
50 vapier 1.33 tc-getCC() { tc-getPROG CC gcc "$@"; }
51 vapier 1.74 # @FUNCTION: tc-getCPP
52     # @USAGE: [toolchain prefix]
53     # @RETURN: name of the C preprocessor
54 robbat2 1.58 tc-getCPP() { tc-getPROG CPP cpp "$@"; }
55 vapier 1.74 # @FUNCTION: tc-getCXX
56     # @USAGE: [toolchain prefix]
57     # @RETURN: name of the C++ compiler
58 vapier 1.33 tc-getCXX() { tc-getPROG CXX g++ "$@"; }
59 vapier 1.74 # @FUNCTION: tc-getLD
60     # @USAGE: [toolchain prefix]
61     # @RETURN: name of the linker
62 vapier 1.33 tc-getLD() { tc-getPROG LD ld "$@"; }
63 vapier 1.74 # @FUNCTION: tc-getSTRIP
64     # @USAGE: [toolchain prefix]
65     # @RETURN: name of the strip program
66 kanaka 1.59 tc-getSTRIP() { tc-getPROG STRIP strip "$@"; }
67 vapier 1.74 # @FUNCTION: tc-getNM
68     # @USAGE: [toolchain prefix]
69     # @RETURN: name of the symbol/object thingy
70 vapier 1.33 tc-getNM() { tc-getPROG NM nm "$@"; }
71 vapier 1.74 # @FUNCTION: tc-getRANLIB
72     # @USAGE: [toolchain prefix]
73     # @RETURN: name of the archiver indexer
74 vapier 1.33 tc-getRANLIB() { tc-getPROG RANLIB ranlib "$@"; }
75 vapier 1.74 # @FUNCTION: tc-getF77
76     # @USAGE: [toolchain prefix]
77     # @RETURN: name of the Fortran 77 compiler
78 kanaka 1.59 tc-getF77() { tc-getPROG F77 f77 "$@"; }
79 vapier 1.74 # @FUNCTION: tc-getF90
80     # @USAGE: [toolchain prefix]
81     # @RETURN: name of the Fortran 90 compiler
82 kanaka 1.59 tc-getF90() { tc-getPROG F90 gfortran "$@"; }
83 vapier 1.74 # @FUNCTION: tc-getFORTRAN
84     # @USAGE: [toolchain prefix]
85     # @RETURN: name of the Fortran compiler
86 kanaka 1.59 tc-getFORTRAN() { tc-getPROG FORTRAN gfortran "$@"; }
87 vapier 1.74 # @FUNCTION: tc-getGCJ
88     # @USAGE: [toolchain prefix]
89     # @RETURN: name of the java compiler
90 vapier 1.33 tc-getGCJ() { tc-getPROG GCJ gcj "$@"; }
91 vapier 1.1
92 vapier 1.74 # @FUNCTION: tc-getBUILD_CC
93     # @USAGE: [toolchain prefix]
94     # @RETURN: name of the C compiler for building binaries to run on the build machine
95 vapier 1.4 tc-getBUILD_CC() {
96 vapier 1.43 local v
97     for v in CC_FOR_BUILD BUILD_CC HOSTCC ; do
98     if [[ -n ${!v} ]] ; then
99     export BUILD_CC=${!v}
100     echo "${!v}"
101     return 0
102     fi
103     done
104 vapier 1.4
105 vapier 1.9 local search=
106 vapier 1.17 if [[ -n ${CBUILD} ]] ; then
107 vapier 1.21 search=$(type -p ${CBUILD}-gcc)
108 vapier 1.17 search=${search##*/}
109 vapier 1.9 fi
110 vapier 1.45 search=${search:-gcc}
111 vapier 1.11
112 vapier 1.17 export BUILD_CC=${search}
113 vapier 1.11 echo "${search}"
114 vapier 1.4 }
115 vapier 1.1
116 vapier 1.74 # @FUNCTION: tc-export
117     # @USAGE: <list of toolchain variables>
118     # @DESCRIPTION:
119     # Quick way to export a bunch of compiler vars at once.
120 vapier 1.10 tc-export() {
121     local var
122     for var in "$@" ; do
123 vapier 1.36 eval tc-get${var} > /dev/null
124 vapier 1.10 done
125     }
126    
127 vapier 1.74 # @FUNCTION: tc-is-cross-compiler
128     # @RETURN: Shell true if we are using a cross-compiler, shell false otherwise
129 vapier 1.12 tc-is-cross-compiler() {
130 vapier 1.43 return $([[ ${CBUILD:-${CHOST}} != ${CHOST} ]])
131 vapier 1.12 }
132    
133 vapier 1.74 # @FUNCTION: tc-is-softfloat
134     # @DESCRIPTION:
135 vapier 1.65 # See if this toolchain is a softfloat based one.
136 vapier 1.74 # @CODE
137 vapier 1.65 # The possible return values:
138     # - only: the target is always softfloat (never had fpu)
139     # - yes: the target should support softfloat
140     # - no: the target should support hardfloat
141 vapier 1.74 # @CODE
142 vapier 1.65 # This allows us to react differently where packages accept
143     # softfloat flags in the case where support is optional, but
144     # rejects softfloat flags where the target always lacks an fpu.
145     tc-is-softfloat() {
146     case ${CTARGET} in
147 vapier 1.66 bfin*|h8300*)
148 vapier 1.65 echo "only" ;;
149     *)
150     [[ ${CTARGET//_/-} == *-softfloat-* ]] \
151     && echo "yes" \
152     || echo "no"
153     ;;
154     esac
155     }
156 vapier 1.1
157 swegener 1.40 # Parse information from CBUILD/CHOST/CTARGET rather than
158 vapier 1.20 # use external variables from the profile.
159     tc-ninja_magic_to_arch() {
160 vapier 1.21 ninj() { [[ ${type} == "kern" ]] && echo $1 || echo $2 ; }
161 vapier 1.19
162     local type=$1
163     local host=$2
164 eradicator 1.25 [[ -z ${host} ]] && host=${CTARGET:-${CHOST}}
165 vapier 1.19
166     case ${host} in
167     alpha*) echo alpha;;
168     arm*) echo arm;;
169 vapier 1.72 avr*) ninj avr32 avr;;
170 vapier 1.53 bfin*) ninj blackfin bfin;;
171 vapier 1.47 cris*) echo cris;;
172 vapier 1.19 hppa*) ninj parisc hppa;;
173 vapier 1.47 i?86*) ninj i386 x86;;
174 vapier 1.19 ia64*) echo ia64;;
175 vapier 1.23 m68*) echo m68k;;
176 vapier 1.19 mips*) echo mips;;
177 vapier 1.52 nios2*) echo nios2;;
178     nios*) echo nios;;
179 vapier 1.49 powerpc*)
180     # Starting with linux-2.6.15, the 'ppc' and 'ppc64' trees
181 josejx 1.54 # have been unified into simply 'powerpc', but until 2.6.16,
182     # ppc32 is still using ARCH="ppc" as default
183     if [[ $(KV_to_int ${KV}) -ge $(KV_to_int 2.6.16) ]] && [[ ${type} == "kern" ]] ; then
184 vapier 1.49 echo powerpc
185 josejx 1.54 elif [[ $(KV_to_int ${KV}) -eq $(KV_to_int 2.6.15) ]] && [[ ${type} == "kern" ]] ; then
186 dostrow 1.55 if [[ ${host} == powerpc64* ]] || [[ ${PROFILE_ARCH} == "ppc64" ]] ; then
187 josejx 1.54 echo powerpc
188     else
189     echo ppc
190 swegener 1.56 fi
191 vapier 1.49 elif [[ ${host} == powerpc64* ]] ; then
192     echo ppc64
193 dostrow 1.51 elif [[ ${PROFILE_ARCH} == "ppc64" ]] ; then
194     ninj ppc64 ppc
195 vapier 1.49 else
196     echo ppc
197     fi
198 dostrow 1.37 ;;
199 vapier 1.47 s390*) echo s390;;
200     sh64*) ninj sh64 sh;;
201     sh*) echo sh;;
202 vapier 1.19 sparc64*) ninj sparc64 sparc;;
203 vapier 1.28 sparc*) [[ ${PROFILE_ARCH} == "sparc64" ]] \
204     && ninj sparc64 sparc \
205     || echo sparc
206     ;;
207 vapier 1.47 vax*) echo vax;;
208     x86_64*) ninj x86_64 amd64;;
209 vapier 1.73
210     # since our usage of tc-arch is largely concerned with
211     # normalizing inputs for testing ${CTARGET}, let's filter
212     # other cross targets (mingw and such) into the unknown.
213     *) echo unknown;;
214 vapier 1.19 esac
215     }
216 vapier 1.74 # @FUNCTION: tc-arch-kernel
217     # @USAGE: [toolchain prefix]
218     # @RETURN: name of the kernel arch according to the compiler target
219 vapier 1.20 tc-arch-kernel() {
220 vapier 1.74 tc-ninja_magic_to_arch kern "$@"
221 vapier 1.19 }
222 vapier 1.74 # @FUNCTION: tc-arch
223     # @USAGE: [toolchain prefix]
224     # @RETURN: name of the portage arch according to the compiler target
225 vapier 1.20 tc-arch() {
226 vapier 1.74 tc-ninja_magic_to_arch portage "$@"
227 vapier 1.19 }
228 vapier 1.74
229 robbat2 1.71 tc-endian() {
230     local host=$1
231     [[ -z ${host} ]] && host=${CTARGET:-${CHOST}}
232     host=${host%%-*}
233    
234     case ${host} in
235     alpha*) echo big;;
236     arm*b*) echo big;;
237     arm*) echo little;;
238     cris*) echo little;;
239     hppa*) echo big;;
240     i?86*) echo little;;
241     ia64*) echo little;;
242     m68*) echo big;;
243     mips*l*) echo little;;
244     mips*) echo big;;
245     powerpc*) echo big;;
246     s390*) echo big;;
247     sh*b*) echo big;;
248     sh*) echo little;;
249     sparc*) echo big;;
250     x86_64*) echo little;;
251     *) echo wtf;;
252     esac
253     }
254 vapier 1.19
255 vapier 1.74 # @FUNCTION: gcc-fullversion
256     # @RETURN: compiler version (major.minor.micro: [3.4.6])
257 vapier 1.1 gcc-fullversion() {
258 vapier 1.63 $(tc-getCC "$@") -dumpversion
259 vapier 1.1 }
260 vapier 1.74 # @FUNCTION: gcc-version
261     # @RETURN: compiler version (major.minor: [3.4].6)
262 vapier 1.1 gcc-version() {
263 vapier 1.63 gcc-fullversion "$@" | cut -f1,2 -d.
264 vapier 1.1 }
265 vapier 1.74 # @FUNCTION: gcc-major-version
266     # @RETURN: major compiler version (major: [3].4.6)
267 vapier 1.1 gcc-major-version() {
268 vapier 1.63 gcc-version "$@" | cut -f1 -d.
269 vapier 1.1 }
270 vapier 1.74 # @FUNCTION: gcc-minor-version
271     # @RETURN: minor compiler version (minor: 3.[4].6)
272 vapier 1.1 gcc-minor-version() {
273 vapier 1.63 gcc-version "$@" | cut -f2 -d.
274 vapier 1.1 }
275 vapier 1.74 # @FUNCTION: gcc-micro-version
276     # @RETURN: micro compiler version (micro: 3.4.[6])
277 vapier 1.1 gcc-micro-version() {
278 vapier 1.63 gcc-fullversion "$@" | cut -f3 -d. | cut -f1 -d-
279 vapier 1.1 }
280 vapier 1.74
281 kevquinn 1.68 # Returns the installation directory - internal toolchain
282     # function for use by _gcc-specs-exists (for flag-o-matic).
283     _gcc-install-dir() {
284     echo "$($(tc-getCC) -print-search-dirs 2> /dev/null |\
285     awk '$1=="install:" {print $2}')"
286     }
287     # Returns true if the indicated specs file exists - internal toolchain
288     # function for use by flag-o-matic.
289     _gcc-specs-exists() {
290     [[ -f $(_gcc-install-dir)/$1 ]]
291     }
292 kevquinn 1.41
293 kevquinn 1.68 # Returns requested gcc specs directive unprocessed - for used by
294     # gcc-specs-directive()
295 kevquinn 1.46 # Note; later specs normally overwrite earlier ones; however if a later
296     # spec starts with '+' then it appends.
297     # gcc -dumpspecs is parsed first, followed by files listed by "gcc -v"
298 kevquinn 1.68 # as "Reading <file>", in order. Strictly speaking, if there's a
299     # $(gcc_install_dir)/specs, the built-in specs aren't read, however by
300     # the same token anything from 'gcc -dumpspecs' is overridden by
301     # the contents of $(gcc_install_dir)/specs so the result is the
302     # same either way.
303     _gcc-specs-directive_raw() {
304 kevquinn 1.57 local cc=$(tc-getCC)
305     local specfiles=$(LC_ALL=C ${cc} -v 2>&1 | awk '$1=="Reading" {print $NF}')
306     ${cc} -dumpspecs 2> /dev/null | cat - ${specfiles} | awk -v directive=$1 \
307 kevquinn 1.46 'BEGIN { pspec=""; spec=""; outside=1 }
308     $1=="*"directive":" { pspec=spec; spec=""; outside=0; next }
309 kevquinn 1.41 outside || NF==0 || ( substr($1,1,1)=="*" && substr($1,length($1),1)==":" ) { outside=1; next }
310 kevquinn 1.46 spec=="" && substr($0,1,1)=="+" { spec=pspec " " substr($0,2); next }
311     { spec=spec $0 }
312     END { print spec }'
313     return 0
314 kevquinn 1.41 }
315    
316 kevquinn 1.68 # Return the requested gcc specs directive, with all included
317     # specs expanded.
318     # Note, it does not check for inclusion loops, which cause it
319     # to never finish - but such loops are invalid for gcc and we're
320     # assuming gcc is operational.
321     gcc-specs-directive() {
322     local directive subdname subdirective
323     directive="$(_gcc-specs-directive_raw $1)"
324     while [[ ${directive} == *%\(*\)* ]]; do
325     subdname=${directive/*%\(}
326     subdname=${subdname/\)*}
327     subdirective="$(_gcc-specs-directive_raw ${subdname})"
328     directive="${directive//\%(${subdname})/${subdirective}}"
329     done
330     echo "${directive}"
331     return 0
332     }
333    
334 kevquinn 1.41 # Returns true if gcc sets relro
335     gcc-specs-relro() {
336     local directive
337     directive=$(gcc-specs-directive link_command)
338     return $([[ ${directive/\{!norelro:} != ${directive} ]])
339     }
340     # Returns true if gcc sets now
341     gcc-specs-now() {
342     local directive
343     directive=$(gcc-specs-directive link_command)
344     return $([[ ${directive/\{!nonow:} != ${directive} ]])
345     }
346     # Returns true if gcc builds PIEs
347     gcc-specs-pie() {
348     local directive
349     directive=$(gcc-specs-directive cc1)
350     return $([[ ${directive/\{!nopie:} != ${directive} ]])
351     }
352     # Returns true if gcc builds with the stack protector
353     gcc-specs-ssp() {
354     local directive
355     directive=$(gcc-specs-directive cc1)
356     return $([[ ${directive/\{!fno-stack-protector:} != ${directive} ]])
357     }
358 kevquinn 1.46 # Returns true if gcc upgrades fstack-protector to fstack-protector-all
359     gcc-specs-ssp-to-all() {
360     local directive
361     directive=$(gcc-specs-directive cc1)
362     return $([[ ${directive/\{!fno-stack-protector-all:} != ${directive} ]])
363     }
364 vapier 1.60
365    
366 vapier 1.74 # @FUNCTION: gen_usr_ldscript
367     # @USAGE: <list of libs to create linker scripts for>
368     # @DESCRIPTION:
369 vapier 1.60 # This function generate linker scripts in /usr/lib for dynamic
370     # libs in /lib. This is to fix linking problems when you have
371     # the .so in /lib, and the .a in /usr/lib. What happens is that
372     # in some cases when linking dynamic, the .a in /usr/lib is used
373     # instead of the .so in /lib due to gcc/libtool tweaking ld's
374 vapier 1.74 # library search path. This causes many builds to fail.
375 vapier 1.60 # See bug #4411 for more info.
376     #
377     # Note that you should in general use the unversioned name of
378 vapier 1.74 # the library (libfoo.so), as ldconfig should usually update it
379     # correctly to point to the latest version of the library present.
380 vapier 1.70 gen_usr_ldscript() {
381 vapier 1.60 local lib libdir=$(get_libdir) output_format=""
382     # Just make sure it exists
383     dodir /usr/${libdir}
384    
385     # OUTPUT_FORMAT gives hints to the linker as to what binary format
386     # is referenced ... makes multilib saner
387     output_format=$($(tc-getCC) ${CFLAGS} ${LDFLAGS} -Wl,--verbose 2>&1 | sed -n 's/^OUTPUT_FORMAT("\([^"]*\)",.*/\1/p')
388     [[ -n ${output_format} ]] && output_format="OUTPUT_FORMAT ( ${output_format} )"
389    
390     for lib in "$@" ; do
391 vapier 1.62 if [[ ${USERLAND} == "Darwin" ]] ; then
392     ewarn "Not creating fake dynamic library for $lib on Darwin;"
393 grobian 1.61 ewarn "making a symlink instead."
394     dosym "/${libdir}/${lib}" "/usr/${libdir}/${lib}"
395     else
396     cat > "${D}/usr/${libdir}/${lib}" <<-END_LDSCRIPT
397     /* GNU ld script
398     Since Gentoo has critical dynamic libraries
399     in /lib, and the static versions in /usr/lib,
400     we need to have a "fake" dynamic lib in /usr/lib,
401     otherwise we run into linking problems.
402    
403     See bug http://bugs.gentoo.org/4411 for more info.
404     */
405     ${output_format}
406     GROUP ( /${libdir}/${lib} )
407     END_LDSCRIPT
408     fi
409 vapier 1.60 fperms a+x "/usr/${libdir}/${lib}" || die "could not change perms on ${lib}"
410     done
411     }

  ViewVC Help
Powered by ViewVC 1.1.20