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

Diff of /eclass/linux-mod.eclass

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

Revision 1.85 Revision 1.100
1# Copyright 1999-2004 Gentoo Foundation 1# Copyright 1999-2011 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/linux-mod.eclass,v 1.85 2008/10/31 21:25:56 dsd Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/linux-mod.eclass,v 1.100 2011/04/24 18:55:20 ulm Exp $
4 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>, 5# Author(s): John Mylchreest <johnm@gentoo.org>,
11# Stefan Schweizer <genstef@gentoo.org> 6# Stefan Schweizer <genstef@gentoo.org>
12# Maintainer: kernel-misc@gentoo.org 7# Maintainer: kernel-misc@gentoo.org
13# 8#
14# Please direct your bugs to the current eclass maintainer :) 9# Please direct your bugs to the current eclass maintainer :)
15 10
11# @ECLASS: linux-mod.eclass
12# @MAINTAINER:
13# kernel-misc@gentoo.org
14# @BLURB: It provides the functionality required to install external modules against a kernel source tree.
15# @DESCRIPTION:
16# This eclass is used to interface with linux-info.eclass in such a way
17# to provide the functionality and initial functions
18# required to install external modules against a kernel source
19# tree.
20
16# A Couple of env vars are available to effect usage of this eclass 21# A Couple of env vars are available to effect usage of this eclass
17# These are as follows: 22# These are as follows:
18# 23
19# Env Var Option Default Description 24# @ECLASS-VARIABLE: KERNEL_DIR
20# KERNEL_DIR <string> /usr/src/linux The directory containing kernel 25# @DESCRIPTION:
21# the target kernel sources. 26# A string containing the directory of the target kernel sources. The default value is
22# ECONF_PARAMS <string> The parameters to pass to econf. 27# "/usr/src/linux"
28
29# @ECLASS-VARIABLE: ECONF_PARAMS
30# @DESCRIPTION:
31# It's a string containing the parameters to pass to econf.
23# If this is not set, then econf 32# If this is not set, then econf isn't run.
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 33
36# MODULE_NAMES - Detailed Overview 34# @ECLASS-VARIABLE: BUILD_PARAMS
35# @DESCRIPTION:
36# It's a string with the parameters to pass to emake.
37
38# @ECLASS-VARIABLE: BUILD_TARGETS
39# @DESCRIPTION:
40# It's a string with the build targets to pass to make. The default value is "clean modules"
41
42# @ECLASS-VARIABLE: MODULE_NAMES
43# @DESCRIPTION:
44# It's a string containing the modules to be built automatically using the default
45# src_compile/src_install. It will only make ${BUILD_TARGETS} once in any directory.
37# 46#
38# The structure of each MODULE_NAMES entry is as follows: 47# The structure of each MODULE_NAMES entry is as follows:
48#
39# modulename(libdir:srcdir:objdir) 49# modulename(libdir:srcdir:objdir)
40# 50#
51# where:
52#
41# modulename = name of the module file excluding the .ko 53# modulename = name of the module file excluding the .ko
42# libdir = place in system modules directory where module is installed: 54# libdir = place in system modules directory where module is installed (by default it's misc)
43# srcdir = place for ebuild to cd to before running make 55# srcdir = place for ebuild to cd to before running make (by default it's ${S})
44# objdir = place the .ko and objects are located after make runs 56# objdir = place the .ko and objects are located after make runs (by default it's set to srcdir)
45# 57#
46# To get an idea of how these variables are used, here's a few lines 58# To get an idea of how these variables are used, here's a few lines
47# of code from around line 540 in this eclass: 59# of code from around line 540 in this eclass:
48# 60#
49# einfo "Installing ${modulename} module" 61# einfo "Installing ${modulename} module"
50# cd ${objdir} || die "${objdir} does not exist" 62# cd ${objdir} || die "${objdir} does not exist"
51# insinto /lib/modules/${KV_FULL}/${libdir} 63# insinto /lib/modules/${KV_FULL}/${libdir}
52# doins ${modulename}.${KV_OBJ} || die "doins ${modulename}.${KV_OBJ} failed" 64# doins ${modulename}.${KV_OBJ} || die "doins ${modulename}.${KV_OBJ} failed"
53# 65#
54# for example: 66# For example:
55# MODULE_NAMES="module_pci(pci:${S}/pci:${S}) module_usb(usb:${S}/usb:${S})" 67# MODULE_NAMES="module_pci(pci:${S}/pci:${S}) module_usb(usb:${S}/usb:${S})"
56# 68#
57# what this would do is 69# what this would do is
70#
58# cd ${S}/pci 71# cd "${S}"/pci
59# make ${BUILD_PARAMS} ${BUILD_TARGETS} 72# make ${BUILD_PARAMS} ${BUILD_TARGETS}
60# cd ${S} 73# cd "${S}"
61# insinto /lib/modules/${KV_FULL}/pci 74# insinto /lib/modules/${KV_FULL}/pci
62# doins module_pci.${KV_OBJ} 75# doins module_pci.${KV_OBJ}
63# 76#
64# cd ${S}/usb 77# cd "${S}"/usb
65# make ${BUILD_PARAMS} ${BUILD_TARGETS} 78# make ${BUILD_PARAMS} ${BUILD_TARGETS}
66# cd ${S} 79# cd "${S}"
67# insinto /lib/modules/${KV_FULL}/usb 80# insinto /lib/modules/${KV_FULL}/usb
68# doins module_usb.${KV_OBJ} 81# doins module_usb.${KV_OBJ}
69#
70# if the srcdir isnt specified, it assumes ${S}
71# if the libdir isnt specified, it assumes misc.
72# if the objdir isnt specified, it assumes srcdir
73 82
74# There is also support for automated modprobe.d/modules.d(2.4) file generation. 83# There is also support for automated modprobe.d/modules.d(2.4) file generation.
75# This can be explicitly enabled by setting any of the following variables. 84# This can be explicitly enabled by setting any of the following variables.
85
86# @ECLASS-VARIABLE: MODULESD_<modulename>_ENABLED
87# @DESCRIPTION:
88# This is used to disable the modprobe.d/modules.d file generation otherwise the file will be
89# always generated (unless no MODULESD_<modulename>_* variable is provided). Set to "no" to disable
90# the generation of the file and the installation of the documentation.
91
92# @ECLASS-VARIABLE: MODULESD_<modulename>_EXAMPLES
93# @DESCRIPTION:
94# This is a bash array containing a list of examples which should
95# be used. If you want us to try and take a guess set this to "guess".
76# 96#
97# For each array_component it's added an options line in the modprobe.d/modules.d file
77# 98#
78# MODULESD_${modulename}_ENABLED This enables the modules.d file 99# options array_component
79# generation even if we dont 100#
80# specify any additional info. 101# where array_component is "<modulename> options" (see modprobe.conf(5))
81# MODULESD_${modulename}_EXAMPLES This is a bash array containing 102
82# a list of examples which should 103# @ECLASS-VARIABLE: MODULESD_<modulename>_ALIASES
83# be used. If you want us to try and 104# @DESCRIPTION:
84# take a guess. Set this to "guess" 105# This is a bash array containing a list of associated aliases.
85# MODULESD_${modulename}_ALIASES This is a bash array containing 106#
86# a list of associated aliases. 107# For each array_component it's added an alias line in the modprobe.d/modules.d file
87# MODULESD_${modulename}_ADDITIONS This is a bash array containing 108#
88# A list of additional things to 109# alias array_component
89# add to the bottom of the file. 110#
90# This can be absolutely anything. 111# where array_component is "wildcard <modulename>" (see modprobe.conf(5))
112
113# @ECLASS-VARIABLE: MODULESD_<modulename>_ADDITIONS
114# @DESCRIPTION:
115# This is a bash array containing a list of additional things to
116# add to the bottom of the file. This can be absolutely anything.
91# Each entry is a new line. 117# Each entry is a new line.
92# MODULES_${modulename}_DOCS This is a string list which contains 118
93# the full path to any associated 119# @ECLASS-VARIABLE: MODULESD_<modulename>_DOCS
94# documents for $modulename 120# @DESCRIPTION:
121# This is a string list which contains the full path to any associated
122# documents for <modulename>. These files are installed in the live tree.
123
124# @ECLASS-VARIABLE: KV_OBJ
125# @DESCRIPTION:
126# It's a read-only variable. It contains the extension of the kernel modules.
95 127
96# The order of these is important as both of linux-info and eutils contain 128# The order of these is important as both of linux-info and eutils contain
97# set_arch_to_kernel and set_arch_to_portage functions and the ones in eutils 129# set_arch_to_kernel and set_arch_to_portage functions and the ones in eutils
98# are deprecated in favor of the ones in linux-info. 130# are deprecated in favor of the ones in linux-info.
99# See http://bugs.gentoo.org/show_bug.cgi?id=127506 131# See http://bugs.gentoo.org/show_bug.cgi?id=127506
102EXPORT_FUNCTIONS pkg_setup pkg_preinst pkg_postinst src_install src_compile pkg_postrm 134EXPORT_FUNCTIONS pkg_setup pkg_preinst pkg_postinst src_install src_compile pkg_postrm
103 135
104IUSE="kernel_linux" 136IUSE="kernel_linux"
105SLOT="0" 137SLOT="0"
106DESCRIPTION="Based on the $ECLASS eclass" 138DESCRIPTION="Based on the $ECLASS eclass"
107RDEPEND="kernel_linux? ( virtual/modutils )" 139RDEPEND="kernel_linux? ( sys-apps/module-init-tools )"
108DEPEND="${RDEPEND} 140DEPEND="${RDEPEND}
109 sys-apps/sed" 141 sys-apps/sed
142 kernel_linux? ( virtual/linux-sources )"
110 143
111# eclass utilities 144# eclass utilities
112# ---------------------------------- 145# ----------------------------------
113 146
114check_vermagic() { 147check_vermagic() {
115 debug-print-function ${FUNCNAME} $* 148 debug-print-function ${FUNCNAME} $*
116 149
117 local curr_gcc_ver=$(gcc -dumpversion) 150 local curr_gcc_ver=$(gcc -dumpversion)
118 local tmpfile old_chost old_gcc_ver result=0 151 local tmpfile old_chost old_gcc_ver result=0
119 152
120 tmpfile=`find ${KV_DIR}/ -iname "*.o.cmd" -exec grep usr/lib/gcc {} \; -quit` 153 tmpfile=`find "${KV_DIR}/" -iname "*.o.cmd" -exec grep usr/lib/gcc {} \; -quit`
121 tmpfile=${tmpfile//*usr/lib} 154 tmpfile=${tmpfile//*usr/lib}
122 tmpfile=${tmpfile//\/include*} 155 tmpfile=${tmpfile//\/include*}
123 old_chost=${tmpfile//*gcc\/} 156 old_chost=${tmpfile//*gcc\/}
124 old_chost=${old_chost//\/*} 157 old_chost=${old_chost//\/*}
125 old_gcc_ver=${tmpfile//*\/} 158 old_gcc_ver=${tmpfile//*\/}
148 ewarn "to match the kernel, or recompile the kernel first." 181 ewarn "to match the kernel, or recompile the kernel first."
149 die "GCC Version Mismatch." 182 die "GCC Version Mismatch."
150 fi 183 fi
151} 184}
152 185
186# @FUNCTION: use_m
187# @RETURN: true or false
188# @DESCRIPTION:
189# It checks if the kernel version is greater than 2.6.5.
153use_m() { 190use_m() {
154 debug-print-function ${FUNCNAME} $* 191 debug-print-function ${FUNCNAME} $*
155 192
156 # if we haven't determined the version yet, we need too. 193 # if we haven't determined the version yet, we need too.
157 get_version; 194 get_version;
160 # M= instead of SUBDIRS= 197 # M= instead of SUBDIRS=
161 [ ${KV_MAJOR} -eq 2 -a ${KV_MINOR} -gt 5 -a ${KV_PATCH} -gt 5 ] && \ 198 [ ${KV_MAJOR} -eq 2 -a ${KV_MINOR} -gt 5 -a ${KV_PATCH} -gt 5 ] && \
162 return 0 || return 1 199 return 0 || return 1
163} 200}
164 201
202# @FUNCTION: convert_to_m
203# @USAGE: /path/to/the/file
204# @DESCRIPTION:
205# It converts a file (e.g. a makefile) to use M= instead of SUBDIRS=
165convert_to_m() { 206convert_to_m() {
166 debug-print-function ${FUNCNAME} $* 207 debug-print-function ${FUNCNAME} $*
167 208
168 if use_m 209 if use_m
169 then 210 then
170 [ ! -f "${1}" ] && \ 211 [ ! -f "${1}" ] && \
171 die "convert_to_m() requires a filename as an argument" 212 die "convert_to_m() requires a filename as an argument"
172 ebegin "Converting ${1/${WORKDIR}\//} to use M= instead of SUBDIRS=" 213 ebegin "Converting ${1/${WORKDIR}\//} to use M= instead of SUBDIRS="
173 sed -i 's:SUBDIRS=:M=:g' ${1} 214 sed -i 's:SUBDIRS=:M=:g' "${1}"
174 eend $? 215 eend $?
175 fi 216 fi
176} 217}
177 218
219# internal function
220#
221# FUNCTION: update_depmod
222# DESCRIPTION:
223# It updates the modules.dep file for the current kernel.
178update_depmod() { 224update_depmod() {
179 debug-print-function ${FUNCNAME} $* 225 debug-print-function ${FUNCNAME} $*
180 226
181 # if we haven't determined the version yet, we need too. 227 # if we haven't determined the version yet, we need too.
182 get_version; 228 get_version;
183 229
184 ebegin "Updating module dependencies for ${KV_FULL}" 230 ebegin "Updating module dependencies for ${KV_FULL}"
185 if [ -r ${KV_OUT_DIR}/System.map ] 231 if [ -r "${KV_OUT_DIR}"/System.map ]
186 then 232 then
187 depmod -ae -F ${KV_OUT_DIR}/System.map -b ${ROOT} -r ${KV_FULL} 233 depmod -ae -F "${KV_OUT_DIR}"/System.map -b "${ROOT}" -r ${KV_FULL}
188 eend $? 234 eend $?
189 else 235 else
190 ewarn 236 ewarn
191 ewarn "${KV_OUT_DIR}/System.map not found." 237 ewarn "${KV_OUT_DIR}/System.map not found."
192 ewarn "You must manually update the kernel module dependencies using depmod." 238 ewarn "You must manually update the kernel module dependencies using depmod."
193 eend 1 239 eend 1
194 ewarn 240 ewarn
195 fi 241 fi
196} 242}
197 243
244# internal function
245#
246# FUNCTION: update_modules
247# DESCRIPTION:
248# It calls the update-modules utility.
198update_modules() { 249update_modules() {
199 debug-print-function ${FUNCNAME} $* 250 debug-print-function ${FUNCNAME} $*
200 251
201 if [ -x /sbin/update-modules ] && \ 252 if [ -x /sbin/update-modules ] && \
202 grep -v -e "^#" -e "^$" ${D}/etc/modules.d/* >/dev/null 2>&1; then 253 grep -v -e "^#" -e "^$" "${D}"/etc/modules.d/* >/dev/null 2>&1; then
203 ebegin "Updating modules.conf" 254 ebegin "Updating modules.conf"
204 /sbin/update-modules 255 /sbin/update-modules
205 eend $? 256 eend $?
206 elif [ -x /sbin/update-modules ] && \ 257 elif [ -x /sbin/update-modules ] && \
207 grep -v -e "^#" -e "^$" ${D}/etc/modules.d/* >/dev/null 2>&1; then 258 grep -v -e "^#" -e "^$" "${D}"/etc/modules.d/* >/dev/null 2>&1; then
208 ebegin "Updating modules.conf" 259 ebegin "Updating modules.conf"
209 /sbin/update-modules 260 /sbin/update-modules
210 eend $? 261 eend $?
211 fi 262 fi
212} 263}
213 264
265# internal function
266#
267# FUNCTION: move_old_moduledb
268# DESCRIPTION:
269# It updates the location of the database used by the module-rebuild utility.
214move_old_moduledb() { 270move_old_moduledb() {
215 debug-print-function ${FUNCNAME} $* 271 debug-print-function ${FUNCNAME} $*
216 272
217 local OLDDIR=${ROOT}/usr/share/module-rebuild/ 273 local OLDDIR="${ROOT}"/usr/share/module-rebuild/
218 local NEWDIR=${ROOT}/var/lib/module-rebuild/ 274 local NEWDIR="${ROOT}"/var/lib/module-rebuild/
219 275
220 if [[ -f ${OLDDIR}/moduledb ]]; then 276 if [[ -f "${OLDDIR}"/moduledb ]]; then
221 [[ ! -d ${NEWDIR} ]] && mkdir -p ${NEWDIR} 277 [[ ! -d "${NEWDIR}" ]] && mkdir -p "${NEWDIR}"
222 [[ ! -f ${NEWDIR}/moduledb ]] && \ 278 [[ ! -f "${NEWDIR}"/moduledb ]] && \
223 mv ${OLDDIR}/moduledb ${NEWDIR}/moduledb 279 mv "${OLDDIR}"/moduledb "${NEWDIR}"/moduledb
224 rm -f ${OLDDIR}/* 280 rm -f "${OLDDIR}"/*
225 rmdir ${OLDDIR} 281 rmdir "${OLDDIR}"
226 fi 282 fi
227} 283}
228 284
285# internal function
286#
287# FUNCTION: update_moduledb
288# DESCRIPTION:
289# It adds the package to the /var/lib/module-rebuild/moduledb database used by the module-rebuild utility.
229update_moduledb() { 290update_moduledb() {
230 debug-print-function ${FUNCNAME} $* 291 debug-print-function ${FUNCNAME} $*
231 292
232 local MODULEDB_DIR=${ROOT}/var/lib/module-rebuild/ 293 local MODULEDB_DIR="${ROOT}"/var/lib/module-rebuild/
233 move_old_moduledb 294 move_old_moduledb
234 295
235 if [[ ! -f ${MODULEDB_DIR}/moduledb ]]; then 296 if [[ ! -f "${MODULEDB_DIR}"/moduledb ]]; then
236 [[ ! -d ${MODULEDB_DIR} ]] && mkdir -p ${MODULEDB_DIR} 297 [[ ! -d "${MODULEDB_DIR}" ]] && mkdir -p "${MODULEDB_DIR}"
237 touch ${MODULEDB_DIR}/moduledb 298 touch "${MODULEDB_DIR}"/moduledb
238 fi 299 fi
239 300
240 if ! grep -qs ${CATEGORY}/${PN}-${PVR} ${MODULEDB_DIR}/moduledb ; then 301 if ! grep -qs ${CATEGORY}/${PN}-${PVR} "${MODULEDB_DIR}"/moduledb ; then
241 einfo "Adding module to moduledb." 302 einfo "Adding module to moduledb."
242 echo "a:1:${CATEGORY}/${PN}-${PVR}" >> ${MODULEDB_DIR}/moduledb 303 echo "a:1:${CATEGORY}/${PN}-${PVR}" >> "${MODULEDB_DIR}"/moduledb
243 fi 304 fi
244} 305}
245 306
307# internal function
308#
309# FUNCTION: remove_moduledb
310# DESCRIPTION:
311# It removes the package from the /var/lib/module-rebuild/moduledb database used by
312# the module-rebuild utility.
246remove_moduledb() { 313remove_moduledb() {
247 debug-print-function ${FUNCNAME} $* 314 debug-print-function ${FUNCNAME} $*
248 315
249 local MODULEDB_DIR=${ROOT}/var/lib/module-rebuild/ 316 local MODULEDB_DIR="${ROOT}"/var/lib/module-rebuild/
250 move_old_moduledb 317 move_old_moduledb
251 318
252 if grep -qs ${CATEGORY}/${PN}-${PVR} ${MODULEDB_DIR}/moduledb ; then 319 if grep -qs ${CATEGORY}/${PN}-${PVR} "${MODULEDB_DIR}"/moduledb ; then
253 einfo "Removing ${CATEGORY}/${PN}-${PVR} from moduledb." 320 einfo "Removing ${CATEGORY}/${PN}-${PVR} from moduledb."
254 sed -i -e "/.*${CATEGORY}\/${PN}-${PVR}.*/d" ${MODULEDB_DIR}/moduledb 321 sed -i -e "/.*${CATEGORY}\/${PN}-${PVR}.*/d" "${MODULEDB_DIR}"/moduledb
255 fi 322 fi
256} 323}
257 324
325# @FUNCTION: set_kvobj
326# @DESCRIPTION:
327# It sets the KV_OBJ variable.
258set_kvobj() { 328set_kvobj() {
259 debug-print-function ${FUNCNAME} $* 329 debug-print-function ${FUNCNAME} $*
260 330
261 if kernel_is 2 6 331 if kernel_is 2 6
262 then 332 then
287 kernel_cc=$(tc-getCC) 357 kernel_cc=$(tc-getCC)
288 fi 358 fi
289 echo "${kernel_cc}" 359 echo "${kernel_cc}"
290} 360}
291 361
362# internal function
363#
364# FUNCTION:
365# USAGE: /path/to/the/modulename_without_extension
366# RETURN: A file in /etc/modules.d/ (kernel < 2.6) or /etc/modprobe.d/ (kernel >= 2.6)
367# DESCRIPTION:
368# This function will generate and install the neccessary modprobe.d/modules.d file from the
369# information contained in the modules exported parms.
370# (see the variables MODULESD_<modulename>_ENABLED, MODULESD_<modulename>_EXAMPLES,
371# MODULESD_<modulename>_ALIASES, MODULESD_<modulename>_ADDITION and MODULESD_<modulename>_DOCS).
372#
373# At the end the documentation specified with MODULESD_<modulename>_DOCS is installed.
292generate_modulesd() { 374generate_modulesd() {
293 debug-print-function ${FUNCNAME} $* 375 debug-print-function ${FUNCNAME} $*
294
295 # This function will generate the neccessary modules.d file from the
296 # information contained in the modules exported parms
297 376
298 local currm_path currm currm_t t myIFS myVAR 377 local currm_path currm currm_t t myIFS myVAR
299 local module_docs module_enabled module_aliases \ 378 local module_docs module_enabled module_aliases \
300 module_additions module_examples module_modinfo module_opts 379 module_additions module_examples module_modinfo module_opts
301 380
335 module_modinfo="$(modinfo -p ${currm_path}.${KV_OBJ})" 414 module_modinfo="$(modinfo -p ${currm_path}.${KV_OBJ})"
336 module_config="${T}/modulesd-${currm}" 415 module_config="${T}/modulesd-${currm}"
337 416
338 ebegin "Preparing file for modules.d" 417 ebegin "Preparing file for modules.d"
339 #----------------------------------------------------------------------- 418 #-----------------------------------------------------------------------
340 echo "# modules.d configuration file for ${currm}" >> ${module_config} 419 echo "# modules.d configuration file for ${currm}" >> "${module_config}"
341 #----------------------------------------------------------------------- 420 #-----------------------------------------------------------------------
342 [[ -n ${module_docs} ]] && \ 421 [[ -n ${module_docs} ]] && \
343 echo "# For more information please read:" >> ${module_config} 422 echo "# For more information please read:" >> "${module_config}"
344 for t in ${module_docs} 423 for t in ${module_docs}
345 do 424 do
346 echo "# ${t//*\/}" >> ${module_config} 425 echo "# ${t//*\/}" >> "${module_config}"
347 done 426 done
348 echo >> ${module_config} 427 echo >> "${module_config}"
349 428
350 #----------------------------------------------------------------------- 429 #-----------------------------------------------------------------------
351 if [[ ${module_aliases} -gt 0 ]] 430 if [[ ${module_aliases} -gt 0 ]]
352 then 431 then
353 echo "# Internal Aliases - Do not edit" >> ${module_config} 432 echo "# Internal Aliases - Do not edit" >> "${module_config}"
354 echo "# ------------------------------" >> ${module_config} 433 echo "# ------------------------------" >> "${module_config}"
355 434
356 for((t=0; t<${module_aliases}; t++)) 435 for((t=0; t<${module_aliases}; t++))
357 do 436 do
358 echo "alias $(eval echo \${MODULESD_${currm}_ALIASES[$t]})" \ 437 echo "alias $(eval echo \${MODULESD_${currm}_ALIASES[$t]})" \
359 >> ${module_config} 438 >> "${module_config}"
360 done 439 done
361 echo '' >> ${module_config} 440 echo '' >> "${module_config}"
362 fi 441 fi
363 442
364 #----------------------------------------------------------------------- 443 #-----------------------------------------------------------------------
365 if [[ -n ${module_modinfo} ]] 444 if [[ -n ${module_modinfo} ]]
366 then 445 then
367 echo >> ${module_config} 446 echo >> "${module_config}"
368 echo "# Configurable module parameters" >> ${module_config} 447 echo "# Configurable module parameters" >> "${module_config}"
369 echo "# ------------------------------" >> ${module_config} 448 echo "# ------------------------------" >> "${module_config}"
370 myIFS="${IFS}" 449 myIFS="${IFS}"
371 IFS="$(echo -en "\n\b")" 450 IFS="$(echo -en "\n\b")"
372 451
373 for t in ${module_modinfo} 452 for t in ${module_modinfo}
374 do 453 do
375 myVAR="$(echo ${t#*:} | grep -e " [0-9][ =]" | sed "s:.*\([01][= ]\).*:\1:")" 454 myVAR="$(echo ${t#*:} | grep -e " [0-9][ =]" | sed "s:.*\([01][= ]\).*:\1:")"
376 if [[ -n ${myVAR} ]] 455 if [[ -n ${myVAR} ]]
377 then 456 then
378 module_opts="${module_opts} ${t%%:*}:${myVAR}" 457 module_opts="${module_opts} ${t%%:*}:${myVAR}"
379 fi 458 fi
380 echo -e "# ${t%%:*}:\t${t#*:}" >> ${module_config} 459 echo -e "# ${t%%:*}:\t${t#*:}" >> "${module_config}"
381 done 460 done
382 IFS="${myIFS}" 461 IFS="${myIFS}"
383 echo '' >> ${module_config} 462 echo '' >> "${module_config}"
384 fi 463 fi
385 464
386 #----------------------------------------------------------------------- 465 #-----------------------------------------------------------------------
387 if [[ $(eval echo \${MODULESD_${currm}_ALIASES[0]}) == guess ]] 466 if [[ $(eval echo \${MODULESD_${currm}_ALIASES[0]}) == guess ]]
388 then 467 then
389 # So lets do some guesswork eh? 468 # So lets do some guesswork eh?
390 if [[ -n ${module_opts} ]] 469 if [[ -n ${module_opts} ]]
391 then 470 then
392 echo "# For Example..." >> ${module_config} 471 echo "# For Example..." >> "${module_config}"
393 echo "# --------------" >> ${module_config} 472 echo "# --------------" >> "${module_config}"
394 for t in ${module_opts} 473 for t in ${module_opts}
395 do 474 do
396 echo "# options ${currm} ${t//:*}=${t//*:}" >> ${module_config} 475 echo "# options ${currm} ${t//:*}=${t//*:}" >> "${module_config}"
397 done 476 done
398 echo '' >> ${module_config} 477 echo '' >> "${module_config}"
399 fi 478 fi
400 elif [[ ${module_examples} -gt 0 ]] 479 elif [[ ${module_examples} -gt 0 ]]
401 then 480 then
402 echo "# For Example..." >> ${module_config} 481 echo "# For Example..." >> "${module_config}"
403 echo "# --------------" >> ${module_config} 482 echo "# --------------" >> "${module_config}"
404 for((t=0; t<${module_examples}; t++)) 483 for((t=0; t<${module_examples}; t++))
405 do 484 do
406 echo "options $(eval echo \${MODULESD_${currm}_EXAMPLES[$t]})" \ 485 echo "options $(eval echo \${MODULESD_${currm}_EXAMPLES[$t]})" \
407 >> ${module_config} 486 >> "${module_config}"
408 done 487 done
409 echo '' >> ${module_config} 488 echo '' >> "${module_config}"
410 fi 489 fi
411 490
412 #----------------------------------------------------------------------- 491 #-----------------------------------------------------------------------
413 if [[ ${module_additions} -gt 0 ]] 492 if [[ ${module_additions} -gt 0 ]]
414 then 493 then
415 for((t=0; t<${module_additions}; t++)) 494 for((t=0; t<${module_additions}; t++))
416 do 495 do
417 echo "$(eval echo \${MODULESD_${currm}_ADDITIONS[$t]})" \ 496 echo "$(eval echo \${MODULESD_${currm}_ADDITIONS[$t]})" \
418 >> ${module_config} 497 >> "${module_config}"
419 done 498 done
420 echo '' >> ${module_config} 499 echo '' >> "${module_config}"
421 fi 500 fi
422 501
423 #----------------------------------------------------------------------- 502 #-----------------------------------------------------------------------
424 503
425 # then we install it 504 # then we install it
426 if kernel_is ge 2 6; then 505 if kernel_is ge 2 6; then
427 insinto /etc/modprobe.d 506 insinto /etc/modprobe.d
428 else 507 else
429 insinto /etc/modules.d 508 insinto /etc/modules.d
430 fi 509 fi
431 newins ${module_config} ${currm_path//*\/} 510 newins "${module_config}" "${currm_path//*\/}.conf"
432 511
433 # and install any documentation we might have. 512 # and install any documentation we might have.
434 [[ -n ${module_docs} ]] && dodoc ${module_docs} 513 [[ -n ${module_docs} ]] && dodoc ${module_docs}
435 done 514 done
436 eend 0 515 eend 0
437 return 0 516 return 0
438} 517}
439 518
519# internal function
520#
521# FUNCTION: find_module_params
522# USAGE: A string "NAME(LIBDIR:SRCDIR:OBJDIR)"
523# RETURN: The string "modulename:NAME libdir:LIBDIR srcdir:SRCDIR objdir:OBJDIR"
524# DESCRIPTION:
525# Analyze the specification NAME(LIBDIR:SRCDIR:OBJDIR) of one module as described in MODULE_NAMES.
440find_module_params() { 526find_module_params() {
441 debug-print-function ${FUNCNAME} $* 527 debug-print-function ${FUNCNAME} $*
442 528
443 local matched_offset=0 matched_opts=0 test="${@}" temp_var result 529 local matched_offset=0 matched_opts=0 test="${@}" temp_var result
444 local i=0 y=0 z=0 530 local i=0 y=0 z=0
480} 566}
481 567
482# default ebuild functions 568# default ebuild functions
483# -------------------------------- 569# --------------------------------
484 570
571# @FUNCTION: linux-mod_pkg_setup
572# @DESCRIPTION:
573# It checks the CONFIG_CHECK options (see linux-info.eclass(5)), verifies that the kernel is
574# configured, verifies that the sources are prepared, verifies that the modules support is builtin
575# in the kernel and sets the object extension KV_OBJ.
485linux-mod_pkg_setup() { 576linux-mod_pkg_setup() {
486 debug-print-function ${FUNCNAME} $* 577 debug-print-function ${FUNCNAME} $*
578
579 # If we are installing a binpkg, take a different path.
580 if [[ $EMERGE_FROM == binary ]]; then
581 linux-mod_pkg_setup_binary
582 return
583 fi
487 584
488 linux-info_pkg_setup; 585 linux-info_pkg_setup;
489 require_configured_kernel 586 require_configured_kernel
490 check_kernel_built; 587 check_kernel_built;
491 strip_modulenames; 588 strip_modulenames;
495 # who intentionally use different kernel and userland compilers can be 592 # who intentionally use different kernel and userland compilers can be
496 # introduced - Jason Wever <weeve@gentoo.org>, 23 Oct 2005 593 # introduced - Jason Wever <weeve@gentoo.org>, 23 Oct 2005
497 #check_vermagic; 594 #check_vermagic;
498} 595}
499 596
597# @FUNCTION: linux-mod_pkg_setup_binary
598# @DESCRIPTION:
599# Perform all kernel option checks non-fatally, as the .config and
600# /proc/config.gz might not be present. Do not do anything that requires kernel
601# sources.
602linux-mod_pkg_setup_binary() {
603 debug-print-function ${FUNCNAME} $*
604 local new_CONFIG_CHECK
605 # ~ needs always to be quoted, else bash expands it.
606 for config in $CONFIG_CHECK ; do
607 optional='~'
608 [[ ${config:0:1} == "~" ]] && optional=''
609 new_CONFIG_CHECK="${new_CONFIG_CHECK} ${optional}${config}"
610 done
611 export CONFIG_CHECK="${new_CONFIG_CHECK}"
612 linux-info_pkg_setup;
613}
614
500strip_modulenames() { 615strip_modulenames() {
501 debug-print-function ${FUNCNAME} $* 616 debug-print-function ${FUNCNAME} $*
502 617
503 local i 618 local i
504 for i in ${MODULE_IGNORE}; do 619 for i in ${MODULE_IGNORE}; do
505 MODULE_NAMES=${MODULE_NAMES//${i}(*} 620 MODULE_NAMES=${MODULE_NAMES//${i}(*}
506 done 621 done
507} 622}
508 623
624# @FUNCTION: linux-mod_src_compile
625# @DESCRIPTION:
626# It compiles all the modules specified in MODULE_NAMES. For each module the econf command is
627# executed only if ECONF_PARAMS is defined, the name of the target is specified by BUILD_TARGETS
628# while the options are in BUILD_PARAMS (all the modules share these variables). The compilation
629# happens inside ${srcdir}.
630#
631# Look at the description of these variables for more details.
509linux-mod_src_compile() { 632linux-mod_src_compile() {
510 debug-print-function ${FUNCNAME} $* 633 debug-print-function ${FUNCNAME} $*
511 634
512 local modulename libdir srcdir objdir i n myABI="${ABI}" 635 local modulename libdir srcdir objdir i n myABI="${ABI}"
513 set_arch_to_kernel 636 set_arch_to_kernel
514 ABI="${KERNEL_ABI}" 637 ABI="${KERNEL_ABI}"
515 638
516 BUILD_TARGETS=${BUILD_TARGETS:-clean module} 639 BUILD_TARGETS=${BUILD_TARGETS:-clean module}
517 strip_modulenames; 640 strip_modulenames;
518 cd "${S}" 641 cd "${S}"
642 touch Module.symvers
519 for i in ${MODULE_NAMES} 643 for i in ${MODULE_NAMES}
520 do 644 do
521 unset libdir srcdir objdir 645 unset libdir srcdir objdir
522 for n in $(find_module_params ${i}) 646 for n in $(find_module_params ${i})
523 do 647 do
527 srcdir=${srcdir:-${S}} 651 srcdir=${srcdir:-${S}}
528 objdir=${objdir:-${srcdir}} 652 objdir=${objdir:-${srcdir}}
529 653
530 if [ ! -f "${srcdir}/.built" ]; 654 if [ ! -f "${srcdir}/.built" ];
531 then 655 then
532 cd ${srcdir} 656 cd "${srcdir}"
657 ln -s "${S}"/Module.symvers Module.symvers
533 einfo "Preparing ${modulename} module" 658 einfo "Preparing ${modulename} module"
534 if [[ -n ${ECONF_PARAMS} ]] 659 if [[ -n ${ECONF_PARAMS} ]]
535 then 660 then
536 econf ${ECONF_PARAMS} || \ 661 econf ${ECONF_PARAMS} || \
537 die "Unable to run econf ${ECONF_PARAMS}" 662 die "Unable to run econf ${ECONF_PARAMS}"
547 LDFLAGS=\"$(get_abi_LDFLAGS)\" \ 672 LDFLAGS=\"$(get_abi_LDFLAGS)\" \
548 ${BUILD_FIXES} \ 673 ${BUILD_FIXES} \
549 ${BUILD_PARAMS} \ 674 ${BUILD_PARAMS} \
550 ${BUILD_TARGETS} " \ 675 ${BUILD_TARGETS} " \
551 || die "Unable to emake HOSTCC="$(tc-getBUILD_CC)" CROSS_COMPILE=${CHOST}- LDFLAGS="$(get_abi_LDFLAGS)" ${BUILD_FIXES} ${BUILD_PARAMS} ${BUILD_TARGETS}" 676 || die "Unable to emake HOSTCC="$(tc-getBUILD_CC)" CROSS_COMPILE=${CHOST}- LDFLAGS="$(get_abi_LDFLAGS)" ${BUILD_FIXES} ${BUILD_PARAMS} ${BUILD_TARGETS}"
677 cd "${OLDPWD}"
552 touch ${srcdir}/.built 678 touch "${srcdir}"/.built
553 cd ${OLDPWD}
554 fi 679 fi
555 done 680 done
556 681
557 set_arch_to_portage 682 set_arch_to_portage
558 ABI="${myABI}" 683 ABI="${myABI}"
559} 684}
560 685
686# @FUNCTION: linux-mod_src_install
687# @DESCRIPTION:
688# It install the modules specified in MODULES_NAME. The modules should be inside the ${objdir}
689# directory and they are installed inside /lib/modules/${KV_FULL}/${libdir}.
690#
691# The modprobe.d/modules.d configuration file is automatically generated if the
692# MODULESD_<modulename>_* variables are defined. The only way to stop this process is by
693# setting MODULESD_<modulename>_ENABLED=no. At the end the documentation specified via
694# MODULESD_<modulename>_DOCS is also installed.
695#
696# Look at the description of these variables for more details.
561linux-mod_src_install() { 697linux-mod_src_install() {
562 debug-print-function ${FUNCNAME} $* 698 debug-print-function ${FUNCNAME} $*
563 699
564 local modulename libdir srcdir objdir i n 700 local modulename libdir srcdir objdir i n
565 701
574 libdir=${libdir:-misc} 710 libdir=${libdir:-misc}
575 srcdir=${srcdir:-${S}} 711 srcdir=${srcdir:-${S}}
576 objdir=${objdir:-${srcdir}} 712 objdir=${objdir:-${srcdir}}
577 713
578 einfo "Installing ${modulename} module" 714 einfo "Installing ${modulename} module"
579 cd ${objdir} || die "${objdir} does not exist" 715 cd "${objdir}" || die "${objdir} does not exist"
580 insinto /lib/modules/${KV_FULL}/${libdir} 716 insinto /lib/modules/${KV_FULL}/${libdir}
581 doins ${modulename}.${KV_OBJ} || die "doins ${modulename}.${KV_OBJ} failed" 717 doins ${modulename}.${KV_OBJ} || die "doins ${modulename}.${KV_OBJ} failed"
582 cd ${OLDPWD} 718 cd "${OLDPWD}"
583 719
584 generate_modulesd ${objdir}/${modulename} 720 generate_modulesd "${objdir}/${modulename}"
585 done 721 done
586} 722}
587 723
724# @FUNCTION: linux-mod_pkg_preinst
725# @DESCRIPTION:
726# It checks what to do after having merged the package.
588linux-mod_pkg_preinst() { 727linux-mod_pkg_preinst() {
589 debug-print-function ${FUNCNAME} $* 728 debug-print-function ${FUNCNAME} $*
590 729
591 [ -d "${D}lib/modules" ] && UPDATE_DEPMOD=true || UPDATE_DEPMOD=false 730 [ -d "${D}lib/modules" ] && UPDATE_DEPMOD=true || UPDATE_DEPMOD=false
592 [ -d "${D}etc/modules.d" ] && UPDATE_MODULES=true || UPDATE_MODULES=false 731 [ -d "${D}etc/modules.d" ] && UPDATE_MODULES=true || UPDATE_MODULES=false
593 [ -d "${D}lib/modules" ] && UPDATE_MODULEDB=true || UPDATE_MODULEDB=false 732 [ -d "${D}lib/modules" ] && UPDATE_MODULEDB=true || UPDATE_MODULEDB=false
594} 733}
595 734
735# @FUNCTION: linux-mod_pkg_postinst
736# @DESCRIPTION:
737# It executes /sbin/depmod and adds the package to the /var/lib/module-rebuild/moduledb
738# database (if ${D}/lib/modules is created) and it runs /sbin/update-modules
739# (if ${D}/etc/modules.d is created).
596linux-mod_pkg_postinst() { 740linux-mod_pkg_postinst() {
597 debug-print-function ${FUNCNAME} $* 741 debug-print-function ${FUNCNAME} $*
598 742
599 ${UPDATE_DEPMOD} && update_depmod; 743 ${UPDATE_DEPMOD} && update_depmod;
600 ${UPDATE_MODULES} && update_modules; 744 ${UPDATE_MODULES} && update_modules;
601 ${UPDATE_MODULEDB} && update_moduledb; 745 ${UPDATE_MODULEDB} && update_moduledb;
602} 746}
603 747
748# @FUNCTION: linux-mod_pkg_postrm
749# @DESCRIPTION:
750# It removes the package from the /var/lib/module-rebuild/moduledb database but it doens't
751# call /sbin/depmod and /sbin/update-modules because the modules are still installed.
604linux-mod_pkg_postrm() { 752linux-mod_pkg_postrm() {
605 debug-print-function ${FUNCNAME} $* 753 debug-print-function ${FUNCNAME} $*
606 remove_moduledb; 754 remove_moduledb;
607} 755}

Legend:
Removed from v.1.85  
changed lines
  Added in v.1.100

  ViewVC Help
Powered by ViewVC 1.1.20