module openconfig-interfaces {

    yang-version 1;

    namespace
      "http://openconfig.net/yang/interfaces";

    prefix oc-if;

    import ietf-interfaces {
      prefix ietf-if;
    }
    import openconfig-yang-types {
      prefix oc-yang;
    }
    import openconfig-types {
      prefix oc-types;
    }
    import openconfig-extensions {
      prefix oc-ext;
    }
    import openconfig-transport-types {
      prefix oc-opt-types;
    }

    organization "OpenConfig working group";

    contact
      "OpenConfig working group
netopenconfig@googlegroups.com";

    description
      "Model for managing network interfaces and subinterfaces.  This
module also defines convenience types / groupings for other
models to create references to interfaces:

 base-interface-ref (type) -  reference to a base interface
 interface-ref (grouping) -  container for reference to a
   interface + subinterface
 interface-ref-state (grouping) - container for read-only
   (opstate) reference to interface + subinterface

This model reuses data items defined in the IETF YANG model for
interfaces described by RFC 7223 with an alternate structure
(particularly for operational state data) and with
additional configuration items.

Portions of this code were derived from IETF RFC 7223.
Please reproduce this note if possible.

IETF code is subject to the following copyright and license:
Copyright (c) IETF Trust and the persons identified as authors of
the code.
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, is permitted pursuant to, and subject to the license
terms contained in, the Simplified BSD License set forth in
Section 4.c of the IETF Trust's Legal Provisions Relating
to IETF Documents (http://trustee.ietf.org/license-info).";

    revision "2024-04-04" {
      description
        "Use single quotes in descriptions.";
      reference
        "3.7.1";

    }

    revision "2023-11-06" {
      description
        "Clarify description for admin-status TESTING.";
      reference
        "3.7.0";

    }

    revision "2023-08-29" {
      description
        "Add augment for penalty-based additive-increase, exponential-decrease link damping algorithm.";
      reference
        "3.6.0";

    }

    revision "2023-07-14" {
      description
        "Move counters which apply to both interfaces and subinterfaces to
a common grouping.  Deprecate physical counters from subinterface";
      reference
        "3.5.0";

    }

    revision "2023-02-06" {
      description
        "Add further specification to interface-ref type to
clarify that the interface and subinterface leaves
are how an interface is referenced, regardless of
context.";
      reference
        "3.0.2";

    }

    revision "2022-10-25" {
      description
        "change loopback-mode to align with available modes";
      reference
        "3.0.1";

    }

    revision "2021-04-06" {
      description
        "Add leaves for management and cpu interfaces";
      reference
        "2.5.0";

    }

    revision "2019-11-19" {
      description
        "Update description of interface name.";
      reference
        "2.4.3";

    }

    revision "2019-07-10" {
      description
        "Remove redundant nanosecond units statements to reflect
universal definition of timeticks64 type.";
      reference
        "2.4.2";

    }

    revision "2018-11-21" {
      description
        "Add OpenConfig module metadata extensions.";
      reference
        "2.4.1";

    }

    revision "2018-08-07" {
      description
        "Add leaf to indicate whether an interface is physical or
logical.";
      reference
        "2.4.0";

    }

    revision "2018-07-02" {
      description
        "Add in-pkts and out-pkts in counters";
      reference
        "2.3.2";

    }

    revision "2018-04-24" {
      description
        "Clarified behavior of last-change state leaf";
      reference
        "2.3.1";

    }

    revision "2018-01-05" {
      description
        "Add logical loopback to interface.";
      reference
        "2.3.0";

    }

    revision "2017-12-22" {
      description
        "Add IPv4 proxy ARP configuration.";
      reference
        "2.2.0";

    }

    revision "2017-12-21" {
      description
        "Added IPv6 router advertisement configuration.";
      reference
        "2.1.0";

    }

    revision "2017-07-14" {
      description
        "Added Ethernet/IP state data; Add dhcp-client;
migrate to OpenConfig types modules; Removed or
renamed opstate values";
      reference
        "2.0.0";

    }

    revision "2017-04-03" {
      description "Update copyright notice.";
      reference
        "1.1.1";

    }

    revision "2016-12-22" {
      description
        "Fixes to Ethernet interfaces model";
      reference
        "1.1.0";

    }

    oc-ext:openconfig-version "3.7.1";
    oc-ext:regexp-posix;
    oc-ext:catalog-organization "openconfig";
    oc-ext:origin "openconfig";

    typedef base-interface-ref {
      type leafref {
        path "/oc-if:interfaces/oc-if:interface/oc-if:name";
      }
      description
        "Reusable type for by-name reference to a base interface.
This type may be used in cases where ability to reference
a subinterface is not required.";
    }

    typedef interface-id {
      type string;
      description
        "User-defined identifier for an interface, generally used to
name a interface reference.  The id can be arbitrary but a
useful convention is to use a combination of base interface
name and subinterface index.";
    }
  }  // module openconfig-interfaces