ActiveXperts Network Monitor 2019##AdminFavorites

CABH-CAP-MIB by vendor Cable Television Laboratories Inc

CABH-CAP-MIB file content

The SNMP protocol is used to for conveying information and commands between agents and managing entities. SNMP uses the User Datagram Protocol (UDP) as the transport protocol for passing data between managers and agents. The reasons for using UDP for SNMP are, firstly it has low overheads in comparison to TCP, which uses a 3-way hand shake for connection. Secondly, in congested networks, SNMP over TCP is a bad idea because TCP in order to maintain reliability will flood the network with retransmissions.

Management information (MIB) is represented as a collection of managed objects. These objects together form a virtual information base called MIB. An agent may implement many MIBs, but all agents must implement a particular MIB called MIB-II [16]. This standard defines variables for things such as interface statistics (interface speeds, MTU, octets sent, octets received, etc.) as well as various other things pertaining to the system itself (system location, system contact, etc.). The main goal of MIB-II is to provide general TCP/IP management information.

Use ActiveXperts Network Monitor 2019 to import vendor-specific MIB files, inclusing CABH-CAP-MIB.


Vendor: Cable Television Laboratories Inc
Mib: CABH-CAP-MIB  [download]  [view objects]
Tool: ActiveXperts Network Monitor 2019 [download]    (ships with advanced SNMP/MIB tools)
CABH-CAP-MIB DEFINITIONS ::= BEGIN
IMPORTS
    MODULE-IDENTITY,
    OBJECT-TYPE,
    Unsigned32		FROM SNMPv2-SMI
    TEXTUAL-CONVENTION,
    TruthValue,
    RowStatus, 
    PhysAddress		FROM SNMPv2-TC
    OBJECT-GROUP,
    MODULE-COMPLIANCE	FROM SNMPv2-CONF
    InetAddressType,
    InetAddress,
    InetPortNumber		FROM INET-ADDRESS-MIB
    clabProjCableHome	FROM CLAB-DEF-MIB;

--==========================================================================
--
--	History:
--
--	Date		Modified by	Reason
--	04/05/02			Issued I01
--	09/20/02			Issued I02
--	04/11/03			Issued I03
--
--===================================================================

cabhCapMib MODULE-IDENTITY
    LAST-UPDATED    "200304110000Z" -- April 11, 2003
    ORGANIZATION    "CableLabs Broadband Access Department"
    CONTACT-INFO
            "Kevin Luehrs
            Postal: Cable Television Laboratories, Inc.
			400 Centennial Parkway
			Louisville, Colorado 80027-1266
            			U.S.A.
            Phone:  +1 303-661-9100
            Fax:    +1 303-661-9199
            E-mail: k.luehrs@cablelabs.com"
    DESCRIPTION
           "This MIB module supplies the basic management objects
           for the CableHome Addressing Portal (CAP) portion of 
           the PS database.

            
        Acknowledgements:
        Roy Spitzer		-	Consultant to CableLabs
        Mike Mannette	-	Consultant to Cable Labs
        Randy Dunton	-	Intel
        Dmitrii Loukianov	-	Intel
        Itay Sherman	-	Texas Instruments
        Chris Zacker	-	Broadcom
        Rick Vetter		-	Consultant to Cable Labs
        John Bevilacqua	-	YAS"
    ::=  { clabProjCableHome 3 }

-- Textual conventions

CabhCapPacketMode ::= TEXTUAL-CONVENTION
	STATUS	current
	DESCRIPTION
		"The data type established when
		a binding/mapping is established."
	SYNTAX	INTEGER {
		napt		(1),	-- NAT with port translation
		nat		(2),	-- Basic NAT
		passthrough	(3)	-- Pass Through External Address
		}


cabhCapObjects      OBJECT IDENTIFIER ::= { cabhCapMib 1 }
cabhCapBase         OBJECT IDENTIFIER ::= { cabhCapObjects 1 }
cabhCapMap          OBJECT IDENTIFIER ::= { cabhCapObjects 2 }


--====================================================================
--
--	General CAP Parameters
--
--====================================================================

cabhCapTcpTimeWait OBJECT-TYPE
    SYNTAX Unsigned32
    UNITS "seconds"
    MAX-ACCESS read-write
    STATUS current
    DESCRIPTION
    "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]"
    DEFVAL { 300 } 
    ::= { cabhCapBase 1 }


cabhCapUdpTimeWait OBJECT-TYPE
	SYNTAX      Unsigned32
	UNITS	   "seconds"
	MAX-ACCESS  read-write
	STATUS      current
	DESCRIPTION
       "The inactivity time to wait before destroying 
       CAP mappings for UDP."
	DEFVAL { 300 }  -- 5 minutes

	::={ cabhCapBase 2 }

