/[gentoo-x86]/eclass/multilib.eclass
Gentoo

Diff of /eclass/multilib.eclass

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.64 Revision 1.65
1# Copyright 1999-2007 Gentoo Foundation 1# Copyright 1999-2008 Gentoo Foundation
2# Distributed under the terms of the GNU General Public License v2 2# Distributed under the terms of the GNU General Public License v2
3# $Header: /var/cvsroot/gentoo-x86/eclass/multilib.eclass,v 1.64 2008/05/02 04:07:38 vapier Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/multilib.eclass,v 1.65 2008/06/01 01:37:29 vapier Exp $
4# 4
5# Maintainer: amd64@gentoo.org / toolchain@gentoo.org 5# @ECLASS: multilib.eclass
6# 6# @MAINTAINER:
7# amd64@gentoo.org
8# toolchain@gentoo.org
9# @BLURB: This eclass is for all functions pertaining to handling multilib configurations.
10# @DESCRIPTION:
7# This eclass is for all functions pertaining to handling multilib. 11# This eclass is for all functions pertaining to handling multilib configurations.
8# configurations.
9 12
10___ECLASS_RECUR_MULTILIB="yes" 13___ECLASS_RECUR_MULTILIB="yes"
11[[ -z ${___ECLASS_RECUR_TOOLCHAIN_FUNCS} ]] && inherit toolchain-funcs 14[[ -z ${___ECLASS_RECUR_TOOLCHAIN_FUNCS} ]] && inherit toolchain-funcs
12
13# has_multilib_profile:
14# Return true if the current profile is a multilib profile and lists more than
15# one abi in ${MULTILIB_ABIS}. When has_multilib_profile returns true, that
16# profile should enable the 'multilib' use flag. This is so you can DEPEND on
17# a package only for multilib or not multilib.
18 15
19# is_final_abi: 16# is_final_abi:
20# Return true if ${ABI} is the final abi to be installed (and thus we are 17# Return true if ${ABI} is the final abi to be installed (and thus we are
21# on our last run through a src_* function. 18# on our last run through a src_* function.
22 19
103export CTARGET_default=${CTARGET_default:-${CTARGET:-${CHOST_default}}} 100export CTARGET_default=${CTARGET_default:-${CTARGET:-${CHOST_default}}}
104export LIBDIR_default=${CONF_LIBDIR:-"lib"} 101export LIBDIR_default=${CONF_LIBDIR:-"lib"}
105export CDEFINE_default="__unix__" 102export CDEFINE_default="__unix__"
106export KERNEL_ABI=${KERNEL_ABI:-${DEFAULT_ABI}} 103export KERNEL_ABI=${KERNEL_ABI:-${DEFAULT_ABI}}
107 104
108# has_multilib_profile() 105# @FUNCTION: has_multilib_profile
106# @DESCRIPTION:
107# Return true if the current profile is a multilib profile and lists more than
108# one abi in ${MULTILIB_ABIS}. When has_multilib_profile returns true, that
109# profile should enable the 'multilib' use flag. This is so you can DEPEND on
110# a package only for multilib or not multilib.
109has_multilib_profile() { 111has_multilib_profile() {
110 [ -n "${MULTILIB_ABIS}" -a "${MULTILIB_ABIS}" != "${MULTILIB_ABIS/ /}" ] 112 [ -n "${MULTILIB_ABIS}" -a "${MULTILIB_ABIS}" != "${MULTILIB_ABIS/ /}" ]
111} 113}
112 114
115# @FUNCTION: get_libdir
116# @RETURN: the libdir for the selected ABI
117# @DESCRIPTION:
113# This function simply returns the desired lib directory. With portage 118# This function simply returns the desired lib directory. With portage
114# 2.0.51, we now have support for installing libraries to lib32/lib64 119# 2.0.51, we now have support for installing libraries to lib32/lib64
115# to accomidate the needs of multilib systems. It's no longer a good idea 120# to accomidate the needs of multilib systems. It's no longer a good idea
116# to assume all libraries will end up in lib. Replace any (sane) instances 121# to assume all libraries will end up in lib. Replace any (sane) instances
117# where lib is named directly with $(get_libdir) if possible. 122# where lib is named directly with $(get_libdir) if possible.
118#
119# Travis Tilley <lv@gentoo.org> (24 Aug 2004)
120# 123#
121# Jeremy Huddleston <eradicator@gentoo.org> (23 Dec 2004): 124# Jeremy Huddleston <eradicator@gentoo.org> (23 Dec 2004):
122# Added support for ${ABI} and ${DEFAULT_ABI}. If they're both not set, 125# Added support for ${ABI} and ${DEFAULT_ABI}. If they're both not set,
123# fall back on old behavior. Any profile that has these set should also 126# fall back on old behavior. Any profile that has these set should also
124# depend on a newer version of portage (not yet released) which uses these 127# depend on a newer version of portage (not yet released) which uses these
131 else 134 else
132 get_abi_LIBDIR 135 get_abi_LIBDIR
133 fi 136 fi
134} 137}
135 138
139# @FUNCTION: get_multilibdir
140# @RETURN: Returns the multilibdir
136get_multilibdir() { 141get_multilibdir() {
137 if has_multilib_profile; then 142 if has_multilib_profile; then
138 eerror "get_multilibdir called, but it shouldn't be needed with the new multilib approach. Please file a bug at http://bugs.gentoo.org and assign it to eradicator@gentoo.org" 143 eerror "get_multilibdir called, but it shouldn't be needed with the new multilib approach. Please file a bug at http://bugs.gentoo.org and assign it to eradicator@gentoo.org"
139 exit 1 144 exit 1
140 fi 145 fi
141 echo ${CONF_MULTILIBDIR:=lib32} 146 echo ${CONF_MULTILIBDIR:=lib32}
142} 147}
143 148
149# @FUNCTION: get_libdir_override
150# @DESCRIPTION:
144# Sometimes you need to override the value returned by get_libdir. A good 151# Sometimes you need to override the value returned by get_libdir. A good
145# example of this is xorg-x11, where lib32 isnt a supported configuration, 152# example of this is xorg-x11, where lib32 isnt a supported configuration,
146# and where lib64 -must- be used on amd64 (for applications that need lib 153# and where lib64 -must- be used on amd64 (for applications that need lib
147# to be 32bit, such as adobe acrobat). Note that this override also bypasses 154# to be 32bit, such as adobe acrobat). Note that this override also bypasses
148# portage version sanity checking. 155# portage version sanity checking.
149# get_libdir_override expects one argument, the result get_libdir should 156# get_libdir_override expects one argument, the result get_libdir should
150# return: 157# return:
151# 158#
152# get_libdir_override lib64 159# get_libdir_override lib64
153#
154# Travis Tilley <lv@gentoo.org> (31 Aug 2004)
155get_libdir_override() { 160get_libdir_override() {
156 if has_multilib_profile; then 161 if has_multilib_profile; then
157 eerror "get_libdir_override called, but it shouldn't be needed with the new multilib approach. Please file a bug at http://bugs.gentoo.org and assign it to eradicator@gentoo.org" 162 eerror "get_libdir_override called, but it shouldn't be needed with the new multilib approach. Please file a bug at http://bugs.gentoo.org and assign it to eradicator@gentoo.org"
158 exit 1 163 exit 1
159 fi 164 fi
160 CONF_LIBDIR="$1" 165 CONF_LIBDIR="$1"
161 CONF_LIBDIR_OVERRIDE="$1" 166 CONF_LIBDIR_OVERRIDE="$1"
162 LIBDIR_default="$1" 167 LIBDIR_default="$1"
163} 168}
164 169
165# get_abi_var <VAR> [<ABI>] 170# @FUNCTION: get_abi_var
171# @USAGE: <VAR> [ABI]
166# returns the value of ${<VAR>_<ABI>} which should be set in make.defaults 172# @RETURN: returns the value of ${<VAR>_<ABI>} which should be set in make.defaults
167# 173# @DESCRIPTION:
168# ex: 174# ex:
169# CFLAGS=$(get_abi_var CFLAGS sparc32) # CFLAGS=-m32 175# CFLAGS=$(get_abi_var CFLAGS sparc32) # CFLAGS=-m32
170# 176#
171# Note that the prefered method is to set CC="$(tc-getCC) $(get_abi_CFLAGS)" 177# Note that the prefered method is to set CC="$(tc-getCC) $(get_abi_CFLAGS)"
172# This will hopefully be added to portage soon... 178# This will hopefully be added to portage soon...
173# 179#
174# If <ABI> is not specified, ${ABI} is used. 180# If <ABI> is not specified, ${ABI} is used.
175# If <ABI> is not specified and ${ABI} is not defined, ${DEFAULT_ABI} is used. 181# If <ABI> is not specified and ${ABI} is not defined, ${DEFAULT_ABI} is used.
176# If <ABI> is not specified and ${ABI} and ${DEFAULT_ABI} are not defined, we return an empty string. 182# If <ABI> is not specified and ${ABI} and ${DEFAULT_ABI} are not defined, we return an empty string.
177#
178# Jeremy Huddleston <eradicator@gentoo.org>
179get_abi_var() { 183get_abi_var() {
180 local flag=$1 184 local flag=$1
181 local abi 185 local abi
182 if [ $# -gt 1 ]; then 186 if [ $# -gt 1 ]; then
183 abi=${2} 187 abi=${2}
191 195
192 local var="${flag}_${abi}" 196 local var="${flag}_${abi}"
193 echo ${!var} 197 echo ${!var}
194} 198}
195 199
200# @FUNCTION: get_abi_CFLAGS
201# @USAGE: [ABI]
202# @DESCRIPTION:
203# Alias for 'get_abi_var CFLAGS'
196get_abi_CFLAGS() { get_abi_var CFLAGS "$@"; } 204get_abi_CFLAGS() { get_abi_var CFLAGS "$@"; }
205
206# @FUNCTION: get_abi_ASFLAGS
207# @USAGE: [ABI]
208# @DESCRIPTION:
209# Alias for 'get_abi_var ASFLAGS'
197get_abi_ASFLAGS() { get_abi_var ASFLAGS "$@"; } 210get_abi_ASFLAGS() { get_abi_var ASFLAGS "$@"; }
211
212# @FUNCTION: get_abi_LDFLAGS
213# @USAGE: [ABI]
214# @DESCRIPTION:
215# Alias for 'get_abi_var LDFLAGS'
198get_abi_LDFLAGS() { get_abi_var LDFLAGS "$@"; } 216get_abi_LDFLAGS() { get_abi_var LDFLAGS "$@"; }
217
218# @FUNCTION: get_abi_CHOST
219# @USAGE: [ABI]
220# @DESCRIPTION:
221# Alias for 'get_abi_var CHOST'
199get_abi_CHOST() { get_abi_var CHOST "$@"; } 222get_abi_CHOST() { get_abi_var CHOST "$@"; }
223
224# @FUNCTION: get_abi_CTARGET
225# @USAGE: [ABI]
226# @DESCRIPTION:
227# Alias for 'get_abi_var CTARGET'
200get_abi_CTARGET() { get_abi_var CTARGET "$@"; } 228get_abi_CTARGET() { get_abi_var CTARGET "$@"; }
229
230# @FUNCTION: get_abi_FAKE_TARGETS
231# @USAGE: [ABI]
232# @DESCRIPTION:
233# Alias for 'get_abi_var FAKE_TARGETS'
201get_abi_FAKE_TARGETS() { get_abi_var FAKE_TARGETS "$@"; } 234get_abi_FAKE_TARGETS() { get_abi_var FAKE_TARGETS "$@"; }
235
236# @FUNCTION: get_abi_CDEFINE
237# @USAGE: [ABI]
238# @DESCRIPTION:
239# Alias for 'get_abi_var CDEFINE'
202get_abi_CDEFINE() { get_abi_var CDEFINE "$@"; } 240get_abi_CDEFINE() { get_abi_var CDEFINE "$@"; }
241
242# @FUNCTION: get_abi_LIBDIR
243# @USAGE: [ABI]
244# @DESCRIPTION:
245# Alias for 'get_abi_var LIBDIR'
203get_abi_LIBDIR() { get_abi_var LIBDIR "$@"; } 246get_abi_LIBDIR() { get_abi_var LIBDIR "$@"; }
204 247
248# @FUNCTION: get_install_abis
249# @DESCRIPTION:
205# Return a list of the ABIs we want to install for with 250# Return a list of the ABIs we want to install for with
206# the last one in the list being the default. 251# the last one in the list being the default.
207get_install_abis() { 252get_install_abis() {
208 local order="" 253 local order=""
209 254
239 284
240 echo ${order} 285 echo ${order}
241 return 0 286 return 0
242} 287}
243 288
289# @FUNCTION: get_all_abis
290# @DESCRIPTION:
244# Return a list of the ABIs supported by this profile. 291# Return a list of the ABIs supported by this profile.
245# the last one in the list being the default. 292# the last one in the list being the default.
246get_all_abis() { 293get_all_abis() {
247 local order="" 294 local order=""
248 295
260 307
261 echo ${order} 308 echo ${order}
262 return 0 309 return 0
263} 310}
264 311
265# get_all_libdirs() 312# @FUNCTION: get_all_libdirs
313# @DESCRIPTION:
266# Returns a list of all the libdirs used by this profile. This includes 314# Returns a list of all the libdirs used by this profile. This includes
267# those that might not be touched by the current ebuild. 315# those that might not be touched by the current ebuild and always includes
316# "lib".
268get_all_libdirs() { 317get_all_libdirs() {
269 local libdirs="lib" 318 local libdirs="lib"
270 local abi 319 local abi
271 local dir 320 local dir
272 321
275 done 324 done
276 325
277 echo "${libdirs}" 326 echo "${libdirs}"
278} 327}
279 328
329# @FUNCTION: is_final_abi
330# @DESCRIPTION:
280# Return true if ${ABI} is the last ABI on our list (or if we're not 331# Return true if ${ABI} is the last ABI on our list (or if we're not
281# using the new multilib configuration. This can be used to determine 332# using the new multilib configuration. This can be used to determine
282# if we're in the last (or only) run through src_{unpack,compile,install} 333# if we're in the last (or only) run through src_{unpack,compile,install}
283is_final_abi() { 334is_final_abi() {
284 has_multilib_profile || return 0 335 has_multilib_profile || return 0
285 local ALL_ABIS=$(get_install_abis) 336 local ALL_ABIS=$(get_install_abis)
286 local LAST_ABI=${ALL_ABIS/* /} 337 local LAST_ABI=${ALL_ABIS/* /}
287 [[ ${LAST_ABI} == ${ABI} ]] 338 [[ ${LAST_ABI} == ${ABI} ]]
288} 339}
289 340
341# @FUNCTION: number_abis
342# @DESCRIPTION:
290# echo the number of ABIs we will be installing for 343# echo the number of ABIs we will be installing for
291number_abis() { 344number_abis() {
292 get_install_abis | wc -w 345 get_install_abis | wc -w
293} 346}
294 347
295# get_ml_incdir [<include dir> [<ABI>]] 348# @FUNCTION: get_ml_incdir
349# @USAGE: [include_dir] [ABI]
350# @DESCRIPTION:
296# include dir defaults to /usr/include 351# include dir defaults to /usr/include
297# ABI defaults to ${ABI} or ${DEFAULT_ABI} 352# ABI defaults to ${ABI} or ${DEFAULT_ABI}
353#
354# If a multilib include dir is associated with the passed include dir, then
355# we return it, otherwise, we just echo back the include dir. This is
356# neccessary when a built script greps header files rather than testing them
357# via #include (like perl) to figure out features.
298get_ml_incdir() { 358get_ml_incdir() {
299 local dir=/usr/include 359 local dir=/usr/include
300 360
301 if [[ $# -gt 0 ]]; then 361 if [[ $# -gt 0 ]]; then
302 incdir=$1 362 incdir=$1
319 else 379 else
320 echo ${dir} 380 echo ${dir}
321 fi 381 fi
322} 382}
323 383
324# prep_ml_includes: 384# @FUNCTION: prep_ml_includes
325# 385# @DESCRIPTION:
326# Some includes (include/asm, glibc, etc) are ABI dependent. In this case, 386# Some includes (include/asm, glibc, etc) are ABI dependent. In this case,
327# We can install them in different locations for each ABI and create a common 387# We can install them in different locations for each ABI and create a common
328# header which includes the right one based on CDEFINE_${ABI}. If your 388# header which includes the right one based on CDEFINE_${ABI}. If your
329# package installs ABI-specific headers, just add 'prep_ml_includes' to the 389# package installs ABI-specific headers, just add 'prep_ml_includes' to the
330# end of your src_install(). It takes a list of directories that include 390# end of your src_install(). It takes a list of directories that include
331# files are installed in (default is /usr/include if none are passed). 391# files are installed in (default is /usr/include if none are passed).
332# 392#
333# Example: 393# Example:
334# src_install() { 394# src_install() {
335# ... 395# ...
336# prep_ml_includes /usr/qt/3/include 396# prep_ml_includes /usr/qt/3/include
337# } 397# }
338
339prep_ml_includes() { 398prep_ml_includes() {
340 if [[ $(number_abis) -gt 1 ]] ; then 399 if [[ $(number_abis) -gt 1 ]] ; then
341 local dir 400 local dir
342 local dirs 401 local dirs
343 local base 402 local base
374 done 433 done
375 fi 434 fi
376 fi 435 fi
377} 436}
378 437
438# @FUNCTION: create_ml_includes
439# @USAGE: <include_dir> <symbol_1>:<dir_1> [<symbol_2>:<dir_2>...]
440# @DESCRIPTION:
379# If you need more control than prep_ml_includes can offer (like linux-headers 441# If you need more control than prep_ml_includes can offer (like linux-headers
380# for the asm-* dirs, then use create_ml_includes. The firs argument is the 442# for the asm-* dirs, then use create_ml_includes. The firs argument is the
381# common dir. The remaining args are of the form <symbol>:<dir> where 443# common dir. The remaining args are of the form <symbol>:<dir> where
382# <symbol> is what is put in the #ifdef for choosing that dir. 444# <symbol> is what is put in the #ifdef for choosing that dir.
383# 445#
384# Ideas for this code came from debian's sparc-linux headers package. 446# Ideas for this code came from debian's sparc-linux headers package.
385# 447#
386# Example: 448# Example:
387# create_ml_includes /usr/include/asm __sparc__:/usr/include/asm-sparc __sparc64__:/usr/include/asm-sparc64 449# create_ml_includes /usr/include/asm __sparc__:/usr/include/asm-sparc __sparc64__:/usr/include/asm-sparc64
388# create_ml_includes /usr/include/asm __i386__:/usr/include/asm-i386 __x86_64__:/usr/include/asm-x86_64 450# create_ml_includes /usr/include/asm __i386__:/usr/include/asm-i386 __x86_64__:/usr/include/asm-x86_64
389# 451#
390# Warning: Be careful with the ordering here. The default ABI has to be the 452# Warning: Be careful with the ordering here. The default ABI has to be the
391# last, because it is always defined (by GCC) 453# last, because it is always defined (by GCC)
392create_ml_includes() { 454create_ml_includes() {
393 local dest=$1 455 local dest=$1
529 echo "Shouldn't be here -- create_ml_includes-sym_for_dir $1 $@" 591 echo "Shouldn't be here -- create_ml_includes-sym_for_dir $1 $@"
530 # exit because we'll likely be called from a subshell 592 # exit because we'll likely be called from a subshell
531 exit 1 593 exit 1
532} 594}
533 595
596# @FUNCTION: get_libname
597# @USAGE: [version]
598# @DESCRIPTION:
599# Returns libname with proper suffix {.so,.dylib} and optionally supplied version
600# for ELF/MACH-O shared objects
601#
602# Example:
603# get_libname libfoo ${PV}
604# Returns: libfoo.so.${PV} (ELF) || libfoo.${PV}.dylib (MACH)
534get_libname() { 605get_libname() {
535 local libname 606 local libname
536 local ver=$1 607 local ver=$1
537 case ${CHOST} in 608 case ${CHOST} in
538 mingw*|*-mingw*) libname="dll";; 609 mingw*|*-mingw*) libname="dll";;
649 export DEFAULT_ABI="default" 720 export DEFAULT_ABI="default"
650 ;; 721 ;;
651 esac 722 esac
652} 723}
653 724
725# @FUNCTION: multilib_toolchain_setup
726# @DESCRIPTION:
654# Hide multilib details here for packages which are forced to be compiled for a 727# Hide multilib details here for packages which are forced to be compiled for a
655# specific ABI when run on another ABI (like x86-specific packages on amd64) 728# specific ABI when run on another ABI (like x86-specific packages on amd64)
656multilib_toolchain_setup() { 729multilib_toolchain_setup() {
657 export ABI=$1 730 export ABI=$1
658 731

Legend:
Removed from v.1.64  
changed lines
  Added in v.1.65

  ViewVC Help
Powered by ViewVC 1.1.20