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

Legend:
Removed from v.1.48  
changed lines
  Added in v.1.91

  ViewVC Help
Powered by ViewVC 1.1.20