---

17.4.15 blscfg

Command: blscfg [-p|--path dir] [-f|--enable-fallback] [-d|--show-default] [-n|--show-non-default] [-e|--entry file] ¶

Load Boot Loader Specification (BLS) entries into the GRUB menu. Boot entries generated from blscfg won’t interfere with entries from grub.cfg appearing in the GRUB menu. Also, entries generated from blscfg exists only in memory and don’t update grub.cfg.

By default, the BLS entries are stored in the /loader/entries directory in the boot partition. If BLS entries are stored elsewhere, the --path option can be used to check a different directory instead of the default location. If no BLS entries are found while using the --path option, the --enable-fallback option can be used to check for entries in the default location.

The --show-default option allows the default boot entry to be added to the GRUB menu from the BLS entries.

The --show-non-default option allows non-default boot entries to be added to the GRUB menu from the BLS entries.

The --entry option allows specific boot entries to be added to the GRUB menu from the BLS entries.

The --entry, --show-default, and --show-non-default options are used to filter which BLS entries are added to the GRUB menu. If none are used, all entries in the default location or the location specified by --path will be added to the GRUB menu.

A BLS config file example:

# /boot/loader/entries/6a9857a393724b7a981ebb5b8495b9ea-3.8.0-2.fc19.x86_64.conf
title        Fedora 19 (Rawhide)
sort-key     fedora
machine-id   6a9857a393724b7a981ebb5b8495b9ea
version      3.8.0-2.fc19.x86_64
options      root=UUID=6d3376e4-fc93-4509-95ec-a21d68011da2 quiet
architecture x64
linux        /6a9857a393724b7a981ebb5b8495b9ea/3.8.0-2.fc19.x86_64/linux
initrd       /6a9857a393724b7a981ebb5b8495b9ea/3.8.0-2.fc19.x86_64/initrd

For more information on BLS entry keys as well as other information on BLS, see: The Boot Loader Specification. For the GRUB, there are a few additional BLS entry keys based on the menuentry command (see menuentry).

The grub_class key may be used any number of times to group menu entries into classes. Menu themes may display different classes using different styles.

The grub_users key grants specific users access to specific menu entries. See Security.

The grub_hotkey key associates a hotkey with a menu entry. key may be a single letter, or one of the aliases ‘backspace’, ‘tab’, or ‘delete’.

The grub_args key can be used for any other argument to be passed as positonal parameters when the list of commands generated from the BLS config file are executed.

Variable expansion using the ‘$’ character (See Writing full configuration files directly) may be used with BLS config files for the GRUB but might not be compatible with other bootloaders.