This module defines a set of extensions that provide P4Runtime (P4RT) specific extensions to the OpenConfig data models. Specifically, these parameters for configuration and state provide extensions that control the P4RT service, or allow it to be used alongside other OpenConfig data models.
The P4RT protocol specification is linked from https://p4.org/specs/ under the P4Runtime heading.
openconfig-extensions
openconfig-interfaces
openconfig-platform
openconfig-system-grpc
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).
ietf-interfaces
openconfig-yang-types
openconfig-types
openconfig-extensions
openconfig-transport-types
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.
type: leafref
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.
type: string
description:
Top level container for interfaces, including configuration
and state data.
nodetype: container (rw)
description:
The list of named interfaces on the device.
nodetype: list (rw)
list keys: [name]
description:
References the name of the interface
nodetype: leaf (list key) (rw)
type: leafref
description:
Configurable items at the global, physical interface
level
nodetype: container (rw)
description:
The name of the interface.
A device MAY restrict the allowed values for this leaf,
possibly depending on the type of the interface.
For system-controlled interfaces, this leaf is the
device-specific name of the interface. The 'config false'
list interfaces/interface[name]/state contains the currently
existing interfaces on the device.
If a client tries to create configuration for a
system-controlled interface that is not present in the
corresponding state list, the server MAY reject
the request if the implementation does not support
pre-provisioning of interfaces or if the name refers to
an interface that can never exist in the system. A
NETCONF server MUST reply with an rpc-error with the
error-tag 'invalid-value' in this case.
The IETF model in RFC 7223 provides YANG features for the
following (i.e., pre-provisioning and arbitrary-names),
however they are omitted here:
If the device supports pre-provisioning of interface
configuration, the 'pre-provisioning' feature is
advertised.
If the device allows arbitrarily named user-controlled
interfaces, the 'arbitrary-names' feature is advertised.
When a configured user-controlled interface is created by
the system, it is instantiated with the same name in the
/interfaces/interface[name]/state list.
nodetype: leaf (rw)
type: string
description:
The type of the interface.
When an interface entry is created, a server MAY
initialize the type leaf with a valid value, e.g., if it
is possible to derive the type from the name of the
interface.
If a client tries to set the type of an interface to a
value that can never be used by the system, e.g., if the
type is not supported or if the type does not match the
name of the interface, the server MUST reject the request.
A NETCONF server MUST reply with an rpc-error with the
error-tag 'invalid-value' in this case.
nodetype: leaf (rw)
type: identityref
description:
Set the max transmission unit size in octets
for the physical interface. If this is not set, the mtu is
set to the operational default -- e.g., 1514 bytes on an
Ethernet interface.
nodetype: leaf (rw)
type: uint16
description:
Sets the loopback type on the interface. Setting the
mode to something besides NONE activates the loopback in
the specified mode.
nodetype: leaf (rw)
type: oc-opt-types:loopback-mode-type
description:
A textual description of the interface.
A server implementation MAY map this leaf to the ifAlias
MIB object. Such an implementation needs to use some
mechanism to handle the differences in size and characters
allowed between this leaf and ifAlias. The definition of
such a mechanism is outside the scope of this document.
Since ifAlias is defined to be stored in non-volatile
storage, the MIB implementation MUST map ifAlias to the
value of 'description' in the persistently stored
datastore.
Specifically, if the device supports ':startup', when
ifAlias is read the device MUST return the value of
'description' in the 'startup' datastore, and when it is
written, it MUST be written to the 'running' and 'startup'
datastores. Note that it is up to the implementation to
decide whether to modify this single leaf in 'startup' or
perform an implicit copy-config from 'running' to
'startup'.
If the device does not support ':startup', ifAlias MUST
be mapped to the 'description' leaf in the 'running'
datastore.
nodetype: leaf (rw)
type: string
description:
This leaf contains the configured, desired state of the
interface.
Systems that implement the IF-MIB use the value of this
leaf in the 'running' datastore to set
IF-MIB.ifAdminStatus to 'up' or 'down' after an ifEntry
has been initialized, as described in RFC 2863.
Changes in this leaf in the 'running' datastore are
reflected in ifAdminStatus, but if ifAdminStatus is
changed over SNMP, this leaf is not affected.
nodetype: leaf (rw)
type: boolean
default: true
description:
Optionally set the tag protocol identifier field (TPID) that
is accepted on the VLAN
nodetype: leaf (rw)
type: identityref
default: oc-vlan-types:TPID_0X8100
description:
The numeric identifier (SDN Port) used by the controller to
address the interface. This ID is assigned by an
external-to-the-device entity (e.g., an SDN management system)
to establish an externally deterministic numeric reference for
the interface. The programming entity must ensure that the ID is
unique within the required context.
Note that this identifier is used only when a numeric reference
to the interface is required, it does not replace the unique
name assigned to the interface.
Ranges:
0x00000000: Unspecified/Invalid
0x00000001: Minimum Port Value
0xFFFFFEFF: Maximum Port Value
Reserved: 0xFFFFFFF0 - 0xFFFFFFFF
0xFFFFFFFA: Recirculate
0xFFFFFFFD: CPU
nodetype: leaf (rw)
type: uint32
description:
Operational state data at the global interface level
nodetype: container (ro)
description:
The name of the interface.
A device MAY restrict the allowed values for this leaf,
possibly depending on the type of the interface.
For system-controlled interfaces, this leaf is the
device-specific name of the interface. The 'config false'
list interfaces/interface[name]/state contains the currently
existing interfaces on the device.
If a client tries to create configuration for a
system-controlled interface that is not present in the
corresponding state list, the server MAY reject
the request if the implementation does not support
pre-provisioning of interfaces or if the name refers to
an interface that can never exist in the system. A
NETCONF server MUST reply with an rpc-error with the
error-tag 'invalid-value' in this case.
The IETF model in RFC 7223 provides YANG features for the
following (i.e., pre-provisioning and arbitrary-names),
however they are omitted here:
If the device supports pre-provisioning of interface
configuration, the 'pre-provisioning' feature is
advertised.
If the device allows arbitrarily named user-controlled
interfaces, the 'arbitrary-names' feature is advertised.
When a configured user-controlled interface is created by
the system, it is instantiated with the same name in the
/interfaces/interface[name]/state list.
nodetype: leaf (ro)
type: string
description:
The type of the interface.
When an interface entry is created, a server MAY
initialize the type leaf with a valid value, e.g., if it
is possible to derive the type from the name of the
interface.
If a client tries to set the type of an interface to a
value that can never be used by the system, e.g., if the
type is not supported or if the type does not match the
name of the interface, the server MUST reject the request.
A NETCONF server MUST reply with an rpc-error with the
error-tag 'invalid-value' in this case.
nodetype: leaf (ro)
type: identityref
description:
Set the max transmission unit size in octets
for the physical interface. If this is not set, the mtu is
set to the operational default -- e.g., 1514 bytes on an
Ethernet interface.
nodetype: leaf (ro)
type: uint16
description:
Sets the loopback type on the interface. Setting the
mode to something besides NONE activates the loopback in
the specified mode.
nodetype: leaf (ro)
type: oc-opt-types:loopback-mode-type
description:
A textual description of the interface.
A server implementation MAY map this leaf to the ifAlias
MIB object. Such an implementation needs to use some
mechanism to handle the differences in size and characters
allowed between this leaf and ifAlias. The definition of
such a mechanism is outside the scope of this document.
Since ifAlias is defined to be stored in non-volatile
storage, the MIB implementation MUST map ifAlias to the
value of 'description' in the persistently stored
datastore.
Specifically, if the device supports ':startup', when
ifAlias is read the device MUST return the value of
'description' in the 'startup' datastore, and when it is
written, it MUST be written to the 'running' and 'startup'
datastores. Note that it is up to the implementation to
decide whether to modify this single leaf in 'startup' or
perform an implicit copy-config from 'running' to
'startup'.
If the device does not support ':startup', ifAlias MUST
be mapped to the 'description' leaf in the 'running'
datastore.
nodetype: leaf (ro)
type: string
description:
This leaf contains the configured, desired state of the
interface.
Systems that implement the IF-MIB use the value of this
leaf in the 'running' datastore to set
IF-MIB.ifAdminStatus to 'up' or 'down' after an ifEntry
has been initialized, as described in RFC 2863.
Changes in this leaf in the 'running' datastore are
reflected in ifAdminStatus, but if ifAdminStatus is
changed over SNMP, this leaf is not affected.
nodetype: leaf (ro)
type: boolean
default: true
description:
System assigned number for each interface. Corresponds to
ifIndex object in SNMP Interface MIB
nodetype: leaf (ro)
type: uint32
description:
The desired state of the interface. In RFC 7223 this leaf
has the same read semantics as ifAdminStatus. Here, it
reflects the administrative state as set by enabling or
disabling the interface.
nodetype: leaf (ro)
type: enumeration
description:
The current operational state of the interface.
This leaf has the same semantics as ifOperStatus.
nodetype: leaf (ro)
type: enumeration
description:
This timestamp indicates the absolute time of the last
state change of the interface (e.g., up-to-down transition).
This is different than the SNMP ifLastChange object in the
standard interface MIB in that it is not relative to the
system boot time (i.e,. sysUpTime).
The value is the timestamp in nanoseconds relative to
the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
nodetype: leaf (ro)
type: oc-types:timeticks64
description:
When set to true, the interface is a logical interface
which does not have an associated physical port or
channel on the system.
nodetype: leaf (ro)
type: boolean
description:
When set to true, the interface is a dedicated
management interface that is not connected to dataplane
interfaces. It may be used to connect the system to an
out-of-band management network, for example.
nodetype: leaf (ro)
type: boolean
description:
When set to true, the interface is for traffic
that is handled by the system CPU, sometimes also called the
control plane interface. On systems that represent the CPU
interface as an Ethernet interface, for example, this leaf
should be used to distinguish the CPU interface from dataplane
interfaces.
nodetype: leaf (ro)
type: boolean
description:
A collection of interface specific statistics entitites which are
not common to subinterfaces.
nodetype: container (ro)
description:
The total number of octets received on the interface,
including framing characters.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of packets received on the interface,
including all unicast, multicast, broadcast and bad packets
etc.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of packets, delivered by this sub-layer to a
higher (sub-)layer, that were not addressed to a
multicast or broadcast address at this sub-layer.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of packets, delivered by this sub-layer to a
higher (sub-)layer, that were addressed to a broadcast
address at this sub-layer.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of packets, delivered by this sub-layer to a
higher (sub-)layer, that were addressed to a multicast
address at this sub-layer. For a MAC-layer protocol,
this includes both Group and Functional addresses.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
For packet-oriented interfaces, the number of inbound
packets that contained errors preventing them from being
deliverable to a higher-layer protocol. For character-
oriented or fixed-length interfaces, the number of
inbound transmission units that contained errors
preventing them from being deliverable to a higher-layer
protocol.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of inbound packets that were chosen to be
discarded even though no errors had been detected to
prevent their being deliverable to a higher-layer
protocol. One possible reason for discarding such a
packet could be to free up buffer space.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of octets transmitted out of the
interface, including framing characters.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of packets transmitted out of the
interface, including all unicast, multicast, broadcast,
and bad packets etc.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of packets that higher-level protocols
requested be transmitted, and that were not addressed
to a multicast or broadcast address at this sub-layer,
including those that were discarded or not sent.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of packets that higher-level protocols
requested be transmitted, and that were addressed to a
broadcast address at this sub-layer, including those
that were discarded or not sent.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of packets that higher-level protocols
requested be transmitted, and that were addressed to a
multicast address at this sub-layer, including those
that were discarded or not sent. For a MAC-layer
protocol, this includes both Group and Functional
addresses.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of outbound packets that were chosen to be
discarded even though no errors had been detected to
prevent their being transmitted. One possible reason
for discarding such a packet could be to free up buffer
space.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
For packet-oriented interfaces, the number of outbound
packets that could not be transmitted because of errors.
For character-oriented or fixed-length interfaces, the
number of outbound transmission units that could not be
transmitted because of errors.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Timestamp of the last time the interface counters were
cleared.
The value is the timestamp in nanoseconds relative to
the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
nodetype: leaf (ro)
type: oc-types:timeticks64
description:
For packet-oriented interfaces, the number of packets
received via the interface that were discarded because
of an unknown or unsupported protocol. For
character-oriented or fixed-length interfaces that
support protocol multiplexing, the number of
transmission units received via the interface that were
discarded because of an unknown or unsupported protocol.
For any interface that does not support protocol
multiplexing, this counter is not present.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of received packets which had errors in the
frame check sequence (FCS), i.e., framing errors.
Discontinuities in the value of this counter can occur
when the device is re-initialization as indicated by the
value of 'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of times the interface state has transitioned
between up and down since the time the device restarted
or the last-clear time, whichever is most recent.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of times the interface hardware has been reset. The
triggers and effects of this event are hardware-specifc.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Optionally set the tag protocol identifier field (TPID) that
is accepted on the VLAN
nodetype: leaf (ro)
type: identityref
default: oc-vlan-types:TPID_0X8100
description:
The numeric identifier (SDN Port) used by the controller to
address the interface. This ID is assigned by an
external-to-the-device entity (e.g., an SDN management system)
to establish an externally deterministic numeric reference for
the interface. The programming entity must ensure that the ID is
unique within the required context.
Note that this identifier is used only when a numeric reference
to the interface is required, it does not replace the unique
name assigned to the interface.
Ranges:
0x00000000: Unspecified/Invalid
0x00000001: Minimum Port Value
0xFFFFFEFF: Maximum Port Value
Reserved: 0xFFFFFFF0 - 0xFFFFFFFF
0xFFFFFFFA: Recirculate
0xFFFFFFFD: CPU
nodetype: leaf (ro)
type: uint32
description:
Top-level container for hold-time settings to enable
dampening advertisements of interface transitions.
nodetype: container (rw)
description:
Configuration data for interface hold-time settings.
nodetype: container (rw)
description:
Dampens advertisement when the interface
transitions from down to up. A zero value means dampening
is turned off, i.e., immediate notification.
nodetype: leaf (rw)
type: uint32
default: 0
units: milliseconds
description:
Dampens advertisement when the interface transitions from
up to down. A zero value means dampening is turned off,
i.e., immediate notification.
nodetype: leaf (rw)
type: uint32
default: 0
units: milliseconds
description:
Operational state data for interface hold-time.
nodetype: container (ro)
description:
Dampens advertisement when the interface
transitions from down to up. A zero value means dampening
is turned off, i.e., immediate notification.
nodetype: leaf (ro)
type: uint32
default: 0
units: milliseconds
description:
Dampens advertisement when the interface transitions from
up to down. A zero value means dampening is turned off,
i.e., immediate notification.
nodetype: leaf (ro)
type: uint32
default: 0
units: milliseconds
description:
Top level container to suppress UP->DOWN link events using a penalty based additive-increase, exponential-decrease algorithm.
nodetype: container (rw)
description:
Configuration data for link damping settings.
nodetype: container (rw)
description:
Maximum time an interface can remain damped since the last link down event no matter how unstable it has been prior to this period of stability. In a damped state, the interface's state change will not be advertised.
nodetype: leaf (rw)
type: uint32
default: 0
units: milliseconds
description:
The amount of time after which an interface's penalty is decreased by half. Decay-half-time should not be more than max-suppress-time.
nodetype: leaf (rw)
type: uint32
default: 0
units: milliseconds
description:
The accumulated penalty that triggers the damping of an interface. A value of 0 indicates config is disabled.
nodetype: leaf (rw)
type: uint32
default: 0
description:
When the accumulated penalty decreases to this reuse threshold, the interface is not damped anymore. Interface state changes are advertised to applications. A value of 0 indicates config is disabled.
nodetype: leaf (rw)
type: uint32
default: 0
description:
A penalty that each down event costs. A value of 0 indicates the config is disabled.
nodetype: leaf (rw)
type: uint32
default: 0
description:
Operational state data for link damping settings.
nodetype: container (ro)
description:
Maximum time an interface can remain damped since the last link down event no matter how unstable it has been prior to this period of stability. In a damped state, the interface's state change will not be advertised.
nodetype: leaf (ro)
type: uint32
default: 0
units: milliseconds
description:
The amount of time after which an interface's penalty is decreased by half. Decay-half-time should not be more than max-suppress-time.
nodetype: leaf (ro)
type: uint32
default: 0
units: milliseconds
description:
The accumulated penalty that triggers the damping of an interface. A value of 0 indicates config is disabled.
nodetype: leaf (ro)
type: uint32
default: 0
description:
When the accumulated penalty decreases to this reuse threshold, the interface is not damped anymore. Interface state changes are advertised to applications. A value of 0 indicates config is disabled.
nodetype: leaf (ro)
type: uint32
default: 0
description:
A penalty that each down event costs. A value of 0 indicates the config is disabled.
nodetype: leaf (ro)
type: uint32
default: 0
description:
Enclosing container for the list of subinterfaces associated
with a physical interface
nodetype: container (rw)
description:
The list of subinterfaces (logical interfaces) associated
with a physical interface
nodetype: list (rw)
list keys: [index]
description:
The index number of the subinterface -- used to address
the logical interface
nodetype: leaf (list key) (rw)
type: leafref
description:
Configurable items at the subinterface level
nodetype: container (rw)
description:
The index of the subinterface, or logical interface number.
On systems with no support for subinterfaces, or not using
subinterfaces, this value should default to 0, i.e., the
default subinterface.
nodetype: leaf (rw)
type: uint32
default: 0
description:
A textual description of the interface.
A server implementation MAY map this leaf to the ifAlias
MIB object. Such an implementation needs to use some
mechanism to handle the differences in size and characters
allowed between this leaf and ifAlias. The definition of
such a mechanism is outside the scope of this document.
Since ifAlias is defined to be stored in non-volatile
storage, the MIB implementation MUST map ifAlias to the
value of 'description' in the persistently stored
datastore.
Specifically, if the device supports ':startup', when
ifAlias is read the device MUST return the value of
'description' in the 'startup' datastore, and when it is
written, it MUST be written to the 'running' and 'startup'
datastores. Note that it is up to the implementation to
decide whether to modify this single leaf in 'startup' or
perform an implicit copy-config from 'running' to
'startup'.
If the device does not support ':startup', ifAlias MUST
be mapped to the 'description' leaf in the 'running'
datastore.
nodetype: leaf (rw)
type: string
description:
This leaf contains the configured, desired state of the
interface.
Systems that implement the IF-MIB use the value of this
leaf in the 'running' datastore to set
IF-MIB.ifAdminStatus to 'up' or 'down' after an ifEntry
has been initialized, as described in RFC 2863.
Changes in this leaf in the 'running' datastore are
reflected in ifAdminStatus, but if ifAdminStatus is
changed over SNMP, this leaf is not affected.
nodetype: leaf (rw)
type: boolean
default: true
description:
Operational state data for logical interfaces
nodetype: container (ro)
description:
The index of the subinterface, or logical interface number.
On systems with no support for subinterfaces, or not using
subinterfaces, this value should default to 0, i.e., the
default subinterface.
nodetype: leaf (ro)
type: uint32
default: 0
description:
A textual description of the interface.
A server implementation MAY map this leaf to the ifAlias
MIB object. Such an implementation needs to use some
mechanism to handle the differences in size and characters
allowed between this leaf and ifAlias. The definition of
such a mechanism is outside the scope of this document.
Since ifAlias is defined to be stored in non-volatile
storage, the MIB implementation MUST map ifAlias to the
value of 'description' in the persistently stored
datastore.
Specifically, if the device supports ':startup', when
ifAlias is read the device MUST return the value of
'description' in the 'startup' datastore, and when it is
written, it MUST be written to the 'running' and 'startup'
datastores. Note that it is up to the implementation to
decide whether to modify this single leaf in 'startup' or
perform an implicit copy-config from 'running' to
'startup'.
If the device does not support ':startup', ifAlias MUST
be mapped to the 'description' leaf in the 'running'
datastore.
nodetype: leaf (ro)
type: string
description:
This leaf contains the configured, desired state of the
interface.
Systems that implement the IF-MIB use the value of this
leaf in the 'running' datastore to set
IF-MIB.ifAdminStatus to 'up' or 'down' after an ifEntry
has been initialized, as described in RFC 2863.
Changes in this leaf in the 'running' datastore are
reflected in ifAdminStatus, but if ifAdminStatus is
changed over SNMP, this leaf is not affected.
nodetype: leaf (ro)
type: boolean
default: true
description:
The system-assigned name for the sub-interface. This MAY
be a combination of the base interface name and the
subinterface index, or some other convention used by the
system.
nodetype: leaf (ro)
type: string
description:
System assigned number for each interface. Corresponds to
ifIndex object in SNMP Interface MIB
nodetype: leaf (ro)
type: uint32
description:
The desired state of the interface. In RFC 7223 this leaf
has the same read semantics as ifAdminStatus. Here, it
reflects the administrative state as set by enabling or
disabling the interface.
nodetype: leaf (ro)
type: enumeration
description:
The current operational state of the interface.
This leaf has the same semantics as ifOperStatus.
nodetype: leaf (ro)
type: enumeration
description:
This timestamp indicates the absolute time of the last
state change of the interface (e.g., up-to-down transition).
This is different than the SNMP ifLastChange object in the
standard interface MIB in that it is not relative to the
system boot time (i.e,. sysUpTime).
The value is the timestamp in nanoseconds relative to
the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
nodetype: leaf (ro)
type: oc-types:timeticks64
description:
When set to true, the interface is a logical interface
which does not have an associated physical port or
channel on the system.
nodetype: leaf (ro)
type: boolean
description:
When set to true, the interface is a dedicated
management interface that is not connected to dataplane
interfaces. It may be used to connect the system to an
out-of-band management network, for example.
nodetype: leaf (ro)
type: boolean
description:
When set to true, the interface is for traffic
that is handled by the system CPU, sometimes also called the
control plane interface. On systems that represent the CPU
interface as an Ethernet interface, for example, this leaf
should be used to distinguish the CPU interface from dataplane
interfaces.
nodetype: leaf (ro)
type: boolean
description:
A collection of interface specific statistics entitites which are
not common to subinterfaces.
nodetype: container (ro)
description:
The total number of octets received on the interface,
including framing characters.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of packets received on the interface,
including all unicast, multicast, broadcast and bad packets
etc.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of packets, delivered by this sub-layer to a
higher (sub-)layer, that were not addressed to a
multicast or broadcast address at this sub-layer.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of packets, delivered by this sub-layer to a
higher (sub-)layer, that were addressed to a broadcast
address at this sub-layer.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of packets, delivered by this sub-layer to a
higher (sub-)layer, that were addressed to a multicast
address at this sub-layer. For a MAC-layer protocol,
this includes both Group and Functional addresses.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
For packet-oriented interfaces, the number of inbound
packets that contained errors preventing them from being
deliverable to a higher-layer protocol. For character-
oriented or fixed-length interfaces, the number of
inbound transmission units that contained errors
preventing them from being deliverable to a higher-layer
protocol.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of inbound packets that were chosen to be
discarded even though no errors had been detected to
prevent their being deliverable to a higher-layer
protocol. One possible reason for discarding such a
packet could be to free up buffer space.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of octets transmitted out of the
interface, including framing characters.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of packets transmitted out of the
interface, including all unicast, multicast, broadcast,
and bad packets etc.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of packets that higher-level protocols
requested be transmitted, and that were not addressed
to a multicast or broadcast address at this sub-layer,
including those that were discarded or not sent.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of packets that higher-level protocols
requested be transmitted, and that were addressed to a
broadcast address at this sub-layer, including those
that were discarded or not sent.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of packets that higher-level protocols
requested be transmitted, and that were addressed to a
multicast address at this sub-layer, including those
that were discarded or not sent. For a MAC-layer
protocol, this includes both Group and Functional
addresses.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of outbound packets that were chosen to be
discarded even though no errors had been detected to
prevent their being transmitted. One possible reason
for discarding such a packet could be to free up buffer
space.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
For packet-oriented interfaces, the number of outbound
packets that could not be transmitted because of errors.
For character-oriented or fixed-length interfaces, the
number of outbound transmission units that could not be
transmitted because of errors.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Timestamp of the last time the interface counters were
cleared.
The value is the timestamp in nanoseconds relative to
the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
nodetype: leaf (ro)
type: oc-types:timeticks64
description:
For packet-oriented interfaces, the number of packets
received via the interface that were discarded because
of an unknown or unsupported protocol. For
character-oriented or fixed-length interfaces that
support protocol multiplexing, the number of
transmission units received via the interface that were
discarded because of an unknown or unsupported protocol.
For any interface that does not support protocol
multiplexing, this counter is not present.
Discontinuities in the value of this counter can occur
at re-initialization of the management system, and at
other times as indicated by the value of
'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of received packets which had errors in the
frame check sequence (FCS), i.e., framing errors.
Discontinuities in the value of this counter can occur
when the device is re-initialization as indicated by the
value of 'last-clear'.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of times the interface state has transitioned
between up and down since the time the device restarted
or the last-clear time, whichever is most recent.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Enclosing container for VLAN interface-specific
data on subinterfaces
nodetype: container (rw)
description:
Configuration parameters for VLANs
nodetype: container (rw)
description:
VLAN id for the subinterface -- specified inline for the
case of a local VLAN. The id is scoped to the
subinterface, and could be repeated on different
subinterfaces.
Deprecation note: See adjacent elements in the 'vlan' container for
making more expressive VLAN matches.
nodetype: leaf (rw)
type: union
type: oc-vlan-types:vlan-id
type: oc-vlan-types:qinq-id
description:
State variables for VLANs
nodetype: container (ro)
description:
VLAN id for the subinterface -- specified inline for the
case of a local VLAN. The id is scoped to the
subinterface, and could be repeated on different
subinterfaces.
Deprecation note: See adjacent elements in the 'vlan' container for
making more expressive VLAN matches.
nodetype: leaf (ro)
type: union
type: oc-vlan-types:vlan-id
type: oc-vlan-types:qinq-id
description:
Configuration for various VLAN tag matching schemes,
including single-tagged 802.1q packets and double-tagged
802.1ad 'Q-in-Q' packets. Typically only one of the subordinate
containers should be specified.
Wildcards may be matched by specifying range values of 2-4094.
If implementations have a more efficient way to match Wildcards
then they should recognize this pattern and translate accordingly.
Implementations are expected to return errors for combinations
that they do not support, or provide deviations to the same effect.
For simple VLAN configurations without an 'egress-mapping' then
using the 'single-tagged' and 'double-tagged' VLAN matches that
resolve to specific values, these specify the VLAN identifiers
applied to packets on egress.
nodetype: container (rw)
description:
Match single-tagged packets with an exact VLAN identifier.
nodetype: container (rw)
description:
Configuration for matching single-tagged packets with an exact
VLAN identifier.
nodetype: container (rw)
description:
VLAN identifier for single-tagged packets.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
State for matching single-tagged packets with an exact VLAN
identifier.
nodetype: container (ro)
description:
VLAN identifier for single-tagged packets.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Match single-tagged packets with a list of VLAN identifiers.
nodetype: container (rw)
description:
Configuration for matching single-tagged packets with a list of
VLAN identifiers.
nodetype: container (rw)
description:
VLAN identifiers for single-tagged packets.
nodetype: leaf-list (rw)
type: oc-vlan-types:vlan-id
description:
State for matching single-tagged packets with a list of VLAN
identifiers.
nodetype: container (ro)
description:
VLAN identifiers for single-tagged packets.
nodetype: leaf-list (ro)
type: oc-vlan-types:vlan-id
description:
Match single-tagged packets with a range of VLAN identifiers.
nodetype: container (rw)
description:
Configuration for matching single-tagged packets with a range of
VLAN identifiers.
nodetype: container (rw)
description:
The low-value VLAN identifier in a range for single-tagged
packets. The range is matched inclusively.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
The high-value VLAN identifier in a range for single-tagged
packets. The range is matched inclusively.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
State for matching single-tagged packets with a range of VLAN
identifiers.
nodetype: container (ro)
description:
The low-value VLAN identifier in a range for single-tagged
packets. The range is matched inclusively.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
The high-value VLAN identifier in a range for single-tagged
packets. The range is matched inclusively.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Match double-tagged packets against inner exact and outer exact
VLAN identifiers.
nodetype: container (rw)
description:
Configuration for matching double-tagged packets against inner
exact and outer exact VLAN identifiers.
nodetype: container (rw)
description:
Inner VLAN identifier for double-tagged packets.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
Outer VLAN identifier for double-tagged packets.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
State for matching double-tagged packets against inner exact
and outer exact VLAN identifiers.
nodetype: container (ro)
description:
Inner VLAN identifier for double-tagged packets.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Outer VLAN identifier for double-tagged packets.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Match double-tagged packets against an inner list and outer exact
VLAN identifiers.
nodetype: container (rw)
description:
Configuration for matching double-tagged packets against an
inner list and outer exact VLAN identifiers.
nodetype: container (rw)
description:
Inner VLAN identifiers for double-tagged packets.
nodetype: leaf-list (rw)
type: oc-vlan-types:vlan-id
description:
Outer VLAN identifier for double-tagged packets.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
State for matching double-tagged packets against an inner list
and outer exact VLAN identifiers.
nodetype: container (ro)
description:
Inner VLAN identifiers for double-tagged packets.
nodetype: leaf-list (ro)
type: oc-vlan-types:vlan-id
description:
Outer VLAN identifier for double-tagged packets.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Match double-tagged packets against an inner exact and outer list
of VLAN identifiers.
nodetype: container (rw)
description:
Configuration for matching double-tagged packets against an
inner exact and outer list of VLAN identifiers.
nodetype: container (rw)
description:
Inner VLAN identifier for double-tagged packets.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
Outer VLAN identifiers for double-tagged packets.
nodetype: leaf-list (rw)
type: oc-vlan-types:vlan-id
description:
State for matching double-tagged packets against an inner
exact and outer list of VLAN identifiers.
nodetype: container (ro)
description:
Inner VLAN identifier for double-tagged packets.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Outer VLAN identifiers for double-tagged packets.
nodetype: leaf-list (ro)
type: oc-vlan-types:vlan-id
description:
Match double-tagged packets against an inner range and outer
exact VLAN identifiers.
nodetype: container (rw)
description:
Configuration for matching double-tagged packets against an
inner range and outer exact VLAN identifiers.
nodetype: container (rw)
description:
The low-value inner VLAN identifier in a range for double-tagged
packets. The range is matched inclusively.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
The high-value inner VLAN identifier in a range for double-tagged
packets. The range is matched inclusively.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
Outer VLAN identifier of double-tagged packets.
nodetype: leaf-list (rw)
type: oc-vlan-types:vlan-id
description:
State for matching double-tagged packets against an inner
range and outer exact VLAN identifiers.
nodetype: container (ro)
description:
The low-value inner VLAN identifier in a range for double-tagged
packets. The range is matched inclusively.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
The high-value inner VLAN identifier in a range for double-tagged
packets. The range is matched inclusively.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Outer VLAN identifier of double-tagged packets.
nodetype: leaf-list (ro)
type: oc-vlan-types:vlan-id
description:
Match double-tagged packets against an inner exact and an outer
range of VLAN identifiers.
nodetype: container (rw)
description:
Configuration for matching double-tagged packets against an
inner exact and an outer range of VLAN identifiers.
nodetype: container (rw)
description:
Inner VLAN identifier for double-tagged packets.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
The low-value outer VLAN identifier for double-tagged packets.
The range is matched inclusively.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
The high-value outer VLAN identifier for double-tagged packets.
The range is matched inclusively.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
State for matching double-tagged packets against an inner
exact and an outer range of VLAN identifiers.
nodetype: container (ro)
description:
Inner VLAN identifier for double-tagged packets.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
The low-value outer VLAN identifier for double-tagged packets.
The range is matched inclusively.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
The high-value outer VLAN identifier for double-tagged packets.
The range is matched inclusively.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Match double-tagged packets against an inner range and an outer
range of VLAN identifiers.
nodetype: container (rw)
description:
Configuration for matching double-tagged packets against an
inner range and an outer range of VLAN identifiers.
nodetype: container (rw)
description:
The low-value inner VLAN identifier in a range for double-tagged
packets. The range is matched inclusively.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
The high-value inner VLAN identifier in a range for double-tagged
packets. The range is matched inclusively.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
The low-value outer VLAN identifier in a range for double-tagged
packets. The range is matched inclusively.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
The high-value outer VLAN identifier for double-tagged packets.
The range is matched inclusively.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
State for matching double-tagged packets against an inner
range and an outer range of VLAN identifiers.
nodetype: container (ro)
description:
The low-value inner VLAN identifier in a range for double-tagged
packets. The range is matched inclusively.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
The high-value inner VLAN identifier in a range for double-tagged
packets. The range is matched inclusively.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
The low-value outer VLAN identifier in a range for double-tagged
packets. The range is matched inclusively.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
The high-value outer VLAN identifier for double-tagged packets.
The range is matched inclusively.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Ingress VLAN stack behaviors for packets that arrive on
this subinterface after their VLAN idenitifer(s) have been
matched.
nodetype: container (rw)
description:
Configuration for ingress VLAN and label behaviors for
packets that arrive on this subinterface after their VLAN
identifier(s) have been matched.
nodetype: container (rw)
description:
The action to take on the VLAN stack of a packet. This is
optionally used in conjunction with adjacent leaves to override
the values of the action.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-stack-action
description:
Optionally specifies a fixed VLAN identifier that is used by the
action configured in 'vlan-stack-action'. For example, if the action
is 'PUSH' then this VLAN identifier is added to the the stack.
This value must be non-zero if the 'vlan-stack-action' is one of
'PUSH' or 'SWAP'.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
Optionally override the tag protocol identifier field (TPID) that
is used by the action configured by 'vlan-stack-action' when
modifying the VLAN stack.
nodetype: leaf (rw)
type: identityref
description:
State for ingress VLAN and label behaviors for packets
that arrive on this subinterface.
nodetype: container (ro)
description:
The action to take on the VLAN stack of a packet. This is
optionally used in conjunction with adjacent leaves to override
the values of the action.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-stack-action
description:
Optionally specifies a fixed VLAN identifier that is used by the
action configured in 'vlan-stack-action'. For example, if the action
is 'PUSH' then this VLAN identifier is added to the the stack.
This value must be non-zero if the 'vlan-stack-action' is one of
'PUSH' or 'SWAP'.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Optionally override the tag protocol identifier field (TPID) that
is used by the action configured by 'vlan-stack-action' when
modifying the VLAN stack.
nodetype: leaf (ro)
type: identityref
description:
Egress VLAN and label behaviors for packets that are
destined for output via this subinterface.
nodetype: container (rw)
description:
Configuration for egress VLAN stack behaviors for
packets that are destined for output via this subinterface.
nodetype: container (rw)
description:
The action to take on the VLAN stack of a packet. This is
optionally used in conjunction with adjacent leaves to override
the values of the action.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-stack-action
description:
Optionally specifies a fixed VLAN identifier that is used by the
action configured in 'vlan-stack-action'. For example, if the action
is 'POP' then a VLAN identifier is removed from the stack but the
value of this leaf is used instead. This value must be non-zero if
the 'vlan-stack-action' is one of 'PUSH' or 'SWAP'.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
Optionally override the tag protocol identifier field (TPID) that
is used by the action configured by 'vlan-stack-action' when
modifying the VLAN stack.
nodetype: leaf (rw)
type: identityref
description:
State for engress VLAN stack behaviors for packets
that are destined for output via this subinterface.
nodetype: container (ro)
description:
The action to take on the VLAN stack of a packet. This is
optionally used in conjunction with adjacent leaves to override
the values of the action.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-stack-action
description:
Optionally specifies a fixed VLAN identifier that is used by the
action configured in 'vlan-stack-action'. For example, if the action
is 'POP' then a VLAN identifier is removed from the stack but the
value of this leaf is used instead. This value must be non-zero if
the 'vlan-stack-action' is one of 'PUSH' or 'SWAP'.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Optionally override the tag protocol identifier field (TPID) that
is used by the action configured by 'vlan-stack-action' when
modifying the VLAN stack.
nodetype: leaf (ro)
type: identityref
description:
Top-level container for ethernet configuration
and state
nodetype: container (rw)
description:
Configuration data for ethernet interfaces
nodetype: container (rw)
description:
Assigns a MAC address to the Ethernet interface. If not
specified, the corresponding operational state leaf is
expected to show the system-assigned MAC address.
nodetype: leaf (rw)
type: oc-yang:mac-address
description:
Enable or disable flow control for this interface.
Ethernet flow control is a mechanism by which a receiver
may send PAUSE frames to a sender to stop transmission for
a specified time.
This setting should override auto-negotiated flow control
settings. If left unspecified, and auto-negotiate is TRUE,
flow control mode is negotiated with the peer interface.
nodetype: leaf (rw)
type: boolean
default: false
description:
Set to TRUE to request the interface to auto-negotiate
transmission parameters with its peer interface. When
set to FALSE, the transmission parameters are specified
manually.
nodetype: leaf (rw)
type: boolean
default: true
description:
Link training is automatic tuning of the SerDes transmit and
receive parameters to ensure an optimal connection over copper
links. It is normally run as part of the auto negotiation
sequence as specified in IEEE 802.3 Clause 73.
Standalone link training is used when full auto negotiation is
not desired on an Ethernet link but link training is needed.
It is configured by setting the standalone-link-training leaf
to TRUE and augo-negotiate leaf to FALSE.
Note: If auto-negotiate is true, then the value of standalone
link training leaf will be ignored.
nodetype: leaf (rw)
type: boolean
default: false
description:
When auto-negotiate is TRUE, this optionally sets the
duplex mode that will be advertised to the peer. If
unspecified, the interface should negotiate the duplex mode
directly (typically full-duplex). When auto-negotiate is
FALSE, this sets the duplex mode on the interface directly.
nodetype: leaf (rw)
type: enumeration
description:
When auto-negotiate is TRUE, this optionally sets the
port-speed mode that will be advertised to the peer for
negotiation. If unspecified, it is expected that the
interface will select the highest speed available based on
negotiation. When auto-negotiate is set to FALSE, sets the
link speed to a fixed value -- supported values are defined
by ETHERNET_SPEED identities
nodetype: leaf (rw)
type: identityref
description:
The FEC mode applied to the physical channels associated with
the interface.
nodetype: leaf (rw)
type: identityref
description:
Specify the logical aggregate interface to which
this interface belongs
nodetype: leaf (rw)
type: leafref
description:
State variables for Ethernet interfaces
nodetype: container (ro)
description:
Assigns a MAC address to the Ethernet interface. If not
specified, the corresponding operational state leaf is
expected to show the system-assigned MAC address.
nodetype: leaf (ro)
type: oc-yang:mac-address
description:
Enable or disable flow control for this interface.
Ethernet flow control is a mechanism by which a receiver
may send PAUSE frames to a sender to stop transmission for
a specified time.
This setting should override auto-negotiated flow control
settings. If left unspecified, and auto-negotiate is TRUE,
flow control mode is negotiated with the peer interface.
nodetype: leaf (ro)
type: boolean
default: false
description:
Set to TRUE to request the interface to auto-negotiate
transmission parameters with its peer interface. When
set to FALSE, the transmission parameters are specified
manually.
nodetype: leaf (ro)
type: boolean
default: true
description:
Link training is automatic tuning of the SerDes transmit and
receive parameters to ensure an optimal connection over copper
links. It is normally run as part of the auto negotiation
sequence as specified in IEEE 802.3 Clause 73.
Standalone link training is used when full auto negotiation is
not desired on an Ethernet link but link training is needed.
It is configured by setting the standalone-link-training leaf
to TRUE and augo-negotiate leaf to FALSE.
Note: If auto-negotiate is true, then the value of standalone
link training leaf will be ignored.
nodetype: leaf (ro)
type: boolean
default: false
description:
When auto-negotiate is TRUE, this optionally sets the
duplex mode that will be advertised to the peer. If
unspecified, the interface should negotiate the duplex mode
directly (typically full-duplex). When auto-negotiate is
FALSE, this sets the duplex mode on the interface directly.
nodetype: leaf (ro)
type: enumeration
description:
When auto-negotiate is TRUE, this optionally sets the
port-speed mode that will be advertised to the peer for
negotiation. If unspecified, it is expected that the
interface will select the highest speed available based on
negotiation. When auto-negotiate is set to FALSE, sets the
link speed to a fixed value -- supported values are defined
by ETHERNET_SPEED identities
nodetype: leaf (ro)
type: identityref
description:
The FEC mode applied to the physical channels associated with
the interface.
nodetype: leaf (ro)
type: identityref
description:
Represents the 'burned-in', or system-assigned, MAC
address for the Ethernet interface.
nodetype: leaf (ro)
type: oc-yang:mac-address
description:
When auto-negotiate is set to TRUE, and the interface has
completed auto-negotiation with the remote peer, this value
shows the duplex mode that has been negotiated.
nodetype: leaf (ro)
type: enumeration
description:
When auto-negotiate is set to TRUE, and the interface has
completed auto-negotiation with the remote peer, this value
shows the interface speed that has been negotiated.
nodetype: leaf (ro)
type: identityref
description:
Ethernet interface counters
nodetype: container (ro)
description:
MAC layer control frames received on the interface
nodetype: leaf (ro)
type: oc-yang:counter64
description:
MAC layer PAUSE frames received on the interface
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of frames received that were
longer than 1518 octets (excluding framing bits,
but including FCS octets) and were otherwise
well formed.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of frames received that were
less than 64 octets long (excluding framing bits,
but including FCS octets) and were otherwise well
formed.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of jabber frames received on the
interface. Jabber frames are typically defined as oversize
frames which also have a bad CRC. Implementations may use
slightly different definitions of what constitutes a jabber
frame. Often indicative of a NIC hardware problem.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of frames received that were less than
64 octets in length (excluding framing bits but including
FCS octets) and had either a bad Frame Check Sequence
(FCS) with an integral number of octets (FCS Error) or a
bad FCS with a non-integral number of octets (Alignment
Error).
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of 802.1q tagged frames received on the interface
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number of frames received that
had a length (excluding framing bits, but
including FCS octets) of between 64 and 1518
octets, inclusive, but had either a bad
Frame Check Sequence (FCS) with an integral
number of octets (FCS Error) or a bad FCS with
a non-integral number of octets (Alignment Error)
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of received errored blocks. Error detection codes
are capable of detecting whether one or more errors have
occurred in a given sequence of bits – the block. It is
normally not possible to determine the exact number of errored
bits within the block
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of received errored frames due to a carrier issue.
The value refers to MIB counter for
dot3StatsCarrierSenseErrors
oid=1.3.6.1.2.1.10.7.2.1.11
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of received errored frames due to interrupted
transmission issue. The value refers to MIB counter for
dot3StatsDeferredTransmissions
oid=1.3.6.1.2.1.10.7.2.1.7
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of received errored frames due to late collision
issue. The value refers to MIB counter for
dot3StatsLateCollisions
oid=1.3.6.1.2.1.10.7.2.1.8
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of received errored frames due to MAC errors
received. The value refers to MIB counter for
dot3StatsInternalMacReceiveErrors
oid=1.3.6.1.2.1.10.7.2.1.16
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of received errored frames due to single collision
issue. The value refers to MIB counter for
dot3StatsSingleCollisionFrames
oid=1.3.6.1.2.1.10.7.2.1.4
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of received errored frames due to symbol error.
The value refers to MIB counter for
in-symbol-error
oid=1.3.6.1.2.1.10.7.2.1.18
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The total number frames received that are well-formed but
dropped due to exceeding the maximum frame size on the interface
(e.g., MTU or MRU)
nodetype: leaf (ro)
type: oc-yang:counter64
description:
MAC layer control frames sent on the interface
nodetype: leaf (ro)
type: oc-yang:counter64
description:
MAC layer PAUSE frames sent on the interface
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of 802.1q tagged frames sent on the interface
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The number of sent errored frames due to MAC errors
transmitted. The value refers to MIB counter for
dot3StatsInternalMacTransmitErrors
oid=1.3.6.1.2.1.10.7.2.1.10
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Specify the logical aggregate interface to which
this interface belongs
nodetype: leaf (ro)
type: leafref
description:
Enclosing container for VLAN interface-specific
data on Ethernet interfaces. These are for standard
L2, switched-style VLANs.
nodetype: container (rw)
description:
Configuration parameters for VLANs
nodetype: container (rw)
description:
Set the interface to access or trunk mode for
VLANs
nodetype: leaf (rw)
type: oc-vlan-types:vlan-mode-type
description:
Set the native VLAN id for untagged frames arriving on
a trunk interface. Tagged frames sent on an interface
configured with a native VLAN should have their tags
stripped prior to transmission. This configuration is only
valid on a trunk interface.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
Assign the access vlan to the access port.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
Specify VLANs, or ranges thereof, that the interface may
carry when in trunk mode. If not specified, all VLANs are
allowed on the interface. Ranges are specified in the form
x..y, where x
nodetype: leaf-list (rw)
type: union
type: oc-vlan-types:vlan-id
type: oc-vlan-types:vlan-range
description:
State variables for VLANs
nodetype: container (ro)
description:
Set the interface to access or trunk mode for
VLANs
nodetype: leaf (ro)
type: oc-vlan-types:vlan-mode-type
description:
Set the native VLAN id for untagged frames arriving on
a trunk interface. Tagged frames sent on an interface
configured with a native VLAN should have their tags
stripped prior to transmission. This configuration is only
valid on a trunk interface.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Assign the access vlan to the access port.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Specify VLANs, or ranges thereof, that the interface may
carry when in trunk mode. If not specified, all VLANs are
allowed on the interface. Ranges are specified in the form
x..y, where x
nodetype: leaf-list (ro)
type: union
type: oc-vlan-types:vlan-id
type: oc-vlan-types:vlan-range
description:
Options for logical interfaces representing
aggregates
nodetype: container (rw)
description:
Configuration variables for logical aggregate /
LAG interfaces
nodetype: container (rw)
description:
Sets the type of LAG, i.e., how it is
configured / maintained
nodetype: leaf (rw)
type: aggregation-type
description:
Specifies the mininum number of member
interfaces that must be active for the aggregate interface
to be available
nodetype: leaf (rw)
type: uint16
description:
Operational state variables for logical
aggregate / LAG interfaces
nodetype: container (ro)
description:
Sets the type of LAG, i.e., how it is
configured / maintained
nodetype: leaf (ro)
type: aggregation-type
description:
Specifies the mininum number of member
interfaces that must be active for the aggregate interface
to be available
nodetype: leaf (ro)
type: uint16
description:
Reports effective speed of the aggregate interface,
based on speed of active member interfaces
nodetype: leaf (ro)
type: uint32
units: Mbps
description:
List of current member interfaces for the aggregate,
expressed as references to existing interfaces
nodetype: leaf-list (ro)
type: oc-if:base-interface-ref
description:
Enclosing container for VLAN interface-specific
data on Ethernet interfaces. These are for standard
L2, switched-style VLANs.
nodetype: container (rw)
description:
Configuration parameters for VLANs
nodetype: container (rw)
description:
Set the interface to access or trunk mode for
VLANs
nodetype: leaf (rw)
type: oc-vlan-types:vlan-mode-type
description:
Set the native VLAN id for untagged frames arriving on
a trunk interface. Tagged frames sent on an interface
configured with a native VLAN should have their tags
stripped prior to transmission. This configuration is only
valid on a trunk interface.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
Assign the access vlan to the access port.
nodetype: leaf (rw)
type: oc-vlan-types:vlan-id
description:
Specify VLANs, or ranges thereof, that the interface may
carry when in trunk mode. If not specified, all VLANs are
allowed on the interface. Ranges are specified in the form
x..y, where x
nodetype: leaf-list (rw)
type: union
type: oc-vlan-types:vlan-id
type: oc-vlan-types:vlan-range
description:
State variables for VLANs
nodetype: container (ro)
description:
Set the interface to access or trunk mode for
VLANs
nodetype: leaf (ro)
type: oc-vlan-types:vlan-mode-type
description:
Set the native VLAN id for untagged frames arriving on
a trunk interface. Tagged frames sent on an interface
configured with a native VLAN should have their tags
stripped prior to transmission. This configuration is only
valid on a trunk interface.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Assign the access vlan to the access port.
nodetype: leaf (ro)
type: oc-vlan-types:vlan-id
description:
Specify VLANs, or ranges thereof, that the interface may
carry when in trunk mode. If not specified, all VLANs are
allowed on the interface. Ranges are specified in the form
x..y, where x
nodetype: leaf-list (ro)
type: union
type: oc-vlan-types:vlan-id
type: oc-vlan-types:vlan-range
description:
Top-level container for routed vlan interfaces. These
logical interfaces are also known as SVI (switched virtual
interface), IRB (integrated routing and bridging), RVI
(routed VLAN interface)
nodetype: container (rw)
description:
Configuration data for routed vlan interfaces
nodetype: container (rw)
description:
References the VLAN for which this IP interface
provides routing services -- similar to a switch virtual
interface (SVI), or integrated routing and bridging interface
(IRB) in some implementations.
nodetype: leaf (rw)
type: union
type: uint16
type: string
description:
Operational state data
nodetype: container (ro)
description:
References the VLAN for which this IP interface
provides routing services -- similar to a switch virtual
interface (SVI), or integrated routing and bridging interface
(IRB) in some implementations.
nodetype: leaf (ro)
type: union
type: uint16
type: string
This module defines a data model for representing a system component inventory, which can include hardware or software elements arranged in an arbitrary structure. The primary relationship supported by the model is containment, e.g., components containing subcomponents.
It is expected that this model reflects every field replacable unit on the device at a minimum (i.e., additional information may be supplied about non-replacable components).
Every element in the inventory is termed a 'component' with each component expected to have a unique name and type, and optionally a unique system-assigned identifier and FRU number. The uniqueness is guaranteed by the system within the device.
Components may have properties defined by the system that are modeled as a list of key-value pairs. These may or may not be user-configurable. The model provides a flag for the system to optionally indicate which properties are user configurable.
Each component also has a list of 'subcomponents' which are references to other components. Appearance in a list of subcomponents indicates a containment relationship as described above. For example, a linecard component may have a list of references to port components that reside on the linecard.
This schema is generic to allow devices to express their own platform-specific structure. It may be augmented by additional component type-specific schemas that provide a common structure for well-known component types. In these cases, the system is expected to populate the common component schema, and may optionally also represent the component and its properties in the generic structure.
The properties for each component may include dynamic values, e.g., in the 'state' part of the schema. For example, a CPU component may report its utilization, temperature, or other physical properties. The intent is to capture all platform- specific physical data in one location, including inventory (presence or absence of a component) and state (physical attributes or status).
openconfig-platform-types
openconfig-extensions
openconfig-alarm-types
openconfig-yang-types
openconfig-types
description:
Enclosing container for the components in the system.
nodetype: container (rw)
description:
List of components, keyed by component name.
nodetype: list (rw)
list keys: [name]
description:
References the component name
nodetype: leaf (list key) (rw)
type: leafref
description:
Configuration data for each component
nodetype: container (rw)
description:
Device name for the component -- this may not be a
configurable parameter on many implementations. Where
component preconfiguration is supported, for example,
the component name may be configurable.
nodetype: leaf (rw)
type: string
description:
Operational state data for each component
nodetype: container (ro)
description:
Device name for the component -- this may not be a
configurable parameter on many implementations. Where
component preconfiguration is supported, for example,
the component name may be configurable.
nodetype: leaf (ro)
type: string
description:
Type of component as identified by the system
nodetype: leaf (ro)
type: union
type: identityref
type: identityref
description:
Unique identifier assigned by the system for the
component
nodetype: leaf (ro)
type: string
description:
System-supplied description of the location of the
component within the system. This could be a bay position,
slot number, socket location, etc. For component types that
have an explicit slot-id attribute, such as linecards, the
system should populate the more specific slot-id.
This leaf is deprecated and replaced by install-position and
install-component.
nodetype: leaf (ro)
type: string
description:
System-supplied index to a position where this component is
installed. The position may be referred in device documenation
as a port, slot, bay, socket, etc. This string must only
indicate the name of the position, and not any indication of
the name of the parent component within the system. Instead,
parent component name should be present in the 'parent' leaf.
Typically the install-position is a number, but it is observed
that some devices may use letters or alphanumerics. The
position name should be the same name used to physically
identify the position in documentation or printed on the
device.
Any component which is removable is expected to have
an install-position and an install-component which points to
an ancestor component where the connection occurs.
For component types that have an explicit slot-id attribute,
such as LINECARD, the system should populate slot-id,
install-position and install-component. This will facilitate a
transition to deprecate slot-id.
nodetype: leaf (ro)
type: string
description:
This leaf contains the name of the ancestor component which
contains the 'install-position'. This creates a distinct
mapping between a removable component and the target component
it is installed into. Note there may be zero or more
intermediate components between the removable component and
the install-component.
For example, consider the component tree
PORT ['eth1/2']-> INTEGRATED_CIRCUIT ['npu1']-> LINECARD ['lc1'].
The PORT has an install-position of '2' and install-component named
'lc1'. The intermediate INTEGRATED-CIRCUIT component is not
present in either install-position or install-component leaves.
nodetype: leaf (ro)
type: leafref
description:
System-supplied description of the component
nodetype: leaf (ro)
type: string
description:
System-supplied identifier for the manufacturer of the
component. This data is particularly useful when a
component manufacturer is different than the overall
device vendor.
nodetype: leaf (ro)
type: string
description:
System-supplied representation of the component's
manufacturing date.
nodetype: leaf (ro)
type: oc-yang:date
description:
For hardware components, this is the hardware revision of
the component.
nodetype: leaf (ro)
type: string
description:
For hardware components, this is the version of associated
firmware that is running on the component, if applicable.
nodetype: leaf (ro)
type: string
description:
For software components such as operating system or other
software module, this is the version of the currently
running software.
nodetype: leaf (ro)
type: string
description:
System-assigned serial number of the component.
nodetype: leaf (ro)
type: string
description:
System-assigned part number for the component. This should
be present in particular if the component is also an FRU
(field replaceable unit)
nodetype: leaf (ro)
type: string
description:
Model name that would be found in a catalog of stock keeping
units (SKU) and should be the orderable name of the
component.
nodetype: leaf (ro)
type: string
description:
Common Language Equipment Identifier (CLEI) code of the
component. This should be present in particular if the
component is also an FRU (field replaceable unit)
nodetype: leaf (ro)
type: string
description:
If true, this component is removable or is a field
replaceable unit
nodetype: leaf (ro)
type: boolean
description:
If applicable, this reports the current operational status
of the component.
nodetype: leaf (ro)
type: identityref
description:
The empty leaf may be used by the device to indicate that a
component position exists but is not populated. Using this
flag, it is possible for the management system to learn how
many positions are available (e.g., occupied vs. empty
linecard slots in a chassis).
nodetype: leaf (ro)
type: boolean
default: false
description:
Reference to the name of the parent component. Note that
this reference must be kept synchronized with the
corresponding subcomponent reference from the parent
component.
nodetype: leaf (ro)
type: leafref
description:
For components that have redundant roles (e.g. two
supervisors in a device, one as primary the other as secondary),
this reports the role of the component.
nodetype: leaf (ro)
type: oc-platform-types:component-redundant-role
description:
Records last power-off reason for a component.
nodetype: container (ro)
description:
Records the generic triggers for the last poweroff
event. Component power-off can be triggered
in various ways,
- USER_INITIATED
- SYSTEM_INITIATED
- POWER_FAILURE
This field is not updated during reboots; those are
tracked in the 'last-reboot-reason' leaf.
nodetype: leaf (ro)
type: component-last-poweroff-reason-trigger
description:
Provides a detailed reason for component power-off.
For system-initiated power-offs, this field can include
specific causes (e.g., critical errors resulting in a
controller-card bootloop).
nodetype: leaf (ro)
type: string
description:
This records the last time a component was directly powered
down. The value is a Unix Epoch timestamp (nanoseconds since
Jan 1, 1970 00:00:00 UTC). Component power-off can be:
- USER_INITIATED
- SYSTEM_INITIATED
- POWER_FAILURE
This field is not updated during reboots; those are tracked
in the 'last-reboot-time' leaf.
nodetype: leaf (ro)
type: oc-types:timeticks64
units: nanoseconds
description:
For components that have redundant roles (e.g. two
supervisors in a device, one as primary the other as secondary),
this reports the reason of the last change of the
component's role.
nodetype: container (ro)
description:
Records the generic triggers, e.g. user or system
initiated the switchover.
nodetype: leaf (ro)
type: component-redundant-role-switchover-reason-trigger
description:
Records detailed description of why the switchover happens.
For example, when system initiated the switchover, this leaf
can be used to record the specific reason, e.g. due to critical
errors of the routing daemon in the primary role.
nodetype: leaf (ro)
type: string
description:
For components that have redundant roles (e.g. two
supervisors in a device, one as primary the other as
secondary), this reports the time of the last change of
the component's role. The value is the timestamp in
nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
nodetype: leaf (ro)
type: oc-types:timeticks64
units: nanoseconds
description:
This reports the reason of the last reboot of the component.
nodetype: leaf (ro)
type: identityref
description:
This reports the time of the last reboot of the component. The
value is the timestamp in nanoseconds relative to the Unix Epoch
(Jan 1, 1970 00:00:00 UTC). This timer is not updated during
power shutdowns; those are tracked in 'last-poweroff-time' leaf.
nodetype: leaf (ro)
type: oc-types:timeticks64
units: nanoseconds
description:
For components that have redundant roles, this reports a value
that indicates if the component is ready to support failover.
The components with a redundant-role should reflect the overall
system's switchover status. For example, two supervisors in a
device, one as primary and the other as secondary, should both
report the same value.
nodetype: leaf (ro)
type: boolean
description:
This is a MAC address representing the root or primary MAC
address for a component. Components such as CHASSIS and
CONTROLLER_CARD are expected to provide a base-mac-address. The
base mac-address for CHASSIS and a PRIMARY CONTROLLER_CARD may
contain the same value.
nodetype: leaf (ro)
type: oc-yang:mac-address
description:
Temperature in degrees Celsius of the component. Values include
the instantaneous, average, minimum, and maximum statistics. If
avg/min/max statistics are not supported, the target is expected
to just supply the instant value
nodetype: container (ro)
description:
The instantaneous value of the statistic.
nodetype: leaf (ro)
type: decimal64
units: celsius
description:
The arithmetic mean value of the statistic over the
sampling period.
nodetype: leaf (ro)
type: decimal64
units: celsius
description:
The minimum value of the statistic over the sampling
period
nodetype: leaf (ro)
type: decimal64
units: celsius
description:
The maximum value of the statistic over the sampling
period
nodetype: leaf (ro)
type: decimal64
units: celsius
description:
If supported by the system, this reports the time interval
over which the min/max/average statistics are computed by
the system.
nodetype: leaf (ro)
type: oc-types:stat-interval
description:
The absolute time at which the minimum value occurred.
The value is the timestamp in nanoseconds relative to
the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
nodetype: leaf (ro)
type: oc-types:timeticks64
description:
The absolute time at which the maximum value occurred.
The value is the timestamp in nanoseconds relative to
the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
nodetype: leaf (ro)
type: oc-types:timeticks64
description:
A value of true indicates the alarm has been raised or
asserted. The value should be false when the alarm is
cleared.
nodetype: leaf (ro)
type: boolean
description:
The threshold value that was crossed for this alarm.
nodetype: leaf (ro)
type: uint32
description:
The severity of the current alarm.
nodetype: leaf (ro)
type: identityref
description:
For components that have associated memory, these values
report information about available and utilized memory.
nodetype: container (ro)
description:
The available memory physically installed, or logically
allocated to the component.
nodetype: leaf (ro)
type: uint64
units: bytes
description:
The memory currently in use by processes running on
the component, not considering reserved memory that is
not available for use.
nodetype: leaf (ro)
type: uint64
units: bytes
description:
Power allocated by the system for the component.
nodetype: leaf (ro)
type: uint32
units: watts
description:
Actual power used by the component.
nodetype: leaf (ro)
type: uint32
units: watts
description:
Components that are connected to the system over the Peripheral
Component Interconnect Express (PCIe), report the fatal, non-fatal
and correctable PCIe error counts.
nodetype: container (ro)
description:
The count of the fatal PCIe errors.
nodetype: container (ro)
description:
Total number of uncorrectable errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of undefined errors detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of data-link errors detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of unexpected link down errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of poisoned TLP errors detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of flow control protocol errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of completion timeout errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of completion abort errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of unexpected completion errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of receiver overflow errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of malformed TLP errors detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of ECRC errors detected by PCIe device since the system
booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of unsupported request errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of access control errors detected by PCIe device since
the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of internal errors detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of blocked TLP errors detected by PCIe device since
the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of atomic operation blocked errors detected by PCIe
device since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of TLP prefix blocked errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The count of the non-fatal PCIe errors.
nodetype: container (ro)
description:
Total number of uncorrectable errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of undefined errors detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of data-link errors detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of unexpected link down errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of poisoned TLP errors detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of flow control protocol errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of completion timeout errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of completion abort errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of unexpected completion errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of receiver overflow errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of malformed TLP errors detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of ECRC errors detected by PCIe device since the system
booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of unsupported request errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of access control errors detected by PCIe device since
the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of internal errors detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of blocked TLP errors detected by PCIe device since
the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of atomic operation blocked errors detected by PCIe
device since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of TLP prefix blocked errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
The count of the correctable PCIe errors.
nodetype: container (ro)
description:
Total number of correctable errors detected by PCIe device
since the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of receiver errors detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of TLPs with bad LCRC detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of DLLPs with bad LCRC detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of relay rollover errors detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of replay timeout errors detected by PCIe device since the
system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of advisory non fatal errors detected by PCIe device since
the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of internal errors detected by PCIe device since the system
booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
Number of header log overflow errors detected by PCIe device since
the system booted, according to PCIe AER driver.
nodetype: leaf (ro)
type: oc-yang:counter64
description:
If true, the hardware indicates that the component's physical equipment
has failed
nodetype: leaf (ro)
type: boolean
default: false
description:
If true, the hardware indicates that the component inserted into the
affected component's physical location is of a different type than what
is configured
nodetype: leaf (ro)
type: boolean
default: false
description:
Enclosing container
nodetype: container (rw)
description:
List of system properties for the component
nodetype: list (rw)
list keys: [name]
description:
Reference to the property name.
nodetype: leaf (list key) (rw)
type: leafref
description:
Configuration data for each property
nodetype: container (rw)
description:
System-supplied name of the property -- this is typically
non-configurable
nodetype: leaf (rw)
type: string
description:
Property values can take on a variety of types. Signed and
unsigned integer types may be provided in smaller sizes,
e.g., int8, uint16, etc.
nodetype: leaf (rw)
type: union
type: string
type: boolean
type: int64
type: uint64
type: decimal64
description:
Operational state data for each property
nodetype: container (ro)
description:
System-supplied name of the property -- this is typically
non-configurable
nodetype: leaf (ro)
type: string
description:
Property values can take on a variety of types. Signed and
unsigned integer types may be provided in smaller sizes,
e.g., int8, uint16, etc.
nodetype: leaf (ro)
type: union
type: string
type: boolean
type: int64
type: uint64
type: decimal64
description:
Indication whether the property is user-configurable
nodetype: leaf (ro)
type: boolean
description:
Enclosing container for subcomponent references
nodetype: container (rw)
description:
List of subcomponent references
nodetype: list (rw)
list keys: [name]
description:
Reference to the name list key
nodetype: leaf (list key) (rw)
type: leafref
description:
Configuration data for the subcomponent
nodetype: container (rw)
description:
Reference to the name of the subcomponent
nodetype: leaf (rw)
type: leafref
description:
Operational state data for the subcomponent
nodetype: container (ro)
description:
Reference to the name of the subcomponent
nodetype: leaf (ro)
type: leafref
description:
Data for chassis components
nodetype: container (rw)
description:
Configuration data for chassis components
nodetype: container (rw)
description:
Operational state data for chassis components
nodetype: container (ro)
description:
Resource utilization of the component.
nodetype: container (rw)
description:
Enclosing container for the resources in this component.
nodetype: container (rw)
description:
List of resources, keyed by resource name.
nodetype: list (rw)
list keys: [name]
description:
References the resource name.
nodetype: leaf (list key) (rw)
type: leafref
description:
Configuration data for each resource.
nodetype: container (rw)
description:
Resource name within the component.
nodetype: leaf (rw)
type: string
description:
The used percentage value (used / (used + free) * 100) that
when crossed will set utilization-threshold-exceeded to 'true'.
nodetype: leaf (rw)
type: oc-types:percentage
description:
The used percentage value (used / (used + free) * 100) that when
crossed will set utilization-threshold-exceeded to 'false'.
nodetype: leaf (rw)
type: oc-types:percentage
description:
Operational state data for each resource.
nodetype: container (ro)
description:
Resource name within the component.
nodetype: leaf (ro)
type: string
description:
The used percentage value (used / (used + free) * 100) that
when crossed will set utilization-threshold-exceeded to 'true'.
nodetype: leaf (ro)
type: oc-types:percentage
description:
The used percentage value (used / (used + free) * 100) that when
crossed will set utilization-threshold-exceeded to 'false'.
nodetype: leaf (ro)
type: oc-types:percentage
description:
Number of entries currently in use for the resource.
nodetype: leaf (ro)
type: uint64
description:
Number of entries currently reserved for this resource. This is only
relevant to tables which allocate a block of resource for a given
feature.
nodetype: leaf (ro)
type: uint64
description:
Number of entries available to use.
nodetype: leaf (ro)
type: uint64
description:
Maximum number of entries available for the resource. The value
is the theoretical maximum resource utilization possible.
nodetype: leaf (ro)
type: uint64
description:
A watermark of highest number of entries used for this resource.
nodetype: leaf (ro)
type: uint64
description:
The timestamp when the high-watermark was last updated. The value
is the timestamp in nanoseconds relative to the Unix Epoch
(Jan 1, 1970 00:00:00 UTC).
nodetype: leaf (ro)
type: oc-types:timeticks64
description:
This value is set to true when the used percentage value
(used / (used + free) * 100) has crossed the used-threshold-upper for this
resource and false when the used percentage value has crossed the configured
used-threshold-upper-clear value for this resource.
nodetype: leaf (ro)
type: boolean
description:
Data for physical port components
nodetype: container (rw)
description:
Configuration data for physical port components
nodetype: container (rw)
description:
Operational state data for physical port components
nodetype: container (ro)
description:
Data for power supply components
nodetype: container (rw)
description:
Configuration data for power supply components
nodetype: container (rw)
description:
Operational state data for power supply components
nodetype: container (ro)
description:
Data for fan components
nodetype: container (rw)
description:
Configuration data for fan components
nodetype: container (rw)
description:
Operational state data for fan components
nodetype: container (ro)
description:
Data for fabric components
nodetype: container (rw)
description:
Configuration data for fabric components
nodetype: container (rw)
description:
Operational state data for fabric components
nodetype: container (ro)
description:
Data for storage components
nodetype: container (rw)
description:
Configuration data for storage components
nodetype: container (rw)
description:
Operational state data for storage components
nodetype: container (ro)
description:
Data for cpu components
nodetype: container (rw)
description:
Configuration data for cpu components
nodetype: container (rw)
description:
Operational state data for cpu components
nodetype: container (ro)
description:
Data for chip components, such as ASIC, NPUs, etc.
nodetype: container (rw)
description:
Configuration data for chip components
nodetype: container (rw)
description:
The numeric ID (device_id) used by the controller to address
the integrated circuit, which may be referred to as a 'device',
'node' or 'target' by the P4RT specification.
Each switching ASIC (i.e., node) is addressed by the external
entity based on its numeric identifier.
The node ID is specified in addition to the string identifier
assigned to the integrated circuit within the
/components/component list.
nodetype: leaf (rw)
type: uint64
description:
Operational state data for chip components
nodetype: container (ro)
description:
The numeric ID (device_id) used by the controller to address
the integrated circuit, which may be referred to as a 'device',
'node' or 'target' by the P4RT specification.
Each switching ASIC (i.e., node) is addressed by the external
entity based on its numeric identifier.
The node ID is specified in addition to the string identifier
assigned to the integrated circuit within the
/components/component list.
nodetype: leaf (ro)
type: uint64
description:
Resource utilization of the component.
nodetype: container (rw)
description:
Enclosing container for the resources in this component.
nodetype: container (rw)
description:
List of resources, keyed by resource name.
nodetype: list (rw)
list keys: [name]
description:
References the resource name.
nodetype: leaf (list key) (rw)
type: leafref
description:
Configuration data for each resource.
nodetype: container (rw)
description:
Resource name within the component.
nodetype: leaf (rw)
type: string
description:
The used percentage value (used / (used + free) * 100) that
when crossed will set utilization-threshold-exceeded to 'true'.
nodetype: leaf (rw)
type: oc-types:percentage
description:
The used percentage value (used / (used + free) * 100) that when
crossed will set utilization-threshold-exceeded to 'false'.
nodetype: leaf (rw)
type: oc-types:percentage
description:
Operational state data for each resource.
nodetype: container (ro)
description:
Resource name within the component.
nodetype: leaf (ro)
type: string
description:
The used percentage value (used / (used + free) * 100) that
when crossed will set utilization-threshold-exceeded to 'true'.
nodetype: leaf (ro)
type: oc-types:percentage
description:
The used percentage value (used / (used + free) * 100) that when
crossed will set utilization-threshold-exceeded to 'false'.
nodetype: leaf (ro)
type: oc-types:percentage
description:
Number of entries currently in use for the resource.
nodetype: leaf (ro)
type: uint64
description:
Number of entries currently reserved for this resource. This is only
relevant to tables which allocate a block of resource for a given
feature.
nodetype: leaf (ro)
type: uint64
description:
Number of entries available to use.
nodetype: leaf (ro)
type: uint64
description:
Maximum number of entries available for the resource. The value
is the theoretical maximum resource utilization possible.
nodetype: leaf (ro)
type: uint64
description:
A watermark of highest number of entries used for this resource.
nodetype: leaf (ro)
type: uint64
description:
The timestamp when the high-watermark was last updated. The value
is the timestamp in nanoseconds relative to the Unix Epoch
(Jan 1, 1970 00:00:00 UTC).
nodetype: leaf (ro)
type: oc-types:timeticks64
description:
This value is set to true when the used percentage value
(used / (used + free) * 100) has crossed the used-threshold-upper for this
resource and false when the used percentage value has crossed the configured
used-threshold-upper-clear value for this resource.
nodetype: leaf (ro)
type: boolean
description:
Data for backplane components
nodetype: container (rw)
description:
Configuration data for backplane components
nodetype: container (rw)
description:
Operational state data for backplane components
nodetype: container (ro)
description:
Data for software module components, i.e., for components
with type=SOFTWARE_MODULE
nodetype: container (rw)
description:
Configuration data for software module components
nodetype: container (rw)
description:
Operational state data for software module components
nodetype: container (ro)
description:
Data for controller card components, i.e., for components
with type=CONTROLLER_CARD
nodetype: container (rw)
description:
Configuration data for controller card components.
nodetype: container (rw)
description:
Operational state data for controller card components
nodetype: container (ro)