From nobody Fri Dec 19 08:05:45 2025 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail header.i=@wdc.com; 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=wdc.com ARC-Seal: i=1; a=rsa-sha256; t=1601261299; cv=none; d=zohomail.com; s=zohoarc; b=PZUsgwSIAWxkS798ee9CIGVj3zyg3emLedw6WHyHgKcDAf0nsEUCtxvjyMtgPWU5nJrnuuWQSWJTEKKIxul0tzXOLWVEWc7TaTuKgg8j4Z6iLvqySd1hjaEmaywdG1OOkEUHDlWvFv1RruPDFd1Nk5NFOGMXuacKfX7ZfsZZZ14= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1601261299; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=YhwLzY9oxJbVxBuYadVNHsc+nli4l+vrV43E0havgO0=; b=YF4XAtneb6m61gUv4URYkKOHUe1Qs6NGzGgRyiMBtpa4DSwFlKnYy+hl2HXNtYNmjVrcnzN/uDAF/L+mP34uKHBXycF8NwwUECEUFf5MWqBv4RDkiH+xROtEY6EOtg74kr/LviK5heUDxi1rRtv0e6sKsp87yx9P8vGG3XPO1y0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail header.i=@wdc.com; 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) header.from= Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1601261299326839.9460180032457; Sun, 27 Sep 2020 19:48:19 -0700 (PDT) Received: from localhost ([::1]:37378 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kMjD8-000411-37 for importer@patchew.org; Sun, 27 Sep 2020 22:48:18 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:46580) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kMj1i-0007nW-MK; Sun, 27 Sep 2020 22:36:32 -0400 Received: from esa1.hgst.iphmx.com ([68.232.141.245]:21619) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kMj1e-0003Li-QQ; Sun, 27 Sep 2020 22:36:30 -0400 Received: from h199-255-45-14.hgst.com (HELO uls-op-cesaep01.wdc.com) ([199.255.45.14]) by ob1.hgst.iphmx.com with ESMTP; 28 Sep 2020 10:36:05 +0800 Received: from uls-op-cesaip02.wdc.com ([10.248.3.37]) by uls-op-cesaep01.wdc.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 27 Sep 2020 19:23:01 -0700 Received: from unknown (HELO redsun50.ssa.fujisawa.hgst.com) ([10.149.66.24]) by uls-op-cesaip02.wdc.com with ESMTP; 27 Sep 2020 19:36:03 -0700 DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=wdc.com; i=@wdc.com; q=dns/txt; s=dkim.wdc.com; t=1601260586; x=1632796586; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=CDicpbQlEYirPMv6LJDX+sqlc3u9djdNDeAWD2fg/v8=; b=DH4m6/FC4KHJSTn2PHkI6ExZXiLBT4PIYfX4PKZKux5mZ7HsBlkUFpF4 8GG68sDmVlnqmOYoAW31jLDw36h3F7x5hWNaiGA/iJ7HQ8JH05Vzepp4y IliJ83bFfRvDYLcKX8TaIQ7H2JkJhZS49/Dov3BmY+XSlbg0bZ2tj82Uu nenU5tpaeEMnwKq6cAxUXfahZUuqVt2YMb8NfcoAqJS8J5unrs8/I6qsR PBo9H1GItyMOvjhBo8rLbQbYj2nysF02aNGkxRo8Cg/hKFSG0aoennLyo Zno7pjq8HLAi+0+5+BUeFdVLayHHbwpnHYfzUj6GfEDcxA0hPJ2AxMEEE A==; IronPort-SDR: IXlCPyiBNO9tHZUFGqYKJocM22q5NiEmxaiOqxNmaadflDZPSinpUaWOQ4x0j4GGVKZQFVhGdN TiQg2LJQYNP4sYfr3LiTnhNOnmALlqBX3DId4GQR7uFOJUi2KCIdfiokese0n1drKDSNis/axl 14liZrwyu4QrRArXEIWgnVQHlgQMeCz+myNSH5T/1jieTvjcQuZW06QPoNN+S2dob5aFx/vDKr 20ovk/2y5MHDHMCLBbn/DubUr5qRa2Hz01prHUJg1SSA2b63LklUb5AVq1jhg88UtMmbV5cz6/ lFo= X-IronPort-AV: E=Sophos;i="5.77,312,1596470400"; d="scan'208";a="258125254" IronPort-SDR: v65OiUf2vqV0Y6duojK6o0FPTWAxrrwXA8Nj5eGQsjfewe/XHq5Y+HMvWVREjQGh/uv974yUuV aQrecWr7c9Sg== IronPort-SDR: fr911q5Yf0OdNrJ/BWd94FydXg2dvERsfQ45ZlwDvtlOxFcw+pNzXfO1p+60DJC9yZYyGvSTJe yEGzLL3dgxOQ== WDCIronportException: Internal From: Dmitry Fomichev To: Keith Busch , Klaus Jensen , Kevin Wolf , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Maxim Levitsky , Fam Zheng Subject: [PATCH v5 14/14] hw/block/nvme: Document zoned parameters in usage text Date: Mon, 28 Sep 2020 11:35:28 +0900 Message-Id: <20200928023528.15260-15-dmitry.fomichev@wdc.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20200928023528.15260-1-dmitry.fomichev@wdc.com> References: <20200928023528.15260-1-dmitry.fomichev@wdc.com> 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=68.232.141.245; envelope-from=prvs=5334b480d=dmitry.fomichev@wdc.com; helo=esa1.hgst.iphmx.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/09/27 22:35:35 X-ACL-Warn: Detected OS = FreeBSD 9.x or newer [fuzzy] X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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: , Cc: Niklas Cassel , Damien Le Moal , qemu-block@nongnu.org, Dmitry Fomichev , qemu-devel@nongnu.org, Alistair Francis , Matias Bjorling Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) Content-Type: text/plain; charset="utf-8" Added brief descriptions of the new device properties that are now available to users to configure features of Zoned Namespace Command Set in the emulator. This patch is for documentation only, no functionality change. Signed-off-by: Dmitry Fomichev --- hw/block/nvme.c | 44 ++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 42 insertions(+), 2 deletions(-) diff --git a/hw/block/nvme.c b/hw/block/nvme.c index ff7d43d38f..34fc6daf9d 100644 --- a/hw/block/nvme.c +++ b/hw/block/nvme.c @@ -9,7 +9,7 @@ */ =20 /** - * Reference Specs: http://www.nvmexpress.org, 1.2, 1.1, 1.0e + * Reference Specs: http://www.nvmexpress.org, 1.4, 1.3, 1.2, 1.1, 1.0e * * https://nvmexpress.org/developers/nvme-specification/ */ @@ -23,7 +23,8 @@ * max_ioqpairs=3D, \ * aerl=3D, aer_max_queued=3D, \ * mdts=3D - * -device nvme-ns,drive=3D,bus=3Dbus_name,nsid=3D + * -device nvme-ns,drive=3D,bus=3Dbus_name,nsid=3D, \ + * zoned=3D * * Note cmb_size_mb denotes size of CMB in MB. CMB is assumed to be at * offset 0 in BAR2 and supports only WDS, RDS and SQS for now. @@ -49,6 +50,45 @@ * completion when there are no oustanding AERs. When the maximum number= of * enqueued events are reached, subsequent events will be dropped. * + * Setting `zoned` to true selects Zoned Command Set at the namespace. + * In this case, the following options are available to configure zoned + * operation: + * zone_size=3D + * + * zone_capacity=3D + * The value 0 (default) forces zone capacity to be the same as zo= ne + * size. The value of this property may not exceed zone size. + * + * zone_file=3D + * Zone metadata file, if specified, allows zone information + * to be persistent across shutdowns and restarts. + * + * zone_descr_ext_size=3D + * This value needs to be specified in 64B units. If it is zero, + * namespace(s) will not support zone descriptor extensions. + * + * max_active=3D + * + * max_open=3D + * + * zone_append_size_limit=3D + * The maximum I/O size that can be supported by Zone Append + * command. Since internally this this value is maintained as + * ZASL =3D log2( / ), some + * values assigned to this property may be rounded down and + * result in a lower maximum ZA data size being in effect. + * If MDTS property is not assigned, the default value of 128KiB is + * used as ZASL. + * + * offline_zones=3D + * + * rdonly_zones=3D + * + * cross_zone_read=3D + * + * fill_pattern=3D + * The byte pattern to return for any portions of unwritten data + * during read. */ =20 #include "qemu/osdep.h" --=20 2.21.0