|
<?php defined('SYSPATH') or die('No direct script access.');
|
|
/*
|
|
* This file is part of open source system FreenetIS
|
|
* and it is released under GPLv3 licence.
|
|
*
|
|
* More info about licence can be found:
|
|
* http://www.gnu.org/licenses/gpl-3.0.html
|
|
*
|
|
* More info about project can be found:
|
|
* http://www.freenetis.org/
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* SNMP driver for HP switches (tested on HP5800).
|
|
* This class MUST not be initialized directly, use Snmp_Factory!
|
|
*
|
|
* @author Michal Kliment
|
|
* @see Abstract_Snmp
|
|
*/
|
|
class HP_Snmp extends Abstract_Snmp
|
|
{
|
|
|
|
/**
|
|
* Checks if the driver is compactible with the driver.
|
|
*
|
|
* @param string $device_ip Device IP address
|
|
* @return bool Is compactible?
|
|
*/
|
|
public function isCompactibleDriverWith($device_ip)
|
|
{
|
|
if (!valid::ip($device_ip))
|
|
{
|
|
throw new InvalidArgumentException('Wrong IP address of the device');
|
|
}
|
|
|
|
try
|
|
{
|
|
$this->startErrorHandler();
|
|
snmp_set_valueretrieval(SNMP_VALUE_PLAIN);
|
|
$row = snmp2_get(
|
|
$device_ip, $this->comunity, 'iso.3.6.1.2.1.1.1.0',
|
|
$this->timeout, $this->retries
|
|
);
|
|
$this->stopErrorHandler();
|
|
}
|
|
catch (Exception $e)
|
|
{
|
|
return FALSE;
|
|
}
|
|
|
|
return (text::starts_with($row, 'HP '));
|
|
}
|
|
|
|
/**
|
|
* Obtain MAC address of a device with the given IP address from ARP table.
|
|
*
|
|
* @param string $device_ip IP address of the device (we would like to know his MAC)
|
|
* @return string MAC address in format xx:xx:xx:xx:xx:xx
|
|
* @throws Exception On SNMP error or wrong SNMP response
|
|
* @throws InvalidArgumentException On wrong IP address
|
|
*/
|
|
public function getARPMacAddressOf($device_ip)
|
|
{
|
|
if (!valid::ip($device_ip))
|
|
{
|
|
throw new InvalidArgumentException('Wrong IP address of the device');
|
|
}
|
|
|
|
$arp_table = $this->getARPTable();
|
|
|
|
if (array_key_exists($device_ip, $arp_table))
|
|
{
|
|
return $arp_table[$device_ip]->mac_address;
|
|
}
|
|
else
|
|
{
|
|
throw new Exception('Given IP address ' . $device_ip
|
|
. ' not in ARP table on ' . $this->deviceIp);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Obtain MAC address of a device with the given IP address from DHCP server.
|
|
*
|
|
* @param string $device_ip IP address of the device (we would like to know his MAC)
|
|
* @return string MAC address in format xx:xx:xx:xx:xx:xx
|
|
* @throws Exception On SNMP error or wrong SNMP response
|
|
* @throws InvalidArgumentException On wrong IP address
|
|
*/
|
|
public function getDHCPMacAddressOf($device_ip)
|
|
{
|
|
/**
|
|
* @todo Do it :-)
|
|
*/
|
|
throw new DHCPMacAddressException('Not implemented');
|
|
}
|
|
|
|
/**
|
|
* Obtaint port number with given MAC address.
|
|
*
|
|
* @param string $mac_address MAC address of the device (we would like to know to which port is connected)
|
|
* @return string MAC address in format xx:xx:xx:xx:xx:xx
|
|
* @throws Exception On SNMP error or wrong SNMP response
|
|
* @throws InvalidArgumentException On wrong IP address
|
|
*/
|
|
public function getPortNumberOf($mac_address)
|
|
{
|
|
if (!valid::mac_address($mac_address))
|
|
{
|
|
throw new InvalidArgumentException('Wrong MAC address of the device');
|
|
}
|
|
|
|
// covert MAC address to decimal format
|
|
$dec_mac_address = implode('.', array_map('hexdec', explode(":", $mac_address)));
|
|
|
|
// obtain whole MAC table
|
|
$this->startErrorHandler();
|
|
snmp_set_valueretrieval(SNMP_VALUE_PLAIN);
|
|
$arp_table = snmp2_real_walk(
|
|
$this->deviceIp, $this->comunity, 'iso.3.6.1.2.1.17.7.1.2.2.1.2',
|
|
$this->timeout, $this->retries
|
|
);
|
|
$this->stopErrorHandler();
|
|
|
|
// parse result
|
|
$regex = '/INTEGER: ([0-9]+)/';
|
|
$matches = array();
|
|
|
|
// try find MAC address in ARP table
|
|
foreach ($arp_table as $key => $val)
|
|
{
|
|
if (text::ends_with($key, '.' . $dec_mac_address) &&
|
|
preg_match($regex, $val, $matches))
|
|
{
|
|
return $matches[1];
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Obtain names of all network interfaces of device
|
|
*
|
|
* @return array Network interfaces of device
|
|
* @throws Exception On SNMP error or wrong SNMP response
|
|
*/
|
|
public function getIfaces()
|
|
{
|
|
$this->startErrorHandler();
|
|
snmp_set_valueretrieval(SNMP_VALUE_PLAIN);
|
|
$data = snmp2_real_walk(
|
|
$this->deviceIp, $this->comunity,
|
|
'iso.3.6.1.2.1.31.1.1.1.1',
|
|
$this->timeout, $this->retries
|
|
);
|
|
$this->stopErrorHandler();
|
|
|
|
$ifaces = array();
|
|
foreach ($data as $key => $value)
|
|
{
|
|
$oids = explode('.', $key);
|
|
|
|
$iface_id = array_pop($oids);
|
|
|
|
$ifaces[$iface_id] = $value;
|
|
}
|
|
|
|
return $ifaces;
|
|
}
|
|
|
|
/**
|
|
* Obtain current state of device's ports
|
|
*
|
|
* @return array Current states of all ports
|
|
* @throws Exception On SNMP error or wrong SNMP response
|
|
*/
|
|
public function getPortStates()
|
|
{
|
|
$this->startErrorHandler();
|
|
snmp_set_valueretrieval(SNMP_VALUE_PLAIN);
|
|
$port_states = snmp2_real_walk(
|
|
$this->deviceIp, $this->comunity,
|
|
'iso.3.6.1.2.1.2.2.1.8',
|
|
$this->timeout, $this->retries
|
|
);
|
|
$this->stopErrorHandler();
|
|
|
|
$states = array();
|
|
foreach ($port_states as $key => $value)
|
|
{
|
|
$pieces = explode('.', $key);
|
|
|
|
$port_nr = array_pop($pieces);
|
|
|
|
$states[$port_nr] = $value == 1 ? 1 : 0;
|
|
}
|
|
|
|
return $states;
|
|
}
|
|
|
|
/**
|
|
* Obtain ARP table of device
|
|
*
|
|
* @return array Whole ARP table from device
|
|
* @throws Exception On SNMP error or wrong SNMP response
|
|
*/
|
|
public function getARPTable()
|
|
{
|
|
// obtain whole ARP table
|
|
$this->startErrorHandler();
|
|
snmp_set_valueretrieval(SNMP_VALUE_PLAIN);
|
|
$arp_table = snmp2_real_walk(
|
|
$this->deviceIp, $this->comunity,
|
|
'iso.3.6.1.2.1.3.1.1',
|
|
$this->timeout, $this->retries
|
|
);
|
|
$this->stopErrorHandler();
|
|
|
|
$ifaces = self::getIfaces();
|
|
|
|
$items = array();
|
|
foreach ($arp_table as $key => $value)
|
|
{
|
|
$pieces = explode('.', $key);
|
|
|
|
$i = implode('.', array_slice($pieces, -4));
|
|
|
|
if (!array_key_exists($i, $items))
|
|
$items[$i] = new stdClass ();
|
|
|
|
switch ($pieces[9])
|
|
{
|
|
case '1':
|
|
$items[$i]->iface_name = $ifaces[$value];
|
|
break;
|
|
|
|
case '2':
|
|
$items[$i]->mac_address = network::bin2mac($value);
|
|
break;
|
|
|
|
case '3':
|
|
$items[$i]->ip_address = $value;
|
|
break;
|
|
}
|
|
}
|
|
|
|
return $items;
|
|
}
|
|
|
|
/**
|
|
* Obtain DHCP leases of device
|
|
*
|
|
* @return array All DHCP leases
|
|
* @throws Exception On SNMP error or wrong SNMP response
|
|
*/
|
|
public function getDHCPLeases()
|
|
{
|
|
return array();
|
|
}
|
|
|
|
/**
|
|
* Obtain device's hostname from DHCP leases of device
|
|
*
|
|
* @param string $device_ip IP address to which we will search for hostname
|
|
* @return string Hostname for given IP address
|
|
* @throws Exception On SNMP error or wrong SNMP response
|
|
* @throws InvalidArgumentException On wrong IP address
|
|
*/
|
|
public function getDHCPHostnameOf($device_ip)
|
|
{
|
|
return FALSE;
|
|
}
|
|
|
|
/**
|
|
* Obtain wireless info of device
|
|
*
|
|
* @return array Current wireless info
|
|
* @throws Exception On SNMP error or wrong SNMP response
|
|
*/
|
|
public function getWirelessInfo()
|
|
{
|
|
return array();
|
|
}
|
|
|
|
/**
|
|
* Obtain MAC table from device
|
|
*
|
|
* @return array Whole MAC table
|
|
* @throws Exception On SNMP error or wrong SNMP response
|
|
*/
|
|
public function getMacTable()
|
|
{
|
|
// obtain whole ARP table
|
|
$this->startErrorHandler();
|
|
snmp_set_valueretrieval(SNMP_VALUE_PLAIN);
|
|
$arp_table = snmp2_real_walk(
|
|
$this->deviceIp, $this->comunity, 'iso.3.6.1.2.1.17.7.1.2.2.1.2',
|
|
$this->timeout, $this->retries
|
|
);
|
|
$this->stopErrorHandler();
|
|
|
|
$items = array();
|
|
foreach ($arp_table as $key => $value)
|
|
{
|
|
$pieces = explode('.', $key);
|
|
|
|
$item = new stdClass();
|
|
|
|
$item->port_nr = $value;
|
|
|
|
$i = implode('.', array_slice($pieces, -6));
|
|
|
|
$item->mac_address = network::dec2mac($i);
|
|
|
|
$items[$i] = $item;
|
|
$ports[$i] = $value;
|
|
}
|
|
|
|
array_multisort($ports, $items);
|
|
|
|
return $items;
|
|
}
|
|
}
|