snmp::info::entity(3pm) [debian man page]

Info::Entity(3pm)					User Contributed Perl Documentation					 Info::Entity(3pm)

NAME

       SNMP::Info::Entity - SNMP Interface to data stored in ENTITY-MIB. RFC 2737

AUTHOR

       Max Baker

SYNOPSIS

	# Let SNMP::Info determine the correct subclass for you.
	my $entity = new SNMP::Info(
				 AutoSpecify => 1,
				 Debug	     => 1,
				 DestHost    => 'myswitch',
				 Community   => 'public',
				 Version     => 2
			       )
	   or die "Can't connect to DestHost.
";

	my $class      = $entity->class();
	print "SNMP::Info determined this device to fall under subclass : $class
";

DESCRIPTION

       ENTITY-MIB is used by Layer 2 devices from HP, Aironet, Foundry, Cisco, and more.

       See RFC 2737 for full details.

       Create or use a device subclass that inherit this class.  Do not use directly.

       For debugging purposes you can call this class directly as you would SNMP::Info

	my $entity = new SNMP::Info::Entity (...);

   Inherited Classes
       none.

   Required MIBs
       ENTITY-MIB

       MIBs can be found at ftp://ftp.cisco.com/pub/mibs/v2/v2.tar.gz

GLOBALS

       none.

TABLE METHODS

       These are methods that return tables of information in the form of a reference to a hash.

   Entity Table
       $entity->e_index()
	   Index

	   ("entPhysicalIndex")

       $entity->e_alias()
	   Human entered, not usually used.

	   ("entPhysicalAlias")

       $entity->e_class()
	   Stack, Module, Container, Port ...

	   ("entPhysicalClass")

       $entity->e_descr()
	   Human Friendly

	   ("entPhysicalClass")

       $entity->e_fwver()
	   ("entPhysicalFirmwareRev")

       $entity->e_fru()
	   BOOLEAN. Field Replaceable unit?

	   ("entPhysicalFRU")

       $entity->e_hwver()
	   ("entPhysicalHardwareRev")

       $entity->e_id()
	   This is human entered and not normally used.

	   ("entPhysicalAssetID")

       $entity->e_map()
	   See MIB.

	   ("entAliasMappingIdentifier")

       $entity->e_model()
	   Model Name of Entity.

	   ("entPhysicalModelName")

       $entity->e_name()
	   More computer friendly name of entity.  Parse me.

	   ("entPhysicalName")

       $entity->e_parent()
	   0 if root.

	   ("entPhysicalContainedIn")

       $entity->e_port()
	   Maps Entity Table entries to the Interface Table ("IfTable") using $entity->e_map()

       $entity->e_pos()
	   The relative position among all entities sharing the same parent.

	   ("entPhysicalParentRelPos")

       $entity->e_serial()
	   ("entPhysicalSerialNum")

       $entity->e_swver()
	   ("entPhysicalSoftwareRev")

       $entity->e_type()
	   This is an OID, which gets munged into the object name if the right MIB is loaded.

	   ("entPhysicalVendorType")

       $entity->e_vendor()
	   Vendor of Module.

	   ("entPhysicalMfgName")

perl v5.12.4							    2011-09-28							 Info::Entity(3pm)

Info::Layer3::Contivity(3pm)				User Contributed Perl Documentation			      Info::Layer3::Contivity(3pm)

NAME

       SNMP::Info::Layer3::Contivity - SNMP Interface to Nortel VPN Routers (Contivity Extranet Switches).

AUTHOR

       Eric Miller

SYNOPSIS

	# Let SNMP::Info determine the correct subclass for you.
	my $contivity = new SNMP::Info(
				 AutoSpecify => 1,
				 Debug	     => 1,
				 DestHost    => 'myswitch',
				 Community   => 'public',
				 Version     => 2
			       )
	   or die "Can't connect to DestHost.
";

	my $class = $contivity->class();
	print "SNMP::Info determined this device to fall under subclass : $class
";

DESCRIPTION

       Abstraction subclass for Nortel VPN Routers (Contivity Extranet Switch).

       For speed or debugging purposes you can call the subclass directly, but not after determining a more specific class using the method above.

	my $contivity = new SNMP::Info::Layer3::Contivity(...);

   Inherited Classes
       SNMP::Info
       SNMP::Info::Layer3
       SNMP::Info::Entity

   Required MIBs
       Inherited Classes' MIBs
	   See "Required MIBs" in SNMP::Info for its own MIB requirements.

	   See "Required MIBs" in SNMP::Info::Layer3 for its own MIB requirements.

	   See "Required MIBs" in SNMP::Info::Entity for its own MIB requirements.

GLOBALS

       These are methods that return scalar value from SNMP

       $contivity->vendor()
	   Returns 'Nortel'

       $contivity->model()
	   Returns the chassis name.

	   ("entPhysicalModelName.1")

       $contivity->os()
	   Returns 'CES'

       $contivity->os_ver()
	   Returns the software version extracted from ("sysDescr").

       $contivity->serial()
	   Returns the chassis serial number.

	   ("entPhysicalSerialNum.1")

       $contivity->mac()
	   Returns the MAC address of the first Ethernet Interface.

   Overrides
       $contivity->layers()
	   Returns 00000100.  Contivity does not support bridge MIB, so override reported layers.

   Globals imported from SNMP::Info
       See documentation in "GLOBALS" in SNMP::Info for details.

   Globals imported from SNMP::Info::Layer3
       See documentation in "GLOBALS" in SNMP::Info::Layer3 for details.

   Globals imported from SNMP::Info::Entity
       See documentation in "GLOBALS" in SNMP::Info::Entity for details.

TABLE METHODS

       These are methods that return tables of information in the form of a reference to a hash.

   Overrides
       $contivity->interfaces()
	   Returns reference to the map between IID and physical Port.	Skips loopback and tunnel interfaces.

       $contivity->i_name()
	   Interface Name field.  Skips loopback and tunnel interfaces.

   Table Methods imported from SNMP::Info
       See documentation in "TABLE METHODS" in SNMP::Info for details.

   Table Methods imported from SNMP::Info::Layer3
       See documentation in "TABLE METHODS" in SNMP::Info::Layer3 for details.

   Table Methods imported from SNMP::Info::Entity
       See documentation in "TABLE METHODS" in SNMP::Info::Entity for details.

perl v5.12.4							    2011-09-28					      Info::Layer3::Contivity(3pm)