ACC SHELL
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html>
<head>
<title>
Bootloader installation and configuration
</title>
<style type="text/css">body { background-color: #c8c8c8 }
h1 { color: #e00000 }
table { width: 100%/ border: none }
img { border: 0px }
.sigbox { background-color: #ffc080; border: solid thin #f96500 }
.sig { font: larger monospace }
.padtbl { background-color: #ffc080; padding: 10px; margin: 10px }
/* arrow */
.a { color: #606060 }
/* type, parameter */
.t, .p { color: #c05000 }
.pbox { width: 20% }
.descbox { }
.right { align: right }
.header {}
.footer { clear: both}
.menu { width: 10%; float: left }
.main { width: 90%; float: left }
</style>
</head>
<body>
<div class="header">
<i>YaST2 Developers Documentation:</i>
<a href="index.html">
<b>
Bootloader installation and configuration
</b>
</a>
<img class="right" alt="" src="/usr/share/doc/packages/yast2-devtools/images/yast2-mini.png" />
<hr />
</div>
<div class="menu">
<img alt="YaST" src="/usr/share/doc/packages/yast2-devtools/images/yast2-half.png" />
<br />
<br />
<a href="index.html">functions</a>
<br />
<a href="files.html">files</a>
<br />
<a href="intro.html">intro</a>
</div>
<div class="main">
<div class="sigbox">
<table class="padtbl">
<tr>
<td>
<h1>
Bootloader installation and configuration
</h1>
</td>
<td class="filecell">
modules/BootPOWERLILO.ycp
</td>
</tr>
<tr>
<td>
Module containing specific functions for POWERLILO configuration
and installation
</td>
</tr>
<tr>
<td>
<ul>
<li> Jiri Srain <jsrain@suse.cz></li>
<li> Joachim Plack <jplack@suse.de></li>
<li> Olaf Dabrunz <od@suse.de></li>
<li> Philipp Thomas <pth@suse.de></li>
</ul>
</td>
</tr>
<tr>
<td>
<p>This module has an unstable interface.</p>
</td>
</tr>
</table>
<table class="padtbl">
<tr>
<td>
<h1>Imports</h1>
<ul>
<li>Arch</li>
<li>BootArch</li>
<li>BootCommon</li>
<li>BootStorage</li>
<li>Installation</li>
<li>Kernel</li>
<li>Mode</li>
<li>Pkg</li>
<li>Stage</li>
<li>Storage</li>
</ul>
<h1>Includes</h1>
<ul>
<li>bootloader/ppc/dialogs.ycp</li>
<li>bootloader/ppc/helps.ycp</li>
<li>bootloader/routines/popups.ycp</li>
</ul>
<h1>Global Functions</h1>
<ul>
<li>
<a href="#BootPOWERLILO">BootPOWERLILO ()</a>
</li>
<li>
<a href="#CreateGlobals">CreateGlobals ()</a>
</li>
<li>
<a href="#CreateImageSection">CreateImageSection (string title)</a>
</li>
<li>
<a href="#CreateSections">CreateSections ()</a>
</li>
<li>
<a href="#Export">Export ()</a>
</li>
<li>
<a href="#FlagOnetimeBoot">FlagOnetimeBoot (string section)</a>
</li>
<li>
<a href="#GetFunctions">GetFunctions ()</a>
</li>
<li>
<a href="#Import">Import (map settings)</a>
</li>
<li>
<a href="#Initializer">Initializer ()</a>
</li>
<li>
<a href="#LocationProposal">LocationProposal ()</a>
</li>
<li>
<a href="#Propose">Propose ()</a>
</li>
<li>
<a href="#Read">Read (boolean reread, boolean avoid_reading_device_map)</a>
</li>
<li>
<a href="#Reset">Reset (boolean init)</a>
</li>
<li>
<a href="#Save">Save (boolean clean, boolean init, boolean flush)</a>
</li>
<li>
<a href="#SaveInstSourceId">SaveInstSourceId ()</a>
</li>
<li>
<a href="#Summary">Summary ()</a>
</li>
<li>
<a href="#Update">Update ()</a>
</li>
<li>
<a href="#Write">Write ()</a>
</li>
<li>
<a href="#currentBoardInit">currentBoardInit ()</a>
</li>
<li>
<a href="#iSeriesInit">iSeriesInit ()</a>
</li>
<li>
<a href="#iSeriesWrite">iSeriesWrite ()</a>
</li>
</ul>
<h1>Local Functions</h1>
<ul>
<li>
<a href="#CHRPInit">CHRPInit ()</a>
</li>
<li>
<a href="#GoodPmacBootPartition">GoodPmacBootPartition ()</a>
</li>
<li>
<a href="#PRePInit">PRePInit ()</a>
</li>
<li>
<a href="#choosePrepBootPartition">choosePrepBootPartition ()</a>
</li>
<li>
<a href="#iSeriesExecute">iSeriesExecute (string command, string logfile)</a>
</li>
<li>
<a href="#updatePrepBootPartitions">updatePrepBootPartitions ()</a>
</li>
</ul>
</td>
</tr>
</table>
</div>
<p />
<div class="sigbox">
<span class="sig" id="updatePrepBootPartitions">local
<b>updatePrepBootPartitions ()
<span class="a"> -> </span>
<span class="t">boolean</span>
</b>
</span>
</div>
<p>
Update list of 41 PReP boot partitions</p>
<dl>
<dt>
<b>Return value:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="t" />
</td>
<td class="descbox">true if list changed, false otherwise</td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="choosePrepBootPartition">local
<b>choosePrepBootPartition ()
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
Select PReP boot partition to propose
Changes internal variables.</p>
<div class="sigbox">
<span class="sig" id="PRePInit">local
<b>PRePInit ()
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
Initialize attributes of the board type</p>
<div class="sigbox">
<span class="sig" id="CHRPInit">local
<b>CHRPInit ()
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
Initialize attributes of the board type</p>
<div class="sigbox">
<span class="sig" id="iSeriesExecute">local
<b>iSeriesExecute (string command, string logfile)
<span class="a"> -> </span>
<span class="t">boolean</span>
</b>
</span>
</div>
<p>
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.</p>
<dl>
<dt>
<b>Parameters:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="p">command</span>
</td>
<td class="descbox">string command to execute</td>
</tr>
<tr>
<td class="pbox">
<span class="p">logfile</span>
</td>
<td class="descbox">string logfile for the commands output</td>
</tr>
</table>
</dd>
</dl>
<dl>
<dt>
<b>Return value:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="t" />
</td>
<td class="descbox">true on success</td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="iSeriesWrite">global
<b>iSeriesWrite ()
<span class="a"> -> </span>
<span class="t">boolean</span>
</b>
</span>
</div>
<p>
Install the board-type-specific part of bootloader</p>
<dl>
<dt>
<b>Return value:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="t" />
</td>
<td class="descbox">true on success</td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="iSeriesInit">global
<b>iSeriesInit ()
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
Initialize attributes of the board type</p>
<div class="sigbox">
<span class="sig" id="currentBoardInit">global
<b>currentBoardInit ()
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
Initialize the attribute of currently used board type</p>
<div class="sigbox">
<span class="sig" id="CreateImageSection">global
<b>CreateImageSection (string title)
<span class="a"> -> </span>
<span class="t">map<string,any></span>
</b>
</span>
</div>
<p>
Create section for bootable image</p>
<dl>
<dt>
<b>Parameters:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="p">title</span>
</td>
<td class="descbox">string the section name to create (untranslated)</td>
</tr>
</table>
</dd>
</dl>
<dl>
<dt>
<b>Return value:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="t" />
</td>
<td class="descbox">describes the section</td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="GoodPmacBootPartition">local
<b>GoodPmacBootPartition ()
<span class="a"> -> </span>
<span class="t">string</span>
</b>
</span>
</div>
<p>
Choose a boot partition on pmac
type == Apple_HFS|Apple_Bootstrap && size < 20 cyl</p>
<dl>
<dt>
<b>Return value:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="t" />
</td>
<td class="descbox">device name of pmac boot partition</td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="LocationProposal">global
<b>LocationProposal ()
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
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.</p>
<div class="sigbox">
<span class="sig" id="CreateSections">global
<b>CreateSections ()
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
Propose sections to bootloader menu
modifies internal sreuctures</p>
<div class="sigbox">
<span class="sig" id="CreateGlobals">global
<b>CreateGlobals ()
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
Propose global options of bootloader
modifies internal structures</p>
<div class="sigbox">
<span class="sig" id="SaveInstSourceId">global
<b>SaveInstSourceId ()
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
Save the ID of the base installation source
modifies internal variable</p>
<div class="sigbox">
<span class="sig" id="Propose">global
<b>Propose ()
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
Propose bootloader settings</p>
<div class="sigbox">
<span class="sig" id="Export">global
<b>Export ()
<span class="a"> -> </span>
<span class="t">map</span>
</b>
</span>
</div>
<p>
Export bootloader settings to a map</p>
<dl>
<dt>
<b>Return value:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="t" />
</td>
<td class="descbox">bootloader settings</td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="Import">global
<b>Import (map settings)
<span class="a"> -> </span>
<span class="t">boolean</span>
</b>
</span>
</div>
<p>
Import settings from a map</p>
<dl>
<dt>
<b>Parameters:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="p">settings</span>
</td>
<td class="descbox">map of bootloader settings</td>
</tr>
</table>
</dd>
</dl>
<dl>
<dt>
<b>Return value:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="t" />
</td>
<td class="descbox">true on success</td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="Read">global
<b>Read (boolean reread, boolean avoid_reading_device_map)
<span class="a"> -> </span>
<span class="t">boolean</span>
</b>
</span>
</div>
<p>
Read settings from disk</p>
<dl>
<dt>
<b>Parameters:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="p">reread</span>
</td>
<td class="descbox">boolean true to force reread settings from system</td>
</tr>
<tr>
<td class="pbox">
<span class="p">avoid_reading_device_map</span>
</td>
<td class="descbox">do not read new device map from file, use
internal data</td>
</tr>
</table>
</dd>
</dl>
<dl>
<dt>
<b>Return value:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="t" />
</td>
<td class="descbox">true on success</td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="Reset">global
<b>Reset (boolean init)
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
Reset bootloader settings</p>
<dl>
<dt>
<b>Parameters:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="p">init</span>
</td>
<td class="descbox"></td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="Save">global
<b>Save (boolean clean, boolean init, boolean flush)
<span class="a"> -> </span>
<span class="t">boolean</span>
</b>
</span>
</div>
<p>
Save all bootloader configuration files to the cache of the PlugLib
PlugLib must be initialized properly !!!</p>
<dl>
<dt>
<b>Parameters:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="p">clean</span>
</td>
<td class="descbox">boolean true if settings should be cleaned up (checking their
correctness, supposing all files are on the disk</td>
</tr>
<tr>
<td class="pbox">
<span class="p">init</span>
</td>
<td class="descbox">boolean true to init the library</td>
</tr>
<tr>
<td class="pbox">
<span class="p">flush</span>
</td>
<td class="descbox">boolean true to flush settings to the disk</td>
</tr>
</table>
</dd>
</dl>
<dl>
<dt>
<b>Return value:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="t" />
</td>
<td class="descbox">true if success</td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="Summary">global
<b>Summary ()
<span class="a"> -> </span>
<span class="t">list<string></span>
</b>
</span>
</div>
<p>
Display bootloader summary</p>
<dl>
<dt>
<b>Return value:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="t" />
</td>
<td class="descbox">a list of summary lines</td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="Update">global
<b>Update ()
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
Update read settings to new version of configuration files</p>
<div class="sigbox">Info:</div>
<p>
Firstly update sections of bootloader configuration and modify internal
structures as needed. This means right now:</p>
<div class="sigbox">Info:</div>
<p>
Secondly update global settings of bootloader configuration:</p>
<div class="sigbox">
<span class="sig" id="Write">global
<b>Write ()
<span class="a"> -> </span>
<span class="t">boolean</span>
</b>
</span>
</div>
<p>
Write bootloader settings to disk</p>
<dl>
<dt>
<b>Return value:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="t" />
</td>
<td class="descbox">true on success</td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="FlagOnetimeBoot">global
<b>FlagOnetimeBoot (string section)
<span class="a"> -> </span>
<span class="t">boolean</span>
</b>
</span>
</div>
<p>
Set section to boot on next reboot</p>
<dl>
<dt>
<b>Parameters:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="p">section</span>
</td>
<td class="descbox">string section to boot</td>
</tr>
</table>
</dd>
</dl>
<dl>
<dt>
<b>Return value:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="t" />
</td>
<td class="descbox">true on success</td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="GetFunctions">global
<b>GetFunctions ()
<span class="a"> -> </span>
<span class="t">map<string, any></span>
</b>
</span>
</div>
<p>
Return map of provided functions</p>
<dl>
<dt>
<b>Return value:</b>
</dt>
<dd>
<table>
<tr>
<td class="pbox">
<span class="t" />
</td>
<td class="descbox">map of functions (eg. $["write":BootPOWERLILO::Write])</td>
</tr>
</table>
</dd>
</dl>
<div class="sigbox">
<span class="sig" id="Initializer">global
<b>Initializer ()
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
Initializer of PowerLILO bootloader</p>
<div class="sigbox">
<span class="sig" id="BootPOWERLILO">global
<b>BootPOWERLILO ()
<span class="a"> -> </span>
<span class="t">void</span>
</b>
</span>
</div>
<p>
Constructor</p>
</div>
<div class="footer">
<hr />
<i>YaST2 Developers Documentation</i>
<img class="right" alt="" src="/usr/share/doc/packages/yast2-devtools/images/yast2-mini.png" />
</div>
</body>
</html>
ACC SHELL 2018