From nobody Tue Apr 30 21:04:10 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=crudebyte.com ARC-Seal: i=1; a=rsa-sha256; t=1585664569; cv=none; d=zohomail.com; s=zohoarc; b=GsUa5ZEbaX511uUEBeeXzztgJY+uaa8T40bot0IpTtLPX7wrFYwyPt76l7rINLmNEjL26KbW3uvxmtDcnyy/+pwmirNhCOIMmit2+R7J7XI7LoO3zKcvK83Z4WcD/3g6hetvq//cXfJHXjBgteC2ZEH4qFk/QNr3mnt/iWcSpCY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1585664569; h=Cc:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:Message-ID:Sender:Subject:To; bh=kM38n4RhNzBA9bLRY0BJSg4Z1nUcKUBMBr0bGse8mAM=; b=YFivSgTPNDVyfkKdushKLYiHV0k7PiqnJK5JiRh+J/IjWl1L3Zu0BhVY3D1MvYbJ5fPLQf6k33lwYUd/37ZBBY2rp9Rvk2/uSwEP6jcgXcY0DJMA+RKEpdxGRdo1IAC76FZjOgM/7rFRQxf6QaDwXxMiyRDgN24q01vx5j69mR0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1585664568530512.6777968536891; Tue, 31 Mar 2020 07:22:48 -0700 (PDT) Received: from localhost ([::1]:38864 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jJHmx-0003nJ-4y for importer@patchew.org; Tue, 31 Mar 2020 10:22:47 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:50229) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from <208f1fceffce2feaf7c900b29e326b967dce7762@lizzy.crudebyte.com>) id 1jJHmG-0003EV-Vm for qemu-devel@nongnu.org; Tue, 31 Mar 2020 10:22:06 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from <208f1fceffce2feaf7c900b29e326b967dce7762@lizzy.crudebyte.com>) id 1jJHmE-0001wq-RD for qemu-devel@nongnu.org; Tue, 31 Mar 2020 10:22:04 -0400 Received: from lizzy.crudebyte.com ([91.194.90.13]:52117) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from <208f1fceffce2feaf7c900b29e326b967dce7762@lizzy.crudebyte.com>) id 1jJHmE-0001Q5-GC for qemu-devel@nongnu.org; Tue, 31 Mar 2020 10:22:02 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=crudebyte.com; s=lizzy; h=Cc:To:Subject:Date:From:Message-Id:Content-Type: Content-Transfer-Encoding:MIME-Version:References:In-Reply-To:Content-ID: Content-Description; bh=kM38n4RhNzBA9bLRY0BJSg4Z1nUcKUBMBr0bGse8mAM=; b=N/JNU hFr30y/3UHvgzp703rtnNZRGKVFQsE9h8j7N9+2skaHuzP/farsdV0bq4nUA4O9cHbi9Uc7I5Xa4f KkvBJIS0kqmESV06ibb415JSfC33so+BX+BXSrijFaJrvJKpVO6WcOqfUNihW0NgNa1dg8luIbWHp 4PEjcwGSu2+faEzhp7iYDMBvymJNVRpSAJPAeaFqbvC1P3CZiwAs8tbp7ldrDJeXDHp2axhPEaFoJ RKFEsIgTyDhPZqhNs07SOeHuoWWAtOh3C24jQxTNP+v2+n3pV/c7xVC0kKnNEY8sF+Ov/zY+GPGbl PSI/ajZNzjs4Tk2P9yoonQ2+vV11w==; Message-Id: <208f1fceffce2feaf7c900b29e326b967dce7762.1585661532.git.qemu_oss@crudebyte.com> From: Christian Schoenebeck Date: Tue, 31 Mar 2020 15:23:38 +0200 Subject: [PATCH] qemu-options.hx: 9p: clarify -virtfs vs. -fsdev To: qemu-devel@nongnu.org Cc: Greg Kurz X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 91.194.90.13 X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: pass (identity @crudebyte.com) Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" The docs are ambiguous about the difference (or actually their equality) between options '-virtfs' vs. '-fsdev'. So clarify that '-virtfs' is actually just a convenience shortcut for its generalized form '-fsdev' in conjunction with '-device virtio-9p-pci'. And as we're at it, also be a bit more descriptive what 9pfs is actually used for. Signed-off-by: Christian Schoenebeck Acked-by: Cornelia Huck --- qemu-options.hx | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/qemu-options.hx b/qemu-options.hx index 962a5ebaa6..fd3830c6cd 100644 --- a/qemu-options.hx +++ b/qemu-options.hx @@ -1542,9 +1542,17 @@ SRST ``-virtfs proxy,sock_fd=3Dsock_fd,mount_tag=3Dmount_tag [,writeout=3Dwrite= out][,readonly]`` \ ``-virtfs synth,mount_tag=3Dmount_tag`` - Define a new filesystem device and expose it to the guest using a - virtio-9p-device. The general form of a Virtual File system - pass-through options are: + Define a new virtual filesystem device and expose it to the guest using + a virtio-9p-device (a.k.a. 9pfs), which essentially means that a certa= in + directory on host is made directly accessible by guest as a pass-throu= gh + file system by using the 9P network protocol for communication between + host and guests, if desired even accessible, shared by several guests + simultaniously. + + Note that ``-virtfs`` is actually just a convenience shortcut for its + generalized form ``-fsdev -device virtio-9p-pci``. + + The general form of pass-through file system options are: =20 ``local`` Accesses to the filesystem are done by QEMU. --=20 2.20.1