cabhCapIcmpTimeWait OBJECT-TYPE
   	SYNTAX      Unsigned32
	UNITS "seconds"
	MAX-ACCESS read-write
	STATUS current
	DESCRIPTION
       "The inactivity time to wait before destroying 
       CAP mappings for ICMP."
	DEFVAL { 300 }  --  5 minutes

	::= { cabhCapBase 3 }


cabhCapPrimaryMode OBJECT-TYPE
    SYNTAX	CabhCapPacketMode
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
    "The Primary Packet Handling Mode to be used."
    DEFVAL { napt }
    ::= { cabhCapBase 4 }
    
cabhCapSetToFactory OBJECT-TYPE
    SYNTAX      TruthValue
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
      "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"

     ::= { cabhCapBase 5 }

--===================================================================
--
--	cabhCapMappingTable (CAP Mapping Table)
--
--	The cabhCapMappingTable contains the info for all CAP mappings.
--
--===================================================================

cabhCapMappingTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF CabhCapMappingEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
    "This table contains IP address mappings between private network
addresses, or network addresses and port numbers/ICMP sequence numbers,
assigned to devices on the subscriber's home LAN, and network 
addresses, or network addresses and port numbers/ICMP sequence number,
assigned by the cable operator, 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."
    ::= {  cabhCapMap 1 }

cabhCapMappingEntry OBJECT-TYPE
    SYNTAX      CabhCapMappingEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
       "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."
    INDEX { cabhCapMappingIndex }
    ::= { cabhCapMappingTable 1 }

	CabhCapMappingEntry ::= SEQUENCE {
	cabhCapMappingIndex 		INTEGER,
	cabhCapMappingWanAddrType 		InetAddressType,
	cabhCapMappingWanAddr		InetAddress,
	cabhCapMappingWanPort 		InetPortNumber,
	cabhCapMappingLanAddrType 		InetAddressType,
	cabhCapMappingLanAddr 		InetAddress,
	cabhCapMappingLanPort		InetPortNumber,
	cabhCapMappingMethod 		INTEGER,
	cabhCapMappingProtocol 		INTEGER,
	cabhCapMappingRowStatus 		RowStatus
	}

cabhCapMappingIndex    OBJECT-TYPE
    SYNTAX              INTEGER   (1..65535)
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
       "The Index into the CAP Mapping Table."
    ::= { cabhCapMappingEntry 1 }

    cabhCapMappingWanAddrType OBJECT-TYPE
    SYNTAX      InetAddressType
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
       "The IP address type assigned on the WAN side"
    DEFVAL { ipv4 }
    ::= { cabhCapMappingEntry 2 }

cabhCapMappingWanAddr OBJECT-TYPE
    SYNTAX      InetAddress
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
    "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."
    ::= { cabhCapMappingEntry 3 }

cabhCapMappingWanPort OBJECT-TYPE
    SYNTAX      InetPortNumber
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
       "The TCP/UDP port number or ICMP sequence number on the WAN
       side.  A port number of 0 indicates a NAT mapping.  A
       non-zero port number indicates an NAPT mapping."
        DEFVAL { 0 }
    ::= { cabhCapMappingEntry 4 }

cabhCapMappingLanAddrType OBJECT-TYPE
    SYNTAX      InetAddressType
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
       "The IP address type assigned on the LAN side."
    DEFVAL { ipv4 }
    ::= { cabhCapMappingEntry 5 }

cabhCapMappingLanAddr OBJECT-TYPE
    SYNTAX      InetAddress
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
       "The IP address assigned by the DHCP server function of the 
        PS (CableHome DHCP Server, CDS), and comprising the 
        LAN-side IP address of the CAP Mapping tuple. 
        This object is populated either dynamically as a result of LAN
        -to-WAN outbound traffic or statically by the cable operator."
    ::= { cabhCapMappingEntry 6 }

cabhCapMappingLanPort OBJECT-TYPE
    SYNTAX      InetPortNumber
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
    "The TCP/UDP port number or ICMP sequence number on the LAN
    side. A port number/sequence number of 0 indicates a NAT mapping.
    A non-zero port number/sequence number indicates an NAPT mapping."
    DEFVAL { 0 }
    ::= { cabhCapMappingEntry 7 }

cabhCapMappingMethod OBJECT-TYPE
    SYNTAX      INTEGER {
		static   (1),	
		dynamic (2)
		}
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
       "Indicates how this mapping was created. Static means that it
       was provisioned, and dynamic means that it was handled by the
       PS itself."
    ::= { cabhCapMappingEntry 8 }
    
