SNMP Tunnel MIB

SNMP MIB support for RFC-4087 SNMP IP Tunnel MIB and RFC-2863 IF-MIB.

TunnelIfTable

MIB Object Description Supported (Yes/No)

tunnelIfEntry

OID: 1.3.6.1.2.1.10.131.1.1.1.1

An entry (conceptual row) containing the information on a particular configured tunnel. Yes

tunnelIfLocalAddress

OID: 1.3.6.1.2.1.10.131.1.1.1.1.1

The address of the local endpoint of the tunnel that is, the source address used in the outer IP header), or 0.0.0.0 if unknown or if the tunnel is over IPv6.

Since this object does not support IPv6, it is deprecated in favor of tunnelIfLocalInetAddress.

No

tunnelIfRemoteAddress

OID: 1.3.6.1.2.1.10.131.1.1.1.1.2

The address of the remote endpoint of the tunnel that is, the destination address used in the outer IP header), or 0.0.0.0 if unknown, or an IPv6 address, or the tunnel is not a point-to-point link (e.g., if it is a 6to4 tunnel).

Since this object does not support IPv6, it is deprecated in favor of tunnelIfRemoteInetAddress.

No

tunnelIfEncapsMethod

OID: 1.3.6.1.2.1.10.131.1.1.1.1.3

The encapsulation method used by the tunnel .

Integer {

other(1), -- none of the following

direct(2), -- no intermediate header

gre(3), -- GRE encapsulation

minimal(4), -- Minimal encapsulation

l2tp(5), -- L2TP encapsulation

pptp(6), -- PPTP encapsulation

l2f(7), -- L2F encapsulation

udp(8), -- UDP encapsulation

atmp(9), -- ATMP encapsulation

msdp(10), -- MSDP encapsulation

sixToFour(11), -- 6to4 encapsulation

sixOverFour(12), -- 6over4 encapsulation

isatap(13), -- ISATAP encapsulation

teredo(14), -- Teredo encapsulation

ipHttps(15), -- IPHTTPS

softwireMesh(16), -- softwire mesh tunnel

dsLite(17) -- DS-Lite tunnel }

Yes

Only GRE is supported.

tunnelIfHopLimit

OID: 1.3.6.1.2.1.10.131.1.1.1.1.4

The IPv4 TTL or IPv6 Hop Limit to use in the outer IP header. A value of 0 indicates that the value is copied from the payload's header. That is of type Integer32 (0...255)

Yes

tunnelIfSecurity

OID: 1.3.6.1.2.1.10.131.1.1.1.1.5

The method used by the tunnel to secure the outer IP header. The value ipsec indicates that IPsec is used between the tunnel endpoints for authentication or encryption or both.

More specific security-related information may be available in a MIB module for the security protocol in use."

INTEGER {

none(1), -- no security

ipsec(2), -- IPsec security

other(3)

}

Yes

tunnelIfTOS

OID : 1.3.6.1.2.1.10.131.1.1.1.1.6

The method used to set the high 6 bits (the differentiated services code point) of the IPv4 TOS or IPv6 Traffic Class in the outer IP header. A value of

-1 indicates that the bits are copied from the payload's header. A value of -2 indicates that a traffic conditioner is invoked and more information may be available in a traffic conditioner MIB module.

A value between 0 and 63 inclusive indicates that the

bit field is set to the indicated value

Integer32 (-2..63)

Yes

tunnelIfFlowLabel

OID :

1.3.6.1.2.1.10.131.1.1.1.1.7

The method used to set the IPv6 Flow Label value.

This object need not be present in rows where tunnelIfAddressType indicates the tunnel is not over IPv6. A value of -1 indicates that a traffic conditioner is invoked and more information may be available in a traffic conditioner MIB. Any other value indicates that the Flow Label field is set to the indicated value.

Integer32 (-1 | 0..1048575)

Yes

tunnelIfAddressType

OID : 1.3.6.1.2.1.10.131.1.1.1.1.8

The type of address in the corresponding

