diff --git a/mdbook/book.toml b/mdbook/book.toml index 235f114a9..d00683e22 100644 --- a/mdbook/book.toml +++ b/mdbook/book.toml @@ -1,6 +1,11 @@ [book] authors = ["John Davidson"] +description = "Minimal Linux Live - guidebook" language = "en" multilingual = false src = "src" title = "Minimal Linux Live" + +[output.html] +default-theme = "rust" + diff --git a/mdbook/book/00_clean.html b/mdbook/book/00_clean.html index 4810ed2da..305775d25 100644 --- a/mdbook/book/00_clean.html +++ b/mdbook/book/00_clean.html @@ -1,5 +1,5 @@ - +
@@ -13,7 +13,7 @@ - + @@ -48,7 +48,7 @@ @@ -74,7 +74,7 @@ if (theme === null || theme === undefined) { theme = default_theme; } var html = document.querySelector('html'); html.classList.remove('no-js') - html.classList.remove('light') + html.classList.remove('rust') html.classList.add(theme); html.classList.add('js'); @@ -93,7 +93,7 @@ @@ -112,8 +112,8 @@The MLL build process can be divided in several major phases.
+The MLL build process can be divided in several major phases. Refer to the common properties for more details on the folders that are referenced below.
Everything from WORK_DIR
is removed. All previous MLL build artifacts are lost and the MLL build process can start from scratch. The previously downloaded sources are preserved in order to speed up the process.
Linux kernel source code is downloaded. OverlayFS and EFI stub are configured. Kernel is built and the kernel binary, along with the kernel header files are placed in KERNEL_INSTALLED
.
GNU C Library source code is downloaded. Build preparations are made in the GLIBC_OBJECTS
. GLIBC is built and the final artifacts are placed in GLIBC_INSTALLED
. The .so
files, along with all GLIBC headers and all kernel headers are placed in SYSROOT
.
Busybox source code is downloaded. The build configuration is tweaked to reference SYSROOT
. The final build artifacts are placed in BUSYBOX_INSTALLED
.
All overlay bundles that have been enabled in .config
are built. The final overlay structure is generated in OVERLAY_ROOTFS
.
The installed Busybox artifacts and src/minimal_rootfs/
are merged in ROOTFS
. The initramfs file WORK_DIR/rootfs.cpio.xz
is generated from ROOTFS
. The final initramfs ISO image structure for the overlay bundles is generated in ISOIMAGE_OVERLAY
.
Syslinux and/or systemd-boot are downloaded.
+The boot loader for BIOS/UEFI is prepared and the boot configuration artifacts from src/minimal_boot/
are properly placed. The final ISO image layout structure is prepared in ISOIMAGE
. This directory contains the BIOS/UEFI boot loader, Linux kernel and initramfs, along with all MLL overlay bundles (i.e. additional software and/or configurations) that have been enabled. The ISO image file src/minimal_linux_live.iso
is generated. The MLL filesystem image (e.g. use in Docker) src/mll_image.tgz
is generated. Final cleanup is performed.
This is the directory where the kernel and its corresponding header files are placed after the kernel build phase has been completed.
GLIBC_OBJECTS=src/work/glibc/glibc_objects/
TODO...
+This is the directory where the GNU C Library is going to be built.
GLIBC_INSTALLED=src/work/glibc/glibc_installed/
TODO...
+This is the directory where the GNU C Library shared objects (.so files) are placed after the build phase has been completed.
BUSYBOX_INSTALLED=src/work/busybox/busybox_installed/
TODO...
+This is the directory where Busybox is placed after the build phase has been completed.
SYSROOT=src/work/sysroot/
TODO...
+The system root folder for MLL. This folder contains GLIBC, and kernel header files. MLL uses the sysroot folder in order to properly link Busybox with the custom built kernel and GLIBC.
ROOTFS=src/work/rootfs/
TODO...
+This folder contains the rootfs/initramfs structure which is generated by the core MLL build process.
OVERLAY_ROOTFS=src/work/overlay_rootfs/
TODO...
+This folder contains the rootfs/initramfs structure which is generated by the overlay subsystem build process.
OVERLAY_ROOTFS=src/work/isoimage/
TODO...
+This folder contains the final ISO image structure.
OVERLAY_ROOTFS=src/work/isoimage_overlay/
TODO...
+This folder contains the final overlay subsystem ISO structure.
This function reads properties from the main .config
file.