From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from atuin.qyliss.net (localhost [IPv6:::1]) by atuin.qyliss.net (Postfix) with ESMTP id 0A6651A202; Mon, 08 Sep 2025 10:05:48 +0000 (UTC) Received: by atuin.qyliss.net (Postfix, from userid 993) id F0EC31A180; Mon, 08 Sep 2025 10:05:45 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-26) on atuin.qyliss.net X-Spam-Level: X-Spam-Status: No, score=-0.8 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,DMARC_MISSING,RCVD_IN_DNSWL_LOW,SPF_HELO_PASS autolearn=unavailable autolearn_force=no version=4.0.1 Received: from fout-b5-smtp.messagingengine.com (fout-b5-smtp.messagingengine.com [202.12.124.148]) by atuin.qyliss.net (Postfix) with ESMTPS id 327A51A0FD for ; Mon, 08 Sep 2025 10:05:44 +0000 (UTC) Received: from phl-compute-06.internal (phl-compute-06.internal [10.202.2.46]) by mailfout.stl.internal (Postfix) with ESMTP id 1ECC91D00118; Mon, 8 Sep 2025 06:05:43 -0400 (EDT) Received: from phl-mailfrontend-01 ([10.202.2.162]) by phl-compute-06.internal (MEProxy); Mon, 08 Sep 2025 06:05:43 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alyssa.is; h=cc :cc:content-type:content-type:date:date:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:subject :subject:to:to; s=fm3; t=1757325942; x=1757412342; bh=6c14UR0Dox 71DnPtwjyNTqproeFKfYrulYhwE9C3ndA=; b=Q/ZrX6XrobJhmlJ+e+/rEhtY1E LZPHta+RdkLHQVgxtJ+6reVrsl6fY32Kda4CHrZ3FA+AL+7phu5+K0edKhlBw1OI x5j6cMTT0UlibLJ/F4+HDrXNa2Au5iFAD6rJdomP7XrZhXXFZSIf45/hYmbZHkIt lJjJzqJvAQEE7O0K8XneFi2v/uLVeaEVW4MMAo63Z5yrfsuF2h+dv7s2Lq2o8Rbi 8MVLw5kgjJwZbnxL1NkRGIb0HPM4DPhMzLNTaNwatB4E+wS26JtcwQ0QuIvHRQw4 8ZknhOz/F9qOsqz14nyFqxyqkSb2wP840IGn98CUkKvcqMQARsFFm5tWZ2+g== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:subject:subject:to :to:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t= 1757325942; x=1757412342; bh=6c14UR0Dox71DnPtwjyNTqproeFKfYrulYh wE9C3ndA=; b=LENCDEoO8TPGzcuHLb211WAYt6rysE/omcGAlM7osgghVDNSxwx W0jAMp9dU/eQc0Z5TkXWvVBmN95jnv+IR97dsmHec5WVCKdwP1tz1BvvnCIdVt66 u0YPHiNSTV3FtaswkgEyDLvQxKn6tQiMruckBYnE9Jc9lGoh9bt+jdf+5wnJL8Sg pcA6EszqBy112bSX+7BAkrBgOGSE/vSAU6tuGwIXz4rfOekTrOArYzmmXCj2sBlO A4AAUt3dsByF1CnbR35f2geC9ypWfBJNVqAon3bduO6Urbc6+3Vl7fNY6lTTpq4f iOS0kItj0T2DsDVxMyrfPBhfpT3XR6o/kkQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeffedrtdeggddujedvhecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpuffrtefokffrpgfnqfghnecuuegr ihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenucfjug hrpefhvfevufgjfhffkfggtgesghdtreertddttdenucfhrhhomheptehlhihsshgrucft ohhsshcuoehhihesrghlhihsshgrrdhisheqnecuggftrfgrthhtvghrnhepudefudekie fgledvvdejhfelheelledtteekhffggfejffevheevgeehkeevleeinecuffhomhgrihhn peguihhouggvrdiiohhnvgenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmh grihhlfhhrohhmpehhihesrghlhihsshgrrdhishdpnhgspghrtghpthhtohepvddpmhho uggvpehsmhhtphhouhhtpdhrtghpthhtohephihurhgvkhgrsegthigsvghrtghhrghosh druggvvhdprhgtphhtthhopeguvghvvghlsehsphgvtghtrhhumhdqohhsrdhorhhg X-ME-Proxy: Feedback-ID: i12284293:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Mon, 8 Sep 2025 06:05:42 -0400 (EDT) Received: by mbp.qyliss.net (Postfix, from userid 1000) id 8E46F1675B96; Mon, 08 Sep 2025 12:05:40 +0200 (CEST) From: Alyssa Ross To: Yureka Lilian Subject: Re: [DO_NOT_APPLY v3 3/3] docs/architecture: add paragraph about networking In-Reply-To: <20250901201248.19794-4-yureka@cyberchaos.dev> References: <20250901201248.19794-1-yureka@cyberchaos.dev> <20250901201248.19794-4-yureka@cyberchaos.dev> Date: Mon, 08 Sep 2025 12:05:39 +0200 Message-ID: <87tt1di7ik.fsf@alyssa.is> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" Message-ID-Hash: 4Q3D22TTO7DCP7VL5ICX7GDHL6BQCUJB X-Message-ID-Hash: 4Q3D22TTO7DCP7VL5ICX7GDHL6BQCUJB X-MailFrom: hi@alyssa.is X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-devel.spectrum-os.org-0; header-match-devel.spectrum-os.org-1; header-match-devel.spectrum-os.org-2; header-match-devel.spectrum-os.org-3; header-match-devel.spectrum-os.org-4; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: devel@spectrum-os.org X-Mailman-Version: 3.3.9 Precedence: list List-Id: Patches and low-level development discussion Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Yureka Lilian writes: > --- > Documentation/about/architecture.adoc | 20 ++++++++++++++++++++ > 1 file changed, 20 insertions(+) Reviewed-by: Alyssa Ross (I'll make some minor copyediting changes when it's ready to be applied, but won't trouble you with those.) When I get around to it, I'll probably rename netvm to "driver VM" or something, BTW, since given we don't control the IOMMU groups, we'll have to be prepared to drive multiple kinds of devices from one VM, assuming we ever manage to move anything aside from network devices out of the host. > diff --git a/Documentation/about/architecture.adoc b/Documentation/about/= architecture.adoc > index e32ab27..2b86616 100644 > --- a/Documentation/about/architecture.adoc > +++ b/Documentation/about/architecture.adoc > @@ -68,3 +68,23 @@ nix-build img/live --no-out-link | xargs -o nix-tree >=20=20 > See the https://diode.zone/w/8DBDQ6HQUe5UUdLkpDuL35[video] of Spectrum l= ive > image interactive analysis with nix-tree. > + > +=3D=3D Networking > + > +The net-vm's purpose is running the Linux drivers for any physical > +interfaces on the spectrum system. > + > +A net-vm (there could be multiple, one per IOMMU-group) will load the > +xdp-forwarder XDP programs on the passed-through physical interfaces as = well > +as the downstream virtio interface going into the router (recognized by > +its special MAC address) using mdev events. > + > +The net-vm needs to multiplex between the physical interfaces, as there > +might be several interfaces in the same IOMMU-group. > + > +For this, the xdp-forwarder applies a > +VLAN tag corresponding to the interface id, and redirects the packets to > +the router interface (identified by the router_iface bpf map). > +In the other direction the XDP program loaded on the router interface > +removes one layer of VLAN tagging, and redirects the packets to the > +interface read from the VLAN tag. > --=20 > 2.50.1 --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEARYKAB0WIQRV/neXydHjZma5XLJbRZGEIw/wogUCaL6qcwAKCRBbRZGEIw/w ogWpAP9pX9UnmpWi2QWhyMfdmuZ4DLF6YtswV01jcwq8v3nM5gEAwYCZAC/rXbm1 +ZEKIR6QiLa2BBP9R6l0+N90Bo4QgAo= =Z3oh -----END PGP SIGNATURE----- --=-=-=--