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.