From nobody Sun Jul 09 13:55:01 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QzTCn2qb8z4mDBv for ; Sun, 9 Jul 2023 13:55:01 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QzTCn2Pvcz4CQM; Sun, 9 Jul 2023 13:55:01 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688910901; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=eKJfcZngyweN7mobKPl4kVHigKoydrLYr1fbKuVWC7k=; b=SYhjFQDOi6lPYHpM/rZ/RHyYeDSdPoa2gJNxAAyMTpDvPN3TUMbRataqHEzV92wwatR+mt Ce4oodWHLagJjF2ys02puvyfdd8GJh+CHMmMvWCBjab0R21jMWXMhOpADdVAT+kHAJk1QV 8ARBIpmZDv0olifTUl5vjfiBwMy2IifcbEA97mzb27dJf/Q0PSmZ/JcybnNLr+nR4xKl7B UAlICJrQxv2zwxAuo13LhPYZNNHsB5W/Q6RKg8TWWXA49YmIrVwGBwWhO51KC/HZo+hBhi ph6ZTT86fYv9dFMk9+1joQMjQyyU0/RKjinwqPjrGjx2YGwcbip5+zG2ysbZ1A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688910901; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=eKJfcZngyweN7mobKPl4kVHigKoydrLYr1fbKuVWC7k=; b=F7tzpttNDq81cYcGOElIXXT07fWZAmCmQVIGLwXO790ds69YnAH7350o5socZgFvrZIh4b 8WIFlGFtasl1AY3cjIa8GgCOirTzkHKVrEm9NmuK8SaJ9aQH6szsC0eYnWtQefCq7+PYc7 B4IuCuKgNaPBbpRceM/QtBihLjtpG8RwX7a7873af8WlNiD745bBDbDEahwHfo1+AGusaU +UUuYA+tdqwtQ6gCTbtAphvddWRj/I9zlBoZ5Z5Rh07y5U7C79ULT9/GzlV/WflV4kY1MO qnFeX0ZK8cWVZo/fpiDbhmHil2oOdHUr9R1EmK4bRTtk4ke/Kve6QWDHj7aAkQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688910901; a=rsa-sha256; cv=none; b=sfwFx8yyhZZLECHvCgi87tixPciMYzFnsw/T5bk0OVLA9GrSyAWjdGzKErRhtpxud764AB huaI05xjpWqnnxU06U27K4gCGTdg/w/18yG3S2FFM142xxZn5rpd/tp11sGJSsb2iePeqi YhG1cZb1m6uNpTn8aJa4xOPd62KEre/7j4FL0yMaKYl2b4YHZ4myOKZ4svJccFosh66Bxa RNeob3VIn8rjXZsWDTsKEj17uw7ZjwQloR/jerYAj5LOXETUapCfRzI5Bwbqk0zIYn+oLn lG0tyj2UdiZPU7Agc1HXSJtYlaBj7e42aNrmUugsi+WoT78ih2ExPf2x13ZQYw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4QzTCn1Wldz14Tm; Sun, 9 Jul 2023 13:55:01 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 369Dt1Rv003389; Sun, 9 Jul 2023 13:55:01 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 369Dt1BZ003388; Sun, 9 Jul 2023 13:55:01 GMT (envelope-from git) Date: Sun, 9 Jul 2023 13:55:01 GMT Message-Id: <202307091355.369Dt1BZ003388@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: 85b19c1799 - main - Status/2023Q2/ifapi.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 85b19c17994d9884a64402fda772d801390b2085 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=85b19c17994d9884a64402fda772d801390b2085 commit 85b19c17994d9884a64402fda772d801390b2085 Author: Justin Hibbits AuthorDate: 2023-07-09 13:50:47 +0000 Commit: Lorenzo Salvadore CommitDate: 2023-07-09 13:53:50 +0000 Status/2023Q2/ifapi.adoc: Add report Reviewed by: status (Pau Amma ) 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 + +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.