tunnelIfLocalInetAddress and tunnelIfRemoteInetAddress objects.

unknown(0) An unknown address type. This value MUST be used if the value of the corresponding InetAddress object is a zero-length string. It may also be used to indicate an IP address that is not in one of the formats defined below.

ipv4(1) An IPv4 address as defined by the

InetAddressIPv4 textual convention.

ipv6(2) An IPv6 address as defined by the

InetAddressIPv6 textual convention.

ipv4z(3) A non-global IPv4 address including a zone

index as defined by the InetAddressIPv4z

textual convention.

ipv6z(4) A non-global IPv6 address including a zone

index as defined by the InetAddressIPv6z

textual convention.

dns(16) A DNS domain name as defined by the

InetAddressDNS textual convention.

Yes

Supported:

Unknown(0)

Ipv4(1)

tunnelIfLocalInetAddress

OID: 1.3.6.1.2.1.10.131.1.1.1.1.9

The address of the local endpoint of the tunnel(i.e., the source address used in the outer IP header). If the address is unknown, the value is 0.0.0.0 for IPv4 or :: for IPv6. The type of this object is given by tunnelIfAddressType Yes

tunnelIfRemoteInetAddress

OID: 1.3.6.1.2.1.10.131.1.1.1.1.10

The address of the remote endpoint of the tunnel (i.e., the destination address used in the outer IP header). If the address is unknown or the tunnel is

not a point-to-point link (e.g., if it is a 6to4 tunnel), the value is 0.0.0.0 for tunnels over IPv4 or :: for tunnels over IPv6. The type of this object is

given by tunnelIfAddressType.

Yes

tunnelIfEncapsLimit

OID: 1.3.6.1.2.1.10.131.1.1.1.1.11

The maximum number of additional encapsulations permitted for packets undergoing encapsulation at this node. A value of -1 indicates that no limit is present (except as a result of the packet size).

Yes

tunnelInetConfigTable

MIB Object Description Read-Write Supported (Yes/No)
tunnelInetConfigEntry

OID: 1.3.6.1.2.1.10.131.1.1.3.1

An entry (conceptual row) containing the information on a particular configured tunnel. Note that there is a 128 subid maximum for object OIDs. Implementers need to be aware that if the total number of octets in tunnelInetConfigLocalAddress and tunnelInetConfigRemoteAddress exceeds 110 then OIDs of column instances in this table will have more than 128 sub-identifiers and cannot be accessed using SNMPv1, SNMPv2c, or SNMPv3. In practice this is not expected to be a problem since IPv4 and IPv6 addresses will not cause the limit to be reached, but if other types are supported by an agent, care must be taken to ensure that the sum of the lengths do not cause the limit to be exceeded. yes

tunnelInetConfigAddressType

OID: 1.3.6.1.2.1.10.131.1.1.3.1.1

The address type over which the tunnel encapsulates packetsunknown(0),ipv4(1),ipv6(2),ipv4z(3),ipv6z(4),

Yes

(not-accessible)

Supported:unknown(0),ipv4(1)

tunnelInetConfigLocalAddress

OID: 1.3.6.1.2.1.10.131.1.1.3.1. 2

The address of the local endpoint of the tunnel, or 0.0.0.0 (for IPv4) or :: (for IPv6) if the device is free to choose any of its addresses at tunnel establishment time.

Yes

(not-accessible)

tunnelInetConfigRemoteAddress

OID: 1.3.6.1.2.1.10.131.1.1.3.1. 3

The address of the remote endpoint of the tunnel Yes

tunnelInetConfigEncapsMethod

OID: 1.3.6.1.2.1.10.131.1.1.3.1. 4

The encapsulation method used by the tunnel other(1), -- none of the followingdirect (2), -- no intermediate headergre(3), -- GRE encapsulationminimal (4), -- Minimal encapsulationl2tp (5), -- L2TP encapsulationpptp (6), -- PPTP encapsulationl2f (7), -- L2F encapsulationudp (8), -- UDP encapsulationatmp (9), -- ATMP encapsulationmsdp (10), -- MSDP encapsulationsixToFour (11), -- 6to4 encapsulationsixOverFour (12), -- 6over4 encapsulationisatap (13), -- ISATAP encapsulationteredo (14), -- Teredo encapsulationipHttps (15), -- IPHTTPSsoftwireMesh(16), -- softwire mesh tunneldsLite (17) -- DS-Lite tunnel}

