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

Contents of /eclass/linux-info.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.90 - (show annotations) (download)
Mon Aug 22 04:46:32 2011 UTC (3 years, 10 months ago) by vapier
Branch: MAIN
Changes since 1.89: +6 -8 lines
fix random bugs in eclass documentation, and convert to new @AUTHOR tag

1 # Copyright 1999-2011 Gentoo Foundation
2 # Distributed under the terms of the GNU General Public License v2
3 # $Header: /var/cvsroot/gentoo-x86/eclass/linux-info.eclass,v 1.89 2011/08/18 14:58:57 vapier Exp $
4
5 # @ECLASS: linux-info.eclass
6 # @MAINTAINER:
7 # kernel-misc@gentoo.org
8 # @AUTHOR:
9 # Original author: John Mylchreest <johnm@gentoo.org>
10 # @BLURB: eclass used for accessing kernel related information
11 # @DESCRIPTION:
12 # This eclass is used as a central eclass for accessing kernel
13 # related information for source or binary already installed.
14 # It is vital for linux-mod.eclass to function correctly, and is split
15 # out so that any ebuild behaviour "templates" are abstracted out
16 # using additional eclasses.
17 #
18 # "kernel config" in this file means:
19 # The .config of the currently installed sources is used as the first
20 # preference, with a fall-back to bundled config (/proc/config.gz) if available.
21
22 # A Couple of env vars are available to effect usage of this eclass
23 # These are as follows:
24
25 # @ECLASS-VARIABLE: KERNEL_DIR
26 # @DESCRIPTION:
27 # A string containing the directory of the target kernel sources. The default value is
28 # "/usr/src/linux"
29
30 # @ECLASS-VARIABLE: CONFIG_CHECK
31 # @DESCRIPTION:
32 # A string containing a list of .config options to check for before
33 # proceeding with the install.
34 #
35 # e.g.: CONFIG_CHECK="MTRR"
36 #
37 # You can also check that an option doesn't exist by
38 # prepending it with an exclamation mark (!).
39 #
40 # e.g.: CONFIG_CHECK="!MTRR"
41 #
42 # To simply warn about a missing option, prepend a '~'.
43 # It may be combined with '!'.
44 #
45 # In general, most checks should be non-fatal. The only time fatal checks should
46 # be used is for building kernel modules or cases that a compile will fail
47 # without the option.
48 #
49 # This is to allow usage of binary kernels, and minimal systems without kernel
50 # sources.
51
52 # @ECLASS-VARIABLE: ERROR_<CFG>
53 # @DESCRIPTION:
54 # A string containing the error message to display when the check against CONFIG_CHECK
55 # fails. <CFG> should reference the appropriate option used in CONFIG_CHECK.
56 #
57 # e.g.: ERROR_MTRR="MTRR exists in the .config but shouldn't!!"
58
59 # @ECLASS-VARIABLE: KBUILD_OUTPUT
60 # @DESCRIPTION:
61 # A string passed on commandline, or set from the kernel makefile. It contains the directory
62 # which is to be used as the kernel object directory.
63
64 # There are also a couple of variables which are set by this, and shouldn't be
65 # set by hand. These are as follows:
66
67 # @ECLASS-VARIABLE: KV_FULL
68 # @DESCRIPTION:
69 # A read-only variable. It's a string containing the full kernel version. ie: 2.6.9-gentoo-johnm-r1
70
71 # @ECLASS-VARIABLE: KV_MAJOR
72 # @DESCRIPTION:
73 # A read-only variable. It's an integer containing the kernel major version. ie: 2
74
75 # @ECLASS-VARIABLE: KV_MINOR
76 # @DESCRIPTION:
77 # A read-only variable. It's an integer containing the kernel minor version. ie: 6
78
79 # @ECLASS-VARIABLE: KV_PATCH
80 # @DESCRIPTION:
81 # A read-only variable. It's an integer containing the kernel patch version. ie: 9
82
83 # @ECLASS-VARIABLE: KV_EXTRA
84 # @DESCRIPTION:
85 # A read-only variable. It's a string containing the kernel EXTRAVERSION. ie: -gentoo
86
87 # @ECLASS-VARIABLE: KV_LOCAL
88 # @DESCRIPTION:
89 # A read-only variable. It's a string containing the kernel LOCALVERSION concatenation. ie: -johnm
90
91 # @ECLASS-VARIABLE: KV_DIR
92 # @DESCRIPTION:
93 # A read-only variable. It's a string containing the kernel source directory, will be null if
94 # KERNEL_DIR is invalid.
95
96 # @ECLASS-VARIABLE: KV_OUT_DIR
97 # @DESCRIPTION:
98 # A read-only variable. It's a string containing the kernel object directory, will be KV_DIR unless
99 # KBUILD_OUTPUT is used. This should be used for referencing .config.
100
101 # And to ensure all the weirdness with crosscompile
102 inherit toolchain-funcs versionator
103
104 EXPORT_FUNCTIONS pkg_setup
105
106 DEPEND=""
107 RDEPEND=""
108
109 # Overwritable environment Var's
110 # ---------------------------------------
111 KERNEL_DIR="${KERNEL_DIR:-${ROOT}usr/src/linux}"
112
113
114 # Bug fixes
115 # fix to bug #75034
116 case ${ARCH} in
117 ppc) BUILD_FIXES="${BUILD_FIXES} TOUT=${T}/.tmp_gas_check";;
118 ppc64) BUILD_FIXES="${BUILD_FIXES} TOUT=${T}/.tmp_gas_check";;
119 esac
120
121 # @FUNCTION: set_arch_to_kernel
122 # @DESCRIPTION:
123 # Set the env ARCH to match what the kernel expects.
124 set_arch_to_kernel() { export ARCH=$(tc-arch-kernel); }
125 # @FUNCTION: set_arch_to_portage
126 # @DESCRIPTION:
127 # Set the env ARCH to match what portage expects.
128 set_arch_to_portage() { export ARCH=$(tc-arch); }
129
130 # qeinfo "Message"
131 # -------------------
132 # qeinfo is a quiet einfo call when EBUILD_PHASE
133 # should not have visible output.
134 qout() {
135 local outputmsg type
136 type=${1}
137 shift
138 outputmsg="${@}"
139 case "${EBUILD_PHASE}" in
140 depend) unset outputmsg;;
141 clean) unset outputmsg;;
142 preinst) unset outputmsg;;
143 esac
144 [ -n "${outputmsg}" ] && ${type} "${outputmsg}"
145 }
146
147 qeinfo() { qout einfo "${@}" ; }
148 qewarn() { qout ewarn "${@}" ; }
149 qeerror() { qout eerror "${@}" ; }
150
151 # File Functions
152 # ---------------------------------------
153
154 # @FUNCTION: getfilevar
155 # @USAGE: variable configfile
156 # @RETURN: the value of the variable
157 # @DESCRIPTION:
158 # It detects the value of the variable defined in the file configfile. This is
159 # done by including the configfile, and printing the variable with Make.
160 # It WILL break if your makefile has missing dependencies!
161 getfilevar() {
162 local ERROR basefname basedname myARCH="${ARCH}"
163 ERROR=0
164
165 [ -z "${1}" ] && ERROR=1
166 [ ! -f "${2}" ] && ERROR=1
167
168 if [ "${ERROR}" = 1 ]
169 then
170 echo -e "\n"
171 eerror "getfilevar requires 2 variables, with the second a valid file."
172 eerror " getfilevar <VARIABLE> <CONFIGFILE>"
173 else
174 basefname="$(basename ${2})"
175 basedname="$(dirname ${2})"
176 unset ARCH
177
178 echo -e "e:\\n\\t@echo \$(${1})\\ninclude ${basefname}" | \
179 make -C "${basedname}" M="${S}" ${BUILD_FIXES} -s -f - 2>/dev/null
180
181 ARCH=${myARCH}
182 fi
183 }
184
185 # @FUNCTION: getfilevar_noexec
186 # @USAGE: variable configfile
187 # @RETURN: the value of the variable
188 # @DESCRIPTION:
189 # It detects the value of the variable defined in the file configfile.
190 # This is done with sed matching an expression only. If the variable is defined,
191 # you will run into problems. See getfilevar for those cases.
192 getfilevar_noexec() {
193 local ERROR basefname basedname mycat myARCH="${ARCH}"
194 ERROR=0
195 mycat='cat'
196
197 [ -z "${1}" ] && ERROR=1
198 [ ! -f "${2}" ] && ERROR=1
199 [ "${2%.gz}" != "${2}" ] && mycat='zcat'
200
201 if [ "${ERROR}" = 1 ]
202 then
203 echo -e "\n"
204 eerror "getfilevar_noexec requires 2 variables, with the second a valid file."
205 eerror " getfilevar_noexec <VARIABLE> <CONFIGFILE>"
206 else
207 ${mycat} "${2}" | \
208 sed -n \
209 -e "/^[[:space:]]*${1}[[:space:]]*:\\?=[[:space:]]*\(.*\)\$/{
210 s,^[^=]*[[:space:]]*=[[:space:]]*,,g ;
211 s,[[:space:]]*\$,,g ;
212 p
213 }"
214 fi
215 }
216
217 # @ECLASS-VARIABLE: _LINUX_CONFIG_EXISTS_DONE
218 # @INTERNAL
219 # @DESCRIPTION:
220 # This is only set if one of the linux_config_*exists functions has been called.
221 # We use it for a QA warning that the check for a config has not been performed,
222 # as linux_chkconfig* in non-legacy mode WILL return an undefined value if no
223 # config is available at all.
224 _LINUX_CONFIG_EXISTS_DONE=
225
226 linux_config_qa_check() {
227 local f="$1"
228 if [ -z "${_LINUX_CONFIG_EXISTS_DONE}" ]; then
229 ewarn "QA: You called $f before any linux_config_exists!"
230 ewarn "QA: The return value of $f will NOT guaranteed later!"
231 fi
232 }
233
234 # @FUNCTION: linux_config_src_exists
235 # @RETURN: true or false
236 # @DESCRIPTION:
237 # It returns true if .config exists in a build directory otherwise false
238 linux_config_src_exists() {
239 export _LINUX_CONFIG_EXISTS_DONE=1
240 [ -s "${KV_OUT_DIR}/.config" ]
241 }
242
243 # @FUNCTION: linux_config_bin_exists
244 # @RETURN: true or false
245 # @DESCRIPTION:
246 # It returns true if .config exists in /proc, otherwise false
247 linux_config_bin_exists() {
248 export _LINUX_CONFIG_EXISTS_DONE=1
249 [ -s "/proc/config.gz" ]
250 }
251
252 # @FUNCTION: linux_config_exists
253 # @RETURN: true or false
254 # @DESCRIPTION:
255 # It returns true if .config exists otherwise false
256 #
257 # This function MUST be checked before using any of the linux_chkconfig_*
258 # functions.
259 linux_config_exists() {
260 linux_config_src_exists || linux_config_bin_exists
261 }
262
263 # @FUNCTION: require_configured_kernel
264 # @DESCRIPTION:
265 # This function verifies that the current kernel is configured (it checks against the existence of .config)
266 # otherwise it dies.
267 require_configured_kernel() {
268 if ! linux_config_src_exists; then
269 qeerror "Could not find a usable .config in the kernel source directory."
270 qeerror "Please ensure that ${KERNEL_DIR} points to a configured set of Linux sources."
271 qeerror "If you are using KBUILD_OUTPUT, please set the environment var so that"
272 qeerror "it points to the necessary object directory so that it might find .config."
273 die "Kernel not configured; no .config found in ${KV_OUT_DIR}"
274 fi
275 }
276
277 # @FUNCTION: linux_chkconfig_present
278 # @USAGE: option
279 # @RETURN: true or false
280 # @DESCRIPTION:
281 # It checks that CONFIG_<option>=y or CONFIG_<option>=m is present in the current kernel .config
282 # If linux_config_exists returns false, the results of this are UNDEFINED. You
283 # MUST call linux_config_exists first.
284 linux_chkconfig_present() {
285 linux_config_qa_check linux_chkconfig_present
286 local RESULT
287 local config
288 config="${KV_OUT_DIR}/.config"
289 [ ! -f "${config}" ] && config="/proc/config.gz"
290 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
291 [ "${RESULT}" = "m" -o "${RESULT}" = "y" ] && return 0 || return 1
292 }
293
294 # @FUNCTION: linux_chkconfig_module
295 # @USAGE: option
296 # @RETURN: true or false
297 # @DESCRIPTION:
298 # It checks that CONFIG_<option>=m is present in the current kernel .config
299 # If linux_config_exists returns false, the results of this are UNDEFINED. You
300 # MUST call linux_config_exists first.
301 linux_chkconfig_module() {
302 linux_config_qa_check linux_chkconfig_module
303 local RESULT
304 local config
305 config="${KV_OUT_DIR}/.config"
306 [ ! -f "${config}" ] && config="/proc/config.gz"
307 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
308 [ "${RESULT}" = "m" ] && return 0 || return 1
309 }
310
311 # @FUNCTION: linux_chkconfig_builtin
312 # @USAGE: option
313 # @RETURN: true or false
314 # @DESCRIPTION:
315 # It checks that CONFIG_<option>=y is present in the current kernel .config
316 # If linux_config_exists returns false, the results of this are UNDEFINED. You
317 # MUST call linux_config_exists first.
318 linux_chkconfig_builtin() {
319 linux_config_qa_check linux_chkconfig_builtin
320 local RESULT
321 local config
322 config="${KV_OUT_DIR}/.config"
323 [ ! -f "${config}" ] && config="/proc/config.gz"
324 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
325 [ "${RESULT}" = "y" ] && return 0 || return 1
326 }
327
328 # @FUNCTION: linux_chkconfig_string
329 # @USAGE: option
330 # @RETURN: CONFIG_<option>
331 # @DESCRIPTION:
332 # It prints the CONFIG_<option> value of the current kernel .config (it requires a configured kernel).
333 # If linux_config_exists returns false, the results of this are UNDEFINED. You
334 # MUST call linux_config_exists first.
335 linux_chkconfig_string() {
336 linux_config_qa_check linux_chkconfig_string
337 local config
338 config="${KV_OUT_DIR}/.config"
339 [ ! -f "${config}" ] && config="/proc/config.gz"
340 getfilevar_noexec "CONFIG_${1}" "${config}"
341 }
342
343 # Versioning Functions
344 # ---------------------------------------
345
346 # @FUNCTION: kernel_is
347 # @USAGE: [-lt -gt -le -ge -eq] major_number [minor_number patch_number]
348 # @RETURN: true or false
349 # @DESCRIPTION:
350 # It returns true when the current kernel version satisfies the comparison against the passed version.
351 # -eq is the default comparison.
352 #
353 # @CODE
354 # For Example where KV = 2.6.9
355 # kernel_is 2 4 returns false
356 # kernel_is 2 returns true
357 # kernel_is 2 6 returns true
358 # kernel_is 2 6 8 returns false
359 # kernel_is 2 6 9 returns true
360 # @CODE
361
362 # got the jist yet?
363
364 kernel_is() {
365 # if we haven't determined the version yet, we need to.
366 linux-info_get_any_version
367
368 local operator testagainst value x=0 y=0 z=0
369
370 case ${1} in
371 -lt|lt) operator="-lt"; shift;;
372 -gt|gt) operator="-gt"; shift;;
373 -le|le) operator="-le"; shift;;
374 -ge|ge) operator="-ge"; shift;;
375 -eq|eq) operator="-eq"; shift;;
376 *) operator="-eq";;
377 esac
378
379 for x in ${@}; do
380 for((y=0; y<$((3 - ${#x})); y++)); do value="${value}0"; done
381 value="${value}${x}"
382 z=$((${z} + 1))
383
384 case ${z} in
385 1) for((y=0; y<$((3 - ${#KV_MAJOR})); y++)); do testagainst="${testagainst}0"; done;
386 testagainst="${testagainst}${KV_MAJOR}";;
387 2) for((y=0; y<$((3 - ${#KV_MINOR})); y++)); do testagainst="${testagainst}0"; done;
388 testagainst="${testagainst}${KV_MINOR}";;
389 3) for((y=0; y<$((3 - ${#KV_PATCH})); y++)); do testagainst="${testagainst}0"; done;
390 testagainst="${testagainst}${KV_PATCH}";;
391 *) die "Error in kernel-2_kernel_is(): Too many parameters.";;
392 esac
393 done
394
395 [ "${testagainst}" ${operator} "${value}" ] && return 0 || return 1
396 }
397
398 get_localversion() {
399 local lv_list i x
400
401 # ignore files with ~ in it.
402 for i in $(ls ${1}/localversion* 2>/dev/null); do
403 [[ -n ${i//*~*} ]] && lv_list="${lv_list} ${i}"
404 done
405
406 for i in ${lv_list}; do
407 x="${x}$(<${i})"
408 done
409 x=${x/ /}
410 echo ${x}
411 }
412
413 # Check if the Makefile is valid for direct parsing.
414 # Check status results:
415 # - PASS, use 'getfilevar' to extract values
416 # - FAIL, use 'getfilevar_noexec' to extract values
417 # The check may fail if:
418 # - make is not present
419 # - corruption exists in the kernel makefile
420 get_makefile_extract_function() {
421 local a='' b='' mkfunc='getfilevar'
422 a="$(getfilevar VERSION ${KERNEL_MAKEFILE})"
423 b="$(getfilevar_noexec VERSION ${KERNEL_MAKEFILE})"
424 [[ "${a}" != "${b}" ]] && mkfunc='getfilevar_noexec'
425 echo "${mkfunc}"
426 }
427
428 # internal variable, so we know to only print the warning once
429 get_version_warning_done=
430
431 # @FUNCTION: get_version
432 # @DESCRIPTION:
433 # It gets the version of the kernel inside KERNEL_DIR and populates the KV_FULL variable
434 # (if KV_FULL is already set it does nothing).
435 #
436 # The kernel version variables (KV_MAJOR, KV_MINOR, KV_PATCH, KV_EXTRA and KV_LOCAL) are also set.
437 #
438 # The KV_DIR is set using the KERNEL_DIR env var, the KV_DIR_OUT is set using a valid
439 # KBUILD_OUTPUT (in a decreasing priority list, we look for the env var, makefile var or the
440 # symlink /lib/modules/${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}/build).
441 get_version() {
442 local kbuild_output mkfunc tmplocal
443
444 # no need to execute this twice assuming KV_FULL is populated.
445 # we can force by unsetting KV_FULL
446 [ -n "${KV_FULL}" ] && return 0
447
448 # if we dont know KV_FULL, then we need too.
449 # make sure KV_DIR isnt set since we need to work it out via KERNEL_DIR
450 unset KV_DIR
451
452 # KV_DIR will contain the full path to the sources directory we should use
453 [ -z "${get_version_warning_done}" ] && \
454 qeinfo "Determining the location of the kernel source code"
455 [ -h "${KERNEL_DIR}" ] && KV_DIR="$(readlink -f ${KERNEL_DIR})"
456 [ -d "${KERNEL_DIR}" ] && KV_DIR="${KERNEL_DIR}"
457
458 if [ -z "${KV_DIR}" ]
459 then
460 if [ -z "${get_version_warning_done}" ]; then
461 get_version_warning_done=1
462 qeerror "Unable to find kernel sources at ${KERNEL_DIR}"
463 #qeinfo "This package requires Linux sources."
464 if [ "${KERNEL_DIR}" == "/usr/src/linux" ] ; then
465 qeinfo "Please make sure that ${KERNEL_DIR} points at your running kernel, "
466 qeinfo "(or the kernel you wish to build against)."
467 qeinfo "Alternatively, set the KERNEL_DIR environment variable to the kernel sources location"
468 else
469 qeinfo "Please ensure that the KERNEL_DIR environment variable points at full Linux sources of the kernel you wish to compile against."
470 fi
471 fi
472 return 1
473 fi
474
475 if [ -z "${get_version_warning_done}" ]; then
476 qeinfo "Found kernel source directory:"
477 qeinfo " ${KV_DIR}"
478 fi
479
480 if [ ! -s "${KV_DIR}/Makefile" ]
481 then
482 if [ -z "${get_version_warning_done}" ]; then
483 get_version_warning_done=1
484 qeerror "Could not find a Makefile in the kernel source directory."
485 qeerror "Please ensure that ${KERNEL_DIR} points to a complete set of Linux sources"
486 fi
487 return 1
488 fi
489
490 # OK so now we know our sources directory, but they might be using
491 # KBUILD_OUTPUT, and we need this for .config and localversions-*
492 # so we better find it eh?
493 # do we pass KBUILD_OUTPUT on the CLI?
494 OUTPUT_DIR="${OUTPUT_DIR:-${KBUILD_OUTPUT}}"
495
496 # keep track of it
497 KERNEL_MAKEFILE="${KV_DIR}/Makefile"
498
499 # Decide the function used to extract makefile variables.
500 mkfunc="$(get_makefile_extract_function "${KERNEL_MAKEFILE}")"
501
502 # And if we didn't pass it, we can take a nosey in the Makefile
503 kbuild_output="$(${mkfunc} KBUILD_OUTPUT ${KERNEL_MAKEFILE})"
504 OUTPUT_DIR="${OUTPUT_DIR:-${kbuild_output}}"
505
506 # And contrary to existing functions I feel we shouldn't trust the
507 # directory name to find version information as this seems insane.
508 # so we parse ${KERNEL_MAKEFILE}
509 KV_MAJOR="$(${mkfunc} VERSION ${KERNEL_MAKEFILE})"
510 KV_MINOR="$(${mkfunc} PATCHLEVEL ${KERNEL_MAKEFILE})"
511 KV_PATCH="$(${mkfunc} SUBLEVEL ${KERNEL_MAKEFILE})"
512 KV_EXTRA="$(${mkfunc} EXTRAVERSION ${KERNEL_MAKEFILE})"
513
514 if [ -z "${KV_MAJOR}" -o -z "${KV_MINOR}" -o -z "${KV_PATCH}" ]
515 then
516 if [ -z "${get_version_warning_done}" ]; then
517 get_version_warning_done=1
518 qeerror "Could not detect kernel version."
519 qeerror "Please ensure that ${KERNEL_DIR} points to a complete set of Linux sources."
520 fi
521 return 1
522 fi
523
524 # and in newer versions we can also pull LOCALVERSION if it is set.
525 # but before we do this, we need to find if we use a different object directory.
526 # This *WILL* break if the user is using localversions, but we assume it was
527 # caught before this if they are.
528 OUTPUT_DIR="${OUTPUT_DIR:-/lib/modules/${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}/build}"
529
530 [ -h "${OUTPUT_DIR}" ] && KV_OUT_DIR="$(readlink -f ${OUTPUT_DIR})"
531 [ -d "${OUTPUT_DIR}" ] && KV_OUT_DIR="${OUTPUT_DIR}"
532 if [ -n "${KV_OUT_DIR}" ];
533 then
534 qeinfo "Found kernel object directory:"
535 qeinfo " ${KV_OUT_DIR}"
536 fi
537 # and if we STILL have not got it, then we better just set it to KV_DIR
538 KV_OUT_DIR="${KV_OUT_DIR:-${KV_DIR}}"
539
540 # Grab the kernel release from the output directory.
541 # TODO: we MUST detect kernel.release being out of date, and 'return 1' from
542 # this function.
543 if [ -s "${KV_OUT_DIR}"/include/config/kernel.release ]; then
544 KV_LOCAL=$(<"${KV_OUT_DIR}"/include/config/kernel.release)
545 elif [ -s "${KV_OUT_DIR}"/.kernelrelease ]; then
546 KV_LOCAL=$(<"${KV_OUT_DIR}"/.kernelrelease)
547 else
548 KV_LOCAL=
549 fi
550
551 # KV_LOCAL currently contains the full release; discard the first bits.
552 tmplocal=${KV_LOCAL#${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}}
553
554 # If the updated local version was not changed, the tree is not prepared.
555 # Clear out KV_LOCAL in that case.
556 # TODO: this does not detect a change in the localversion part between
557 # kernel.release and the value that would be generated.
558 if [ "$KV_LOCAL" = "$tmplocal" ]; then
559 KV_LOCAL=
560 else
561 KV_LOCAL=$tmplocal
562 fi
563
564 # And we should set KV_FULL to the full expanded version
565 KV_FULL="${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}${KV_LOCAL}"
566
567 qeinfo "Found sources for kernel version:"
568 qeinfo " ${KV_FULL}"
569
570 return 0
571 }
572
573 # @FUNCTION: get_running_version
574 # @DESCRIPTION:
575 # It gets the version of the current running kernel and the result is the same as get_version() if the
576 # function can find the sources.
577 get_running_version() {
578 KV_FULL=$(uname -r)
579
580 if [[ -f ${ROOT}/lib/modules/${KV_FULL}/source/Makefile && -f ${ROOT}/lib/modules/${KV_FULL}/build/Makefile ]]; then
581 KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/source)
582 KBUILD_OUTPUT=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/build)
583 unset KV_FULL
584 get_version
585 return $?
586 elif [[ -f ${ROOT}/lib/modules/${KV_FULL}/source/Makefile ]]; then
587 KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/source)
588 unset KV_FULL
589 get_version
590 return $?
591 elif [[ -f ${ROOT}/lib/modules/${KV_FULL}/build/Makefile ]]; then
592 KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/build)
593 unset KV_FULL
594 get_version
595 return $?
596 else
597 KV_MAJOR=$(get_version_component_range 1 ${KV_FULL})
598 KV_MINOR=$(get_version_component_range 2 ${KV_FULL})
599 KV_PATCH=$(get_version_component_range 3 ${KV_FULL})
600 KV_PATCH=${KV_PATCH//-*}
601 KV_EXTRA="${KV_FULL#${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}}"
602 fi
603 return 0
604 }
605
606 # This next function is named with the eclass prefix to avoid conflicts with
607 # some old versionator-like eclass functions.
608
609 # @FUNCTION: linux-info_get_any_version
610 # @DESCRIPTION:
611 # This attempts to find the version of the sources, and otherwise falls back to
612 # the version of the running kernel.
613 linux-info_get_any_version() {
614 get_version
615 if [[ $? -ne 0 ]]; then
616 ewarn "Unable to calculate Linux Kernel version for build, attempting to use running version"
617 get_running_version
618 fi
619 }
620
621
622 # ebuild check functions
623 # ---------------------------------------
624
625 # @FUNCTION: check_kernel_built
626 # @DESCRIPTION:
627 # This function verifies that the current kernel sources have been already prepared otherwise it dies.
628 check_kernel_built() {
629 # if we haven't determined the version yet, we need to
630 require_configured_kernel
631 get_version
632
633 if [ ! -f "${KV_OUT_DIR}/include/linux/version.h" ]
634 then
635 eerror "These sources have not yet been prepared."
636 eerror "We cannot build against an unprepared tree."
637 eerror "To resolve this, please type the following:"
638 eerror
639 eerror "# cd ${KV_DIR}"
640 eerror "# make oldconfig"
641 eerror "# make modules_prepare"
642 eerror
643 eerror "Then please try merging this module again."
644 die "Kernel sources need compiling first"
645 fi
646 }
647
648 # @FUNCTION: check_modules_supported
649 # @DESCRIPTION:
650 # This function verifies that the current kernel support modules (it checks CONFIG_MODULES=y) otherwise it dies.
651 check_modules_supported() {
652 # if we haven't determined the version yet, we need too.
653 require_configured_kernel
654 get_version
655
656 if ! linux_chkconfig_builtin "MODULES"
657 then
658 eerror "These sources do not support loading external modules."
659 eerror "to be able to use this module please enable \"Loadable modules support\""
660 eerror "in your kernel, recompile and then try merging this module again."
661 die "No support for external modules in ${KV_FULL} config"
662 fi
663 }
664
665 # @FUNCTION: check_extra_config
666 # @DESCRIPTION:
667 # It checks the kernel config options specified by CONFIG_CHECK. It dies only when a required config option (i.e.
668 # the prefix ~ is not used) doesn't satisfy the directive.
669 check_extra_config() {
670 local config negate die error reworkmodulenames
671 local soft_errors_count=0 hard_errors_count=0 config_required=0
672 # store the value of the QA check, because otherwise we won't catch usages
673 # after if check_extra_config is called AND other direct calls are done
674 # later.
675 local old_LINUX_CONFIG_EXISTS_DONE="${_LINUX_CONFIG_EXISTS_DONE}"
676
677 # if we haven't determined the version yet, we need to
678 linux-info_get_any_version
679
680 # Determine if we really need a .config. The only time when we don't need
681 # one is when all of the CONFIG_CHECK options are prefixed with "~".
682 for config in ${CONFIG_CHECK}
683 do
684 if [[ "${config:0:1}" != "~" ]]; then
685 config_required=1
686 break
687 fi
688 done
689
690 if [[ ${config_required} == 0 ]]; then
691 # In the case where we don't require a .config, we can now bail out
692 # if the user has no .config as there is nothing to do. Otherwise
693 # code later will cause a failure due to missing .config.
694 if ! linux_config_exists; then
695 ewarn "Unable to check for the following kernel config options due"
696 ewarn "to absence of any configured kernel sources or compiled"
697 ewarn "config:"
698 for config in ${CONFIG_CHECK}; do
699 local_error="ERROR_${config#\~}"
700 msg="${!local_error}"
701 if [[ "x${msg}" == "x" ]]; then
702 local_error="WARNING_${config#\~}"
703 msg="${!local_error}"
704 fi
705 ewarn " - ${config#\~}${msg:+ - }${msg}"
706 done
707 ewarn "You're on your own to make sure they are set if needed."
708 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
709 return 0
710 fi
711 else
712 require_configured_kernel
713 fi
714
715 einfo "Checking for suitable kernel configuration options..."
716
717 for config in ${CONFIG_CHECK}
718 do
719 # if we specify any fatal, ensure we honor them
720 die=1
721 error=0
722 negate=0
723 reworkmodulenames=0
724
725 if [[ ${config:0:1} == "~" ]]; then
726 die=0
727 config=${config:1}
728 elif [[ ${config:0:1} == "@" ]]; then
729 die=0
730 reworkmodulenames=1
731 config=${config:1}
732 fi
733 if [[ ${config:0:1} == "!" ]]; then
734 negate=1
735 config=${config:1}
736 fi
737
738 if [[ ${negate} == 1 ]]; then
739 linux_chkconfig_present ${config} && error=2
740 elif [[ ${reworkmodulenames} == 1 ]]; then
741 local temp_config="${config//*:}" i n
742 config="${config//:*}"
743 if linux_chkconfig_present ${config}; then
744 for i in ${MODULE_NAMES}; do
745 n="${i//${temp_config}}"
746 [[ -z ${n//\(*} ]] && \
747 MODULE_IGNORE="${MODULE_IGNORE} ${temp_config}"
748 done
749 error=2
750 fi
751 else
752 linux_chkconfig_present ${config} || error=1
753 fi
754
755 if [[ ${error} > 0 ]]; then
756 local report_func="eerror" local_error
757 local_error="ERROR_${config}"
758 local_error="${!local_error}"
759
760 if [[ -z "${local_error}" ]]; then
761 # using old, deprecated format.
762 local_error="${config}_ERROR"
763 local_error="${!local_error}"
764 fi
765 if [[ ${die} == 0 && -z "${local_error}" ]]; then
766 #soft errors can be warnings
767 local_error="WARNING_${config}"
768 local_error="${!local_error}"
769 if [[ -n "${local_error}" ]] ; then
770 report_func="ewarn"
771 fi
772 fi
773
774 if [[ -z "${local_error}" ]]; then
775 [[ ${error} == 1 ]] \
776 && local_error="is not set when it should be." \
777 || local_error="should not be set. But it is."
778 local_error="CONFIG_${config}:\t ${local_error}"
779 fi
780 if [[ ${die} == 0 ]]; then
781 ${report_func} " ${local_error}"
782 soft_errors_count=$[soft_errors_count + 1]
783 else
784 ${report_func} " ${local_error}"
785 hard_errors_count=$[hard_errors_count + 1]
786 fi
787 fi
788 done
789
790 if [[ ${hard_errors_count} > 0 ]]; then
791 eerror "Please check to make sure these options are set correctly."
792 eerror "Failure to do so may cause unexpected problems."
793 eerror "Once you have satisfied these options, please try merging"
794 eerror "this package again."
795 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
796 die "Incorrect kernel configuration options"
797 elif [[ ${soft_errors_count} > 0 ]]; then
798 ewarn "Please check to make sure these options are set correctly."
799 ewarn "Failure to do so may cause unexpected problems."
800 else
801 eend 0
802 fi
803 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
804 }
805
806 check_zlibinflate() {
807 # if we haven't determined the version yet, we need to
808 require_configured_kernel
809 get_version
810
811 # although I restructured this code - I really really really dont support it!
812
813 # bug #27882 - zlib routines are only linked into the kernel
814 # if something compiled into the kernel calls them
815 #
816 # plus, for the cloop module, it appears that there's no way
817 # to get cloop.o to include a static zlib if CONFIG_MODVERSIONS
818 # is on
819
820 local INFLATE
821 local DEFLATE
822
823 einfo "Determining the usability of ZLIB_INFLATE support in your kernel"
824
825 ebegin "checking ZLIB_INFLATE"
826 linux_chkconfig_builtin CONFIG_ZLIB_INFLATE
827 eend $?
828 [ "$?" != 0 ] && die
829
830 ebegin "checking ZLIB_DEFLATE"
831 linux_chkconfig_builtin CONFIG_ZLIB_DEFLATE
832 eend $?
833 [ "$?" != 0 ] && die
834
835 local LINENO_START
836 local LINENO_END
837 local SYMBOLS
838 local x
839
840 LINENO_END="$(grep -n 'CONFIG_ZLIB_INFLATE y' ${KV_DIR}/lib/Config.in | cut -d : -f 1)"
841 LINENO_START="$(head -n $LINENO_END ${KV_DIR}/lib/Config.in | grep -n 'if \[' | tail -n 1 | cut -d : -f 1)"
842 (( LINENO_AMOUNT = $LINENO_END - $LINENO_START ))
843 (( LINENO_END = $LINENO_END - 1 ))
844 SYMBOLS="$(head -n $LINENO_END ${KV_DIR}/lib/Config.in | tail -n $LINENO_AMOUNT | sed -e 's/^.*\(CONFIG_[^\" ]*\).*/\1/g;')"
845
846 # okay, now we have a list of symbols
847 # we need to check each one in turn, to see whether it is set or not
848 for x in $SYMBOLS ; do
849 if [ "${!x}" = "y" ]; then
850 # we have a winner!
851 einfo "${x} ensures zlib is linked into your kernel - excellent"
852 return 0
853 fi
854 done
855
856 eerror
857 eerror "This kernel module requires ZLIB library support."
858 eerror "You have enabled zlib support in your kernel, but haven't enabled"
859 eerror "enabled any option that will ensure that zlib is linked into your"
860 eerror "kernel."
861 eerror
862 eerror "Please ensure that you enable at least one of these options:"
863 eerror
864
865 for x in $SYMBOLS ; do
866 eerror " * $x"
867 done
868
869 eerror
870 eerror "Please remember to recompile and install your kernel, and reboot"
871 eerror "into your new kernel before attempting to load this kernel module."
872
873 die "Kernel doesn't include zlib support"
874 }
875
876 ################################
877 # Default pkg_setup
878 # Also used when inheriting linux-mod to force a get_version call
879 # @FUNCTION: linux-info_pkg_setup
880 # @DESCRIPTION:
881 # Force a get_version() call when inherited from linux-mod.eclass and then check if the kernel is configured
882 # to support the options specified in CONFIG_CHECK (if not null)
883 linux-info_pkg_setup() {
884 linux-info_get_any_version
885
886 if kernel_is 2 4; then
887 if [ "$( gcc-major-version )" -eq "4" ] ; then
888 echo
889 ewarn "Be warned !! >=sys-devel/gcc-4.0.0 isn't supported with"
890 ewarn "linux-2.4 (or modules building against a linux-2.4 kernel)!"
891 echo
892 ewarn "Either switch to another gcc-version (via gcc-config) or use a"
893 ewarn "newer kernel that supports gcc-4."
894 echo
895 ewarn "Also be aware that bugreports about gcc-4 not working"
896 ewarn "with linux-2.4 based ebuilds will be closed as INVALID!"
897 echo
898 epause 10
899 fi
900 fi
901
902 [ -n "${CONFIG_CHECK}" ] && check_extra_config;
903 }

  ViewVC Help
Powered by ViewVC 1.1.20