mirror of
https://github.com/armbian/build.git
synced 2026-09-08 23:59:54 +08:00
SuperKali
c9c888bf88
Generic GRUB setup adds an Intel-only parameter to arm64 and loong64 images. Restrict it to amd64 while keeping the common Plymouth options. Signed-off-by: SuperKali <hello@superkali.me>
336 lines
19 KiB
Bash
336 lines
19 KiB
Bash
#!/usr/bin/env bash
|
|
# @description Standard GRUB bootloader setup for UEFI-capable boards (amd64, arm64, loong64), with optional amd64 BIOS support and a `DISTRO_GENERIC_KERNEL` mode that boots the distro kernel instead of Armbian's. Installs `grub-efi`, generates `grub.cfg`, and sets `GRUB_GFXPAYLOAD_LINUX=text` with `splash plymouth.ignore-serial-consoles` to keep the framebuffer console on `fbcon` and kernel boot messages visible.
|
|
|
|
# This runs *after* user_config. Don't change anything not coming from other variables or meant to be configured by the u ser.
|
|
function extension_prepare_config__prepare_grub_standard() {
|
|
# Extension configuration defaults.
|
|
declare -g DISTRO_GENERIC_KERNEL=${DISTRO_GENERIC_KERNEL:-no} # if yes, does not build our own kernel, instead, uses generic one from distro
|
|
declare -g UEFI_GRUB_TERMINAL="${UEFI_GRUB_TERMINAL:-"serial console"}" # 'serial' forces grub menu on serial console. empty to not include
|
|
declare -g UEFI_GRUB_DISABLE_OS_PROBER="${UEFI_GRUB_DISABLE_OS_PROBER:-}" # 'true' will disable os-probing, useful for SD cards.
|
|
declare -g UEFI_GRUB_DISTRO_NAME="${UEFI_GRUB_DISTRO_NAME:-Armbian}" # Will be used on grub menu display
|
|
declare -g UEFI_GRUB_TIMEOUT=${UEFI_GRUB_TIMEOUT:-0} # Small timeout by default
|
|
declare -g GRUB_CMDLINE_LINUX_DEFAULT="${GRUB_CMDLINE_LINUX_DEFAULT:-}" # Cmdline by default
|
|
declare -g UEFI_ENABLE_BIOS_AMD64="${UEFI_ENABLE_BIOS_AMD64:-yes}" # Enable BIOS too if target is amd64
|
|
declare -g UEFI_EXPORT_KERNEL_INITRD="${UEFI_EXPORT_KERNEL_INITRD:-no}" # export kernel and initrd for direct kernel boot "kexec"
|
|
|
|
# local
|
|
declare -a packages=()
|
|
|
|
if [[ "${UEFI_GRUB}" != "skip" ]]; then
|
|
# User config overrides for GRUB.
|
|
declare -g BOOTCONFIG="none" # To try and convince lib/ to not build or install u-boot.
|
|
unset BOOTSOURCE # To try and convince lib/ to not build or install u-boot.
|
|
declare -g IMAGE_PARTITION_TABLE="gpt" # GPT partition table is essential for many UEFI-like implementations, eg Apple+Intel stuff.
|
|
declare -g UEFISIZE=260 # in MiB - grub EFI is tiny - but some EFI BIOSes ignore small too small EFI partitions
|
|
declare -g BOOTSIZE=0 # No separate /boot when using UEFI.
|
|
if [[ $BOOTPART_REQUIRED == "yes" ]]; then # It is important to place this into /boot to have unified boot partition, especially when CRYPTROOT is used
|
|
declare -g UEFI_MOUNT_POINT=/boot
|
|
fi
|
|
declare -g EXTRA_BSP_NAME="${EXTRA_BSP_NAME}-grub" # Unique bsp name.
|
|
declare -g UEFI_GRUB_TARGET_BIOS="" # Target for BIOS GRUB install, set to i386-pc when UEFI_ENABLE_BIOS_AMD64=yes and target is amd64
|
|
|
|
packages+=(efibootmgr efivar cloud-initramfs-growroot busybox) # Use growroot(+busybox for it to work on Bookworm), add some efi-related packages
|
|
packages+=(os-prober "grub-efi-${ARCH}-bin") # This works for Ubuntu and Debian, by sheer luck; common for EFI and BIOS
|
|
|
|
# BIOS-compatibility for amd64
|
|
if [[ "${ARCH}" == "amd64" ]]; then
|
|
declare -g UEFI_GRUB_TARGET="x86_64-efi" # Default for x86_64
|
|
if [[ "${UEFI_ENABLE_BIOS_AMD64}" == "yes" ]]; then
|
|
packages+=(grub-pc-bin grub-pc)
|
|
declare -g UEFI_GRUB_TARGET_BIOS="i386-pc"
|
|
declare -g BIOSSIZE=4 # 4 MiB BIOS partition
|
|
else
|
|
packages+=("grub-efi-${ARCH}")
|
|
fi
|
|
else
|
|
packages+=("grub-efi-${ARCH}")
|
|
fi
|
|
|
|
if [[ "${ARCH}" == "arm64" ]]; then
|
|
declare -g UEFI_GRUB_TARGET="arm64-efi" # Default for arm64-efi
|
|
elif [[ "${ARCH}" == "loong64" ]]; then
|
|
declare -g UEFI_GRUB_TARGET="loongarch64-efi"
|
|
fi
|
|
fi
|
|
|
|
if [[ "${DISTRIBUTION}" == "Ubuntu" ]]; then
|
|
DISTRO_KERNEL_VER="generic"
|
|
DISTRO_KERNEL_PACKAGES="linux-image-generic"
|
|
DISTRO_FIRMWARE_PACKAGES="linux-firmware"
|
|
elif [[ "${DISTRIBUTION}" == "Debian" ]]; then
|
|
DISTRO_KERNEL_VER="${ARCH}" # Debian's generic kernel is named like "5.19.0-2-amd64", we can't predict, use the arch
|
|
DISTRO_KERNEL_PACKAGES="linux-image-${ARCH}"
|
|
DISTRO_FIRMWARE_PACKAGES="firmware-linux-free"
|
|
fi
|
|
|
|
if [[ "${DISTRO_GENERIC_KERNEL}" == "yes" ]]; then
|
|
declare -g IMAGE_INSTALLED_KERNEL_VERSION="${DISTRO_KERNEL_VER}"
|
|
declare -g KERNELSOURCE='none' # We need to be explicit we don't want a kernel built.
|
|
declare -g INSTALL_ARMBIAN_FIRMWARE=no # Should skip build and install of Armbian-firmware.
|
|
else
|
|
declare -g KERNELDIR="linux-uefi-${LINUXFAMILY}" # Avoid sharing a source tree with others, until we know it's safe.
|
|
# Don't install anything. Armbian handles everything.
|
|
DISTRO_KERNEL_PACKAGES=""
|
|
DISTRO_FIRMWARE_PACKAGES=""
|
|
fi
|
|
|
|
# @TODO: use actual arrays. Yeah...
|
|
# shellcheck disable=SC2086
|
|
add_packages_to_image ${DISTRO_FIRMWARE_PACKAGES} ${DISTRO_KERNEL_PACKAGES} "${packages[@]}"
|
|
|
|
display_alert "Extension: ${EXTENSION}: ${UEFI_GRUB} activating" "GRUB with SERIALCON=${SERIALCON}; timeout ${UEFI_GRUB_TIMEOUT}; BIOS=${UEFI_GRUB_TARGET_BIOS}" ""
|
|
}
|
|
|
|
function post_family_tweaks_bsp__remove_uboot_grub() {
|
|
if [[ "${UEFI_GRUB}" == "skip" ]]; then
|
|
display_alert "Extension: ${EXTENSION}: Skipping remove uboot from BSP" "due to UEFI_GRUB:${UEFI_GRUB}" "debug"
|
|
return 0
|
|
fi
|
|
|
|
display_alert "Removing uboot from BSP" "${EXTENSION}" "info"
|
|
# Simply remove everything with 'uboot' or 'u-boot' in their filenames from the BSP package.
|
|
# shellcheck disable=SC2154 # $destination is the target dir of the bsp building function
|
|
pushd "${destination}" || exit_with_error "cray-cray about destination: ${destination}"
|
|
run_host_command_logged find "." -type f "|" grep -e "uboot" -e "u-boot" "|" xargs rm -v
|
|
popd
|
|
}
|
|
|
|
function pre_umount_final_image__remove_uboot_initramfs_hook_grub() {
|
|
if [[ "${UEFI_GRUB}" == "skip" ]]; then
|
|
display_alert "Extension: ${EXTENSION}: Skipping GRUB install" "due to UEFI_GRUB:${UEFI_GRUB}" "debug"
|
|
return 0
|
|
fi
|
|
|
|
# even if BSP still contained this (cached .deb), make sure by removing from ${MOUNT}
|
|
[[ -f "$MOUNT"/etc/initramfs/post-update.d/99-uboot ]] && rm -v "$MOUNT"/etc/initramfs/post-update.d/99-uboot
|
|
return 0 # shortcircuit above
|
|
}
|
|
|
|
pre_umount_final_image__install_grub() {
|
|
if [[ "${UEFI_GRUB}" == "skip" ]]; then
|
|
display_alert "Extension: ${EXTENSION}: Skipping GRUB install" "due to UEFI_GRUB:${UEFI_GRUB}" "debug"
|
|
if [[ "${DISTRO_GENERIC_KERNEL}" == "yes" ]]; then
|
|
display_alert "Extension: ${EXTENSION}: Skipping GRUB install" "due to UEFI_GRUB:${UEFI_GRUB} - calling update_initramfs directly with IMAGE_INSTALLED_KERNEL_VERSION=${DISTRO_KERNEL_VER}" "debug"
|
|
IMAGE_INSTALLED_KERNEL_VERSION="${DISTRO_KERNEL_VER}" update_initramfs "${MOUNT}"
|
|
fi
|
|
return 0
|
|
fi
|
|
|
|
configure_grub
|
|
local chroot_target="${MOUNT}"
|
|
display_alert "Extension: ${EXTENSION}: Installing bootloader" "GRUB" "info"
|
|
|
|
# Ubuntu's grub (10_linux) will look for /boot/dtb, /boot/dtb-<version> ...
|
|
# ... unfortunately it does not account for the fact those might be a directories (as in Armbian's linux-dtb case).
|
|
# Zap everything out of there, the hook below will have a chance to put them back, as symlinks.
|
|
# Kernel hooks should maintain the link for apt upgrades (same as done for initrd).
|
|
rm -rf "${MOUNT}"/boot/dtb* || true
|
|
|
|
# Call a hook, allowing for early configuration of GRUB.
|
|
call_extension_method "grub_early_config" <<- 'GRUB_EARLY_CONFIG'
|
|
Allow for early GRUB configuration.
|
|
This is called after `configure_grub`, and zapping /boot/dtb*.
|
|
chroot ($MOUNT) is *not* mounted yet.
|
|
GRUB_EARLY_CONFIG
|
|
|
|
# add config to disable os-prober, otherwise image will have the host's other OSes boot entries.
|
|
cat <<- grubCfgFragHostSide >> "${MOUNT}"/etc/default/grub.d/99-armbian-host-side.cfg
|
|
GRUB_DISABLE_OS_PROBER=true
|
|
grubCfgFragHostSide
|
|
|
|
# copy Armbian GRUB wallpaper
|
|
mkdir -p "${MOUNT}"/usr/share/images/grub/
|
|
cp "${SRC}"/packages/blobs/splash/grub.png "${MOUNT}"/usr/share/images/grub/wallpaper.png
|
|
|
|
if [[ "${DISTRO_GENERIC_KERNEL}" == "yes" ]]; then
|
|
display_alert "Extension: ${EXTENSION}: Using Distro Generic Kernel" "${EXTENSION}: update_initramfs with IMAGE_INSTALLED_KERNEL_VERSION: ${DISTRO_KERNEL_VER}" "debug"
|
|
IMAGE_INSTALLED_KERNEL_VERSION="${DISTRO_KERNEL_VER}" update_initramfs "${MOUNT}"
|
|
fi
|
|
|
|
# Mount the chroot...
|
|
mount_chroot "$chroot_target/" # this already handles /boot/efi which is required for it to work.
|
|
|
|
call_extension_method "grub_pre_install" <<- 'GRUB_PRE_INSTALL'
|
|
Last-minute hook for GRUB tweaks before actually installing GRUB and running update-grub.
|
|
The chroot ($MOUNT) is mounted.
|
|
GRUB_PRE_INSTALL
|
|
|
|
deploy_qemu_binary_to_chroot "$chroot_target" "grub" # undeployed near the end of this function
|
|
|
|
if [[ "${UEFI_GRUB_TARGET_BIOS}" != "" ]]; then
|
|
display_alert "Extension: ${EXTENSION}: Installing GRUB BIOS..." "${UEFI_GRUB_TARGET_BIOS} device ${LOOP}" ""
|
|
chroot_custom "$chroot_target" grub-install --target=${UEFI_GRUB_TARGET_BIOS} "${LOOP}" || {
|
|
exit_with_error "${install_grub_cmdline} failed!"
|
|
}
|
|
fi
|
|
|
|
local install_grub_cmdline="grub-install --target=${UEFI_GRUB_TARGET} --efi-directory=${UEFI_MOUNT_POINT} --no-nvram --removable" # nvram is global to the host, even across chroot. take care.
|
|
display_alert "Extension: ${EXTENSION}: Installing GRUB EFI..." "${UEFI_GRUB_TARGET}" ""
|
|
chroot_custom "$chroot_target" "$install_grub_cmdline" || {
|
|
exit_with_error "${install_grub_cmdline} failed!"
|
|
}
|
|
|
|
# update-grub is secretly `grub-mkconfig` under wraps, but the actual work is done by /etc/grub.d/10-linux
|
|
# that decides based on 'test -e "/dev/disk/by-uuid/${GRUB_DEVICE_UUID}"' so that _must_ exist.
|
|
# If it does NOT exist, then a reference to a /dev/devYpX is used, and will fail to boot.
|
|
# Irony: let's use grub-probe to find out the UUID of the root partition, and then create a symlink to it.
|
|
# Another: on some systems (eg, not Docker) the thing might already exist due to udev actually working.
|
|
# shellcheck disable=SC2016 # some wierd escaping going on there.
|
|
# Root is needed so that UUID of the unlocked /dev/mapper/armbian-root is discovered by grub-update,
|
|
# UUID is then put into grub.cfg instead of raw /dev/mapper/armbian-root which will fail further sanity check
|
|
chroot_custom "$chroot_target" mkdir -pv '/dev/disk/by-uuid/"$(grub-probe --target=fs_uuid /)"' "||" true
|
|
# Include /boot that might point to a separate boot partition in case one exists (lvm, cryptroot)
|
|
# Even if boot partition doesn't exist - the command will be the same as mkdir for / above
|
|
chroot_custom "$chroot_target" mkdir -pv '/dev/disk/by-uuid/"$(grub-probe --target=fs_uuid /boot)"' "||" true
|
|
|
|
display_alert "Extension: ${EXTENSION}: Creating GRUB config..." "grub-mkconfig" ""
|
|
chroot_custom "$chroot_target" update-grub || {
|
|
display_alert "GRUB grub-mkconfig failed" "update-grub failed; dumping full config" "err"
|
|
|
|
declare -a mkconfig_input_files=()
|
|
mkconfig_input_files+=("${MOUNT}/etc/default/grub")
|
|
mkconfig_input_files+=("${MOUNT}/etc/default/grub.d/"*) # expands!
|
|
mkconfig_input_files+=("${MOUNT}/etc/grub.d/"*) # same for /etc/grub.d; expands!
|
|
run_tool_batcat "${mkconfig_input_files[@]}"
|
|
|
|
exit_with_error "update-grub failed!"
|
|
}
|
|
|
|
call_extension_method "grub_late_config" <<- 'GRUB_LATE_CONFIG'
|
|
Allow for late GRUB configuration.
|
|
This is called after grub-install and update-grub.
|
|
chroot ($MOUNT) is mounted. sanity checks are going to be performed.
|
|
GRUB_LATE_CONFIG
|
|
|
|
### Sanity check. The produced "/boot/grub/grub.cfg" should:
|
|
declare -i has_failed_sanity_check=0
|
|
|
|
# - NOT have any mention of `/dev` inside; otherwise something is going to fail
|
|
if grep -q '/dev' "${chroot_target}/boot/grub/grub.cfg"; then
|
|
display_alert "GRUB sanity check failed" "grub.cfg contains /dev" "err"
|
|
SHOW_LOG=yes run_host_command_logged grep '/dev' "${chroot_target}/boot/grub/grub.cfg" "||" true
|
|
has_failed_sanity_check=1
|
|
else
|
|
display_alert "Extension: ${EXTENSION}: GRUB config sanity check passed" "no '/dev' found in grub.cfg" "info"
|
|
fi
|
|
|
|
# - HAVE references to initrd, otherwise going to fail.
|
|
if ! grep -q 'initrd.img' "${chroot_target}/boot/grub/grub.cfg"; then
|
|
display_alert "GRUB config sanity check failed" "no initrd.img references found in /boot/grub/grub.cfg" "err"
|
|
has_failed_sanity_check=1
|
|
else
|
|
display_alert "Extension: ${EXTENSION}: GRUB config sanity check passed" "initrd.img references found OK in /boot/grub/grub.cfg" "debug"
|
|
fi
|
|
|
|
if [[ ${has_failed_sanity_check} -gt 0 ]]; then
|
|
exit_with_error "Extension: ${EXTENSION}: GRUB config sanity check failed, image will be unbootable; see above errors"
|
|
fi
|
|
|
|
# Check and warn if the wallpaper was not picked up by grub-mkconfig, if UEFI_GRUB_TERMINAL==gfxterm
|
|
if [[ "${UEFI_GRUB_TERMINAL}" =~ "gfxterm" ]]; then
|
|
if ! grep -q "background_image" "${chroot_target}/boot/grub/grub.cfg"; then
|
|
display_alert "Extension: ${EXTENSION}: GRUB mkconfig problem" "no wallpaper detected in generated grub.cfg" "warn"
|
|
else
|
|
display_alert "Extension: ${EXTENSION}: GRUB config sanity check passed" "wallpaper setup" "debug"
|
|
fi
|
|
else
|
|
display_alert "Extension: ${EXTENSION}: GRUB config sanity check passed" "UEFI_GRUB_TERMINAL!=gfxterm, skipping wallpaper check" "debug"
|
|
fi
|
|
|
|
# Remove host-side config.
|
|
rm -f "${MOUNT}"/etc/default/grub.d/99-armbian-host-side.cfg
|
|
|
|
undeploy_qemu_binary_from_chroot "$chroot_target" "grub"
|
|
umount_chroot "$chroot_target/"
|
|
|
|
}
|
|
|
|
pre_umount_final_image__900_export_kernel_and_initramfs() {
|
|
if [[ "${UEFI_EXPORT_KERNEL_INITRD}" == "yes" ]]; then
|
|
display_alert "Extension: ${EXTENSION}: Exporting Kernel and Initrd for" "kexec" "info"
|
|
# this writes to ${DESTIMG} directly, since debootstrap.sh will move them later.
|
|
# capture the $MOUNT/boot/vmlinuz and initrd and send it out ${DESTIMG}
|
|
run_host_command_logged ls -la "${MOUNT}"/boot/vmlinuz-* "${MOUNT}"/boot/initrd.img-* || true
|
|
run_host_command_logged cp -pv "${MOUNT}"/boot/vmlinuz-* "${DESTIMG}/${version}.kernel"
|
|
run_host_command_logged cp -pv "${MOUNT}"/boot/initrd.img-* "${DESTIMG}/${version}.initrd"
|
|
fi
|
|
}
|
|
|
|
configure_grub() {
|
|
display_alert "Extension: ${EXTENSION}: Configuring GRUB" "UEFI GRUB; SERIALCON=${SERIALCON}" "info"
|
|
|
|
# If SERIALCON is _not_ tty1 or tty0, include a console=tty0 first.
|
|
if [[ "${SERIALCON}" != "tty1" && "${SERIALCON}" != "tty0" ]]; then
|
|
GRUB_CMDLINE_LINUX_DEFAULT+=" console=tty0"
|
|
fi
|
|
|
|
[[ -n "$SERIALCON" ]] &&
|
|
GRUB_CMDLINE_LINUX_DEFAULT+=" console=${SERIALCON}"
|
|
|
|
# Kernel cmdline. We always pass the graphical-Plymouth flags
|
|
# (splash plymouth.ignore-serial-consoles) on UEFI systems,
|
|
# regardless of whether this image is being built as CLI or
|
|
# desktop. Two reasons:
|
|
# 1. Users routinely add a desktop later via armbian-config
|
|
# and we don't want that to require regenerating grub.cfg.
|
|
# The .cfg is baked once at image-build time and stays
|
|
# put across desktop installs.
|
|
# 2. Plymouth handles the "no theme installed" / "no DRM"
|
|
# cases gracefully — the flags are harmless on a CLI
|
|
# install. They are NOT harmless when wrong: the previous
|
|
# 'splash=verbose' value was rejected by the kernel
|
|
# ("Unknown kernel command line parameters splash=verbose"
|
|
# in dmesg) AND interpreted by Plymouth as "render the
|
|
# verbose/text theme", so a desktop installed later still
|
|
# booted to a black/text screen.
|
|
#
|
|
# Deliberately NO 'quiet' and NO 'loglevel=3' here. Plymouth
|
|
# still draws the splash on top of the kernel boot messages,
|
|
# but the messages remain visible underneath so users can see
|
|
# what their system is doing. Press Esc during boot to drop
|
|
# the splash and read the messages directly.
|
|
GRUB_CMDLINE_LINUX_DEFAULT+=" splash plymouth.ignore-serial-consoles"
|
|
if [[ "${ARCH}" == "amd64" ]]; then
|
|
GRUB_CMDLINE_LINUX_DEFAULT+=" i915.force_probe=*"
|
|
fi
|
|
|
|
# Enable Armbian Wallpaper on GRUB
|
|
if [[ "${VENDOR}" == Armbian ]]; then
|
|
display_alert "Extension: ${EXTENSION}: Enabling" "Armbian Wallpaper on GRUB" "info"
|
|
mkdir -p "${MOUNT}"/usr/share/desktop-base/
|
|
cat <<- grubWallpaper >> "${MOUNT}"/usr/share/desktop-base/grub_background.sh
|
|
WALLPAPER=/usr/share/images/grub/wallpaper.png
|
|
COLOR_NORMAL=white/black
|
|
COLOR_HIGHLIGHT=black/white
|
|
grubWallpaper
|
|
run_host_command_logged chmod -v +x "${MOUNT}"/usr/share/desktop-base/grub_background.sh
|
|
fi
|
|
|
|
display_alert "Extension: ${EXTENSION}: GRUB EFI kernel cmdline" "cmdline '${GRUB_CMDLINE_LINUX_DEFAULT}' distro=${UEFI_GRUB_DISTRO_NAME} timeout=${UEFI_GRUB_TIMEOUT}" ""
|
|
cat <<- grubCfgFrag >> "${MOUNT}"/etc/default/grub.d/98-armbian.cfg
|
|
GRUB_CMDLINE_LINUX_DEFAULT="${GRUB_CMDLINE_LINUX_DEFAULT}"
|
|
GRUB_TIMEOUT_STYLE=menu # Show the menu with Kernel options (Armbian or -generic)...
|
|
GRUB_TIMEOUT=${UEFI_GRUB_TIMEOUT} # ... for ${UEFI_GRUB_TIMEOUT} seconds, then boot the Armbian default.
|
|
GRUB_DISTRIBUTOR="${UEFI_GRUB_DISTRO_NAME}" # On GRUB menu will show up as "Armbian GNU/Linux" (will show up in some UEFI BIOS boot menu (F8?) as "armbian", not on others)
|
|
GRUB_BACKGROUND="/usr/share/images/grub/wallpaper.png" # Armbian GRUB wallpaper. 05_debian_theme gives GRUB_BACKGROUND precedence over the WALLPAPER sourced from /usr/share/desktop-base/grub_background.sh, so the Armbian image wins even on Debian desktop images where desktop-base ships (and overwrites) that file to point at its own theme wallpaper (Trixie: ceratopsian). Ubuntu already showed the Armbian image; this makes it deterministic on both.
|
|
GRUB_DISABLE_SUBMENU=y # Do not put all kernel options into a submenu, instead, list them all on the main menu.
|
|
GRUB_DISABLE_OS_PROBER=false # Have to be explicit about enabling os-prober
|
|
GRUB_FONT="/usr/share/grub/unicode.pf2" # Be explicit about the font to use so Ubuntu does not freak out and mess gfxterm
|
|
GRUB_GFXPAYLOAD_LINUX=text # Note the correct var name is GRUB_GFXPAYLOAD_LINUX, not GRUB_GFXPAYLOAD (the latter is silently ignored). The 'text' value disables Ubuntu's vt.handoff=7 injection: Ubuntu's grub2 10_linux only expands 'vt.handoff=7' inside grub.cfg's gfxmode function when the gfxpayload arg is exactly 'keep'. Setting it to 'text' makes the runtime check fail and the framebuffer console stays bound to fbcon for the entire userspace lifetime — which is what we want, otherwise after Plymouth quits on a CLI install (or after the user uninstalls the desktop), the kernel hands the framebuffer to VT7 waiting for an X server, nothing ever claims it, and the local console goes black even though getty@tty1 is running.
|
|
GRUB_DISABLE_UUID=false # Be explicit about wanting UUID
|
|
GRUB_DISABLE_LINUX_UUID=false # Be explicit about wanting UUID
|
|
grubCfgFrag
|
|
|
|
if [[ "a${UEFI_GRUB_DISABLE_OS_PROBER}" != "a" ]]; then
|
|
cat <<- grubCfgFragHostSide >> "${MOUNT}"/etc/default/grub.d/98-armbian.cfg
|
|
GRUB_DISABLE_OS_PROBER=${UEFI_GRUB_DISABLE_OS_PROBER}
|
|
grubCfgFragHostSide
|
|
fi
|
|
|
|
if [[ "a${UEFI_GRUB_TERMINAL}" != "a" ]]; then
|
|
cat <<- grubCfgFragTerminal >> "${MOUNT}"/etc/default/grub.d/98-armbian.cfg
|
|
GRUB_TERMINAL="${UEFI_GRUB_TERMINAL}"
|
|
grubCfgFragTerminal
|
|
fi
|
|
}
|