LIVE-BOOT-REFRESH(1)

NAME
live-boot-refresh - set the live USB boot menu title to the release name

SYNOPSIS
live-boot-refresh [options] [mount-point]

DESCRIPTION
Set the live USB boot menus to the current release name. This is useful after a remaster, when the running system reports a new release name but the boot menus still show the original one.

The release name is taken from /etc/lsb-release (DISTRIB_DESCRIPTION) when present, otherwise from /etc/os-release (PRETTY_NAME).

It is written to:

    •   the title banner — the MENU TITLE line of the syslinux and isolinux configuration files and the “Welcome to ...” text of the GRUB theme files — as “Welcome to release”; and

    •   the OS boot entry labels — every syslinux / isolinux MENU LABEL, GRUB menuentry, and gfxboot readme.msg line that carries a build date (the sysvinit and systemd variants) — as “release (current date)”, keeping any trailing “(sysvinit)” or “(systemd)” marker.

Entries without a build date (Custom Boot, Memory Test, integrity check, ...) are left unchanged, as are commented-out entries.

If mount-point is omitted, the partition holding the boot menus is located automatically — the BIOS/EFI GRUB partition, then the boot partition — and mounted if needed. This includes the case where the device is not currently mounted, for example after booting toram when boot-dev is empty. A device that this command mounts is unmounted again on exit unless --keep-mounted is given. Auto-detection requires root and reads the live boot configuration, so it only works on a running live system; pass an explicit mount-point otherwise.

OPTIONS

-h, --help
    Show help.

-n, --dry-run
    Show what would be changed without modifying files.

-m, --keep-mounted
    Do not unmount a device that this command mounted.

FILES

/etc/lsb-release, /etc/os-release
    Source of the release name (DISTRIB_DESCRIPTION, then PRETTY_NAME). The copies under <mount-point>/etc are preferred when an explicit system tree is given.

boot/isolinux/isolinux.cfg, boot/syslinux/syslinux.cfg
    Main menu configuration files whose MENU TITLE and dated MENU LABEL lines are updated in place. Sub-menu configs (e.g. checkmedia.cfg) are left alone.

boot/grub/grub.cfg, boot/grub/config/*.cfg
    GRUB menu files whose dated menuentry titles are updated in place.

boot/isolinux/readme.msg, boot/syslinux/readme.msg
    gfxboot menu text (what is drawn on screen) whose dated entry lines are updated in place.

boot/grub/theme/*.txt
    GRUB theme files whose “Welcome to ...” banner text is updated in place.

SEE ALSO
live-remaster(1), live-grubsave(1), live-setup(1)

AUTHOR
mx-remaster maintainers