[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