From nobody Fri May 17 11:58:50 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org ARC-Seal: i=1; a=rsa-sha256; t=1709911220; cv=none; d=zohomail.com; s=zohoarc; b=VIuU0bga7aYwMtONOUQKYAYueoVRjK41yaIG6IDi4LiVcdfjrBiSe7+uM1b/x+0aRXTn1WC6hWOS9BNbzRHfoLoyQwgQOsdmi5QeLyqI2Pl6pgwDTBEo14SwpLx0mJnKKGJhScrCuGjzgkGJlIr6b+fGO8nmS44GMA9j4Q9zYeQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1709911220; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=0Thr5ENyvPLoF4bqDxKM90EiB1TJ9YdmJBGx+I/Z+q8=; b=KdnPjmAAYpsPxdGYw0EwwJUY4sigHu/7nduh1udwHVx/7CjgG12G81G5+i/zWMyNFDk5IFD8GSVnjMMIVDCsf3Vm1d4oMUzM6MoGuAb4MlJr/jNkCVOaOc92Jp08KVSpluO+xApOOM7ftsJcqdEYzt33D+NhLZ7cLLD6HA6Od3g= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 1709911219961991.9573065804829; Fri, 8 Mar 2024 07:20:19 -0800 (PST) Received: from list by lists.xenproject.org with outflank-mailman.690335.1076239 (Exim 4.92) (envelope-from ) id 1ric0k-00087V-US; Fri, 08 Mar 2024 15:19:50 +0000 Received: by outflank-mailman (output) from mailman id 690335.1076239; Fri, 08 Mar 2024 15:19:50 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1ric0k-00087O-RX; Fri, 08 Mar 2024 15:19:50 +0000 Received: by outflank-mailman (input) for mailman id 690335; Fri, 08 Mar 2024 15:19:49 +0000 Received: from se1-gles-flk1-in.inumbo.com ([94.247.172.50] helo=se1-gles-flk1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1ric0i-000860-S4 for xen-devel@lists.xenproject.org; Fri, 08 Mar 2024 15:19:48 +0000 Received: from mail-wm1-x32b.google.com (mail-wm1-x32b.google.com [2a00:1450:4864:20::32b]) by se1-gles-flk1.inumbo.com (Halon) with ESMTPS id 4bca6f16-dd5f-11ee-a1ee-f123f15fe8a2; Fri, 08 Mar 2024 16:19:46 +0100 (CET) Received: by mail-wm1-x32b.google.com with SMTP id 5b1f17b1804b1-41316512055so7978985e9.2 for ; Fri, 08 Mar 2024 07:19:46 -0800 (PST) Received: from localhost.localdomain (82-64-138-184.subs.proxad.net. [82.64.138.184]) by smtp.googlemail.com with ESMTPSA id d8-20020a05600c4c0800b004130889c7b3sm5993105wmp.34.2024.03.08.07.19.44 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 08 Mar 2024 07:19:44 -0800 (PST) X-Outflank-Mailman: Message body and most headers restored to incoming version X-BeenThere: xen-devel@lists.xenproject.org List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Precedence: list Sender: "Xen-devel" X-Inumbo-ID: 4bca6f16-dd5f-11ee-a1ee-f123f15fe8a2 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rabbit-lu.20230601.gappssmtp.com; s=20230601; t=1709911185; x=1710515985; darn=lists.xenproject.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=0Thr5ENyvPLoF4bqDxKM90EiB1TJ9YdmJBGx+I/Z+q8=; b=DO4hSaa6tIxmFn3NXc4O3l0KFQPob5PyFPN6dQikXP9OIR3Gu46sc2VvpcespgsEG2 pm3tSB1uO8mBubyP0N1SHaUV/uz+N0JtA+fooVSqlvM56RYtPQUbOyPYah5JuiKFqlCk 4m6mVn/x7WmQJKg/FpKa5v+KlghoNGMUA4V07lWxyOhUVdIpRvB10wbu3ddYDhFNwzir WTOLazUx3XXkTNhkqmvpExn4+7v5+4BZYtyPABMVhovTnb1OPVjEVmF/RFfsnzZYnK5C 8Su6loz6Or1vCvMkKULhW8S3A8m7O8mautd8VS+luhVPRooGCyDh/MWInYmRLwDd4cwo 06hA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1709911185; x=1710515985; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=0Thr5ENyvPLoF4bqDxKM90EiB1TJ9YdmJBGx+I/Z+q8=; b=rvZgLW9YWz3amAfv+/gIWDNrYOECrlWMkk65VTBsJ02SHhHE+8SeTtmFToy+TNip1A 9f8l3oxV6966JNPCvoNLDgCJH28ptr6jQV9IFNssAXFHMvc/Cb4f2CenxoFHNrXlRQg5 NDqYxbsx3ZVhDz+Qd7I2e8weCHEG3kBIpDw4vEaFA8uhpvE6WO6ihPZmqllFQydlw1oX qnM51Z4KVk0oL3tiF8e30OAwj/dOMoLeoG0HG9XUGAnK0xNoZArmjB3zdl9gj3G3Wlr0 qEPo+aiNCihvH2/yqfEj7hluA5NzHR3IRWbE+ljAy3KIeVlx1a9ehkzTh9koByGjlkgP zztA== X-Gm-Message-State: AOJu0Yx1M9jpOeQ+K86DePlsE/n0iH6VgB7wgXpp5v7E0WoTUehkt5iv Kgvwmg24+OXjlD0UQBpfT0MX+ByOUEmbWUGefmT+jtgLHWaswNCZw/W+4w5akCJO0IRxSrNOxhJ I X-Google-Smtp-Source: AGHT+IHiaAJqPMGi9k6Smk9LMBKkuT2WruGkYhVCrqw6IuwF0IcCTr53NN+mer6aP7WmLNw7uYa5Iw== X-Received: by 2002:a05:600c:3515:b0:412:eff3:8497 with SMTP id h21-20020a05600c351500b00412eff38497mr7544830wmq.1.1709911185282; Fri, 08 Mar 2024 07:19:45 -0800 (PST) From: =?UTF-8?q?zithro=20/=20Cyril=20R=C3=A9bert?= To: xen-devel@lists.xenproject.org Cc: =?UTF-8?q?zithro=20/=20Cyril=20R=C3=A9bert?= , =?UTF-8?q?Roger=20Pau=20Monn=C3=A9?= , Wei Liu , Anthony PERARD Subject: [PATCH v2] docs/man: add shutdown reasons to xl (list) man page Date: Fri, 8 Mar 2024 16:19:20 +0100 Message-Id: <0a2fcad111622431b8cd54c69adc3dedd24fb572.1709910923.git.slack@rabbit.lu> X-Mailer: git-send-email 2.39.2 MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @rabbit-lu.20230601.gappssmtp.com) X-ZM-MESSAGEID: 1709911222316100001 Add the shutdown reasons to the paragraph of "xl list" concerning the shutdown status. I have adapted the explanations from the source code : - tools/xl/xl_info.c : function "list_domains()", variable "shutdown_reason_letters" - xen/include/public/sched.h : variable "shed_shutdown_reason" Suggested-by: Roger Pau Monn=C3=A9 Signed-off-by: Cyril R=C3=A9bert / zithro --- v2: - apply changes from Anthony and Roger Questions (unblocking): - why a double space between all sentences ? - how to get a "simple LF" ? Ie. I want to use
, not

