/[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.51 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.51 2007/10/01 13:16:44 vapier Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/linux-info.eclass,v 1.89 2011/08/18 14:58:57 vapier Exp $
4# 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#
11# Maintainer: John Mylchreest <johnm@gentoo.org> 5# Original author: John Mylchreest <johnm@gentoo.org>
12# Copyright 2004 Gentoo Linux 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 :)
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.
15 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'
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.
261linux_config_exists() {
262 linux_config_src_exists || linux_config_bin_exists
263}
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.
269require_configured_kernel() {
270 if ! linux_config_src_exists; then
271 qeerror "Could not find a usable .config in the kernel source directory."
272 qeerror "Please ensure that ${KERNEL_DIR} points to a configured set of Linux sources."
273 qeerror "If you are using KBUILD_OUTPUT, please set the environment var so that"
274 qeerror "it points to the necessary object directory so that it might find .config."
275 die "Kernel not configured; no .config found in ${KV_OUT_DIR}"
276 fi
277}
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.
134linux_chkconfig_present() { 286linux_chkconfig_present() {
287 linux_config_qa_check linux_chkconfig_present
135local RESULT 288 local RESULT
289 local config
290 config="${KV_OUT_DIR}/.config"
291 [ ! -f "${config}" ] && config="/proc/config.gz"
136 RESULT="$(getfilevar CONFIG_${1} ${KV_OUT_DIR}/.config)" 292 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
137 [ "${RESULT}" = "m" -o "${RESULT}" = "y" ] && return 0 || return 1 293 [ "${RESULT}" = "m" -o "${RESULT}" = "y" ] && return 0 || return 1
138} 294}
139 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.
140linux_chkconfig_module() { 303linux_chkconfig_module() {
304 linux_config_qa_check linux_chkconfig_module
141local RESULT 305 local RESULT
306 local config
307 config="${KV_OUT_DIR}/.config"
308 [ ! -f "${config}" ] && config="/proc/config.gz"
142 RESULT="$(getfilevar CONFIG_${1} ${KV_OUT_DIR}/.config)" 309 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
143 [ "${RESULT}" = "m" ] && return 0 || return 1 310 [ "${RESULT}" = "m" ] && return 0 || return 1
144} 311}
145 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.
146linux_chkconfig_builtin() { 320linux_chkconfig_builtin() {
321 linux_config_qa_check linux_chkconfig_builtin
147local RESULT 322 local RESULT
323 local config
324 config="${KV_OUT_DIR}/.config"
325 [ ! -f "${config}" ] && config="/proc/config.gz"
148 RESULT="$(getfilevar CONFIG_${1} ${KV_OUT_DIR}/.config)" 326 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
149 [ "${RESULT}" = "y" ] && return 0 || return 1 327 [ "${RESULT}" = "y" ] && return 0 || return 1
150} 328}
151 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.
152linux_chkconfig_string() { 337linux_chkconfig_string() {
338 linux_config_qa_check linux_chkconfig_string
339 local config
340 config="${KV_OUT_DIR}/.config"
341 [ ! -f "${config}" ] && config="/proc/config.gz"
153 getfilevar "CONFIG_${1}" "${KV_OUT_DIR}/.config" 342 getfilevar_noexec "CONFIG_${1}" "${config}"
154} 343}
155 344
156# Versioning Functions 345# Versioning Functions
157# --------------------------------------- 346# ---------------------------------------
158 347
159# 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.
160# 354#
355# @CODE
161# For Example where KV = 2.6.9 356# For Example where KV = 2.6.9
162# kernel_is 2 4 returns false 357# kernel_is 2 4 returns false
163# kernel_is 2 returns true 358# kernel_is 2 returns true
164# kernel_is 2 6 returns true 359# kernel_is 2 6 returns true
165# kernel_is 2 6 8 returns false 360# kernel_is 2 6 8 returns false
166# kernel_is 2 6 9 returns true 361# kernel_is 2 6 9 returns true
167# 362# @CODE
363
168# got the jist yet? 364# got the jist yet?
169 365
170kernel_is() { 366kernel_is() {
171 # if we haven't determined the version yet, we need too. 367 # if we haven't determined the version yet, we need to.
172 get_version; 368 linux-info_get_any_version
369
173 local operator test value x=0 y=0 z=0 370 local operator testagainst value x=0 y=0 z=0
174 371
175 case ${1} in 372 case ${1} in
176 lt) operator="-lt"; shift;; 373 -lt|lt) operator="-lt"; shift;;
177 gt) operator="-gt"; shift;; 374 -gt|gt) operator="-gt"; shift;;
178 le) operator="-le"; shift;; 375 -le|le) operator="-le"; shift;;
179 ge) operator="-ge"; shift;; 376 -ge|ge) operator="-ge"; shift;;
180 eq) operator="-eq"; shift;; 377 -eq|eq) operator="-eq"; shift;;
181 *) operator="-eq";; 378 *) operator="-eq";;
182 esac 379 esac
183 380
184 for x in ${@}; do 381 for x in ${@}; do
185 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
186 value="${value}${x}" 383 value="${value}${x}"
187 z=$((${z} + 1)) 384 z=$((${z} + 1))
188 385
189 case ${z} in 386 case ${z} in
190 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;
191 test="${test}${KV_MAJOR}";; 388 testagainst="${testagainst}${KV_MAJOR}";;
192 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;
193 test="${test}${KV_MINOR}";; 390 testagainst="${testagainst}${KV_MINOR}";;
194 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;
195 test="${test}${KV_PATCH}";; 392 testagainst="${testagainst}${KV_PATCH}";;
196 *) die "Error in kernel-2_kernel_is(): Too many parameters.";; 393 *) die "Error in kernel-2_kernel_is(): Too many parameters.";;
197 esac 394 esac
198 done 395 done
199 396
200 [ ${test} ${operator} ${value} ] && return 0 || return 1 397 [ "${testagainst}" ${operator} "${value}" ] && return 0 || return 1
201} 398}
202 399
203get_localversion() { 400get_localversion() {
204 local lv_list i x 401 local lv_list i x
205 402
213 done 410 done
214 x=${x/ /} 411 x=${x/ /}
215 echo ${x} 412 echo ${x}
216} 413}
217 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).
218get_version() { 443get_version() {
219 local kbuild_output 444 local kbuild_output mkfunc tmplocal
220 445
221 # no need to execute this twice assuming KV_FULL is populated. 446 # no need to execute this twice assuming KV_FULL is populated.
222 # we can force by unsetting KV_FULL 447 # we can force by unsetting KV_FULL
223 [ -n "${KV_FULL}" ] && return 0 448 [ -n "${KV_FULL}" ] && return 0
224 449
225 # if we dont know KV_FULL, then we need too. 450 # if we dont know KV_FULL, then we need too.
226 # 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
227 unset KV_DIR 452 unset KV_DIR
228 453
229 # 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}" ] && \
230 qeinfo "Determining the location of the kernel source code" 456 qeinfo "Determining the location of the kernel source code"
231 [ -h "${KERNEL_DIR}" ] && KV_DIR="$(readlink -f ${KERNEL_DIR})" 457 [ -h "${KERNEL_DIR}" ] && KV_DIR="$(readlink -f ${KERNEL_DIR})"
232 [ -d "${KERNEL_DIR}" ] && KV_DIR="${KERNEL_DIR}" 458 [ -d "${KERNEL_DIR}" ] && KV_DIR="${KERNEL_DIR}"
233 459
234 if [ -z "${KV_DIR}" ] 460 if [ -z "${KV_DIR}" ]
235 then 461 then
462 if [ -z "${get_version_warning_done}" ]; then
463 get_version_warning_done=1
236 qeerror "Unable to find kernel sources at ${KERNEL_DIR}" 464 qeerror "Unable to find kernel sources at ${KERNEL_DIR}"
237 qeinfo "This package requires Linux sources." 465 #qeinfo "This package requires Linux sources."
238 if [ "${KERNEL_DIR}" == "/usr/src/linux" ] ; then 466 if [ "${KERNEL_DIR}" == "/usr/src/linux" ] ; then
239 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, "
240 qeinfo "(or the kernel you wish to build against)." 468 qeinfo "(or the kernel you wish to build against)."
241 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"
242 else 470 else
243 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
244 fi 473 fi
245 return 1 474 return 1
246 fi 475 fi
247 476
477 if [ -z "${get_version_warning_done}" ]; then
248 qeinfo "Found kernel source directory:" 478 qeinfo "Found kernel source directory:"
249 qeinfo " ${KV_DIR}" 479 qeinfo " ${KV_DIR}"
480 fi
250 481
251 if [ ! -s "${KV_DIR}/Makefile" ] 482 if [ ! -s "${KV_DIR}/Makefile" ]
252 then 483 then
484 if [ -z "${get_version_warning_done}" ]; then
485 get_version_warning_done=1
253 qeerror "Could not find a Makefile in the kernel source directory." 486 qeerror "Could not find a Makefile in the kernel source directory."
254 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
255 return 1 489 return 1
256 fi 490 fi
257 491
258 # 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
259 # KBUILD_OUTPUT, and we need this for .config and localversions-* 493 # KBUILD_OUTPUT, and we need this for .config and localversions-*
260 # so we better find it eh? 494 # so we better find it eh?
261 # do we pass KBUILD_OUTPUT on the CLI? 495 # do we pass KBUILD_OUTPUT on the CLI?
262 OUTPUT_DIR="${OUTPUT_DIR:-${KBUILD_OUTPUT}}" 496 OUTPUT_DIR="${OUTPUT_DIR:-${KBUILD_OUTPUT}}"
263 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
264 # 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
265 kbuild_output="$(getfilevar KBUILD_OUTPUT ${KV_DIR}/Makefile)" 505 kbuild_output="$(${mkfunc} KBUILD_OUTPUT ${KERNEL_MAKEFILE})"
266 OUTPUT_DIR="${OUTPUT_DIR:-${kbuild_output}}" 506 OUTPUT_DIR="${OUTPUT_DIR:-${kbuild_output}}"
267 507
268 # 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
269 # directory name to find version information as this seems insane. 509 # directory name to find version information as this seems insane.
270 # so we parse ${KV_DIR}/Makefile 510 # so we parse ${KERNEL_MAKEFILE}
271 KV_MAJOR="$(getfilevar VERSION ${KV_DIR}/Makefile)" 511 KV_MAJOR="$(${mkfunc} VERSION ${KERNEL_MAKEFILE})"
272 KV_MINOR="$(getfilevar PATCHLEVEL ${KV_DIR}/Makefile)" 512 KV_MINOR="$(${mkfunc} PATCHLEVEL ${KERNEL_MAKEFILE})"
273 KV_PATCH="$(getfilevar SUBLEVEL ${KV_DIR}/Makefile)" 513 KV_PATCH="$(${mkfunc} SUBLEVEL ${KERNEL_MAKEFILE})"
274 KV_EXTRA="$(getfilevar EXTRAVERSION ${KV_DIR}/Makefile)" 514 KV_EXTRA="$(${mkfunc} EXTRAVERSION ${KERNEL_MAKEFILE})"
275 515
276 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}" ]
277 then 517 then
518 if [ -z "${get_version_warning_done}" ]; then
519 get_version_warning_done=1
278 qeerror "Could not detect kernel version." 520 qeerror "Could not detect kernel version."
279 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
280 return 1 523 return 1
281 fi 524 fi
282 525
283 # 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.
284 # 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.
285 # 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
286 # caught before this if they are. 529 # caught before this if they are.
287 [ "${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}" == "$(uname -r)" ] && \
288 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}"
289 531
290 [ -h "${OUTPUT_DIR}" ] && KV_OUT_DIR="$(readlink -f ${OUTPUT_DIR})" 532 [ -h "${OUTPUT_DIR}" ] && KV_OUT_DIR="$(readlink -f ${OUTPUT_DIR})"
291 [ -d "${OUTPUT_DIR}" ] && KV_OUT_DIR="${OUTPUT_DIR}" 533 [ -d "${OUTPUT_DIR}" ] && KV_OUT_DIR="${OUTPUT_DIR}"
292 if [ -n "${KV_OUT_DIR}" ]; 534 if [ -n "${KV_OUT_DIR}" ];
293 then 535 then
294 qeinfo "Found kernel object directory:" 536 qeinfo "Found kernel object directory:"
295 qeinfo " ${KV_OUT_DIR}" 537 qeinfo " ${KV_OUT_DIR}"
296
297 KV_LOCAL="$(get_localversion ${KV_OUT_DIR})"
298 fi 538 fi
299 # 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
300 KV_OUT_DIR="${KV_OUT_DIR:-${KV_DIR}}" 540 KV_OUT_DIR="${KV_OUT_DIR:-${KV_DIR}}"
301 541
302 if [ ! -s "${KV_OUT_DIR}/.config" ] 542 # Grab the kernel release from the output directory.
303 then 543 # TODO: we MUST detect kernel.release being out of date, and 'return 1' from
304 qeerror "Could not find a usable .config in the kernel source directory." 544 # this function.
305 qeerror "Please ensure that ${KERNEL_DIR} points to a configured set of Linux sources." 545 if [ -s "${KV_OUT_DIR}"/include/config/kernel.release ]; then
306 qeerror "If you are using KBUILD_OUTPUT, please set the environment var so that" 546 KV_LOCAL=$(<"${KV_OUT_DIR}"/include/config/kernel.release)
307 qeerror "it points to the necessary object directory so that it might find .config." 547 elif [ -s "${KV_OUT_DIR}"/.kernelrelease ]; then
308 return 1 548 KV_LOCAL=$(<"${KV_OUT_DIR}"/.kernelrelease)
549 else
550 KV_LOCAL=
309 fi 551 fi
310 552
311 KV_LOCAL="${KV_LOCAL}$(get_localversion ${KV_DIR})" 553 # KV_LOCAL currently contains the full release; discard the first bits.
312 KV_LOCAL="${KV_LOCAL}$(linux_chkconfig_string LOCALVERSION)" 554 tmplocal=${KV_LOCAL#${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}}
313 KV_LOCAL="${KV_LOCAL//\"/}"
314 555
315 # For things like git that can append extra stuff: 556 # If the updated local version was not changed, the tree is not prepared.
316 [ -e ${KV_DIR}/scripts/setlocalversion ] && 557 # Clear out KV_LOCAL in that case.
317 linux_chkconfig_builtin LOCALVERSION_AUTO && 558 # TODO: this does not detect a change in the localversion part between
318 KV_LOCAL="${KV_LOCAL}$(sh ${KV_DIR}/scripts/setlocalversion ${KV_DIR})" 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
564 fi
319 565
320 # And we should set KV_FULL to the full expanded version 566 # And we should set KV_FULL to the full expanded version
321 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}"
322 568
323 qeinfo "Found sources for kernel version:" 569 qeinfo "Found sources for kernel version:"
324 qeinfo " ${KV_FULL}" 570 qeinfo " ${KV_FULL}"
325 571
326 return 0 572 return 0
327} 573}
328 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.
329get_running_version() { 579get_running_version() {
330 KV_FULL=$(uname -r) 580 KV_FULL=$(uname -r)
331 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 $?
332 if [[ -f ${ROOT}/lib/modules/${KV_FULL}/source/Makefile ]]; then 588 elif [[ -f ${ROOT}/lib/modules/${KV_FULL}/source/Makefile ]]; then
333 KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/source) 589 KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/source)
334 unset KV_FULL 590 unset KV_FULL
335 get_version 591 get_version
336 return $? 592 return $?
337 elif [[ -f ${ROOT}/lib/modules/${KV_FULL}/build/Makefile ]]; then 593 elif [[ -f ${ROOT}/lib/modules/${KV_FULL}/build/Makefile ]]; then
340 get_version 596 get_version
341 return $? 597 return $?
342 else 598 else
343 KV_MAJOR=$(get_version_component_range 1 ${KV_FULL}) 599 KV_MAJOR=$(get_version_component_range 1 ${KV_FULL})
344 KV_MINOR=$(get_version_component_range 2 ${KV_FULL}) 600 KV_MINOR=$(get_version_component_range 2 ${KV_FULL})
345 KV_PATCH=$(get_version_component_range 3- ${KV_FULL}) 601 KV_PATCH=$(get_version_component_range 3 ${KV_FULL})
346 KV_PATCH=${KV_PATCH//-*} 602 KV_PATCH=${KV_PATCH//-*}
347 [[ -n ${KV_FULL#*-} ]] && [[ -n ${KV_FULL//${KV_FULL#*-}} ]] \ 603 KV_EXTRA="${KV_FULL#${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}}"
348 && KV_EXTRA="-${KV_FULL#*-}"
349 fi 604 fi
350 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
351} 621}
352 622
353 623
354# ebuild check functions 624# ebuild check functions
355# --------------------------------------- 625# ---------------------------------------
356 626
627# @FUNCTION: check_kernel_built
628# @DESCRIPTION:
629# This function verifies that the current kernel sources have been already prepared otherwise it dies.
357check_kernel_built() { 630check_kernel_built() {
358 # if we haven't determined the version yet, we need too. 631 # if we haven't determined the version yet, we need to
632 require_configured_kernel
359 get_version; 633 get_version
360 634
361 if [ ! -f "${KV_OUT_DIR}/include/linux/version.h" ] 635 if [ ! -f "${KV_OUT_DIR}/include/linux/version.h" ]
362 then 636 then
363 eerror "These sources have not yet been prepared." 637 eerror "These sources have not yet been prepared."
364 eerror "We cannot build against an unprepared tree." 638 eerror "We cannot build against an unprepared tree."
371 eerror "Then please try merging this module again." 645 eerror "Then please try merging this module again."
372 die "Kernel sources need compiling first" 646 die "Kernel sources need compiling first"
373 fi 647 fi
374} 648}
375 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.
376check_modules_supported() { 653check_modules_supported() {
377 # if we haven't determined the version yet, we need too. 654 # if we haven't determined the version yet, we need too.
655 require_configured_kernel
378 get_version; 656 get_version
379 657
380 if ! linux_chkconfig_builtin "MODULES" 658 if ! linux_chkconfig_builtin "MODULES"
381 then 659 then
382 eerror "These sources do not support loading external modules." 660 eerror "These sources do not support loading external modules."
383 eerror "to be able to use this module please enable \"Loadable modules support\"" 661 eerror "to be able to use this module please enable \"Loadable modules support\""
384 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."
385 die "No support for external modules in ${KV_FULL} config" 663 die "No support for external modules in ${KV_FULL} config"
386 fi 664 fi
387} 665}
388 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.
389check_extra_config() { 671check_extra_config() {
390 local config negate die error reworkmodulenames 672 local config negate die error reworkmodulenames
391 local soft_errors_count=0 hard_errors_count=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}"
392 678
393 # if we haven't determined the version yet, we need too. 679 # if we haven't determined the version yet, we need to
394 get_version; 680 linux-info_get_any_version
681
682 # Determine if we really need a .config. The only time when we don't need
683 # one is when all of the CONFIG_CHECK options are prefixed with "~".
684 for config in ${CONFIG_CHECK}
685 do
686 if [[ "${config:0:1}" != "~" ]]; then
687 config_required=1
688 break
689 fi
690 done
691
692 if [[ ${config_required} == 0 ]]; then
693 # In the case where we don't require a .config, we can now bail out
694 # if the user has no .config as there is nothing to do. Otherwise
695 # code later will cause a failure due to missing .config.
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}"
711 return 0
712 fi
713 else
714 require_configured_kernel
715 fi
395 716
396 einfo "Checking for suitable kernel configuration options..." 717 einfo "Checking for suitable kernel configuration options..."
718
397 for config in ${CONFIG_CHECK} 719 for config in ${CONFIG_CHECK}
398 do 720 do
399 # if we specify any fatal, ensure we honor them 721 # if we specify any fatal, ensure we honor them
400 die=1 722 die=1
401 error=0 723 error=0
402 negate=0 724 negate=0
403 reworkmodulenames=0 725 reworkmodulenames=0
404 726
405 if [[ -z ${config/\~*} ]]; then 727 if [[ ${config:0:1} == "~" ]]; then
406 die=0 728 die=0
407 config=${config:1} 729 config=${config:1}
408 elif [[ -z ${config/\@*} ]]; then 730 elif [[ ${config:0:1} == "@" ]]; then
409 die=0 731 die=0
410 reworkmodulenames=1 732 reworkmodulenames=1
411 config=${config:1} 733 config=${config:1}
412 fi 734 fi
413 if [[ -z ${config//\!*} ]]; then 735 if [[ ${config:0:1} == "!" ]]; then
414 negate=1 736 negate=1
415 config=${config:1} 737 config=${config:1}
416 fi 738 fi
417 739
418 if [[ ${negate} == 1 ]]; then 740 if [[ ${negate} == 1 ]]; then
470 if [[ ${hard_errors_count} > 0 ]]; then 792 if [[ ${hard_errors_count} > 0 ]]; then
471 eerror "Please check to make sure these options are set correctly." 793 eerror "Please check to make sure these options are set correctly."
472 eerror "Failure to do so may cause unexpected problems." 794 eerror "Failure to do so may cause unexpected problems."
473 eerror "Once you have satisfied these options, please try merging" 795 eerror "Once you have satisfied these options, please try merging"
474 eerror "this package again." 796 eerror "this package again."
797 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
475 die "Incorrect kernel configuration options" 798 die "Incorrect kernel configuration options"
476 elif [[ ${soft_errors_count} > 0 ]]; then 799 elif [[ ${soft_errors_count} > 0 ]]; then
477 ewarn "Please check to make sure these options are set correctly." 800 ewarn "Please check to make sure these options are set correctly."
478 ewarn "Failure to do so may cause unexpected problems." 801 ewarn "Failure to do so may cause unexpected problems."
479 else 802 else
480 eend 0 803 eend 0
481 fi 804 fi
805 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
482} 806}
483 807
484check_zlibinflate() { 808check_zlibinflate() {
485 # if we haven't determined the version yet, we need too. 809 # if we haven't determined the version yet, we need to
810 require_configured_kernel
486 get_version; 811 get_version
487 812
488 # although I restructured this code - I really really really dont support it! 813 # although I restructured this code - I really really really dont support it!
489 814
490 # bug #27882 - zlib routines are only linked into the kernel 815 # bug #27882 - zlib routines are only linked into the kernel
491 # if something compiled into the kernel calls them 816 # if something compiled into the kernel calls them
498 local DEFLATE 823 local DEFLATE
499 824
500 einfo "Determining the usability of ZLIB_INFLATE support in your kernel" 825 einfo "Determining the usability of ZLIB_INFLATE support in your kernel"
501 826
502 ebegin "checking ZLIB_INFLATE" 827 ebegin "checking ZLIB_INFLATE"
503 getfilevar_isbuiltin CONFIG_ZLIB_INFLATE ${KV_DIR}/.config 828 linux_chkconfig_builtin CONFIG_ZLIB_INFLATE
504 eend $? 829 eend $?
505 [ "$?" != 0 ] && die 830 [ "$?" != 0 ] && die
506 831
507 ebegin "checking ZLIB_DEFLATE" 832 ebegin "checking ZLIB_DEFLATE"
508 getfilevar_isbuiltin CONFIG_ZLIB_DEFLATE ${KV_DIR}/.config 833 linux_chkconfig_builtin CONFIG_ZLIB_DEFLATE
509 eend $? 834 eend $?
510 [ "$?" != 0 ] && die 835 [ "$?" != 0 ] && die
511 836
512 local LINENO_START 837 local LINENO_START
513 local LINENO_END 838 local LINENO_END
551} 876}
552 877
553################################ 878################################
554# Default pkg_setup 879# Default pkg_setup
555# 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
556 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)
557linux-info_pkg_setup() { 885linux-info_pkg_setup() {
558 get_version || die "Unable to calculate Linux Kernel version" 886 linux-info_get_any_version
559 887
560 if kernel_is 2 4; then 888 if kernel_is 2 4; then
561 if [ "$( gcc-major-version )" -eq "4" ] ; then 889 if [ "$( gcc-major-version )" -eq "4" ] ; then
562 echo 890 echo
563 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.51  
changed lines
  Added in v.1.89

  ViewVC Help
Powered by ViewVC 1.1.20