zephyr/doc/reference/networking/ethernet_mgmt.rst
Jukka Rissanen 575040496d doc: net: Add table of contents to networking docs
This allows easy access to different part of the page.

Signed-off-by: Jukka Rissanen <jukka.rissanen@linux.intel.com>
2019-03-03 23:50:17 -05:00

35 lines
968 B
ReStructuredText

.. _ethernet_mgmt_interface:
Ethernet Management
###################
.. contents::
:local:
:depth: 2
Overview
********
Ethernet management API provides functions to manage the Ethernet
network interface low level status. The caller of these functions can:
* raise ``carrier ON`` or ``carrier OFF`` management events
* raise ``VLAN enabled`` or ``VLAN disabled`` management events
Typically the ``carrier OFF`` event would be generated by the Ethernet
device driver when it notices that the Ethernet cable is disconnected.
The ``carrier ON`` event would be generated if the Ethernet device driver
notices that the Ethernet cable is re-connected.
Currently the VLAN events are generated by the Ethernet L2 layer when a
specific VLAN tag is either enabled or disabled.
The user application can monitor these events if it needs to act
when the corresponding status changes.
API Reference
*************
.. doxygengroup:: ethernet_mgmt
:project: Zephyr