Standard view Table view

MIDCOM-MIB

        This MIB module defines a set of basic objects for
configuring middleboxes, such as firewalls and network
        
address translators, in order to enable communication
across these devices.
        
Managed objects defined in this MIB module are structured
in three kinds of objects:
  - transaction objects required according to the MIDCOM
    protocol requirements defined in RFC 3304 and according
    to the MIDCOM protocol semantics defined in RFC 3989,
  - configuration objects that can be used for retrieving or
    setting parameters of the implementation of transaction
    objects,
  - optional monitoring objects that provide information
    about used resource and statistics
        
The transaction objects are organized in two subtrees:
  - objects modeling MIDCOM policy rules in the
    midcomRuleTable
  - objects modeling MIDCOM policy rule groups in the
    midcomGroupTable
        
Note that typically, configuration objects are not intended
to be written by MIDCOM clients.  In general, write access
to these objects needs to be restricted more strictly than
write access to objects in the transaction subtrees.
        
Copyright (C) The Internet Society (2008).  This version
of this MIB module is part of RFC 5190;  see the RFC
itself for full legal notices.
Source file
MIDCOM-MIB
Last revised
Identity
midcomMIB
Base OID
1.3.6.1.2.1.171
Imported Objects
IF-MIB InterfaceIndexOrZero
INET-ADDRESS-MIB InetAddress InetAddressPrefixLength InetAddressType InetPortNumber
NAT-MIB NatBindIdOrZero
SNMP-FRAMEWORK-MIB SnmpAdminString
SNMPv2-CONF MODULE-COMPLIANCE NOTIFICATION-GROUP OBJECT-GROUP
SNMPv2-SMI Counter32 Gauge32 mib-2 MODULE-IDENTITY NOTIFICATION-TYPE OBJECT-TYPE Unsigned32
SNMPv2-TC RowStatus StorageType TEXTUAL-CONVENTION TruthValue
Net-SNMP examples using the rfc MIB directory Show commands

These commands use the standard Observium installation path and load the selected MIB variant before the RFC and Net-SNMP directories.

Translate the module identity
/usr/bin/snmptranslate -Pud -Ir -On -m 'MIDCOM-MIB' -M '/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'MIDCOM-MIB::midcomMIB'
Walk the MIB subtree
/usr/bin/snmpbulkwalk -v2c -c '<community>' -Pud -Ir -OQUs -m 'MIDCOM-MIB' -M '/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'udp:<hostname>:161' 'MIDCOM-MIB::midcomMIB'
How SNMP, Net-SNMP, MIB paths, and variants work
Objects (78)
midcomMIB
.1.3.6.1.2.1.171
midcomNotifications
.1.3.6.1.2.1.171.0
midcomObjects
.1.3.6.1.2.1.171.1
midcomTransaction
.1.3.6.1.2.1.171.1.1
midcomRuleTable
.1.3.6.1.2.1.171.1.1.3
midcomRuleEntry
midcomRuleOwnermidcomGroupIndexmidcomRuleIndex
 .1.3.6.1.2.1.171.1.1.3.1
midcomRuleOwner
OctetString
 .1.3.6.1.2.1.171.1.1.3.1.1
midcomRuleFlowDirection r/w
Enumeration
 .1.3.6.1.2.1.171.1.1.3.1.10
midcomRuleMaxIdleTime r/w
secondsSNMPv2-SMIUnsigned32
 .1.3.6.1.2.1.171.1.1.3.1.11
midcomRuleTransportProtocol r/w
Unsigned32
 .1.3.6.1.2.1.171.1.1.3.1.12
midcomRulePortRange r/w
Enumeration
 .1.3.6.1.2.1.171.1.1.3.1.13
midcomRuleInternalIpVersion r/w
INET-ADDRESS-MIBInetAddressType
 .1.3.6.1.2.1.171.1.1.3.1.14
midcomRuleExternalIpVersion r/w
INET-ADDRESS-MIBInetAddressType
 .1.3.6.1.2.1.171.1.1.3.1.15
midcomRuleInternalIpAddr r/w
INET-ADDRESS-MIBInetAddress
 .1.3.6.1.2.1.171.1.1.3.1.16
midcomRuleInternalIpPrefixLength r/w
INET-ADDRESS-MIBInetAddressPrefixLength
 .1.3.6.1.2.1.171.1.1.3.1.17
midcomRuleInternalPort r/w
INET-ADDRESS-MIBInetPortNumber
 .1.3.6.1.2.1.171.1.1.3.1.18
midcomRuleExternalIpAddr r/w
INET-ADDRESS-MIBInetAddress
 .1.3.6.1.2.1.171.1.1.3.1.19
midcomRuleExternalIpPrefixLength r/w
INET-ADDRESS-MIBInetAddressPrefixLength
 .1.3.6.1.2.1.171.1.1.3.1.20
