CABH-CAP-MIB: View SNMP OID List / Download MIB

This MIB module supplies the basic management objects for the CableHome Addressing Portal (CAP) portion of the PS.

This object is the maximum inactivity time to wait before assuming TCP session is terminated. It has no relation to the TCP session TIME_WAIT state referred to in [RFC793].

The inactivity time to wait before destroying CAP mappings for UDP.

The inactivity time to wait before destroying CAP mappings for ICMP.

The Primary Packet-handling Mode of the Portal Services logical element (PS) of a CableHome compliant residential gateway device. This object configures operation of the PS packet handling functions. When the value of this object is napt(1), the PS is required to support the Network Address and Port Translation (NAPT) process in accordance with the NAPT requirements defined in IETF RFC 3022. When operating in NAPT Primary Packet Handling Mode, the PS supports the translation of multiple LAN-Trans IP addresses and their TCP/UDP ports into a single WAN-Data IP address and its TCP/UDP ports. When the value of this object is nat(2), the PS is required to support the Network Address Translation (NAT) process in accordance with the NAT equirements defined in IETF RFC 3022. When operating in NAT Primary Packet Handling Mode, the PS supports the translation of multiple LAN-Trans IP addresses into the same number of unique WAN-Data IP addresses. When the value of this object is passthrough(3), the PS is required to act as a transparent bridge in accordance with IEEE 802.1D. When operating in Passthrough Primary Packet Handling Mode, the PS does not translate network addresses, and bridges all traffic between its LAN and WAN interfaces. The PS MUST delete dynamically-created row entries from the cabhCapMappingTable, i.e. those with cabhCapMappingMethod = dynamic(2), when the value of cabhCapPrimaryMode changes. The PS MUST NOT delete statically-created row entries from the cabhCapMappingTable where cabhCapMappingMethod = static(1), when the value of cabhCapPrimaryMode changes. Enumeration: 'passthrough': 3, 'napt': 1, 'nat': 2.

Reading this object always returns false(2). When the cabhCapSetToFactory object is set to true(1), the PS must take the following actions: 1. Clear all entries in the cabhCapMappingTable and cabhCapPassthroughTable. 2. Reset the following objects to their factory default values: cabhCapTcpTimeWait, cabhCapUdpTimeWait, cabhCapIcmpTimeWait, cabhCapPrimaryMode

The value of sysUpTime when cabhCapSetToFactory was last set to true. Zero if never reset.

This MIB is effective only when the PS is performing NAPT. If this MIB object is set to false(2), the PS MUST disable the UPnP WANIpConnection Service in the CableHome PS. If this MIB object is set to true(1), the PS MUST enable the WANIpConnection service in the PS. When the primary packet handling mode of the PS is C-NAT (2) or Passthrough(3), setting this MIB to true(1) MUST return InconsistentValue error.

The inactivity time to wait before destroying CAP mappings created by UPnP control points. The value of 0 indicates inactivity time wait of infinity, i.e. a UPnP entry doesnt get destroyed based on inactivity period.

This table contains IP address mappings between private network addresses, or network addresses and port numbers/ICMP Identifiers, assigned to devices on the subscriber's home LAN, and network addresses, or network addresses and port numbers/ICMP Identifiers on the WAN, presumed to be on a separate subnetwork than the private IP addresses. The CAP Mapping Table is used by the CableHome Address Portal (CAP) function of the PS to make packet forwarding decisions.

List of the private IP (LAN) address - to - cable operator assigned IP (WAN) address mappings stored in the PS and used by the PS to make packet forwarding decisions.

The Index into the CAP Mapping Table.

The IP address type assigned on the WAN side.

The IP address assigned by the cable operator's address (DHCP) server, and comprising the WAN-side IP address of the CAP Mapping tuple. This object is populated either dynamically by LAN-to-WAN outbound traffic or statically by the cable operator.

The TCP/UDP port number or ICMP Identifier on the WAN side. A port number/Identifier of 0 indicates either a NAT or a DMZ mapping. A non-zero port number/Identifier indicates a NAPT mapping. If the value of cabhCapMappingNumPorts MIB object is non-zero this MIB represents a starting TCP/UDP port number on the WAN side for which a mapping entry is created.

