YaST2 Developers Documentation: Bootloader installation and configuration

Bootloader installation and configuration

modules/BootPOWERLILO.ycp
Module containing specific functions for POWERLILO configuration and installation
  • Jiri Srain
  • Joachim Plack
  • Olaf Dabrunz
  • Philipp Thomas

This module has an unstable interface.

Imports

  • Arch
  • BootArch
  • BootCommon
  • Installation
  • Kernel
  • Mode
  • Pkg
  • Stage
  • Storage

Includes

  • bootloader/generic/dialogs.ycp
  • bootloader/ppc/helps.ycp
  • bootloader/routines/popups.ycp

Global Functions

Local Functions

local updatePrepBootPartitions () -> boolean

Update list of 41 PReP boot partitions

Return value:
true if list changed, false otherwise
local choosePrepBootPartition () -> void

Select PReP boot partition to propose Changes internal variables.

local PRePInit () -> void

Initialize attributes of the board type

local CHRPInit () -> void

Initialize attributes of the board type

local iSeriesExecute (string command, string logfile) -> boolean

Helper function that executes a command with the shell, appending stdout and stderr to a logfile. On error, it writes log entries to the yast2 log.

Parameters:
command string command to execute
logfile string logfile for the commands output
Return value:
true on success
global iSeriesWrite () -> boolean

Install the board-type-specific part of bootloader

Return value:
true on success
global iSeriesInit () -> void

Initialize attributes of the board type

global currentBoardInit () -> void

Initialize the attribute of currently used board type

local CreateImageSection (string title) -> map<string,any>

Create section for bootable image

Parameters:
title string the section name to create (untranslated)
Return value:
describes the section
local GoodPmacBootPartition () -> string

Choose a boot partition on pmac type == Apple_HFS|Apple_Bootstrap && size < 20 cyl

Return value:
device name of pmac boot partition
global LocationProposal () -> void

Propose the location of the root device on disk and the boot device (if any), according to the subarchitecture. Results are stored in global variables.

global CreateSections () -> void

Propose sections to bootloader menu modifies internal sreuctures

global CreateGlobals () -> void

Propose global options of bootloader modifies internal structures

global SaveInstSourceId () -> void

Save the ID of the base installation source modifies internal variable

global Propose () -> void

Propose bootloader settings

global Export () -> map

Export bootloader settings to a map

Return value:
bootloader settings
global Import (map settings) -> boolean

Import settings from a map

Parameters:
settings map of bootloader settings
Return value:
true on success
global Read (boolean reread, boolean avoid_reading_device_map) -> boolean

Read settings from disk

Parameters:
reread boolean true to force reread settings from system
avoid_reading_device_map do not read new device map from file, use internal data
Return value:
true on success
global Reset (boolean init) -> void

Reset bootloader settings

Parameters:
init
global Save (boolean clean, boolean init, boolean flush) -> boolean

Save all bootloader configuration files to the cache of the PlugLib PlugLib must be initialized properly !!!

Parameters:
clean boolean true if settings should be cleaned up (checking their correctness, supposing all files are on the disk
init boolean true to init the library
flush boolean true to flush settings to the disk
Return value:
true if success
global Summary () -> list<string>

Display bootloader summary

Return value:
a list of summary lines
global Update () -> void

Update read settings to new version of configuration files

Info:

Firstly update sections of bootloader configuration and modify internal structures as needed. This means right now:

Info:

Secondly update global settings of bootloader configuration:

global Write () -> boolean

Write bootloader settings to disk

Return value:
true on success
global FlagOnetimeBoot (string section) -> boolean

Set section to boot on next reboot

Parameters:
section string section to boot
Return value:
true on success
global GetFunctions () -> map<string, any>

Return map of provided functions

Return value:
map of functions (eg. $["write":BootPOWERLILO::Write])
global Initializer () -> void

Initializer of PowerLILO bootloader

global BootPOWERLILO () -> void

Constructor