Bootloader::Core::GRUBUser Contributed Perl DocumentaBootloader::Core::GRUB(3)NAME
Bootlader::Core::GRUB - GRUB library for bootloader configuration
PREFACE
This package is the GRUB library of the bootloader configuration
SYNOPSIS
use Bootloader::Core::GRUB;
"$obj_ref = Bootloader::Core::GRUB->new ();"
"$unquoted = Bootloader::Core::GRUB->Unquote ($text);"
"$quoted = Bootloader::Core::GRUB->Quote ($text, $when);"
"$unix_dev = Bootloader::Core::GRUB->GrubDev2UnixDev ($grub_dev);"
"$grub_dev = Bootloader::Core::GRUB->UnixDev2GrubDev ($unix_dev);"
"$unix_path = Bootloader::Core::GRUB->GrubPath2UnixPath ($grub_path,
$grub_dev_prefix);"
"$grub_path = Bootloader::Core::GRUB->UnixPath2GrubPath ($unix_path,
$grub_dev_prefix);"
"$grub_conf_line_ref = Bootloader::Core::GRUB->CreateGrubConfLine
($target, $discswitch);"
"$files_ref = Bootloader::Core::GRUB->ListFiles ();"
"$status = Bootloader::Core::GRUB->ParseLines (\%files,
$avoid_reading_device_map);"
"$files_ref = Bootloader::Core::GRUB->CreateLines ();"
"$dev = Bootloader::Core::GRUB->GetCommonDevice (@paths);"
"$line = Bootloader::Core::GRUB->CreateKernelLine (\%sectingo,
$grub_root);"
"$line = Bootloader::Core::GRUB->CreateChainloaderLine (\%sectinfo,
$grub_root);"
"$disk = Bootloader::Core::GRUB->Partition2Disk ($partition);"
"$sectin_info_ref = Bootloader::Core::GRUB->Section2Info
(\@section_lines);"
"$lines_ref = Bootloader::Core::GRUB->Info2Section (\%section_info);"
"$glob_info = $Bootloader::Core::GRUB->Global2Info (\@glob_lines,
\@section_names);"
"$lines_ref = Bootloader::Core::GRUB->Info2Global (\%section_info,
\@section_names);"
"$settings_ref = Bootloader::Core::GRUB->GetSettings ();"
"$status = Bootloader::Core::GRUB->SetSettings (\%settings);"
"$status = Bootloader::Core::GRUB->InitializeBootloader ();"
"$mountpoint = Bootloader::Core::GRUB->GrubDev2MountPoint ($grub_dev);"
DESCRIPTION
"$obj_ref = Bootloader::Core::GRUB->new ();"
Creates an instance of the Bootloader::Core::GRUB class.
"$unquoted = Bootloader::Core::GRUB->Unquote ($text);"
Just override of Bootloader::Core->Unquote function, returning the
first parameter.
"$quoted = Bootloader::Core::GRUB->Quote ($text, $when);"
Just override of Bootloader::Core->Quote function, returning the
first parameter.
"$allow_afterline_empty = Bootloader::Core->AllowCommentAfterText();"
checks if bootloader configuration allow comments after text on line,
returns a scalar (1 if true, 0 otherwise).
"$unix_dev = Bootloader::Core::GRUB->GrubDev2UnixDev ($grub_dev);"
Translates the GRUB device (eg. '(hd0,0)') to UNIX device (eg.
'/dev/hda1'). As argument takes the GRUB device, returns the UNIX
device (both strings) or argument if translate fail.
"$grub_dev = Bootloader::Core::GRUB->UnixDev2GrubDev ($unix_dev);"
Translates the UNIX device (eg. '/dev/hda1') to GRUB device (eg.
'(hd0,0)'). As argument takes the UNIX device, returns the GRUB
device (both strings).
"$unix_path = Bootloader::Core::GRUB->GrubPath2UnixPath ($grub_path,
$grub_dev_prefix);"
Translates the GRUB path (eg. '(hd0,0)/grub/device.map') to UNIX path
(eg. '/boot/grub/device.map'). If the GRUB path does not contain the
device, the one specified in the argument is used instead. As
arguments, the function takes the GRUB path and the device to be used
if not specified in the GRUB path, and returns the UNIX path (all
strings).
"$grub_path = Bootloader::Core::GRUB->UnixPath2GrubPath ($unix_path,
$grub_dev_prefix);"
Translates the UNIX path (eg. '/boot/grub/device.map') to GRUB path
(eg. '(hd0,0)/grub/device.map'). If the device (as specified in GRUB
configuration files via the 'root' option) is the same as the device
in the resulting path, the resulting path does not contain the
device. As arguments, the function takes the UNIX path and the
device as specified via 'root' option, and returns the GRUB path (all
strings).
"$grub_conf_line_ref = Bootloader::Core::GRUB->CreateGrubConfLine
($target, $discswitch);"
Creates a hash representing a line of /etc/grub.conf file. As
arguments, it takes the device to install GRUB to, and the discswitch
argument ('d' or ''). Returns a reference to a hash containing info
about the 'install' line.
"$files_ref = Bootloader::Core::GRUB->ListFiles ();"
Returns the list of the configuration files of the bootloader Returns
undef on fail
"$status = Bootloader::Core::GRUB->ParseLines (\%files,
$avoid_reading_device_map);"
Parses the contents of all files and stores the settings in the
internal structures. As first argument, it takes a hash reference,
where keys are file names and values are references to lists, each
member is one line of the file. As second argument, it takes a
boolean flag that, if set to a true value, causes it to skip updating
the internal device_map information. Returns undef on fail, defined
nonzero value on success.
"$files_ref = Bootloader::Core::GRUB->CreateLines ();"
creates contents of all files from the internal structures. Returns
a hash reference in the same format as argument of ParseLines on
success, or undef on fail.
"$sectin_info_ref = Bootloader::Core::GRUB->Section2Info
(\@section_lines);"
Gets the information about the section. As argument, takes a
reference to the list of lines building the section, returns a
reference to a hash containing information about the section.
"$dev = Bootloader::Core::GRUB->GetCommonDevice (@paths);"
Checks all paths given as arguments if they are on the same device.
If so, returns the common device, otherwise returns empty string.
"$line = Bootloader::Core::GRUB->CreateKernelLine (\%sectingo,
$grub_root);"
Creates a line with the kernel command for GRUB's menu.lst. As
arguments. it takes a hash containing information about the section
and the root device specified by the GRUB's root command. Returns the
line to be written to menu.lst (without the leading kernel keyword).
"$line = Bootloader::Core::GRUB->CreateChainloaderLine (\%sectinfo,
$grub_root);"
Creates a line with the chainloader command for GRUB's menu.lst. As
arguments. it takes a hash containing information about the section
and the root device specified by the GRUB's root command. Returns the
line to be written to menu.lst (without the leading chainloader
keyword).
"$disk = Bootloader::Core::Grub->Partition2Disk ($partition);"
Gets the disk a partition resides on. As argument, it takes the
partition device node (eg. '/dev/hda3'), returns the device node of
the disk holding the partition (eg. "/dev/hda"), or undef if checking
failed.
"$lines_ref = Bootloader::Core::GRUB->Info2Section (\%section_info);"
Takes the info about the section and uses it to construct the list of
lines. The info about the section also contains the original lines.
As parameter, takes the section info (reference to a hash), returns
the lines (a list of hashes).
"$glob_info = $Bootloader::Core::GRUB->Global2Info (\@glob_lines,
\@section_names);"
Gets the general information from the global section of the menu
file. This information usually means the default section, graphical
menu, timeout etc. As argument it takes a reference to the list of
hashes representing lines of the section, returns a reference to a
hash containing the important information.
"$lines_ref = Bootloader::Core::GRUB->Info2Global (\%section_info,
\@section_names);"
Takes the info about the global options and uses it to construct the
list of lines. The info about global option also contains the
original lines. As parameter, takes the section info (reference to a
hash) and a list of sectino names, returns the lines (a list of
hashes).
"$settings_ref = Bootloader::Core::GRUB->GetSettings ();"
returns the complete settings in a hash. Does not read the settings
from the system, but returns internal structures.
"$status = Bootloader::Core::GRUB->SetSettings (\%settings);"
Stores the settings in the given parameter to the internal
structures. Does not touch the system. Returns undef on fail,
defined nonzero value on success.
"$status = Bootloader::Core::GRUB->InitializeBootloader ();"
Initializes the firmware to boot the bootloader. Returns undef on
fail, defined nonzero value otherwise
"$mountpoint = Bootloader::Core::GRUB->GrubDev2MountPoint ();"
creates the mountpoint from a Grub Device (hdX,Y), be it a udev
device, a udev link or a device mapper device
returns the mountpoint or the grub device, if it couldn't be resolved
POD ERRORS
Hey! The above document had some coding errors, which are explained
below:
Around line 679:
=cut found outside a pod block. Skipping to next block.
Around line 685:
=cut found outside a pod block. Skipping to next block.
perl v5.10.0 2013-03-28 Bootloader::Core::GRUB(3)