From nobody Sat May 18 21:15:56 2024 Delivered-To: importer@patchew.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=fail(p=none dis=none) header.from=bytedance.com ARC-Seal: i=1; a=rsa-sha256; t=1653916232; cv=none; d=zohomail.com; s=zohoarc; b=gAbhSRFov8j8McsNpzHyoBIrTJiOcC5la/SzxgY/s0rVTYK7fJQlEuRONj4TAzEgL208QcRuYFo03airGsuLr2r/pwfW9FKcZIqDQOVqWjBRKzyaw4BcCgDZYFMqH1CyzizmRzlFhNThSp04lTbZWbjwZacQdzTSNuEt0VZPeW0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1653916232; h=Content-Transfer-Encoding:Cc:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To; bh=o6AXr5TJ451k6quZ+GTuFmIYm1I8K5rTXSLs5A80P8E=; b=ZTvY70jSM9cYBW5eeALcL+FQgwNecmYfQfG8X6cM6reXFeyf29eawOp6HbHIBcreaWHxgOkFeEpGx5yQ7Bw+G9Fc6F0jRgmmsPaDi6pdZtcMv0I+qId0subawsQAGxsG69xZ/3FxfUTl0IA/7NYgc9xDvD9okhFD8m0sRyMwWEU= 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=fail header.from= (p=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1653916232646818.0716327692464; Mon, 30 May 2022 06:10:32 -0700 (PDT) Received: from localhost ([::1]:58076 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nvfAF-0000yl-8u for importer@patchew.org; Mon, 30 May 2022 09:10:31 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:40818) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nvf3w-0004M9-Lr for qemu-devel@nongnu.org; Mon, 30 May 2022 09:04:00 -0400 Received: from mail-pg1-x52f.google.com ([2607:f8b0:4864:20::52f]:35435) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nvf3q-0006Y7-3g for qemu-devel@nongnu.org; Mon, 30 May 2022 09:03:58 -0400 Received: by mail-pg1-x52f.google.com with SMTP id 129so5829933pgc.2 for ; Mon, 30 May 2022 06:03:52 -0700 (PDT) Received: from localhost ([139.177.225.244]) by smtp.gmail.com with ESMTPSA id p3-20020a1709026b8300b0016390e0db7asm7216931plk.121.2022.05.30.06.03.49 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 30 May 2022 06:03:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bytedance-com.20210112.gappssmtp.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=o6AXr5TJ451k6quZ+GTuFmIYm1I8K5rTXSLs5A80P8E=; b=hjA/AzSyhoan9Da+EhyEBQgswnAJdRq+o9fpdgWjgSXUV+fk8CUbTod01iG+zk9EQs Ae74uUYJjsd+ZBJKYy/65bFO7emoJxdjUjEa6j2uAllzHohEuaZenmHn9gj8u1ApAACM QUBxuEpUvPXQKUp3zTaOX56a3eB2/z6F5zJqLSjJty23/cFDcsQziCU3NvKFHCOsZg5h KGJIeP4ZL3mMXLJfZVU5BGuPW0KkgHEVrhCpRADuvLgORzU3cAejKNLifzxaqj09ZjC8 JCNtbaeafYQQ1bfddq33iJ2eiQnolSgi12dZGFbhQdTUBPw7a3b8nhFop+0//uOgBAAL uUmw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=o6AXr5TJ451k6quZ+GTuFmIYm1I8K5rTXSLs5A80P8E=; b=qJJCmyv+SjOM7Yks0adBLV64I/ADzUgGHYE0KGCEuxQwNgSUIOWUbm71XfDpexR0E7 WkWmuLAkzqyxkCKrslae5c6LUUKSTzKvYp6IXciSuYNZTdleJqYE1F1aRyG8gZnqXFQx XbhCEKbMJqnFrr5BzDFDBAQw3IJ4h1SuPvz93zZWUqtCuCfeMZlIKVzcii8Lrwftcw1B hnsSQZnYDR537aLxKb9MhUoLAiGMyNOH8YJgadNM/nBfu/p3dH0l5p5//yl3EzBR70KJ 0CL4JDqOV9+iP6YHg0WwRMPEFYNHChM4OpGnZgy7UFvaxGJEHv4JFHO9PW3qYZ0WHP3e KtoA== X-Gm-Message-State: AOAM531ys+Uk58vbuiK8EkkTftGlP4YkAEkES91tlxNfWvGazN18qErk 7yCyTwMy6JO20ql8sr6sReo9 X-Google-Smtp-Source: ABdhPJyu3D7BUK3R8J+PGQA3APMPBuH2Cv2Ukv016zmlEebjzRWhypotGm2AVX75CPD9h2Jq6e2Jmw== X-Received: by 2002:a63:d813:0:b0:3f5:f9d8:7cce with SMTP id b19-20020a63d813000000b003f5f9d87ccemr48695872pgh.585.1653915831524; Mon, 30 May 2022 06:03:51 -0700 (PDT) From: Xie Yongji To: kwolf@redhat.com, stefanha@redhat.com Cc: qemu-block@nongnu.org, qemu-devel@nongnu.org Subject: [PATCH] vduse-blk: Add name option Date: Mon, 30 May 2022 21:04:28 +0800 Message-Id: <20220530130428.137-1-xieyongji@bytedance.com> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable 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; Received-SPF: pass client-ip=2607:f8b0:4864:20::52f; envelope-from=xieyongji@bytedance.com; helo=mail-pg1-x52f.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=unavailable autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 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 @bytedance-com.20210112.gappssmtp.com) X-ZM-MESSAGEID: 1653916234123100003 Content-Type: text/plain; charset="utf-8" Currently we use 'id' option as the name of VDUSE device. It's a bit confusing since we use one value for two different purposes: the ID to identfy the export within QEMU (must be distinct from any other exports in the same QEMU process, but can overlap with names used by other processes), and the VDUSE name to uniquely identify it on the host (must be distinct from other VDUSE devices on the same host, but can overlap with other export types like NBD in the same process). To make it clear, this patch adds a separate 'name ' option to specify the VDUSE name for the vduse-blk export instead. Signed-off-by: Xie Yongji --- block/export/vduse-blk.c | 6 +++--- docs/tools/qemu-storage-daemon.rst | 5 +++-- qapi/block-export.json | 7 ++++--- storage-daemon/qemu-storage-daemon.c | 8 ++++---- 4 files changed, 14 insertions(+), 12 deletions(-) diff --git a/block/export/vduse-blk.c b/block/export/vduse-blk.c index 3b10349173..acf2d30e6c 100644 --- a/block/export/vduse-blk.c +++ b/block/export/vduse-blk.c @@ -245,7 +245,7 @@ static int vduse_blk_exp_create(BlockExport *exp, Block= ExportOptions *opts, } vblk_exp->num_queues =3D num_queues; vblk_exp->handler.blk =3D exp->blk; - vblk_exp->handler.serial =3D exp->id; + vblk_exp->handler.serial =3D vblk_opts->name; vblk_exp->handler.logical_block_size =3D logical_block_size; vblk_exp->handler.writable =3D opts->writable; =20 @@ -279,7 +279,7 @@ static int vduse_blk_exp_create(BlockExport *exp, Block= ExportOptions *opts, features |=3D 1ULL << VIRTIO_BLK_F_RO; } =20 - vblk_exp->dev =3D vduse_dev_create(exp->id, VIRTIO_ID_BLOCK, 0, + vblk_exp->dev =3D vduse_dev_create(vblk_opts->name, VIRTIO_ID_BLOCK, 0, features, num_queues, sizeof(struct virtio_blk_config), (char *)&config, &vduse_blk_ops, @@ -290,7 +290,7 @@ static int vduse_blk_exp_create(BlockExport *exp, Block= ExportOptions *opts, } =20 vblk_exp->recon_file =3D g_strdup_printf("%s/vduse-blk-%s", - g_get_tmp_dir(), exp->id); + g_get_tmp_dir(), vblk_opts->nam= e); if (vduse_set_reconnect_log_file(vblk_exp->dev, vblk_exp->recon_file))= { error_setg(errp, "failed to set reconnect log file"); vduse_dev_destroy(vblk_exp->dev); diff --git a/docs/tools/qemu-storage-daemon.rst b/docs/tools/qemu-storage-d= aemon.rst index fbeaf76954..8a20ebd304 100644 --- a/docs/tools/qemu-storage-daemon.rst +++ b/docs/tools/qemu-storage-daemon.rst @@ -77,7 +77,7 @@ Standard options: --export [type=3D]vhost-user-blk,id=3D,node-name=3D,addr.= type=3Dunix,addr.path=3D[,writable=3Don|off][,logical-block-si= ze=3D][,num-queues=3D] --export [type=3D]vhost-user-blk,id=3D,node-name=3D,addr.= type=3Dfd,addr.str=3D[,writable=3Don|off][,logical-block-size=3D][,num-queues=3D] --export [type=3D]fuse,id=3D,node-name=3D,mountpoint=3D[,growable=3Don|off][,writable=3Don|off][,allow-other=3Don|off|auto] - --export [type=3D]vduse-blk,id=3D,node-name=3D[,writable= =3Don|off][,num-queues=3D][,queue-size=3D][,logical= -block-size=3D] + --export [type=3D]vduse-blk,id=3D,node-name=3D,name=3D[,writable=3Don|off][,num-queues=3D][,queue-size=3D][,logical-block-size=3D] =20 is a block export definition. ``node-name`` is the block node that shoul= d be exported. ``writable`` determines whether or not the export allows write @@ -111,7 +111,8 @@ Standard options: ``allow-other`` to auto (the default) will try enabling this option, and= on error fall back to disabling it. =20 - The ``vduse-blk`` export type uses the ``id`` as the VDUSE device name. + The ``vduse-blk`` export type takes a ``name`` (must be unique across th= e host) + to create the VDUSE device. ``num-queues`` sets the number of virtqueues (the default is 1). ``queue-size`` sets the virtqueue descriptor table size (the default is = 256). =20 diff --git a/qapi/block-export.json b/qapi/block-export.json index e4bd4de363..f5a2713e59 100644 --- a/qapi/block-export.json +++ b/qapi/block-export.json @@ -182,6 +182,7 @@ # # A vduse-blk block export. # +# @name: the name of VDUSE device (must be unique across the host). # @num-queues: the number of virtqueues. Defaults to 1. # @queue-size: the size of virtqueue. Defaults to 256. # @logical-block-size: Logical block size in bytes. Range [512, PAGE_SIZE] @@ -190,7 +191,8 @@ # Since: 7.1 ## { 'struct': 'BlockExportOptionsVduseBlk', - 'data': { '*num-queues': 'uint16', + 'data': { 'name': 'str', + '*num-queues': 'uint16', '*queue-size': 'uint16', '*logical-block-size': 'size'} } =20 @@ -314,8 +316,7 @@ # Describes a block export, i.e. how single node should be exported on an # external interface. # -# @id: A unique identifier for the block export (across the host for vduse= -blk -# export type or across all export types for other types) +# @id: A unique identifier for the block export (across all export types) # # @node-name: The node name of the block node to be exported (since: 5.2) # diff --git a/storage-daemon/qemu-storage-daemon.c b/storage-daemon/qemu-sto= rage-daemon.c index d47fb2d468..4375282b2e 100644 --- a/storage-daemon/qemu-storage-daemon.c +++ b/storage-daemon/qemu-storage-daemon.c @@ -122,11 +122,11 @@ static void help(void) #endif /* CONFIG_VHOST_USER_BLK_SERVER */ #ifdef CONFIG_VDUSE_BLK_EXPORT " --export [type=3D]vduse-blk,id=3D,node-name=3D\n" -" [,writable=3Don|off][,num-queues=3D]\n" -" [,queue-size=3D]\n" +" ,name=3D[,writable=3Don|off]\n" +" [,num-queues=3D][,queue-size=3D]\n" " [,logical-block-size=3D]\n" -" export the specified block node as a vduse-blk\n" -" device using the id as the VDUSE device name\n" +" export the specified block node as a\n" +" vduse-blk device\n" "\n" #endif /* CONFIG_VDUSE_BLK_EXPORT */ " --monitor [chardev=3D]name[,mode=3Dcontrol][,pretty[=3Don|off]]\n" --=20 2.20.1