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

Contents of /eclass/linux-mod.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.75 - (show annotations) (download)
Wed Oct 3 12:53:10 2007 UTC (6 years, 11 months ago) by phreak
Branch: MAIN
Changes since 1.74: +4 -3 lines
kernel related eclasses are maintained by kernel-misc@gentoo.org.

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.74 2007/04/16 19:20:28 vapier 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 automatyed modules.d 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 insinto /etc/modules.d
408 newins ${module_config} ${currm_path//*\/}
409
410 # and install any documentation we might have.
411 [[ -n ${module_docs} ]] && dodoc ${module_docs}
412 done
413 eend 0
414 return 0
415 }
416
417 find_module_params() {
418 debug-print-function ${FUNCNAME} $*
419
420 local matched_offset=0 matched_opts=0 test="${@}" temp_var result
421 local i=0 y=0 z=0
422
423 for((i=0; i<=${#test}; i++))
424 do
425 case ${test:${i}:1} in
426 \() matched_offset[0]=${i};;
427 \:) matched_opts=$((${matched_opts} + 1));
428 matched_offset[${matched_opts}]="${i}";;
429 \)) matched_opts=$((${matched_opts} + 1));
430 matched_offset[${matched_opts}]="${i}";;
431 esac
432 done
433
434 for((i=0; i<=${matched_opts}; i++))
435 do
436 # i = offset were working on
437 # y = last offset
438 # z = current offset - last offset
439 # temp_var = temporary name
440 case ${i} in
441 0) tempvar=${test:0:${matched_offset[0]}};;
442 *) y=$((${matched_offset[$((${i} - 1))]} + 1))
443 z=$((${matched_offset[${i}]} - ${matched_offset[$((${i} - 1))]}));
444 z=$((${z} - 1))
445 tempvar=${test:${y}:${z}};;
446 esac
447
448 case ${i} in
449 0) result="${result} modulename:${tempvar}";;
450 1) result="${result} libdir:${tempvar}";;
451 2) result="${result} srcdir:${tempvar}";;
452 3) result="${result} objdir:${tempvar}";;
453 esac
454 done
455
456 echo ${result}
457 }
458
459 # default ebuild functions
460 # --------------------------------
461
462 linux-mod_pkg_setup() {
463 debug-print-function ${FUNCNAME} $*
464
465 linux-info_pkg_setup;
466 check_kernel_built;
467 strip_modulenames;
468 [[ -n ${MODULE_NAMES} ]] && check_modules_supported
469 set_kvobj;
470 # Commented out with permission from johnm until a fixed version for arches
471 # who intentionally use different kernel and userland compilers can be
472 # introduced - Jason Wever <weeve@gentoo.org>, 23 Oct 2005
473 #check_vermagic;
474 }
475
476 strip_modulenames() {
477 debug-print-function ${FUNCNAME} $*
478
479 local i
480 for i in ${MODULE_IGNORE}; do
481 MODULE_NAMES=${MODULE_NAMES//${i}(*}
482 done
483 }
484
485 linux-mod_src_compile() {
486 debug-print-function ${FUNCNAME} $*
487
488 local modulename libdir srcdir objdir i n myARCH="${ARCH}" myABI="${ABI}"
489 ARCH="$(tc-arch-kernel)"
490 ABI="${KERNEL_ABI}"
491
492 BUILD_TARGETS=${BUILD_TARGETS:-clean module}
493 strip_modulenames;
494 for i in ${MODULE_NAMES}
495 do
496 unset libdir srcdir objdir
497 for n in $(find_module_params ${i})
498 do
499 eval ${n/:*}=${n/*:/}
500 done
501 libdir=${libdir:-misc}
502 srcdir=${srcdir:-${S}}
503 objdir=${objdir:-${srcdir}}
504
505 if [ ! -f "${srcdir}/.built" ];
506 then
507 cd ${srcdir}
508 einfo "Preparing ${modulename} module"
509 if [[ -n ${ECONF_PARAMS} ]]
510 then
511 econf ${ECONF_PARAMS} || \
512 die "Unable to run econf ${ECONF_PARAMS}"
513 fi
514
515 emake HOSTCC="$(tc-getBUILD_CC)" CC="$(get-KERNEL_CC)" LDFLAGS="$(get_abi_LDFLAGS)" \
516 ${BUILD_FIXES} ${BUILD_PARAMS} ${BUILD_TARGETS} \
517 || die "Unable to make ${BUILD_FIXES} ${BUILD_PARAMS} ${BUILD_TARGETS}."
518 touch ${srcdir}/.built
519 cd ${OLDPWD}
520 fi
521 done
522
523 ARCH="${myARCH}"
524 ABI="${myABI}"
525 }
526
527 linux-mod_src_install() {
528 debug-print-function ${FUNCNAME} $*
529
530 local modulename libdir srcdir objdir i n
531
532 strip_modulenames;
533 for i in ${MODULE_NAMES}
534 do
535 unset libdir srcdir objdir
536 for n in $(find_module_params ${i})
537 do
538 eval ${n/:*}=${n/*:/}
539 done
540 libdir=${libdir:-misc}
541 srcdir=${srcdir:-${S}}
542 objdir=${objdir:-${srcdir}}
543
544 einfo "Installing ${modulename} module"
545 cd ${objdir} || die "${objdir} does not exist"
546 insinto /lib/modules/${KV_FULL}/${libdir}
547 doins ${modulename}.${KV_OBJ} || die "doins ${modulename}.${KV_OBJ} failed"
548 cd ${OLDPWD}
549
550 generate_modulesd ${objdir}/${modulename}
551 done
552 }
553
554 linux-mod_pkg_preinst() {
555 debug-print-function ${FUNCNAME} $*
556
557 [ -d ${IMAGE}/lib/modules ] && UPDATE_DEPMOD=true || UPDATE_DEPMOD=false
558 [ -d ${IMAGE}/etc/modules.d ] && UPDATE_MODULES=true || UPDATE_MODULES=false
559 [ -d ${IMAGE}/lib/modules ] && UPDATE_MODULEDB=true || UPDATE_MODULEDB=false
560 }
561
562 linux-mod_pkg_postinst() {
563 debug-print-function ${FUNCNAME} $*
564
565 ${UPDATE_DEPMOD} && update_depmod;
566 ${UPDATE_MODULES} && update_modules;
567 ${UPDATE_MODULEDB} && update_moduledb;
568 }
569
570 linux-mod_pkg_postrm() {
571 debug-print-function ${FUNCNAME} $*
572 remove_moduledb;
573 }

  ViewVC Help
Powered by ViewVC 1.1.20