git: 85b19c1799 - main - Status/2023Q2/ifapi.adoc: Add report

From: Lorenzo Salvadore <salvadore_at_FreeBSD.org>
Date: Sun, 09 Jul 2023 13:55:01 UTC
The branch main has been updated by salvadore:

URL: https://cgit.FreeBSD.org/doc/commit/?id=85b19c17994d9884a64402fda772d801390b2085

commit 85b19c17994d9884a64402fda772d801390b2085
Author:     Justin Hibbits <jhibbits@FreeBSD.org>
AuthorDate: 2023-07-09 13:50:47 +0000
Commit:     Lorenzo Salvadore <salvadore@FreeBSD.org>
CommitDate: 2023-07-09 13:53:50 +0000

    Status/2023Q2/ifapi.adoc: Add report
    
    Reviewed by:    status (Pau Amma <pauamma@gundo.com>)
    Approved by:    dbaio (mentor, implicit)
---
 .../content/en/status/report-2023-04-2023-06/ifapi.adoc | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/website/content/en/status/report-2023-04-2023-06/ifapi.adoc b/website/content/en/status/report-2023-04-2023-06/ifapi.adoc
new file mode 100644
index 0000000000..4c2f62233a
--- /dev/null
+++ b/website/content/en/status/report-2023-04-2023-06/ifapi.adoc
@@ -0,0 +1,17 @@
+=== Network Interface API (IfAPI)
+
+Links: +
+link:https://wiki.freebsd.org/projects/ifnet[Original project page] URL: link:https://wiki.freebsd.org/projects/ifnet
+
+Contact: Justin Hibbits <jhibbits@FreeBSD.org>
+
+Started back in 2014, the IfAPI (formerly DrvAPI) goal is to hide the man:ifnet[9] structure from network drivers.
+Instead, all accesses to members will go through accessor functions.
+This allows the network stack to be changed without recompiling drivers, as well as potentially allowing a single driver to support multiple versions of FreeBSD.
+
+As of now this goal has been achieved in the base system, but several ports need to be updated to use the IfAPI.
+There is a tool to automate most of the conversion, in [.filename]#tools/ifnet/convert_ifapi.sh#.
+Documentation is also forthcoming, but could use help on that.
+man:ifnet[9] needs a lot of cleanup, as even some information in it currently is out of date.
+
+Sponsor: Juniper Networks, Inc.