cabhCapMappingProtocol OBJECT-TYPE
    SYNTAX      INTEGER {
		other		(1),	-- any other protocol; e.g. IGMP
		icmp		(2),
		udp		(3),
		tcp		(4)
				}
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
       "The protocol for this mapping."
    ::= { cabhCapMappingEntry 9 }

cabhCapMappingRowStatus OBJECT-TYPE
    SYNTAX      RowStatus
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
"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
cabhCapMappingWanAddrType, cabhCapMappingWanAddr,
cabhCapMappingLanAddrType, cabhCapMappingLanAddr, and
cabhCapMappingProtocol have been set.  If Primary Packet-handling
Mode is NAPT (cabhCapPrimaryMode is napt(1)), a newly created row
can not be set to active(1) until a non-zero value of
cabhCapMappingWanPort and cabhCapMappingLanPort have been set.
If 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 of
cabhCapMappingWanPort and cabhCapMappingLanPort have been set."
    ::={ cabhCapMappingEntry 10 }

--====================================================================
--
--	cabhCapPassthroughTable (CAP Passthrough Table)
--
--	The cabhCapPassthroughTable contains the MAC Addresses for all 
--	LAN-IP Devices which will be configured as passthrough.
--
--====================================================================

cabhCapPassthroughTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF CabhCapPassthroughEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
    "This table contains MAC addresses for LAN-IP Devices which are
    configured as passthrough mode." 
    ::= {  cabhCapMap 2 }

cabhCapPassthroughEntry	OBJECT-TYPE
    SYNTAX	CabhCapPassthroughEntry
    MAX-ACCESS	not-accessible
    STATUS	current
    DESCRIPTION
    "List of hardware addresses of LAN IP Devices which are configured
    for passthrough mode."
    INDEX {cabhCapPassthroughIndex}
::= {cabhCapPassthroughTable 1}

CabhCapPassthroughEntry::=SEQUENCE {
	cabhCapPassthroughIndex		INTEGER,
	cabhCapPassthroughMacAddr	PhysAddress,
	cabhCapPassthroughRowStatus	RowStatus
	}

cabhCapPassthroughIndex		OBJECT-TYPE
    SYNTAX	INTEGER (1..65535)
    MAX-ACCESS	not-accessible
    STATUS	current
    DESCRIPTION
    "The index into the CAP Passthrough Table."
    ::= { cabhCapPassthroughEntry 1 }

cabhCapPassthroughMacAddr		OBJECT-TYPE
    SYNTAX	PhysAddress
    MAX-ACCESS	read-create
    STATUS	current
    DESCRIPTION
    "Hardware address of the LAN-IP Device to be configured as
    passthrough mode."
    ::={cabhCapPassthroughEntry 2}

cabhCapPassthroughRowStatus	OBJECT-TYPE
    SYNTAX		RowStatus
    MAX-ACCESS	read-create
    STATUS		current
    DESCRIPTION 
"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)."
    ::= { cabhCapPassthroughEntry 3 }
--
-- notification group is for future extension.
-- 

cabhCapNotification	OBJECT IDENTIFIER ::= { cabhCapMib 2 0 }
cabhCapConformance	OBJECT IDENTIFIER ::= { cabhCapMib 3 }
cabhCapCompliances	OBJECT IDENTIFIER ::= { cabhCapConformance 1 }
cabhCapGroups		OBJECT IDENTIFIER ::= { cabhCapConformance 2 }

--
--    Notification Group
--


-- compliance statements

cabhCapBasicCompliance MODULE-COMPLIANCE
    STATUS     current
    DESCRIPTION
    "The compliance statement for devices that implement 
    MTA feature."
    MODULE   --cabhCapMib


-- unconditionally mandatory groups

MANDATORY-GROUPS {
    cabhCapGroup
    }

::= { cabhCapCompliances 1 }


cabhCapGroup OBJECT-GROUP
    OBJECTS {
		cabhCapTcpTimeWait,
		cabhCapUdpTimeWait,
		cabhCapIcmpTimeWait,
		cabhCapPrimaryMode,
		cabhCapSetToFactory,
		cabhCapMappingWanAddrType,
		cabhCapMappingWanAddr,
		cabhCapMappingWanPort,
		cabhCapMappingLanAddrType,
		cabhCapMappingLanAddr,
		cabhCapMappingLanPort,
		cabhCapMappingMethod,
		cabhCapMappingProtocol,
		cabhCapMappingRowStatus,
		cabhCapPassthroughMacAddr,
		cabhCapPassthroughRowStatus
		}
    STATUS    current
    DESCRIPTION
        "Group of objects for CableHome CAP MIB."
    ::= { cabhCapGroups 1 }

END