module ieee802-dot1q-rstp {

    yang-version 1.1;

    namespace
      "urn:ieee:std:802.1Q:yang:ieee802-dot1q-rstp";

    prefix rstp;

    import ietf-yang-types {
      prefix yang;
    }
    import ietf-interfaces {
      prefix if;
    }
    import ieee802-types {
      prefix ieee;
    }

    organization "IEEE 802.1 Working Group";

    contact
      "WG-URL: http://www.ieee802.org/1/
WG-EMail: stds-802-1-l@ieee.org

Contact: IEEE 802.1 Working Group Chair
Postal: C/O IEEE 802.1 Working Group
       IEEE Standards Association
       445 Hoes Lane
       Piscataway, NJ 08854
       USA

E-mail: stds-802-1-chairs@ieee.org";

    description
      "This module provides management of IEEE Std 802.1Q Bridge components
that support the Rapid Spanning Tree Algorithm and Protocol (RSTP).
The managed objects specified also support those aspects of Multiple
Spanning Tree Algorithm and Protocol (MSTP) and Shortest Path Bridging
(SPB) operation that provide plug-and-play interoperability with RSTP.

References specify constraints on, and consequences of, settings of
leaf values and the creation and deletion of list entries. The values
of all configured objects are retained across system reinitialization.

Copyright (C) IEEE (2025).

This version of this YANG module is part of IEEE Std 802.1Q; see the
standard itself for full legal notices.";

    revision "2025-02-04" {
      description
        "Published as part of IEEE Std 802.1Qdy-2025.

The following reference statement identifies each referenced IEEE
Standard as updated by applicable amendments.";
      reference
        "IEEE Std 802.1Q Bridges and Bridged Networks:
        IEEE Std 802.1Q-2022, IEEE Std 802.1Qcz-2023,
        IEEE Std 802.1Qcw-2023, IEEE Std 802.1Qcj-2023,
        IEEE Std 802.1Qdj-2024, IEEE Std 802.1Qdx-2024,
        IEEE Std 802.1Qdy-2025.";

    }


    typedef id-priority {
      type uint8 {
        range "0..15";
      }
      default "8";
      description
        "Priority for Bridge and Bridge Port identifiers. Lower numeric
values indicate the better identifier.";
    }

    typedef id-port-number {
      type uint16 {
        range "0..4095";
      }
      description
        "A system assigned Bridge Port number, unique in the context of
a Bridge component, used in a Port Identifier.";
    }

    typedef port-state {
      type enumeration {
        enum "discarding" {
          value 1;
          description
            "Received frames are not submitted to the Learning Process or
to the Forwarding Process. The Forwarding Process does not relay
frames to the port for transmission. The Discarding state
includes an inability to receive or transmit frames or BPDUs
because MAC_Operational is false (if:oper-status not up).";
        }
        enum "learning" {
          value 2;
          description
            "Received frames are submitted to the Learning Process, but not
to the Forwarding Process. The Forwarding Process does not
relay frames to the port for transmission.";
        }
        enum "forwarding" {
          value 3;
          description
            "Received frames are submitted to the Learning Process and the
Forwarding Process. The Forwarding Process can relay frames to
the port for transmission.";
        }
      }
      description
        "The Port State for frames assigned to a given spanning tree,
governing submission of frames received by the port to the Learning
and Forwarding Processes and relay of frames to the port by the
Forwarding Process.";
      reference
        "8.4, 8.6, 8.7, 13.4, and items aw) and ba) in 13.27
        of IEEE Std 802.1Q.";

    }

    typedef port-role {
      type enumeration {
        enum "disabled-port" {
          value 1;
          description
            "The port's MAC_Operational status is false (if:oper-status not
up), or admin-bridge-port-enabled is false.";
        }
        enum "root-port" {
          value 2;
          description "The Root Port.";
        }
        enum "designated-port" {
          value 3;
          description "A Designated Port.";
        }
        enum "alternate-port" {
          value 4;
          description "An Alternate Port.";
        }
        enum "backup-port" {
          value 5;
          description "A Backup Port.";
        }
      }
      description
        "The Port Role assigned by the Bridge's spanning tree protocol entity
for a given spanning tree.";
      reference
        "13.4, 13.5, 13.12, 13.24, 13.27.66, and item bn) in 13.27
        of IEEE Std 802.1Q.";

    }
  }  // module ieee802-dot1q-rstp