The IP address type assigned on the LAN side.

The IP address of the LAN-Trans IP Device. This object is populated either dynamically as a result of LAN-to-WAN outbound traffic or statically by the cable operator.

The TCP/UDP port number or ICMP Identifier on the LAN side. A port number/Identifier of 0 indicates either a DMZ mapping or a NAT mapping. A non-zero port number/Identifier indicates a NAPT mapping. If the value of cabhCapMappingNumPorts MIB object is non-zero then this MIB represents a starting TCP/UDP port number on the LAN side for which a mapping entry is created.

Indicates how this mapping was created. Static means that it was provisioned, and dynamic means that it was handled by the PS itself. upnp (3) means that the CAP mapping entry was created by some UPnP compliant application. Enumeration: 'dynamic': 2, 'static': 1, 'upnp': 3.

The protocol for this mapping entry. The value of other(1) represents a protocol other than ICMP, TCP, and UDP. Thus, when the value other(1) is specified for the cabhCapMappingProtocol value of a CAP Mapping Table entry, TCP, UDP or ICMP packets MUST NOT be forwarded even if the WAN and LAN IP address and port tuple of the packet matches with mapping entry. The value of all(255) represents all protocol types. Thus, when the cabhCapMappingProtocol value all(255) is specified for an entry in the CAP Mapping Table, traffic of all protocol types MUST be forwarded accordingly f the WAN and LAN IP address and port tuple in the packet matches the mapping entry. Enumeration: 'icmp': 2, 'other': 1, 'udp': 3, 'tcp': 4, 'all': 255.

The RowStatus interlock for the creation and deletion of a cabhCapMappingTable entry. Changing the value of the IP address or port number columns of the CAP Mapping Table may have an effect on active traffic, so the PS will prevent modification of this table's columns and return an inconsistentValue error when cabhCapMappingRowStatus object is active(1). The PS must not allow RowStatus to be set to notInService(2) by a manager. A newly created row cannot be set to active(1) until the corresponding instances of cabhCapMappingWanAddr, cabhCapMappingLanAddr, and cabhCapMappingProtocol have been set. If the manager attempts to populate a row entry in the table with a non-unique value for the combination of cabhCapMappingWanAddr and range of WAN port(s) (identified by cabhCapMappingWanPort to cabhCapMappingWanPort + cabhCapMappingNumPorts 1), or a non-unique value for the combination of cabhCapMappingLanAddr and range of LAN port(s) (identified by cabhCapMappingLanPort to cabhCapMappingLanPort + cabhCapMappingNumPorts - 1), the PS MUST prevent the creation of this row and return an inconsistentValue error. This prevents creation of entries with overlapping port ranges in the CAP table. If the manager attempts to populate a row entry with a zero value for cabhCapMappingWanPort and a non-zero value for cabhCapMappingLanPort or a row entry with a zero value for cabhCapMappingLanPort and a non-zero value for cabhCapMappingWanPort, the PS MUST prevent the creation of this row and return an inconsistentValue error. This prevents creation of invalid NAT or NAPT entries. If the manager attempts to populate a row entry with non-zero values for both cabhCapMappingWanPort and cabhCapMappingLanPort, but a zero value for cabhCapMappingNumPorts, the PS MUST prevent the creation of this row and return an inconsistentValue error. This prevents creation of NAPT entries. When Primary Packet-handling Mode is NAPT (cabhCapPrimaryMode is napt(1)), provisioned rows can be set to active(1) regardless of whether the value to which cabhCapMappingWanPort, cabhCapMappingLanPort, and cabhCapMappingNumPorts have been set is zero or nonzero. When Primary Packet-handling Mode is NAT (cabhCapPrimaryMode is nat(2)), a newly created row can not be set to active(1) if a non-zero value have been set for cabhCapMappingWanPort, cabhCapMappingLanPort and cabhCapMappingNumPorts. In NAPT Primary Packet-handling mode, a row entry with zero values for cabhCapMappingWanPort, cabhCapMappingLanPort, and cabhCapMappingNumPorts objects represents a DMZ entry.

