Help-Site Computer Manuals
Software
Hardware
Programming
Networking
  Algorithms & Data Structures   Programming Languages   Revision Control
  Protocols
  Cameras   Computers   Displays   Keyboards & Mice   Motherboards   Networking   Printers & Scanners   Storage
  Windows   Linux & Unix   Mac

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

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



NAME

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


SYNOPSIS


  use Solaris::DeviceTree::PathToInst;

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

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

  $root = $node->root_node;

  $path = $node->devfs_path;

  $nodename = $node->node_name;

  $busaddr = $node->bus_addr;

  $instance = $node->instance;

  $drivername = $node->driver_name;


DESCRIPTION

This module implements the the Solaris::DeviceTree::Node manpage interface and allows access to the Solaris driver configuration file /etc/path_to_inst via a hierarchical tree structure. The API of this class overwrites methods from the base class applicable to this context.

A line in the path_to_inst looks like this:


  "<devfs_path>" <instance> "<driver_name>"

The devfs_path is build out of the components


  <node_name>@<bus_addr>/<node_name>@<bus_addr>/...

and it is split at the / to build the node hierarchy.


METHODS

The following methods are available:

new

The constructor takes an optional named option filename to a location of a path_to_inst file and returns a reference to the root node object. If no filename is given the file from the running system at /etc/path_to_inst is used.

root_node

Returns the root node of the tree.

devfs_path

Returns the physical path assocatiated with this node.

node_name

Returns the name of the node. The value is derived from the devfs_path path. It is undefined for the root node and guaranteed to be defined for all other nodes.

driver_name

Returns the driver name for the 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.

instance

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


AUTHOR

Copyright 1999-2003 Dagobert Michelsen.


SEE ALSO

the Solaris::DeviceTree manpage, the Solaris::DeviceTree::Node manpage, path_to_inst(4).

Programminig
Wy
Wy
yW
Wy
Programming
Wy
Wy
Wy
Wy