Porteus Kernel Builder

Post#1 by **neko** » 15 Jan 2017, 09:41

setting window

mkKernel-24.12.03-noarch-1.xzm (12 M)
https://www.mediafire.com/file/oca6s365 ... arch-1.xzm
md5sum: 6fd7356b53a2045e3d9bebc19e009642 mkKernel-24.12.03-noarch-1.xzm

[Firmware database :kernel-firmware-20241122_3ed524d-noarch-1plus.xzm (594 M)]
that was created with
slackware package "kernel-firmware-20241122_3ed524d-noarch-1.txz (361 M)" and following pakages lib/firmware.
alsa-firmware
amd-ucode
intel-ucode
linux-atm
linux-firmware
linux-firmware-bnx2x
linux-firmware-liquidio
linux-firmware-marvell
linux-firmware-mellanox
linux-firmware-nfp
linux-firmware-qcom
linux-firmware-qlogic
nvidia-utils
sof-firmware
wireless-regdb

This tool makes "COMPILATION AND USAGE OF CUSTOM PORTEUS KERNEL" procedure easy.
http://www.porteus.org/component/conten ... ernel.html
From GUI it creates the shell script and then performs that script.

The functions of Porteus Kernel Builder are as followed.
1. detect latest kernel version.
2. download kernel source (compressed).
3. download and create the AUF patch that corresponds to the kernel version.
4. get prototype config. (Mostly created by Blaze. Thanks to Blaze.)
5. expand kernel source and adapt AUF patch.
6. build kernel.
7. copy firmwares from firmware packages.
8. create crippled_sources module.
9. replace kernel of ISO with new one.

[How to use]
step 1. prepare compile environment.
get 05-devel.xzm for your architecture from Porteus release site.
activate "05-devel.xzm".
This prepare is needed for the following actions only.
1)getting AUF patch
2)adapting AUF patch
3)building kernel

step 2. set working direcory.
First, prepare the directory for 'Porteus Kernel Builder'.
This direcory must be in LINUX file system (ext4 etc.,).
Select this in "Kernel Builder directory" of "setting window"

step 3. select kernel version.
select kernel version line in left item of "Kernel Version" of "setting window".
left item will display the latest version of the line.
if older version is needed, select kernel version in right item.

step 4. (option) "Build kernel" circle
"32Bit/64Bit" item: (first, display running PC architecture)
---->select compiling architecture.

"download" item:
---->if check it on, download kernel source.

"expand & patch" item: (this action needs 05-devel.xzm for adapting AUF patch)
---->if select NONE: none expand
---->if select ONLY: expand only
---->if select AUFS: expand & AUFS patch
---->if select OWN: expand & OWN patch

"compile" item: (this action needs 05-devel.xzm for building kernel)
---->if select NONE: not build
---->if select PROTO: build with prototype config, and set vmlinuz & lib.
---->if select YOUR: build with your set config, and set vmlinuz & lib.
---->if select ONLY: build with the config from "make localmodconfig", and set vmlinuz & lib.

"Create FW" item:
---->if check it on, copy firmwares from firmware packages

"cleanup" item:
---->if check it on, cleanup expanded directory.

Note 1:
Each item can be set independently.
(example)
1st run: set "download" item and "expand & patch"
modfy config depending on own needs.
2nd run: set "compile" item.
check result.
3rd run: set "cleanup" item.

step 5. (option) "ISO whose kernel will be update" circle
select ISO whose kernel will be update. (Original ISO must be in the directory differ from kernel build work directory.)
"keep org" item: (default "check on")
---->if check it off, replace initrd.xz with "integrated initrd.xz", and insert a new porteus-NNNNN.cfg.

step 6. (option) "Create crippled_sources or 000-kernel modules" circle
"crippled_sources" item:
---->if check it on, create crippled_sources module.
Don't cleanup, when this will be used.

"000-kernel" item:
---->if check it on, create 000-kernel module.

"Placement:Arcklinux/Placement:Slackware" item:
----> select "Placement:Slackware" for 000-kernel of Porteus.
----> select "Placement:Arcklinux" for 000-kernel of APorteus.

"Zstd compress" item:
---->if check it on, XZM module (crippled_sources, 000-kerne) is a mksquashfs compressed with "Zstandard (zstd)"
---->if check it off, XZM module (crippled_sources, 000-kerne) is a mksquashfs compressed with "XZ"

Note 2: Config
"Porteus Kernel Builder" mkKernel-yy.mm.dd-noarch-1.xzm includes config prototypes.

/usr/local/share/mkKernel/lib/vN.M/32bit.config:
is a config prototype for 32 bit kernel version N.M.n build.
/usr/local/share/mkKernel/lib/vN.M/64bit.config:
is a config prototype for 64 bit kernel version N.M.n build.

These prototypes were derived from the Porteus original config
by "make oldconfig" command with the almost new items "No" spec.
If a new function item of a kernel version is needed,
the prototype config item should be changed by "make menuconfig" command.

[Kernel config prototypes updating policy]
Updating the config is set with almost new spec items "N".
Because it prevent to grow the size of kernel.
Some spec items that were requested are set with "M" or "Y".
Setting with "Y" is only for boot devices.
The spec item concerning network is set with "M".
Because a network is set up after boot.
If network booting is used,
in initrd, 000-kernel.xzm module will be activated and the needed driver is included.
therefore naming "000-kernel.xzm" is reserved.
(I don't know that new Porteus initrd performs same.)
All spec items concerning debug are set with "N".

Note 3: "integrated initrd.xz"
[integrating initrds]
initrd of Porteus 4.0
initrd of Porteus 4.0 Overlay FS trial version
initrd of APorteus
initrd of APorteus Overlay FS version

Note 4: AUFS patch
AUFS patches consist of multiple patches.
It can be divided into basic patches and optional patches.
Basic patches are classified into two types:
one for statically incorporated AUFS functionality
(kernel build config paramater: CONFIG_AUFS_FS=y <-----Porteus)
and
one for dynamically incorporated AUFS functionality
(kernel build config paramater: CONFIG_AUFS_FS=m).

1. Basic patch group
1.1. Basic patches for static integration
{Documentation,fs,include/uapi/linux/aufs_type.h} files
aufsN-base.patch
aufsN-kbuild.patch
aufsN-mmap.patch

Apply basic patches shell script (/usr/local/share/mkKernel/bin/aufsBase.sh)