/[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.89 Revision 1.98
1# Copyright 1999-2006 Gentoo Foundation 1# Copyright 1999-2013 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.89 2011/08/18 14:58:57 vapier Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/linux-info.eclass,v 1.98 2013/02/10 06:18:19 vapier Exp $
4#
5# Original author: John Mylchreest <johnm@gentoo.org>
6# Maintainer: kernel-misc@gentoo.org
7#
8# Please direct your bugs to the current eclass maintainer :)
9 4
10# @ECLASS: linux-info.eclass 5# @ECLASS: linux-info.eclass
11# @MAINTAINER: 6# @MAINTAINER:
12# kernel-misc@gentoo.org 7# kernel-misc@gentoo.org
8# @AUTHOR:
9# Original author: John Mylchreest <johnm@gentoo.org>
13# @BLURB: eclass used for accessing kernel related information 10# @BLURB: eclass used for accessing kernel related information
14# @DESCRIPTION: 11# @DESCRIPTION:
15# This eclass is used as a central eclass for accessing kernel 12# This eclass is used as a central eclass for accessing kernel
16# related information for source or binary already installed. 13# related information for source or binary already installed.
17# It is vital for linux-mod.eclass to function correctly, and is split 14# It is vital for linux-mod.eclass to function correctly, and is split
19# using additional eclasses. 16# using additional eclasses.
20# 17#
21# "kernel config" in this file means: 18# "kernel config" in this file means:
22# The .config of the currently installed sources is used as the first 19# 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. 20# preference, with a fall-back to bundled config (/proc/config.gz) if available.
21#
22# Before using any of the config-handling functions in this eclass, you must
23# ensure that one of the following functions has been called (in order of
24# preference), otherwise you will get bugs like #364041):
25# linux-info_pkg_setup
26# linux-info_get_any_version
27# get_version
28# get_running_version
24 29
25# A Couple of env vars are available to effect usage of this eclass 30# A Couple of env vars are available to effect usage of this eclass
26# These are as follows: 31# These are as follows:
27 32
28# @ECLASS-VARIABLE: KERNEL_DIR 33# @ECLASS-VARIABLE: KERNEL_DIR
160# @DESCRIPTION: 165# @DESCRIPTION:
161# It detects the value of the variable defined in the file configfile. This is 166# It detects the value of the variable defined in the file configfile. This is
162# done by including the configfile, and printing the variable with Make. 167# done by including the configfile, and printing the variable with Make.
163# It WILL break if your makefile has missing dependencies! 168# It WILL break if your makefile has missing dependencies!
164getfilevar() { 169getfilevar() {
165local ERROR basefname basedname myARCH="${ARCH}" 170 local ERROR basefname basedname myARCH="${ARCH}"
166 ERROR=0 171 ERROR=0
167 172
168 [ -z "${1}" ] && ERROR=1 173 [ -z "${1}" ] && ERROR=1
169 [ ! -f "${2}" ] && ERROR=1 174 [ ! -f "${2}" ] && ERROR=1
170 175
176 else 181 else
177 basefname="$(basename ${2})" 182 basefname="$(basename ${2})"
178 basedname="$(dirname ${2})" 183 basedname="$(dirname ${2})"
179 unset ARCH 184 unset ARCH
180 185
186 # We use nonfatal because we want the caller to take care of things #373151
187 [[ ${EAPI:-0} == [0123] ]] && nonfatal() { "$@"; }
181 echo -e "e:\\n\\t@echo \$(${1})\\ninclude ${basefname}" | \ 188 echo -e "e:\\n\\t@echo \$(${1})\\ninclude ${basefname}" | \
182 make -C "${basedname}" M="${S}" ${BUILD_FIXES} -s -f - 2>/dev/null 189 nonfatal emake -C "${basedname}" M="${S}" ${BUILD_FIXES} -s -f - 2>/dev/null
183 190
184 ARCH=${myARCH} 191 ARCH=${myARCH}
185 fi 192 fi
186} 193}
187 194
191# @DESCRIPTION: 198# @DESCRIPTION:
192# It detects the value of the variable defined in the file configfile. 199# It detects the value of the variable defined in the file configfile.
193# This is done with sed matching an expression only. If the variable is defined, 200# This is done with sed matching an expression only. If the variable is defined,
194# you will run into problems. See getfilevar for those cases. 201# you will run into problems. See getfilevar for those cases.
195getfilevar_noexec() { 202getfilevar_noexec() {
196 local ERROR basefname basedname mycat myARCH="${ARCH}" 203 local ERROR basefname basedname mycat myARCH="${ARCH}"
197 ERROR=0 204 ERROR=0
198 mycat='cat' 205 mycat='cat'
199 206
200 [ -z "${1}" ] && ERROR=1 207 [ -z "${1}" ] && ERROR=1
201 [ ! -f "${2}" ] && ERROR=1 208 [ ! -f "${2}" ] && ERROR=1
215 p 222 p
216 }" 223 }"
217 fi 224 fi
218} 225}
219 226
220# @PRIVATE-VARIABLE: _LINUX_CONFIG_EXISTS_DONE 227# @ECLASS-VARIABLE: _LINUX_CONFIG_EXISTS_DONE
228# @INTERNAL
221# @DESCRIPTION: 229# @DESCRIPTION:
222# This is only set if one of the linux_config_*exists functions has been called. 230# This is only set if one of the linux_config_*exists functions has been called.
223# We use it for a QA warning that the check for a config has not been performed, 231# We use it for a QA warning that the check for a config has not been performed,
224# as linux_chkconfig* in non-legacy mode WILL return an undefined value if no 232# as linux_chkconfig* in non-legacy mode WILL return an undefined value if no
225# config is available at all. 233# config is available at all.
237# @RETURN: true or false 245# @RETURN: true or false
238# @DESCRIPTION: 246# @DESCRIPTION:
239# It returns true if .config exists in a build directory otherwise false 247# It returns true if .config exists in a build directory otherwise false
240linux_config_src_exists() { 248linux_config_src_exists() {
241 export _LINUX_CONFIG_EXISTS_DONE=1 249 export _LINUX_CONFIG_EXISTS_DONE=1
242 [ -s "${KV_OUT_DIR}/.config" ] 250 [[ -n ${KV_OUT_DIR} && -s ${KV_OUT_DIR}/.config ]]
243} 251}
244 252
245# @FUNCTION: linux_config_bin_exists 253# @FUNCTION: linux_config_bin_exists
246# @RETURN: true or false 254# @RETURN: true or false
247# @DESCRIPTION: 255# @DESCRIPTION:
248# It returns true if .config exists in /proc, otherwise false 256# It returns true if .config exists in /proc, otherwise false
249linux_config_bin_exists() { 257linux_config_bin_exists() {
250 export _LINUX_CONFIG_EXISTS_DONE=1 258 export _LINUX_CONFIG_EXISTS_DONE=1
251 [ -s "/proc/config.gz" ] 259 [[ -s /proc/config.gz ]]
252} 260}
253 261
254# @FUNCTION: linux_config_exists 262# @FUNCTION: linux_config_exists
255# @RETURN: true or false 263# @RETURN: true or false
256# @DESCRIPTION: 264# @DESCRIPTION:
258# 266#
259# This function MUST be checked before using any of the linux_chkconfig_* 267# This function MUST be checked before using any of the linux_chkconfig_*
260# functions. 268# functions.
261linux_config_exists() { 269linux_config_exists() {
262 linux_config_src_exists || linux_config_bin_exists 270 linux_config_src_exists || linux_config_bin_exists
271}
272
273# @FUNCTION: linux_config_path
274# @DESCRIPTION:
275# Echo the name of the config file to use. If none are found,
276# then return false.
277linux_config_path() {
278 if linux_config_src_exists; then
279 echo "${KV_OUT_DIR}/.config"
280 elif linux_config_bin_exists; then
281 echo "/proc/config.gz"
282 else
283 return 1
284 fi
263} 285}
264 286
265# @FUNCTION: require_configured_kernel 287# @FUNCTION: require_configured_kernel
266# @DESCRIPTION: 288# @DESCRIPTION:
267# This function verifies that the current kernel is configured (it checks against the existence of .config) 289# This function verifies that the current kernel is configured (it checks against the existence of .config)
283# It checks that CONFIG_<option>=y or CONFIG_<option>=m is present in the current kernel .config 305# It checks that CONFIG_<option>=y or CONFIG_<option>=m is present in the current kernel .config
284# If linux_config_exists returns false, the results of this are UNDEFINED. You 306# If linux_config_exists returns false, the results of this are UNDEFINED. You
285# MUST call linux_config_exists first. 307# MUST call linux_config_exists first.
286linux_chkconfig_present() { 308linux_chkconfig_present() {
287 linux_config_qa_check linux_chkconfig_present 309 linux_config_qa_check linux_chkconfig_present
288 local RESULT 310 [[ $(getfilevar_noexec "CONFIG_$1" "$(linux_config_path)") == [my] ]]
289 local config
290 config="${KV_OUT_DIR}/.config"
291 [ ! -f "${config}" ] && config="/proc/config.gz"
292 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
293 [ "${RESULT}" = "m" -o "${RESULT}" = "y" ] && return 0 || return 1
294} 311}
295 312
296# @FUNCTION: linux_chkconfig_module 313# @FUNCTION: linux_chkconfig_module
297# @USAGE: option 314# @USAGE: option
298# @RETURN: true or false 315# @RETURN: true or false
300# It checks that CONFIG_<option>=m is present in the current kernel .config 317# It checks that CONFIG_<option>=m is present in the current kernel .config
301# If linux_config_exists returns false, the results of this are UNDEFINED. You 318# If linux_config_exists returns false, the results of this are UNDEFINED. You
302# MUST call linux_config_exists first. 319# MUST call linux_config_exists first.
303linux_chkconfig_module() { 320linux_chkconfig_module() {
304 linux_config_qa_check linux_chkconfig_module 321 linux_config_qa_check linux_chkconfig_module
305 local RESULT 322 [[ $(getfilevar_noexec "CONFIG_$1" "$(linux_config_path)") == m ]]
306 local config
307 config="${KV_OUT_DIR}/.config"
308 [ ! -f "${config}" ] && config="/proc/config.gz"
309 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
310 [ "${RESULT}" = "m" ] && return 0 || return 1
311} 323}
312 324
313# @FUNCTION: linux_chkconfig_builtin 325# @FUNCTION: linux_chkconfig_builtin
314# @USAGE: option 326# @USAGE: option
315# @RETURN: true or false 327# @RETURN: true or false
317# It checks that CONFIG_<option>=y is present in the current kernel .config 329# It checks that CONFIG_<option>=y is present in the current kernel .config
318# If linux_config_exists returns false, the results of this are UNDEFINED. You 330# If linux_config_exists returns false, the results of this are UNDEFINED. You
319# MUST call linux_config_exists first. 331# MUST call linux_config_exists first.
320linux_chkconfig_builtin() { 332linux_chkconfig_builtin() {
321 linux_config_qa_check linux_chkconfig_builtin 333 linux_config_qa_check linux_chkconfig_builtin
322 local RESULT 334 [[ $(getfilevar_noexec "CONFIG_$1" "$(linux_config_path)") == y ]]
323 local config
324 config="${KV_OUT_DIR}/.config"
325 [ ! -f "${config}" ] && config="/proc/config.gz"
326 RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
327 [ "${RESULT}" = "y" ] && return 0 || return 1
328} 335}
329 336
330# @FUNCTION: linux_chkconfig_string 337# @FUNCTION: linux_chkconfig_string
331# @USAGE: option 338# @USAGE: option
332# @RETURN: CONFIG_<option> 339# @RETURN: CONFIG_<option>
334# It prints the CONFIG_<option> value of the current kernel .config (it requires a configured kernel). 341# It prints the CONFIG_<option> value of the current kernel .config (it requires a configured kernel).
335# If linux_config_exists returns false, the results of this are UNDEFINED. You 342# If linux_config_exists returns false, the results of this are UNDEFINED. You
336# MUST call linux_config_exists first. 343# MUST call linux_config_exists first.
337linux_chkconfig_string() { 344linux_chkconfig_string() {
338 linux_config_qa_check linux_chkconfig_string 345 linux_config_qa_check linux_chkconfig_string
339 local config
340 config="${KV_OUT_DIR}/.config"
341 [ ! -f "${config}" ] && config="/proc/config.gz"
342 getfilevar_noexec "CONFIG_${1}" "${config}" 346 getfilevar_noexec "CONFIG_$1" "$(linux_config_path)"
343} 347}
344 348
345# Versioning Functions 349# Versioning Functions
346# --------------------------------------- 350# ---------------------------------------
347 351
359# kernel_is 2 6 returns true 363# kernel_is 2 6 returns true
360# kernel_is 2 6 8 returns false 364# kernel_is 2 6 8 returns false
361# kernel_is 2 6 9 returns true 365# kernel_is 2 6 9 returns true
362# @CODE 366# @CODE
363 367
364# got the jist yet? 368# Note: duplicated in kernel-2.eclass
365
366kernel_is() { 369kernel_is() {
367 # if we haven't determined the version yet, we need to. 370 # if we haven't determined the version yet, we need to.
368 linux-info_get_any_version 371 linux-info_get_any_version
369 372
370 local operator testagainst value x=0 y=0 z=0 373 # Now we can continue
374 local operator test value
371 375
372 case ${1} in 376 case ${1#-} in
373 -lt|lt) operator="-lt"; shift;; 377 lt) operator="-lt"; shift;;
374 -gt|gt) operator="-gt"; shift;; 378 gt) operator="-gt"; shift;;
375 -le|le) operator="-le"; shift;; 379 le) operator="-le"; shift;;
376 -ge|ge) operator="-ge"; shift;; 380 ge) operator="-ge"; shift;;
377 -eq|eq) operator="-eq"; shift;; 381 eq) operator="-eq"; shift;;
378 *) operator="-eq";; 382 *) operator="-eq";;
379 esac 383 esac
380
381 for x in ${@}; do
382 for((y=0; y<$((3 - ${#x})); y++)); do value="${value}0"; done
383 value="${value}${x}"
384 z=$((${z} + 1))
385
386 case ${z} in
387 1) for((y=0; y<$((3 - ${#KV_MAJOR})); y++)); do testagainst="${testagainst}0"; done;
388 testagainst="${testagainst}${KV_MAJOR}";;
389 2) for((y=0; y<$((3 - ${#KV_MINOR})); y++)); do testagainst="${testagainst}0"; done;
390 testagainst="${testagainst}${KV_MINOR}";;
391 3) for((y=0; y<$((3 - ${#KV_PATCH})); y++)); do testagainst="${testagainst}0"; done;
392 testagainst="${testagainst}${KV_PATCH}";;
393 *) die "Error in kernel-2_kernel_is(): Too many parameters.";; 384 [[ $# -gt 3 ]] && die "Error in kernel-2_kernel_is(): too many parameters"
394 esac
395 done
396 385
397 [ "${testagainst}" ${operator} "${value}" ] && return 0 || return 1 386 : $(( test = (KV_MAJOR << 16) + (KV_MINOR << 8) + KV_PATCH ))
387 : $(( value = (${1:-${KV_MAJOR}} << 16) + (${2:-${KV_MINOR}} << 8) + ${3:-${KV_PATCH}} ))
388 [ ${test} ${operator} ${value} ]
398} 389}
399 390
400get_localversion() { 391get_localversion() {
401 local lv_list i x 392 local lv_list i x
402 393
594 KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/build) 585 KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/build)
595 unset KV_FULL 586 unset KV_FULL
596 get_version 587 get_version
597 return $? 588 return $?
598 else 589 else
590 # This handles a variety of weird kernel versions. Make sure to update
591 # tests/linux-info:get_running_version.sh if you want to change this.
592 local kv_full=${KV_FULL//[-+_]*}
599 KV_MAJOR=$(get_version_component_range 1 ${KV_FULL}) 593 KV_MAJOR=$(get_version_component_range 1 ${kv_full})
600 KV_MINOR=$(get_version_component_range 2 ${KV_FULL}) 594 KV_MINOR=$(get_version_component_range 2 ${kv_full})
601 KV_PATCH=$(get_version_component_range 3 ${KV_FULL}) 595 KV_PATCH=$(get_version_component_range 3 ${kv_full})
602 KV_PATCH=${KV_PATCH//-*}
603 KV_EXTRA="${KV_FULL#${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}}" 596 KV_EXTRA="${KV_FULL#${KV_MAJOR}.${KV_MINOR}${KV_PATCH:+.${KV_PATCH}}}"
597 : ${KV_PATCH:=0}
604 fi 598 fi
605 return 0 599 return 0
606} 600}
607 601
608# This next function is named with the eclass prefix to avoid conflicts with 602# This next function is named with the eclass prefix to avoid conflicts with
630check_kernel_built() { 624check_kernel_built() {
631 # if we haven't determined the version yet, we need to 625 # if we haven't determined the version yet, we need to
632 require_configured_kernel 626 require_configured_kernel
633 get_version 627 get_version
634 628
629 local versionh_path
630 if kernel_is -ge 3 7; then
631 versionh_path="include/generated/uapi/linux/version.h"
632 else
633 versionh_path="include/linux/version.h"
634 fi
635
635 if [ ! -f "${KV_OUT_DIR}/include/linux/version.h" ] 636 if [ ! -f "${KV_OUT_DIR}/${versionh_path}" ]
636 then 637 then
637 eerror "These sources have not yet been prepared." 638 eerror "These sources have not yet been prepared."
638 eerror "We cannot build against an unprepared tree." 639 eerror "We cannot build against an unprepared tree."
639 eerror "To resolve this, please type the following:" 640 eerror "To resolve this, please type the following:"
640 eerror 641 eerror
653check_modules_supported() { 654check_modules_supported() {
654 # if we haven't determined the version yet, we need too. 655 # if we haven't determined the version yet, we need too.
655 require_configured_kernel 656 require_configured_kernel
656 get_version 657 get_version
657 658
658 if ! linux_chkconfig_builtin "MODULES" 659 if ! linux_chkconfig_builtin "MODULES"; then
659 then
660 eerror "These sources do not support loading external modules." 660 eerror "These sources do not support loading external modules."
661 eerror "to be able to use this module please enable \"Loadable modules support\"" 661 eerror "to be able to use this module please enable \"Loadable modules support\""
662 eerror "in your kernel, recompile and then try merging this module again." 662 eerror "in your kernel, recompile and then try merging this module again."
663 die "No support for external modules in ${KV_FULL} config" 663 die "No support for external modules in ${KV_FULL} config"
664 fi 664 fi
667# @FUNCTION: check_extra_config 667# @FUNCTION: check_extra_config
668# @DESCRIPTION: 668# @DESCRIPTION:
669# It checks the kernel config options specified by CONFIG_CHECK. It dies only when a required config option (i.e. 669# It checks the kernel config options specified by CONFIG_CHECK. It dies only when a required config option (i.e.
670# the prefix ~ is not used) doesn't satisfy the directive. 670# the prefix ~ is not used) doesn't satisfy the directive.
671check_extra_config() { 671check_extra_config() {
672 local config negate die error reworkmodulenames 672 local config negate die error reworkmodulenames
673 local soft_errors_count=0 hard_errors_count=0 config_required=0 673 local soft_errors_count=0 hard_errors_count=0 config_required=0
674 # store the value of the QA check, because otherwise we won't catch usages 674 # store the value of the QA check, because otherwise we won't catch usages
675 # after if check_extra_config is called AND other direct calls are done 675 # after if check_extra_config is called AND other direct calls are done
676 # later. 676 # later.
677 local old_LINUX_CONFIG_EXISTS_DONE="${_LINUX_CONFIG_EXISTS_DONE}" 677 local old_LINUX_CONFIG_EXISTS_DONE="${_LINUX_CONFIG_EXISTS_DONE}"
678 678
679 # if we haven't determined the version yet, we need to 679 # if we haven't determined the version yet, we need to
680 linux-info_get_any_version 680 linux-info_get_any_version
681 681
682 # Determine if we really need a .config. The only time when we don't need 682 # Determine if we really need a .config. The only time when we don't need
683 # one is when all of the CONFIG_CHECK options are prefixed with "~". 683 # one is when all of the CONFIG_CHECK options are prefixed with "~".
684 for config in ${CONFIG_CHECK} 684 for config in ${CONFIG_CHECK}; do
685 do
686 if [[ "${config:0:1}" != "~" ]]; then 685 if [[ "${config:0:1}" != "~" ]]; then
687 config_required=1 686 config_required=1
688 break 687 break
689 fi 688 fi
690 done 689 done

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

  ViewVC Help
Powered by ViewVC 1.1.20