From nobody Thu Apr 18 13:12:47 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1684414798; cv=none; d=zohomail.com; s=zohoarc; b=AmWr4/AxTjTosazC4geSUNy8Kzr+XzHMn1ZRqgvZ/J289WNLZYn0aycUj6smo4B+t05rPKXWxluOtWl05D7z+O0hKUVP+UL6TnM2/VZ+RlaW2gjKDylBumSK1Cqc+CC2mNGLfQVsb0Nsm/ENS4YV7LDzx22Lyoy1mTMcnBey73Q= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1684414798; h=Content-Type: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=2YcEBfukIAeJZ61fLc/2ztRSKaX2zxDyIDM81rYBBtk=; b=YzfsRpJkTziHWA07uHvtBWyot8Ck++90aiHP1OX2AoR1c23hTtt4glDvHchum50mVwe+h2qGtMHW+CWlncCrVQkVCFzOzgGQp/UNIFuY1RfqIYPjNJ5IK/VkQucJvK2Coj3BDOBfeYar4k14OSFAwF+MHEOO/UjDiIt3mqFGf5c= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.zohomail.com with SMTPS id 1684414798494237.01170798518854; Thu, 18 May 2023 05:59:58 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-321-3geyt1u_PPOzrY2RSwgVyg-1; Thu, 18 May 2023 08:59:54 -0400 Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 0B06985A5B1; Thu, 18 May 2023 12:59:52 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (unknown [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 499CF492B01; Thu, 18 May 2023 12:59:49 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id CD4C219465A8; Thu, 18 May 2023 12:59:43 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id F2A6219465A4 for ; Thu, 18 May 2023 12:59:42 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id CF8CAC164F0; Thu, 18 May 2023 12:59:42 +0000 (UTC) Received: from lacos-laptop-9.usersys.redhat.com (unknown [10.39.192.151]) by smtp.corp.redhat.com (Postfix) with ESMTP id 01C8CC15BA0; Thu, 18 May 2023 12:59:41 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1684414797; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=2YcEBfukIAeJZ61fLc/2ztRSKaX2zxDyIDM81rYBBtk=; b=HFmFRcmJLzL6bXXZLHjP2d7ekmfniPMbujnw8/JveHge9NoGFWzo+AKmsvDli38NASEqZV uj2dDL8l09jLxpr+jcyQT7dQEZaWviQBf/04/SctgZLJuqchJ6kMbHikqzh0DVqKb/Tswn 2MzInACw8YM5yiehjrsv5RcWmRh66tU= X-MC-Unique: 3geyt1u_PPOzrY2RSwgVyg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Laszlo Ersek To: libvir-list@redhat.com, lersek@redhat.com Subject: [PATCH 1/2] docs: fix typo in isa-debugcon example Date: Thu, 18 May 2023 14:59:38 +0200 Message-Id: <20230518125939.268617-2-lersek@redhat.com> In-Reply-To: <20230518125939.268617-1-lersek@redhat.com> References: <20230518125939.268617-1-lersek@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.8 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Andrea Bolognani Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.9 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1684414799697100001 Content-Type: text/plain; charset="utf-8" The opening tag is paired with the closing tag; that's a mismatch. The question is then whether to modify the former to , or the latter to . Per section "Relationship between serial ports and consoles", is used for emulated (not paravirt) consoles, and it's the type that's suitable for early debug output (such as from firmware). Thus, change to . Cc: "Daniel P. Berrang=C3=A9" Cc: Andrea Bolognani Fixes: 654968381df0256c047d2ecd4542ccc90dc57ad0 Signed-off-by: Laszlo Ersek Reviewed-by: Andrea Bolognani Reviewed-by: J=C3=A1n Tomko --- docs/formatdomain.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 1f52f58d37e1..6b8b60804e62 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -6634,7 +6634,7 @@ Serial port
- + =20 ... From nobody Thu Apr 18 13:12:47 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1684414814; cv=none; d=zohomail.com; s=zohoarc; b=nqwBfqrb7evQw6kkVMBZDpzFD5O1mx5jsXzaSsxLuZHKxxMtB0o0kyzQxxsUblV3bQgXo/5vrNBua78poyoo88ZSORP3zvy5MlCZ1sW4r3joQZqVZPuqRBdnPeC1XZ2AZnDQnT5C1ylotxIWbflksSq5qYts8zIwlZ3pRvoRhkw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1684414814; h=Content-Type: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=5ngMwv3fnYJa8TJ9dXeiu+EjR7pBLhxkwX58S7+TTc8=; b=Pb/IWjxVF1bcUNlueLkULwjtRM4GxYIUezIMbJLImTium8AyhagRav9QRzbgzULF90u0lnHVp9/3fPNBwZkQR0/swIgnoUn1GBeqUhs+tq3gOimihRR+zyvpR5g7x7iVKYPGH7qAUBTq7aDt0m1B+Rn0/Bbwi0yzUXtGlED797g= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.zohomail.com with SMTPS id 1684414814110567.3246006359218; Thu, 18 May 2023 06:00:14 -0700 (PDT) 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-595-ng2snnOaP9OMKZF8LC-IaA-1; Thu, 18 May 2023 09:00:09 -0400 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.rdu2.redhat.com [10.11.54.6]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id EC42A3C0F384; Thu, 18 May 2023 13:00:05 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (unknown [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id D37582166B31; Thu, 18 May 2023 13:00:05 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id EF46C19452C7; Thu, 18 May 2023 12:59:47 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 8952A19466DF for ; Thu, 18 May 2023 12:59:44 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 4AC4BC164F1; Thu, 18 May 2023 12:59:44 +0000 (UTC) Received: from lacos-laptop-9.usersys.redhat.com (unknown [10.39.192.151]) by smtp.corp.redhat.com (Postfix) with ESMTP id 1E6BCC15BA0; Thu, 18 May 2023 12:59:42 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1684414812; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=5ngMwv3fnYJa8TJ9dXeiu+EjR7pBLhxkwX58S7+TTc8=; b=ZElD0++F8JAxL+zxO7fVMdMicNGYSmHG8UAEm8sMqU0YNhVy5xNg3LlV4cFjpevaRBCz6G /6B7FhQ+OzQ+fEGfUczu4kdexb0NtULRV9ONVH4wpa5XA35ZUZ+pl22mReOITPRTmumTMO 2TU5SsGwLLRArWAusADgcv6bc2QZGOk= X-MC-Unique: ng2snnOaP9OMKZF8LC-IaA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Laszlo Ersek To: libvir-list@redhat.com, lersek@redhat.com Subject: [PATCH 2/2] docs: make isa-debugcon example more useful / directly applicable Date: Thu, 18 May 2023 14:59:39 +0200 Message-Id: <20230518125939.268617-3-lersek@redhat.com> In-Reply-To: <20230518125939.268617-1-lersek@redhat.com> References: <20230518125939.268617-1-lersek@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.8 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Andrea Bolognani Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.6 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1684414815314100001 Content-Type: text/plain; charset="utf-8" The type=3D'pty' attribute in the element causes a Pseudo TTY to be allocated on the host side via "/dev/ptmx", which is meant to be interacted with via "virsh console" or similar. That's not how a firmware log is typically viewed or saved. Replace type=3D'pty' with type=3D'file', and also provide an example eleme= nt (with the pathname of the logfile), similarly to how the example just above provides a element too. Cc: "Daniel P. Berrang=C3=A9" Cc: Andrea Bolognani Updates: 654968381df0256c047d2ecd4542ccc90dc57ad0 Signed-off-by: Laszlo Ersek Reviewed-by: Andrea Bolognani Reviewed-by: J=C3=A1n Tomko --- Notes: context:-U6 docs/formatdomain.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 6b8b60804e62..b46eefb0f675 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -6628,15 +6628,16 @@ Serial port - +
+ =20 ... =20 ::