NAME
   Net::SNMP::Mixin::IpCidrRouteTable - mixin class for the mib-II
   ipCidrRouteTable

VERSION
   Version 0.03

SYNOPSIS
     use Net::SNMP;
     use Net::SNMP::Mixin;

     #...

     my $session = Net::SNMP->session( -hostname => 'foo.bar.com' );

     $session->mixer('Net::SNMP::Mixin::IpCidrRouteTable');
     $session->init_mixins;
     snmp_dispatcher();

     die $session->errors if $session->errors;

     my @routes = get_ip_cidr_route_table();

     foreach my $route (@routes) {
         my $dest     = $route->{ipCidrRouteDest};
         my $mask     = $route->{ipCidrRouteMask};
         my $tos      = $route->{ipCidrRouteTos};
         my $next_hop = $route->{ipCidrRouteNextHop};
         my $if_index = $route->{ipCidrRouteIfIndex};

         print "$dest/$mask/$tos/$next_hop => $if_index/$next_hop\n";
     }

DESCRIPTION
   A Net::SNMP mixin class for mib-II ipCidrRouteTable info.

MIXIN METHODS
 OBJ->get_ip_cidr_route_table()
   Returns a sorted list of mib-II ipCidrRouteTable entries. Every list
   element (route entry) is a hashref with the following fields and values:

       {
           ipCidrRouteDest         => IpAddress,           # tbl index
           ipCidrRouteMask         => IpAddress,           # tbl index
           ipCidrRouteTos          => Integer32,           # tbl index
           ipCidrRouteNextHop      => IpAddress,           # tbl index
           ipCidrRouteIfIndex      => Integer32,
           ipCidrRouteType         => INTEGER,
           ipCidrRouteTypeString   => String,              # resolved enum
           ipCidrRouteProto        => INTEGER,
           ipCidrRouteProtoString  => String,              # resolved enum
           ipCidrRouteAge          => Integer32,
           ipCidrRouteInfo         => OBJECT IDENTIFIER,
           ipCidrRouteNextHopAS    => Integer32,
           ipCidrRouteMetric1      => Integer32,
           ipCidrRouteMetric2      => Integer32,
           ipCidrRouteMetric3      => Integer32,
           ipCidrRouteMetric4      => Integer32,
           ipCidrRouteMetric5      => Integer32,
           ipCidrRouteStatus       => RowStatus,
           ipCidrRouteStatusString => String,              # resolved enum
       }

INITIALIZATION
 OBJ->_init($reload)
   Fetch the mib-II ipCidrRouteTable from the host. Don't call this method
   direct!

PRIVATE METHODS
   Only for developers or maintainers.

 _fetch_ip_cidr_route_tbl($session)
   Fetch the ipCidrRouteTable once during object initialization.

 _ip_cidr_route_tbl_cb($session)
   The callback for _fetch_ip_cidr_route_tbl().

SEE ALSO
   Net::SNMP::Mixin

REQUIREMENTS
   Net::SNMP, Net::SNMP::Mixin

BUGS, PATCHES & FIXES
   There are no known bugs at the time of this release. However, if you
   spot a bug or are experiencing difficulties that are not explained
   within the POD documentation, please submit a bug to the RT system (see
   link below). However, it would help greatly if you are able to pinpoint
   problems or even supply a patch.

   Fixes are dependant upon their severity and my availablity. Should a fix
   not be forthcoming, please feel free to (politely) remind me by sending
   an email to [email protected] .

     RT: http://rt.cpan.org/Public/Dist/Display.html?Name=Net-SNMP-Mixin-IpCidrRouteTable

AUTHOR
   Karl Gaissmaier <karl.gaissmaier at uni-ulm.de>

COPYRIGHT & LICENSE
   Copyright 2011 Karl Gaissmaier, all rights reserved.

   This program is free software; you can redistribute it and/or modify it
   under the same terms as Perl itself.