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

Contents of /eclass/multilib.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.14 - (show annotations) (download)
Tue Jan 18 04:56:03 2005 UTC (9 years, 8 months ago) by eradicator
Branch: MAIN
Changes since 1.13: +80 -3 lines
Added has_multilib_profile and documentation near the top.

1 # Copyright 1999-2004 Gentoo Foundation
2 # Distributed under the terms of the GNU General Public License v2
3 # $Header: /var/cvsroot/gentoo-x86/eclass/multilib.eclass,v 1.13 2005/01/17 04:20:55 eradicator Exp $
4 #
5 # Author: Jeremy Huddleston <eradicator@gentoo.org>
6 #
7 # This eclass is for all functions pertaining to handling multilib.
8 # configurations.
9
10 ECLASS=multilib
11 INHERITED="$INHERITED $ECLASS"
12
13 DESCRIPTION="Based on the ${ECLASS} eclass"
14
15 # has_multilib_profile:
16 # Return true if the current profile is a multilib profile. You might
17 # want to use this like 'use multilib || has_multilib_profile' until
18 # all profiles utilizing the 'multilib' use flag are removed from portage
19
20 # is_final_abi:
21 # Return true if ${ABI} is the final abi to be installed (and thus we are
22 # on our last run through a src_* function.
23
24 # number_abis:
25 # echo the number of ABIs we will be installing for
26
27 # get_abi_order:
28 # Return a list of the ABIs we want to install for with
29 # the last one in the list being the default.
30
31 # get_all_libdir:
32 # Returns a list of all the libdirs used by this profile. This includes
33 # those that might not be touched by the current ebuild and always includes
34 # "lib".
35
36 # get_libdir:
37 # Returns the libdir for the selected ABI. This is backwards compatible
38 # and simply calls get_abi_LIBDIR() on newer profiles. You should use this
39 # to determine where to install shared objects (ex: /usr/$(get_libdir))
40
41 # get_abi_var <VAR> [<ABI>]:
42 # returns the value of ${<VAR>_<ABI>} which should be set in make.defaults
43 #
44 # get_abi_CFLAGS:
45 # get_abi_CDEFINE:
46 # get_abi_LIBDIR:
47 # Aliases for 'get_abi_var CFLAGS', etc.
48
49 # get_ml_incdir [<include dir> [<ABI>]]
50 # include dir defaults to /usr/include
51 # ABI defaults to ${ABI} or ${DEFAULT_ABI}
52 #
53 # If a multilib include dir is associated with the passed include dir, then
54 # we return it, otherwise, we just echo back the include dir. This is
55 # neccessary when a built script greps header files rather than testing them
56 # via #include (like perl) to figure out features.
57
58 # prep_ml_includes:
59 # Some includes (include/asm, glibc, etc) are ABI dependent. In this case,
60 # We can install them in different locations for each ABI and create a common
61 # header which includes the right one based on CDEFINE_${ABI}. If your
62 # package installs ABI-specific headers, just add 'prep_ml_includes' to the
63 # end of your src_install(). It takes a list of directories that include
64 # files are installed in (default is /usr/include if none are passed).
65 #
66 # Example:
67 # src_install() {
68 # ...
69 # prep_ml_includes /usr/qt/3/include
70 # }
71
72 # create_ml_includes <include dir> <symbol 1>:<dir 1> [<symbol 2>:<dir 2> ...]
73 # If you need more control than prep_ml_includes can offer (like linux-headers
74 # for the asm-* dirs, then use create_ml_includes. The firs argument is the
75 # common dir. The remaining args are of the form <symbol>:<dir> where
76 # <symbol> is what is put in the #ifdef for choosing that dir.
77 #
78 # Ideas for this code came from debian's sparc-linux headers package.
79 #
80 # Example:
81 # create_ml_includes /usr/include/asm __sparc__:/usr/include/asm-sparc __sparc64__:/usr/include/asm-sparc64
82 # create_ml_includes /usr/include/asm __i386__:/usr/include/asm-i386 __x86_64__:/usr/include/asm-x86_64
83
84 ### END DOCUMENTATION ###
85
86 # has_multilib_profile()
87 # Return true if
88 has_multilib_profile() {
89 [ -n "${MULTILIB_ABIS}" ]
90 }
91
92 # This function simply returns the desired lib directory. With portage
93 # 2.0.51, we now have support for installing libraries to lib32/lib64
94 # to accomidate the needs of multilib systems. It's no longer a good idea
95 # to assume all libraries will end up in lib. Replace any (sane) instances
96 # where lib is named directly with $(get_libdir) if possible.
97 #
98 # Travis Tilley <lv@gentoo.org> (24 Aug 2004)
99 #
100 # Jeremy Huddleston <eradicator@gentoo.org> (23 Dec 2004):
101 # Added support for ${ABI} and ${DEFAULT_ABI}. If they're both not set,
102 # fall back on old behavior. Any profile that has these set should also
103 # depend on a newer version of portage (not yet released) which uses these
104 # over CONF_LIBDIR in econf, dolib, etc...
105 get_libdir() {
106 LIBDIR_TEST=$(type econf)
107 if [ ! -z "${CONF_LIBDIR_OVERRIDE}" ] ; then
108 # if there is an override, we want to use that... always.
109 CONF_LIBDIR="${CONF_LIBDIR_OVERRIDE}"
110 elif [ -n "$(get_abi_LIBDIR)" ]; then
111 CONF_LIBDIR="$(get_abi_LIBDIR)"
112 elif [ "${LIBDIR_TEST/CONF_LIBDIR}" == "${LIBDIR_TEST}" ]; then # we don't have CONF_LIBDIR support
113 # will be <portage-2.0.51_pre20
114 CONF_LIBDIR="lib"
115 fi
116 # and of course, default to lib if CONF_LIBDIR isnt set
117 echo ${CONF_LIBDIR:=lib}
118 unset LIBDIR_TEST
119 }
120
121 get_multilibdir() {
122 if [ -n "$(get_abi_LIBDIR)" ]; then
123 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"
124 exit 1
125 fi
126 echo ${CONF_MULTILIBDIR:=lib32}
127 }
128
129 # Sometimes you need to override the value returned by get_libdir. A good
130 # example of this is xorg-x11, where lib32 isnt a supported configuration,
131 # and where lib64 -must- be used on amd64 (for applications that need lib
132 # to be 32bit, such as adobe acrobat). Note that this override also bypasses
133 # portage version sanity checking.
134 # get_libdir_override expects one argument, the result get_libdir should
135 # return:
136 #
137 # get_libdir_override lib64
138 #
139 # Travis Tilley <lv@gentoo.org> (31 Aug 2004)
140 get_libdir_override() {
141 if [ -n "$(get_abi_LIBDIR)" ]; then
142 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"
143 exit 1
144 fi
145 CONF_LIBDIR="$1"
146 CONF_LIBDIR_OVERRIDE="$1"
147 }
148
149 # get_abi_var <VAR> [<ABI>]
150 # returns the value of ${<VAR>_<ABI>} which should be set in make.defaults
151 #
152 # ex:
153 # CFLAGS=$(get_abi_var CFLAGS sparc32) # CFLAGS=-m32
154 #
155 # Note that the prefered method is to set CC="$(tc-getCC) $(get_abi_CFLAGS)"
156 # This will hopefully be added to portage soon...
157 #
158 # If <ABI> is not specified, ${ABI} is used.
159 # If <ABI> is not specified and ${ABI} is not defined, ${DEFAULT_ABI} is used.
160 # If <ABI> is not specified and ${ABI} and ${DEFAULT_ABI} are not defined, we return an empty string.
161 #
162 # Jeremy Huddleston <eradicator@gentoo.org>
163 get_abi_var() {
164 local flag=${1}
165 local abi
166 if [ $# -gt 1 ]; then
167 abi=${2}
168 elif [ -n "${ABI}" ]; then
169 abi=${ABI}
170 elif [ -n "${DEFAULT_ABI}" ]; then
171 abi=${DEFAULT_ABI}
172 else
173 return 1
174 fi
175
176 local var="${flag}_${abi}"
177 echo ${!var}
178 }
179
180 get_abi_CFLAGS() { get_abi_var CFLAGS ${@}; }
181 get_abi_CDEFINE() { get_abi_var CDEFINE ${@}; }
182 get_abi_LIBDIR() { get_abi_var LIBDIR ${@}; }
183
184 # Return a list of the ABIs we want to install for with
185 # the last one in the list being the default.
186 get_abi_order() {
187 local order=""
188
189 if [ -z "${MULTILIB_ABIS}" ]; then
190 echo "NOMULTILIB"
191 return 1
192 fi
193
194 if hasq multilib-pkg-force ${RESTRICT} ||
195 { hasq multilib-pkg ${FEATURES} && hasq multilib-pkg ${RESTRICT}; }; then
196 for x in ${MULTILIB_ABIS}; do
197 if [ "${x}" != "${DEFAULT_ABI}" ]; then
198 hasq ${x} ${ABI_DENY} || ordera="${ordera} ${x}"
199 fi
200 done
201 hasq ${DEFAULT_ABI} ${ABI_DENY} || order="${ordera} ${DEFAULT_ABI}"
202
203 if [ -n "${ABI_ALLOW}" ]; then
204 local ordera=""
205 for x in ${order}; do
206 if hasq ${x} ${ABI_ALLOW}; then
207 ordera="${ordera} ${x}"
208 fi
209 done
210 order="${ordera}"
211 fi
212 else
213 order="${DEFAULT_ABI}"
214 fi
215
216 if [ -z "${order}" ]; then
217 die "The ABI list is empty. Are you using a proper multilib profile? Perhaps your USE flags or MULTILIB_ABIS are too restrictive for this package."
218 fi
219
220 echo ${order}
221 return 0
222 }
223
224 # get_all_libdir()
225 # Returns a list of all the libdirs used by this profile. This includes
226 # those that might not be touched by the current ebuild.
227 get_all_libdirs() {
228 local libdirs="lib"
229 local abi
230 local dir
231
232 if has_multilib_profile; then
233 for abi in ${MULTILIB_ABIS}; do
234 [ "$(get_abi_LIBDIR ${abi})" != "lib" ] && libdirs="${libdirs} $(get_abi_LIBDIR ${abi})"
235 done
236 elif [ -n "${CONF_LIBDIR}" ]; then
237 for dir in ${CONF_LIBDIR} ${CONF_MULTILIBDIR:=lib32}; do
238 [ "${dir}" != "lib" ] && libdirs="${libdirs} ${dir}"
239 done
240 fi
241
242 echo "${libdirs}"
243 }
244
245 # Return true if ${ABI} is the last ABI on our list (or if we're not
246 # using the new multilib configuration. This can be used to determine
247 # if we're in the last (or only) run through src_{unpack,compile,install}
248 is_final_abi() {
249 ! has_multilib_profile && return 0
250 local ALL_ABIS=$(get_abi_order)
251 local LAST_ABI=${ALL_ABIS/* /}
252 [ "${LAST_ABI}" = "${ABI}" ]
253 }
254
255 # echo the number of ABIs we will be installing for
256 number_abis() {
257 get_abi_order | wc -w
258 }
259
260 # get_ml_incdir [<include dir> [<ABI>]]
261 # include dir defaults to /usr/include
262 # ABI defaults to ${ABI} or ${DEFAULT_ABI}
263 get_ml_incdir() {
264 local dir=/usr/include
265
266 if [[ ${#} -gt 0 ]]; then
267 incdir=${1}
268 shift
269 fi
270
271 if [[ -z "${MULTILIB_ABIS}" ]]; then
272 echo ${incdir}
273 return 0
274 fi
275
276 local abi=${ABI:-${DEFAULT_ABI}}
277 if [[ ${#} -gt 0 ]]; then
278 abi=${1}
279 shift
280 fi
281
282 if [[ -d "${dir}/gentoo-multilib/${abi}" ]]; then
283 echo ${dir}/gentoo-multilib/${abi}
284 else
285 echo ${dir}
286 fi
287 }
288
289 # prep_ml_includes:
290 #
291 # Some includes (include/asm, glibc, etc) are ABI dependent. In this case,
292 # We can install them in different locations for each ABI and create a common
293 # header which includes the right one based on CDEFINE_${ABI}. If your
294 # package installs ABI-specific headers, just add 'prep_ml_includes' to the
295 # end of your src_install(). It takes a list of directories that include
296 # files are installed in (default is /usr/include if none are passed).
297 #
298 # Example:
299 # src_install() {
300 # ...
301 # prep_ml_includes /usr/qt/3/include
302 # }
303
304 prep_ml_includes() {
305 if [ $(number_abis) -gt 1 ]; then
306 local dir
307 local dirs
308 local base
309
310 if [ ${#} -eq 0 ]; then
311 dirs="/usr/include"
312 else
313 dirs="${@}"
314 fi
315
316 for dir in ${dirs}; do
317 base=${T}/gentoo-multilib/${dir}/gentoo-multilib
318 mkdir -p ${base}
319 [ -d ${base}/${ABI} ] && rm -rf ${base}/${ABI}
320 mv ${D}/${dir} ${base}/${ABI}
321 done
322
323 if is_final_abi; then
324 base=${T}/gentoo-multilib
325 pushd ${base}
326 find . | cpio -pmd --no-preserve-owner ${D}
327 popd
328
329 for dir in ${dirs}; do
330 local args=${dir}
331 local abi
332 for abi in $(get_abi_order); do
333 args="${args} $(get_abi_CDEFINE ${abi}):${dir}/gentoo-multilib/${abi}"
334 done
335 create_ml_includes ${args}
336 done
337 fi
338 fi
339 }
340
341 # If you need more control than prep_ml_includes can offer (like linux-headers
342 # for the asm-* dirs, then use create_ml_includes. The firs argument is the
343 # common dir. The remaining args are of the form <symbol>:<dir> where
344 # <symbol> is what is put in the #ifdef for choosing that dir.
345 #
346 # Ideas for this code came from debian's sparc-linux headers package.
347 #
348 # Example:
349 # create_ml_includes /usr/include/asm __sparc__:/usr/include/asm-sparc __sparc64__:/usr/include/asm-sparc64
350 # create_ml_includes /usr/include/asm __i386__:/usr/include/asm-i386 __x86_64__:/usr/include/asm-x86_64
351 create_ml_includes() {
352 local dest="${1}"
353 shift
354 local mlinfo="${@}"
355 local basedirs=$(create_ml_includes-listdirs ${mlinfo})
356
357 create_ml_includes-makedestdirs ${dest} ${basedirs}
358
359 local file
360 for file in $(create_ml_includes-allfiles ${basedirs}); do
361 local name="$(echo $file | tr a-z A-Z | sed 's:[^A-Z]:_:g')"
362 {
363 echo "/* Common header file autogenerated by create_ml_includes in multilib.eclass */"
364 #echo "#ifndef __CREATE_ML_INCLUDES_STUB_${name}__"
365 #echo "#define __CREATE_ML_INCLUDES_STUB_${name}__"
366 #echo ""
367
368 local dir
369 for dir in ${basedirs}; do
370 if [ -f "${D}/${dir}/${file}" ]; then
371 echo "#ifdef $(create_ml_includes-sym_for_dir ${dir} ${mlinfo})"
372 echo "#include \"$(create_ml_includes-relative_between ${dest}/$(dirname ${file}) ${dir}/${file})\""
373 echo "#endif /* $(create_ml_includes-sym_for_dir ${dir} ${mlinfo}) */"
374 echo ""
375 fi
376 done
377
378 #echo "#endif /* __CREATE_ML_INCLUDES_STUB_${name}__ */"
379 } > ${D}/${dest}/${file}
380 done
381 }
382
383 # Helper function for create_ml_includes
384 create_ml_includes-relative_between() {
385 local src="$(create_ml_includes-tidy_path ${1})"
386 local dst="$(create_ml_includes-tidy_path ${2})"
387
388 src=(${src//\// })
389 dst=(${dst//\// })
390
391 local i
392 for ((i=0; i<${#src[*]}; i++)); do
393 [ "${dst[i]}" != "${src[i]}" ] && break
394 done
395
396 local common=$i
397
398 for ((i=${#src[*]}; i>common; i--)); do
399 echo -n ../
400 done
401
402 for ((i=common; i<${#dst[*]}-1; i++)); do
403 echo -n ${dst[i]}/
404 done
405
406 echo -n ${dst[i]}
407 }
408
409 # Helper function for create_ml_includes
410 create_ml_includes-tidy_path() {
411 local removed="${1}"
412
413 if [ -n "${removed}" ]; then
414 # Remove multiple slashes
415 while [ "${removed}" != "${removed/\/\//\/}" ]; do
416 removed=${removed/\/\//\/}
417 done
418
419 # Remove . directories
420 while [ "${removed}" != "${removed//\/.\//\/}" ]; do
421 removed=${removed//\/.\//\/}
422 done
423 [ "${removed##*/}" = "." ] && removed=${removed%/*}
424
425 # Removed .. directories
426 while [ "${removed}" != "${removed//\/..\/}" ]; do
427 local p1="${removed%%\/..\/*}"
428 local p2="${removed#*\/..\/}"
429
430 removed="${p1%\/*}/${p2}"
431 done
432
433 # Remove trailing ..
434 [ "${removed##*/}" = ".." ] && removed=${removed%/*/*}
435
436 # Remove trailing /
437 [ "${removed##*/}" = "" ] && removed=${removed%/*}
438
439 echo ${removed}
440 fi
441 }
442
443 # Helper function for create_ml_includes
444 create_ml_includes-listdirs() {
445 local dirs
446 local data
447 for data in ${@}; do
448 dirs="${dirs} ${data/*:/}"
449 done
450 echo ${dirs:1}
451 }
452
453 # Helper function for create_ml_includes
454 create_ml_includes-makedestdirs() {
455 local dest=${1}
456 shift
457 local basedirs=${@}
458
459 dodir ${dest}
460
461 local basedir
462 for basedir in ${basedirs}; do
463 local dir
464 for dir in $(find ${D}/${basedir} -type d); do
465 dodir ${dest}/${dir/${D}\/${basedir}/}
466 done
467 done
468 }
469
470 # Helper function for create_ml_includes
471 create_ml_includes-allfiles() {
472 local basedirs=${@}
473
474 local basedir
475 for basedir in ${basedirs}; do
476 local file
477 for file in $(find ${D}/${basedir} -type f); do
478 echo ${file/${D}\/${basedir}\//}
479 done
480 done | sort | uniq
481 }
482
483 # Helper function for create_ml_includes
484 create_ml_includes-sym_for_dir() {
485 local dir="${1}"
486 shift
487 local data
488 for data in ${@}; do
489 if [ "${dir}" = "${data/*:/}" ]; then
490 echo ${data/:*/}
491 return 0
492 fi
493 done
494 echo "Shouldn't be here -- create_ml_includes-sym_for_dir ${1} ${@}"
495 # exit because we'll likely be called from a subshell
496 exit 1
497 }

  ViewVC Help
Powered by ViewVC 1.1.20