From patchwork Mon Oct 14 14:46:15 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: David Hildenbrand X-Patchwork-Id: 13835142 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 C6D44D1627E for ; Mon, 14 Oct 2024 14:47:02 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 51E076B0093; Mon, 14 Oct 2024 10:47:02 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 4A5F46B0095; Mon, 14 Oct 2024 10:47:02 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 31FB86B0096; Mon, 14 Oct 2024 10:47:02 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id 109D26B0093 for ; Mon, 14 Oct 2024 10:47:02 -0400 (EDT) Received: from smtpin16.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay09.hostedemail.com (Postfix) with ESMTP id 11D2E81076 for ; Mon, 14 Oct 2024 14:46:55 +0000 (UTC) X-FDA: 82672484916.16.77470AD Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by imf28.hostedemail.com (Postfix) with ESMTP id 06C0AC0009 for ; Mon, 14 Oct 2024 14:46:53 +0000 (UTC) Authentication-Results: imf28.hostedemail.com; dkim=pass header.d=redhat.com header.s=mimecast20190719 header.b=P3OkWOmk; spf=pass (imf28.hostedemail.com: domain of david@redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=david@redhat.com; dmarc=pass (policy=none) header.from=redhat.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1728917077; 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=4Os76zwoG6jFijiPcIPH9iCyJSDWZb0dHletZ1AI4lw=; b=bL3KnKsZ4uc2ysTjcWBLERCyYqVYuz9EWMA5iI7korn8qfOXXz/jhhmCy+wc5dU8Lo04Yl 7jsJm1WLiY2wBW5USrxDj1dpppuikyyon4auS3not22xKnPXCaa/vpTquRFivjNQRNwAc5 r5SuVZzCcaTaj8I5kiyQXz52n/gwrLI= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1728917077; a=rsa-sha256; cv=none; b=7pNh2INIubyHBpGXBnc4HkoF1A7pMZ+RjQUtCn+824otbUBmrnxd0NkIY/9nLJeJgeUyFD h2TPQPiSYtj+K1+oll7mpqE/rhDD0W7opHCZpwM+gpOWqO609ELDrKUU38wi/9DmsULtm7 spUJhiGkerSJnXHXa+0Y1CDrtMqD6Js= ARC-Authentication-Results: i=1; imf28.hostedemail.com; dkim=pass header.d=redhat.com header.s=mimecast20190719 header.b=P3OkWOmk; spf=pass (imf28.hostedemail.com: domain of david@redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=david@redhat.com; dmarc=pass (policy=none) header.from=redhat.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1728917219; 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=4Os76zwoG6jFijiPcIPH9iCyJSDWZb0dHletZ1AI4lw=; b=P3OkWOmk+8hYvGlubXH4aK0BEF0tu2EXYLSAfRktVfpeBsUlGipXSV7jUkw9GmzsVUJnui 4i6R1+oeM4EL4R9Pm4BsIi/ya8jnSuDZyAXs2J9ovaBwXL60geb8tI4HM67U+xsNsgZ80J bhYRuK2eSOeZO7hmmwfkduXAC4QtVPA= Received: from mx-prod-mc-04.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-677-xXFMHelCOC6T9rvvopYX6w-1; Mon, 14 Oct 2024 10:46:56 -0400 X-MC-Unique: xXFMHelCOC6T9rvvopYX6w-1 Received: from mx-prod-int-05.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-05.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.17]) (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-04.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 3DEEF19560BC; Mon, 14 Oct 2024 14:46:54 +0000 (UTC) Received: from t14s.cit.tum.de (unknown [10.22.32.146]) by mx-prod-int-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id A52E41955E8F; Mon, 14 Oct 2024 14:46:47 +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?= , Andrew Morton , Jonathan Corbet Subject: [PATCH v2 3/7] Documentation: s390-diag.rst: document diag500(STORAGE LIMIT) subfunction Date: Mon, 14 Oct 2024 16:46:15 +0200 Message-ID: <20241014144622.876731-4-david@redhat.com> In-Reply-To: <20241014144622.876731-1-david@redhat.com> References: <20241014144622.876731-1-david@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.0 on 10.30.177.17 X-Stat-Signature: nzydy4j813gburgp5d9xpb9gcgqdpnuk X-Rspamd-Queue-Id: 06C0AC0009 X-Rspam-User: X-Rspamd-Server: rspam08 X-HE-Tag: 1728917213-449570 X-HE-Meta: U2FsdGVkX19JwyrYbbQshvEtkJp18/KQCePjNRupks1nHK5gJRcSTeiEn/6IqXknHDdppPt4cqUZLDPgp4tyCKfJeFAPYlc3/rTqTsAhT8s/cC+8Zo3eP2zeBOICH0xZFWGjKuMIMocdmDWOMB2iEELYzSp8VFUygNbxIgEEqDWW1j9EIIeLyJFGZjd5YEPYdKM11H93LxdcutOkP0m63AQA2o0+0U0X4+J8I93LSWR8n1GJIkKN788/5xVuV/iaGxLwb1nOHZnd1EuFCnCygQxiNFmUP0wPiSl/AMeCqgc7yEUNFJZGoYcdB1I9UPJv5gUtMLUzpIKq3dBs1CyqQsTdLh86toEfgFIwLPjhcCPko2G+xwBk6eJZ+iXr9MHerMo2jF26oFwsnbCGr4z0oRpNy3JMe641kXJdw05eYh420prcJRrpgia4qd+g1t4/k0+lUPBBB3KXAagQg29lSMbmygI+ivMv9MH/30LmcXccU/pp2sESS+JgBLILiEYMlrUaZk/mGI4pu5Zvjmiu6E6oGeguDlPlSyqVaJvxStbMvbORCAnOMOz1bc9u4l9CD15OJeGUukbcUCyr5IO39iQEtfeuaYu4NG4KvnD/eo8x7UbQDA/SY4X0KolBjbi++F+8mguJSXoeXimjkxiDeCGEfxI86xdC1mLNNCRzKr2Q3G5anXfC/040fUTLNjmtVU5RgpeEFViFuhEk5gWHKArohfstWJPlBROpJU5ieAM+Be7KedzHcs/CfP94EIzYWPXx4B4IlnXX3W7Ej7UFJUxUbuRksknX2koQHAWOEGmbz0cd+LZs9/2c/u2FD1sTGwJlEvc0vyKKi7hSK0u5/e7Y+9VXj7tNXLtL67MpefaZ+QqvyHUVia2w7Oq7bR3eztSIc18xj92FwVfTtV/istR753Ppiwa8mu8k1F9PvfxH5J8gUkFEZqK5kGTZdjjojczFDZEggktMKR2kZip vI7Fv6il spIAYTyFSxiP+OvQ9Zij1AH4qf9xEmEcSlVrtRk9bpS8siG/5sHmDgetqak5sTGNG8vaeBIPZCeIKpXm7QZMmeVkR5d79u7w28r3oiuY4qb0l2cBa39gQ9xB9ukdGiH+emjx6cMoiloODi+n+zw1J0em0f9Xrx3UtJn33MmX6tWvfBqiJj8bq9e0VgntWoLPYPBwAxWIeBCr7TZU0wBUgBxp4G5ROcMejk5ibbV/O5Ivdm2nGcUQTmyjvFvxvIFNhmllWoWeeTkl5UvoCUm/nHFDPoZNYSj3DM+P53uAgsReMuI4+5zDofBJx1X496WtHCJindg5YotMmq3I= 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 --- 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 d9b7c6cbc99e..c69c6e0fa71b 100644 --- a/Documentation/virt/kvm/s390/s390-diag.rst +++ b/Documentation/virt/kvm/s390/s390-diag.rst @@ -77,6 +77,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 ----------------------------------------------