YaST2 Developers Documentation: Bootloader installation and configuration

Bootloader installation and configuration

include/bootloader/routines/lilolike.ycp
Functions common for lilo-like bootloaders only
  • Jiri Srain
  • Olaf Dabrunz

This module has an unstable interface.

Imports

  • Arch
  • BootArch
  • Map
  • Mode
  • Storage
  • StorageDevices

Includes

  • bootloader/routines/i386.ycp

Global Functions

Local Functions

global DisksChanged () -> boolean

Check whether disk settings were changed since last checking

Return value:
true if needs to recheck
global FindMBRDisk () -> string

FindMbrDisk() try to find the system's mbr device

Return value:
mbr device
local soft_MDraid_boot_disk (list<map> partitions) -> string

function check all partitions and it tries to find /boot partition if it is MD Raid and soft-riad return correct device for analyse MBR

Parameters:
partitions
Return value:
device for analyse MBR
Info:

ConfigureLocation() Where to install the bootloader. Returns the type of device where to install: one of "boot", "root", "mbr", "mbr_md" Also sets internal global variable selected_location to this.

Return value:
type of location proposed to bootloader
global DetectDisks () -> void

Detect /boot and / (root) partition devices If loader_device is empty or the device is not available as a boot partition, also calls ConfigureLocation to configure loader_device, set selected_location and set the activate flag if needed all these settings are stored in internal variables

global Md2Partitions (string md_device) -> map<string, integer>

Converts the md device to the list of devices building it

Parameters:
md_device string md device
Return value:
a map of devices (from device name to BIOS ID or nil if not detected) building the md device
global Md2Partition (string md_device) -> string

Converts the md device to the first of its members

Parameters:
md_device string md device
Return value:
one of devices building the md array
global RunDelayedUpdates () -> void

Run delayed updates

This is used by perl-Bootloader when it cannot remove sections from the bootloader configuration from the postuninstall-script of the kernel. It writes a command to a delayed update script that is then called here to remove these sections.

Info:

fallback list for kernel flavors (adapted from Kernel.ycp), used if we have no better information order is from special to general, but prefer "default" in favor of "xen"

global FixGlobals () -> void

Fix global section of lilo-like bootloader

This currently only tries to fix the "default" key if necessary. It is when the referenced section does not exist anymore or during a system update when a special comment in the bootloader configuration tells us that we have to update the "default" key. An empty "default" value is not changed, because this means that no default is wanted.

If we need to fix the "default" key we take the following steps:

- If we are fixing the configuration at the end of an update and the special key "former_default_image_flavor" exists, try to set the default to the first "linux.*" section with an image of this flavor (preferring "linux" entries over possibly older "linux-.*" entries).

- Otherwise go through a list of fallback kernel flavours and use the first "linux.*" section that contains a matching image (preferring "linux" entries over possibly older "linux-.*" entries).

global FixSections () -> void

Fix section of lilo-like bootloader

local UpdateDeviceForSection (map<string,any> section) -> void

Update in section old devices to new kernel format

Parameters:
section section to modify
global UpdateSections () -> void

Update sections of bootloader menu (removes obsolete thinks and place for ugly hacks (but doesn't efect zypper dup)) modifies internal structures label update is done in perl-Bootloader during updating kernel Purpose is don't break anything, but expect that previous state is working

global UpdateGlobals () -> void

Update global options of bootloader modifies internal sreuctures

global UpdateDeviceMap () -> void

Update the device map according to changed device names Read device map and store it in internal structures

global RemoveUnexistentSections (string path_prefix, string relative_path_prefix) -> void

Filter sections, remove those pointing to unexistent image

Parameters:
path_prefix string prefix to be added to kernel path
relative_path_prefix prefix to be added to relative kernel paths (without leading slash)
global UpdateAppend () -> void

Update append option if some parameters were changed

global UpdateGfxMenu () -> void

Update the gfxboot/message/... line if exists

global DiskOrderSummary () -> string

Get the summary of disks order for the proposal

Return value:
a line for the summary (or nil if not intended to be shown)
local ConvertXENinDomU () -> boolean

Convert XEN boot section to normal linux section if intalling in domU (bnc #436899)

Return value:
true if XEN section is converted to linux section