-- extracted from draft-ietf-ptopomib-pdp-03.txt -- at Mon Nov 15 17:11:08 1999 PDP-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, Integer32, Counter32 FROM SNMPv2-SMI RowStatus FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF PhysicalIndex FROM ENTITY-MIB; pdpMIB MODULE-IDENTITY LAST-UPDATED "9707300000Z" ORGANIZATION "IETF PTOPOMIB Working Group" CONTACT-INFO "PTOPOMIB WG Discussion: ptopo@3com.com Subscription: majordomo@3com.com msg body: [un]subscribe ptopomib Andy Bierman Cisco Systems Inc. 170 West Tasman Drive San Jose, CA 95134 408-527-3711 abierman@cisco.com Keith McCloghrie Cisco Systems Inc. 170 West Tasman Drive San Jose, CA 95134 408-526-5260 kzm@cisco.com" DESCRIPTION "The MIB module for managing the Physical Topology Discovery Protocol." ::= { experimental xx } pdpMIBObjects OBJECT IDENTIFIER ::= { pdpMIB 1 } -- MIB groups pdpConfig OBJECT IDENTIFIER ::= { pdpMIBObjects 1 } pdpStats OBJECT IDENTIFIER ::= { pdpMIBObjects 2 } PdpPortIdType ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "The type of index value used to represent a port component. If an object of this type has a value of 'ifIndexType(1)', then the associated 'port ID' value represents an ifEntry, with the same ifIndex value. If an object of this type has a value of 'entPhysicalIndexType(2)', then the associated 'port ID' value represents an entPhysicalEntry, with the same entPhysicalIndex value." SYNTAX INTEGER { ifIndexType(1), entPhysicalIndexType(2) } -- -- *********************************************************** -- -- P D P C O N F I G -- -- *********************************************************** -- -- The Physical Topology Discovery Protocol Configuration Group pdpAdminStatus OBJECT-TYPE SYNTAX INTEGER { enabled(1), disabled(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "The administratively desired status of the the local PDP agent. If the agent is capable of storing non-volatile configuration, then the value of this object must be restored after a re-initialization of the management system." ::= { pdpConfig 1 } pdpOperStatus OBJECT-TYPE SYNTAX INTEGER { enabled(1), disabled(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "The current operational status of the local PDP agent." ::= { pdpConfig 2 } pdpMessageTxInterval OBJECT-TYPE SYNTAX Integer32 (5..32768) UNITS "seconds" MAX-ACCESS read-write STATUS current DESCRIPTION "The interval at which PDP messages are transmitted on behalf of this PDP agent. If the agent is capable of storing non-volatile configuration, then the value of this object must be restored after a re-initialization of the management system." DEFVAL { 60 } ::= { pdpConfig 3 } pdpMessageTxHoldMultiplier OBJECT-TYPE SYNTAX Integer32 (2..10) MAX-ACCESS read-write STATUS current DESCRIPTION "The time-to-live value expressed as a multiple of the pdpMessageTxInterval object. The actual time-to-live value used in PDP messages, transmitted on behalf of this PDP agent, can be expressed by the following formula: TTL = min(65535, (pdpMessageTxInterval * pdpMessageTxHoldMultiplier)) For example, if the value of pdpMessageTxInterval is '60', and the value of pdpMessageTxHoldMultiplier is '3', then the value '180' is encoded in the TTL field in the PDP header. If the agent is capable of storing non-volatile configuration, then the value of this object must be restored after a re-initialization of the management system." DEFVAL { 3 } ::= { pdpConfig 4 } -- -- PdpSuppressTable: -- Disable PDP activity on individual local ports pdpSuppressTable OBJECT-TYPE SYNTAX SEQUENCE OF PdpSuppressEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table controlling PDP message transmission on individual interfaces, ports, or backplanes." ::= { pdpConfig 6 } pdpSuppressEntry OBJECT-TYPE SYNTAX PdpSuppressEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "PDP message configuration information for a particular port. The port must be contained in the same chassis as the PDP agent. PDP messages will not be transmitted or received on the indicated port, even if the port is enabled. If the agent is capable of storing non-volatile configuration, then each active pdpSuppressEntry must be re-created after a re-initialization of the management system. An agent should store enough information about the associated entPhysicalEntry (e.g., entPhysicalAlias) or ifEntry (e.g. ifAlias), to properly re-create the entry, even if the pdpSuppressChassisId and/or pdpSuppressPortId values change across a system re-initialization." INDEX { pdpSuppressChassisId, pdpSuppressPortIdType, pdpSuppressPortId } ::= { pdpSuppressTable 1 } PdpSuppressEntry ::= SEQUENCE { pdpSuppressChassisId PhysicalIndex, pdpSuppressPortIdType PdpPortIdType, pdpSuppressPortId Integer32, pdpSuppressRowStatus RowStatus } pdpSuppressChassisId OBJECT-TYPE SYNTAX PhysicalIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "The entPhysicalIndex value used to identify the chassis component associated with this entry. The associated entPhysicalEntry must be active, and the associated entPhysicalClass object must be equal to 'chassis(3)'." ::= { pdpSuppressEntry 1 } pdpSuppressPortIdType OBJECT-TYPE SYNTAX PdpPortIdType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The type of index value contained in the associated pdpSuppressPortId object." ::= { pdpSuppressEntry 2 } pdpSuppressPortId OBJECT-TYPE SYNTAX Integer32 (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index value used to identify the port component of this entry. The type of index value depends on the pdpSuppressPortIdType value for this entry. If the associated pdpSuppressPortIdType is equal to 'ifIndexType(1)', then this pdpSuppressPortId represents an ifEntry with the same ifIndex value. The associated ifEntry must be active, and represent a physical interface on the local chassis. If the associated pdpSuppressPortIdType is equal to 'entPhysicalIndexType(2)', then this pdpSuppressPortId represents an entPhysicalEntry with the same entPhysicalIndex value. The associated entPhysicalEntry must be active, and the associated entPhysicalClass object must be equal to 'port(10)' or 'backplane(4)'. Note that some devices, such as repeaters, cannot restrict frame transmission to a single port, but rather to a group of ports. In such an event, an agent will disable PDP activity on all ports in the port group, if any of the individual ports in the group are specified in this table." ::= { pdpSuppressEntry 3 } pdpSuppressRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this entry." ::= { pdpSuppressEntry 4 } -- -- *********************************************************** -- -- P D P S T A T S -- -- *********************************************************** -- -- PDP Stats Group pdpStatsTable OBJECT-TYPE SYNTAX SEQUENCE OF PdpStatsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table containing PDP statistics for individual ports. Entries are not required to exist in this table while the pdpAdminStatus or pdpOperStatus objects are equal to 'disabled(2)'. Entries are not required to exist in this table if a corresponding entry (with identical index values) exists in the pdpSuppressTable." ::= { pdpStats 1 } pdpStatsEntry OBJECT-TYPE SYNTAX PdpStatsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "PDP message statistics for a particular port. The port must be contained in the same chassis as the PDP agent." INDEX { pdpStatsChassisId, pdpStatsPortIdType, pdpStatsPortId } ::= { pdpStatsTable 1 } PdpStatsEntry ::= SEQUENCE { pdpStatsChassisId PhysicalIndex, pdpStatsPortIdType PdpPortIdType, pdpStatsPortId Integer32, pdpStatsInGoodPkts Counter32, pdpStatsInErrors Counter32, pdpStatsOutPkts Counter32 } pdpStatsChassisId OBJECT-TYPE SYNTAX PhysicalIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "The entPhysicalIndex value used to identify the chassis component associated with this entry. The associated entPhysicalEntry must be active, and the associated entPhysicalClass object must be equal to 'chassis(3)'." ::= { pdpStatsEntry 1 } pdpStatsPortIdType OBJECT-TYPE SYNTAX PdpPortIdType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The type of index value contained in the associated pdpStatsPortId object." ::= { pdpStatsEntry 2 } pdpStatsPortId OBJECT-TYPE SYNTAX Integer32 (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index value used to identify the port component of this entry. The type of index value depends on the pdpStatsPortType value for this entry. If the associated pdpStatsPortIdType is equal to 'ifIndexType(1)', then this pdpStatsPortId represents an ifEntry with the same ifIndex value. The associated ifEntry must be active, and represent a physical interface on the local chassis. If the associated pdpStatsPortIdType is equal to 'entPhysicalIndexType(2)', then this pdpStatsPortId represents an entPhysicalEntry with the same entPhysicalIndex value. The associated entPhysicalEntry must be active, and the associated entPhysicalClass object must be equal to 'port(10)' or 'backplane(4)'." ::= { pdpStatsEntry 3 } pdpStatsInGoodPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of valid PDP messages received by this PDP agent on the indicated port, while this PDP agent is enabled." ::= { pdpStatsEntry 4 } pdpStatsInErrors OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of invalid PDP messages received by this PDP agent on the indicated port, while this PDP agent is enabled. A PDP message may be invalid for several reasons, including: - invalid MAC header; length or DA fields - invalid PDP header; version or flags fields - invalid PDP VarBindList ASN.1/BER encoding - invalid or missing PDP VarBindList data elements" ::= { pdpStatsEntry 5 } pdpStatsOutPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of PDP messages transmitted by this PDP agent on the indicated port." ::= { pdpStatsEntry 6 } -- conformance information pdpConformance OBJECT IDENTIFIER ::= { pdpMIB 2 } pdpCompliances OBJECT IDENTIFIER ::= { pdpConformance 1 } pdpGroups OBJECT IDENTIFIER ::= { pdpConformance 2 } -- compliance statements pdpCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMP entities which implement the PDP MIB." MODULE -- this module MANDATORY-GROUPS { pdpConfigGroup, pdpStatsGroup } ::= { pdpCompliances 1 } -- MIB groupings pdpConfigGroup OBJECT-GROUP OBJECTS { pdpAdminStatus, pdpOperStatus, pdpMessageTxInterval, pdpMessageTxHoldMultiplier, pdpSuppressRowStatus } STATUS current DESCRIPTION "The collection of objects which are used to configure the PTOPO Discovery Protocol implementation behavior. This group is mandatory for agents which implement the PTOPO Discovery Protocol." ::= { pdpGroups 1 } pdpStatsGroup OBJECT-GROUP OBJECTS { pdpStatsInGoodPkts, pdpStatsInErrors, pdpStatsOutPkts } STATUS current DESCRIPTION "The collection of objects which are used to represent PTOPO Discovery Protocol statistics. This group is mandatory for agents which implement the PTOPO Discovery Protocol." ::= { pdpGroups 2 } END -- -- Copyright (C) The Internet Society (1998). All Rights Reserved. -- -- This document and translations of it may be copied and furnished to -- others, and derivative works that comment on or otherwise explain it or -- assist in its implementation may be prepared, copied, published and -- distributed, in whole or in part, without restriction of any kind, -- provided that the above copyright notice and this paragraph are included -- on all such copies and derivative works. However, this document itself -- may not be modified in any way, such as by removing the copyright notice -- or references to the Internet Society or other Internet organizations, -- except as needed for the purpose of developing Internet standards in -- which case the procedures for copyrights defined in the Internet -- Standards process must be followed, or as required to translate it into -- languages other than English. -- -- The limited permissions granted above are perpetual and will not be -- revoked by the Internet Society or its successors or assigns. -- -- This document and the information contained herein is provided on an "AS -- IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK -- FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT -- LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT -- INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR -- FITNESS FOR A PARTICULAR PURPOSE."