getsub(1Msnmp)

getsub -- extract routing information from SNMP entity

Synopsis

getsub entity_addr community_string [ partial.IP.address ]

Description

getsub is an SNMP application that retrieves routing information from an entity by traversing the ipRouteDest, ipRouteIfIndex, ipRouteMetric1, ipRouteNextHop, ipRouteType, and ipRouteProto variable classes for ach subnet found. It takes as arguments the address of the SNMP entity, a community string to provide access to that entity, and, optionally, a net or subnet address qualifier. Only those portions of the routing table which match the net or subnet address qualifier are retrieved. For example, if one were to enter:

getsub myagent top-secret 192.244

getsub would retrieve all entries beginning with 192.244. Similarly,

getsub myagent top-secret 128.139.4

would retrieve all entries beginning with 128.139.4. Finally,

getsub myagent top-secret

would retrieve the entire routing table.

References

getid(1Msnmp), getmany(1Msnmp), getmet(1Msnmp), getnext(1Msnmp), getone(1Msnmp), getroute(1Msnmp), setany(1Msnmp), snmpd(1Msnmp), snmpd.conf(4snmp), snmpd.comm(4snmp), snmpd.peers(4snmp), snmpd.trap(4snmp), snmpstat(1Msnmp), trap_rece(1Msnmp), trap_send(1Msnmp)

RFC 1155 (STD 16), RFC 1156, RFC 1157 (STD 15), RFC 1213 (STD 17)