# Distributed under the terms of the GNU General Public License v2
# @ECLASS: kernel-2.eclass
-# @MAINTAINER:
+# @MAINTAINER:
# Gentoo Kernel project <kernel@gentoo.org>
-# @AUTHOR:
+# @AUTHOR:
# John Mylchreest <johnm@gentoo.org>
# Mike Pagano <mpagano@gentoo.org>
# <so many, many others, please add yourself>
# this is useful for things like wolk. IE:
# EXTRAVERSION would be something like : -wolk-4.19-r1
-# @ECLASS-VARIABLE: K_NOSETEXTRAVERSION
+# @ECLASS-VARIABLE: K_NOSETEXTRAVERSION
# @DEFAULT_UNSET
# @DESCRIPTION:
# if this is set then EXTRAVERSION will not be
# automatically set within the kernel Makefile
-# @ECLASS-VARIABLE: K_NOUSENAME
+# @ECLASS-VARIABLE: K_NOUSENAME
# @DEFAULT_UNSET
# @DESCRIPTION:
# if this is set then EXTRAVERSION will not include the
# first part of ${PN} in EXTRAVERSION
-# @ECLASS-VARIABLE: K_NOUSEPR
+# @ECLASS-VARIABLE: K_NOUSEPR
# @DEFAULT_UNSET
# @DESCRIPTION:
# if this is set then EXTRAVERSION will not include the
# anything based on ${PR}.
-# @ECLASS-VARIABLE: K_PREPATCHED
+# @ECLASS-VARIABLE: K_PREPATCHED
# @DEFAULT_UNSET
# @DESCRIPTION:
# if the patchset is prepatched (ie: mm-sources,
# the patchset version for
# and not use it as a true package revision
-# @ECLASS-VARIABLE: K_EXTRAEINFO
+# @ECLASS-VARIABLE: K_EXTRAEINFO
# @DEFAULT_UNSET
# @DESCRIPTION:
# this is a new-line seperated list of einfo displays in
# postinst and can be used to carry additional postinst
# messages
-# @ECLASS-VARIABLE: K_EXTRAELOG
+# @ECLASS-VARIABLE: K_EXTRAELOG
# @DEFAULT_UNSET
# @DESCRIPTION:
# same as K_EXTRAEINFO except using elog instead of einfo
-# @ECLASS-VARIABLE: K_EXTRAEWARN
+# @ECLASS-VARIABLE: K_EXTRAEWARN
# @DEFAULT_UNSET
# @DESCRIPTION:
# same as K_EXTRAEINFO except using ewarn instead of einfo
-# @ECLASS-VARIABLE: K_SYMLINK
+# @ECLASS-VARIABLE: K_SYMLINK
# @DEFAULT_UNSET
# @DESCRIPTION:
# if this is set, then forcably create symlink anyway
-# @ECLASS-VARIABLE: K_BASE_VER
+# @ECLASS-VARIABLE: K_BASE_VER
# @DEFAULT_UNSET
# @DESCRIPTION:
# for git-sources, declare the base version this patch is
# based off of.
-# @ECLASS-VARIABLE: K_DEFCONFIG
+# @ECLASS-VARIABLE: K_DEFCONFIG
# @DEFAULT_UNSET
# @DESCRIPTION:
# Allow specifying a different defconfig target.
# If length zero, defaults to "defconfig".
-# @ECLASS-VARIABLE: K_WANT_GENPATCHES
+# @ECLASS-VARIABLE: K_WANT_GENPATCHES
# @DEFAULT_UNSET
# @DESCRIPTION:
# Apply genpatches to kernel source. Provide any
# combination of "base", "extras" or "experimental".
-# @ECLASS-VARIABLE: K_EXP_GENPATCHES_PULL
+# @ECLASS-VARIABLE: K_EXP_GENPATCHES_PULL
# @DEFAULT_UNSET
# @DESCRIPTION:
# If set, we pull "experimental" regardless of the USE FLAG
# but expect the ebuild maintainer to use K_EXP_GENPATCHES_LIST.
-# @ECLASS-VARIABLE: K_EXP_GENPATCHES_NOUSE
+# @ECLASS-VARIABLE: K_EXP_GENPATCHES_NOUSE
# @DEFAULT_UNSET
# @DESCRIPTION:
# If set, no USE flag will be provided for "experimental";
# as a result the user cannot choose to apply those patches.
-# @ECLASS-VARIABLE: K_EXP_GENPATCHES_LIST
+# @ECLASS-VARIABLE: K_EXP_GENPATCHES_LIST
# @DEFAULT_UNSET
# @DESCRIPTION:
# A list of patches to pick from "experimental" to apply when
# the USE flag is unset and K_EXP_GENPATCHES_PULL is set.
-# @ECLASS-VARIABLE: K_FROM_GIT
+# @ECLASS-VARIABLE: K_FROM_GIT
# @DEFAULT_UNSET
# @DESCRIPTION:
-# If set, this variable signals that the kernel sources derives
-# from a git tree and special handling will be applied so that
+# If set, this variable signals that the kernel sources derives
+# from a git tree and special handling will be applied so that
# any patches that are applied will actually apply.
-# @ECLASS-VARIABLE: K_GENPATCHES_VER
+# @ECLASS-VARIABLE: K_GENPATCHES_VER
# @DEFAULT_UNSET
# @DESCRIPTION:
# The version of the genpatches tarball(s) to apply.
# If set, this kernel is unsupported by Gentoo Security
# to the current eclass maintainer :)
-# @ECLASS-VARIABLE: K_DEBLOB_AVAILABLE
+# @ECLASS-VARIABLE: K_DEBLOB_AVAILABLE
# @DEFAULT_UNSET
# @DESCRIPTION:
# A value of "0" will disable all of the optional deblob
# code. If empty, will be set to "1" if deblobbing is
# possible. Test ONLY for "1".
-# @ECLASS-VARIABLE: K_DEBLOB_TAG
+# @ECLASS-VARIABLE: K_DEBLOB_TAG
# @DEFAULT_UNSET
# @DESCRIPTION:
# This will be the version of deblob script. It's a upstream SVN tag
# such asw -gnu or -gnu1.
-# @ECLASS-VARIABLE: K_PREDEBLOBBED
+# @ECLASS-VARIABLE: K_PREDEBLOBBED
# @DEFAULT_UNSET
# @DESCRIPTION:
# This kernel was already deblobbed elsewhere.
# If false, either optional deblobbing will be available
# or the license will note the inclusion of freedist code.
-# @ECLASS-VARIABLE: K_LONGTERM
+# @ECLASS-VARIABLE: K_LONGTERM
# @DEFAULT_UNSET
# @DESCRIPTION:
# If set, the eclass will search for the kernel source
# in the long term directories on the upstream servers
# as the location has been changed by upstream
-# @ECLASS-VARIABLE: H_SUPPORTEDARCH
+# @ECLASS-VARIABLE: H_SUPPORTEDARCH
# @DEFAULT_UNSET
# @DESCRIPTION:
# this should be a space separated list of ARCH's which
# can be supported by the headers ebuild
-# @ECLASS-VARIABLE: UNIPATCH_LIST
+# @ECLASS-VARIABLE: UNIPATCH_LIST
# @DEFAULT_UNSET
# @DESCRIPTION:
# space delimetered list of patches to be applied to the kernel
-# @ECLASS-VARIABLE: UNIPATCH_EXCLUDE
+# @ECLASS-VARIABLE: UNIPATCH_EXCLUDE
# @DEFAULT_UNSET
# @DESCRIPTION:
# An addition var to support exlusion based completely
# this should _NOT_ be used from the ebuild as this is
# reserved for end users passing excludes from the cli
-# @ECLASS-VARIABLE: UNIPATCH_DOCS
+# @ECLASS-VARIABLE: UNIPATCH_DOCS
# @DEFAULT_UNSET
# @DESCRIPTION:
# space delimemeted list of docs to be installed to
# the doc dir
-# @ECLASS-VARIABLE: UNIPATCH_STRICTORDER
+# @ECLASS-VARIABLE: UNIPATCH_STRICTORDER
# @DEFAULT_UNSET
# @DESCRIPTION:
# if this is set places patches into directories of
# @FUNCTION: debug-print-kernel2-variables
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# this function exists only to help debug kernel-2.eclass
# if you are adding new functionality in, put a call to it
# at the start of src_unpack, or during SRC_URI/dep generation.
# @FUNCTION: detect_version
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# this function will detect and set
# - OKV: Original Kernel Version (2.6.0/2.6.0-test11)
# - KV: Kernel Version (2.6.0-gentoo/2.6.0-test11-gentoo-r1)
# @FUNCTION: kernel_is
# @USAGE: <conditional version | version>
-# @DESCRIPTION:
+# @DESCRIPTION:
# user for comparing kernel versions
# or just identifying a version
# e.g kernel_is 2 4
# @FUNCTION: kernel_is_2_4
# @USAGE:
-# @DESCRIPTION:
-# return true if kernel is version 2.4
+# @DESCRIPTION:
+# return true if kernel is version 2.4
kernel_is_2_4() {
kernel_is 2 4
}
# @FUNCTION: kernel_is_2_6
# @USAGE:
-# @DESCRIPTION:
-# return true if kernel is version 2.6
+# @DESCRIPTION:
+# return true if kernel is version 2.6
kernel_is_2_6() {
kernel_is 2 6 || kernel_is 2 5
}
# @FUNCTION: kernel_header_destdir
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# return header destination directory
kernel_header_destdir() {
[[ ${CTARGET} == ${CHOST} ]] \
# @FUNCTION: cross_pre_c_headers
# @USAGE:
-# @DESCRIPTION:
-# set use if necessary for cross compile support
+# @DESCRIPTION:
+# set use if necessary for cross compile support
cross_pre_c_headers() {
use crosscompile_opts_headers-only && [[ ${CHOST} != ${CTARGET} ]]
}
# @FUNCTION: env_setup_xmakeopts
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# set the ARCH/CROSS_COMPILE when cross compiling
env_setup_xmakeopts() {
# @FUNCTION: unpack_2_4
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# unpack and generate .config for 2.4 kernels
unpack_2_4() {
# @FUNCTION: unpack_2_6
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# unpack and generate .config for 2.6 kernels
unpack_2_6() {
# @FUNCTION: universal_unpack
# @USAGE:
-# @DESCRIPTION:
-# unpack kernel sources
+# @DESCRIPTION:
+# unpack kernel sources
universal_unpack() {
debug-print "Inside universal_unpack"
# @FUNCTION: unpack_set_extraversion
# @USAGE:
-# @DESCRIPTION:
-# handle EXTRAVERSION
+# @DESCRIPTION:
+# handle EXTRAVERSION
unpack_set_extraversion() {
cd "${S}"
# @FUNCTION: unpack_fix_install_path
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# Should be done after patches have been applied
# Otherwise patches that modify the same area of Makefile will fail
# @FUNCTION: compile_headers
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# header compilation
compile_headers() {
# @FUNCTION: compile_headers_tweak_config
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# some targets can be very very picky, so let's finesse the
# .config based upon any info we may have
# @FUNCTION: install_universal
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# Fix permissions in tarball
install_universal() {
# @FUNCTION: install_headers
# @USAGE:
-# @DESCRIPTION:
-# Install headers
+# @DESCRIPTION:
+# Install headers
install_headers() {
local ddir=$(kernel_header_destdir)
# @FUNCTION: install_sources
# @USAGE:
-# @DESCRIPTION:
-# Install sources
+# @DESCRIPTION:
+# Install sources
install_sources() {
local file
# @FUNCTION: preinst_headers
# @USAGE:
-# @DESCRIPTION:
-# Headers preinst steps
+# @DESCRIPTION:
+# Headers preinst steps
preinst_headers() {
local ddir=$(kernel_header_destdir)
# @FUNCTION: postinst_sources
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# Sources post installation function.
# see inline comments
# @FUNCTION: setup_headers
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# Determine if ${PN} supports arch
setup_headers() {
# @FUNCTION: unipatch
# @USAGE: <list of patches to apply>
-# @DESCRIPTION:
-# Universal function that will apply patches to source
+# @DESCRIPTION:
+# Universal function that will apply patches to source
unipatch() {
local i x y z extention PIPE_CMD UNIPATCH_DROP KPATCH_DIR PATCH_DEPTH ELINE
# We're gonna need it when doing patches with a predefined patchlevel
eshopts_push -s extglob
- # This function will unpack all passed tarballs, add any passed patches,
+ # This function will unpack all passed tarballs, add any passed patches,
# and remove any passed patchnumbers
# usage can be either via an env var or by params
# although due to the nature we pass this within this eclass
# @FUNCTION: getfilevar
# @USAGE: <variable> <configfile>
-# @DESCRIPTION:
+# @DESCRIPTION:
# pulled from linux-info
getfilevar() {
# @FUNCTION: detect_arch
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# This function sets ARCH_URI and ARCH_PATCH
# with the neccessary info for the arch sepecific compatibility
# patchsets.
# @FUNCTION: headers___fix
# @USAGE:
-# @DESCRIPTION:
+# @DESCRIPTION:
# Voodoo to partially fix broken upstream headers.
# note: do not put inline/asm/volatile together (breaks "inline asm volatile")
"$@"
}
-# @FUNCTION: kernel-2_src_unpack()
+# @FUNCTION: kernel-2_src_unpack()
# @USAGE:
-# @DESCRIPTION:
-# unpack sources, handle genpatches, deblob
+# @DESCRIPTION:
+# unpack sources, handle genpatches, deblob
kernel-2_src_unpack() {
universal_unpack
# @FUNCTION: kernel-2_src_prepare
# @USAGE:
# @DESCRIPTION:
-# Apply any user patches
+# Apply any user patches
kernel-2_src_prepare() {
# @FUNCTION: kernel-2_src_compile
# @USAGE:
# @DESCRIPTION:
-# conpile headers or run deblob script
+# conpile headers or run deblob script
kernel-2_src_compile() {
cd "${S}"
# @FUNCTION: kernel-2_pkg_preinst
# @DESCRIPTION:
-# if ETYPE = headers, call preinst_headers
+# if ETYPE = headers, call preinst_headers
kernel-2_pkg_preinst() {
[[ ${ETYPE} == headers ]] && preinst_headers
# @FUNCTION: kernel-2_pkg_postinst
# @USAGE:
# @DESCRIPTION:
-# call postinst_sources for ETYPE = sources
+# call postinst_sources for ETYPE = sources
kernel-2_pkg_postinst() {
[[ ${ETYPE} == sources ]] && postinst_sources
# @USAGE:
# @DESCRIPTION:
# check for supported kernel version, die if ETYPE is unknown, call setup_headers
-# if necessary
+# if necessary
kernel-2_pkg_setup() {
if kernel_is 2 4; then
projects / gentoo.git / commitdiff