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

Legend:
Removed from v.1.55  
changed lines
  Added in v.1.89

  ViewVC Help
Powered by ViewVC 1.1.20