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

Diff of /eclass/linux-info.eclass

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

Revision 1.3 Revision 1.90
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-info.eclass,v 1.3 2004/11/27 11:26:52 johnm Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/linux-info.eclass,v 1.90 2011/08/22 04:46:32 vapier Exp $
4#
5# This eclass provides functions for querying the installed kernel
6# source version, selected kernel options etc.
7#
8 4
9ECLASS=linux-info 5# @ECLASS: linux-info.eclass
10INHERITED="$INHERITED $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
102inherit toolchain-funcs versionator
103
104EXPORT_FUNCTIONS pkg_setup
105
106DEPEND=""
107RDEPEND=""
11 108
12# Overwritable environment Var's 109# Overwritable environment Var's
13# --------------------------------------- 110# ---------------------------------------
14KERNEL_DIR="${KERNEL_DIR:-/usr/src/linux}" 111KERNEL_DIR="${KERNEL_DIR:-${ROOT}usr/src/linux}"
15 112
16 113
114# Bug fixes
115# fix to bug #75034
116case ${ARCH} in
117 ppc) BUILD_FIXES="${BUILD_FIXES} TOUT=${T}/.tmp_gas_check";;
118 ppc64) BUILD_FIXES="${BUILD_FIXES} TOUT=${T}/.tmp_gas_check";;
119esac
120
121# @FUNCTION: set_arch_to_kernel
122# @DESCRIPTION:
123# Set the env ARCH to match what the kernel expects.
124set_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.
128set_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.
134qout() {
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
147qeinfo() { qout einfo "${@}" ; }
148qewarn() { qout ewarn "${@}" ; }
149qeerror() { qout eerror "${@}" ; }
17 150
18# File Functions 151# File Functions
19# --------------------------------------- 152# ---------------------------------------
20 153
21# getfilevar accepts 2 vars as follows: 154# @FUNCTION: getfilevar
22# getfilevar <VARIABLE> <CONFIGFILE> 155# @USAGE: variable configfile
23 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!
24getfilevar() { 161getfilevar() {
25local ERROR 162local ERROR basefname basedname myARCH="${ARCH}"
26 ERROR=0 163 ERROR=0
27 164
28 [ -z "${1}" ] && ERROR=1 165 [ -z "${1}" ] && ERROR=1
29 [ -z "${2}" ] && ERROR=1
30 [ ! -f "${2}" ] && ERROR=1 166 [ ! -f "${2}" ] && ERROR=1
31 167
32 if [ "${ERROR}" = 1 ] 168 if [ "${ERROR}" = 1 ]
33 then 169 then
170 echo -e "\n"
34 eerror "getfilevar requires 2 variables, with the second a valid file." 171 eerror "getfilevar requires 2 variables, with the second a valid file."
35 eerror " getfilevar <VARIABLE> <CONFIGFILE>" 172 eerror " getfilevar <VARIABLE> <CONFIGFILE>"
36 else 173 else
37 grep -e "^$1[= ]" $2 | sed 's: = :=:' | cut -d= -f2- 174 basefname="$(basename ${2})"
38 fi 175 basedname="$(dirname ${2})"
39} 176 unset ARCH
40 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.
41getfilevar_isset() { 192getfilevar_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
226linux_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
238linux_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
247linux_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.
259linux_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.
267require_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.
284linux_chkconfig_present() {
285 linux_config_qa_check linux_chkconfig_present
42local RESULT 286 local RESULT
43 RESULT="$(getfilevar ${1} ${2})" 287 local config
288 config="${KV_OUT_DIR}/.config"
289 [ ! -f "${config}" ] && config="/proc/config.gz"
290 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
44 [ "${RESULT}" = "m" -o "${RESULT}" = "y" ] && return 0 || return 1 291 [ "${RESULT}" = "m" -o "${RESULT}" = "y" ] && return 0 || return 1
45} 292}
46 293
47getfilevar_ismodule() { 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.
301linux_chkconfig_module() {
302 linux_config_qa_check linux_chkconfig_module
48local RESULT 303 local RESULT
49 RESULT="$(getfilevar ${1} ${2})" 304 local config
305 config="${KV_OUT_DIR}/.config"
306 [ ! -f "${config}" ] && config="/proc/config.gz"
307 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
50 [ "${RESULT}" = "m" ] && return 0 || return 1 308 [ "${RESULT}" = "m" ] && return 0 || return 1
51} 309}
52 310
53getfilevar_isbuiltin() { 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.
318linux_chkconfig_builtin() {
319 linux_config_qa_check linux_chkconfig_builtin
54local RESULT 320 local RESULT
55 RESULT="$(getfilevar ${1} ${2})" 321 local config
322 config="${KV_OUT_DIR}/.config"
323 [ ! -f "${config}" ] && config="/proc/config.gz"
324 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
56 [ "${RESULT}" = "y" ] && return 0 || return 1 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.
335linux_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}"
57} 341}
58 342
59# Versioning Functions 343# Versioning Functions
60# --------------------------------------- 344# ---------------------------------------
61 345
62# kernel_is returns true when the version is the same as the passed version 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.
63# 352#
353# @CODE
64# For Example where KV = 2.6.9 354# For Example where KV = 2.6.9
65# kernel_is 2 4 returns false 355# kernel_is 2 4 returns false
66# kernel_is 2 returns true 356# kernel_is 2 returns true
67# kernel_is 2 6 returns true 357# kernel_is 2 6 returns true
68# kernel_is 2 6 8 returns false 358# kernel_is 2 6 8 returns false
69# kernel_is 2 6 9 returns true 359# kernel_is 2 6 9 returns true
70# 360# @CODE
361
71# got the jist yet? 362# got the jist yet?
72 363
73kernel_is() { 364kernel_is() {
74 # if we haven't determined the version yet, we need too. 365 # if we haven't determined the version yet, we need to.
75 get_version; 366 linux-info_get_any_version
76
77 local RESULT
78 RESULT=1
79
80 if [ -n "${1}" ]
81 then
82 [ "${1}" = "${KV_MAJOR}" ] && RESULT=0
83 fi
84
85 if [ -n "${2}" ]
86 then
87 RESULT=1
88 [ "${2}" = "${KV_MINOR}" ] && RESULT=0
89 fi
90
91 if [ -n "${3}" ]
92 then
93 RESULT=1
94 [ "${3}" = "${KV_PATCH}" ] && RESULT=0
95 fi
96 return ${RESULT}
97}
98 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
398get_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
420get_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
429get_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).
99get_version() { 441get_version() {
442 local kbuild_output mkfunc tmplocal
443
100 # no need to execute this twice assuming KV_FULL is populated. 444 # no need to execute this twice assuming KV_FULL is populated.
101 # we can force by unsetting KV_FULL 445 # we can force by unsetting KV_FULL
102 if [ -n "${KV_FULL}" ] 446 [ -n "${KV_FULL}" ] && return 0
103 then
104 # Lets keep this quiet eh?
105 # einfo "\${KV_FULL} is already set. Not running get_version again"
106 return
107 fi
108 447
109 # if we dont know KV_FULL, then we need too. 448 # if we dont know KV_FULL, then we need too.
110 # make sure KV_DIR isnt set since we need to work it out via KERNEL_DIR 449 # make sure KV_DIR isnt set since we need to work it out via KERNEL_DIR
111 unset KV_DIR 450 unset KV_DIR
112 451
113 # KV_DIR will contain the full path to the sources directory we should use 452 # KV_DIR will contain the full path to the sources directory we should use
453 [ -z "${get_version_warning_done}" ] && \
114 einfo "Determining the location of the kernel source code" 454 qeinfo "Determining the location of the kernel source code"
115 [ -h "${KERNEL_DIR}" ] && KV_DIR="$(readlink -f ${KERNEL_DIR})" 455 [ -h "${KERNEL_DIR}" ] && KV_DIR="$(readlink -f ${KERNEL_DIR})"
116 [ -d "${KERNEL_DIR}" ] && KV_DIR="${KERNEL_DIR}" 456 [ -d "${KERNEL_DIR}" ] && KV_DIR="${KERNEL_DIR}"
117 457
118 if [ -z "${KV_DIR}" ] 458 if [ -z "${KV_DIR}" ]
119 then 459 then
460 if [ -z "${get_version_warning_done}" ]; then
461 get_version_warning_done=1
120 eerror "Unable to find kernel sources at ${KERNEL_DIR}" 462 qeerror "Unable to find kernel sources at ${KERNEL_DIR}"
121 die 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
122 fi 471 fi
123 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
124 # And contrary to existing functions I feel we shouldn't trust the 506 # And contrary to existing functions I feel we shouldn't trust the
125 # directory name to find version information as this seems insane. 507 # directory name to find version information as this seems insane.
126 # so we parse ${KV_DIR}/Makefile 508 # so we parse ${KERNEL_MAKEFILE}
127 KV_MAJOR="$(getfilevar VERSION ${KV_DIR}/Makefile)" 509 KV_MAJOR="$(${mkfunc} VERSION ${KERNEL_MAKEFILE})"
128 KV_MINOR="$(getfilevar PATCHLEVEL ${KV_DIR}/Makefile)" 510 KV_MINOR="$(${mkfunc} PATCHLEVEL ${KERNEL_MAKEFILE})"
129 KV_PATCH="$(getfilevar SUBLEVEL ${KV_DIR}/Makefile)" 511 KV_PATCH="$(${mkfunc} SUBLEVEL ${KERNEL_MAKEFILE})"
130 KV_EXTRA="$(getfilevar EXTRAVERSION ${KV_DIR}/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
131 # and in newer versions we can also pull LOCALVERSION if it is set. 524 # and in newer versions we can also pull LOCALVERSION if it is set.
132 KV_LOCAL="$(cat ${KV_DIR}/localversion* 2>/dev/null)$(getfilevar CONFIG_LOCALVERSION ${KV_DIR}/.config | sed 's:"::g')" 525 # but before we do this, we need to find if we use a different object directory.
133 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
134 # And we should set KV_FULL to the full expanded version 564 # And we should set KV_FULL to the full expanded version
135 KV_FULL="${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}${KV_LOCAL}" 565 KV_FULL="${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}${KV_LOCAL}"
136 566
137 if [ -z "${KV_FULL}" ] 567 qeinfo "Found sources for kernel version:"
138 then 568 qeinfo " ${KV_FULL}"
139 eerror "We are unable to find a usable kernel source tree in ${KV_DIR}" 569
140 eerror "Please check a kernel source exists in this directory." 570 return 0
141 die 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.
577get_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 $?
142 else 596 else
143 einfo "Found kernel source directory:" 597 KV_MAJOR=$(get_version_component_range 1 ${KV_FULL})
144 einfo " ${KV_DIR}" 598 KV_MINOR=$(get_version_component_range 2 ${KV_FULL})
145 einfo "with sources for kernel version:" 599 KV_PATCH=$(get_version_component_range 3 ${KV_FULL})
146 einfo " ${KV_FULL}" 600 KV_PATCH=${KV_PATCH//-*}
601 KV_EXTRA="${KV_FULL#${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}}"
147 fi 602 fi
603 return 0
148} 604}
149 605
606# This next function is named with the eclass prefix to avoid conflicts with
607# some old versionator-like eclass functions.
150 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.
613linux-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}
151 620
152 621
153# ebuild check functions 622# ebuild check functions
154# --------------------------------------- 623# ---------------------------------------
155 624
625# @FUNCTION: check_kernel_built
626# @DESCRIPTION:
627# This function verifies that the current kernel sources have been already prepared otherwise it dies.
156check_kernel_built() { 628check_kernel_built() {
157 # if we haven't determined the version yet, we need too. 629 # if we haven't determined the version yet, we need to
630 require_configured_kernel
158 get_version; 631 get_version
159 632
160 if [ ! -f "${KV_DIR}/System.map" ] 633 if [ ! -f "${KV_OUT_DIR}/include/linux/version.h" ]
161 then 634 then
162 eerror "These sources have not yet been compiled." 635 eerror "These sources have not yet been prepared."
163 eerror "We cannot build against an uncompiled tree." 636 eerror "We cannot build against an unprepared tree."
164 eerror "To resolve this, please type the following:" 637 eerror "To resolve this, please type the following:"
165 eerror 638 eerror
166 eerror "# cd ${KV_DIR}" 639 eerror "# cd ${KV_DIR}"
167 eerror "# make oldconfig" 640 eerror "# make oldconfig"
168 eerror "# make bzImage modules modules_install" 641 eerror "# make modules_prepare"
169 eerror 642 eerror
170 eerror "Then please try merging this module again." 643 eerror "Then please try merging this module again."
171 die "Kernel sources need compiling first" 644 die "Kernel sources need compiling first"
172 fi 645 fi
173} 646}
174 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.
175check_modules_supported() { 651check_modules_supported() {
176 # if we haven't determined the version yet, we need too. 652 # if we haven't determined the version yet, we need too.
653 require_configured_kernel
177 get_version; 654 get_version
178 655
179 getfilevar_isset CONFIG_MODULES ${KV_DIR}/.config 656 if ! linux_chkconfig_builtin "MODULES"
180 if [ "$?" != 0 ]
181 then 657 then
182 eerror "These sources do not support loading external modules." 658 eerror "These sources do not support loading external modules."
183 eerror "to be able to use this module please enable \"Loadable modules support\"" 659 eerror "to be able to use this module please enable \"Loadable modules support\""
184 eerror "in your kernel, recompile and then try merging this module again." 660 eerror "in your kernel, recompile and then try merging this module again."
185 die No support for external modules in ${KV_FUll} config 661 die "No support for external modules in ${KV_FULL} config"
186 fi 662 fi
187} 663}
188 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.
189check_extra_config() { 669check_extra_config() {
190local config negate error 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}"
191 676
192 # if we haven't determined the version yet, we need too. 677 # if we haven't determined the version yet, we need to
193 get_version; 678 linux-info_get_any_version
194 679
195 einfo "Checking for suitable kernel configuration options" 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 "~".
196 for config in ${CONFIG_CHECK} 682 for config in ${CONFIG_CHECK}
197 do 683 do
198 negate="${config:0:1}" 684 if [[ "${config:0:1}" != "~" ]]; then
199 if [ "${negate}" == "!" ]; 685 config_required=1
200 then 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
201 config="${config:1}" 727 config=${config:1}
202 if getfilevar_isset ${config} ${KV_DIR}/.config ; 728 elif [[ ${config:0:1} == "@" ]]; then
203 then 729 die=0
204 eerror " ${config}:\tshould not be set in the kernel configuration, but it is." 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
205 error=1 749 error=2
206 fi 750 fi
207 else 751 else
208 if ! getfilevar_isset ${config} ${KV_DIR}/.config ; 752 linux_chkconfig_present ${config} || error=1
209 then 753 fi
210 eerror " ${config}:\tshould be set in the kernel configuration, but isn't" 754
211 error=1 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}"
212 fi 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
213 fi 787 fi
214 done 788 done
215 789
216 if [ -n "${error}" ] ; 790 if [[ ${hard_errors_count} > 0 ]]; then
217 then
218 eerror "Please check to make sure these options are set correctly." 791 eerror "Please check to make sure these options are set correctly."
792 eerror "Failure to do so may cause unexpected problems."
219 eerror "Once you have satisfied these options, please try merging" 793 eerror "Once you have satisfied these options, please try merging"
220 eerror "this package again." 794 eerror "this package again."
795 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
221 die Incorrect kernel configuration options 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
222 fi 802 fi
803 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
223} 804}
224 805
225check_zlibinflate() { 806check_zlibinflate() {
226 # if we haven't determined the version yet, we need too. 807 # if we haven't determined the version yet, we need to
808 require_configured_kernel
227 get_version; 809 get_version
228 810
229 # although I restructured this code - I really really really dont support it! 811 # although I restructured this code - I really really really dont support it!
230 812
231 # bug #27882 - zlib routines are only linked into the kernel 813 # bug #27882 - zlib routines are only linked into the kernel
232 # if something compiled into the kernel calls them 814 # if something compiled into the kernel calls them
233 # 815 #
234 # plus, for the cloop module, it appears that there's no way 816 # plus, for the cloop module, it appears that there's no way
235 # to get cloop.o to include a static zlib if CONFIG_MODVERSIONS 817 # to get cloop.o to include a static zlib if CONFIG_MODVERSIONS
236 # is on 818 # is on
237 819
238local INFLATE 820 local INFLATE
239local DEFLATE 821 local DEFLATE
240 822
241 einfo "Determining the usability of ZLIB_INFLATE support in your kernel" 823 einfo "Determining the usability of ZLIB_INFLATE support in your kernel"
242 824
243 ebegin "checking ZLIB_INFLATE" 825 ebegin "checking ZLIB_INFLATE"
244 getfilevar_isbuiltin CONFIG_ZLIB_INFLATE ${KV_DIR}/.config 826 linux_chkconfig_builtin CONFIG_ZLIB_INFLATE
245 eend $? 827 eend $?
246 [ "$?" != 0 ] && die 828 [ "$?" != 0 ] && die
247 829
248 ebegin "checking ZLIB_DEFLATE" 830 ebegin "checking ZLIB_DEFLATE"
249 getfilevar_isbuiltin CONFIG_ZLIB_DEFLATE ${KV_DIR}/.config 831 linux_chkconfig_builtin CONFIG_ZLIB_DEFLATE
250 eend $? 832 eend $?
251 [ "$?" != 0 ] && die 833 [ "$?" != 0 ] && die
252 834
253
254 local LINENO_START 835 local LINENO_START
255 local LINENO_END 836 local LINENO_END
256 local SYMBOLS 837 local SYMBOLS
257 local x 838 local x
258 839
259 LINENO_END="$(grep -n 'CONFIG_ZLIB_INFLATE y' ${KV_DIR}/lib/Config.in | cut -d : -f 1)" 840 LINENO_END="$(grep -n 'CONFIG_ZLIB_INFLATE y' ${KV_DIR}/lib/Config.in | cut -d : -f 1)"
260 LINENO_START="$(head -n $LINENO_END ${KV_DIR}/lib/Config.in | grep -n 'if \[' | tail -n 1 | 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)"
261 (( LINENO_AMOUNT = $LINENO_END - $LINENO_START )) 842 (( LINENO_AMOUNT = $LINENO_END - $LINENO_START ))
262 (( LINENO_END = $LINENO_END - 1 )) 843 (( LINENO_END = $LINENO_END - 1 ))
263 SYMBOLS="$(head -n $LINENO_END ${KERNEL_DIR}/lib/Config.in | tail -n $LINENO_AMOUNT | sed -e 's/^.*\(CONFIG_[^\" ]*\).*/\1/g;')" 844 SYMBOLS="$(head -n $LINENO_END ${KV_DIR}/lib/Config.in | tail -n $LINENO_AMOUNT | sed -e 's/^.*\(CONFIG_[^\" ]*\).*/\1/g;')"
264 845
265 # okay, now we have a list of symbols 846 # okay, now we have a list of symbols
266 # we need to check each one in turn, to see whether it is set or not 847 # we need to check each one in turn, to see whether it is set or not
267 for x in $SYMBOLS ; do 848 for x in $SYMBOLS ; do
268 if [ "${!x}" = "y" ]; then 849 if [ "${!x}" = "y" ]; then
269 # we have a winner! 850 # we have a winner!
270 einfo "${x} ensures zlib is linked into your kernel - excellent" 851 einfo "${x} ensures zlib is linked into your kernel - excellent"
271 return 0 852 return 0
272 fi 853 fi
273 done 854 done
274 855
275 eerror 856 eerror
276 eerror "This kernel module requires ZLIB library support." 857 eerror "This kernel module requires ZLIB library support."
277 eerror "You have enabled zlib support in your kernel, but haven't enabled" 858 eerror "You have enabled zlib support in your kernel, but haven't enabled"
278 eerror "enabled any option that will ensure that zlib is linked into your" 859 eerror "enabled any option that will ensure that zlib is linked into your"
279 eerror "kernel." 860 eerror "kernel."
289 eerror "Please remember to recompile and install your kernel, and reboot" 870 eerror "Please remember to recompile and install your kernel, and reboot"
290 eerror "into your new kernel before attempting to load this kernel module." 871 eerror "into your new kernel before attempting to load this kernel module."
291 872
292 die "Kernel doesn't include zlib support" 873 die "Kernel doesn't include zlib support"
293} 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)
883linux-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}

Legend:
Removed from v.1.3  
changed lines
  Added in v.1.90

  ViewVC Help
Powered by ViewVC 1.1.20