Yes

(not-accessible)

Only GRE is supported. For possible future support for MPLS, other(1) will be used.

tunnelInetConfigID

OID: 1.3.6.1.2.1.10.131.1.1.3.1. 5

An identifier used to distinguish between multiple tunnels of the same encapsulation method, with the same endpoints. If the encapsulation protocol only allows one tunnel per set of endpoint addresses (such as for GRE or IP-in-IP), the value of this object is1. For encapsulation methods (such as L2F) which allow multiple parallel tunnels, the manager is responsible for choosing any ID which does not conflict with an existing row, such as choosing a random number.

Yes

(not-accessible)

tunnelInetConfigIfIndex

OID: 1.3.6.1.2.1.10.131.1.1.3.1. 6

If the value of tunnelInetConfigStatus for this row is active, then this object contains the value of ifIndex corresponding to the tunnel interface. A value of 0 is not legal in the active state, and means that the interface index has not yet been assigned.

Yes

tunnelInetConfigStatus

OID: 1.3.6.1.2.1.10.131.1.1.3.1. 7

The status of this row, by which new entries may be created, or old entries deleted from this table.

To create a row in this table for an encapsulation method which does not support multiple parallel tunnels with the same endpoints, the management station should simply use a tunnelInetConfigID of 1, and set tunnelInetConfigStatus to createAndGo. For encapsulation methods such as L2F which allow multiple parallel tunnels, the management station may select a pseudo-random number to use as the tunnelInetConfigID and set tunnelInetConfigStatus to createAndGo. In the event that this ID is already in use and an inconsistentValue is returned in response to the set operation, the management station should simply select a new pseudo-random number and retry the operation.

Creating a row in this table will cause an interface index to be assigned by the agent in an implementation-dependent manner, and corresponding rows will be instantiated in the ifTable and the tunnelIfTable. The status of this row will become active as soon as the agent assigns the interface index, regardless of whether the interface is operationally up.

Deleting a row in this table will likewise delete the corresponding row in the ifTable and in the tunnelIfTable.

Yes

Since SET is not supported in this release, only 'active' is supported.

tunnelInetConfigStorageType

OID: 1.3.6.1.2.1.10.131.1.1.3.1. 8

The storage type of this row. If the row is permanent (4), no objects in the row need be writable other(1) volatile (2) nonVolatile (3) permanent(4) readOnly (5)

Yes

only non Volatile(3) is supported

IfXTable

MIB Object Description Supported (Yes/No)
ifIndex

OID: .1.3.6.1.2.1.2.2.1.1

A unique value, greater than zero, for each interface. It is recommended that values are assigned contiguously starting from 1. The value for each interface sub-layer must remain constant at least from one re-initialization of the entity's network management system to the next re-initialization. Yes (not accessible)

ifDescr

OID: .1.3.6.1.2.1.2.2.1.2

Textual string containing information about the interface. This string should include the name of the manufacturer, the product name and the version of the interface hardware/software.

Yes

ifType

OID: .1.3.6.1.2.1.2.2.1.3

The type of interface. Additional values for ifType are assigned by the Internet Assigned Numbers Authority (IANA), through updating the syntax of the IANAifType textual convention.

Yes

ifMtu

OID: .1.3.6.1.2.1.2.2.1.4

The size of the largest packet which can be sent/received on the interface, specified in octets. For interfaces that are used for transmitting network datagrams, this is the size of the largest network datagram that can be sent on the interface.

Yes

ifSpeed

OID: .1.3.6.1.2.1.2.2.1.5

An estimate of the interface's current bandwidth in bits per second. For interfaces which do not vary in bandwidth or for those where no accurate estimation can be made, this object should contain the nominal bandwidth.

