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

Contents of /eclass/linux-info.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.92 - (show annotations) (download)
Tue Jun 26 00:06:14 2012 UTC (2 years, 3 months ago) by robbat2
Branch: MAIN
Changes since 1.91: +10 -2 lines
You must ensure at least one of the version setup functions gets called in linux-info.eclass before you can use the config functions.

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

  ViewVC Help
Powered by ViewVC 1.1.20