Info::Layer3::Pf(3p)

NAME
SNMP::Info::Layer3::Pf - SNMP Interface to FreeBSD-Based Firewalls using Pf /Pf Sense

AUTHOR
Max Baker

SYNOPSIS
 # Let SNMP::Info determine the correct subclass for you.
 my $pf = new SNMP::Info(
                        AutoSpecify => 1,
                        Debug       => 1,
                        # These arguments are passed directly to SNMP::Session
                        DestHost    => 'myswitch',
                        Community   => 'public',
                        Version     => 2
                        )
    or die "Can't connect to DestHost.\n";

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

DESCRIPTION
Subclass for Free-BSD PF-Based devices

LLDP Support
LLDP Support is included but untested in this Device Class. It is reported that the available CDP/LLDP modules for net-snmp don't work on FreeBSD (on which pfSense is based) as they assume certain Linux specific Ethernet structures. This problem is apparently solved on PF based firewall appliances by using the ladvd package, for which a port may be found here: <http://www.freshports.org/net/ladvd/>. I'm not sure if this module ties into Net-SNMP or not.

  Inherited Classes

SNMP::Info::Layer3
SNMP::Info::LLDP

  Required MIBs

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

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

GLOBALS
These are methods that return scalar values from SNMP

$pf->vendor()
        Returns 'FreeBSD'

$pf->hasCDP()
        Returns whether LLDP is enabled.

$pf->model()
    Grabs the os version from "sysDescr"

$pf->os()
    Returns 'Pf'

$pf->os_ver()
    Tries to reference $pf->id() to one of the product MIBs listed above. Will probably return a truncation of the default OID for pf-based systems "enterprises.12325.1.1.2.1.1".

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

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

$pf->c_id()
    Returns LLDP information.

$pf->c_if()
    Returns LLDP information.

$pf->c_ip()
    Returns LLDP information.

$pf->c_platform()
    Returns LLDP information.

$pf->c_port()
    Returns LLDP information.

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

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