midcomRuleExternalPort r/w
INET-ADDRESS-MIBInetPortNumber
 .1.3.6.1.2.1.171.1.1.3.1.21
midcomRuleInsideIpAddr
INET-ADDRESS-MIBInetAddress
 .1.3.6.1.2.1.171.1.1.3.1.22
midcomRuleInsidePort
INET-ADDRESS-MIBInetPortNumber
 .1.3.6.1.2.1.171.1.1.3.1.23
midcomRuleOutsideIpAddr
INET-ADDRESS-MIBInetAddress
 .1.3.6.1.2.1.171.1.1.3.1.24
midcomRuleOutsidePort
INET-ADDRESS-MIBInetPortNumber
 .1.3.6.1.2.1.171.1.1.3.1.25
midcomRuleLifetime r/w
secondsSNMPv2-SMIUnsigned32
 .1.3.6.1.2.1.171.1.1.3.1.26
midcomRuleRowStatus r/w
SNMPv2-TCRowStatus
 .1.3.6.1.2.1.171.1.1.3.1.27
midcomRuleIndex
Unsigned32
 .1.3.6.1.2.1.171.1.1.3.1.3
midcomRuleAdminStatus r/w
Enumeration
 .1.3.6.1.2.1.171.1.1.3.1.4
midcomRuleOperStatus
Enumeration
 .1.3.6.1.2.1.171.1.1.3.1.5
midcomRuleStorageType r/w
SNMPv2-TCStorageType
 .1.3.6.1.2.1.171.1.1.3.1.6
midcomRuleStorageTime r/w
secondsSNMPv2-SMIUnsigned32
 .1.3.6.1.2.1.171.1.1.3.1.7
midcomRuleError
SNMP-FRAMEWORK-MIBSnmpAdminString
 .1.3.6.1.2.1.171.1.1.3.1.8
midcomRuleInterface r/w
IF-MIBInterfaceIndexOrZero
 .1.3.6.1.2.1.171.1.1.3.1.9
midcomGroupTable
.1.3.6.1.2.1.171.1.1.4
midcomGroupEntry
midcomRuleOwnermidcomGroupIndex
 .1.3.6.1.2.1.171.1.1.4.1
midcomGroupIndex
Unsigned32
 .1.3.6.1.2.1.171.1.1.4.1.2
midcomGroupLifetime r/w
secondsSNMPv2-SMIUnsigned32
 .1.3.6.1.2.1.171.1.1.4.1.3
midcomConfig
.1.3.6.1.2.1.171.1.2
midcomConfigMaxLifetime r/w
secondsSNMPv2-SMIUnsigned32
 .1.3.6.1.2.1.171.1.2.1
midcomConfigPersistentRules r/w
SNMPv2-TCTruthValue
 .1.3.6.1.2.1.171.1.2.2
midcomConfigIfTable
.1.3.6.1.2.1.171.1.2.3
midcomConfigIfEntry
midcomConfigIfIndex
 .1.3.6.1.2.1.171.1.2.3.1
midcomConfigIfIndex
IF-MIBInterfaceIndexOrZero
 .1.3.6.1.2.1.171.1.2.3.1.1
midcomConfigIfBits
Bits
 .1.3.6.1.2.1.171.1.2.3.1.2
midcomConfigIfEnabled r/w
SNMPv2-TCTruthValue
 .1.3.6.1.2.1.171.1.2.3.1.3
midcomConfigFirewallTable
.1.3.6.1.2.1.171.1.2.4
midcomConfigFirewallEntry
midcomConfigFirewallIndex
 .1.3.6.1.2.1.171.1.2.4.1
midcomConfigFirewallIndex
IF-MIBInterfaceIndexOrZero
 .1.3.6.1.2.1.171.1.2.4.1.1
midcomConfigFirewallGroupId r/w
SNMP-FRAMEWORK-MIBSnmpAdminString
 .1.3.6.1.2.1.171.1.2.4.1.2
midcomConfigFirewallPriority r/w
SNMPv2-SMIUnsigned32
 .1.3.6.1.2.1.171.1.2.4.1.3
midcomMonitoring
.1.3.6.1.2.1.171.1.3
midcomResourceTable
.1.3.6.1.2.1.171.1.3.1
midcomResourceEntry
.1.3.6.1.2.1.171.1.3.1.1
midcomRscFirewallRuleId
SNMPv2-SMIUnsigned32
 .1.3.6.1.2.1.171.1.3.1.1.10
midcomRscNatInternalAddrBindMode
MidcomNatBindMode
 .1.3.6.1.2.1.171.1.3.1.1.4
midcomRscNatInternalAddrBindId
NAT-MIBNatBindIdOrZero
 .1.3.6.1.2.1.171.1.3.1.1.5
