IPMCAST-MIB
Functions Overview
IPMCAST-MIB is used to implement multicast operations on a device and records operation results. In addition, this MIB manages IP multicast, including multicast routing and multicast data forwarding and receiving.
Root directory:
iso(1).rog(3).dod(6).internet(1).mgmt(2).mib-2(1).ipMcastMib(168)
Relationships Between Tables
After an (S, G) entry is created in ipMcastRouteTable and an outbound interface is specified for this entry, a new row is generated in ipMcastRouteNextHopTable.
Description of Single Objects
ipMcastEnabled
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.168.1.1 |
ipMcastEnabled |
INTEGER{true(1),false(2)} |
Read-write |
This object indicates whether IPv4 multicast is enabled:
|
This object is implemented as defined in the corresponding MIB file. |
When the Get operation is performed, only the status of IPv4 multicast can be queried. The status of IPv6 multicast cannot be queried. If IPv4 multicast is enabled, the value enabled (1) is returned; if IPv4 multicast is disabled, the value disabled (2) is returned.
ipMcastDeviceConfigStorageType
OID |
Object Name |
Syntax |
Max Access |
Meaning |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.168.1.11 |
ipMcastDeviceConfigStorageType |
INTEGER{other(1),volatile(2),nonVolatile(3),permanent(4),readOnly(5)} |
read-write |
The storage type used for the global IP multicast configuration. |
Currently, the maximum access is read-only. |
ipMcastRouteEntryCount
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.168.1.2 |
ipMcastRouteEntryCount |
INTEGER (0..4294967295) |
Read-only |
This object indicates the total number of entries in multicast routing-table plus entries in multicast ipv6 routing-table. This object can be used to monitor the size of the multicast routing table. |
This object is implemented as defined in the corresponding MIB file. |
Description of MIB Tables
ipMcastRouteTable
This table is used to record information about the routes from the specified source to a multicast group on a device.
The indexes of this table are ipMcastRouteGroupAddressType, ipMcastRouteGroup, ipMcastRouteGroupPrefixLength, ipMcastRouteSourceAddressType, ipMcastRouteSource, and ipMcastRouteSourcePrefixLength.
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.168.1.5.1.1 |
ipMcastRouteGroupAddressType |
INTEGER{unknown(0),ipv4(1),ipv6(2),ipv4z(3),ipv6z(4),dns(16)} |
Not-accessible |
This object indicates the type of a multicast group address. The value can be IPv4 or IPv6. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.2 |
ipMcastRouteGroup |
OCTET STRING (SIZE (0..255)) |
Not-accessible |
This object indicates a multicast group address. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.3 |
ipMcastRouteGroupPrefixLength |
Unsigned32 (0..2040) |
Not-accessible |
This object indicates the mask of a multicast group address. In the case of an IPv4 address, the value ranges from 4 to 32. In the case of an IPv6 address, the value ranges from 8 to 128. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.4 |
ipMcastRouteSourceAddressType |
INTEGER{unknown(0),ipv4(1),ipv6(2),ipv4z(3),ipv6z(4),dns(16)} |
Not-accessible |
This object indicates the type of a source address. The value can be IPv4 or IPv6. The types of the source address and multicast group address must be the same. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.5 |
ipMcastRouteSource |
OCTET STRING (SIZE (0..255)) |
Not-accessible |
This object indicates a source address. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.6 |
ipMcastRouteSourcePrefixLength |
Unsigned32 (0..2040) |
Not-accessible |
This object indicates the mask of a source address. In the case of an IPv4 address, the value ranges from 4 to 32. In the case of an IPv6 address, the value ranges from 8 to 128. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.7 |
ipMcastRouteUpstreamNeighborType |
INTEGER{unknown(0),ipv4(1),ipv6(2),ipv4z(3),ipv6z(4),dns(16)} |
Read-only |
This object indicates the type of an upstream neighbor address. The value can be IPv4 or IPv6. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.8 |
ipMcastRouteUpstreamNeighbor |
OCTET STRING (SIZE (0..255)) |
Read-only |
This object indicates the address of an upstream neighbor. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.9 |
ipMcastRouteInIfIndex |
Integer32 (0..2147483647) |
Read-only |
This object indicates the index of an upstream interface. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.10 |
ipMcastRouteTimeStamp |
TimeTicks |
Read-only |
This object indicates the time when a multicast routing entry is created. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.11 |
ipMcastRouteExpiryTime |
INTEGER (0..4294967295) |
Read-only |
This object indicates the timeout period of a multicast routing entry. |
The value of this object is always 0. |
1.3.6.1.2.1.168.1.5.1.12 |
ipMcastRouteProtocol |
INTEGER {other(1),local(2),netmgmt(3),dvmrp(4),mospf(5),pimSparseDense(6),cbt(7),pimSparseMode(8),pimDenseMode(9),igmpOnly(10),bgmp(11),msdp(12)} |
Read-only |
This object indicates a multicast routing protocol, such as PIM-SM, PIM-DM, and IGMP. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.13 |
ipMcastRouteRtProtocol |
INTEGER {other (1),local (2),netmgmt (3),icmp (4),egp (5),ggp (6),hello (7),rip (8),isIs (9),esIs (10),ciscoIgrp (11),bbnSpfIgp (12),ospf (13),bgp (14),idpr (15),ciscoEigrp (16),dvmrp (17)} |
Read-only |
This object indicates the unicast routing protocol used in RPF check, such as OSPF and IS-IS. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.14 |
ipMcastRouteRtAddressType |
INTEGER{unknown(0),ipv4(1),ipv6(2),ipv4z(3),ipv6z(4),dns(16)} |
Read-only |
This object indicates the address type of a unicast protocol. The value can be IPv4 or IPv6. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.15 |
ipMcastRouteRtAddress |
OCTET STRING (SIZE (0..255)) |
Read-only |
This object indicates a unicast address. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.16 |
ipMcastRouteRtPrefixLength |
Unsigned32 (0..2040) |
Read-only |
This object indicates the length of the mask of a unicast routing entry. In the case of an IPv4 address, the value ranges from 4 to 32. In the case of an IPv6 address, the value ranges from 8 to 128. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.17 |
ipMcastRouteRtType |
INTEGER |
Read-only |
The value of this object identifies the origin of routes in a multicast routing information base.
|
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.18 |
ipMcastRouteOctets |
INTEGER (0..18446744073709551615) |
Read-only |
This object indicates the number of forwarded bytes that carry (S, G) multicast data. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.19 |
ipMcastRoutePkts |
INTEGER (0..18446744073709551615) |
Read-only |
This object indicates the number of forwarded packets that carry (S, G) multicast data. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.5.1.20 |
ipMcastRouteTtlDropOctets |
INTEGER (0..18446744073709551615) |
read-only |
The value of this object identifies the digits of multicast data packets that are discarded because the packet's TTL value (IPv4) or hop limit (IPv6) is invalid. The value of this object is always 0. |
The value of this object is always 0. |
1.3.6.1.2.1.168.1.5.1.21 |
ipMcastRouteTtlDropPackets |
INTEGER (0..18446744073709551615) |
read-only |
The value of this object identifies the number of multicast data packets that are discarded because the packet's TTL value (IPv4) or hop limit (IPv6) is invalid. The value of this object is always 0. |
The value of this object is always 0. |
1.3.6.1.2.1.168.1.5.1.22 |
ipMcastRouteDifferentInIfOctets |
INTEGER (0..18446744073709551615) |
read-only |
The value of this object identifies the digits of multicast data packets that are discarded because the packets are received from unexpected interfaces. The value of this object is always 0. |
The value of this object is always 0. |
1.3.6.1.2.1.168.1.5.1.23 |
ipMcastRouteDifferentInIfPackets |
INTEGER (0..18446744073709551615) |
read-only |
The value of this object identifies the number of multicast data packets that are discarded because the packets are received from unexpected interfaces. The value of this object is always 0. |
The value of this object is always 0. |
Creation Restriction
No entry can be created in this table.
Modification Restriction
The entries in this table cannot be modified.
Deletion Restriction
The entries in this table cannot be deleted.
Access Restriction
The entries in this table can be read only when multicast is enabled and multicast routing entries exist on the device.
ipMcastRouteNextHopTable
This table is used to record the next hops of multicast routes on outbound interfaces. Each record shows information about the next hop for a multicast route from a specified source to a specified multicast group.
The indexes of this table are ipMcastRouteNextHopGroupAddressType, ipMcastRouteNextHopGroup, ipMcastRouteNextHopGroupPrefixLength, ipMcastRouteNextHopSourceAddressType, ipMcastRouteNextHopSource, ipMcastRouteNextHopSourcePrefixLength, ipMcastRouteNextHopIfIndex, ipMcastRouteNextHopAddressType, and ipMcastRouteNextHopAddress.
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.168.1.6.1.1 |
ipMcastRouteNextHopGroupAddressType |
INTEGER{unknown(0),ipv4(1),ipv6(2),ipv4z(3),ipv6z(4),dns(16)} |
Not-accessible |
This object indicates the type of a multicast group address. The value can be IPv4 or IPv6. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.6.1.2 |
ipMcastRouteNextHopGroup |
OCTET STRING (SIZE (0..255)) |
Not-accessible |
This object indicates a multicast group address. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.6.1.3 |
ipMcastRouteNextHopGroupPrefixLength |
Unsigned32 (0..2040) |
Not-accessible |
This object indicates the mask length of a group address. In the case of an IPv4 address, the value ranges from 4 to 32. In the case of an IPv6 address, the value ranges from 8 to 128. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.6.1.4 |
ipMcastRouteNextHopSourceAddressType |
INTEGER{unknown(0),ipv4(1),ipv6(2),ipv4z(3),ipv6z(4),dns(16)} |
Not-accessible |
This object indicates the type of a source address. The value can be IPv4 or IPv6. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.6.1.5 |
ipMcastRouteNextHopSource |
OCTET STRING (SIZE (0..255)) |
Not-accessible |
This object indicates a source address. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.6.1.6 |
ipMcastRouteNextHopSourcePrefixLength |
Unsigned32 (0..2040) |
Not-accessible |
This object indicates the mask length of a source address. In the case of an IPv4 address, the value ranges from 4 to 32. In the case of an IPv6 address, the value ranges from 8 to 128. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.6.1.7 |
ipMcastRouteNextHopIfIndex |
INTEGER |
Not-accessible |
This object indicates the index of an outbound interface. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.6.1.8 |
ipMcastRouteNextHopAddressType |
INTEGER{unknown(0),ipv4(1),ipv6(2),ipv4z(3),ipv6z(4),dns(16)} |
Not-accessible |
This object indicates the address type of an outbound interface. The value can be IPv4 or IPv6. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.6.1.9 |
ipMcastRouteNextHopAddress |
OCTET STRING (SIZE (0..255)) |
Not-accessible |
This object indicates a next-hop address. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.6.1.10 |
ipMcastRouteNextHopState |
INTEGER |
Read-only |
The value of this object identifies the current status of an outbound interface.
|
Currently, only forwarding(2) is supported. |
1.3.6.1.2.1.168.1.6.1.11 |
ipMcastRouteNextHopTimeStamp |
TimeTicks |
Read-only |
This object indicates the time when a multicast entry is created. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.6.1.12 |
ipMcastRouteNextHopExpiryTime |
INTEGER (0..4294967295) |
read-only |
This object indicates the timeout period of a multicast routing entry. The value of this object is always 0. |
The value of this object is always 0. |
1.3.6.1.2.1.168.1.6.1.13 |
ipMcastRouteNextHopClosestMemberHops |
INTEGER (0..4294967295) |
Read-only |
The object indicates the minimum TTL of an outbound interface. The value ranges from 0 to 256. |
Currently, the value ranges from 1 to 255. The default value is 1. |
1.3.6.1.2.1.168.1.6.1.14 |
ipMcastRouteNextHopProtocol |
INTEGER {other(1),local(2),netmgmt(3),dvmrp(4),mospf(5),pimSparseDense(6),cbt(7),pimSparseMode(8),pimDenseMode(9),igmpOnly(10),bgmp(11),msdp(12)} |
Read-only |
This object indicates the multicast protocol that adds the current outbound interface to the multicast routing table. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.6.1.15 |
ipMcastRouteNextHopOctets |
INTEGER (0..18446744073709551615) |
read-only |
The value of this object identifies the digits of multicast packets forwarded by multicast routes. The value of this object is always 0. |
The value of this object is always 0. |
1.3.6.1.2.1.168.1.6.1.16 |
ipMcastRouteNextHopPkts |
INTEGER (0..18446744073709551615) |
read-only |
The value of this object identifies the number of multicast packets forwarded by multicast routes. The value of this object is always 0. |
The value of this object is always 0. |
Creation Restriction
No entry can be created in this table.
Modification Restriction
The entries in this table cannot be modified.
Deletion Restriction
The entries in this table cannot be deleted.
Access Restriction
The entry of this table can be read only when the following situations are met: ipMcastRouteTable contains a record related to this entry; multicast is enabled on the router; the downstream list of the multicast routing entry should not be null.
ipMcastBoundaryTable
ipMcastBoundaryTable is used to record multicast boundaries that are configured on interfaces.
The indexes of this table are ipMcastBoundaryIfIndex, ipMcastBoundaryAddressType, ipMcastBoundaryAddress, and ipMcastBoundaryAddressPrefixLength.
OID |
Object Name |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
1.3.6.1.2.1.168.1.7.1.1 |
ipMcastBoundaryIfIndex |
INTEGER |
Not-accessible |
This object indicates the interface index. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.7.1.2 |
ipMcastBoundaryAddressType |
INTEGER{unknown(0),ipv4(1),ipv6(2),ipv4z(3),ipv6z(4),dns(16)} |
Not-accessible |
This object indicates the address type of a multicast boundary. The value can be IPv4 or IPv6. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.7.1.3 |
ipMcastBoundaryAddress |
OCTET STRING (SIZE (0..255)) |
Not-accessible |
This object indicates the address of a multicast boundary. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.7.1.4 |
ipMcastBoundaryAddressPrefixLength |
Unsigned32 (0..2040) |
Not-accessible |
This object indicates the mask length of the address of a multicast boundary. The value ranges from 4 to 128. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.7.1.5 |
ipMcastBoundaryTimeStamp |
TimeTicks |
Read-only |
This object indicates the time when a boundary is created. |
This object is implemented as defined in the corresponding MIB file. |
1.3.6.1.2.1.168.1.7.1.6 |
ipMcastBoundaryDroppedMcastOctets |
INTEGER (0..18446744073709551615) |
Read-only |
The value of this object identifies the digits of multicast packets that have been dropped. The value of this object is always 0. |
The value of this object is always 0. |
1.3.6.1.2.1.168.1.7.1.7 |
ipMcastBoundaryDroppedMcastPkts |
INTEGER (0..18446744073709551615) |
Read-only |
The value of this object identifies the number of multicast packets that have been dropped. The value of this object is always 0. |
The value of this object is always 0. |
1.3.6.1.2.1.168.1.7.1.8 |
ipMcastBoundaryStatus |
INTEGER{active(1),notInService(2),notReady(3),createAndGo(4),createAndWait(5),destroy(6)} |
Read-create |
This object indicates the status of a multicast boundary. |
Currently, only active(1), createAndGo(4), and destroy(6) are supported. |
Creation Restriction
This table supports only CreateAndGo. You must set ipMcastBoundaryIfIndex, ipMcastBoundaryAddressType, ipMcastBoundaryAddress, and ipMcastBoundaryAddressPrefixLength together to succeed in creating a row.
When a row is created, a device will compare the values of saved ipMcastBoundaryAddress and ipMcastBoundaryAddressPrefixLength and reset the extra bits. For example, if the value of ipMcastBoundaryAddress is set to 10.1.1.1 and ipMcastBoundaryAddressPrefixLength is 8, ipMcastBoundaryAddress saved on the device must be 10.0.0.0.
Creating a record in which the mask length is relatively short will clear all the records in which the mask length of the addresses in the same network segment is longer. For example, the device has three records, 10.1.0.0/16, 10.2.0.0/16, and 10.3.0.0/16. At this time, adding a record 10.0.0.0/8 will clear all the previous three records.
Modification Restriction
None.
Deletion Restriction
This table supports only destroy. You must set ipMcastBoundaryIfIndex, ipMcastBoundaryAddressType, ipMcastBoundaryAddress, and ipMcastBoundaryAddressPrefixLength together to succeed in deleting a row.
Access Restriction
The entries in this table can be read only when multicast is enabled on the device and IPv4 boundary or IPv6 boundary is configured on multicast interfaces.