baseconfig
configs
debugconfig
scripts
.gitignore
0001-Enable-AXP288-PMIC-support-on-x86_64-for-battery-cha.patch
0001-iio-Use-event-header-from-kernel-tree.patch
0001-platform-x86-Add-driver-for-ACPI-INT0002-Virtual-GPI.patch
0002-mfd-Add-Cherry-Trail-Whiskey-Cove-PMIC-driver.patch
0003-power-supply-core-Add-support-for-supplied-from-devi.patch
0004-platform-x86-intel_cht_int33fe-Set-supplied-from-pro.patch
0005-ACPI-PMIC-xpower-Add-support-for-the-GPI1-regulator-.patch
0006-Input-axp20x-pek-Add-wakeup-support.patch
0007-platform-x86-silead_dmi-Add-touchscreen-info-for-GP-.patch
0008-platform-x86-silead_dmi-Add-touchscreen-info-for-PoV.patch
0009-platform-x86-silead_dmi-Add-touchscreen-info-for-Pip.patch
0010-Input-silead-Add-support-for-capactive-home-button-f.patch
0011-Input-goodix-Add-support-for-capacitive-home-button.patch
0012-Input-gpio_keys-Do-not-report-wake-button-presses-as.patch
0013-iio-accel-bmc150-Add-support-for-BOSC0200-ACPI-devic.patch
0014-mmc-sdhci-acpi-Workaround-conflict-with-PCI-wifi-on-.patch
0015-i2c-cht-wc-Add-Intel-Cherry-Trail-Whiskey-Cove-SMBUS.patch
0016-Input-silead-Do-not-try-to-directly-access-the-GPIO-.patch
ARM-tegra-usb-no-reset.patch
Add-EFI-signature-data-types.patch
Add-an-EFI-signature-blob-parser-and-key-loader.patch
Add-option-to-automatically-enforce-module-signature.patch
AllWinner-net-emac.patch
CVE-2017-7477.patch
CVE-2017-7645.patch
Input-synaptics-pin-3-touches-when-the-firmware-repo.patch
KEYS-Allow-unrestricted-boot-time-addition-of-keys-t.patch
Kbuild-Add-an-option-to-enable-GCC-VTA.patch
MODSIGN-Import-certificates-from-UEFI-Secure-Boot.patch
MODSIGN-Support-not-importing-certs-from-db.patch
Makefile
PatchList.txt
README.txt
RFC-audit-fix-a-race-condition-with-the-auditd-tracking-code.patch
TODO
arm-dts-boneblack-wireless-add-WL1835-Bluetooth-device-node.patch
arm-imx6-hummingboard2.patch
arm-revert-mmc-omap_hsmmc-Use-dma_request_chan-for-reque.patch
arm64-Add-option-of-13-for-FORCE_MAX_ZONEORDER.patch
ath9k-rx-dma-stop-check.patch
bcm2835-clk-audio-jitter-issues.patch
bcm2835-fix-potential-null-pointer-dereferences.patch
bcm2837-initial-support.patch
bcm283x-vc4-fix-vblank.patch
config_generation
cpupower.config
cpupower.service
crash-driver.patch
criu-no-expert.patch
die-floppy-die.patch
disable-i8042-check-on-apple-mac.patch
drm-i915-hush-check-crtc-state.patch
drm-vc4-Fix-OOPSes-from-trying-to-cache-a-partially-constructed-BO..patch
efi-Add-EFI_SECURE_BOOT-bit.patch
efi-Add-SHIM-and-image-security-database-GUID-defini.patch
efi-Disable-secure-boot-if-shim-is-in-insecure-mode.patch
efi-lockdown.patch
filter-aarch64.sh
filter-armv7hl.sh
filter-i686.sh
filter-ppc64.sh
filter-ppc64le.sh
filter-ppc64p7.sh
filter-s390x.sh
filter-x86_64.sh
firmware-Drop-WARN-from-usermodehelper_read_trylock-.patch
gitrev
input-kill-stupid-messages.patch
kernel-aarch64-debug.config
kernel-aarch64.config
kernel-armv7hl-debug.config
kernel-armv7hl-lpae-debug.config
kernel-armv7hl-lpae.config
kernel-armv7hl.config
kernel-i686-PAE.config
kernel-i686-PAEdebug.config
kernel-i686-debug.config
kernel-i686.config
kernel-local
kernel-ppc64-debug.config
kernel-ppc64.config
kernel-ppc64le-debug.config
kernel-ppc64le.config
kernel-ppc64p7-debug.config
kernel-ppc64p7.config
kernel-s390x-debug.config
kernel-s390x.config
kernel-x86_64-debug.config
kernel-x86_64.config
kernel.spec
lib-cpumask-Make-CPUMASK_OFFSTACK-usable-without-deb.patch
lis3-improve-handling-of-null-rate.patch
mod-extra.list
no-pcspkr-modalias.patch
qcom-QDF2432-tmp-errata.patch
qcom-rmsg-spmi-fixes.patch
rebase-notes.txt
scsi-sd_revalidate_disk-prevent-NULL-ptr-deref.patch
silence-fbcon-logo.patch
sources
usb-phy-tegra-Add-38.4MHz-clock-table-entry.patch
x509.genkey
xen-pciback-Don-t-disable-PCI_COMMAND-on-PCI-device-.patch
build_configs.sh
check_configs.awk
filter-modules.sh
generate_all_configs.sh
generate_debug_configs.sh
merge.pl
mod-extra.sh
mod-sign.sh
remove-binary-diff.pl
README.txt
		Kernel package tips & tricks.
		~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The kernel is one of the more complicated packages in the distro, and
