/[gentoo-x86]/eclass/linux-mod.eclass
Gentoo

Contents of /eclass/linux-mod.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.81 - (show annotations) (download)
Thu Apr 3 16:11:24 2008 UTC (6 years, 8 months ago) by cardoe
Branch: MAIN
Changes since 1.80: +2 -2 lines
fix if that was missing then

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/linux-mod.eclass,v 1.80 2008/04/03 14:58:59 genstef Exp $
4
5 # Description: This eclass is used to interface with linux-info in such a way
6 # to provide the functionality required and initial functions
7 # required to install external modules against a kernel source
8 # tree.
9 #
10 # Author(s): John Mylchreest <johnm@gentoo.org>,
11 # Stefan Schweizer <genstef@gentoo.org>
12 # Maintainer: kernel-misc@gentoo.org
13 #
14 # Please direct your bugs to the current eclass maintainer :)
15
16 # A Couple of env vars are available to effect usage of this eclass
17 # These are as follows:
18 #
19 # Env Var Option Default Description
20 # KERNEL_DIR <string> /usr/src/linux The directory containing kernel
21 # the target kernel sources.
22 # ECONF_PARAMS <string> The parameters to pass to econf.
23 # If this is not set, then econf
24 # isn't run.
25 # BUILD_PARAMS <string> The parameters to pass to emake.
26 # BUILD_TARGETS <string> clean modules The build targets to pass to
27 # make.
28 # MODULE_NAMES <string> This is the modules which are
29 # to be built automatically using
30 # the default pkg_compile/install.
31 # They are explained properly
32 # below. It will only make
33 # BUILD_TARGETS once in any
34 # directory.
35
36 # MODULE_NAMES - Detailed Overview
37 #
38 # The structure of each MODULE_NAMES entry is as follows:
39 # modulename(libdir:srcdir:objdir)
40 # for example:
41 # MODULE_NAMES="module_pci(pci:${S}/pci:${S}) module_usb(usb:${S}/usb:${S})"
42 #
43 # what this would do is
44 # cd ${S}/pci
45 # make ${BUILD_PARAMS} ${BUILD_TARGETS}
46 # cd ${S}
47 # insinto /lib/modules/${KV_FULL}/pci
48 # doins module_pci.${KV_OBJ}
49 #
50 # cd ${S}/usb
51 # make ${BUILD_PARAMS} ${BUILD_TARGETS}
52 # cd ${S}
53 # insinto /lib/modules/${KV_FULL}/usb
54 # doins module_usb.${KV_OBJ}
55 #
56 # if the srcdir isnt specified, it assumes ${S}
57 # if the libdir isnt specified, it assumes misc.
58 # if the objdir isnt specified, it assumes srcdir
59
60 # There is also support for automated modprobe.d/modules.d(2.4) file generation.
61 # This can be explicitly enabled by setting any of the following variables.
62 #
63 #
64 # MODULESD_${modulename}_ENABLED This enables the modules.d file
65 # generation even if we dont
66 # specify any additional info.
67 # MODULESD_${modulename}_EXAMPLES This is a bash array containing
68 # a list of examples which should
69 # be used. If you want us to try and
70 # take a guess. Set this to "guess"
71 # MODULESD_${modulename}_ALIASES This is a bash array containing
72 # a list of associated aliases.
73 # MODULESD_${modulename}_ADDITIONS This is a bash array containing
74 # A list of additional things to
75 # add to the bottom of the file.
76 # This can be absolutely anything.
77 # Each entry is a new line.
78 # MODULES_${modulename}_DOCS This is a string list which contains
79 # the full path to any associated
80 # documents for $modulename
81
82 # The order of these is important as both of linux-info and eutils contain
83 # set_arch_to_kernel and set_arch_to_portage functions and the ones in eutils
84 # are deprecated in favor of the ones in linux-info.
85 # See http://bugs.gentoo.org/show_bug.cgi?id=127506
86
87 inherit eutils linux-info multilib
88 EXPORT_FUNCTIONS pkg_setup pkg_preinst pkg_postinst src_install src_compile pkg_postrm
89
90 IUSE="kernel_linux"
91 SLOT="0"
92 DESCRIPTION="Based on the $ECLASS eclass"
93 RDEPEND="kernel_linux? ( virtual/modutils )"
94 DEPEND="${RDEPEND}
95 sys-apps/sed"
96
97 # eclass utilities
98 # ----------------------------------
99
100 check_vermagic() {
101 debug-print-function ${FUNCNAME} $*
102
103 local curr_gcc_ver=$(gcc -dumpversion)
104 local tmpfile old_chost old_gcc_ver result=0
105
106 tmpfile=`find ${KV_DIR}/ -iname "*.o.cmd" -exec grep usr/lib/gcc {} \; -quit`
107 tmpfile=${tmpfile//*usr/lib}
108 tmpfile=${tmpfile//\/include*}
109 old_chost=${tmpfile//*gcc\/}
110 old_chost=${old_chost//\/*}
111 old_gcc_ver=${tmpfile//*\/}
112
113 if [[ -z ${old_gcc_ver} || -z ${old_chost} ]]; then
114 ewarn ""
115 ewarn "Unable to detect what version of GCC was used to compile"
116 ewarn "the kernel. Build will continue, but you may experience problems."
117 elif [[ ${curr_gcc_ver} != ${old_gcc_ver} ]]; then
118 ewarn ""
119 ewarn "The version of GCC you are using (${curr_gcc_ver}) does"
120 ewarn "not match the version of GCC used to compile the"
121 ewarn "kernel (${old_gcc_ver})."
122 result=1
123 elif [[ ${CHOST} != ${old_chost} ]]; then
124 ewarn ""
125 ewarn "The current CHOST (${CHOST}) does not match the chost"
126 ewarn "used when compiling the kernel (${old_chost})."
127 result=1
128 fi
129
130 if [[ ${result} -gt 0 ]]; then
131 ewarn ""
132 ewarn "Build will not continue, because you will experience problems."
133 ewarn "To fix this either change the version of GCC you wish to use"
134 ewarn "to match the kernel, or recompile the kernel first."
135 die "GCC Version Mismatch."
136 fi
137 }
138
139 use_m() {
140 debug-print-function ${FUNCNAME} $*
141
142 # if we haven't determined the version yet, we need too.
143 get_version;
144
145 # if the kernel version is greater than 2.6.6 then we should use
146 # M= instead of SUBDIRS=
147 [ ${KV_MAJOR} -eq 2 -a ${KV_MINOR} -gt 5 -a ${KV_PATCH} -gt 5 ] && \
148 return 0 || return 1
149 }
150
151 convert_to_m() {
152 debug-print-function ${FUNCNAME} $*
153
154 if use_m
155 then
156 [ ! -f "${1}" ] && \
157 die "convert_to_m() requires a filename as an argument"
158 ebegin "Converting ${1/${WORKDIR}\//} to use M= instead of SUBDIRS="
159 sed -i 's:SUBDIRS=:M=:g' ${1}
160 eend $?
161 fi
162 }
163
164 update_depmod() {
165 debug-print-function ${FUNCNAME} $*
166
167 # if we haven't determined the version yet, we need too.
168 get_version;
169
170 ebegin "Updating module dependencies for ${KV_FULL}"
171 if [ -r ${KV_OUT_DIR}/System.map ]
172 then
173 depmod -ae -F ${KV_OUT_DIR}/System.map -b ${ROOT} -r ${KV_FULL}
174 eend $?
175 else
176 ewarn
177 ewarn "${KV_OUT_DIR}/System.map not found."
178 ewarn "You must manually update the kernel module dependencies using depmod."
179 eend 1
180 ewarn
181 fi
182 }
183
184 update_modules() {
185 debug-print-function ${FUNCNAME} $*
186
187 if [ -x /sbin/update-modules ] && \
188 grep -v -e "^#" -e "^$" ${D}/etc/modules.d/* >/dev/null 2>&1; then
189 ebegin "Updating modules.conf"
190 /sbin/update-modules
191 eend $?
192 elif [ -x /sbin/update-modules ] && \
193 grep -v -e "^#" -e "^$" ${D}/etc/modules.d/* >/dev/null 2>&1; then
194 ebegin "Updating modules.conf"
195 /sbin/update-modules
196 eend $?
197 fi
198 }
199
200 move_old_moduledb() {
201 debug-print-function ${FUNCNAME} $*
202
203 local OLDDIR=${ROOT}/usr/share/module-rebuild/
204 local NEWDIR=${ROOT}/var/lib/module-rebuild/
205
206 if [[ -f ${OLDDIR}/moduledb ]]; then
207 [[ ! -d ${NEWDIR} ]] && mkdir -p ${NEWDIR}
208 [[ ! -f ${NEWDIR}/moduledb ]] && \
209 mv ${OLDDIR}/moduledb ${NEWDIR}/moduledb
210 rm -f ${OLDDIR}/*
211 rmdir ${OLDDIR}
212 fi
213 }
214
215 update_moduledb() {
216 debug-print-function ${FUNCNAME} $*
217
218 local MODULEDB_DIR=${ROOT}/var/lib/module-rebuild/
219 move_old_moduledb
220
221 if [[ ! -f ${MODULEDB_DIR}/moduledb ]]; then
222 [[ ! -d ${MODULEDB_DIR} ]] && mkdir -p ${MODULEDB_DIR}
223 touch ${MODULEDB_DIR}/moduledb
224 fi
225
226 if ! grep -qs ${CATEGORY}/${PN}-${PVR} ${MODULEDB_DIR}/moduledb ; then
227 einfo "Adding module to moduledb."
228 echo "a:1:${CATEGORY}/${PN}-${PVR}" >> ${MODULEDB_DIR}/moduledb
229 fi
230 }
231
232 remove_moduledb() {
233 debug-print-function ${FUNCNAME} $*
234
235 local MODULEDB_DIR=${ROOT}/var/lib/module-rebuild/
236 move_old_moduledb
237
238 if grep -qs ${CATEGORY}/${PN}-${PVR} ${MODULEDB_DIR}/moduledb ; then
239 einfo "Removing ${CATEGORY}/${PN}-${PVR} from moduledb."
240 sed -i -e "/.*${CATEGORY}\/${PN}-${PVR}.*/d" ${MODULEDB_DIR}/moduledb
241 fi
242 }
243
244 set_kvobj() {
245 debug-print-function ${FUNCNAME} $*
246
247 if kernel_is 2 6
248 then
249 KV_OBJ="ko"
250 else
251 KV_OBJ="o"
252 fi
253 # Do we really need to know this?
254 # Lets silence it.
255 # einfo "Using KV_OBJ=${KV_OBJ}"
256 }
257
258 get-KERNEL_CC() {
259 debug-print-function ${FUNCNAME} $*
260
261 local kernel_cc
262 if [ -n "${KERNEL_ABI}" ]; then
263 # In future, an arch might want to define CC_$ABI
264 #kernel_cc="$(get_abi_CC)"
265 #[ -z "${kernel_cc}" ] &&
266 kernel_cc="$(tc-getCC $(ABI=${KERNEL_ABI} get_abi_CHOST))"
267 else
268 kernel_cc=$(tc-getCC)
269 fi
270 echo "${kernel_cc}"
271 }
272
273 generate_modulesd() {
274 debug-print-function ${FUNCNAME} $*
275
276 # This function will generate the neccessary modules.d file from the
277 # information contained in the modules exported parms
278
279 local currm_path currm currm_t t myIFS myVAR
280 local module_docs module_enabled module_aliases \
281 module_additions module_examples module_modinfo module_opts
282
283 for currm_path in ${@}
284 do
285 currm=${currm_path//*\/}
286 currm=$(echo ${currm} | tr '[:lower:]' '[:upper:]')
287 currm_t=${currm}
288 while [[ -z ${currm_t//*-*} ]]; do
289 currm_t=${currm_t/-/_}
290 done
291
292 module_docs="$(eval echo \${MODULESD_${currm_t}_DOCS})"
293 module_enabled="$(eval echo \${MODULESD_${currm_t}_ENABLED})"
294 module_aliases="$(eval echo \${#MODULESD_${currm_t}_ALIASES[*]})"
295 module_additions="$(eval echo \${#MODULESD_${currm_t}_ADDITIONS[*]})"
296 module_examples="$(eval echo \${#MODULESD_${currm_t}_EXAMPLES[*]})"
297
298 [[ ${module_aliases} -eq 0 ]] && unset module_aliases
299 [[ ${module_additions} -eq 0 ]] && unset module_additions
300 [[ ${module_examples} -eq 0 ]] && unset module_examples
301
302 # If we specify we dont want it, then lets exit, otherwise we assume
303 # that if its set, we do want it.
304 [[ ${module_enabled} == no ]] && return 0
305
306 # unset any unwanted variables.
307 for t in ${!module_*}
308 do
309 [[ -z ${!t} ]] && unset ${t}
310 done
311
312 [[ -z ${!module_*} ]] && return 0
313
314 # OK so now if we have got this far, then we know we want to continue
315 # and generate the modules.d file.
316 module_modinfo="$(modinfo -p ${currm_path}.${KV_OBJ})"
317 module_config="${T}/modulesd-${currm}"
318
319 ebegin "Preparing file for modules.d"
320 #-----------------------------------------------------------------------
321 echo "# modules.d configuration file for ${currm}" >> ${module_config}
322 #-----------------------------------------------------------------------
323 [[ -n ${module_docs} ]] && \
324 echo "# For more information please read:" >> ${module_config}
325 for t in ${module_docs}
326 do
327 echo "# ${t//*\/}" >> ${module_config}
328 done
329 echo >> ${module_config}
330
331 #-----------------------------------------------------------------------
332 if [[ ${module_aliases} -gt 0 ]]
333 then
334 echo "# Internal Aliases - Do not edit" >> ${module_config}
335 echo "# ------------------------------" >> ${module_config}
336
337 for((t=0; t<${module_aliases}; t++))
338 do
339 echo "alias $(eval echo \${MODULESD_${currm}_ALIASES[$t]})" \
340 >> ${module_config}
341 done
342 echo '' >> ${module_config}
343 fi
344
345 #-----------------------------------------------------------------------
346 if [[ -n ${module_modinfo} ]]
347 then
348 echo >> ${module_config}
349 echo "# Configurable module parameters" >> ${module_config}
350 echo "# ------------------------------" >> ${module_config}
351 myIFS="${IFS}"
352 IFS="$(echo -en "\n\b")"
353
354 for t in ${module_modinfo}
355 do
356 myVAR="$(echo ${t#*:} | grep -e " [0-9][ =]" | sed "s:.*\([01][= ]\).*:\1:")"
357 if [[ -n ${myVAR} ]]
358 then
359 module_opts="${module_opts} ${t%%:*}:${myVAR}"
360 fi
361 echo -e "# ${t%%:*}:\t${t#*:}" >> ${module_config}
362 done
363 IFS="${myIFS}"
364 echo '' >> ${module_config}
365 fi
366
367 #-----------------------------------------------------------------------
368 if [[ $(eval echo \${MODULESD_${currm}_ALIASES[0]}) == guess ]]
369 then
370 # So lets do some guesswork eh?
371 if [[ -n ${module_opts} ]]
372 then
373 echo "# For Example..." >> ${module_config}
374 echo "# --------------" >> ${module_config}
375 for t in ${module_opts}
376 do
377 echo "# options ${currm} ${t//:*}=${t//*:}" >> ${module_config}
378 done
379 echo '' >> ${module_config}
380 fi
381 elif [[ ${module_examples} -gt 0 ]]
382 then
383 echo "# For Example..." >> ${module_config}
384 echo "# --------------" >> ${module_config}
385 for((t=0; t<${module_examples}; t++))
386 do
387 echo "options $(eval echo \${MODULESD_${currm}_EXAMPLES[$t]})" \
388 >> ${module_config}
389 done
390 echo '' >> ${module_config}
391 fi
392
393 #-----------------------------------------------------------------------
394 if [[ ${module_additions} -gt 0 ]]
395 then
396 for((t=0; t<${module_additions}; t++))
397 do
398 echo "$(eval echo \${MODULESD_${currm}_ADDITIONS[$t]})" \
399 >> ${module_config}
400 done
401 echo '' >> ${module_config}
402 fi
403
404 #-----------------------------------------------------------------------
405
406 # then we install it
407 if kernel_is ge 2 6; then
408 insinto /etc/modprobe.d
409 else
410 insinto /etc/modules.d
411 fi
412 newins ${module_config} ${currm_path//*\/}
413
414 # and install any documentation we might have.
415 [[ -n ${module_docs} ]] && dodoc ${module_docs}
416 done
417 eend 0
418 return 0
419 }
420
421 find_module_params() {
422 debug-print-function ${FUNCNAME} $*
423
424 local matched_offset=0 matched_opts=0 test="${@}" temp_var result
425 local i=0 y=0 z=0
426
427 for((i=0; i<=${#test}; i++))
428 do
429 case ${test:${i}:1} in
430 \() matched_offset[0]=${i};;
431 \:) matched_opts=$((${matched_opts} + 1));
432 matched_offset[${matched_opts}]="${i}";;
433 \)) matched_opts=$((${matched_opts} + 1));
434 matched_offset[${matched_opts}]="${i}";;
435 esac
436 done
437
438 for((i=0; i<=${matched_opts}; i++))
439 do
440 # i = offset were working on
441 # y = last offset
442 # z = current offset - last offset
443 # temp_var = temporary name
444 case ${i} in
445 0) tempvar=${test:0:${matched_offset[0]}};;
446 *) y=$((${matched_offset[$((${i} - 1))]} + 1))
447 z=$((${matched_offset[${i}]} - ${matched_offset[$((${i} - 1))]}));
448 z=$((${z} - 1))
449 tempvar=${test:${y}:${z}};;
450 esac
451
452 case ${i} in
453 0) result="${result} modulename:${tempvar}";;
454 1) result="${result} libdir:${tempvar}";;
455 2) result="${result} srcdir:${tempvar}";;
456 3) result="${result} objdir:${tempvar}";;
457 esac
458 done
459
460 echo ${result}
461 }
462
463 # default ebuild functions
464 # --------------------------------
465
466 linux-mod_pkg_setup() {
467 debug-print-function ${FUNCNAME} $*
468
469 linux-info_pkg_setup;
470 require_configured_kernel
471 check_kernel_built;
472 strip_modulenames;
473 [[ -n ${MODULE_NAMES} ]] && check_modules_supported
474 set_kvobj;
475 # Commented out with permission from johnm until a fixed version for arches
476 # who intentionally use different kernel and userland compilers can be
477 # introduced - Jason Wever <weeve@gentoo.org>, 23 Oct 2005
478 #check_vermagic;
479 }
480
481 strip_modulenames() {
482 debug-print-function ${FUNCNAME} $*
483
484 local i
485 for i in ${MODULE_IGNORE}; do
486 MODULE_NAMES=${MODULE_NAMES//${i}(*}
487 done
488 }
489
490 linux-mod_src_compile() {
491 debug-print-function ${FUNCNAME} $*
492
493 local modulename libdir srcdir objdir i n myARCH="${ARCH}" myABI="${ABI}"
494 ARCH="$(tc-arch-kernel)"
495 ABI="${KERNEL_ABI}"
496
497 BUILD_TARGETS=${BUILD_TARGETS:-clean module}
498 strip_modulenames;
499 cd "${S}"
500 for i in ${MODULE_NAMES}
501 do
502 unset libdir srcdir objdir
503 for n in $(find_module_params ${i})
504 do
505 eval ${n/:*}=${n/*:/}
506 done
507 libdir=${libdir:-misc}
508 srcdir=${srcdir:-${S}}
509 objdir=${objdir:-${srcdir}}
510
511 if [ ! -f "${srcdir}/.built" ];
512 then
513 cd ${srcdir}
514 einfo "Preparing ${modulename} module"
515 if [[ -n ${ECONF_PARAMS} ]]
516 then
517 econf ${ECONF_PARAMS} || \
518 die "Unable to run econf ${ECONF_PARAMS}"
519 fi
520
521 # This looks messy, but it is needed to handle multiple variables
522 # being passed in the BUILD_* stuff where the variables also have
523 # spaces that must be preserved. If don't do this, then the stuff
524 # inside the variables gets used as targets for Make, which then
525 # fails.
526 eval "emake HOSTCC=\"$(tc-getBUILD_CC)\" \
527 CC=\"$(get-KERNEL_CC)\" \
528 LDFLAGS=\"$(get_abi_LDFLAGS)\" \
529 ${BUILD_FIXES} \
530 ${BUILD_PARAMS} \
531 ${BUILD_TARGETS} " \
532 || die "Unable to emake HOSTCC="$(tc-getBUILD_CC)" CC="$(get-KERNEL_CC)" LDFLAGS="$(get_abi_LDFLAGS)" ${BUILD_FIXES} ${BUILD_PARAMS} ${BUILD_TARGETS}"
533 touch ${srcdir}/.built
534 cd ${OLDPWD}
535 fi
536 done
537
538 ARCH="${myARCH}"
539 ABI="${myABI}"
540 }
541
542 linux-mod_src_install() {
543 debug-print-function ${FUNCNAME} $*
544
545 local modulename libdir srcdir objdir i n
546
547 strip_modulenames;
548 for i in ${MODULE_NAMES}
549 do
550 unset libdir srcdir objdir
551 for n in $(find_module_params ${i})
552 do
553 eval ${n/:*}=${n/*:/}
554 done
555 libdir=${libdir:-misc}
556 srcdir=${srcdir:-${S}}
557 objdir=${objdir:-${srcdir}}
558
559 einfo "Installing ${modulename} module"
560 cd ${objdir} || die "${objdir} does not exist"
561 insinto /lib/modules/${KV_FULL}/${libdir}
562 doins ${modulename}.${KV_OBJ} || die "doins ${modulename}.${KV_OBJ} failed"
563 cd ${OLDPWD}
564
565 generate_modulesd ${objdir}/${modulename}
566 done
567 }
568
569 linux-mod_pkg_preinst() {
570 debug-print-function ${FUNCNAME} $*
571
572 [ -d "${D}lib/modules" ] && UPDATE_DEPMOD=true || UPDATE_DEPMOD=false
573 [ -d "${D}etc/modules.d" ] && UPDATE_MODULES=true || UPDATE_MODULES=false
574 [ -d "${D}lib/modules" ] && UPDATE_MODULEDB=true || UPDATE_MODULEDB=false
575 }
576
577 linux-mod_pkg_postinst() {
578 debug-print-function ${FUNCNAME} $*
579
580 ${UPDATE_DEPMOD} && update_depmod;
581 ${UPDATE_MODULES} && update_modules;
582 ${UPDATE_MODULEDB} && update_moduledb;
583 }
584
585 linux-mod_pkg_postrm() {
586 debug-print-function ${FUNCNAME} $*
587 remove_moduledb;
588 }

  ViewVC Help
Powered by ViewVC 1.1.20