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). When an explicit live USB boot tree is given and it has no etc metadata, the existing dated boot labels in that tree are used instead. This prevents an older mounted USB from being relabeled with the host system's release 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; otherwise an explicit boot tree falls back to its existing dated boot labels.

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