Skip to content

Latest commit

 

History

History
59 lines (38 loc) · 2.46 KB

README.md

File metadata and controls

59 lines (38 loc) · 2.46 KB
Raw

PURPOSE

This is a simple Makefile wrapper around the kernel makefile, which enables the following advantages:

  1. Seperate kernel-sources and kernel-build objects:

    • allows reuse of source files for different kernel configuration

  2. Fast/painless compile and install process:

    • make ; make install (or make gentooinstall) is enough
    • nice level and makeflags are supported
    • remote host installation possible -- check the SSH_INSTALL_USER / SSH_HOST_INSTALL variables

  3. optional: build kernel as [portage] user

    • use a root shell uncomment/set KBUILD_USER in Makefile.kern (global) or in your Makefile for a local config (sudo is necessary)
    • ensure that the user has the permissions to create the build directory

It's especially dedicated to gentoo-users, but should works (with minor adpations) for all others distros as well. However there is a gentooinstall target which covers additionally:

  • grub-mkconfig -o /boot/grub/grub
  • emerge -1 @module-rebuild

USAGE

Makefile.kern is kind of the template makefile. For a standard (amd64/x86) compilation the following steps are necessary:

Initial:

  • Create a directory (favored use the name of the host the kernel is used) otherwise set KHOST variable
  • Create a Makefile and adapt special configuration settings like KSOURCE_PATH, KMAKE_TARGETS etc.
  • Finally include the template makefile by adding include ../Makefile.kern
  • (optional) add a intial kernel configuration in a defconfig file (in case the file is missing make defconfig is used)

Compilation:

  • (optional) run make update_defconfig in order to update your kernel seed from the currently running kernel (access to /proc/config.gz required)
  • (optional) run other kernel tragets like make menuconfig
  • run make

Installation:

  • run make install (or make gentooinstall)

EXAMPLES

  • amd64: look at the amd64-host-example/ directory
  • amd64 + initramfs: look at the amd64-host-initramfs-example/ directory
  • armv7a: look at the armv7a-odroidhc1-example/ directory (use crossdev for cross-compilation)

gentoo

Gentoo users have to set KBUILD_OUTPUT in their make.conf ("<kern-git-root>/<hostname or configdir>/linux/kbuild")

The gentoo directory contains larry the cow as logo that can be use for the linux kernel Additionaly a template for /etc/portage/env/sys-kernel/gentoo-sources is provided which replaces the original linux logo and does same cleanup work after removing a the gentoo-source package.