Files
librenms-librenms/LibreNMS/Modules/Stp.php
Tony Murray d8c372bbf4 Refactor MAC utilities into a single class (#15379)
* Refactor MAC utils to a new utility class

* Apply fixes from StyleCI

* Inline functions
Add tests
Handle bridgeid format

* Apply fixes from StyleCI

* Dedicated code path for stp bridge parsing, and improve STP output a bit

* Correctly parse dot1dBaseBridgeAddress and don't store int in bool field

* trim any unexpected character from bridge addresses, add extra test data.

* better comment

* barsBridge can handle dot1dBaseBridgeAddress correctly now

* parseBridge, check for properly formatted mac first.

* update test data, empty data = empty mac

* Fix new usage after rebase

* import

---------

Co-authored-by: StyleCI Bot <bot@styleci.io>
2023-10-06 07:34:14 -05:00

113 lines
3.3 KiB
PHP

<?php
/*
* Stp.php
*
* Spanning Tree
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* @package LibreNMS
* @link http://librenms.org
* @copyright 2021 Tony Murray
* @author Tony Murray <murraytony@gmail.com>
*/
namespace LibreNMS\Modules;
use App\Models\Device;
use App\Models\PortStp;
use App\Observers\ModuleModelObserver;
use LibreNMS\DB\SyncsModels;
use LibreNMS\Interfaces\Data\DataStorageInterface;
use LibreNMS\Interfaces\Module;
use LibreNMS\OS;
use LibreNMS\Polling\ModuleStatus;
class Stp implements Module
{
use SyncsModels;
/**
* @inheritDoc
*/
public function dependencies(): array
{
return ['ports', 'vlans'];
}
public function shouldDiscover(OS $os, ModuleStatus $status): bool
{
return $status->isEnabled() && ! $os->getDevice()->snmp_disable && $os->getDevice()->status;
}
public function discover(OS $os): void
{
$device = $os->getDevice();
$instances = $os->discoverStpInstances();
echo 'Instances: ';
ModuleModelObserver::observe(\App\Models\Stp::class);
$this->syncModels($device, 'stpInstances', $instances);
$ports = $os->discoverStpPorts($instances);
echo "\nPorts: ";
ModuleModelObserver::observe(PortStp::class);
$this->syncModels($device, 'stpPorts', $ports);
echo PHP_EOL;
}
public function shouldPoll(OS $os, ModuleStatus $status): bool
{
return $status->isEnabled() && ! $os->getDevice()->snmp_disable && $os->getDevice()->status;
}
public function poll(OS $os, DataStorageInterface $datastore): void
{
$device = $os->getDevice();
echo 'Instances: ';
$instances = $device->stpInstances;
$instances = $os->pollStpInstances($instances);
ModuleModelObserver::observe(\App\Models\Stp::class);
$this->syncModels($device, 'stpInstances', $instances);
echo "\nPorts: ";
$ports = $device->stpPorts;
ModuleModelObserver::observe(PortStp::class);
$this->syncModels($device, 'stpPorts', $ports);
}
public function cleanup(Device $device): void
{
$device->stpInstances()->delete();
$device->stpPorts()->delete();
}
/**
* @inheritDoc
*/
public function dump(Device $device)
{
return [
'stp' => $device->stpInstances()->orderBy('bridgeAddress')
->get()->map->makeHidden(['stp_id', 'device_id']),
'ports_stp' => $device->portsStp()->orderBy('port_index')
->leftJoin('ports', 'ports_stp.port_id', 'ports.port_id')
->select(['ports_stp.*', 'ifIndex'])
->get()->map->makeHidden(['port_stp_id', 'device_id', 'port_id']),
];
}
}