test/dumps/corba/MAU_MIB.idl

   1 /*                                                      -- DO NOT EDIT --
   2  * Generated by smidump version 0.4.8:
   3  *   smidump -f corba MAU-MIB
   4  *
   5  * Derived from MAU-MIB:
   6  *   Management information for 802.3 MAUs.
   7  *
   8  *   The following reference is used throughout this MIB module:
   9  *
  10  *   [IEEE802.3] refers to:
  11  *      IEEE Std 802.3, 2005 Edition: 'IEEE Standard for Information
  12  *      technology - Telecommunications and information exchange
  13  *      between systems - Local and metropolitan area networks -
  14  *      Specific requirements - Part 3: Carrier sense multiple
  15  *      access with collision detection (CSMA/CD) access method and
  16  *      physical layer specifications'.
  17  *
  18  *      Of particular interest is Clause 30, 'Management'.
  19  *
  20  *   Copyright (C) The IETF Trust (2007).
  21  *   This version of this MIB module is part of RFC 4836;
  22  *   see the RFC itself for full legal notices.
  23  *
  24  * Revision 2007-04-21 00:00:
  25  *   Updated to reference IANA maintaned textual
  26  *   conventions for MAU types, Media Availability state,
  27  *   Auto Negotiation capabilities, and jack types,
  28  *   instead of using internally defined values.
  29  *
  30  *   This version is published as RFC 4836.
  31  *
  32  * Revision 2003-09-19 00:00:
  33  *   Updated to include support for 10 Gb/s MAUs.
  34  *   This resulted in the following revisions:
  35  *   - Added OBJECT-IDENTITY definitions for
  36  *     10 gigabit MAU types
  37  *
  38  *
  39  *
  40  *   - Added fiberLC jack type to JackType TC
  41  *   - Extended ifMauTypeListBits with bits for
  42  *     the 10 gigabit MAU types
  43  *   - Added enumerations to ifMauMediaAvailable,
  44  *     and updated its DESCRIPTION to reflect
  45  *     behaviour at 10 Gb/s
  46  *   - Added 64-bit version of ifMauFalseCarriers
  47  *     and added mauIfGrpHCStats object group to
  48  *     contain the new object
  49  *   - Deprecated mauModIfCompl2 and replaced it
  50  *     with mauModIfCompl3, which includes the new
  51  *     object group
  52  *
  53  *    This version published as RFC 3636.
  54  *
  55  * Revision 1999-08-24 04:00:
  56  *   This version published as RFC 2668.  Updated
  57  *   to include support for 1000 Mb/sec
  58  *   MAUs and flow control negotiation.
  59  *
  60  * Revision 1997-10-31 00:00:
  61  *   Version published as RFC 2239.
  62  *
  63  * Revision 1993-09-30 00:00:
  64  *   Initial version, published as RFC 1515.
  65  *
  66  * $Id: MAU_MIB.idl 8090 2008-04-18 12:56:29Z strauss $
  67  */
  68
  69 #ifndef _MAU_MIB_IDL_
  70 #define _MAU_MIB_IDL_
  71
  72 #include <ASN1Types.idl>
  73 #include <SNMPMgmt.idl>
  74 #include <IANA_MAU_MIB.idl>
  75 #include <IF_MIB.idl>
  76 #include <SNMPv2_SMI.idl>
  77 #include <SNMPv2_TC.idl>
  78
  79 module MAU_MIB {
  80
  81     typedef IANA_MAU_MIB::IANAifJackTypeType IANAifJackTypeType;
  82     typedef IANA_MAU_MIB::IANAifMauAutoNegCapBitsType IANAifMauAutoNegCapBitsType;
  83     typedef IANA_MAU_MIB::IANAifMauMediaAvailableType IANAifMauMediaAvailableType;
  84     typedef IANA_MAU_MIB::IANAifMauTypeListBitsType IANAifMauTypeListBitsType;
  85     typedef IF_MIB::InterfaceIndexType InterfaceIndexType;
  86     typedef SNMPv2_SMI::Counter32Type Counter32Type;
  87     typedef SNMPv2_SMI::Counter64Type Counter64Type;
  88     typedef SNMPv2_SMI::Integer32Type Integer32Type;
  89     typedef SNMPv2_TC::AutonomousTypeType AutonomousTypeType;
  90     typedef SNMPv2_TC::TruthValueType TruthValueType;
  91
  92     const string moduleIdentity = "mauMod";
  93     const ASN1_ObjectIdentifier mauMod = "::MAU_MIB::mauMod";
  94
  95     /*
  96              Management information for 802.3 MAUs.
  97
  98              The following reference is used throughout this MIB module:
  99
 100              [IEEE802.3] refers to:
 101                 IEEE Std 802.3, 2005 Edition: 'IEEE Standard for Information
 102                 technology - Telecommunications and information exchange
 103                 between systems - Local and metropolitan area networks -
 104                 Specific requirements - Part 3: Carrier sense multiple
 105                 access with collision detection (CSMA/CD) access method and
 106                 physical layer specifications'.
 107
 108                 Of particular interest is Clause 30, 'Management'.
 109
 110              Copyright (C) The IETF Trust (2007).
 111              This version of this MIB module is part of RFC 4836;
 112              see the RFC itself for full legal notices.
 113
 114     LAST-UPDATED:   200704210000Z
 115
 116     ORGANIZATION:
 117             "IETF Ethernet Interfaces and Hub MIB Working Group"
 118
 119     CONTACT-INFO:
 120             "WG charter:
 121              http://www.ietf.org/html.charters/hubmib-charter.html
 122
 123              Mailing Lists:
 124              General Discussion: hubmib@ietf.org
 125              To Subscribe: hubmib-request@ietf.org
 126              In Body: subscribe your_email_address
 127
 128
 129
 130              Chair: Bert Wijnen
 131              Postal: Alcatel-Lucent
 132                    Schagen 33
 133                    3461 GL Linschoten
 134                    Netherlands
 135              Phone: +31-348-407-775
 136              EMail: bwijnen@alcatel-lucent.com
 137
 138              Editor: Edward Beili
 139              Postal: Actelis Networks Inc.
 140                    25 Bazel St., P.O.B. 10173
 141                    Petach-Tikva 10173
 142                    Israel
 143               Tel: +972-3-924-3491
 144              EMail: edward.beili@actelis.com"
 145
 146     REVISION:       "200704210000Z"
 147     REVISION-DESCRIPTION:
 148             "Updated to reference IANA maintaned textual
 149              conventions for MAU types, Media Availability state,
 150              Auto Negotiation capabilities, and jack types,
 151              instead of using internally defined values.
 152
 153              This version is published as RFC 4836."
 154
 155     REVISION:       "200309190000Z"
 156     REVISION-DESCRIPTION:
 157             "Updated to include support for 10 Gb/s MAUs.
 158              This resulted in the following revisions:
 159              - Added OBJECT-IDENTITY definitions for
 160                10 gigabit MAU types
 161
 162
 163
 164              - Added fiberLC jack type to JackType TC
 165              - Extended ifMauTypeListBits with bits for
 166                the 10 gigabit MAU types
 167              - Added enumerations to ifMauMediaAvailable,
 168                and updated its DESCRIPTION to reflect
 169                behaviour at 10 Gb/s
 170              - Added 64-bit version of ifMauFalseCarriers
 171                and added mauIfGrpHCStats object group to
 172                contain the new object
 173              - Deprecated mauModIfCompl2 and replaced it
 174                with mauModIfCompl3, which includes the new
 175                object group
 176
 177               This version published as RFC 3636."
 178
 179     REVISION:       "199908240400Z"
 180     REVISION-DESCRIPTION:
 181             "This version published as RFC 2668.  Updated
 182              to include support for 1000 Mb/sec
 183              MAUs and flow control negotiation."
 184
 185     REVISION:       "199710310000Z"
 186     REVISION-DESCRIPTION:
 187             "Version published as RFC 2239."
 188
 189     REVISION:       "199309300000Z"
 190     REVISION-DESCRIPTION:
 191             "Initial version, published as RFC 1515."
 192
 193     */
 194
 195     typedef ASN1_Integer RpMauGroupIndexType;
 196
 197     typedef ASN1_Integer RpMauPortIndexType;
 198
 199     typedef ASN1_Integer RpMauIndexType;
 200
 201     typedef ASN1_Integer RpMauStatusType;
 202     const RpMauStatusType RpMauStatusType_other = 1;
 203     const RpMauStatusType RpMauStatusType_unknown = 2;
 204     const RpMauStatusType RpMauStatusType_operational = 3;
 205     const RpMauStatusType RpMauStatusType_standby = 4;
 206     const RpMauStatusType RpMauStatusType_shutdown = 5;
 207     const RpMauStatusType RpMauStatusType_reset = 6;
 208     const string RpMauStatusType_NameNumberList = "other (1) , unknown (2) , operational (3) , standby (4) , shutdown (5) , reset (6)";
 209
 210     typedef ASN1_Integer RpMauJabberStateType;
 211     const RpMauJabberStateType RpMauJabberStateType_other = 1;
 212     const RpMauJabberStateType RpMauJabberStateType_unknown = 2;
 213     const RpMauJabberStateType RpMauJabberStateType_noJabber = 3;
 214     const RpMauJabberStateType RpMauJabberStateType_jabbering = 4;
 215     const string RpMauJabberStateType_NameNumberList = "other (1) , unknown (2) , noJabber (3) , jabbering (4)";
 216
 217     typedef ASN1_Integer RpJackIndexType;
 218
 219     typedef ASN1_Integer IfMauIndexType;
 220
 221     typedef ASN1_Integer IfMauStatusType;
 222     const IfMauStatusType IfMauStatusType_other = 1;
 223     const IfMauStatusType IfMauStatusType_unknown = 2;
 224     const IfMauStatusType IfMauStatusType_operational = 3;
 225     const IfMauStatusType IfMauStatusType_standby = 4;
 226     const IfMauStatusType IfMauStatusType_shutdown = 5;
 227     const IfMauStatusType IfMauStatusType_reset = 6;
 228     const string IfMauStatusType_NameNumberList = "other (1) , unknown (2) , operational (3) , standby (4) , shutdown (5) , reset (6)";
 229
 230     typedef ASN1_Integer IfMauJabberStateType;
 231     const IfMauJabberStateType IfMauJabberStateType_other = 1;
 232     const IfMauJabberStateType IfMauJabberStateType_unknown = 2;
 233     const IfMauJabberStateType IfMauJabberStateType_noJabber = 3;
 234     const IfMauJabberStateType IfMauJabberStateType_jabbering = 4;
 235     const string IfMauJabberStateType_NameNumberList = "other (1) , unknown (2) , noJabber (3) , jabbering (4)";
 236
 237     typedef ASN1_Integer IfJackIndexType;
 238
 239     typedef ASN1_Integer IfMauAutoNegAdminStatusType;
 240     const IfMauAutoNegAdminStatusType IfMauAutoNegAdminStatusType_enabled = 1;
 241     const IfMauAutoNegAdminStatusType IfMauAutoNegAdminStatusType_disabled = 2;
 242     const string IfMauAutoNegAdminStatusType_NameNumberList = "enabled (1) , disabled (2)";
 243
 244     typedef ASN1_Integer IfMauAutoNegRemoteSignalingType;
 245     const IfMauAutoNegRemoteSignalingType IfMauAutoNegRemoteSignalingType_detected = 1;
 246     const IfMauAutoNegRemoteSignalingType IfMauAutoNegRemoteSignalingType_notdetected = 2;
 247     const string IfMauAutoNegRemoteSignalingType_NameNumberList = "detected (1) , notdetected (2)";
 248
 249     typedef ASN1_Integer IfMauAutoNegConfigType;
 250     const IfMauAutoNegConfigType IfMauAutoNegConfigType_other = 1;
 251     const IfMauAutoNegConfigType IfMauAutoNegConfigType_configuring = 2;
 252     const IfMauAutoNegConfigType IfMauAutoNegConfigType_complete = 3;
 253     const IfMauAutoNegConfigType IfMauAutoNegConfigType_disabled = 4;
 254     const IfMauAutoNegConfigType IfMauAutoNegConfigType_parallelDetectFail = 5;
 255     const string IfMauAutoNegConfigType_NameNumberList = "other (1) , configuring (2) , complete (3) , disabled (4) , parallelDetectFail (5)";
 256
 257     typedef ASN1_Integer IfMauAutoNegRestartType;
 258     const IfMauAutoNegRestartType IfMauAutoNegRestartType_restart = 1;
 259     const IfMauAutoNegRestartType IfMauAutoNegRestartType_norestart = 2;
 260     const string IfMauAutoNegRestartType_NameNumberList = "restart (1) , norestart (2)";
 261
 262     typedef ASN1_Integer IfMauAutoNegRemoteFaultAdvertisedType;
 263     const IfMauAutoNegRemoteFaultAdvertisedType IfMauAutoNegRemoteFaultAdvertisedType_noError = 1;
 264     const IfMauAutoNegRemoteFaultAdvertisedType IfMauAutoNegRemoteFaultAdvertisedType_offline = 2;
 265     const IfMauAutoNegRemoteFaultAdvertisedType IfMauAutoNegRemoteFaultAdvertisedType_linkFailure = 3;
 266     const IfMauAutoNegRemoteFaultAdvertisedType IfMauAutoNegRemoteFaultAdvertisedType_autoNegError = 4;
 267     const string IfMauAutoNegRemoteFaultAdvertisedType_NameNumberList = "noError (1) , offline (2) , linkFailure (3) , autoNegError (4)";
 268
 269     typedef ASN1_Integer IfMauAutoNegRemoteFaultReceivedType;
 270     const IfMauAutoNegRemoteFaultReceivedType IfMauAutoNegRemoteFaultReceivedType_noError = 1;
 271     const IfMauAutoNegRemoteFaultReceivedType IfMauAutoNegRemoteFaultReceivedType_offline = 2;
 272     const IfMauAutoNegRemoteFaultReceivedType IfMauAutoNegRemoteFaultReceivedType_linkFailure = 3;
 273     const IfMauAutoNegRemoteFaultReceivedType IfMauAutoNegRemoteFaultReceivedType_autoNegError = 4;
 274     const string IfMauAutoNegRemoteFaultReceivedType_NameNumberList = "noError (1) , offline (2) , linkFailure (3) , autoNegError (4)";
 275
 276     interface dot3RpMauBasicGroup : SNMPMgmt::SmiEntry {
 277
 278         /*
 279              Table of descriptive and status information
 280              about the MAU(s) attached to the ports of a
 281              repeater.
 282         */
 283         SNMPMgmt::SmiTableIterator get_rpMauTable();
 284
 285         /*
 286              Information about the external jacks attached
 287              to MAUs attached to the ports of a repeater.
 288         */
 289         SNMPMgmt::SmiTableIterator get_rpJackTable();
 290     };
 291
 292
 293     /*
 294              An entry in the table, containing information
 295              about a single MAU.
 296     */
 297     interface rpMauEntry : SNMPMgmt::SmiEntry {
 298
 299         const string IndexVarList = "rpMauGroupIndex rpMauPortIndex rpMauIndex";
 300
 301         /*
 302              This variable uniquely identifies the group
 303              containing the port to which the MAU described
 304              by this entry is connected.
 305
 306              Note:  In practice, a group will generally be
 307              a field-replaceable unit (i.e., module, card,
 308              or board) that can fit in the physical system
 309              enclosure, and the group number will correspond
 310              to a number marked on the physical enclosure.
 311
 312              The group denoted by a particular value of this
 313              object is the same as the group denoted by the
 314              same value of rptrGroupIndex.
 315         REFERENCE:
 316             "RFC 2108, rptrGroupIndex."
 317
 318         */
 319         readonly attribute RpMauGroupIndexType rpMauGroupIndex;
 320
 321         /*
 322              This variable uniquely identifies the repeater
 323              port within group rpMauGroupIndex to which the
 324              MAU described by this entry is connected.
 325         REFERENCE:
 326             "RFC 2108, rptrPortIndex."
 327
 328         */
 329         readonly attribute RpMauPortIndexType rpMauPortIndex;
 330
 331         /*
 332              This variable uniquely identifies the MAU
 333              described by this entry from among other
 334              MAUs connected to the same port
 335              (rpMauPortIndex).
 336         REFERENCE:
 337             "[IEEE802.3], 30.5.1.1.1, aMAUID."
 338
 339         */
 340         readonly attribute RpMauIndexType rpMauIndex;
 341
 342         /*
 343              This object identifies the MAU type.  Values for
 344              standard IEEE 802.3 MAU types are defined in the
 345              IANA maintained IANA-MAU-MIB module, as
 346              OBJECT-IDENTITIES of dot3MauType.
 347              If the MAU type is unknown, the object identifier
 348              zeroDotZero is returned.
 349         REFERENCE:
 350             "[IEEE802.3], 30.5.1.1.2, aMAUType."
 351
 352         */
 353         readonly attribute AutonomousTypeType rpMauType;
 354
 355         /*
 356              The current state of the MAU.  This object MAY
 357              be implemented as a read-only object by those
 358              agents and MAUs that do not implement software
 359              control of the MAU state.  Some agents may not
 360              support setting the value of this object to some
 361              of the enumerated values.
 362
 363              The value other(1) is returned if the MAU is in
 364              a state other than one of the states 2 through
 365              6.
 366
 367
 368
 369              The value unknown(2) is returned when the MAU's
 370              true state is unknown; for example, when it is
 371              being initialized.
 372
 373              A MAU in the operational(3) state is fully
 374              functional; it operates, and passes signals to its
 375              attached DTE or repeater port in accordance to
 376              its specification.
 377
 378              A MAU in standby(4) state forces DI and CI to
 379              idle, and the media transmitter to idle or fault,
 380              if supported.  Standby(4) mode only applies to
 381              link type MAUs.  The state of
 382              rpMauMediaAvailable is unaffected.
 383
 384              A MAU in shutdown(5) state assumes the same
 385              condition on DI, CI, and the media transmitter,
 386              as though it were powered down or not connected.
 387              The MAU MAY return other(1) value for the
 388              rpMauJabberState and rpMauMediaAvailable objects
 389              when it is in this state.  For an AUI, this
 390              state will remove power from the AUI.
 391
 392              Setting this variable to the value reset(6)
 393              resets the MAU in the same manner as a
 394              power-off, power-on cycle of at least one-half
 395              second would.  The agent is not required to
 396              return the value reset(6).
 397
 398              Setting this variable to the value
 399              operational(3), standby(4), or shutdown(5)
 400              causes the MAU to assume the respective state,
 401              except that setting a mixing-type MAU or an AUI
 402              to standby(4) will cause the MAU to enter the
 403              shutdown state.
 404         REFERENCE:
 405             "[IEEE802.3], 30.5.1.1.7, aMAUAdminState,
 406              30.5.1.2.2, acMAUAdminControl, and 30.5.1.2.1,
 407              acResetMAU."
 408
 409         */
 410         attribute RpMauStatusType rpMauStatus;
 411
 412         /*
 413              This object identifies Media Available state of
 414              the MAU, complementary to the rpMauStatus.  Values
 415              for the standard IEEE 802.3 Media Available states
 416              are defined in the IANA maintained IANA-MAU-MIB
 417
 418
 419
 420              module, as IANAifMauMediaAvailable TC.
 421         REFERENCE:
 422             "[IEEE802.3], 30.5.1.1.4, aMediaAvailable."
 423
 424         */
 425         readonly attribute IANAifMauMediaAvailableType rpMauMediaAvailable;
 426
 427         /*
 428              A count of the number of times that
 429              rpMauMediaAvailable for this MAU instance leaves
 430              the state available(3).
 431
 432              Discontinuities in the value of this counter can
 433              occur at re-initialization of the management
 434              system and at other times, as indicated by the
 435              value of rptrMonitorPortLastChange.
 436         REFERENCE:
 437             "[IEEE802.3], 30.5.1.1.5, aLoseMediaCounter.
 438              RFC 2108, rptrMonitorPortLastChange"
 439
 440         */
 441         readonly attribute Counter32Type rpMauMediaAvailableStateExits;
 442
 443         /*
 444              The value other(1) is returned if the jabber
 445              state is not 2, 3, or 4.  The agent MUST always
 446              return other(1) for MAU type dot3MauTypeAUI.
 447
 448              The value unknown(2) is returned when the MAU's
 449              true state is unknown; for example, when it is
 450              being initialized.
 451
 452              If the MAU is not jabbering the agent returns
 453              noJabber(3).  This is the 'normal' state.
 454
 455              If the MAU is in jabber state the agent returns
 456              the jabbering(4) value.
 457         REFERENCE:
 458             "[IEEE802.3], 30.5.1.1.6, aJabber.jabberFlag."
 459
 460         */
 461         readonly attribute RpMauJabberStateType rpMauJabberState;
 462
 463         /*
 464              A count of the number of times that
 465              mauJabberState for this MAU instance enters the
 466              state jabbering(4).  For MAUs of type
 467              dot3MauTypeAUI, dot3MauType100BaseT4,
 468              dot3MauType100BaseTX, dot3MauType100BaseFX, and
 469              all 1000Mbps types, this counter will always
 470              indicate zero.
 471
 472              Discontinuities in the value of this counter can
 473              occur at re-initialization of the management
 474              system and at other times, as indicated by the
 475              value of rptrMonitorPortLastChange.
 476         REFERENCE:
 477             "[IEEE802.3], 30.5.1.1.6, aJabber.jabberCounter.
 478              RFC 2108, rptrMonitorPortLastChange"
 479
 480         */
 481         readonly attribute Counter32Type rpMauJabberingStateEnters;
 482
 483         /*
 484              A count of the number of false carrier events
 485              during IDLE in 100BASE-X links.  This counter
 486              does not increment at the symbol rate.  It can
 487              increment after a valid carrier completion at a
 488              maximum rate of once per 100 ms until the next
 489              carrier event.
 490
 491              This counter increments only for MAUs of type
 492              dot3MauType100BaseT4, dot3MauType100BaseTX,
 493              dot3MauType100BaseFX, and all 1000Mbps types.
 494
 495              For all other MAU types, this counter will
 496              always indicate zero.
 497
 498              The approximate minimum time for rollover of
 499              this counter is 7.4 hours.
 500
 501              Discontinuities in the value of this counter can
 502              occur at re-initialization of the management
 503              system and at other times, as indicated by the
 504              value of rptrMonitorPortLastChange.
 505         REFERENCE:
 506             "[IEEE802.3], 30.5.1.1.10, aFalseCarriers.
 507              RFC 2108, rptrMonitorPortLastChange"
 508
 509         */
 510         readonly attribute Counter32Type rpMauFalseCarriers;
 511     };
 512
 513
 514     /*
 515              An entry in the table, containing information
 516              about a particular jack.
 517     */
 518     interface rpJackEntry : SNMPMgmt::SmiEntry {
 519
 520         const string IndexVarList = "rpMauGroupIndex rpMauPortIndex rpMauIndex rpJackIndex";
 521
 522         /*
 523              The jack connector type, as it appears on the
 524              outside of the system.
 525         */
 526         readonly attribute IANAifJackTypeType rpJackType;
 527     };
 528
 529     interface dot3IfMauBasicGroup : SNMPMgmt::SmiEntry {
 530
 531         /*
 532              Table of descriptive and status information
 533              about MAU(s) attached to an interface.
 534         */
 535         SNMPMgmt::SmiTableIterator get_ifMauTable();
 536
 537         /*
 538              Information about the external jacks attached
 539              to MAUs attached to an interface.
 540         */
 541         SNMPMgmt::SmiTableIterator get_ifJackTable();
 542     };
 543
 544
 545     /*
 546              An entry in the table, containing information
 547              about a single MAU.
 548     */
 549     interface ifMauEntry : SNMPMgmt::SmiEntry {
 550
 551         const string IndexVarList = "ifMauIfIndex ifMauIndex";
 552
 553         /*
 554              This variable uniquely identifies the interface
 555              to which the MAU described by this entry is
 556              connected.
 557         REFERENCE:
 558             "RFC 2863, ifIndex"
 559
 560         */
 561         readonly attribute InterfaceIndexType ifMauIfIndex;
 562
 563         /*
 564              This variable uniquely identifies the MAU
 565              described by this entry from among other MAUs
 566              connected to the same interface (ifMauIfIndex).
 567         REFERENCE:
 568             "[IEEE802.3], 30.5.1.1.1, aMAUID."
 569
 570         */
 571         readonly attribute IfMauIndexType ifMauIndex;
 572
 573         /*
 574              This object identifies the MAU type.  Values for
 575              standard IEEE 802.3 MAU types are defined in the
 576              IANA maintained IANA-MAU-MIB module, as
 577              OBJECT-IDENTITIES of dot3MauType.
 578              If the MAU type is unknown, the object identifier
 579              zeroDotZero is returned.
 580
 581              This object represents the operational type of
 582              the MAU, as determined by either 1) the result
 583              of the auto-negotiation function or 2) if
 584              auto-negotiation is not enabled or is not
 585              implemented for this MAU, by the value of the
 586              object ifMauDefaultType.  In case 2), a set to
 587              the object ifMauDefaultType will force the MAU
 588              into the new operating mode.
 589         REFERENCE:
 590             "[IEEE802.3], 30.5.1.1.2, aMAUType."
 591
 592         */
 593         readonly attribute AutonomousTypeType ifMauType;
 594
 595         /*
 596              The current state of the MAU.  This object MAY
 597              be implemented as a read-only object by those
 598              agents and MAUs that do not implement software
 599              control of the MAU state.  Some agents may not
 600
 601
 602
 603              support setting the value of this object to some
 604              of the enumerated values.
 605
 606              The value other(1) is returned if the MAU is in
 607              a state other than one of the states 2 through
 608              6.
 609
 610              The value unknown(2) is returned when the MAU's
 611              true state is unknown; for example, when it is
 612              being initialized.
 613
 614              A MAU in the operational(3) state is fully
 615              functional; it operates, and passes signals to its
 616              attached DTE or repeater port in accordance to
 617              its specification.
 618
 619              A MAU in standby(4) state forces DI and CI to
 620              idle and the media transmitter to idle or fault,
 621              if supported.  Standby(4) mode only applies to
 622              link type MAUs.  The state of
 623              ifMauMediaAvailable is unaffected.
 624
 625              A MAU in shutdown(5) state assumes the same
 626              condition on DI, CI, and the media transmitter,
 627              as though it were powered down or not connected.
 628              The MAU MAY return other(1) value for the
 629              ifMauJabberState and ifMauMediaAvailable objects
 630              when it is in this state.  For an AUI, this
 631              state will remove power from the AUI.
 632
 633              Setting this variable to the value reset(6)
 634              resets the MAU in the same manner as a
 635              power-off, power-on cycle of at least one-half
 636              second would.  The agent is not required to
 637              return the value reset(6).
 638
 639              Setting this variable to the value
 640              operational(3), standby(4), or shutdown(5)
 641              causes the MAU to assume the respective state,
 642              except that setting a mixing-type MAU or an AUI
 643              to standby(4) will cause the MAU to enter the
 644              shutdown state.
 645         REFERENCE:
 646             "[IEEE802.3], 30.5.1.1.7, aMAUAdminState,
 647              30.5.1.2.2, acMAUAdminControl, and 30.5.1.2.1,
 648              acResetMAU."
 649
 650         */
 651         attribute IfMauStatusType ifMauStatus;
 652
 653         /*
 654              This object identifies Media Available state of
 655              the MAU, complementary to the ifMauStatus.  Values
 656              for the standard IEEE 802.3 Media Available states
 657              are defined in the IANA maintained IANA-MAU-MIB
 658              module, as IANAifMauMediaAvailable TC.
 659         REFERENCE:
 660             "[IEEE802.3], 30.5.1.1.4, aMediaAvailable."
 661
 662         */
 663         readonly attribute IANAifMauMediaAvailableType ifMauMediaAvailable;
 664
 665         /*
 666              A count of the number of times that
 667              ifMauMediaAvailable for this MAU instance leaves
 668              the state available(3).
 669
 670              Discontinuities in the value of this counter can
 671              occur at re-initialization of the management
 672              system and at other times, as indicated by the
 673              value of ifCounterDiscontinuityTime.
 674         REFERENCE:
 675             "[IEEE802.3], 30.5.1.1.5, aLoseMediaCounter.
 676              RFC 2863, ifCounterDiscontinuityTime."
 677
 678         */
 679         readonly attribute Counter32Type ifMauMediaAvailableStateExits;
 680
 681         /*
 682              The value other(1) is returned if the jabber
 683              state is not 2, 3, or 4.  The agent MUST always
 684              return other(1) for MAU type dot3MauTypeAUI.
 685
 686              The value unknown(2) is returned when the MAU's
 687              true state is unknown; for example, when it is
 688              being initialized.
 689
 690              If the MAU is not jabbering the agent returns
 691              noJabber(3).  This is the 'normal' state.
 692
 693              If the MAU is in jabber state the agent returns
 694
 695
 696
 697              the jabbering(4) value.
 698         REFERENCE:
 699             "[IEEE802.3], 30.5.1.1.6, aJabber.jabberFlag."
 700
 701         */
 702         readonly attribute IfMauJabberStateType ifMauJabberState;
 703
 704         /*
 705              A count of the number of times that
 706              mauJabberState for this MAU instance enters the
 707              state jabbering(4).  This counter will always
 708              indicate zero for MAUs of type dot3MauTypeAUI
 709              and those of speeds above 10Mbps.
 710
 711              Discontinuities in the value of this counter can
 712              occur at re-initialization of the management
 713              system and at other times, as indicated by the
 714              value of ifCounterDiscontinuityTime.
 715         REFERENCE:
 716             "[IEEE802.3], 30.5.1.1.6, aJabber.jabberCounter.
 717              RFC 2863, ifCounterDiscontinuityTime."
 718
 719         */
 720         readonly attribute Counter32Type ifMauJabberingStateEnters;
 721
 722         /*
 723              A count of the number of false carrier events
 724              during IDLE in 100BASE-X and 1000BASE-X links.
 725
 726              For all other MAU types, this counter will
 727              always indicate zero.  This counter does not
 728              increment at the symbol rate.
 729
 730              It can increment after a valid carrier
 731              completion at a maximum rate of once per 100 ms
 732              for 100BASE-X and once per 10us for 1000BASE-X
 733              until the next CarrierEvent.
 734
 735              This counter can roll over very quickly.  A
 736              management station is advised to poll the
 737              ifMauHCFalseCarriers instead of this counter in
 738              order to avoid loss of information.
 739
 740              Discontinuities in the value of this counter can
 741              occur at re-initialization of the management
 742              system and at other times, as indicated by the
 743              value of ifCounterDiscontinuityTime.
 744         REFERENCE:
 745             "[IEEE802.3], 30.5.1.1.10, aFalseCarriers.
 746
 747
 748
 749              RFC 2863, ifCounterDiscontinuityTime."
 750
 751         */
 752         readonly attribute Counter32Type ifMauFalseCarriers;
 753
 754         /*
 755              This object identifies the default
 756              administrative baseband MAU type to be used in
 757              conjunction with the operational MAU type
 758              denoted by ifMauType.
 759
 760              The set of possible values for this object is
 761              the same as the set defined for the ifMauType
 762              object.
 763
 764              This object represents the
 765              administratively-configured type of the MAU.  If
 766              auto-negotiation is not enabled or is not
 767              implemented for this MAU, the value of this
 768              object determines the operational type of the
 769              MAU.  In this case, a set to this object will
 770              force the MAU into the specified operating mode.
 771
 772              If auto-negotiation is implemented and enabled
 773              for this MAU, the operational type of the MAU
 774              is determined by auto-negotiation, and the value
 775              of this object denotes the type to which the MAU
 776              will automatically revert if/when
 777              auto-negotiation is later disabled.
 778
 779              NOTE TO IMPLEMENTORS:  It may be necessary to
 780              provide for underlying hardware implementations
 781              which do not follow the exact behavior specified
 782              above.  In particular, when
 783              ifMauAutoNegAdminStatus transitions from enabled
 784              to disabled, the agent implementation MUST
 785              ensure that the operational type of the MAU (as
 786              reported by ifMauType) correctly transitions to
 787              the value specified by this object, rather than
 788              continuing to operate at the value earlier
 789              determined by the auto-negotiation function.
 790         REFERENCE:
 791             "[IEEE802.3], 30.5.1.1.1, aMAUID, and 22.2.4.1.4."
 792
 793         */
 794         attribute AutonomousTypeType ifMauDefaultType;
 795
 796         /*
 797              This object indicates whether or not
 798              auto-negotiation is supported on this MAU.
 799         */
 800         readonly attribute TruthValueType ifMauAutoNegSupported;
 801
 802         /*
 803              A value that uniquely identifies the set of
 804              possible IEEE 802.3 types that the MAU could be.
 805              If auto-negotiation is present on this MAU, this
 806              object will map to ifMauAutoNegCapabilityBits.
 807
 808              Note that this MAU may be capable of operating
 809              as a MAU type that is beyond the scope of this
 810              MIB.  This is indicated by returning the
 811              bit value bOther in addition to any bit values
 812              for standard capabilities that are listed in the
 813              IANAifMauTypeListBits TC.
 814         */
 815         readonly attribute IANAifMauTypeListBitsType ifMauTypeListBits;
 816
 817         /*
 818              A count of the number of false carrier events
 819              during IDLE in 100BASE-X and 1000BASE-X links.
 820
 821              For all other MAU types, this counter will
 822              always indicate zero.  This counter does not
 823              increment at the symbol rate.
 824
 825              This counter is a 64-bit version of
 826              ifMauFalseCarriers.  Since the 32-bit version of
 827              this counter can roll over very quickly,
 828              management stations are advised to poll the
 829              64-bit version instead, in order to avoid loss
 830              of information.
 831
 832              Discontinuities in the value of this counter can
 833              occur at re-initialization of the management
 834              system and at other times, as indicated by the
 835              value of ifCounterDiscontinuityTime.
 836         REFERENCE:
 837             "[IEEE802.3], 30.5.1.1.10, aFalseCarriers.
 838
 839
 840
 841              RFC 2863, ifCounterDiscontinuityTime."
 842
 843         */
 844         readonly attribute Counter64Type ifMauHCFalseCarriers;
 845     };
 846
 847
 848     /*
 849              An entry in the table, containing information
 850              about a particular jack.
 851     */
 852     interface ifJackEntry : SNMPMgmt::SmiEntry {
 853
 854         const string IndexVarList = "ifMauIfIndex ifMauIndex ifJackIndex";
 855
 856         /*
 857              The jack connector type, as it appears on the
 858              outside of the system.
 859         */
 860         readonly attribute IANAifJackTypeType ifJackType;
 861     };
 862
 863     interface dot3IfMauAutoNegGroup : SNMPMgmt::SmiEntry {
 864
 865         /*
 866              Configuration and status objects for the
 867              auto-negotiation function of MAUs attached to
 868              interfaces.
 869
 870              The ifMauAutoNegTable applies to systems in
 871              which auto-negotiation is supported on one or
 872              more MAUs attached to interfaces.  Note that if
 873              auto-negotiation is present and enabled, the
 874              ifMauType object reflects the result of the
 875              auto-negotiation function.
 876         */
 877         SNMPMgmt::SmiTableIterator get_ifMauAutoNegTable();
 878     };
 879
 880
 881     /*
 882              An entry in the table, containing configuration
 883              and status information for the auto-negotiation
 884              function of a particular MAU.
 885     */
 886     interface ifMauAutoNegEntry : SNMPMgmt::SmiEntry {
 887
 888         const string IndexVarList = "ifMauIfIndex ifMauIndex";
 889
 890         /*
 891              Setting this object to enabled(1) will cause
 892              the interface that has the auto-negotiation
 893              signaling ability to be enabled.
 894
 895              If the value of this object is disabled(2) then
 896              the interface will act as it would if it had no
 897              auto-negotiation signaling.  Under these
 898              conditions, an IEEE 802.3 MAU will immediately
 899              be forced to the state indicated by the value of
 900              the object ifMauDefaultType.
 901
 902              NOTE TO IMPLEMENTORS:  When
 903              ifMauAutoNegAdminStatus transitions from enabled
 904              to disabled, the agent implementation MUST
 905              ensure that the operational type of the MAU (as
 906              reported by ifMauType) correctly transitions to
 907              the value specified by the ifMauDefaultType
 908              object, rather than continuing to operate at the
 909              value earlier determined by the auto-negotiation
 910              function.
 911         REFERENCE:
 912             "[IEEE802.3], 30.6.1.1.2, aAutoNegAdminState,
 913              and 30.6.1.2.2, acAutoNegAdminControl."
 914
 915         */
 916         attribute IfMauAutoNegAdminStatusType ifMauAutoNegAdminStatus;
 917
 918         /*
 919              A value indicating whether the remote end of
 920              the link is using auto-negotiation signaling.  It
 921              takes the value detected(1) if and only if,
 922              during the previous link negotiation, FLP Bursts
 923              were received.
 924         REFERENCE:
 925             "[IEEE802.3], 30.6.1.1.3,
 926              aAutoNegRemoteSignaling."
 927
 928         */
 929         readonly attribute IfMauAutoNegRemoteSignalingType ifMauAutoNegRemoteSignaling;
 930
 931         /*
 932              A value indicating the current status of the
 933              auto-negotiation process.  The enumeration
 934              parallelDetectFail(5) maps to a failure in
 935              parallel detection as defined in 28.2.3.1 of
 936              [IEEE802.3].
 937         REFERENCE:
 938             "[IEEE802.3], 30.6.1.1.4, aAutoNegAutoConfig."
 939
 940         */
 941         readonly attribute IfMauAutoNegConfigType ifMauAutoNegConfig;
 942
 943         /*
 944              If the value of this object is set to
 945              restart(1) then this will force auto-negotiation
 946              to begin link renegotiation.  If auto-negotiation
 947              signaling is disabled, a write to this object
 948              has no effect.
 949              Setting the value of this object to norestart(2)
 950              has no effect.
 951         REFERENCE:
 952             "[IEEE802.3], 30.6.1.2.1,
 953              acAutoNegRestartAutoConfig."
 954
 955         */
 956         attribute IfMauAutoNegRestartType ifMauAutoNegRestart;
 957
 958         /*
 959              A value that uniquely identifies the set of
 960              capabilities of the local auto-negotiation
 961              entity.  Note that interfaces that support this
 962              MIB may have capabilities that extend beyond the
 963              scope of this MIB.
 964
 965              Note that the local auto-negotiation entity may
 966              support some capabilities beyond the scope of
 967              this MIB.  This is indicated by returning the
 968              bit value bOther in addition to any bit values
 969              for standard capabilities that are listed in the
 970              IANAifMauAutoNegCapBits TC.
 971         REFERENCE:
 972             "[IEEE802.3], 30.6.1.1.5,
 973              aAutoNegLocalTechnologyAbility."
 974
 975         */
 976         readonly attribute IANAifMauAutoNegCapBitsType ifMauAutoNegCapabilityBits;
 977
 978         /*
 979              A value that uniquely identifies the set of
 980              capabilities advertised by the local
 981              auto-negotiation entity.
 982
 983              Capabilities in this object that are not
 984              available in ifMauAutoNegCapabilityBits cannot
 985              be enabled.
 986
 987              Note that the local auto-negotiation entity may
 988              advertise some capabilities beyond the scope of
 989              this MIB.  This is indicated by returning the
 990              bit value bOther in addition to any bit values
 991              for standard capabilities that are listed in the
 992              IANAifMauAutoNegCapBits TC.
 993         REFERENCE:
 994             "[IEEE802.3], 30.6.1.1.6,
 995              aAutoNegAdvertisedTechnologyAbility."
 996
 997         */
 998         attribute IANAifMauAutoNegCapBitsType ifMauAutoNegCapAdvertisedBits;
 999
1000         /*
1001              A value that uniquely identifies the set of
1002              capabilities received from the remote
1003              auto-negotiation entity.
1004              Note that interfaces that support this MIB may
1005              be attached to remote auto-negotiation entities
1006              that have capabilities beyond the scope of this
1007              MIB.  This is indicated by returning the bit
1008              value bOther in addition to any bit values for
1009              standard capabilities that are listed in the
1010              IANAifMauAutoNegCapBits TC.
1011         REFERENCE:
1012             "[IEEE802.3], 30.6.1.1.7,
1013              aAutoNegReceivedTechnologyAbility."
1014
1015         */
1016         readonly attribute IANAifMauAutoNegCapBitsType ifMauAutoNegCapReceivedBits;
1017
1018         /*
1019              A value that identifies any local fault
1020              indications that this MAU has detected and will
1021              advertise at the next auto-negotiation
1022              interaction for 1000Mbps MAUs.
1023         REFERENCE:
1024             "[IEEE802.3], 30.6.1.1.6,
1025              aAutoNegAdvertisedTechnologyAbility."
1026
1027         */
1028         attribute IfMauAutoNegRemoteFaultAdvertisedType ifMauAutoNegRemoteFaultAdvertised;
1029
1030         /*
1031              A value that identifies any fault indications
1032              received from the far end of a link by the
1033              local auto-negotiation entity for 1000Mbps
1034              MAUs.
1035         REFERENCE:
1036             "[IEEE802.3], 30.6.1.1.7,
1037              aAutoNegReceivedTechnologyAbility."
1038
1039         */
1040         readonly attribute IfMauAutoNegRemoteFaultReceivedType ifMauAutoNegRemoteFaultReceived;
1041     };
1042
1043     struct RpMauJabberStateVBType {
1044         string var_name;
1045         string var_index;
1046         RpMauJabberStateType rpMauJabberState;
1047     };
1048
1049     struct IfMauJabberStateVBType {
1050         string var_name;
1051         string var_index;
1052         IfMauJabberStateType ifMauJabberState;
1053     };
1054
1055     struct RpMauJabberTrapType {
1056         RpMauJabberStateVBType rpMauJabberState;
1057     };
1058
1059     struct IfMauJabberTrapType {
1060         IfMauJabberStateVBType ifMauJabberState;
1061     };
1062
1063     /* typed push event communication */
1064     interface Notifications : SNMPMgmt::Notifications {
1065
1066         /*
1067              This trap is sent whenever a managed repeater
1068              MAU enters the jabber state.
1069
1070              The agent MUST throttle the generation of
1071              consecutive rpMauJabberTraps so that there is at
1072              least a five-second gap between them.
1073         REFERENCE:
1074             "[IEEE802.3], 30.5.1.3.1, nJabber notification."
1075
1076         */
1077         void rpMauJabberTrap (
1078             in CosNaming::Name src_entry_name,
1079             in CORBA::ScopedName event_type,
1080             in ASN1_GeneralizedTime event_time,
1081             in RpMauJabberTrapType notification_info
1082         );
1083
1084         /*
1085              This trap is sent whenever a managed interface
1086              MAU enters the jabber state.
1087
1088              The agent MUST throttle the generation of
1089              consecutive ifMauJabberTraps so that there is at
1090              least a five-second gap between them.
1091         REFERENCE:
1092             "[IEEE802.3], 30.5.1.3.1, nJabber notification."
1093
1094         */
1095         void ifMauJabberTrap (
1096             in CosNaming::Name src_entry_name,
1097             in CORBA::ScopedName event_type,
1098             in ASN1_GeneralizedTime event_time,
1099             in IfMauJabberTrapType notification_info
1100         );
1101     };
1102
1103     /* typed pull event communication */
1104     interface PullNotifications : SNMPMgmt::PullNotifications {
1105
1106         /*
1107              This trap is sent whenever a managed repeater
1108              MAU enters the jabber state.
1109
1110              The agent MUST throttle the generation of
1111              consecutive rpMauJabberTraps so that there is at
1112              least a five-second gap between them.
1113         REFERENCE:
1114             "[IEEE802.3], 30.5.1.3.1, nJabber notification."
1115
1116         */
1117         void pull_rpMauJabberTrap (
1118             out CosNaming::Name src_entry_name,
1119             out CORBA::ScopedName event_type,
1120             out ASN1_GeneralizedTime event_time,
1121             out RpMauJabberTrapType notification_info
1122         );
1123         boolean try_rpMauJabberTrap (
1124             out CosNaming::Name src_entry_name,
1125             out CORBA::ScopedName event_type,
1126             out ASN1_GeneralizedTime event_time,
1127             out RpMauJabberTrapType notification_info
1128         );
1129
1130         /*
1131              This trap is sent whenever a managed interface
1132              MAU enters the jabber state.
1133
1134              The agent MUST throttle the generation of
1135              consecutive ifMauJabberTraps so that there is at
1136              least a five-second gap between them.
1137         REFERENCE:
1138             "[IEEE802.3], 30.5.1.3.1, nJabber notification."
1139
1140         */
1141         void pull_ifMauJabberTrap (
1142             out CosNaming::Name src_entry_name,
1143             out CORBA::ScopedName event_type,
1144             out ASN1_GeneralizedTime event_time,
1145             out IfMauJabberTrapType notification_info
1146         );
1147         boolean try_ifMauJabberTrap (
1148             out CosNaming::Name src_entry_name,
1149             out CORBA::ScopedName event_type,
1150             out ASN1_GeneralizedTime event_time,
1151             out IfMauJabberTrapType notification_info
1152         );
1153     };
1154
1155     interface SmiEntryFactory : SNMPMgmt::GenericFactory {
1156
1157         rpMauEntry create_rpMauEntry (
1158             in RpMauGroupIndexType rpMauGroupIndex,
1159             in RpMauPortIndexType rpMauPortIndex,
1160             in RpMauIndexType rpMauIndex,
1161             in RpMauStatusType rpMauStatus
1162         ) raises (
1163             SNMPMgmt::AlreadyExists,
1164             CosLifeCycle::InvalidCriteria,
1165             CosLifeCycle::CannotMeetCriteria
1166         );
1167
1168         ifMauEntry create_ifMauEntry (
1169             in InterfaceIndexType ifMauIfIndex,
1170             in IfMauIndexType ifMauIndex,
1171             in IfMauStatusType ifMauStatus,
1172             in AutonomousTypeType ifMauDefaultType
1173         ) raises (
1174             SNMPMgmt::AlreadyExists,
1175             CosLifeCycle::InvalidCriteria,
1176             CosLifeCycle::CannotMeetCriteria
1177         );
1178
1179         ifMauAutoNegEntry create_ifMauAutoNegEntry (
1180             in InterfaceIndexType ifMauIfIndex,
1181             in IfMauIndexType ifMauIndex,
1182             in IfMauAutoNegAdminStatusType ifMauAutoNegAdminStatus,
1183             in IfMauAutoNegRestartType ifMauAutoNegRestart,
1184             in IANAifMauAutoNegCapBitsType ifMauAutoNegCapAdvertisedBits,
1185             in IfMauAutoNegRemoteFaultAdvertisedType ifMauAutoNegRemoteFaultAdvertised
1186         ) raises (
1187             SNMPMgmt::AlreadyExists,
1188             CosLifeCycle::InvalidCriteria,
1189             CosLifeCycle::CannotMeetCriteria
1190         );
1191     };
1192
1193 };
1194
1195 #endif /* !_MAU_MIB_IDL_ */