From nobody Sat Nov 15 02:02:58 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=1592431199; cv=none; d=zohomail.com; s=zohoarc; b=fT3ZSaPbeRQtoQkbmnIW726Ayd+SJpp9OLf115ZDGKojNN6Zh9ZsbDEyzMTcFo7QXDTS34dWTpSXLs5buOg6qq7pn4NPZNj0aJnsBNdw4eANP7TQC+/MZpq0U5SJfUsc10A0c4euOiop/eB4wU28fhayS6h6g1oOUzjOX66Eqik= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1592431199; 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=va1Q2UsNHVPLnGE2Y0UZONED+1jPz6VLoha/EepSxaM=; b=Qpqz1vtDXXzTZkxNTxIfeFDEwbd7XQmGi4Vsg/0h5VNNyTK+jVMJP1egQtJ0h/4BPxfEiZXy+HUsJsDZggBnEw/OExENv2EG27Zs/nrFwX5PTtqggzfR4NscCCOhwd/7hvkrTmEb8XgGQRHmv3iDBpZ7XaZi6RwW6FaD9wp4WXs= 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 1592431199530305.65622310944605; Wed, 17 Jun 2020 14:59:59 -0700 (PDT) Received: from localhost ([::1]:50124 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jlg6A-0006KC-7E for importer@patchew.org; Wed, 17 Jun 2020 17:59:58 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:46400) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jlfil-0005AE-7b; Wed, 17 Jun 2020 17:35:48 -0400 Received: from esa1.hgst.iphmx.com ([68.232.141.245]:29885) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jlfii-0005JY-1P; Wed, 17 Jun 2020 17:35:46 -0400 Received: from uls-op-cesaip02.wdc.com (HELO uls-op-cesaep02.wdc.com) ([199.255.45.15]) by ob1.hgst.iphmx.com with ESMTP; 18 Jun 2020 05:35:00 +0800 Received: from uls-op-cesaip02.wdc.com ([10.248.3.37]) by uls-op-cesaep02.wdc.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 17 Jun 2020 14:23:41 -0700 Received: from unknown (HELO redsun50.ssa.fujisawa.hgst.com) ([10.149.66.24]) by uls-op-cesaip02.wdc.com with ESMTP; 17 Jun 2020 14:34:59 -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=1592429743; x=1623965743; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=+rqBZY1U3F+yetC52f/eo+7Diy5jbNgRvxvBAhx0aao=; b=b3seLZVmq+03txtaufYYUd7MGE6JRgK1h3Avc+dDyx0uMRkVMU/Qj7/k ySXORvH9f3ifGLB1/uSIfb25vHdxwVL72CIsK+rO1EKBBKCgeLkkZRfbk HAJ89IeEsV6tFR+KOoF70v+3cYcGO0mZ367nBf82B7AB06bAJx4sIRfrJ S2uudSlSPi3yTufaPpM8n8Xhb2XyU2veaqgGGmrK1g3XfuLNvfjSE2X03 xJp8y5H+RH6mDI2ElAD53DMb4mc9LTPfl9eNl9Btf266qiNtaGLGrH6PG VsYWpgdtUhAgvK1D33J2tV2BGjrwwpHYY02yg5QJsQF52On4OIjo+SIOY A==; IronPort-SDR: J3sQ4+Lu7HeJrkZfnDfW3AqD08kMhdaJaMq7ULIpAYVI2v3znb601TtewZ0aese5B/79ljpjXX 9eljBak+IIJ8xqSvhyQyHSLZN6PNqLAWMPESHbAZbjAXfL7lgp+opGlPJ9PalUda2gN+Dpe+Rf 4cg7kT2FOLs2PNm4GScj6UCClbgDkZLfjKzz9M0XCDD5prUNE42LvJOvEixpIuZ2Dr8+PwDT8Y b3E+5ti5NsJmydfJLRK0/dcpGjAzmYa8h74QhbLSxeHAMb3mUXHIm4wp02OwPgaOpFYIgDJItb IFg= X-IronPort-AV: E=Sophos;i="5.73,523,1583164800"; d="scan'208";a="249439849" IronPort-SDR: 6qizE2Lmrt6xMT1kymNWSBHd9sWfDyXxsOITRZnjRHkxK9u76VC49UqtOwmlJtVL1WuHNKSQ03 7cc5ZogYH9aFXjfIVrz6B7/QLMZwubl04= IronPort-SDR: wT2sYu4NG9DC7YafUcU2mjQXmlaBLTky2wTVn+Ql4SAZMsAHhDYS/+UKjeITXFcoN4F7gIiW6P SlDiuOkk6DfQ== WDCIronportException: Internal From: Dmitry Fomichev To: Kevin Wolf , Keith Busch , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Maxim Levitsky Subject: [PATCH v2 18/18] hw/block/nvme: Document zoned parameters in usage text Date: Thu, 18 Jun 2020 06:34:15 +0900 Message-Id: <20200617213415.22417-19-dmitry.fomichev@wdc.com> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20200617213415.22417-1-dmitry.fomichev@wdc.com> References: <20200617213415.22417-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=430b82a1d=dmitry.fomichev@wdc.com; helo=esa1.hgst.iphmx.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/06/17 17:34:28 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, URIBL_BLOCKED=0.001 autolearn=_AUTOLEARN 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, 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 driver properties now available to users to configure features of Zoned Namespace Command Set in the driver. This patch is for documentation only, no functionality change. Signed-off-by: Dmitry Fomichev --- hw/block/nvme.c | 62 +++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 60 insertions(+), 2 deletions(-) diff --git a/hw/block/nvme.c b/hw/block/nvme.c index 63e7a6352e..90b1ae24b5 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 * * http://www.nvmexpress.org/resources/ */ @@ -20,7 +20,8 @@ * -device nvme,drive=3D,serial=3D,id=3D, \ * cmb_size_mb=3D, \ * [pmrdev=3D,] \ - * max_ioqpairs=3D + * max_ioqpairs=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. @@ -32,6 +33,63 @@ * For example: * -object memory-backend-file,id=3D,share=3Don,mem-path=3D, \ * size=3D .... -device nvme,...,pmrdev=3D + * + * Setting "zoned" to true makes the driver emulate zoned namespaces. + * In this case, of the following options are available to configure zoned + * operation: + * zone_size=3D + * + * zone_capacity=3D + * + * 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 + * + * reset_rcmnd_delay=3D + * The amount of time that passes between the moment when a zone + * enters Full state and when Reset Zone Recommended attribute + * is set for that zone. + * + * reset_rcmnd_limit=3D + * If this value is zero (default), RZR attribute is not set for + * any zones. + * + * finish_rcmnd_delay=3D + * The amount of time that passes between the moment when a zone + * enters an Open or Closed state and when Finish Zone Recommended + * attribute is set for that zone. + * + * finish_rcmnd_limit=3D + * If this value is zero (default), FZR attribute is not set for + * any zones. + * + * zamds=3D + * The maximum I/O size that can be supported by Zone Append + * command. Since internally this this value is maintained as + * ZAMDS =3D log2( / ), some + * values assigned to this property may be rounded down and + * result in a lower maximum ZA data size being in effect. + * + * zone_async_events=3D + * Enable sending Zone Descriptor Changed AENs to the host. + * + * offline_zones=3D + * + * rdonly_zones=3D + * + * cross_zone_read=3D + * + * fill_pattern=3D + * Byte pattern to to return for any portions of unwritten data + * during read. */ =20 #include "qemu/osdep.h" --=20 2.21.0