From nobody Mon Feb 9 06:00:34 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; 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=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1668676278; cv=none; d=zohomail.com; s=zohoarc; b=Gb6yqgiL78lIjkVFE1lFQQMTT2EoYOWp0FuSJBMHT2o3221B71Syoq5au18WpHi8ZT/cWIRsE8RauyM8wkn2al0EkKMO2mqG4HTz9RcJMGm+mTeCmK4z6H9ftvehS1mKKhlahIbAfH9aArvgbReOsm4OVm+pXkA8yYUBXZa3Nck= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1668676278; h=Content-Transfer-Encoding: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=1vASfgmJy6tlSODj6TlYRO8X2w/hgsd933UsScQK70g=; b=ldTfiDNVJHamTL5abak2Y0QyNRRDhsXHjUydXA+N+5FP8pI695Pn/SNfm01DvLjBXUzHNwpZvP3d3A/2z2H/vKErlruXAmF7lAleENCUEYM/T9XaqtEw4SEPdxz0+WNgC1M6EQWzvcbMbIdpOzMljrEudP+aRVFBrjgOAw1S+yY= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; 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=pass header.from= (p=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 166867627853522.534905364486463; Thu, 17 Nov 2022 01:11:18 -0800 (PST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ovaub-0007YX-2n; Thu, 17 Nov 2022 04:10:21 -0500 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 1ovauZ-0007Xy-2J for qemu-devel@nongnu.org; Thu, 17 Nov 2022 04:10:19 -0500 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ovauX-0001rL-D7 for qemu-devel@nongnu.org; Thu, 17 Nov 2022 04:10:18 -0500 Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-616-TdcYwA5iPJSSzYNy0T5zvA-1; Thu, 17 Nov 2022 04:10:14 -0500 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.rdu2.redhat.com [10.11.54.4]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 570E43802B82 for ; Thu, 17 Nov 2022 09:10:14 +0000 (UTC) Received: from thuth.com (unknown [10.39.192.254]) by smtp.corp.redhat.com (Postfix) with ESMTP id 9AB952027064; Thu, 17 Nov 2022 09:10:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1668676216; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=1vASfgmJy6tlSODj6TlYRO8X2w/hgsd933UsScQK70g=; b=f9du15chCVqZW/efRej5IQOnUfqdpG7xjlD6kF8hUjt3O9RI00kOLQte2xLPeyP5GKP2rr ojoepcbWArE1yX+KveiUtTrJt+L1aWiC/aswFd6pGPD+pT1Uf1DAWlx2frFMaQK1JDgxBj H2/b4FFzAZSC58Vq1a2aMqxAaAY6/3E= X-MC-Unique: TdcYwA5iPJSSzYNy0T5zvA-1 From: Thomas Huth To: Stefan Hajnoczi , qemu-devel@nongnu.org Subject: [PULL 2/4] docs/system/s390x: Document the "loadparm" machine property Date: Thu, 17 Nov 2022 10:10:04 +0100 Message-Id: <20221117091006.525072-3-thuth@redhat.com> In-Reply-To: <20221117091006.525072-1-thuth@redhat.com> References: <20221117091006.525072-1-thuth@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.1 on 10.11.54.4 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=170.10.133.124; envelope-from=thuth@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=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+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1668676279429100003 Content-Type: text/plain; charset="utf-8" The "loadparm" machine property is useful for selecting alternative kernels on the disk of the guest, but so far we do not tell the users yet how to use it. Add some documentation to fill this gap. Buglink: https://bugzilla.redhat.com/show_bug.cgi?id=3D2128235 Message-Id: <20221114132502.110213-1-thuth@redhat.com> Reviewed-by: Claudio Imbrenda Signed-off-by: Thomas Huth --- docs/system/s390x/bootdevices.rst | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/system/s390x/bootdevices.rst b/docs/system/s390x/bootdevi= ces.rst index b5950133e8..1a7a18b43b 100644 --- a/docs/system/s390x/bootdevices.rst +++ b/docs/system/s390x/bootdevices.rst @@ -53,6 +53,32 @@ recommended to specify a CD-ROM device via ``-device scs= i-cd`` (as mentioned above) instead. =20 =20 +Selecting kernels with the ``loadparm`` property +------------------------------------------------ + +The ``s390-ccw-virtio`` machine supports the so-called ``loadparm`` parame= ter +which can be used to select the kernel on the disk of the guest that the +s390-ccw bios should boot. When starting QEMU, it can be specified like th= is:: + + qemu-system-s390x -machine s390-ccw-virtio,loadparm=3D + +The first way to use this parameter is to use the word ``PROMPT`` as the +```` here. In that case the s390-ccw bios will show a list of +installed kernels on the disk of the guest and ask the user to enter a num= ber +to chose which kernel should be booted -- similar to what can be achieved = by +specifying the ``-boot menu=3Don`` option when starting QEMU. Note that th= e menu +list will only show the names of the installed kernels when using a DASD-l= ike +disk image with 4k byte sectors. On normal SCSI-style disks with 512-byte +sectors, there is not enough space for the zipl loader on the disk to store +the kernel names, so you only get a list without names here. + +The second way to use this parameter is to use a number in the range from 0 +to 31. The numbers that can be used here correspond to the numbers that are +shown when using the ``PROMPT`` option, and the s390-ccw bios will then try +to automatically boot the kernel that is associated with the given number. +Note that ``0`` can be used to boot the default entry. + + Booting from a network device ----------------------------- =20 --=20 2.31.1