NAME

Solaris::DeviceTree::PathToInst - Perl interface to /etc/path_to_inst

SYNOPSIS

use Solaris::DeviceTree::PathToInst;
$node = new Solaris::DeviceTree::PathToInst;
@children = $node->child_nodes;

DESCRIPTION

The Solaris::DeviceTree::PathToInst module implements access to the Solaris driver configuration file /etc/path_to_inst via a hierarchical tree structure. The API of this class contains all methods from the Solaris::DeviceTree applicable to this context.

METHODS

The following methods are available:

$node = new Solaris::DeviceTree::PathToInst;

$node = new Solaris::DeviceTree::PathToInst( filename => '/a/etc/path_to_inst' );

The constructor takes a location of a path_to_inst file as data source and returns a reference to the root node object. If no path_to_inst file is given the file from the running system at /etc/path_to_inst is read.

$path = $node->devfs_path

Returns the physical path assocatiated with this node.

$nodename = $node->node_name;

Returns the name of the node. The value is used to build the physical path. It is undefined for the root node and defined for all other nodes.

$bindingname = $node->binding_name;

Returns the binding name of the driver for the node.

$drivername = $node->driver_name;

Returns the driver name for the node.

$busaddr = $node->bus_addr;

Returns the address on the bus for this node. undef is returned if a bus address has not been assigned to the device. A zero-length string may be returned and is considered a valid bus address.

$inst = $node->instance;

Returns the instance number for this node of the bound driver. undef is returned if no instance number has been assigned.

IMPLEMENTATION DETAILS

Because the methods are all read-only the object is implemented as singleton and the same reference gets returned every time.

BUGS

* The singleton implementation keeps only one instance of
  this class. If multiple calls to the constructor are issued
  with different filenames the returned values are always from
  the path_to_inst initially specified.

EXAMPLES

AUTHOR

Copyright 1999-2003 Dagobert Michelsen.

SEE ALSO

* L<path_to_inst (4)>