for the newcomer, some of the voodoo in the spec file can be somewhat scary.
This file attempts to document some of the magic.


Speeding up make prep
---------------------
The kernel is nearly 500MB of source code, and as such, 'make prep'
takes a while. The spec file employs some trickery so that repeated
invocations of make prep don't take as long.  Ordinarily the %prep
phase of a package will delete the tree it is about to untar/patch.
The kernel %prep keeps around an unpatched version of the tree,
and makes a symlink tree clone of that clean tree and than applies
the patches listed in the spec to the symlink tree.
This makes a huge difference if you're doing multiple make preps a day.
As an added bonus, doing a diff between the clean tree and the symlink
tree is slightly faster than it would be doing two proper copies of the tree.


build logs.
-----------
There's a convenience helper script in scripts/grab-logs.sh
that will grab the build logs from koji for the kernel version reported
by make verrel


config heirarchy.
-----------------
Instead of having to maintain a config file for every arch variant we build on,
the kernel spec uses a nested system of configs. Each option CONFIG_FOO is
represented by a single file named CONFIG_FOO which contains the state (=y, =m,
=n). These options are collected in the folder baseconfig. Architecture specifi
options are set in nested folders. An option set in a nested folder will
override the same option set in one of the higher levels.

The individual CONFIG_FOO files only exist in the pkg-git repository. The RPM
contains kernel-foo.config files which are the result of combining all the
CONFIG_FOO files. The files are combined by running build_configs.sh. This
script _must_ be run each time one of the options is changed.

Example flow:

# Enable the option CONFIG_ABC123 as a module for all arches
echo "CONFIG_ABC123=m" > baseconfig/CONFIG_ABC1234
# enable the option CONFIG_XYZ321 for only x86
echo "# CONFIG_XYZ321 is not set" > baseconfig/CONFIG_XYZ321
echo "CONFIG_XYZ321=m" > baseconfig/x86/CONFIG_XYZ321
# regenerate the combined config files
./build_configs.sh

The file config_generation gives a listing of what folders go into each
config file generated.

debug options.
--------------
This is a little complicated, as the purpose & meaning of this changes
depending on where we are in the release cycle.
If we are building for a current stable release, 'make release' has
typically been run already, which sets up the following..
- Two builds occur, a 'kernel' and a 'kernel-debug' flavor.
- kernel-debug will get various heavyweight debugging options like
  lockdep etc turned on.

If we are building for rawhide, 'make debug' has been run, which changes
the status quo to:
- We only build one kernel 'kernel'
- The debug options are always turned on.
This is done to increase coverage testing, as not many people actually
run kernel-debug.

The debug options are managed in a separate heierarchy under debugconfig. This
works in a similar manner to baseconfig. More deeply nested folders, again,
override options. The file config_generation gives a listing of what folders
go into each config file generated.