From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on atuin.qyliss.net X-Spam-Level: X-Spam-Status: No, score=-1.8 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,RCVD_IN_DNSWL_LOW,RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL,SPF_HELO_PASS autolearn=unavailable autolearn_force=no version=3.4.6 Received: from atuin.qyliss.net (localhost [IPv6:::1]) by atuin.qyliss.net (Postfix) with ESMTP id E0EDA90212; Mon, 10 Oct 2022 23:32:28 +0000 (UTC) Received: by atuin.qyliss.net (Postfix, from userid 496) id D39E190123; Mon, 10 Oct 2022 23:32:19 +0000 (UTC) Received: from out4-smtp.messagingengine.com (out4-smtp.messagingengine.com [66.111.4.28]) by atuin.qyliss.net (Postfix) with ESMTPS id 839DD90073 for ; Mon, 10 Oct 2022 23:32:12 +0000 (UTC) Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.nyi.internal (Postfix) with ESMTP id 2B0115C01A6 for ; Mon, 10 Oct 2022 19:32:08 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute3.internal (MEProxy); Mon, 10 Oct 2022 19:32:08 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alyssa.is; h=cc :content-transfer-encoding:date:date:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:sender :subject:subject:to:to; s=fm2; t=1665444728; x=1665531128; bh=FL /C0skkYs26EjffDj6HrVDYPVhfReg6JghJ9FwuZAY=; b=UZs0cJJ9JsUWXDbnzn AStyqUUImvzf8g4KEuM6495aDMdOJofdjKG+uPA9kk+TXw6mYkx+fbnJdyhQf4Oj UShGWzUpxhnlONRXpbr7vieEZO9Q0UvurUT0u1L62rkkW/osNcJyU8l69fo04i90 VJqv/LKMSc7gVDqW2hqh404D0vDzqFGhnxt2WjolZ2em6DZQ8Mgh4tmHzjuSgqvQ cNTTEi/4ZXMjcg+o14gr9DpMX1CuMUOZWTKkWOhLc7Kflf5f1J1Ox6y/uPBiXA8r VyerxD5zt2kz5GKN/It2Kc8vulh+a7OGQ2B8cdXJZS6uUERUPEwya0tXT6weAYOZ +zKg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:date :feedback-id:feedback-id:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:sender:subject :subject:to:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; t=1665444728; x=1665531128; bh=FL/C0skkYs26E jffDj6HrVDYPVhfReg6JghJ9FwuZAY=; b=rg+v1TLX2x8mWwgq4Rj7uI+O22Mav o3kNARU9P9B+uQCqBbOK7DI3HpIF+b7As9HFraFIlbFoZv1cGkEUj+oX00+aesCr GQjeBOr/z4QiqjXRY57FZcT1Rmjuprtk9+8dhgBLkQk2J1bupUHssoi7w/kInrWp +Wa48NBeIrCVfDTLodYK0iIYSUUd+0RT3VY7R0JSK3YHpTFZE08Zz2LceKL1lWhK 2jyf37cBTWpWS5tiqjoktVT4avbDfn6eEPvodEwFVNHbhOUA9st687hDvG4setnm bo5GqmYAVpfkJbUQo9YcEcGoP8y0NO5cJr8tuz98pBd961OWD9XsVZLJg== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedrfeejhedgvddvucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucenucfjughrpefhvffufffkofgjfhgggfestdekre dtredttdenucfhrhhomheptehlhihsshgrucftohhsshcuoehhihesrghlhihsshgrrdhi sheqnecuggftrfgrthhtvghrnhepgfefudekvdelieelledufeevheeglefggedvudejvd dtffeuueevffehleejkedvnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehm rghilhhfrhhomhepqhihlhhishhsseigvddvtddrqhihlhhishhsrdhnvght X-ME-Proxy: Feedback-ID: i12284293:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Mon, 10 Oct 2022 19:32:07 -0400 (EDT) Received: by x220.qyliss.net (Postfix, from userid 1000) id 134A7BB4; Mon, 10 Oct 2022 23:32:06 +0000 (UTC) From: Alyssa Ross To: devel@spectrum-os.org Subject: [PATCH 04/22] Documentation: explain VM shared directories Date: Mon, 10 Oct 2022 23:28:44 +0000 Message-Id: <20221010232909.1953738-5-hi@alyssa.is> X-Mailer: git-send-email 2.37.1 In-Reply-To: <20221010232909.1953738-1-hi@alyssa.is> References: <20221010232909.1953738-1-hi@alyssa.is> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Message-ID-Hash: ULXD5FBKP6JWKCSYS3DZV7J7VS7MCY6A X-Message-ID-Hash: ULXD5FBKP6JWKCSYS3DZV7J7VS7MCY6A X-MailFrom: qyliss@x220.qyliss.net X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-config-1; header-match-devel.spectrum-os.org-0; header-match-devel.spectrum-os.org-1; header-match-devel.spectrum-os.org-2; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.5 Precedence: list List-Id: Patches and low-level development discussion Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Signed-off-by: Alyssa Ross --- Documentation/_sass/custom/custom.scss | 22 ++++++++++++++++++++++ Documentation/creating-vms.adoc | 8 ++++++++ 2 files changed, 30 insertions(+) create mode 100644 Documentation/_sass/custom/custom.scss diff --git a/Documentation/_sass/custom/custom.scss b/Documentation/_sass/custom/custom.scss new file mode 100644 index 0000000..eb50c81 --- /dev/null +++ b/Documentation/_sass/custom/custom.scss @@ -0,0 +1,22 @@ +// SPDX-FileCopyrightText: 2022 Alyssa Ross +// SPDX-License-Identifier: MIT + +.main-content { + // Just the Docs puts titles next to definitions, rather than on + // the line before. This makes the definitions too horizontally + // compressed. + dl { + display: block; + } + dt { + text-align: left; + font-weight: bold; + + &::after { + content: none; + } + } + dd { + margin-left: 2ch; + } +} diff --git a/Documentation/creating-vms.adoc b/Documentation/creating-vms.adoc index 6d4fde0..efae489 100644 --- a/Documentation/creating-vms.adoc +++ b/Documentation/creating-vms.adoc @@ -19,6 +19,14 @@ blk:: A directory containing disk images (with file names ending in ".img") that will be provided to the guest as a virtio-blk device. Order is not guaranteed. At least one image is *required*. +shared-dirs:: A directory whose *subdirectories* each describe a +directory to be shared with a VM. The name of each subdirectory is +used as the virtiofs tag, and the contents are as follows: + + dir::: A symbolic link pointing to the directory to be shared with + the VM. The directory must be on the xref:user-partition.adoc[user + data partition]. *Required.* + providers/net:: A directory containing a file named for each VM that should provide networking to this VM. The contents of these files are ignored. -- 2.37.1