From nobody Fri Jan 3 00:13:04 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) client-ip=8.43.85.245; envelope-from=devel-bounces@lists.libvirt.org; helo=lists.libvirt.org; Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=fail(p=none dis=none) header.from=redhat.com Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 1728647758332309.3812974363768; Fri, 11 Oct 2024 04:55:58 -0700 (PDT) Received: by lists.libvirt.org (Postfix, from userid 996) id 40B1012B5; Fri, 11 Oct 2024 07:55:57 -0400 (EDT) Received: from lists.libvirt.org (localhost [IPv6:::1]) by lists.libvirt.org (Postfix) with ESMTP id F3BD712C1; Fri, 11 Oct 2024 07:55:40 -0400 (EDT) Received: by lists.libvirt.org (Postfix, from userid 996) id 32878124E; Fri, 11 Oct 2024 07:55:38 -0400 (EDT) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id AF5A7124E for ; Fri, 11 Oct 2024 07:55:37 -0400 (EDT) Received: from mail-wm1-f70.google.com (mail-wm1-f70.google.com [209.85.128.70]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-404--a5BskzUP9qIYWhdboBBFg-1; Fri, 11 Oct 2024 07:55:36 -0400 Received: by mail-wm1-f70.google.com with SMTP id 5b1f17b1804b1-43057565db5so10920275e9.1 for ; Fri, 11 Oct 2024 04:55:35 -0700 (PDT) Received: from wheatley.localdomain (nat-pool-brq-t.redhat.com. [213.175.37.10]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-37d4b6a8671sm3791285f8f.18.2024.10.11.04.55.34 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 11 Oct 2024 04:55:34 -0700 (PDT) Received: from wheatley.pinto-pinecone.ts.net (wheatley.k8r.cz [127.0.0.1]) by wheatley.localdomain (Postfix) with ESMTP id C90EA30B06C4 for ; Fri, 11 Oct 2024 13:55:33 +0200 (CEST) X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-0.5 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL,RCVD_IN_VALIDITY_RPBL_BLOCKED, RCVD_IN_VALIDITY_SAFE_BLOCKED,SPF_HELO_NONE autolearn=unavailable autolearn_force=no version=3.4.4 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1728647737; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=MQz6zxM7bVP8OFuobBXmccKjqLiCiEeu+bcQd1hyCTc=; b=Go2JwjyMFPVKHt8wEkn+/NX49BGckn2LZ6hEN5zrpMHO7fSPObrmCvYk/lMw9mJqlGJuqA aG1nP0yLj+45Oc2M5w0MccdhjiDOAWjQSeAyCd4uQwyHcXJ/1/s/EDm/7K8fLwiUz593fy qX8+FUoNkitQdasE9S/4tUf4wOtnK6c= X-MC-Unique: -a5BskzUP9qIYWhdboBBFg-1 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1728647735; x=1729252535; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=MQz6zxM7bVP8OFuobBXmccKjqLiCiEeu+bcQd1hyCTc=; b=tQRSFBKvfr/yTIE9ohEAC3LoEAXHT0P3KFUPir3qC+f5KtU+ZpAxAKQRA3S8IPPfR5 Fdle8Od2pwX6xUpLZIB37tuHlXc8m8Ryjdod6Hr7b+JKSoiK5/W1t4SA2vPu5+HSf1z8 HqR7p9xHzjNGMR3PDOmRmMeLtnxTATkUshn2JMqku5Z0dmUbg4CXVgygRHB5HiAuvcwI 3zFO35R0WdZV17+PYDP61ZvhFeJ8o2tWyeV4aTxtfHVYmOuV72uFSGN8jF7k8i3JW79K 3ifHWGJ7i/1rzfJJTSnrjMxv0qJ17F8S4jhcUnKBpDJJc6f5YRKS2S8pEBITaxmg31EA Xm2g== X-Gm-Message-State: AOJu0Yw6TT3WyxIvtOE5TGLuJ0s2rOPVUbLHAkopF2KnhwtYe05ahI6h qIs6YwkdaHQEOXyyHuYxePo4iUNPhTpMUhRZh+KXxyv0YH6mvV/uy003+ptRjRknLWhF7+Uz9HN uOMZEfUJKWMl0IQXEwxrfisBx/CkEnOu1cK9pxfNuCaewfIZ5BiAeJAFBd9pgSqV2t7t15QxvVV sKphPOyIZS99uzVIpZZTqm8++XwExW2lm9/hsqpgI= X-Received: by 2002:a05:600c:3106:b0:431:136b:8bef with SMTP id 5b1f17b1804b1-43115aa52a6mr59021775e9.7.1728647734936; Fri, 11 Oct 2024 04:55:34 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHMLIF5Ka1bNTbDoDwfKHw8AON9v+fIzjpuvEotCvzxweDYSjo6oCTLkbH9bRGnQpwNXRSZkA== X-Received: by 2002:a05:600c:3106:b0:431:136b:8bef with SMTP id 5b1f17b1804b1-43115aa52a6mr59021525e9.7.1728647734510; Fri, 11 Oct 2024 04:55:34 -0700 (PDT) From: Martin Kletzander To: devel@lists.libvirt.org Subject: [PATCH] docs: Document watchdog action=dump slightly more Date: Fri, 11 Oct 2024 13:55:26 +0200 Message-ID: <6bdf47f2f2a58aa4fddfeaede453bfaacfd0119e.1728647726.git.mkletzan@redhat.com> X-Mailer: git-send-email 2.46.2 MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable Message-ID-Hash: X5XWYGNHWKJJV5I7J5DOFP4LVUIH62HH X-Message-ID-Hash: X5XWYGNHWKJJV5I7J5DOFP4LVUIH62HH X-MailFrom: mkletzan@redhat.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-config-1; header-match-config-2; header-match-config-3; header-match-devel.lists.libvirt.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; suspicious-header X-Mailman-Version: 3.2.2 Precedence: list List-Id: Development discussions about the libvirt library & tools Archived-At: List-Archive: List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1728647761023116600 Content-Type: text/plain; charset="utf-8"; x-default="true" With watchdog action=3Ddump the actual watchdog action is set to pause and the daemon then proceeds to dump the process. After that the domain is resumed. That was the case since the feature was added. However the resuming of the domain might be unexpected, especially when compared to HW watchdog, which will never run the guest from the point where it got interrupted. Document the pre-existing behaviour, since any change might be unexpected as well. Change of behaviour would require new options like dump+reset, dump+pause, etc. That option is still possible, but orthogonal to this change. Resolves: https://issues.redhat.com/browse/RHEL-753 Signed-off-by: Martin Kletzander Acked-by: Richard W.M. Jones Reviewed-by: Jiri Denemark --- docs/formatdomain.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 4336cff3ac05..e6f09a728f0f 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -7914,7 +7914,8 @@ southbridge, which is used with the q35 machine type.= :since:`Since 9.1.0` - 'poweroff' - forcefully power off the guest - 'pause' - pause the guest - 'none' - do nothing - - 'dump' - automatically dump the guest :since:`Since 0.8.7` + - 'dump' - automatically dump the guest, beware that after the + dump the guest will be resumed :since:`Since 0.8.7` - 'inject-nmi' - inject a non-maskable interrupt into the guest :since:`Since 1.2.17` =20 --=20 2.46.2