/[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.46 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.46 2006/07/20 05:34:10 marineam 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 KV_LOCAL="${KV_LOCAL}$(sh ${KV_DIR}/scripts/setlocalversion ${KV_DIR})" 543 # TODO: this does not detect a change in the localversion part between
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
314 550
315 # And we should set KV_FULL to the full expanded version 551 # And we should set KV_FULL to the full expanded version
316 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}"
317 553
318 qeinfo "Found sources for kernel version:" 554 qeinfo "Found sources for kernel version:"
319 qeinfo " ${KV_FULL}" 555 qeinfo " ${KV_FULL}"
320 556
321 return 0 557 return 0
322} 558}
323 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.
324get_running_version() { 564get_running_version() {
325 KV_FULL=$(uname -r) 565 KV_FULL=$(uname -r)
326 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 $?
327 if [[ -f ${ROOT}/lib/modules/${KV_FULL}/source/Makefile ]]; then 573 elif [[ -f ${ROOT}/lib/modules/${KV_FULL}/source/Makefile ]]; then
328 KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/source) 574 KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/source)
329 unset KV_FULL 575 unset KV_FULL
330 get_version 576 get_version
331 return $? 577 return $?
332 elif [[ -f ${ROOT}/lib/modules/${KV_FULL}/build/Makefile ]]; then 578 elif [[ -f ${ROOT}/lib/modules/${KV_FULL}/build/Makefile ]]; then
335 get_version 581 get_version
336 return $? 582 return $?
337 else 583 else
338 KV_MAJOR=$(get_version_component_range 1 ${KV_FULL}) 584 KV_MAJOR=$(get_version_component_range 1 ${KV_FULL})
339 KV_MINOR=$(get_version_component_range 2 ${KV_FULL}) 585 KV_MINOR=$(get_version_component_range 2 ${KV_FULL})
340 KV_PATCH=$(get_version_component_range 3- ${KV_FULL}) 586 KV_PATCH=$(get_version_component_range 3 ${KV_FULL})
341 KV_PATCH=${KV_PATCH//-*} 587 KV_PATCH=${KV_PATCH//-*}
342 [[ -n ${KV_FULL#*-} ]] && [[ -n ${KV_FULL//${KV_FULL#*-}} ]] \ 588 KV_EXTRA="${KV_FULL#${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}}"
343 && KV_EXTRA="-${KV_FULL#*-}"
344 fi 589 fi
345 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
346} 606}
347 607
348 608
349# ebuild check functions 609# ebuild check functions
350# --------------------------------------- 610# ---------------------------------------
351 611
612# @FUNCTION: check_kernel_built
613# @DESCRIPTION:
614# This function verifies that the current kernel sources have been already prepared otherwise it dies.
352check_kernel_built() { 615check_kernel_built() {
353 # 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
354 get_version; 618 get_version
355 619
356 if [ ! -f "${KV_OUT_DIR}/include/linux/version.h" ] 620 if [ ! -f "${KV_OUT_DIR}/include/linux/version.h" ]
357 then 621 then
358 eerror "These sources have not yet been prepared." 622 eerror "These sources have not yet been prepared."
359 eerror "We cannot build against an unprepared tree." 623 eerror "We cannot build against an unprepared tree."
366 eerror "Then please try merging this module again." 630 eerror "Then please try merging this module again."
367 die "Kernel sources need compiling first" 631 die "Kernel sources need compiling first"
368 fi 632 fi
369} 633}
370 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.
371check_modules_supported() { 638check_modules_supported() {
372 # 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
373 get_version; 641 get_version
374 642
375 if ! linux_chkconfig_builtin "MODULES" 643 if ! linux_chkconfig_builtin "MODULES"
376 then 644 then
377 eerror "These sources do not support loading external modules." 645 eerror "These sources do not support loading external modules."
378 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\""
379 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."
380 die "No support for external modules in ${KV_FULL} config" 648 die "No support for external modules in ${KV_FULL} config"
381 fi 649 fi
382} 650}
383 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.
384check_extra_config() { 656check_extra_config() {
385 local config negate die error reworkmodulenames 657 local config negate die error reworkmodulenames
386 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}"
387 663
388 # if we haven't determined the version yet, we need too. 664 # if we haven't determined the version yet, we need to
389 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
390 701
391 einfo "Checking for suitable kernel configuration options..." 702 einfo "Checking for suitable kernel configuration options..."
703
392 for config in ${CONFIG_CHECK} 704 for config in ${CONFIG_CHECK}
393 do 705 do
394 # if we specify any fatal, ensure we honor them 706 # if we specify any fatal, ensure we honor them
395 die=1 707 die=1
396 error=0 708 error=0
397 negate=0 709 negate=0
398 reworkmodulenames=0 710 reworkmodulenames=0
399 711
400 if [[ -z ${config/\~*} ]]; then 712 if [[ ${config:0:1} == "~" ]]; then
401 die=0 713 die=0
402 config=${config:1} 714 config=${config:1}
403 elif [[ -z ${config/\@*} ]]; then 715 elif [[ ${config:0:1} == "@" ]]; then
404 die=0 716 die=0
405 reworkmodulenames=1 717 reworkmodulenames=1
406 config=${config:1} 718 config=${config:1}
407 fi 719 fi
408 if [[ -z ${config//\!*} ]]; then 720 if [[ ${config:0:1} == "!" ]]; then
409 negate=1 721 negate=1
410 config=${config:1} 722 config=${config:1}
411 fi 723 fi
412 724
413 if [[ ${negate} == 1 ]]; then 725 if [[ ${negate} == 1 ]]; then
465 if [[ ${hard_errors_count} > 0 ]]; then 777 if [[ ${hard_errors_count} > 0 ]]; then
466 eerror "Please check to make sure these options are set correctly." 778 eerror "Please check to make sure these options are set correctly."
467 eerror "Failure to do so may cause unexpected problems." 779 eerror "Failure to do so may cause unexpected problems."
468 eerror "Once you have satisfied these options, please try merging" 780 eerror "Once you have satisfied these options, please try merging"
469 eerror "this package again." 781 eerror "this package again."
782 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
470 die "Incorrect kernel configuration options" 783 die "Incorrect kernel configuration options"
471 elif [[ ${soft_errors_count} > 0 ]]; then 784 elif [[ ${soft_errors_count} > 0 ]]; then
472 ewarn "Please check to make sure these options are set correctly." 785 ewarn "Please check to make sure these options are set correctly."
473 ewarn "Failure to do so may cause unexpected problems." 786 ewarn "Failure to do so may cause unexpected problems."
474 else 787 else
475 eend 0 788 eend 0
476 fi 789 fi
790 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
477} 791}
478 792
479check_zlibinflate() { 793check_zlibinflate() {
480 # 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
481 get_version; 796 get_version
482 797
483 # 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!
484 799
485 # bug #27882 - zlib routines are only linked into the kernel 800 # bug #27882 - zlib routines are only linked into the kernel
486 # if something compiled into the kernel calls them 801 # if something compiled into the kernel calls them
493 local DEFLATE 808 local DEFLATE
494 809
495 einfo "Determining the usability of ZLIB_INFLATE support in your kernel" 810 einfo "Determining the usability of ZLIB_INFLATE support in your kernel"
496 811
497 ebegin "checking ZLIB_INFLATE" 812 ebegin "checking ZLIB_INFLATE"
498 getfilevar_isbuiltin CONFIG_ZLIB_INFLATE ${KV_DIR}/.config 813 linux_chkconfig_builtin CONFIG_ZLIB_INFLATE
499 eend $? 814 eend $?
500 [ "$?" != 0 ] && die 815 [ "$?" != 0 ] && die
501 816
502 ebegin "checking ZLIB_DEFLATE" 817 ebegin "checking ZLIB_DEFLATE"
503 getfilevar_isbuiltin CONFIG_ZLIB_DEFLATE ${KV_DIR}/.config 818 linux_chkconfig_builtin CONFIG_ZLIB_DEFLATE
504 eend $? 819 eend $?
505 [ "$?" != 0 ] && die 820 [ "$?" != 0 ] && die
506 821
507 local LINENO_START 822 local LINENO_START
508 local LINENO_END 823 local LINENO_END
546} 861}
547 862
548################################ 863################################
549# Default pkg_setup 864# Default pkg_setup
550# 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
551 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)
552linux-info_pkg_setup() { 870linux-info_pkg_setup() {
553 get_version || die "Unable to calculate Linux Kernel version" 871 linux-info_get_any_version
872
873 if kernel_is 2 4; then
874 if [ "$( gcc-major-version )" -eq "4" ] ; then
875 echo
876 ewarn "Be warned !! >=sys-devel/gcc-4.0.0 isn't supported with"
877 ewarn "linux-2.4 (or modules building against a linux-2.4 kernel)!"
878 echo
879 ewarn "Either switch to another gcc-version (via gcc-config) or use a"
880 ewarn "newer kernel that supports gcc-4."
881 echo
882 ewarn "Also be aware that bugreports about gcc-4 not working"
883 ewarn "with linux-2.4 based ebuilds will be closed as INVALID!"
884 echo
885 epause 10
886 fi
887 fi
888
554 [ -n "${CONFIG_CHECK}" ] && check_extra_config; 889 [ -n "${CONFIG_CHECK}" ] && check_extra_config;
555} 890}

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

  ViewVC Help
Powered by ViewVC 1.1.20