[rtems-libbsd commit] libbsd.txt: Move network interface driver hints

Sebastian Huber sebh at rtems.org
Wed May 25 06:05:24 UTC 2022


Module:    rtems-libbsd
Branch:    6-freebsd-12
Commit:    0283481dab29581d74a621a3bce254fe943adf69
Changeset: http://git.rtems.org/rtems-libbsd/commit/?id=0283481dab29581d74a621a3bce254fe943adf69

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Mon May 23 11:25:08 2022 +0200

libbsd.txt: Move network interface driver hints

---

 CONTRIBUTING.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index a1c711af..af072efe 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -493,3 +493,17 @@ within interrupt context is not allowed, so the Board Support Package (BSP)
 should support the
 `Interrupt Manager <https://docs.rtems.org/branches/master/c-user/interrupt/directives.html#rtems-interrupt-server-handler-install>`_
 in general.
+
+Network Interface Drivers Hints
+===============================
+
+Link Up/Down Events
+-------------------
+
+You can notifiy the application space of link up/down events in your network
+interface driver via the
+``if_link_state_change(LINK_STATE_UP/LINK_STATE_DOWN)`` function.  The
+DHCPCD(8) client is a consumer of these events for example.  Make sure that the
+interface flag ``IFF_UP`` and the interface driver flag ``IFF_DRV_RUNNING`` is
+set in case the link is up, otherwise ``ether_output()`` will return the error
+status ``ENETDOWN``.



More information about the vc mailing list