This object represents number of ports available for port translation on both LAN and WAN side. When both cabhCapMappingWanPort and cabhCapMappingLanPort are set to zero, the PS MUST ignore this MIB object, and such a row entry represents either a DMZ entry (when primary packet handling mode is NAPT) or a NAT entry (when primary packet handling mode is NAT). When a row entry is created with non-zero values for cabhCapMappingWanPort, cabhCapMappingLanPort, and cabhCapMappingNumPorts the PS MUST translate range of ports on the WAN side (identified by cabhCapMappingWanPort to cabhCapMappingWanPort + cabhCapMappingNumPorts-1) to range of ports on the LAN side (identified by cabhCapMappingLanPort to cabhCapMappingLanPort + cabhCapMappingNumPorts-1). The PS MUST ignore this MIB for a CAP mapping entry with the value of cabhCapMappingProtocol equal to icmp(2).

A string value that can be used to describe the purpose or attributes of the CAP Mapping entry.

For dynamic(2) and upnp(3) CAP mapping entries the PS MUST set this MIB with date and time when the entry is created. The PS MUST set the value of this MIB to zero valued 11-byte string for static CAP mapping entries. This MIB object MUST NOT persist across the PS reboot.

The PS MUST set the value of this MIB to zero valued 11 byte string for static CAP mapping entries. For dynamic(2) CAP Mapping entries, the PS MUST set the value of this MIB to the value of cabhCapMappingCreateTime For upnp(3) CAP mapping entries the PS MUST set this MIB with date and time when the entry is last updated. When the upnp(3)entry is first created the PS MUST set this MIB with the value of cabhCapMappingCreateTime MIB. This MIB object MUST NOT persist across the PS reboot.

When a value greater than zero is assigned to this object, the PS MUST remove the CAP entry after the time duration, represented by this object, elapses starting from cabhCapMappingLastUpdateTime. When a value of 0 is assigned to this object, the PS MUST retain the CAP mapping entry until reboot or reset. The PS MUST retain a CAP mapping entry with cabhCapMappingDuration MIB set to 0 and cabhCapMappingMethod set to static(1) across the reboots. The PS MUST NOT retain a CAP mapping entry with cabhCapMappingDuration MIB set to 0 and cabhCapMappingMethod set to upnp(3) across the reboots. When a value of 1 is assigned for this MIB the PS MUST ignore this MIB and MUST remove the CAP mapping entries based on TCP, UDP and ICMP inactivity time-wait depending upon their protocol type. When the cabhCapMappingMethod object is static(1), the default value for this object is 0. When the cabhCapMappingMethod object is dynamic(2), the PS MUST set the value of this object to 1. When the cabhCapMappingMethod object is upnp(3), the default value for this object is -1.

The IP address type for a remote host on the WAN side.

The IP address of the remote host for a CAP mapping entry. The packet traversing through the PS is either originated from or is destined to this remote host. The value of all zeros for this MIB object indicates any IP address for a remote host.

This MIB allows the PS to enable or disable a particular CAP mapping entry. When this MIB is set to true(1) for a CAP mapping entry, the PS MUST correctly route the traffic that matches this entry. When this MIB is set to false(2) for a CAP mapping entry, the PS MUST NOT route the traffic that matches this entry.

This table contains hardware addresses of LAN IP Devices for which the PS will bridge traffic at OSI Layer 2.

List of hardware addresses of LAN IP Devices for which the PS will bridge traffic at OSI Layer 2.

The index into the CAP Passthrough Table.

Hardware address of the LAN IP Device for which the PS MUST bridge traffic at OSI Layer 2.

The RowStatus interlock for the creation and deletion of a cabhCapPassthroughTable entry. Any writable object in each row can be modified at any time while the row is active(1).

The compliance statement for devices that implement the CableHome Portal Services functionality.

Group of objects for CableHome CAP MIB.