scripts
.gitignore
Makefile
Makefile.config
README.txt
acpi-ec-add-delay-before-write.patch
add-appleir-usb-driver.patch
add-support-for-ricoh-e822-sdhci.patch
btrfs-prohibit-a-operation-of-changing-acls-mask-when-noacl-mount-option-is-used.patch
config-arm
config-debug
config-generic
config-i686-PAE
config-ia64-generic
config-nodebug
config-powerpc-generic
config-powerpc32-generic
config-powerpc32-smp
config-powerpc64
config-rhel-generic
config-s390x
config-sparc64-generic
config-x86-generic
config-x86_64-generic
crypto-add-async-hash-testing.patch
crystalhd-2.6.34-staging.patch
die-floppy-die.patch
drm-i915-resume-force-mode.patch
drm-i915-sanity-check-pread-pwrite.patch
drm-intel-945gm-stability-fixes.patch
drm-intel-acpi-populate-didl.patch
drm-intel-big-hammer.patch
drm-intel-make-lvds-work.patch
drm-intel-next.patch
drm-intel-no-tv-hotplug.patch
drm-nouveau-d620.patch
drm-nouveau-g80-ctxprog.patch
drm-nouveau-kconfig.patch
drm-nouveau-mutex.patch
drm-nouveau-nva3-noaccel.patch
drm-nouveau-safetile-getparam.patch
drm-nouveau-tvout-disable.patch
drm-nouveau-update.patch
drm-radeon-pm.patch
drm-upgrayed-fixes.patch
drm-upgrayedd.patch
fix-abrtd.patch
fix-ima-null-ptr-deref.patch
genkey
git-bluetooth.patch
git-cpufreq.patch
git-linus.diff
hda_intel-prealloc-4mb-dmabuffer.patch
hdpvr-ir-enable.patch
ice1712-fix-revo71-mixer-names.patch
inet_diag-make-sure-we-run-the-same-bytecode-we-audited.patch
ipc-shm-fix-information-leak-to-user.patch
ipc-zero-struct-memory-for-compat-fns.patch
iwlwifi-fix-internal-scan-race.patch
iwlwifi-fix-scan-races.patch
iwlwifi-manage-QoS-by-mac-stack.patch
iwlwifi-recover_from_tx_stall.patch
iwlwifi-reset-card-during-probe.patch
iwlwifi_-Adjusting-PLCP-error-threshold-for-1000-NIC.patch
iwlwifi_-Logic-to-control-how-frequent-radio-should-be-reset-if-needed.patch
iwlwifi_-Recover-TX-flow-failure.patch
iwlwifi_-Recover-TX-flow-stall-due-to-stuck-queue.patch
iwlwifi_-Tune-radio-to-prevent-unexpected-behavior.patch
iwlwifi_-add-function-to-reset_tune-radio-if-needed.patch
iwlwifi_-add-internal-short-scan-support-for-3945.patch
iwlwifi_-code-cleanup-for-connectivity-recovery.patch
iwlwifi_-iwl_good_ack_health-only-apply-to-AGN-device.patch
iwlwifi_-move-plcp-check-to-separated-function.patch
iwlwifi_-multiple-force-reset-mode.patch
iwlwifi_-separated-time-check-for-different-type-of-force-reset.patch
kernel.spec
l2tp-fix-oops-in-pppol2tp_xmit.patch
linux-2.6-acpi-video-dos.patch
linux-2.6-ata-quirk.patch
linux-2.6-autoload-wmi.patch
linux-2.6-b43_-Rewrite-DMA-Tx-status-handling-sanity-checks.patch
linux-2.6-build-nonintconfig.patch
linux-2.6-cantiga-iommu-gfx.patch
linux-2.6-compile-fixes.patch
linux-2.6-crash-driver.patch
linux-2.6-debug-always-inline-kzalloc.patch
linux-2.6-debug-nmi-timeout.patch
linux-2.6-debug-sizeof-structs.patch
linux-2.6-debug-taint-vm.patch
linux-2.6-debug-vm-would-have-oomkilled.patch
linux-2.6-defaults-acpi-video.patch
linux-2.6-defaults-alsa-hda-beep-off.patch
linux-2.6-defaults-aspm.patch
linux-2.6-defaults-pci_no_msi.patch
linux-2.6-defaults-pciehp.patch
linux-2.6-dell-laptop-rfkill-fix.patch
linux-2.6-driver-level-usb-autosuspend.diff
linux-2.6-e1000-ich9.patch
linux-2.6-enable-btusb-autosuspend.patch
linux-2.6-execshield.patch
linux-2.6-firewire-git-pending.patch
linux-2.6-firewire-git-update.patch
linux-2.6-g5-therm-shutdown.patch
linux-2.6-hotfixes.patch
linux-2.6-imac-transparent-bridge.patch
linux-2.6-input-fix-toshiba-hotkeys.patch
linux-2.6-input-hid-quirk-egalax.patch
linux-2.6-input-kill-stupid-messages.patch
linux-2.6-ksm-kvm.patch
linux-2.6-makefile-after_link.patch
linux-2.6-nfs4-callback-hidden.patch
linux-2.6-nfsd4-proots.patch
linux-2.6-pci-cacheline-sizing.patch
linux-2.6-pciehp-update.patch
linux-2.6-phylib-autoload.patch
linux-2.6-ps3-storage-alias.patch
linux-2.6-revert-dvb-net-kabi-change.patch
linux-2.6-rfkill-all.patch
linux-2.6-selinux-mprotect-checks.patch
linux-2.6-serial-460800.patch
linux-2.6-silence-acpi-blacklist.patch
linux-2.6-silence-fbcon-logo.patch
linux-2.6-silence-noise.patch
linux-2.6-sparc-selinux-mprotect-checks.patch
linux-2.6-tracehook.patch
linux-2.6-upstream-reverts.patch
linux-2.6-usb-uvc-autosuspend.diff
linux-2.6-usb-wwan-update.patch
linux-2.6-utrace-ptrace.patch
linux-2.6-utrace.patch
linux-2.6-v4l-dvb-add-kworld-a340-support.patch
linux-2.6-v4l-dvb-add-lgdt3304-support.patch
linux-2.6-v4l-dvb-experimental.patch
linux-2.6-v4l-dvb-fixes.patch
linux-2.6-v4l-dvb-rebase-gspca-to-latest.patch
linux-2.6-v4l-dvb-update.patch
linux-2.6-vio-modalias.patch
linux-2.6-x86-64-fbdev-primary.patch
linux-2.6.29-sparc-IOC_TYPECHECK.patch
linux-2.6.30-hush-rom-warning.patch
linux-2.6.30-no-pcspkr-modalias.patch
lirc-2.6.32.patch
mac80211-explicitly-disable-enable-QoS.patch
net-do-not-check-capable-if-kernel.patch
netlink-make-nlmsg_find_attr-take-a-const-ptr.patch
pci-acpi-disable-aspm-if-no-osc.patch
pci-aspm-dont-enable-too-early.patch
perf
posix-cpu-timers-workaround-to-suppress-problems-with-mt-exec.patch
sky2-optima-add-missing-write-bits.patch
sky2-optima-add-register-definitions.patch
sky2-optima-fix-tcp-offload.patch
sky2-optima-print-chip-name.patch
sky2-optima-support.patch
sources
thinkpad-acpi-add-x100e.patch
thinkpad-acpi-fix-backlight.patch
tty-icount-changeover-for-other-main-devices.patch
tty-make-tiocgicount-a-handler.patch
via-hwmon-temp-sensor.patch
viafb-neuter-device-table.patch
wmi-check-find_guid-return-value-to-prevent-oops.patch
wmi-survive-bios-with-duplicate-guids.patch
find-provides
merge.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.  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.
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.