From patchwork Tue Aug 8 06:27:30 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Klaus Jensen X-Patchwork-Id: 13345728 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id C9840C04A94 for ; Tue, 8 Aug 2023 06:28:39 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qTGBx-0004UN-WC; Tue, 08 Aug 2023 02:27:42 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qTGBv-0004St-Ig; Tue, 08 Aug 2023 02:27:39 -0400 Received: from out5-smtp.messagingengine.com ([66.111.4.29]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qTGBt-00070X-Mx; Tue, 08 Aug 2023 02:27:39 -0400 Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.nyi.internal (Postfix) with ESMTP id A08975C00CF; Tue, 8 Aug 2023 02:27:36 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute4.internal (MEProxy); Tue, 08 Aug 2023 02:27:36 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=irrelevant.dk; h=cc:cc:content-transfer-encoding:content-type: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=1691476056; x= 1691562456; bh=LiVaiUPQkEJAbjOQlo74CUcpKHBAY/5caLUVHR53Y9Y=; b=D IYnj1oT68R46ZAqiCW4zQGgjWNvFpML0ZTcTLgpVZr/gAOseWJ9dJKtmnxMC7YoY uVUFoKxs6+ehTZsID+skPYoue8G6P/KXBvBDBWu3vzvvPjVUm78nchGCrE9Mvy1N X4YxbdzcvKlHcoQMGOecMSgxxRhvJ6LCTbAhP7Lh6cdBLSIiKPajtI5te5kXua7m kO1PkiMYdCqrL/estbEdbARmlEo9Tfp9LNIiHB5IRdzERbwQA+XljrJPdTorVUJ8 jTQr2M96aJoUodFcDhWffkrF1Lo+YwlcZMZW0Imhp87eWF+s/3M5e4UB8njBzm5k rhpcjlPrsr7Rmn1+HcPPg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type: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=1691476056; x= 1691562456; bh=LiVaiUPQkEJAbjOQlo74CUcpKHBAY/5caLUVHR53Y9Y=; b=H qWAEy2eLBvSq+g1rzBVN2siZYO9pd7wRETYSMKBg0mXDHYwFphmTvXquJSmzTHRE /OrzMtOWquMysuv8o7mFA3xsAShX8TPq57ZEVV7lLwoUbIPyVhloztEb0pFVnc1V NFT6mAWXvoW7yCOqZ4/YzXorxd1dgAvKxYprP7rv4ijgW+mGLVMmqzqYMBHANCsb AVkF1j8pxJGwxjP3DiPngtmwv9aMlSWzK9S9Sx0FnzjPjOmSnXiBTnnHW9qwY6i0 gMfyK4NEbcBE5GL/J0vYfHUjQ7SBj92zrZfJDAn37CgJYfbQq+eh45dnZ6rMtKje 4tWd1IvofDus1aRyiZ+og== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedviedrledugddutdehucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvvefufffkofgjfhgggfestdekredtredttdenucfhrhhomhepmfhlrghu shculfgvnhhsvghnuceoihhtshesihhrrhgvlhgvvhgrnhhtrdgukheqnecuggftrfgrth htvghrnhepjefgieelgfeiveehkeeuveehheekfeevgeeigfehfefgjeejhefffeegudej udegnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepih htshesihhrrhgvlhgvvhgrnhhtrdgukh X-ME-Proxy: Feedback-ID: idc91472f:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue, 8 Aug 2023 02:27:34 -0400 (EDT) From: Klaus Jensen To: Peter Maydell , qemu-devel@nongnu.org Cc: qemu-block@nongnu.org, Keith Busch , Kevin Wolf , Hanna Reitz , Klaus Jensen , =?utf-8?q?Philippe_Mathieu-Daud=C3=A9?= , Stefan Hajnoczi , Fam Zheng , Ankit Kumar , Klaus Jensen Subject: [PULL 2/2] docs: update hw/nvme documentation for protection information Date: Tue, 8 Aug 2023 08:27:30 +0200 Message-ID: <20230808062727.19263-6-its@irrelevant.dk> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20230808062727.19263-4-its@irrelevant.dk> References: <20230808062727.19263-4-its@irrelevant.dk> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1608; i=k.jensen@samsung.com; h=from:subject; bh=7PyhBW87ohtkKzfN7XuRW2ocbhNYaJUMLfDxUacHVr8=; b=owJ4nAFtAZL+kA0DAAoBTeGvMW1PDekByyZiAGTR4FBaXSNtgmRZ4xk997G5oewRRdynp8UNL BcmTZAA4kdW6okBMwQAAQoAHRYhBFIoM6p14tzmokdmwE3hrzFtTw3pBQJk0eBQAAoJEE3hrzFt Tw3pwP4H/AvkP8Eb2qEHX89tGCj2iiixiuZw5ggC1FvKdbYb2KdNSXFnOxI4MPkeBjJzLW7oe8v TDQPV5a+zSydY+Vl0xaHI49rT18ZwFAW9S2u3Eq7xkbo5WdUtlE98kLfhaxiLfyO4wYibb4Inwd 3mHc1jZY78suW/1t4PrSw95M760Q6I2EYADtgKkECWPOyTPgFjhiRrk6TQ4eebyFk7wEkvZp8zu 2S2fUGvXNmGiRhj6qpIrbGGXdfsFL9wAg5MK3cHV0wfWreOyq12I2Z+aa85IBOb+zymXSsbwRhf GWHoHI1sFebxAE8gDMSTJ4ye43JJXfe+pdOv1c/29VawWlVQvhvcwKmX X-Developer-Key: i=k.jensen@samsung.com; a=openpgp; fpr=DDCA4D9C9EF931CC3468427263D56FC5E55DA838 Received-SPF: pass client-ip=66.111.4.29; envelope-from=its@irrelevant.dk; helo=out5-smtp.messagingengine.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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_LOW=-0.7, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, 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.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Sender: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org From: Ankit Kumar Add missing entry for pif ("protection information format"). Protection information size can be 8 or 16 bytes, Update the pil entry as per the NVM command set specification. Signed-off-by: Ankit Kumar Signed-off-by: Klaus Jensen --- docs/system/devices/nvme.rst | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/system/devices/nvme.rst b/docs/system/devices/nvme.rst index 2a3af268f7a5..32ff287cd78e 100644 --- a/docs/system/devices/nvme.rst +++ b/docs/system/devices/nvme.rst @@ -271,9 +271,15 @@ The virtual namespace device supports DIF- and DIX-based protection information ``pil=UINT8`` (default: ``0``) Controls the location of the protection information within the metadata. Set - to ``1`` to transfer protection information as the first eight bytes of - metadata. Otherwise, the protection information is transferred as the last - eight bytes. + to ``1`` to transfer protection information as the first bytes of metadata. + Otherwise, the protection information is transferred as the last bytes of + metadata. + +``pif=UINT8`` (default: ``0``) + By default, the namespace device uses 16 bit guard protection information + format (``pif=0``). Set to ``2`` to enable 64 bit guard protection + information format. This requires at least 16 bytes of metadata. Note that + ``pif=2`` (32 bit guards) are currently not supported. Virtualization Enhancements and SR-IOV (Experimental Support) -------------------------------------------------------------