From patchwork Fri Oct 25 14:14:47 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: David Hildenbrand X-Patchwork-Id: 13850764 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 kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id E4466D0C616 for ; Fri, 25 Oct 2024 14:15:31 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 6B50B6B0098; Fri, 25 Oct 2024 10:15:31 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 665AE6B0099; Fri, 25 Oct 2024 10:15:31 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 52D5B6B009B; Fri, 25 Oct 2024 10:15:31 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id 333BC6B0098 for ; Fri, 25 Oct 2024 10:15:31 -0400 (EDT) Received: from smtpin01.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id 1DECEAC574 for ; Fri, 25 Oct 2024 14:14:52 +0000 (UTC) X-FDA: 82712321496.01.63F99F0 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by imf17.hostedemail.com (Postfix) with ESMTP id E499540011 for ; Fri, 25 Oct 2024 14:15:13 +0000 (UTC) Authentication-Results: imf17.hostedemail.com; dkim=pass header.d=redhat.com header.s=mimecast20190719 header.b=gEsaMdXn; dmarc=pass (policy=none) header.from=redhat.com; spf=pass (imf17.hostedemail.com: domain of david@redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=david@redhat.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1729865603; a=rsa-sha256; cv=none; b=I0pkcAxqP49x+6OkWoEUHwXIm3s5bwua54PNlv/yB7FEG2nUwZ9jRE4xm8sCLiYAgbxn/y bVzecoLmpobgOj4X7q9NjFE3AME2YFZZ1dmVBtL9kvw51hZ4mgD1bOkCe7Sn/ZGGztB9ih uEyf56uuyxt1zDFdocyxy+0YLhXQ4gE= ARC-Authentication-Results: i=1; imf17.hostedemail.com; dkim=pass header.d=redhat.com header.s=mimecast20190719 header.b=gEsaMdXn; dmarc=pass (policy=none) header.from=redhat.com; spf=pass (imf17.hostedemail.com: domain of david@redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=david@redhat.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1729865603; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=ZrDkTfigLaNGazXPM44aNCnZCzJMkV9GdJkwS2fHAmE=; b=rj6iLkTOd1ZvucT/DUx6TtLvpojDm+VvekPorL+r7OX/H9FTiJoOwQ1baLy/TG2VkdHtuN Jg21KlSd0+wyu2kU6IbKztAUAKCwXCtPvY26jHqmdPu9NMacjrsJ7H9B7drWncGxTZU0K3 Ot8Sm7WPya2NLlQ1hXMUmzy3stCLTbs= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1729865728; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=ZrDkTfigLaNGazXPM44aNCnZCzJMkV9GdJkwS2fHAmE=; b=gEsaMdXnLi8lveCQ6r2EnMx0GkFLlhxfnOgw7BprXHDmoCXhRmRPrSBGFUlDnjZXuRIL8Q iWqot5d92f648KgeYY8Edu4+mGbsHn2I/L1EGPnYs1k0EZlX1QFa/nG8lsZhWOXh1K4KpH 2ymO55StYVyv6Nk+j6qEmXhXvzubWVA= Received: from mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-493-5G9aywhZMEOYyzT-kYfMXQ-1; Fri, 25 Oct 2024 10:15:24 -0400 X-MC-Unique: 5G9aywhZMEOYyzT-kYfMXQ-1 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 4594C1955E85; Fri, 25 Oct 2024 14:15:18 +0000 (UTC) Received: from t14s.redhat.com (unknown [10.22.65.27]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 25C4219560A2; Fri, 25 Oct 2024 14:15:10 +0000 (UTC) From: David Hildenbrand To: linux-kernel@vger.kernel.org Cc: linux-mm@kvack.org, linux-s390@vger.kernel.org, virtualization@lists.linux.dev, linux-doc@vger.kernel.org, kvm@vger.kernel.org, David Hildenbrand , Heiko Carstens , Vasily Gorbik , Alexander Gordeev , Christian Borntraeger , Sven Schnelle , Thomas Huth , Cornelia Huck , Janosch Frank , Claudio Imbrenda , "Michael S. Tsirkin" , Jason Wang , Xuan Zhuo , =?utf-8?q?Eugenio_P=C3=A9rez?= , Eric Farman , Andrew Morton , Jonathan Corbet Subject: [PATCH v3 2/7] Documentation: s390-diag.rst: document diag500(STORAGE LIMIT) subfunction Date: Fri, 25 Oct 2024 16:14:47 +0200 Message-ID: <20241025141453.1210600-3-david@redhat.com> In-Reply-To: <20241025141453.1210600-1-david@redhat.com> References: <20241025141453.1210600-1-david@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 X-Rspamd-Server: rspam12 X-Rspamd-Queue-Id: E499540011 X-Stat-Signature: byehogmupt6i36tp6y6fwpzsqakxz18m X-Rspam-User: X-HE-Tag: 1729865713-603476 X-HE-Meta: U2FsdGVkX1+ezOlZsdpbEywbtai8B9HxO5rvj852IOuslhBoHDfml8Zs1x3ZfPI1iVxoUn2Cr/0MTz6OXfgXt4PnuctPD90+hOWfaaRnibZn74/f746lI67XGun+HQRdGy8QH9ZZJm2SM3Gb4rVXldVvRzqTxiHVvIQyBBg7wQmJiFb23MGYqIcGc9bun2DAO7+4VGecPSfklRBTVxohX9SrvWnpixh7MMTLWKCt1ZizSEHHCjCEpBjeegVLs27J+7A08XWFfNiFK9667hEofHX0O81/93sJK9Po5rfXOKifGfx7Ry37vqZGUvbF9zpAiE7gJHUwWse3BHBr2KLcHyBecU+/ENGIZlUUj9TXkcfQNzwxIQhSTBGMYyEavjQt9NgyF0UFrrqOKHUim19oeseZig0KE0RDl88bnCNtKw6O8wCmDpkAulLUrlWlUF6+fBLmkUCk7JMnLgp2qK2ZWD7P9I0K50YqxFtm5/jwmSfVSmDMBsyUtAC3Jn4gPm7NN3cy6I7kOhvWRMKvDWW0dJmPmK4+ZfqbUiLQXUoBcEGakwReceZ4OL2z5VcdM1HnRAfjniY6ud9Bw2sl8ORZblbvdCCGJnBIBHLLD7z5zyoXBGk9m7vPvbUC7GozRoPQE3EyPFB5iHqb4xlj/gQAEk/1WhV+hsHN2c4c9UFA9gbSnt0rHYS6F9Q8fLGmxzCq25s2WGJhv8tuXNG2WOCTJ2K519slwSv0ZP/QrhEySr1OqX6UuFNMdPQx1JjKxdLm27gAVw6acDI+kzY1VGWnls5+N8Zl/fbXicHPsQCL5nxe18/w9eTU+JxBAIRVKT6+MxmdgZy6sHwpukELnhE/VLfiRdzJy/jPlnifVUqyn2KXb90lOpAVvy/FMeeDvuN9JRsPUiCbO8HVnQx+LUIZHDZB2NpP+XfsEYe1tKvo87QR76qN7F/VfNdWbVm31Gs1pFg5iP3rsa2vYwYOiVc uVUiJvsk w1YKP2mpWZJQtkumD10WhEMfPFEqELpgVjPGltUBh1cVeYDtbJsZer9FEFzdgs62jukULG3XtMwIyWhKmhOzDHx+6X//rgFZ3i+QVkNFP3hkOnXUv1D6MM/hjAjApI+ymIfSx7++x+MtLMGhFaB+jw+Qhq/mVDpBlE+hhgnnJO7X4tALiXNIolf2nJzl2VJf/+h0T7ihvNvxxBv2zc30fEvCk0vLSZEyBPNDHJPHpbwswmWOjSsWgGIFrhnZ+7W3SnN9oWqoRgjoFbisZEt5OmkyApkAw6HWR5cZHm/wy3umPwDUwtu6pwSQwGEtJfRCkee/Q/RMihKp2dxo= X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: Let's document our new diag500 subfunction that can be implemented by userspace. Signed-off-by: David Hildenbrand Reviewed-by: Heiko Carstens Reviewed-by: Eric Farman --- Documentation/virt/kvm/s390/s390-diag.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/Documentation/virt/kvm/s390/s390-diag.rst b/Documentation/virt/kvm/s390/s390-diag.rst index 48a326d41cc0..3e4f9e3bef81 100644 --- a/Documentation/virt/kvm/s390/s390-diag.rst +++ b/Documentation/virt/kvm/s390/s390-diag.rst @@ -80,6 +80,23 @@ Subcode 3 - virtio-ccw notification See also the virtio standard for a discussion of this hypercall. +Subcode 4 - storage-limit + Handled by userspace. + + After completion of the DIAGNOSE call, general register 2 will + contain the storage limit: the maximum physical address that might be + used for storage throughout the lifetime of the VM. + + The storage limit does not indicate currently usable storage, it may + include holes, standby storage and areas reserved for other means, such + as memory hotplug or virtio-mem devices. Other interfaces for detecting + actually usable storage, such as SCLP, must be used in conjunction with + this subfunction. + + Note that the storage limit can be larger, but never smaller than the + maximum storage address indicated by SCLP via the "maximum storage + increment" and the "increment size". + DIAGNOSE function code 'X'501 - KVM breakpoint ----------------------------------------------