/[gentoo-x86]/eclass/linux-info.eclass
Gentoo

Contents of /eclass/linux-info.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.90 - (hide annotations) (download)
Mon Aug 22 04:46:32 2011 UTC (3 years, 4 months ago) by vapier
Branch: MAIN
Changes since 1.89: +6 -8 lines
fix random bugs in eclass documentation, and convert to new @AUTHOR tag

1 vapier 1.90 # Copyright 1999-2011 Gentoo Foundation
2 johnm 1.1 # Distributed under the terms of the GNU General Public License v2
3 vapier 1.90 # $Header: /var/cvsroot/gentoo-x86/eclass/linux-info.eclass,v 1.89 2011/08/18 14:58:57 vapier Exp $
4 johnm 1.10
5 dsd 1.56 # @ECLASS: linux-info.eclass
6     # @MAINTAINER:
7     # kernel-misc@gentoo.org
8 vapier 1.90 # @AUTHOR:
9     # Original author: John Mylchreest <johnm@gentoo.org>
10 dsd 1.56 # @BLURB: eclass used for accessing kernel related information
11     # @DESCRIPTION:
12     # This eclass is used as a central eclass for accessing kernel
13 robbat2 1.62 # related information for source or binary already installed.
14 dsd 1.56 # It is vital for linux-mod.eclass to function correctly, and is split
15     # out so that any ebuild behaviour "templates" are abstracted out
16     # using additional eclasses.
17 robbat2 1.62 #
18     # "kernel config" in this file means:
19     # The .config of the currently installed sources is used as the first
20     # preference, with a fall-back to bundled config (/proc/config.gz) if available.
21 dsd 1.56
22 johnm 1.10 # A Couple of env vars are available to effect usage of this eclass
23     # These are as follows:
24 dsd 1.56
25     # @ECLASS-VARIABLE: KERNEL_DIR
26     # @DESCRIPTION:
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:
32     # A string containing a list of .config options to check for before
33     # proceeding with the install.
34     #
35     # e.g.: CONFIG_CHECK="MTRR"
36     #
37     # You can also check that an option doesn't exist by
38     # prepending it with an exclamation mark (!).
39     #
40     # e.g.: CONFIG_CHECK="!MTRR"
41     #
42 vapier 1.89 # To simply warn about a missing option, prepend a '~'.
43 robbat2 1.62 # 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 dsd 1.56
52     # @ECLASS-VARIABLE: ERROR_<CFG>
53     # @DESCRIPTION:
54     # A string containing the error message to display when the check against CONFIG_CHECK
55     # fails. <CFG> should reference the appropriate option used in CONFIG_CHECK.
56 swegener 1.29 #
57 dsd 1.56 # e.g.: ERROR_MTRR="MTRR exists in the .config but shouldn't!!"
58    
59     # @ECLASS-VARIABLE: KBUILD_OUTPUT
60     # @DESCRIPTION:
61     # A string passed on commandline, or set from the kernel makefile. It contains the directory
62     # which is to be used as the kernel object directory.
63 johnm 1.10
64     # There are also a couple of variables which are set by this, and shouldn't be
65     # set by hand. These are as follows:
66 dsd 1.56
67     # @ECLASS-VARIABLE: KV_FULL
68     # @DESCRIPTION:
69     # A read-only variable. It's a string containing the full kernel version. ie: 2.6.9-gentoo-johnm-r1
70    
71     # @ECLASS-VARIABLE: KV_MAJOR
72     # @DESCRIPTION:
73     # A read-only variable. It's an integer containing the kernel major version. ie: 2
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
94     # KERNEL_DIR is invalid.
95    
96     # @ECLASS-VARIABLE: KV_OUT_DIR
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.
100 johnm 1.10
101 johnm 1.21 # And to ensure all the weirdness with crosscompile
102 johnm 1.23 inherit toolchain-funcs versionator
103 johnm 1.1
104 johnm 1.8 EXPORT_FUNCTIONS pkg_setup
105 johnm 1.1
106 robbat2 1.65 DEPEND=""
107     RDEPEND=""
108    
109 johnm 1.1 # Overwritable environment Var's
110     # ---------------------------------------
111 johnm 1.21 KERNEL_DIR="${KERNEL_DIR:-${ROOT}usr/src/linux}"
112 johnm 1.1
113 johnm 1.7
114 johnm 1.16 # Bug fixes
115     # fix to bug #75034
116     case ${ARCH} in
117 swegener 1.29 ppc) BUILD_FIXES="${BUILD_FIXES} TOUT=${T}/.tmp_gas_check";;
118     ppc64) BUILD_FIXES="${BUILD_FIXES} TOUT=${T}/.tmp_gas_check";;
119 johnm 1.16 esac
120    
121 vapier 1.51 # @FUNCTION: set_arch_to_kernel
122     # @DESCRIPTION:
123     # Set the env ARCH to match what the kernel expects.
124     set_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.
128     set_arch_to_portage() { export ARCH=$(tc-arch); }
129 johnm 1.11
130     # qeinfo "Message"
131     # -------------------
132 johnm 1.21 # qeinfo is a quiet einfo call when EBUILD_PHASE
133 johnm 1.11 # should not have visible output.
134 johnm 1.21 qout() {
135     local outputmsg type
136     type=${1}
137     shift
138     outputmsg="${@}"
139 wolf31o2 1.26 case "${EBUILD_PHASE}" in
140     depend) unset outputmsg;;
141     clean) unset outputmsg;;
142     preinst) unset outputmsg;;
143     esac
144     [ -n "${outputmsg}" ] && ${type} "${outputmsg}"
145 johnm 1.11 }
146    
147 johnm 1.21 qeinfo() { qout einfo "${@}" ; }
148 robbat2 1.82 qewarn() { qout ewarn "${@}" ; }
149 johnm 1.21 qeerror() { qout eerror "${@}" ; }
150 johnm 1.11
151 johnm 1.1 # File Functions
152     # ---------------------------------------
153    
154 dsd 1.56 # @FUNCTION: getfilevar
155     # @USAGE: variable configfile
156     # @RETURN: the value of the variable
157     # @DESCRIPTION:
158 robbat2 1.61 # 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!
161 johnm 1.1 getfilevar() {
162 dsd 1.57 local ERROR basefname basedname myARCH="${ARCH}"
163 johnm 1.1 ERROR=0
164 johnm 1.16
165 johnm 1.1 [ -z "${1}" ] && ERROR=1
166     [ ! -f "${2}" ] && ERROR=1
167    
168     if [ "${ERROR}" = 1 ]
169     then
170 johnm 1.6 echo -e "\n"
171 johnm 1.1 eerror "getfilevar requires 2 variables, with the second a valid file."
172     eerror " getfilevar <VARIABLE> <CONFIGFILE>"
173     else
174 johnm 1.34 basefname="$(basename ${2})"
175     basedname="$(dirname ${2})"
176 johnm 1.6 unset ARCH
177 johnm 1.21
178 johnm 1.42 echo -e "e:\\n\\t@echo \$(${1})\\ninclude ${basefname}" | \
179 dsd 1.57 make -C "${basedname}" M="${S}" ${BUILD_FIXES} -s -f - 2>/dev/null
180 johnm 1.21
181     ARCH=${myARCH}
182 johnm 1.1 fi
183     }
184    
185 robbat2 1.61 # @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.
192     getfilevar_noexec() {
193 robbat2 1.62 local ERROR basefname basedname mycat myARCH="${ARCH}"
194 robbat2 1.61 ERROR=0
195 robbat2 1.62 mycat='cat'
196 robbat2 1.61
197     [ -z "${1}" ] && ERROR=1
198     [ ! -f "${2}" ] && ERROR=1
199 robbat2 1.64 [ "${2%.gz}" != "${2}" ] && mycat='zcat'
200 robbat2 1.61
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 robbat2 1.62 ${mycat} "${2}" | \
208 robbat2 1.61 sed -n \
209 vapier 1.89 -e "/^[[:space:]]*${1}[[:space:]]*:\\?=[[:space:]]*\(.*\)\$/{
210 robbat2 1.61 s,^[^=]*[[:space:]]*=[[:space:]]*,,g ;
211     s,[[:space:]]*\$,,g ;
212     p
213 robbat2 1.62 }"
214 robbat2 1.61 fi
215     }
216    
217 vapier 1.90 # @ECLASS-VARIABLE: _LINUX_CONFIG_EXISTS_DONE
218     # @INTERNAL
219 robbat2 1.75 # @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    
226     linux_config_qa_check() {
227 robbat2 1.76 local f="$1"
228 robbat2 1.75 if [ -z "${_LINUX_CONFIG_EXISTS_DONE}" ]; then
229 robbat2 1.76 ewarn "QA: You called $f before any linux_config_exists!"
230 cardoe 1.87 ewarn "QA: The return value of $f will NOT guaranteed later!"
231 robbat2 1.75 fi
232     }
233 dsd 1.53
234 robbat2 1.62 # @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
238     linux_config_src_exists() {
239 robbat2 1.75 export _LINUX_CONFIG_EXISTS_DONE=1
240 robbat2 1.62 [ -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
247     linux_config_bin_exists() {
248 robbat2 1.75 export _LINUX_CONFIG_EXISTS_DONE=1
249 robbat2 1.79 [ -s "/proc/config.gz" ]
250 robbat2 1.62 }
251    
252 dsd 1.56 # @FUNCTION: linux_config_exists
253     # @RETURN: true or false
254     # @DESCRIPTION:
255     # It returns true if .config exists otherwise false
256 robbat2 1.62 #
257     # This function MUST be checked before using any of the linux_chkconfig_*
258     # functions.
259 dsd 1.53 linux_config_exists() {
260 robbat2 1.62 linux_config_src_exists || linux_config_bin_exists
261 dsd 1.53 }
262    
263 dsd 1.56 # @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.
267 dsd 1.53 require_configured_kernel() {
268 robbat2 1.62 if ! linux_config_src_exists; then
269 dsd 1.53 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 dsd 1.56 # @FUNCTION: linux_chkconfig_present
278     # @USAGE: option
279     # @RETURN: true or false
280     # @DESCRIPTION:
281 loki_val 1.59 # It checks that CONFIG_<option>=y or CONFIG_<option>=m is present in the current kernel .config
282 robbat2 1.62 # If linux_config_exists returns false, the results of this are UNDEFINED. You
283     # MUST call linux_config_exists first.
284 johnm 1.7 linux_chkconfig_present() {
285 robbat2 1.76 linux_config_qa_check linux_chkconfig_present
286 robbat2 1.75 local RESULT
287 robbat2 1.62 local config
288     config="${KV_OUT_DIR}/.config"
289     [ ! -f "${config}" ] && config="/proc/config.gz"
290     RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
291 johnm 1.1 [ "${RESULT}" = "m" -o "${RESULT}" = "y" ] && return 0 || return 1
292     }
293    
294 dsd 1.56 # @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 robbat2 1.62 # If linux_config_exists returns false, the results of this are UNDEFINED. You
300     # MUST call linux_config_exists first.
301 johnm 1.7 linux_chkconfig_module() {
302 robbat2 1.76 linux_config_qa_check linux_chkconfig_module
303 robbat2 1.75 local RESULT
304 robbat2 1.62 local config
305     config="${KV_OUT_DIR}/.config"
306     [ ! -f "${config}" ] && config="/proc/config.gz"
307     RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
308 johnm 1.1 [ "${RESULT}" = "m" ] && return 0 || return 1
309     }
310    
311 dsd 1.56 # @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 robbat2 1.62 # If linux_config_exists returns false, the results of this are UNDEFINED. You
317     # MUST call linux_config_exists first.
318 johnm 1.7 linux_chkconfig_builtin() {
319 robbat2 1.76 linux_config_qa_check linux_chkconfig_builtin
320 robbat2 1.75 local RESULT
321 robbat2 1.62 local config
322     config="${KV_OUT_DIR}/.config"
323     [ ! -f "${config}" ] && config="/proc/config.gz"
324     RESULT="$(getfilevar_noexec CONFIG_${1} "${config}")"
325 johnm 1.1 [ "${RESULT}" = "y" ] && return 0 || return 1
326     }
327    
328 dsd 1.56 # @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 robbat2 1.62 # If linux_config_exists returns false, the results of this are UNDEFINED. You
334     # MUST call linux_config_exists first.
335 johnm 1.7 linux_chkconfig_string() {
336 robbat2 1.76 linux_config_qa_check linux_chkconfig_string
337 robbat2 1.62 local config
338     config="${KV_OUT_DIR}/.config"
339     [ ! -f "${config}" ] && config="/proc/config.gz"
340     getfilevar_noexec "CONFIG_${1}" "${config}"
341 johnm 1.7 }
342    
343 johnm 1.1 # Versioning Functions
344     # ---------------------------------------
345    
346 dsd 1.56 # @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.
352 johnm 1.1 #
353 dsd 1.56 # @CODE
354 johnm 1.1 # For Example where KV = 2.6.9
355 dsd 1.56 # kernel_is 2 4 returns false
356     # kernel_is 2 returns true
357     # kernel_is 2 6 returns true
358     # kernel_is 2 6 8 returns false
359     # kernel_is 2 6 9 returns true
360     # @CODE
361    
362 johnm 1.1 # got the jist yet?
363    
364     kernel_is() {
365 dsd 1.53 # if we haven't determined the version yet, we need to.
366 robbat2 1.69 linux-info_get_any_version
367    
368 robbat2 1.80 local operator testagainst value x=0 y=0 z=0
369 johnm 1.23
370     case ${1} in
371 robbat2 1.68 -lt|lt) operator="-lt"; shift;;
372     -gt|gt) operator="-gt"; shift;;
373     -le|le) operator="-le"; shift;;
374     -ge|ge) operator="-ge"; shift;;
375     -eq|eq) operator="-eq"; shift;;
376     *) operator="-eq";;
377 johnm 1.23 esac
378    
379     for x in ${@}; do
380     for((y=0; y<$((3 - ${#x})); y++)); do value="${value}0"; done
381     value="${value}${x}"
382     z=$((${z} + 1))
383    
384     case ${z} in
385 robbat2 1.80 1) for((y=0; y<$((3 - ${#KV_MAJOR})); y++)); do testagainst="${testagainst}0"; done;
386     testagainst="${testagainst}${KV_MAJOR}";;
387     2) for((y=0; y<$((3 - ${#KV_MINOR})); y++)); do testagainst="${testagainst}0"; done;
388     testagainst="${testagainst}${KV_MINOR}";;
389     3) for((y=0; y<$((3 - ${#KV_PATCH})); y++)); do testagainst="${testagainst}0"; done;
390     testagainst="${testagainst}${KV_PATCH}";;
391 johnm 1.23 *) die "Error in kernel-2_kernel_is(): Too many parameters.";;
392     esac
393     done
394 maekke 1.73
395 robbat2 1.80 [ "${testagainst}" ${operator} "${value}" ] && return 0 || return 1
396 johnm 1.1 }
397    
398 johnm 1.30 get_localversion() {
399     local lv_list i x
400    
401     # ignore files with ~ in it.
402     for i in $(ls ${1}/localversion* 2>/dev/null); do
403     [[ -n ${i//*~*} ]] && lv_list="${lv_list} ${i}"
404     done
405    
406     for i in ${lv_list}; do
407     x="${x}$(<${i})"
408     done
409     x=${x/ /}
410     echo ${x}
411     }
412    
413 robbat2 1.83 # Check if the Makefile is valid for direct parsing.
414     # Check status results:
415     # - PASS, use 'getfilevar' to extract values
416     # - FAIL, use 'getfilevar_noexec' to extract values
417     # The check may fail if:
418     # - make is not present
419     # - corruption exists in the kernel makefile
420     get_makefile_extract_function() {
421     local a='' b='' mkfunc='getfilevar'
422     a="$(getfilevar VERSION ${KERNEL_MAKEFILE})"
423     b="$(getfilevar_noexec VERSION ${KERNEL_MAKEFILE})"
424     [[ "${a}" != "${b}" ]] && mkfunc='getfilevar_noexec'
425     echo "${mkfunc}"
426     }
427    
428 robbat2 1.63 # internal variable, so we know to only print the warning once
429     get_version_warning_done=
430    
431 dsd 1.56 # @FUNCTION: get_version
432     # @DESCRIPTION:
433     # It gets the version of the kernel inside KERNEL_DIR and populates the KV_FULL variable
434     # (if KV_FULL is already set it does nothing).
435     #
436     # The kernel version variables (KV_MAJOR, KV_MINOR, KV_PATCH, KV_EXTRA and KV_LOCAL) are also set.
437     #
438     # The KV_DIR is set using the KERNEL_DIR env var, the KV_DIR_OUT is set using a valid
439     # KBUILD_OUTPUT (in a decreasing priority list, we look for the env var, makefile var or the
440     # symlink /lib/modules/${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}/build).
441 johnm 1.1 get_version() {
442 robbat2 1.86 local kbuild_output mkfunc tmplocal
443 swegener 1.29
444 johnm 1.1 # no need to execute this twice assuming KV_FULL is populated.
445     # we can force by unsetting KV_FULL
446 johnm 1.19 [ -n "${KV_FULL}" ] && return 0
447 johnm 1.1
448     # if we dont know KV_FULL, then we need too.
449     # make sure KV_DIR isnt set since we need to work it out via KERNEL_DIR
450     unset KV_DIR
451    
452     # KV_DIR will contain the full path to the sources directory we should use
453 robbat2 1.63 [ -z "${get_version_warning_done}" ] && \
454 johnm 1.11 qeinfo "Determining the location of the kernel source code"
455 johnm 1.1 [ -h "${KERNEL_DIR}" ] && KV_DIR="$(readlink -f ${KERNEL_DIR})"
456     [ -d "${KERNEL_DIR}" ] && KV_DIR="${KERNEL_DIR}"
457 swegener 1.29
458 johnm 1.1 if [ -z "${KV_DIR}" ]
459     then
460 robbat2 1.63 if [ -z "${get_version_warning_done}" ]; then
461     get_version_warning_done=1
462     qeerror "Unable to find kernel sources at ${KERNEL_DIR}"
463     #qeinfo "This package requires Linux sources."
464     if [ "${KERNEL_DIR}" == "/usr/src/linux" ] ; then
465     qeinfo "Please make sure that ${KERNEL_DIR} points at your running kernel, "
466     qeinfo "(or the kernel you wish to build against)."
467     qeinfo "Alternatively, set the KERNEL_DIR environment variable to the kernel sources location"
468     else
469     qeinfo "Please ensure that the KERNEL_DIR environment variable points at full Linux sources of the kernel you wish to compile against."
470     fi
471 johnm 1.7 fi
472 johnm 1.19 return 1
473 johnm 1.7 fi
474    
475 robbat2 1.63 if [ -z "${get_version_warning_done}" ]; then
476     qeinfo "Found kernel source directory:"
477     qeinfo " ${KV_DIR}"
478     fi
479 johnm 1.7
480     if [ ! -s "${KV_DIR}/Makefile" ]
481     then
482 robbat2 1.63 if [ -z "${get_version_warning_done}" ]; then
483     get_version_warning_done=1
484     qeerror "Could not find a Makefile in the kernel source directory."
485     qeerror "Please ensure that ${KERNEL_DIR} points to a complete set of Linux sources"
486     fi
487 johnm 1.19 return 1
488 johnm 1.7 fi
489 swegener 1.29
490 johnm 1.4 # OK so now we know our sources directory, but they might be using
491     # KBUILD_OUTPUT, and we need this for .config and localversions-*
492     # so we better find it eh?
493     # do we pass KBUILD_OUTPUT on the CLI?
494     OUTPUT_DIR="${OUTPUT_DIR:-${KBUILD_OUTPUT}}"
495 swegener 1.29
496 robbat2 1.78 # keep track of it
497     KERNEL_MAKEFILE="${KV_DIR}/Makefile"
498 vapier 1.89
499 robbat2 1.83 # Decide the function used to extract makefile variables.
500     mkfunc="$(get_makefile_extract_function "${KERNEL_MAKEFILE}")"
501 robbat2 1.78
502 johnm 1.6 # And if we didn't pass it, we can take a nosey in the Makefile
503 robbat2 1.78 kbuild_output="$(${mkfunc} KBUILD_OUTPUT ${KERNEL_MAKEFILE})"
504 johnm 1.4 OUTPUT_DIR="${OUTPUT_DIR:-${kbuild_output}}"
505 swegener 1.29
506 johnm 1.1 # And contrary to existing functions I feel we shouldn't trust the
507     # directory name to find version information as this seems insane.
508 robbat2 1.78 # so we parse ${KERNEL_MAKEFILE}
509     KV_MAJOR="$(${mkfunc} VERSION ${KERNEL_MAKEFILE})"
510     KV_MINOR="$(${mkfunc} PATCHLEVEL ${KERNEL_MAKEFILE})"
511     KV_PATCH="$(${mkfunc} SUBLEVEL ${KERNEL_MAKEFILE})"
512     KV_EXTRA="$(${mkfunc} EXTRAVERSION ${KERNEL_MAKEFILE})"
513 swegener 1.29
514 johnm 1.7 if [ -z "${KV_MAJOR}" -o -z "${KV_MINOR}" -o -z "${KV_PATCH}" ]
515     then
516 robbat2 1.63 if [ -z "${get_version_warning_done}" ]; then
517     get_version_warning_done=1
518     qeerror "Could not detect kernel version."
519     qeerror "Please ensure that ${KERNEL_DIR} points to a complete set of Linux sources."
520     fi
521 johnm 1.19 return 1
522 johnm 1.7 fi
523 swegener 1.29
524 johnm 1.1 # and in newer versions we can also pull LOCALVERSION if it is set.
525 johnm 1.4 # but before we do this, we need to find if we use a different object directory.
526     # This *WILL* break if the user is using localversions, but we assume it was
527     # caught before this if they are.
528 robbat2 1.81 OUTPUT_DIR="${OUTPUT_DIR:-/lib/modules/${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}/build}"
529 johnm 1.4
530     [ -h "${OUTPUT_DIR}" ] && KV_OUT_DIR="$(readlink -f ${OUTPUT_DIR})"
531     [ -d "${OUTPUT_DIR}" ] && KV_OUT_DIR="${OUTPUT_DIR}"
532     if [ -n "${KV_OUT_DIR}" ];
533     then
534 johnm 1.11 qeinfo "Found kernel object directory:"
535     qeinfo " ${KV_OUT_DIR}"
536 johnm 1.4 fi
537 johnm 1.41 # and if we STILL have not got it, then we better just set it to KV_DIR
538 johnm 1.4 KV_OUT_DIR="${KV_OUT_DIR:-${KV_DIR}}"
539 johnm 1.21
540 robbat2 1.86 # Grab the kernel release from the output directory.
541     # TODO: we MUST detect kernel.release being out of date, and 'return 1' from
542     # this function.
543     if [ -s "${KV_OUT_DIR}"/include/config/kernel.release ]; then
544     KV_LOCAL=$(<"${KV_OUT_DIR}"/include/config/kernel.release)
545     elif [ -s "${KV_OUT_DIR}"/.kernelrelease ]; then
546     KV_LOCAL=$(<"${KV_OUT_DIR}"/.kernelrelease)
547     else
548     KV_LOCAL=
549     fi
550 robbat2 1.85
551 robbat2 1.86 # KV_LOCAL currently contains the full release; discard the first bits.
552     tmplocal=${KV_LOCAL#${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}}
553 dsd 1.53
554 robbat2 1.86 # If the updated local version was not changed, the tree is not prepared.
555     # Clear out KV_LOCAL in that case.
556     # TODO: this does not detect a change in the localversion part between
557     # kernel.release and the value that would be generated.
558     if [ "$KV_LOCAL" = "$tmplocal" ]; then
559     KV_LOCAL=
560 robbat2 1.85 else
561 robbat2 1.86 KV_LOCAL=$tmplocal
562 johnm 1.41 fi
563    
564 johnm 1.1 # And we should set KV_FULL to the full expanded version
565     KV_FULL="${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}${KV_EXTRA}${KV_LOCAL}"
566 johnm 1.21
567 johnm 1.11 qeinfo "Found sources for kernel version:"
568     qeinfo " ${KV_FULL}"
569 johnm 1.21
570 johnm 1.19 return 0
571 johnm 1.1 }
572    
573 dsd 1.56 # @FUNCTION: get_running_version
574     # @DESCRIPTION:
575     # It gets the version of the current running kernel and the result is the same as get_version() if the
576     # function can find the sources.
577 johnm 1.23 get_running_version() {
578     KV_FULL=$(uname -r)
579 johnm 1.1
580 abcd 1.84 if [[ -f ${ROOT}/lib/modules/${KV_FULL}/source/Makefile && -f ${ROOT}/lib/modules/${KV_FULL}/build/Makefile ]]; then
581     KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/source)
582     KBUILD_OUTPUT=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/build)
583     unset KV_FULL
584     get_version
585     return $?
586     elif [[ -f ${ROOT}/lib/modules/${KV_FULL}/source/Makefile ]]; then
587 johnm 1.23 KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/source)
588     unset KV_FULL
589     get_version
590     return $?
591     elif [[ -f ${ROOT}/lib/modules/${KV_FULL}/build/Makefile ]]; then
592     KERNEL_DIR=$(readlink -f ${ROOT}/lib/modules/${KV_FULL}/build)
593     unset KV_FULL
594     get_version
595     return $?
596     else
597     KV_MAJOR=$(get_version_component_range 1 ${KV_FULL})
598     KV_MINOR=$(get_version_component_range 2 ${KV_FULL})
599 flameeyes 1.88 KV_PATCH=$(get_version_component_range 3 ${KV_FULL})
600 johnm 1.23 KV_PATCH=${KV_PATCH//-*}
601 flameeyes 1.88 KV_EXTRA="${KV_FULL#${KV_MAJOR}.${KV_MINOR}.${KV_PATCH}}"
602 johnm 1.23 fi
603     return 0
604     }
605 johnm 1.1
606 robbat2 1.66 # This next function is named with the eclass prefix to avoid conflicts with
607     # some old versionator-like eclass functions.
608    
609     # @FUNCTION: linux-info_get_any_version
610     # @DESCRIPTION:
611     # This attempts to find the version of the sources, and otherwise falls back to
612     # the version of the running kernel.
613     linux-info_get_any_version() {
614 maekke 1.73 get_version
615 robbat2 1.67 if [[ $? -ne 0 ]]; then
616 robbat2 1.66 ewarn "Unable to calculate Linux Kernel version for build, attempting to use running version"
617 maekke 1.73 get_running_version
618 robbat2 1.66 fi
619     }
620    
621 johnm 1.1
622     # ebuild check functions
623     # ---------------------------------------
624    
625 dsd 1.56 # @FUNCTION: check_kernel_built
626     # @DESCRIPTION:
627     # This function verifies that the current kernel sources have been already prepared otherwise it dies.
628 johnm 1.1 check_kernel_built() {
629 dsd 1.53 # if we haven't determined the version yet, we need to
630 dsd 1.54 require_configured_kernel
631 dsd 1.53 get_version
632 swegener 1.29
633 johnm 1.16 if [ ! -f "${KV_OUT_DIR}/include/linux/version.h" ]
634 johnm 1.1 then
635 johnm 1.16 eerror "These sources have not yet been prepared."
636     eerror "We cannot build against an unprepared tree."
637 johnm 1.1 eerror "To resolve this, please type the following:"
638     eerror
639     eerror "# cd ${KV_DIR}"
640     eerror "# make oldconfig"
641 johnm 1.16 eerror "# make modules_prepare"
642 johnm 1.1 eerror
643     eerror "Then please try merging this module again."
644     die "Kernel sources need compiling first"
645     fi
646     }
647    
648 dsd 1.56 # @FUNCTION: check_modules_supported
649     # @DESCRIPTION:
650     # This function verifies that the current kernel support modules (it checks CONFIG_MODULES=y) otherwise it dies.
651 johnm 1.1 check_modules_supported() {
652     # if we haven't determined the version yet, we need too.
653 dsd 1.53 require_configured_kernel
654     get_version
655 swegener 1.29
656 johnm 1.7 if ! linux_chkconfig_builtin "MODULES"
657 johnm 1.1 then
658     eerror "These sources do not support loading external modules."
659     eerror "to be able to use this module please enable \"Loadable modules support\""
660     eerror "in your kernel, recompile and then try merging this module again."
661 johnm 1.7 die "No support for external modules in ${KV_FULL} config"
662 johnm 1.3 fi
663     }
664    
665 dsd 1.56 # @FUNCTION: check_extra_config
666     # @DESCRIPTION:
667     # It checks the kernel config options specified by CONFIG_CHECK. It dies only when a required config option (i.e.
668     # the prefix ~ is not used) doesn't satisfy the directive.
669 johnm 1.3 check_extra_config() {
670 mrness 1.45 local config negate die error reworkmodulenames
671 dsd 1.53 local soft_errors_count=0 hard_errors_count=0 config_required=0
672 robbat2 1.75 # store the value of the QA check, because otherwise we won't catch usages
673     # after if check_extra_config is called AND other direct calls are done
674     # later.
675     local old_LINUX_CONFIG_EXISTS_DONE="${_LINUX_CONFIG_EXISTS_DONE}"
676 dsd 1.53
677 dsd 1.55 # if we haven't determined the version yet, we need to
678 robbat2 1.70 linux-info_get_any_version
679 dsd 1.55
680 dsd 1.53 # Determine if we really need a .config. The only time when we don't need
681     # one is when all of the CONFIG_CHECK options are prefixed with "~".
682     for config in ${CONFIG_CHECK}
683     do
684     if [[ "${config:0:1}" != "~" ]]; then
685     config_required=1
686     break
687     fi
688     done
689    
690     if [[ ${config_required} == 0 ]]; then
691     # In the case where we don't require a .config, we can now bail out
692     # if the user has no .config as there is nothing to do. Otherwise
693     # code later will cause a failure due to missing .config.
694 robbat2 1.79 if ! linux_config_exists; then
695 robbat2 1.60 ewarn "Unable to check for the following kernel config options due"
696 robbat2 1.64 ewarn "to absence of any configured kernel sources or compiled"
697     ewarn "config:"
698 robbat2 1.60 for config in ${CONFIG_CHECK}; do
699 robbat2 1.77 local_error="ERROR_${config#\~}"
700     msg="${!local_error}"
701     if [[ "x${msg}" == "x" ]]; then
702     local_error="WARNING_${config#\~}"
703     msg="${!local_error}"
704     fi
705     ewarn " - ${config#\~}${msg:+ - }${msg}"
706 robbat2 1.60 done
707     ewarn "You're on your own to make sure they are set if needed."
708 robbat2 1.75 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
709 dsd 1.53 return 0
710     fi
711     else
712 robbat2 1.79 require_configured_kernel
713 dsd 1.53 fi
714 johnm 1.3
715 mrness 1.45 einfo "Checking for suitable kernel configuration options..."
716 maekke 1.58
717 johnm 1.3 for config in ${CONFIG_CHECK}
718     do
719 johnm 1.31 # if we specify any fatal, ensure we honor them
720     die=1
721     error=0
722     negate=0
723     reworkmodulenames=0
724    
725 dsd 1.53 if [[ ${config:0:1} == "~" ]]; then
726 mrness 1.45 die=0
727 johnm 1.31 config=${config:1}
728 dsd 1.53 elif [[ ${config:0:1} == "@" ]]; then
729 mrness 1.45 die=0
730 johnm 1.31 reworkmodulenames=1
731     config=${config:1}
732     fi
733 dsd 1.53 if [[ ${config:0:1} == "!" ]]; then
734 mrness 1.45 negate=1
735 johnm 1.44 config=${config:1}
736     fi
737 johnm 1.17
738 johnm 1.31 if [[ ${negate} == 1 ]]; then
739     linux_chkconfig_present ${config} && error=2
740     elif [[ ${reworkmodulenames} == 1 ]]; then
741 mrness 1.45 local temp_config="${config//*:}" i n
742 johnm 1.17 config="${config//:*}"
743 johnm 1.31 if linux_chkconfig_present ${config}; then
744     for i in ${MODULE_NAMES}; do
745 johnm 1.17 n="${i//${temp_config}}"
746 dsd 1.38 [[ -z ${n//\(*} ]] && \
747 johnm 1.31 MODULE_IGNORE="${MODULE_IGNORE} ${temp_config}"
748 johnm 1.17 done
749 johnm 1.31 error=2
750 johnm 1.17 fi
751 johnm 1.3 else
752 johnm 1.31 linux_chkconfig_present ${config} || error=1
753     fi
754    
755 mrness 1.45 if [[ ${error} > 0 ]]; then
756     local report_func="eerror" local_error
757     local_error="ERROR_${config}"
758     local_error="${!local_error}"
759    
760     if [[ -z "${local_error}" ]]; then
761     # using old, deprecated format.
762     local_error="${config}_ERROR"
763     local_error="${!local_error}"
764     fi
765     if [[ ${die} == 0 && -z "${local_error}" ]]; then
766     #soft errors can be warnings
767     local_error="WARNING_${config}"
768 johnm 1.7 local_error="${!local_error}"
769 mrness 1.45 if [[ -n "${local_error}" ]] ; then
770     report_func="ewarn"
771 johnm 1.44 fi
772 mrness 1.45 fi
773 johnm 1.44
774 mrness 1.45 if [[ -z "${local_error}" ]]; then
775     [[ ${error} == 1 ]] \
776     && local_error="is not set when it should be." \
777     || local_error="should not be set. But it is."
778     local_error="CONFIG_${config}:\t ${local_error}"
779     fi
780     if [[ ${die} == 0 ]]; then
781     ${report_func} " ${local_error}"
782     soft_errors_count=$[soft_errors_count + 1]
783     else
784     ${report_func} " ${local_error}"
785     hard_errors_count=$[hard_errors_count + 1]
786 johnm 1.3 fi
787     fi
788     done
789    
790 mrness 1.45 if [[ ${hard_errors_count} > 0 ]]; then
791 johnm 1.3 eerror "Please check to make sure these options are set correctly."
792 johnm 1.31 eerror "Failure to do so may cause unexpected problems."
793 mrness 1.45 eerror "Once you have satisfied these options, please try merging"
794     eerror "this package again."
795 robbat2 1.75 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
796 mrness 1.45 die "Incorrect kernel configuration options"
797     elif [[ ${soft_errors_count} > 0 ]]; then
798     ewarn "Please check to make sure these options are set correctly."
799     ewarn "Failure to do so may cause unexpected problems."
800     else
801     eend 0
802 johnm 1.1 fi
803 robbat2 1.75 export LINUX_CONFIG_EXISTS_DONE="${old_LINUX_CONFIG_EXISTS_DONE}"
804 johnm 1.1 }
805    
806     check_zlibinflate() {
807 dsd 1.53 # if we haven't determined the version yet, we need to
808     require_configured_kernel
809     get_version
810 swegener 1.29
811 johnm 1.1 # although I restructured this code - I really really really dont support it!
812    
813     # bug #27882 - zlib routines are only linked into the kernel
814     # if something compiled into the kernel calls them
815     #
816     # plus, for the cloop module, it appears that there's no way
817     # to get cloop.o to include a static zlib if CONFIG_MODVERSIONS
818     # is on
819 swegener 1.29
820     local INFLATE
821     local DEFLATE
822 johnm 1.1
823     einfo "Determining the usability of ZLIB_INFLATE support in your kernel"
824 swegener 1.29
825 johnm 1.1 ebegin "checking ZLIB_INFLATE"
826 robbat2 1.61 linux_chkconfig_builtin CONFIG_ZLIB_INFLATE
827 johnm 1.1 eend $?
828     [ "$?" != 0 ] && die
829 swegener 1.29
830 johnm 1.1 ebegin "checking ZLIB_DEFLATE"
831 robbat2 1.61 linux_chkconfig_builtin CONFIG_ZLIB_DEFLATE
832 johnm 1.1 eend $?
833     [ "$?" != 0 ] && die
834 swegener 1.29
835 johnm 1.1 local LINENO_START
836     local LINENO_END
837     local SYMBOLS
838     local x
839 swegener 1.29
840 johnm 1.1 LINENO_END="$(grep -n 'CONFIG_ZLIB_INFLATE y' ${KV_DIR}/lib/Config.in | cut -d : -f 1)"
841     LINENO_START="$(head -n $LINENO_END ${KV_DIR}/lib/Config.in | grep -n 'if \[' | tail -n 1 | cut -d : -f 1)"
842     (( LINENO_AMOUNT = $LINENO_END - $LINENO_START ))
843     (( LINENO_END = $LINENO_END - 1 ))
844 johnm 1.4 SYMBOLS="$(head -n $LINENO_END ${KV_DIR}/lib/Config.in | tail -n $LINENO_AMOUNT | sed -e 's/^.*\(CONFIG_[^\" ]*\).*/\1/g;')"
845 johnm 1.1
846     # okay, now we have a list of symbols
847     # we need to check each one in turn, to see whether it is set or not
848     for x in $SYMBOLS ; do
849     if [ "${!x}" = "y" ]; then
850     # we have a winner!
851     einfo "${x} ensures zlib is linked into your kernel - excellent"
852     return 0
853     fi
854     done
855 swegener 1.29
856 johnm 1.1 eerror
857     eerror "This kernel module requires ZLIB library support."
858     eerror "You have enabled zlib support in your kernel, but haven't enabled"
859     eerror "enabled any option that will ensure that zlib is linked into your"
860     eerror "kernel."
861     eerror
862     eerror "Please ensure that you enable at least one of these options:"
863     eerror
864    
865     for x in $SYMBOLS ; do
866     eerror " * $x"
867     done
868    
869     eerror
870     eerror "Please remember to recompile and install your kernel, and reboot"
871     eerror "into your new kernel before attempting to load this kernel module."
872    
873     die "Kernel doesn't include zlib support"
874     }
875 johnm 1.8
876     ################################
877     # Default pkg_setup
878     # Also used when inheriting linux-mod to force a get_version call
879 dsd 1.56 # @FUNCTION: linux-info_pkg_setup
880     # @DESCRIPTION:
881     # Force a get_version() call when inherited from linux-mod.eclass and then check if the kernel is configured
882     # to support the options specified in CONFIG_CHECK (if not null)
883 johnm 1.8 linux-info_pkg_setup() {
884 robbat2 1.66 linux-info_get_any_version
885 phreak 1.48
886     if kernel_is 2 4; then
887     if [ "$( gcc-major-version )" -eq "4" ] ; then
888     echo
889     ewarn "Be warned !! >=sys-devel/gcc-4.0.0 isn't supported with"
890     ewarn "linux-2.4 (or modules building against a linux-2.4 kernel)!"
891     echo
892     ewarn "Either switch to another gcc-version (via gcc-config) or use a"
893     ewarn "newer kernel that supports gcc-4."
894     echo
895     ewarn "Also be aware that bugreports about gcc-4 not working"
896     ewarn "with linux-2.4 based ebuilds will be closed as INVALID!"
897     echo
898     epause 10
899     fi
900     fi
901    
902 johnm 1.10 [ -n "${CONFIG_CHECK}" ] && check_extra_config;
903 johnm 1.8 }

  ViewVC Help
Powered by ViewVC 1.1.20