Partial

ifPhysAddressOID: .1.3.6.1.2.1.2.2.1.6

The interface's address at its protocol sub-layer. For interfaces which do not have such an address (e.g., a serial line), this object should contain an octet string of zero length."

No

ifAdminStatus

OID: .1.3.6.1.2.1.2.2.1.7

The desired state of the interface. The testing(3) state indicates that no operational packets can be passed.SYNTAX INTEGER {up(1), -- ready to pass packetsdown(2),testing(3) -- in some test mode}
Note:

 

For ifAdminStatus, the these interfaces are supported: Physical interface, VE interface, port channel, and Loopback interface.

Yes

ifOperStatus

OID: .1.3.6.1.2.1.2.2.1.8

The current operational state of the interface. The testing(3) state indicates that no operational packets can be passed.SYNTAX INTEGER {up(1), -- ready to pass packetsdown(2),testing(3), -- in some test modeunknown(4), -- status cannot be determined for some reason.dormant(5),notPresent(6), -- some component is missinglowerLayerDown(7) -- down due to state of lower-layer interface(s)}

Yes

ifLastChange

OID: .1.3.6.1.2.1.2.2.1.9

The value of sysUpTime at the time the interface entered its current operational state.

No

ifInOctets

OID: .1.3.6.1.2.1.2.2.1.10

The total number of octets received on the interface, including framing characters.

Partial

ifInUcastPkts

OID: .1.3.6.1.2.1.2.2.1.11

The number of packets, delivered by this sub-layer to a higher (sub-)layer, which were not addressed to a multicast or broadcast address at this sub-layer.

Partial

ifInNUcastPkts

OID: .1.3.6.1.2.1.2.2.1.12

The number of packets, delivered by this sub-layer to a higher (sub-)layer, which were addressed to a multicast or broadcast address at this sub-layer.

No

ifInDiscards

OID: .1.3.6.1.2.1.2.2.1.13

The number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being deliverable to a higher-layer protocol. One possible reason for discarding such a packet could be to free up buffer space.

No

ifInErrors

OID: .1.3.6.1.2.1.2.2.1.14

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol.

No

ifInUnknownProtos

OID: .1.3.6.1.2.1.2.2.1.15

For packet-oriented interfaces, the number of packets received via the interface which were discarded because of an unknown or unsupported protocol. For character-oriented or fixed-length interfaces that support protocol multiplexing the number of transmission units received via the interface which were discarded because of an unknown or unsupported protocol. For any interface that does not support protocol multiplexing, this counter will always be 0.

No

ifOutOctets

OID: .1.3.6.1.2.1.2.2.1.16

The total number of octets transmitted out of the interface, including framing characters.

Yes

ifOutUcastPkts

OID: .1.3.6.1.2.1.2.2.1.17

The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a multicast or broadcast address at this sub-layer, including those that were discarded or not sent.

Yes

ifOutNUcastPkts

OID: .1.3.6.1.2.1.2.2.1.18

The total number of packets that higher-level protocols requested be transmitted, and which were addressed to a multicast or broadcast address at this sub-layer, including those that were discarded or not sent.

No

ifOutDiscards

OID: .1.3.6.1.2.1.2.2.1.19

The number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted.

No

ifOutErrors

OID: .1.3.6.1.2.1.2.2.1.20

For packet-oriented interfaces, the number of outbound packets that could not be transmitted because of errors. For character-oriented or fixed-length interfaces, the number of outbound transmission units that could not be transmitted because of errors.

No

ifOutQLen

OID: .1.3.6.1.2.1.2.2.1.21

The length of the output packet queue (in packets).

No

ifSpecific

OID: .1.3.6.1.2.1.2.2.1.22

A reference to MIB definitions specific to the particular media being used to realize the interface.

No

ifNumber

MIB Object Description Supported (Yes/No)

ifNumber

OID: .1.3.6.1.2.1.2.1

The number of network interfaces (regardless of their current state) present on this system. Yes