NAME

Solaris::DeviceTree::OBP - Utility functions for OBP access

SYNOPSIS

Value access:

$tree = Solaris::DeviceTree::Libdevinfo->new;

$aliases = obp_aliases($tree);
my $disk = $aliases->{'disk'};
$chosen_boot_device = obp_chosen_boot_device($tree);
@boot_devices = obp_boot_devices($tree);
@diag_devices = obp_diag_devices($tree);

Path transformation:

$resolved_path = obp_resolve_path( aliases => $aliases, path => "disk:c" );

DESCRIPTION

The Solaris::DeviceTree::OBP module implements functions for manipulating OBP pathes according to IEEE 1275. For most of the functions you need to specify a devicetree containing PROM property nodes, which are most likely to find in an Solaris::DeviceTree::Libdevinfo tree.

EXPORT

The following functions are exported on demand:

obp_resolve_path

This functions transforms the specified path in an alias-free path using the path resolution procedure described in 1275.pdf - 4.3.1 Path resolution procedure according to the specified reference to an alias mapping.

aliases

This method returns a reference to a hash which maps all aliases to their corresponding values.

obp_chosen_boot_device

This method returns the device from which the system has most recently booted.

obp_boot_devices

This method returns a list with all boot devices entered in the OBP.

obp_diag_devices

This method returns a list with all diag devices entered in the OBP.

The following export tags are defined:

boot
L</obp_chosen_boot_device>, L</obp_boot_devices>, L</obp_diag_devices>.
alias
L</obp_aliases>.
path
L</obp_resolve_path>.

EXAMPLES

In the following example the resolved physical pathname of the device last booted from is printed:

use Solaris::DeviceTree::OBP;
use Solaris::DeviceTree::Libdevinfo;
my $tree = Solaris::DeviceTree::Libdevinfo->new;
$bootpath = $tree->find_prop( devfs_path => "/chosen", prom_prop_name => "bootpath" );
$resolved_path = obp_resolve_path( aliases => $tree->aliases, path => $bootpath->string );
print "Last boot from $resolved_path\n";

AUTHOR

Dagobert Michelsen, <dam@baltic-online.de>

SEE ALSO

Open Firmware Homepage http://playground.sun.com/1275/home.html, eeprom(1m).

1 POD Error

The following errors were encountered while parsing the POD:

Around line 236:

=back doesn't take any parameters, but you said =back 4