midcomRscNatInsideAddrBindMode
MidcomNatBindMode
 .1.3.6.1.2.1.171.1.3.1.1.6
midcomRscNatInsideAddrBindId
NAT-MIBNatBindIdOrZero
 .1.3.6.1.2.1.171.1.3.1.1.7
midcomRscNatSessionId1
MidcomNatSessionIdOrZero
 .1.3.6.1.2.1.171.1.3.1.1.8
midcomRscNatSessionId2
MidcomNatSessionIdOrZero
 .1.3.6.1.2.1.171.1.3.1.1.9
midcomStatistics
.1.3.6.1.2.1.171.1.3.2
midcomCurrentOwners
SNMPv2-SMIGauge32
 .1.3.6.1.2.1.171.1.3.2.1
midcomTotalIncorrectEnableRules
SNMPv2-SMICounter32
 .1.3.6.1.2.1.171.1.3.2.10
midcomTotalRejectedEnableRules
SNMPv2-SMICounter32
 .1.3.6.1.2.1.171.1.3.2.11
midcomCurrentActiveEnableRules
SNMPv2-SMIGauge32
 .1.3.6.1.2.1.171.1.3.2.12
midcomTotalExpiredEnableRules
SNMPv2-SMICounter32
 .1.3.6.1.2.1.171.1.3.2.13
midcomTotalTerminatedOnRqEnableRules
SNMPv2-SMICounter32
 .1.3.6.1.2.1.171.1.3.2.14
midcomTotalTerminatedEnableRules
SNMPv2-SMICounter32
 .1.3.6.1.2.1.171.1.3.2.15
midcomTotalRejectedRuleEntries
SNMPv2-SMICounter32
 .1.3.6.1.2.1.171.1.3.2.2
midcomCurrentRulesIncomplete
SNMPv2-SMIGauge32
 .1.3.6.1.2.1.171.1.3.2.3
midcomTotalIncorrectReserveRules
SNMPv2-SMICounter32
 .1.3.6.1.2.1.171.1.3.2.4
midcomTotalRejectedReserveRules
SNMPv2-SMICounter32
 .1.3.6.1.2.1.171.1.3.2.5
midcomCurrentActiveReserveRules
SNMPv2-SMIGauge32
 .1.3.6.1.2.1.171.1.3.2.6
midcomTotalExpiredReserveRules
SNMPv2-SMICounter32
 .1.3.6.1.2.1.171.1.3.2.7
midcomTotalTerminatedOnRqReserveRules
SNMPv2-SMICounter32
 .1.3.6.1.2.1.171.1.3.2.8
midcomTotalTerminatedReserveRules
SNMPv2-SMICounter32
 .1.3.6.1.2.1.171.1.3.2.9
midcomConformance
.1.3.6.1.2.1.171.2
midcomCompliances
.1.3.6.1.2.1.171.2.1
midcomGroups
.1.3.6.1.2.1.171.2.2
Dependencies (9) 7 direct · 2 transitive Show tree and compile order Hide dependency details

Each imported module is resolved in the importing module's source directory first, then through the normal default-variant rules.

Dependency tree
Dependency-first compile order
  1. SNMPv2-SMIrfc
  2. SNMPv2-TCrfc
  3. IANAifType-MIBrfc
  4. SNMPv2-CONFrfc
  5. SNMPv2-MIBrfc
  6. IF-MIBrfc
  7. INET-ADDRESS-MIBrfc
  8. SNMP-FRAMEWORK-MIBrfc
  9. NAT-MIBrfc
  10. MIDCOM-MIBrfcselected
Type Definitions (2)
MidcomNatBindMode
Enumeration
addressBind(1)
addressPortBind(2)
none(3)
MidcomNatSessionIdOrZero
Unsigned32
Conformance Groups (6)
midcomRuleGroup
midcomRuleAdminStatus midcomRuleOperStatus midcomRuleStorageType midcomRuleStorageTime midcomRuleError midcomRuleInterface midcomRuleFlowDirection midcomRuleMaxIdleTime midcomRuleTransportProtocol midcomRulePortRange midcomRuleInternalIpVersion midcomRuleExternalIpVersion midcomRuleInternalIpAddr midcomRuleInternalIpPrefixLength midcomRuleInternalPort midcomRuleExternalIpAddr midcomRuleExternalIpPrefixLength midcomRuleExternalPort midcomRuleInsideIpAddr midcomRuleInsidePort midcomRuleOutsideIpAddr midcomRuleOutsidePort midcomRuleLifetime midcomRuleRowStatus midcomGroupLifetime
A collection of objects providing information about
policy rules and policy rule groups.
 .1.3.6.1.2.1.171.2.2.1
midcomCapabilitiesGroup
midcomConfigMaxLifetime midcomConfigPersistentRules midcomConfigIfBits midcomConfigIfEnabled
A collection of objects providing information about
the capabilities of a middlebox.
 .1.3.6.1.2.1.171.2.2.2
