The Linux kernel
Go to file
Josh Boyer 32027e071f Linux v3.15-rc3-41-g2aafe1a4d451
- Reenable debugging options.
2014-04-29 10:29:23 -04:00
scripts generate-git-snapshot.sh: warn if $LINUX_GIT dir is unset 2013-07-18 20:14:24 -04:00
.gitignore Linux v3.14 2014-03-31 08:32:46 -04:00
0001-ARM-sunxi-Add-driver-for-SD-MMC-hosts-found-on-Allwi.patch Add patch to support the mmc controller on sunxi arm SoCs 2014-04-25 10:17:30 +02:00
0001-HID-rmi-do-not-handle-touchscreens-through-hid-rmi.patch Add patch to fix Synaptics touchscreens and HID rmi driver (rhbz 1089583) 2014-04-22 13:06:51 -04:00
0001-HID-rmi-introduce-RMI-driver-for-Synaptics-touchpads.patch Backported HID RMI driver for Haswell Dell XPS machines from Benjamin Tissoires (rhbz 1048314) 2014-04-10 09:59:02 -04:00
0001-lib-cpumask-Make-CPUMASK_OFFSTACK-usable-without-deb.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
0001-synaptics-Add-min-max-quirk-for-ThinkPad-Edge-E431.patch Add synaptics min-max quirk for ThinkPad Edge E431 (rhbz#1089689) 2014-04-25 10:23:22 +02:00
ACPICA-Tables-Fix-bad-pointer-issue-in-acpi_tb_parse_root_table.patch Fix ACPI issue preventing boot on AMI firmware (rhbz 1090746) 2014-04-25 08:12:25 -04:00
arm-tegra-usb-no-reset-linux33.patch Patch for disconnect issues with storage attached to a tegra-ehci controller 2012-05-03 20:27:11 +01:00
ath9k_rx_dma_stop_check.patch Add patch to fix ath9k dma stop checks (rhbz 892811) 2013-02-06 10:00:23 -05:00
compile-fixes.patch Rename a bunch of patches. 2013-01-10 14:24:41 -05:00
config-arm64 Linux v3.14-4227-g3e75c6de1ac3 2014-04-02 12:29:14 -04:00
config-arm-generic Linux v3.15-rc3 2014-04-28 09:48:57 -04:00
config-armv7 minor omap config tweaks for recent option name changes, no functional change 2014-04-26 12:26:39 +01:00
config-armv7-generic Add patch to support the mmc controller on sunxi arm SoCs 2014-04-25 10:17:30 +02:00
config-armv7-lpae Minor ARM config changes and cleanups for 3.15 merge window 2014-04-14 13:13:02 +01:00
config-debug Linux v3.14-751-g683b6c6f82a6 2014-04-01 15:56:24 -04:00
config-generic Linux v3.15-rc3-41-g2aafe1a4d451 2014-04-29 10:29:23 -04:00
config-i686-PAE Re-enable I2O, but only for 32-bit x86 (#629676) 2010-09-03 05:24:38 -04:00
config-local Add support for local rebuild config option overrides 2011-01-10 17:37:27 -05:00
config-no-extra disable extras on arm 2013-10-03 12:22:16 -04:00
config-nodebug Linux v3.15-rc3-41-g2aafe1a4d451 2014-04-29 10:29:23 -04:00
config-powerpc32-generic Minor kernel configs cleanup merging duplicated config opts into generic 2013-08-19 09:37:57 -04:00
config-powerpc32-smp Minor kernel configs cleanup merging duplicated config opts into generic 2013-08-19 09:37:57 -04:00
config-powerpc64 Linux v3.14-12812-g321d03c86732 2014-04-13 16:50:45 -04:00
config-powerpc64le Add ppc64le support from Brent Baude (rhbz 1073102) 2014-03-06 14:35:39 -05:00
config-powerpc64p7 Linux v3.14-12812-g321d03c86732 2014-04-13 16:50:45 -04:00
config-powerpc-generic Linux v3.14-rc3 2014-02-17 08:36:46 -05:00
config-s390x Fix crash driver build and re-enable on s390x (from Dan Horák) 2013-11-26 13:53:18 -05:00
config-x86_64-generic Switch to CONFIG_TRANSPARENT_HUGEPAGE_MADVISE instead of always on 2014-03-27 18:31:27 -04:00
config-x86-32-generic Linux v3.15-rc1-113-g6ca2a88ad820 2014-04-17 09:36:17 -04:00
config-x86-generic Linux v3.15-rc3-41-g2aafe1a4d451 2014-04-29 10:29:23 -04:00
cpupower.config Create the kernel-tools package. WHEE 2011-08-17 21:19:57 -04:00
cpupower.service Create the kernel-tools package. WHEE 2011-08-17 21:19:57 -04:00
crash-driver.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
criu-no-expert.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
defaults-acpi-video.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
die-floppy-die.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
disable-i8042-check-on-apple-mac.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
disable-libdw-unwind-on-non-x86.patch Linux v3.15-rc1-113-g6ca2a88ad820 2014-04-18 06:58:29 -04:00
drm-i915-hush-check-crtc-state.patch Update bugzilla and upstream status for i915 hush crtc state patch 2013-11-13 14:58:25 -05:00
drm-radeon-Disable-writeback-by-default-on-ppc.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
fanotify-fix-EOVERFLOW-on-64-bit.patch Add patch from Will Woods to fix fanotify EOVERFLOW issue (rhbz 696821) 2014-04-25 08:32:59 -04:00
gpio-ich-set-regs-and-reglen-for-i3100-and-ich6-chipset.patch Linux v3.15-rc1-49-g10ec34fcb100 2014-04-16 11:08:24 -04:00
hibernate-freeze-filesystems.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
input-kill-stupid-messages.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
kernel.spec Linux v3.15-rc3-41-g2aafe1a4d451 2014-04-29 10:29:23 -04:00
lis3-improve-handling-of-null-rate.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
Makefile Linux v3.15-rc1 2014-04-14 09:50:14 -04:00
makefile-after_link.patch Linux v3.14-751-g683b6c6f82a6 2014-04-01 15:56:24 -04:00
Makefile.config Add ppc64le support from Brent Baude (rhbz 1073102) 2014-03-06 14:35:39 -05:00
Makefile.release Linux v3.15-rc1 2014-04-14 09:50:14 -04:00
merge.pl initial srpm import 2010-07-29 16:46:31 -07:00
mod-extra.list Linux v3.11-rc5-21-g28fbc8b 2013-08-14 14:30:31 -04:00
mod-extra.sh Prep mod-extra.sh for signed modules 2012-09-25 13:22:00 -04:00
mod-sign.sh simplify the signing stuff now that sign-file takes pub/priv key args 2013-03-28 16:33:21 -04:00
modsign-uefi.patch Linux v3.15-rc2 2014-04-21 09:46:02 -04:00
no-pcspkr-modalias.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
nowatchdog-on-virt.patch Fix nowatchdog-on-virt.patch to actually work in KVM guests 2013-12-18 10:31:48 -05:00
PatchList.txt Linux v3.13-rc1-77-g4c1cc40 2013-11-24 08:42:45 -05:00
README.txt document inheritance/heirarchy of config generation 2012-01-13 15:42:52 -05:00
rebase-notes.txt rebase-notes: no X32 2012-03-19 20:54:31 -04:00
Revert-userns-Allow-unprivileged-users-to-create-use.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
sb-hibernate.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
scsi-sd_revalidate_disk-prevent-NULL-ptr-deref.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
secure-modules.patch Linux v3.14-12042-g69cd9eba3886 2014-04-10 09:38:28 -04:00
serial-460800.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
silence-fbcon-logo.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
silence-noise.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
sources Linux v3.15-rc3-41-g2aafe1a4d451 2014-04-29 10:29:23 -04:00
sysrq-secure-boot.patch Linux v3.13-2502-gec513b1 2014-01-21 21:50:28 -05:00
TODO 3.5 reminder 2012-04-30 12:20:09 -04:00
upstream-reverts.patch Rename a bunch of patches. 2013-01-10 14:24:41 -05:00
weird-root-dentry-name-debug.patch Update patches with bugzilla/upstream-status fields 2013-12-17 11:16:02 -05:00
x509.genkey Switch to using modsign-post-KS upstream with x509 certs 2012-09-25 13:22:04 -04:00

		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.  At the top level, is
config-generic. Add options here that should be present in every possible
config on all architectures.

Beneath this are per-arch overrides. For example config-x86-generic add
additional x86 specific options, and also _override_ any options that were
set in config-generic.

The heirarchy looks like this..

                           config-generic
                                 |
                         config-x86-generic
                         |                |
             config-x86-32-generic   config-x86-64-generic

An option set in a lower level will override the same option set in one
of the higher levels.


There exist two additional overrides, config-debug, and config-nodebug,
which override -generic, and the per-arch overrides. It is documented
further below.


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 from 'config-debug' are always turned on.
This is done to increase coverage testing, as not many people actually
run kernel-debug.

To add new debug options, add an option to _both_ config-debug and config-nodebug,
and also new stanzas to the Makefile 'debug' and 'release' targets.

Sometimes debug options get added to config-generic, or per-arch overrides
instead of config-[no]debug. In this instance, the options should have no
discernable performance impact, otherwise they belong in the debug files.