test/dumps/yang/MAU-MIB

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