midcomConfigFirewallGroup
midcomConfigFirewallGroupId midcomConfigFirewallPriority
A collection of objects providing information about
the firewall rule group and firewall rule priority to
be used by firewalls loaded through MIDCOM.
 .1.3.6.1.2.1.171.2.2.3
midcomResourceGroup
midcomRscNatInternalAddrBindMode midcomRscNatInternalAddrBindId midcomRscNatInsideAddrBindMode midcomRscNatInsideAddrBindId midcomRscNatSessionId1 midcomRscNatSessionId2 midcomRscFirewallRuleId
A collection of objects providing information about
the used NAT and firewall resources.
 .1.3.6.1.2.1.171.2.2.4
midcomStatisticsGroup
midcomCurrentOwners midcomTotalRejectedRuleEntries midcomCurrentRulesIncomplete midcomTotalIncorrectReserveRules midcomTotalRejectedReserveRules midcomCurrentActiveReserveRules midcomTotalExpiredReserveRules midcomTotalTerminatedOnRqReserveRules midcomTotalTerminatedReserveRules midcomTotalIncorrectEnableRules midcomTotalRejectedEnableRules midcomCurrentActiveEnableRules midcomTotalExpiredEnableRules midcomTotalTerminatedOnRqEnableRules midcomTotalTerminatedEnableRules
A collection of objects providing statistical
information about the MIDCOM server.
 .1.3.6.1.2.1.171.2.2.5
midcomNotificationsGroup
midcomUnsolicitedRuleEvent midcomSolicitedRuleEvent midcomSolicitedGroupEvent
The notifications emitted by the midcomMIB.
 .1.3.6.1.2.1.171.2.2.6
Compliance Statements (1)

OID .1.3.6.1.2.1.171.2.1.1
The compliance statement for implementations of the
MIDCOM-MIB module.

Note that compliance with this compliance
statement requires compliance with the
ifCompliance3 MODULE-COMPLIANCE statement of the
IF-MIB [RFC2863].
Required groups
mandatory midcomRuleGroup
mandatory midcomNotificationsGroup
mandatory midcomCapabilitiesGroup
mandatory midcomStatisticsGroup
optional midcomConfigFirewallGroup A compliant implementation does not have to implement
the midcomConfigFirewallGroup.
optional midcomResourceGroup A compliant implementation does not have to implement
the midcomResourceGroup.
Object refinements
ObjectAccessSyntaxDescription
midcomRuleInternalIpPrefixLength readonly
Write access is not required. When write access is
not supported, return 128 as the value of this object.
A value of 128 means that the function represented by
this option is not supported.
midcomRuleExternalIpPrefixLength readonly
Write access is not required. When write access is
not supported, return 128 as the value of this object.

A value of 128 means that the function represented by
this option is not supported.
midcomRuleMaxIdleTime readonly
Write access is not required. When write access is
not supported, return 0 as the value of this object.
A value of 0 means that the function represented by
this option is not supported.
midcomRuleInterface readonly
Write access is not required.
midcomConfigMaxLifetime readonly
Write access is not required.
midcomConfigPersistentRules readonly
Write access is not required.
midcomConfigIfEnabled readonly
Write access is not required.
midcomConfigFirewallGroupId readonly
Write access is not required.
midcomConfigFirewallPriority readonly
Write access is not required.
Notifications / Traps (3)
NameOIDDescription
midcomUnsolicitedRuleEvent
midcomRuleOperStatus midcomRuleLifetime
.1.3.6.1.2.1.171.0.1
This notification is generated whenever the value of
midcomRuleOperStatus enters any error state or any
termination state without an explicit trigger by a
MIDCOM client.
midcomSolicitedRuleEvent
midcomRuleOperStatus midcomRuleLifetime
.1.3.6.1.2.1.171.0.2
This notification is generated whenever the value
of midcomRuleOperStatus enters one of the states
{reserved, enabled, any error state, any termination state}
as a result of a MIDCOM agent writing successfully to
object midcomRuleAdminStatus.

In addition, it is generated when the lifetime of
a rule was changed by successfully writing to object
midcomRuleLifetime.
midcomSolicitedGroupEvent
midcomGroupLifetime
.1.3.6.1.2.1.171.0.3
This notification is generated for indicating that the
lifetime of all member rules of the group was changed by
successfully writing to object midcomGroupLifetime.

Note that this notification is only sent if the lifetime
of a group was changed by successfully writing to object
midcomGroupLifetime. No notification is sent
- if a group's lifetime is changed by writing to object
midcomRuleLifetime of any of its member policies,
- if a group's lifetime expires (in this case,
notifications are sent for all member policies), or
- if the group is terminated by terminating the last
of its member policies without writing to object
midcomGroupLifetime.