(a simple has no effect, a double renders a

) --- docs/man/xl.1.pod.in | 40 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/docs/man/xl.1.pod.in b/docs/man/xl.1.pod.in index bed8393473..d37227ba58 100644 --- a/docs/man/xl.1.pod.in +++ b/docs/man/xl.1.pod.in @@ -370,12 +370,50 @@ scheduling by the Xen hypervisor. The guest OS has shut down (SCHEDOP_shutdown has been called) but the domain is not dying yet. =20 -=3Ditem B +There are six shutdown reasons, which will be displayed after the "s" : B<= -rscwS>. + +Note that some states will only be displayed if "on_poweroff=3Dpreserve" i= s set in +the config file, see L). + +=3Dover 4 + +=3Dover 4 + +=3Ditem B + +The domain exited normally, it will get destroyed. + +=3Ditem B + +The domain will reboot. + +=3Ditem B + +The domain is suspended to disk or to RAM. If suspended to disk, the domai= n will +get destroyed. + +=3Ditem B =20 The domain has crashed, which is always a violent ending. Usually this state only occurs if the domain has been configured not to restart on a crash. See L for more info. =20 +=3Ditem B + +Restart because watchdog time expired. + +=3Ditem B + +The domain asked to perform 'soft reset' for it. The expected behavior +is to reset internal Xen state for the domain returning it to the point +where it was created but leaving the domain's memory contents and vCPU +contexts intact. This will allow the domain to start over and set up +all Xen specific interfaces again. + +=3Dback + +=3Dback + =3Ditem B =20 The domain is in the process of dying, but hasn't completely shut down or --=20 2.39.2