{{numentries}}
{{object}} table (a stackable interface object as described in
{{bibref|TR-181i2|Section 4.2}}).
{{numentries}}
{{object}} table (a stackable interface object as described in
{{bibref|TR-181i2|Section 4.2}}).
MAC address target of the magic packet.
The SecureOn password. The parameter value can be empty or, if present,
can contain either 4 bytes or 6 bytes.
Ethernet object, which is any interface implementing the {{bibref|802.3-2015}} family of specifications.
This object models several Ethernet interface objects,
each representing a different stack layer, including:
{{object|Interface}}, {{object|Link}}, and {{object|VLANTermination}}.
{{object|Interface}} is media-specific and models a port, the PHY
layer, and the Channel Access Method (CAM) part of the MAC layer.
{{object|Link}} is media-independent and models the Logical Link
Control (LLC) layer. An "outer" {{object|VLANTermination}}, when
present, is expected to be stacked on top of {{object|Link}} objects to
receive and send frames with a configured VLANID.
Indicates that WoL (Wake on LAN) over Ethernet is supported.
Indicates that Flow Control over Ethernet is supported, as per
{{bibref|802.3-2015}}.
{{numentries}}
Ethernet interface table (a stackable interface object as described in
{{bibref|TR-181i2|Section 4.2}}) for any interface implementing the IEEE 802.3 family
of specifications. This table models physical Ethernet ports, but in terms of the interface
stack it only models the PHY and Connection Access Method of the Ethernet interface MAC. A
{{object|#.Link}} is also required to model a full Ethernet device.
The unique manufacturer-assigned Ethernet hardware address of the
interface, also referred to as burned-in MAC address.
Note: This is not necessarily the same as the MAC address used for
higher-level protocols, which is modeled via the
{{param|#.Link.{i}.MACAddress}} parameter. Its main purpose is the
identification of a specific Ethernet interface; the information can
also can be used to perform Wake on LAN.
Reports the supported link modes. MUST be reported in a compliant way
as defined in {{bibref|IANAMauMIB|IANAifMauTypeListBits}}. For
example, IANAifMauTypeListBits defines the following link mode types:
* ''16'' (100BASE-TX full duplex mode)
* ''26'' (1000BASE-SX full duplex mode)
* ''30'' (1000BASE-T full duplex mode)
* ''54'' (10GBASE-T)
* ''103'' (2.5GBASE-T)
* ''104'' (5GBASE-T)
Sets the advertised link modes. MUST be set in a compliant way
as defined in {{bibref|IANAMauMIB|IANAifMauTypeListBits}}. For
example, IANAifMauTypeListBits defines the following link mode types:
* ''16'' (100BASE-TX full duplex mode)
* ''26'' (1000BASE-SX full duplex mode)
* ''30'' (1000BASE-T full duplex mode)
* ''54'' (10GBASE-T)
* ''103'' (2.5GBASE-T)
* ''104'' (5GBASE-T)
Reports the link modes advertised by the link partner. MUST be reported in a compliant way
as defined in {{bibref|IANAMauMIB|IANAifMauTypeListBits}}. For
example, IANAifMauTypeListBits defines the following link mode types:
* ''16'' (100BASE-TX full duplex mode)
* ''26'' (1000BASE-SX full duplex mode)
* ''30'' (1000BASE-T full duplex mode)
* ''54'' (10GBASE-T)
* ''103'' (2.5GBASE-T)
* ''104'' (5GBASE-T)
The current upstream and downstream PHY bit rate on this interface
(expressed in {{units}}).
A value of 0 indicates that the current bit rate is unknown.
The duplex mode requested for this connection.
The duplex mode currently in use by this connection.
Indicates whether this physical ethernet port supports Energy
Efficient Ethernet as specified in
{{bibref|802.3-2012_section6|Section 78}}.
Whether Energy Efficient Ethernet
{{bibref|802.3-2012_section6|Section 78}} support is currently
enabled. When enabled, this ethernet port will be capable of entering
or exiting Low Power Idle (LPI) mode.
Indicates the active state of Energy Efficient Ethernet
{{bibref|802.3-2012_section6|Section 78}}.
The {{enum|Disabled}} value indicates that {{param|EEEEnable}} is disabled.
The {{enum|Active}} value indicates that {{param|EEEEnable}} is enabled and
that EEE support has been negotiated with the link partner. In this state EEE
will be used.
The {{enum|Inactive}} value indicates that {{param|EEEEnable}} is disabled, or that
EEE support has not been negotiated with the link partner, either because the
link parter is not EEE capable, or its support for EEE is disabled.
The {{enum|Unsupported}} value indicates that this physical interface does not
support EEE. In which case {{param|EEECapability}} will be {{false}}.
Indicates whether this physical ethernet port supports Energy Detect Power Down (EDPD).
Implementations of this feature are vendor specific,
Energy Detect Power Down is not part of the 802.3-2015 standard.
Indicates whether Energy Detect Power Down (EDPD) support is currently enabled.
When enabled, depending on the type of hardware, either the transmit power is disabled or
the link impulses are sent at a greater interval.
Implementations of this feature are vendor specific,
Energy Detect Power Down is not part of the 802.3-2015 standard.
Indicates the active state of Energy Detect Power Down (EDPD).
Implementations of this feature are vendor specific,
Energy Detect Power Down is not part of the 802.3-2015 standard.
Indicates that EDPD is disabled.
Indicates that {{param|EDPDEnable}} is enabled and supported
by the physical interface. In this state EDPD will be used.
Indicates that this physical interface does not support EDPD.
In which case {{param|EDPDCapability}} will be {{false}}.
Configure the Medium Dependent Interface crossover functionality on the interface.
The current Medium Dependent Interface crossover setting in use on the interface.
The total number of collisions on the interface.
Ethernet link layer table (a stackable interface object as described in
{{bibref|TR-181i2|Section 4.2}}). Table entries model the Logical Link
Control (LLC) layer. It is expected that an ''Ethernet Link'' interface
can be stacked above any lower-layer interface object capable of
carrying Ethernet frames.
Maximum Transmission Unit for this interface (expressed in
{{units}}).
The MAC address used for packets sent via this interface. Provides
the source MAC address for outgoing traffic and the destination MAC
address for incoming traffic.
Enables or disables priority tagging on this Ethernet Link.
When {{true}}, egress frames leaving this interface will be priority
tagged with the frame's associated priority value, which will either
be derived directly from the ingress frame or else set via
{{param|##.QoS.Classification.{i}.EthernetPriorityMark}} or
{{param|##.QoS.Classification.{i}.InnerEthernetPriorityMark}}.
When {{false}}, egress frames leaving this interface will be
untagged.
The parameter does not affect reception of ingress frames.
Configures Flow Control on given Ethernet port. When set to {{true}},
it activates the exchange of pause-resume flow control frames.
Disables or enables sending of ARP messages on the Ethernet link.
If {{true}}, the kernel will not send ARP requests and won't send ARP replies.
{{deprecated|2.21|in favor of {{param|##.NeighborDiscovery.InterfaceSetting.{i}.ARP.Enable}}}}
The total number of Ethernet pause frames sent on the link.
The total number of Ethernet pause frames received on the link.
VLAN Termination table (a stackable interface object as described in
{{bibref|TR-181i2|Section 4.2}}). A VLAN Termination entry is typically
stacked on top of a {{object|#.Link}} object to receive and send frames
with the configured {{param|VLANID}}.
The VLAN ID for this {{object}} entry (as defined in
{{bibref|802.1Q-2011}}). Only ingress frames with this VLAN ID will
be passed to higher protocol layers; frames sent from higher protocol
layers will be tagged with this VLAN ID.
The VLAN Priority for this {{object}} entry, also known as 802.1p Priority,
is a 3-bit field used to indicate the priority of network traffic within a VLAN.
A value of ''-1'' indicates that the VLAN priority should not be changed for this {{object}}.
The Tag Protocol Identifier (TPID) assigned to this {{object}}. The
TPID is an EtherType value used to identify the frame as a tagged
frame.
Standard {{bibref|802.1Q-2011|Table 9.1}} TPID values are:
*S-TAG 0x88A8 = 34984
*C-TAG 0x8100 = 33024
Non-Standard TPID values are:
*S-TAG 0x9100 = 37120
Ethernet statistics based on the {{bibref|RFC2819}} ''RMON-MIB''
''etherStatsTable'', with some extensions inspired by
{{bibref|G.988|Section 9.3.32}}.
Each instance is associated with an interface capable of transporting
Ethernet-encapsulated packets, and contains a set of unidirectional
Ethernet statistics.
The statistics are sampled either on ingress or on egress. This is
determined as follows:
* If the instance is associated with an egress queue (or queues) via
the {{param|Queue}} parameter or by setting {{param|AllQueues}} to
{{true}} then data is sampled on egress. In this case {{param|Bytes}}
etc measure the data that has been sent on the interface, possibly
filtered by {{param|Queue}} or {{param|VLANID}}.
* Otherwise data is sampled on ingress. In this case {{param|Bytes}}
etc measure the data that has been received on the interface,
possibly filtered by {{param|VLANID}}.
When sampling on egress, the term ''received'' means ''received by the
queuing sub-system''.
Multiple instances can be associated with a single interface:
individual instances can be configured to collect data associated with
the entire interface, or with a particular VLAN and/or queue.
The CPE MUST reset each instances's Stats parameters whenever the
instance is disabled and re-enabled. Whether this reset occurs when the
instance becomes operationally disabled ({{param|Status}} =
{{enum|Disabled|Status}}) or administratively enabled ({{param|Enable}}
= {{true}}) is a local matter to the CPE. This is similar to the
behavior of interface statistics, e.g. as specified for
{{object|#.Interface.{i}.Stats}}. Furthermore, this instance's Stats
parameters MUST be reset whenever the referenced interface's Stats
parameters are reset, or when the referenced queue or VLAN is disabled
and re-enabled.
For enabled table entries, if {{param|Interface}} references an
interface that is not capable of transporting Ethernet-encapsulated
packets, or if {{param|Queue}} references a queue that is not
instantiated on {{param|Interface}}, or if {{param|Queue}} is not a
valid reference and {{param|AllQueues}} is {{false}}, the table entry
is inoperable and the CPE MUST set {{param|Status}} to
{{enum|Error_Misconfigured|Status}}.
Note: The {{object}} table includes unique key parameters that are
strong references. If a strongly referenced object is deleted, the CPE
will set the referencing parameter to {{empty}}. However, doing so
under these circumstances might cause the updated {{object}} row to
then violate the table's unique key constraint; if this occurs, the CPE
MUST set {{param|Status}} to {{enum|Error_Misconfigured|Status}} and
disable the offending {{object}} row.
Enables or disables this instance.
The status of this instance. {{enum}}
The {{enum|Error_Misconfigured}} value indicates that a necessary
configuration value is undefined or invalid.
The {{enum|Error}} value MAY be used by the CPE to indicate a locally
defined error condition.
The textual name of the {{object}} entry as assigned by the CPE.
The interface associated with this instance. {{reference|an interface
that is capable of transporting Ethernet-encapsulated packets}}
The term "capable of transporting Ethernet-encapsulated packets"
means "has an Ethernet header" and therefore refers to any interface
that is at or below an ''Ethernet''.{{object|#.Link}} instance in the
interface stack.
Filter criterion.
The VLAN ID for which statistics are to be collected.
A zero value indicates that all packets, whether or not they have a
VLAN header, will be considered.
A non-zero value indicates that only packets that have the the
specified VLAN ID will be considered.
Filter criterion.
The egress queue with which this instance is associated.
Only packets that are sent to the referenced queue will be
considered.
Indicates whether this instance applies to all queues. If {{true}},
the value of {{param|Queue}} is ignored since all egress queues are
indicated.
The total number of events in which packets were dropped due to lack
of resources. Note that this number is not necessarily the number of
packets dropped; it is just the number of times this condition has
been detected.
This parameter is based on ''etherStatsDropEvents'' from
{{bibref|RFC2819}}.
The total number of {{units}} (including those in bad packets)
received (excluding framing bits but including FCS bytes).
This parameter is based on ''etherStatsOctets'' from
{{bibref|RFC2819}}.
The total number of {{units}} (including bad packets, broadcast
packets, and multicast packets) received.
This parameter is based on ''etherStatsPkts'' from
{{bibref|RFC2819}}.
The total number of good {{units}} received that were directed to the
broadcast address. Note that this does not include multicast packets.
This parameter is based on ''etherStatsBroadcastPkts'' from
{{bibref|RFC2819}}.
The total number of good {{units}} received that were directed to a
multicast address. Note that this number does not include packets
directed to the broadcast address.
This parameter is based on ''etherStatsMulticastPkts'' from
{{bibref|RFC2819}}.
The total number of {{units}} received that had a length (excluding
framing bits, but including FCS bytes) of between 64 and 1518 bytes,
inclusive, but had either a bad Frame Check Sequence (FCS) with an
integral number of bytes (FCS Error) or a bad FCS with a non-integral
number of bytes (Alignment Error).
This parameter is based on ''etherStatsCRCAlignErrors'' from
{{bibref|RFC2819}}.
The total number of {{units}} received that were less than 64 bytes
long (excluding framing bits, but including FCS bytes) and were
otherwise well formed.
This parameter is based on ''etherStatsUndersizePkts'' from
{{bibref|RFC2819}}.
The total number of {{units}} received that were longer than 1518
bytes (excluding framing bits, but including FCS bytes) and were
otherwise well formed.
This parameter is based on ''etherStatsOversizePkts'' from
{{bibref|RFC2819}}.
The total number of {{units}} (including bad packets) received that
were 64 bytes in length (excluding framing bits but including FCS
bytes).
This parameter is based on ''etherStatsPkts64Octets'' from
{{bibref|RFC2819}}.
The total number of {{units}} (including bad packets) received that
were between 65 and 127 bytes in length inclusive (excluding framing
bits but including FCS bytes).
This parameter is based on ''etherStatsPkts65to127Octets'' from
{{bibref|RFC2819}}.
The total number of {{units}} (including bad packets) received that
were between 128 and 255 bytes in length inclusive (excluding framing
bits but including FCS bytes).
This parameter is based on ''etherStatsPkts128to255Octets'' from
{{bibref|RFC2819}}.
The total number of {{units}} (including bad packets) received that
were between 256 and 511 bytes in length inclusive (excluding framing
bits but including FCS bytes).
This parameter is based on ''etherStatsPkts256to511Octets'' from
{{bibref|RFC2819}}.
The total number of {{units}} (including bad packets) received that
were between 512 and 1023 bytes in length inclusive (excluding
framing bits but including FCS bytes).
This parameter is based on ''etherStatsPkts512to1023Octets'' from
{{bibref|RFC2819}}.
The total number of {{units}} (including bad packets) received that
were between 1024 and 1518 bytes in length inclusive (excluding
framing bits but including FCS bytes).
This parameter is based on ''etherStatsPkts1024to1518Octets'' from
{{bibref|RFC2819}}.
This object provides access to the WoL (Wake on LAN) functionality.
Ethernet Link Aggregation Group (LAG) table (a stackable interface
object as described in {{bibref|TR-181i2|Section 4.2}}). Table entries
model the Link Aggregation Sub-Layer as defined in
{{bibref|802.3-2015}} and {{bibref|802.1AX-2014}}. It is expected that
a {{object}} interface can only be stacked above {{object|#.Interface}}
interfaces. The CPE can reject creation of additional LAG instances if
this would exceed its capabilities.
{{param}} must reference to Device.Ethernet.Interface instances where
Link Aggregation Group is configured by the CPE.
For example, "Device.Ethernet.Interface.1,
Device.Ethernet.Interface.2"
MAC address of the Link Aggregation Interface.