/[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.34 Revision 1.76
1# Copyright 1999-2004 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.34 2005/12/30 18:36:39 johnm Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/linux-info.eclass,v 1.76 2009/12/11 21:33:30 robbat2 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"
27# ERROR_CFG <string> The error message to display when the above check 44#
45# To simply warn about a missing option, prepend a '~'.
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
28# fails. <CFG> should reference the appropriate option 58# fails. <CFG> should reference the appropriate option used in CONFIG_CHECK.
29# as above. ie: ERROR_MTRR="MTRR exists in the .config 59#
30# but shouldn't!!" 60# e.g.: ERROR_MTRR="MTRR exists in the .config but shouldn't!!"
31# KBUILD_OUTPUT <string> This is passed on commandline, or can be set from 61
32# 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
33# which is to be used as the kernel object directory. 65# which is to be used as the kernel object directory.
34 66
35# 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
36# set by hand. These are as follows: 68# set by hand. These are as follows:
37# 69
38# Env Var Option Description 70# @ECLASS-VARIABLE: KV_FULL
39# KV_FULL <string> The full kernel version. ie: 2.6.9-gentoo-johnm-r1 71# @DESCRIPTION:
40# 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
41# KV_MINOR <integer> The kernel minor version. ie: 6 73
42# KV_PATCH <integer> The kernel patch version. ie: 9 74# @ECLASS-VARIABLE: KV_MAJOR
43# KV_EXTRA <string> The kernel EXTRAVERSION. ie: -gentoo 75# @DESCRIPTION:
44# 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
45# 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
46# KERNEL_DIR is invalid. 97# KERNEL_DIR is invalid.
47# KV_OUT_DIR <string> The kernel object directory. will be KV_DIR unless 98
48# koutput is used. This should be used for referencing 99# @ECLASS-VARIABLE: KV_OUT_DIR
49# .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.
103
104# @ECLASS-VARIABLE: I_KNOW_WHAT_I_AM_DOING
105# @DESCRIPTION:
106# Temporary variable for the migration to making linux-info non-fatal.
50 107
51# And to ensure all the weirdness with crosscompile 108# And to ensure all the weirdness with crosscompile
52inherit toolchain-funcs versionator 109inherit toolchain-funcs versionator
53 110
54EXPORT_FUNCTIONS pkg_setup 111EXPORT_FUNCTIONS pkg_setup
112
113DEPEND=""
114RDEPEND=""
115
116[ -z "${I_KNOW_WHAT_I_AM_DOING}" ] && \
117DEPEND="kernel_linux? ( virtual/linux-sources )"
55 118
56# Overwritable environment Var's 119# Overwritable environment Var's
57# --------------------------------------- 120# ---------------------------------------
58KERNEL_DIR="${KERNEL_DIR:-${ROOT}usr/src/linux}" 121KERNEL_DIR="${KERNEL_DIR:-${ROOT}usr/src/linux}"
59 122
63case ${ARCH} in 126case ${ARCH} in
64 ppc) BUILD_FIXES="${BUILD_FIXES} TOUT=${T}/.tmp_gas_check";; 127 ppc) BUILD_FIXES="${BUILD_FIXES} TOUT=${T}/.tmp_gas_check";;
65 ppc64) BUILD_FIXES="${BUILD_FIXES} TOUT=${T}/.tmp_gas_check";; 128 ppc64) BUILD_FIXES="${BUILD_FIXES} TOUT=${T}/.tmp_gas_check";;
66esac 129esac
67 130
68# These are legacy wrappers for toolchain-funcs. 131# @FUNCTION: set_arch_to_kernel
69# I dont like them here, but oh well. 132# @DESCRIPTION:
133# Set the env ARCH to match what the kernel expects.
70set_arch_to_kernel() { export ARCH="$(tc-arch-kernel)"; } 134set_arch_to_kernel() { export ARCH=$(tc-arch-kernel); }
135# @FUNCTION: set_arch_to_portage
136# @DESCRIPTION:
137# Set the env ARCH to match what portage expects.
71set_arch_to_portage() { export ARCH="$(tc-arch)"; } 138set_arch_to_portage() { export ARCH=$(tc-arch); }
72 139
73# qeinfo "Message" 140# qeinfo "Message"
74# ------------------- 141# -------------------
75# qeinfo is a quiet einfo call when EBUILD_PHASE 142# qeinfo is a quiet einfo call when EBUILD_PHASE
76# should not have visible output. 143# should not have visible output.
91qeerror() { qout eerror "${@}" ; } 158qeerror() { qout eerror "${@}" ; }
92 159
93# File Functions 160# File Functions
94# --------------------------------------- 161# ---------------------------------------
95 162
96# getfilevar accepts 2 vars as follows: 163# @FUNCTION: getfilevar
97# getfilevar <VARIABLE> <CONFIGFILE> 164# @USAGE: variable configfile
98 165# @RETURN: the value of the variable
166# @DESCRIPTION:
167# It detects the value of the variable defined in the file configfile. This is
168# done by including the configfile, and printing the variable with Make.
169# It WILL break if your makefile has missing dependencies!
99getfilevar() { 170getfilevar() {
100local ERROR workingdir basefname basedname myARCH="${ARCH}" 171local ERROR basefname basedname myARCH="${ARCH}"
101 ERROR=0 172 ERROR=0
102 173
103 [ -z "${1}" ] && ERROR=1 174 [ -z "${1}" ] && ERROR=1
104 [ ! -f "${2}" ] && ERROR=1 175 [ ! -f "${2}" ] && ERROR=1
105 176
107 then 178 then
108 echo -e "\n" 179 echo -e "\n"
109 eerror "getfilevar requires 2 variables, with the second a valid file." 180 eerror "getfilevar requires 2 variables, with the second a valid file."
110 eerror " getfilevar <VARIABLE> <CONFIGFILE>" 181 eerror " getfilevar <VARIABLE> <CONFIGFILE>"
111 else 182 else
112 workingdir="${PWD}"
113 basefname="$(basename ${2})" 183 basefname="$(basename ${2})"
114 basedname="$(dirname ${2})" 184 basedname="$(dirname ${2})"
115 unset ARCH 185 unset ARCH
116 186
117 cd "${basedname}" 187 echo -e "e:\\n\\t@echo \$(${1})\\ninclude ${basefname}" | \
118 echo -e "include ${basefname}\ne:\n\t@echo \$(${1})" | \ 188 make -C "${basedname}" M="${S}" ${BUILD_FIXES} -s -f - 2>/dev/null
119 make ${BUILD_FIXES} -s -f - e 2>/dev/null
120 cd "${workingdir}"
121 189
122 ARCH=${myARCH} 190 ARCH=${myARCH}
123 fi 191 fi
124} 192}
125 193
194# @FUNCTION: getfilevar_noexec
195# @USAGE: variable configfile
196# @RETURN: the value of the variable
197# @DESCRIPTION:
198# It detects the value of the variable defined in the file configfile.
199# This is done with sed matching an expression only. If the variable is defined,
200# you will run into problems. See getfilevar for those cases.
201getfilevar_noexec() {
202 local ERROR basefname basedname mycat myARCH="${ARCH}"
203 ERROR=0
204 mycat='cat'
205
206 [ -z "${1}" ] && ERROR=1
207 [ ! -f "${2}" ] && ERROR=1
208 [ "${2%.gz}" != "${2}" ] && mycat='zcat'
209
210 if [ "${ERROR}" = 1 ]
211 then
212 echo -e "\n"
213 eerror "getfilevar_noexec requires 2 variables, with the second a valid file."
214 eerror " getfilevar_noexec <VARIABLE> <CONFIGFILE>"
215 else
216 ${mycat} "${2}" | \
217 sed -n \
218 -e "/^[[:space:]]*${1}[[:space:]]*=[[:space:]]*\(.*\)\$/{
219 s,^[^=]*[[:space:]]*=[[:space:]]*,,g ;
220 s,[[:space:]]*\$,,g ;
221 p
222 }"
223 fi
224}
225
226# @PRIVATE-VARIABLE: _LINUX_CONFIG_EXISTS_DONE
227# @DESCRIPTION:
228# This is only set if one of the linux_config_*exists functions has been called.
229# We use it for a QA warning that the check for a config has not been performed,
230# as linux_chkconfig* in non-legacy mode WILL return an undefined value if no
231# config is available at all.
232_LINUX_CONFIG_EXISTS_DONE=
233
234linux_config_qa_check() {
235 local f="$1"
236 if [ -z "${_LINUX_CONFIG_EXISTS_DONE}" ]; then
237 ewarn "QA: You called $f before any linux_config_exists!"
238 ewarn "QA: The return value of $f will NOT gaurenteed later!"
239 fi
240}
241
242# @FUNCTION: linux_config_src_exists
243# @RETURN: true or false
244# @DESCRIPTION:
245# It returns true if .config exists in a build directory otherwise false
246linux_config_src_exists() {
247 export _LINUX_CONFIG_EXISTS_DONE=1
248 [ -s "${KV_OUT_DIR}/.config" ]
249}
250
251# @FUNCTION: linux_config_bin_exists
252# @RETURN: true or false
253# @DESCRIPTION:
254# It returns true if .config exists in /proc, otherwise false
255linux_config_bin_exists() {
256 export _LINUX_CONFIG_EXISTS_DONE=1
257 [ -n "${I_KNOW_WHAT_I_AM_DOING}" -a -s "/proc/config.gz" ]
258}
259
260# @FUNCTION: linux_config_exists
261# @RETURN: true or false
262# @DESCRIPTION:
263# It returns true if .config exists otherwise false
264#
265# This function MUST be checked before using any of the linux_chkconfig_*
266# functions.
267linux_config_exists() {
268 linux_config_src_exists || linux_config_bin_exists
269}
270
271# @FUNCTION: require_configured_kernel
272# @DESCRIPTION:
273# This function verifies that the current kernel is configured (it checks against the existence of .config)
274# otherwise it dies.
275require_configured_kernel() {
276 if ! linux_config_src_exists; then
277 qeerror "Could not find a usable .config in the kernel source directory."
278 qeerror "Please ensure that ${KERNEL_DIR} points to a configured set of Linux sources."
279 qeerror "If you are using KBUILD_OUTPUT, please set the environment var so that"
280 qeerror "it points to the necessary object directory so that it might find .config."
281 die "Kernel not configured; no .config found in ${KV_OUT_DIR}"
282 fi
283}
284
285# @FUNCTION: linux_chkconfig_present
286# @USAGE: option
287# @RETURN: true or false
288# @DESCRIPTION:
289# It checks that CONFIG_<option>=y or CONFIG_<option>=m is present in the current kernel .config
290# If linux_config_exists returns false, the results of this are UNDEFINED. You
291# MUST call linux_config_exists first.
126linux_chkconfig_present() { 292linux_chkconfig_present() {
293 linux_config_qa_check linux_chkconfig_present
127local RESULT 294 local RESULT
295 [ -z "${I_KNOW_WHAT_I_AM_DOING}" ] && require_configured_kernel
296 local config
297 config="${KV_OUT_DIR}/.config"
298 [ ! -f "${config}" ] && config="/proc/config.gz"
128 RESULT="$(getfilevar CONFIG_${1} ${KV_OUT_DIR}/.config)" 299 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
129 [ "${RESULT}" = "m" -o "${RESULT}" = "y" ] && return 0 || return 1 300 [ "${RESULT}" = "m" -o "${RESULT}" = "y" ] && return 0 || return 1
130} 301}
131 302
303# @FUNCTION: linux_chkconfig_module
304# @USAGE: option
305# @RETURN: true or false
306# @DESCRIPTION:
307# It checks that CONFIG_<option>=m is present in the current kernel .config
308# If linux_config_exists returns false, the results of this are UNDEFINED. You
309# MUST call linux_config_exists first.
132linux_chkconfig_module() { 310linux_chkconfig_module() {
311 linux_config_qa_check linux_chkconfig_module
133local RESULT 312 local RESULT
313 [ -z "${I_KNOW_WHAT_I_AM_DOING}" ] && require_configured_kernel
314 local config
315 config="${KV_OUT_DIR}/.config"
316 [ ! -f "${config}" ] && config="/proc/config.gz"
134 RESULT="$(getfilevar CONFIG_${1} ${KV_OUT_DIR}/.config)" 317 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
135 [ "${RESULT}" = "m" ] && return 0 || return 1 318 [ "${RESULT}" = "m" ] && return 0 || return 1
136} 319}
137 320
321# @FUNCTION: linux_chkconfig_builtin
322# @USAGE: option
323# @RETURN: true or false
324# @DESCRIPTION:
325# It checks that CONFIG_<option>=y is present in the current kernel .config
326# If linux_config_exists returns false, the results of this are UNDEFINED. You
327# MUST call linux_config_exists first.
138linux_chkconfig_builtin() { 328linux_chkconfig_builtin() {
329 linux_config_qa_check linux_chkconfig_builtin
139local RESULT 330 local RESULT
331 [ -z "${I_KNOW_WHAT_I_AM_DOING}" ] && require_configured_kernel
332 local config
333 config="${KV_OUT_DIR}/.config"
334 [ ! -f "${config}" ] && config="/proc/config.gz"
140 RESULT="$(getfilevar CONFIG_${1} ${KV_OUT_DIR}/.config)" 335 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
141 [ "${RESULT}" = "y" ] && return 0 || return 1 336 [ "${RESULT}" = "y" ] && return 0 || return 1
142} 337}
143 338
339# @FUNCTION: linux_chkconfig_string
340# @USAGE: option
341# @RETURN: CONFIG_<option>
342# @DESCRIPTION:
343# It prints the CONFIG_<option> value of the current kernel .config (it requires a configured kernel).
344# If linux_config_exists returns false, the results of this are UNDEFINED. You
345# MUST call linux_config_exists first.
144linux_chkconfig_string() { 346linux_chkconfig_string() {
347 linux_config_qa_check linux_chkconfig_string
348 [ -z "${I_KNOW_WHAT_I_AM_DOING}" ] && require_configured_kernel
349 local config
350 config="${KV_OUT_DIR}/.config"
351 [ ! -f "${config}" ] && config="/proc/config.gz"
145 getfilevar "CONFIG_${1}" "${KV_OUT_DIR}/.config" 352 getfilevar_noexec "CONFIG_${1}" "${config}"
146} 353}
147 354
148# Versioning Functions 355# Versioning Functions
149# --------------------------------------- 356# ---------------------------------------
150 357
151# kernel_is returns true when the version is the same as the passed version 358# @FUNCTION: kernel_is
359# @USAGE: [-lt -gt -le -ge -eq] major_number [minor_number patch_number]
360# @RETURN: true or false
361# @DESCRIPTION:
362# It returns true when the current kernel version satisfies the comparison against the passed version.
363# -eq is the default comparison.
152# 364#
365# @CODE
153# For Example where KV = 2.6.9 366# For Example where KV = 2.6.9
154# kernel_is 2 4 returns false 367# kernel_is 2 4 returns false
155# kernel_is 2 returns true 368# kernel_is 2 returns true
156# kernel_is 2 6 returns true 369# kernel_is 2 6 returns true
157# kernel_is 2 6 8 returns false 370# kernel_is 2 6 8 returns false
158# kernel_is 2 6 9 returns true 371# kernel_is 2 6 9 returns true
159# 372# @CODE
373
160# got the jist yet? 374# got the jist yet?
161 375
162kernel_is() { 376kernel_is() {
163 # if we haven't determined the version yet, we need too. 377 # if we haven't determined the version yet, we need to.
164 get_version; 378 linux-info_get_any_version
379
165 local operator test value x=0 y=0 z=0 380 local operator test value x=0 y=0 z=0
166 381
167 case ${1} in 382 case ${1} in
168 lt) operator="-lt"; shift;; 383 -lt|lt) operator="-lt"; shift;;
169 gt) operator="-gt"; shift;; 384 -gt|gt) operator="-gt"; shift;;
170 le) operator="-le"; shift;; 385 -le|le) operator="-le"; shift;;
171 ge) operator="-ge"; shift;; 386 -ge|ge) operator="-ge"; shift;;
172 eq) operator="-eq"; shift;; 387 -eq|eq) operator="-eq"; shift;;
173 *) operator="-eq";; 388 *) operator="-eq";;
174 esac 389 esac
175 390
176 for x in ${@}; do 391 for x in ${@}; do
177 for((y=0; y<$((3 - ${#x})); y++)); do value="${value}0"; done 392 for((y=0; y<$((3 - ${#x})); y++)); do value="${value}0"; done
178 value="${value}${x}" 393 value="${value}${x}"
205 done 420 done
206 x=${x/ /} 421 x=${x/ /}
207 echo ${x} 422 echo ${x}
208} 423}
209 424
425# internal variable, so we know to only print the warning once
426get_version_warning_done=
427
428# @FUNCTION: get_version
429# @DESCRIPTION:
430# It gets the version of the kernel inside KERNEL_DIR and populates the KV_FULL variable
431# (if KV_FULL is already set it does nothing).
432#
433# The kernel version variables (KV_MAJOR, KV_MINOR, KV_PATCH, KV_EXTRA and KV_LOCAL) are also set.
434#
435# The KV_DIR is set using the KERNEL_DIR env var, the KV_DIR_OUT is set using a valid
436# KBUILD_OUTPUT (in a decreasing priority list, we look for the env var, makefile var or the
437# symlink /lib/modules/${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}/build).
210get_version() { 438get_version() {
211 local kbuild_output 439 local kbuild_output
212 440
213 # no need to execute this twice assuming KV_FULL is populated. 441 # no need to execute this twice assuming KV_FULL is populated.
214 # we can force by unsetting KV_FULL 442 # we can force by unsetting KV_FULL
217 # if we dont know KV_FULL, then we need too. 445 # if we dont know KV_FULL, then we need too.
218 # make sure KV_DIR isnt set since we need to work it out via KERNEL_DIR 446 # make sure KV_DIR isnt set since we need to work it out via KERNEL_DIR
219 unset KV_DIR 447 unset KV_DIR
220 448
221 # KV_DIR will contain the full path to the sources directory we should use 449 # KV_DIR will contain the full path to the sources directory we should use
450 [ -z "${get_version_warning_done}" ] && \
222 qeinfo "Determining the location of the kernel source code" 451 qeinfo "Determining the location of the kernel source code"
223 [ -h "${KERNEL_DIR}" ] && KV_DIR="$(readlink -f ${KERNEL_DIR})" 452 [ -h "${KERNEL_DIR}" ] && KV_DIR="$(readlink -f ${KERNEL_DIR})"
224 [ -d "${KERNEL_DIR}" ] && KV_DIR="${KERNEL_DIR}" 453 [ -d "${KERNEL_DIR}" ] && KV_DIR="${KERNEL_DIR}"
225 454
226 if [ -z "${KV_DIR}" ] 455 if [ -z "${KV_DIR}" ]
227 then 456 then
457 if [ -z "${get_version_warning_done}" ]; then
458 get_version_warning_done=1
228 qeerror "Unable to find kernel sources at ${KERNEL_DIR}" 459 qeerror "Unable to find kernel sources at ${KERNEL_DIR}"
229 qeinfo "This package requires Linux sources." 460 #qeinfo "This package requires Linux sources."
230 if [ "${KERNEL_DIR}" == "/usr/src/linux" ] ; then 461 if [ "${KERNEL_DIR}" == "/usr/src/linux" ] ; then
231 qeinfo "Please make sure that ${KERNEL_DIR} points at your running kernel, " 462 qeinfo "Please make sure that ${KERNEL_DIR} points at your running kernel, "
232 qeinfo "(or the kernel you wish to build against)." 463 qeinfo "(or the kernel you wish to build against)."
233 qeinfo "Alternatively, set the KERNEL_DIR environment variable to the kernel sources location" 464 qeinfo "Alternatively, set the KERNEL_DIR environment variable to the kernel sources location"
234 else 465 else
235 qeinfo "Please ensure that the KERNEL_DIR environment variable points at full Linux sources of the kernel you wish to compile against." 466 qeinfo "Please ensure that the KERNEL_DIR environment variable points at full Linux sources of the kernel you wish to compile against."
467 fi
236 fi 468 fi
237 return 1 469 return 1
238 fi 470 fi
239 471
472 if [ -z "${get_version_warning_done}" ]; then
240 qeinfo "Found kernel source directory:" 473 qeinfo "Found kernel source directory:"
241 qeinfo " ${KV_DIR}" 474 qeinfo " ${KV_DIR}"
475 fi
242 476
243 if [ ! -s "${KV_DIR}/Makefile" ] 477 if [ ! -s "${KV_DIR}/Makefile" ]
244 then 478 then
479 if [ -z "${get_version_warning_done}" ]; then
480 get_version_warning_done=1
245 qeerror "Could not find a Makefile in the kernel source directory." 481 qeerror "Could not find a Makefile in the kernel source directory."
246 qeerror "Please ensure that ${KERNEL_DIR} points to a complete set of Linux sources" 482 qeerror "Please ensure that ${KERNEL_DIR} points to a complete set of Linux sources"
483 fi
247 return 1 484 return 1
248 fi 485 fi
249 486
250 # OK so now we know our sources directory, but they might be using 487 # OK so now we know our sources directory, but they might be using
251 # KBUILD_OUTPUT, and we need this for .config and localversions-* 488 # KBUILD_OUTPUT, and we need this for .config and localversions-*
252 # so we better find it eh? 489 # so we better find it eh?
253 # do we pass KBUILD_OUTPUT on the CLI? 490 # do we pass KBUILD_OUTPUT on the CLI?
254 OUTPUT_DIR="${OUTPUT_DIR:-${KBUILD_OUTPUT}}" 491 OUTPUT_DIR="${OUTPUT_DIR:-${KBUILD_OUTPUT}}"
255 492
256 # And if we didn't pass it, we can take a nosey in the Makefile 493 # And if we didn't pass it, we can take a nosey in the Makefile
257 kbuild_output="$(getfilevar KBUILD_OUTPUT ${KV_DIR}/Makefile)" 494 kbuild_output="$(getfilevar_noexec KBUILD_OUTPUT ${KV_DIR}/Makefile)"
258 OUTPUT_DIR="${OUTPUT_DIR:-${kbuild_output}}" 495 OUTPUT_DIR="${OUTPUT_DIR:-${kbuild_output}}"
259 496
260 # And contrary to existing functions I feel we shouldn't trust the 497 # And contrary to existing functions I feel we shouldn't trust the
261 # directory name to find version information as this seems insane. 498 # directory name to find version information as this seems insane.
262 # so we parse ${KV_DIR}/Makefile 499 # so we parse ${KV_DIR}/Makefile
263 KV_MAJOR="$(getfilevar VERSION ${KV_DIR}/Makefile)" 500 KV_MAJOR="$(getfilevar_noexec VERSION ${KV_DIR}/Makefile)"
264 KV_MINOR="$(getfilevar PATCHLEVEL ${KV_DIR}/Makefile)" 501 KV_MINOR="$(getfilevar_noexec PATCHLEVEL ${KV_DIR}/Makefile)"
265 KV_PATCH="$(getfilevar SUBLEVEL ${KV_DIR}/Makefile)" 502 KV_PATCH="$(getfilevar_noexec SUBLEVEL ${KV_DIR}/Makefile)"
266 KV_EXTRA="$(getfilevar EXTRAVERSION ${KV_DIR}/Makefile)" 503 KV_EXTRA="$(getfilevar_noexec EXTRAVERSION ${KV_DIR}/Makefile)"
267 504
268 if [ -z "${KV_MAJOR}" -o -z "${KV_MINOR}" -o -z "${KV_PATCH}" ] 505 if [ -z "${KV_MAJOR}" -o -z "${KV_MINOR}" -o -z "${KV_PATCH}" ]
269 then 506 then
507 if [ -z "${get_version_warning_done}" ]; then
508 get_version_warning_done=1
270 qeerror "Could not detect kernel version." 509 qeerror "Could not detect kernel version."
271 qeerror "Please ensure that ${KERNEL_DIR} points to a complete set of Linux sources." 510 qeerror "Please ensure that ${KERNEL_DIR} points to a complete set of Linux sources."
511 fi
272 return 1 512 return 1
273 fi 513 fi
274 514
275 # and in newer versions we can also pull LOCALVERSION if it is set. 515 # and in newer versions we can also pull LOCALVERSION if it is set.
276 # but before we do this, we need to find if we use a different object directory. 516 # but before we do this, we need to find if we use a different object directory.
277 # This *WILL* break if the user is using localversions, but we assume it was 517 # This *WILL* break if the user is using localversions, but we assume it was
278 # caught before this if they are. 518 # caught before this if they are.
279 [ "${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}.${KV_EXTRA}" == "$(uname -r)" ] && \ 519 [ "${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}" == "$(uname -r)" ] && \
280 OUTPUT_DIR="${OUTPUT_DIR:-/lib/modules/${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}.${KV_EXTRA}/build}" 520 OUTPUT_DIR="${OUTPUT_DIR:-/lib/modules/${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}/build}"
281 521
282 [ -h "${OUTPUT_DIR}" ] && KV_OUT_DIR="$(readlink -f ${OUTPUT_DIR})" 522 [ -h "${OUTPUT_DIR}" ] && KV_OUT_DIR="$(readlink -f ${OUTPUT_DIR})"
283 [ -d "${OUTPUT_DIR}" ] && KV_OUT_DIR="${OUTPUT_DIR}" 523 [ -d "${OUTPUT_DIR}" ] && KV_OUT_DIR="${OUTPUT_DIR}"
284 if [ -n "${KV_OUT_DIR}" ]; 524 if [ -n "${KV_OUT_DIR}" ];
285 then 525 then
286 qeinfo "Found kernel object directory:" 526 qeinfo "Found kernel object directory:"
287 qeinfo " ${KV_OUT_DIR}" 527 qeinfo " ${KV_OUT_DIR}"
288 528
289 KV_LOCAL="$(get_localversion ${KV_OUT_DIR})" 529 KV_LOCAL="$(get_localversion ${KV_OUT_DIR})"
290 fi 530 fi
291 # and if we STILL haven't got it, then we better just set it to KV_DIR 531 # and if we STILL have not got it, then we better just set it to KV_DIR
292 KV_OUT_DIR="${KV_OUT_DIR:-${KV_DIR}}" 532 KV_OUT_DIR="${KV_OUT_DIR:-${KV_DIR}}"
293 533
294 KV_LOCAL="${KV_LOCAL}$(get_localversion ${KV_DIR})" 534 KV_LOCAL="${KV_LOCAL}$(get_localversion ${KV_DIR})"
535 if linux_config_src_exists; then
295 KV_LOCAL="${KV_LOCAL}$(linux_chkconfig_string LOCALVERSION)" 536 KV_LOCAL="${KV_LOCAL}$(linux_chkconfig_string LOCALVERSION)"
296 KV_LOCAL="${KV_LOCAL//\"/}" 537 KV_LOCAL="${KV_LOCAL//\"/}"
538
539 # For things like git that can append extra stuff:
540 [ -e ${KV_DIR}/scripts/setlocalversion ] &&
541 linux_chkconfig_builtin LOCALVERSION_AUTO &&
542 KV_LOCAL="${KV_LOCAL}$(sh ${KV_DIR}/scripts/setlocalversion ${KV_DIR})"
543 fi
297 544
298 # And we should set KV_FULL to the full expanded version 545 # And we should set KV_FULL to the full expanded version
299 KV_FULL="${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}${KV_LOCAL}" 546 KV_FULL="${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}${KV_LOCAL}"
300 547
301 qeinfo "Found sources for kernel version:" 548 qeinfo "Found sources for kernel version:"
302 qeinfo " ${KV_FULL}" 549 qeinfo " ${KV_FULL}"
303 550
304 if [ ! -s "${KV_OUT_DIR}/.config" ]
305 then
306 qeerror "Could not find a usable .config in the kernel source directory."
307 qeerror "Please ensure that ${KERNEL_DIR} points to a configured set of Linux sources."
308 qeerror "If you are using KBUILD_OUTPUT, please set the environment var so that"
309 qeerror "it points to the necessary object directory so that it might find .config."
310 return 1
311 fi
312
313 return 0 551 return 0
314} 552}
315 553
554# @FUNCTION: get_running_version
555# @DESCRIPTION:
556# It gets the version of the current running kernel and the result is the same as get_version() if the
557# function can find the sources.
316get_running_version() { 558get_running_version() {
317 KV_FULL=$(uname -r) 559 KV_FULL=$(uname -r)
318 560
319 if [[ -f ${ROOT}/lib/modules/${KV_FULL}/source/Makefile ]]; then 561 if [[ -f ${ROOT}/lib/modules/${KV_FULL}/source/Makefile ]]; then
320 KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/source) 562 KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/source)
335 && KV_EXTRA="-${KV_FULL#*-}" 577 && KV_EXTRA="-${KV_FULL#*-}"
336 fi 578 fi
337 return 0 579 return 0
338} 580}
339 581
582# This next function is named with the eclass prefix to avoid conflicts with
583# some old versionator-like eclass functions.
584
585# @FUNCTION: linux-info_get_any_version
586# @DESCRIPTION:
587# This attempts to find the version of the sources, and otherwise falls back to
588# the version of the running kernel.
589linux-info_get_any_version() {
590 get_version
591 if [[ $? -ne 0 ]]; then
592 ewarn "Unable to calculate Linux Kernel version for build, attempting to use running version"
593 get_running_version
594 fi
595}
596
340 597
341# ebuild check functions 598# ebuild check functions
342# --------------------------------------- 599# ---------------------------------------
343 600
601# @FUNCTION: check_kernel_built
602# @DESCRIPTION:
603# This function verifies that the current kernel sources have been already prepared otherwise it dies.
344check_kernel_built() { 604check_kernel_built() {
345 # if we haven't determined the version yet, we need too. 605 # if we haven't determined the version yet, we need to
606 require_configured_kernel
346 get_version; 607 get_version
347 608
348 if [ ! -f "${KV_OUT_DIR}/include/linux/version.h" ] 609 if [ ! -f "${KV_OUT_DIR}/include/linux/version.h" ]
349 then 610 then
350 eerror "These sources have not yet been prepared." 611 eerror "These sources have not yet been prepared."
351 eerror "We cannot build against an unprepared tree." 612 eerror "We cannot build against an unprepared tree."
358 eerror "Then please try merging this module again." 619 eerror "Then please try merging this module again."
359 die "Kernel sources need compiling first" 620 die "Kernel sources need compiling first"
360 fi 621 fi
361} 622}
362 623
624# @FUNCTION: check_modules_supported
625# @DESCRIPTION:
626# This function verifies that the current kernel support modules (it checks CONFIG_MODULES=y) otherwise it dies.
363check_modules_supported() { 627check_modules_supported() {
364 # if we haven't determined the version yet, we need too. 628 # if we haven't determined the version yet, we need too.
629 require_configured_kernel
365 get_version; 630 get_version
366 631
367 if ! linux_chkconfig_builtin "MODULES" 632 if ! linux_chkconfig_builtin "MODULES"
368 then 633 then
369 eerror "These sources do not support loading external modules." 634 eerror "These sources do not support loading external modules."
370 eerror "to be able to use this module please enable \"Loadable modules support\"" 635 eerror "to be able to use this module please enable \"Loadable modules support\""
371 eerror "in your kernel, recompile and then try merging this module again." 636 eerror "in your kernel, recompile and then try merging this module again."
372 die "No support for external modules in ${KV_FULL} config" 637 die "No support for external modules in ${KV_FULL} config"
373 fi 638 fi
374} 639}
375 640
641# @FUNCTION: check_extra_config
642# @DESCRIPTION:
643# It checks the kernel config options specified by CONFIG_CHECK. It dies only when a required config option (i.e.
644# the prefix ~ is not used) doesn't satisfy the directive.
376check_extra_config() { 645check_extra_config() {
377 local config negate error local_error i n
378 local temp_config die reworkmodulenames 646 local config negate die error reworkmodulenames
647 local soft_errors_count=0 hard_errors_count=0 config_required=0
648 # store the value of the QA check, because otherwise we won't catch usages
649 # after if check_extra_config is called AND other direct calls are done
650 # later.
651 local old_LINUX_CONFIG_EXISTS_DONE="${_LINUX_CONFIG_EXISTS_DONE}"
379 652
380 # if we haven't determined the version yet, we need too. 653 # if we haven't determined the version yet, we need to
381 get_version; 654 linux-info_get_any_version
382 655
656 # Determine if we really need a .config. The only time when we don't need
657 # one is when all of the CONFIG_CHECK options are prefixed with "~".
658 for config in ${CONFIG_CHECK}
659 do
660 if [[ "${config:0:1}" != "~" ]]; then
661 config_required=1
662 break
663 fi
664 done
665
666 # TODO: After we enable the new code for /proc/config.gz, we need to
667 # change this back to linux_config_exists.
668 if [[ ${config_required} == 0 ]]; then
669 # In the case where we don't require a .config, we can now bail out
670 # if the user has no .config as there is nothing to do. Otherwise
671 # code later will cause a failure due to missing .config.
672 if ! linux_config_src_exists; then
673 ewarn "Unable to check for the following kernel config options due"
674 ewarn "to absence of any configured kernel sources or compiled"
675 ewarn "config:"
676 for config in ${CONFIG_CHECK}; do
677 ewarn " - ${config#\~}"
678 done
679 ewarn "You're on your own to make sure they are set if needed."
680 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
681 return 0
682 fi
683 else
684 [ -n "${I_KNOW_WHAT_I_AM_DOING}" ] && require_configured_kernel
685 fi
686
383 einfo "Checking for suitable kernel configuration options:" 687 einfo "Checking for suitable kernel configuration options..."
688
384 for config in ${CONFIG_CHECK} 689 for config in ${CONFIG_CHECK}
385 do 690 do
386 # if we specify any fatal, ensure we honor them 691 # if we specify any fatal, ensure we honor them
387 die=1 692 die=1
388 error=0 693 error=0
389 negate=0 694 negate=0
390 reworkmodulenames=0 695 reworkmodulenames=0
391 696
392 if [[ -z ${config//\!*} ]]; then 697 if [[ ${config:0:1} == "~" ]]; then
393 negate=1 698 die=0
394 config=${config:1} 699 config=${config:1}
395 fi 700 elif [[ ${config:0:1} == "@" ]]; then
396 if [[ -z ${config/\@*} ]]; then
397 die=2 701 die=0
398 reworkmodulenames=1 702 reworkmodulenames=1
399 config=${config:1} 703 config=${config:1}
400 fi 704 fi
401 if [[ -z ${config/\~*} ]]; then 705 if [[ ${config:0:1} == "!" ]]; then
402 die=0 706 negate=1
403 config=${config:1} 707 config=${config:1}
404 fi 708 fi
405 709
406 if [[ ${negate} == 1 ]]; then 710 if [[ ${negate} == 1 ]]; then
407 linux_chkconfig_present ${config} && error=2 711 linux_chkconfig_present ${config} && error=2
408 elif [[ ${reworkmodulenames} == 1 ]]; then 712 elif [[ ${reworkmodulenames} == 1 ]]; then
409 temp_config="${config//*:}" 713 local temp_config="${config//*:}" i n
410 config="${config//:*}" 714 config="${config//:*}"
411 if linux_chkconfig_present ${config}; then 715 if linux_chkconfig_present ${config}; then
412 for i in ${MODULE_NAMES}; do 716 for i in ${MODULE_NAMES}; do
413 n="${i//${temp_config}}" 717 n="${i//${temp_config}}"
414 [[ -z ${n//(*} ]] && \ 718 [[ -z ${n//\(*} ]] && \
415 MODULE_IGNORE="${MODULE_IGNORE} ${temp_config}" 719 MODULE_IGNORE="${MODULE_IGNORE} ${temp_config}"
416 done 720 done
417 error=2 721 error=2
418 fi 722 fi
419 else 723 else
420 linux_chkconfig_present ${config} || error=1 724 linux_chkconfig_present ${config} || error=1
421 fi 725 fi
422 726
423 if [[ ${die} == 0 ]]; then
424 ebegin "CONFIG_${config}"
425 eend ${error}
426 else
427 if [[ ${error} > 0 ]]; then 727 if [[ ${error} > 0 ]]; then
728 local report_func="eerror" local_error
729 local_error="ERROR_${config}"
730 local_error="${!local_error}"
731
732 if [[ -z "${local_error}" ]]; then
733 # using old, deprecated format.
428 local_error="${config}_ERROR" 734 local_error="${config}_ERROR"
429 local_error="${!local_error}" 735 local_error="${!local_error}"
736 fi
737 if [[ ${die} == 0 && -z "${local_error}" ]]; then
738 #soft errors can be warnings
739 local_error="WARNING_${config}"
740 local_error="${!local_error}"
430 if [[ -z "${local_error}" ]]; then 741 if [[ -n "${local_error}" ]] ; then
431 [[ ${error} == 1 ]] \ 742 report_func="ewarn"
432 && local_error="is not set when it should be." \
433 || local_error="should not be set. But it is."
434 local_error="CONFIG_${config}:\t ${local_error}"
435 fi 743 fi
436 eerror " ${local_error}"
437 fi 744 fi
745
746 if [[ -z "${local_error}" ]]; then
747 [[ ${error} == 1 ]] \
748 && local_error="is not set when it should be." \
749 || local_error="should not be set. But it is."
750 local_error="CONFIG_${config}:\t ${local_error}"
751 fi
752 if [[ ${die} == 0 ]]; then
753 ${report_func} " ${local_error}"
754 soft_errors_count=$[soft_errors_count + 1]
755 else
756 ${report_func} " ${local_error}"
757 hard_errors_count=$[hard_errors_count + 1]
758 fi
438 fi 759 fi
439 done 760 done
440 761
441 if [[ ${error} > 0 ]]; then 762 if [[ ${hard_errors_count} > 0 ]]; then
442 eerror "Please check to make sure these options are set correctly." 763 eerror "Please check to make sure these options are set correctly."
443 eerror "Failure to do so may cause unexpected problems." 764 eerror "Failure to do so may cause unexpected problems."
444 if [[ ${die} == 1 ]]; then
445 eerror "Once you have satisfied these options, please try merging" 765 eerror "Once you have satisfied these options, please try merging"
446 eerror "this package again." 766 eerror "this package again."
767 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
447 die "Incorrect kernel configuration options" 768 die "Incorrect kernel configuration options"
769 elif [[ ${soft_errors_count} > 0 ]]; then
770 ewarn "Please check to make sure these options are set correctly."
771 ewarn "Failure to do so may cause unexpected problems."
772 else
773 eend 0
448 fi 774 fi
449 fi 775 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
450} 776}
451 777
452check_zlibinflate() { 778check_zlibinflate() {
453 # if we haven't determined the version yet, we need too. 779 # if we haven't determined the version yet, we need to
780 require_configured_kernel
454 get_version; 781 get_version
455 782
456 # although I restructured this code - I really really really dont support it! 783 # although I restructured this code - I really really really dont support it!
457 784
458 # bug #27882 - zlib routines are only linked into the kernel 785 # bug #27882 - zlib routines are only linked into the kernel
459 # if something compiled into the kernel calls them 786 # if something compiled into the kernel calls them
466 local DEFLATE 793 local DEFLATE
467 794
468 einfo "Determining the usability of ZLIB_INFLATE support in your kernel" 795 einfo "Determining the usability of ZLIB_INFLATE support in your kernel"
469 796
470 ebegin "checking ZLIB_INFLATE" 797 ebegin "checking ZLIB_INFLATE"
471 getfilevar_isbuiltin CONFIG_ZLIB_INFLATE ${KV_DIR}/.config 798 linux_chkconfig_builtin CONFIG_ZLIB_INFLATE
472 eend $? 799 eend $?
473 [ "$?" != 0 ] && die 800 [ "$?" != 0 ] && die
474 801
475 ebegin "checking ZLIB_DEFLATE" 802 ebegin "checking ZLIB_DEFLATE"
476 getfilevar_isbuiltin CONFIG_ZLIB_DEFLATE ${KV_DIR}/.config 803 linux_chkconfig_builtin CONFIG_ZLIB_DEFLATE
477 eend $? 804 eend $?
478 [ "$?" != 0 ] && die 805 [ "$?" != 0 ] && die
479 806
480 local LINENO_START 807 local LINENO_START
481 local LINENO_END 808 local LINENO_END
519} 846}
520 847
521################################ 848################################
522# Default pkg_setup 849# Default pkg_setup
523# Also used when inheriting linux-mod to force a get_version call 850# Also used when inheriting linux-mod to force a get_version call
524 851# @FUNCTION: linux-info_pkg_setup
852# @DESCRIPTION:
853# Force a get_version() call when inherited from linux-mod.eclass and then check if the kernel is configured
854# to support the options specified in CONFIG_CHECK (if not null)
525linux-info_pkg_setup() { 855linux-info_pkg_setup() {
526 get_version || die "Unable to calculate Linux Kernel version" 856 linux-info_get_any_version
857
858 if kernel_is 2 4; then
859 if [ "$( gcc-major-version )" -eq "4" ] ; then
860 echo
861 ewarn "Be warned !! >=sys-devel/gcc-4.0.0 isn't supported with"
862 ewarn "linux-2.4 (or modules building against a linux-2.4 kernel)!"
863 echo
864 ewarn "Either switch to another gcc-version (via gcc-config) or use a"
865 ewarn "newer kernel that supports gcc-4."
866 echo
867 ewarn "Also be aware that bugreports about gcc-4 not working"
868 ewarn "with linux-2.4 based ebuilds will be closed as INVALID!"
869 echo
870 epause 10
871 fi
872 fi
873
527 [ -n "${CONFIG_CHECK}" ] && check_extra_config; 874 [ -n "${CONFIG_CHECK}" ] && check_extra_config;
528} 875}

Legend:
Removed from v.1.34  
changed lines
  Added in v.1.76

  ViewVC Help
Powered by ViewVC 1.1.20