From nobody Fri May 17 11:28:41 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=1709678765; cv=none; d=zohomail.com; s=zohoarc; b=IE3ZUiQs6lu4NAOBc4zRcfuLiq3kRxewAV+UyE2Fvf9eTDudXR9Ghjj40wAz3KSZAwnQYbunDOt0ASrWyelf9KM0teWeXJbgyY4ir2gfJrr2d/fzTZ+0Nuk/ImU36HQzkJpF1CLJ5bbYrNmwVsAKbIfSNjCK8jb0/Gfh1m277qU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1709678765; 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=ZQZyzUwJSWsCwe+Cq0i2MFZNLiLssuBmZ6olbZklGwQ=; b=LCMTPo7uc1cTEpEu6Um/zrTuSFMYvBF1ZJIITkYczMjNJg4d3yDwjVTW8nagnP9bkZRWrl2CZ4ABwvVmbB1GKWWhjRVr4e1VeZYLWDVivKWUi3vh1QasI537+nWt2/t77WSDKCYWSvf3+ECZJDF2/BpH2Aw1DiE1MFm1hCOU+Pg= 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 1709678764991914.7689773101168; Tue, 5 Mar 2024 14:46:04 -0800 (PST) Received: from list by lists.xenproject.org with outflank-mailman.688905.1073658 (Exim 4.92) (envelope-from ) id 1rhdXO-0002SP-Bl; Tue, 05 Mar 2024 22:45:30 +0000 Received: by outflank-mailman (output) from mailman id 688905.1073658; Tue, 05 Mar 2024 22:45:30 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1rhdXO-0002SI-8u; Tue, 05 Mar 2024 22:45:30 +0000 Received: by outflank-mailman (input) for mailman id 688905; Tue, 05 Mar 2024 22:45:29 +0000 Received: from se1-gles-sth1-in.inumbo.com ([159.253.27.254] helo=se1-gles-sth1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1rhdXN-0002SB-1Z for xen-devel@lists.xenproject.org; Tue, 05 Mar 2024 22:45:29 +0000 Received: from mail-wm1-x32f.google.com (mail-wm1-x32f.google.com [2a00:1450:4864:20::32f]) by se1-gles-sth1.inumbo.com (Halon) with ESMTPS id 0fc911bd-db42-11ee-afda-a90da7624cb6; Tue, 05 Mar 2024 23:45:27 +0100 (CET) Received: by mail-wm1-x32f.google.com with SMTP id 5b1f17b1804b1-412eddd14b9so8343265e9.2 for ; Tue, 05 Mar 2024 14:45:27 -0800 (PST) Received: from localhost.localdomain (82-64-138-184.subs.proxad.net. [82.64.138.184]) by smtp.googlemail.com with ESMTPSA id iv16-20020a05600c549000b00412ea93220asm3929518wmb.12.2024.03.05.14.45.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 05 Mar 2024 14:45:26 -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: 0fc911bd-db42-11ee-afda-a90da7624cb6 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rabbit-lu.20230601.gappssmtp.com; s=20230601; t=1709678727; x=1710283527; 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=ZQZyzUwJSWsCwe+Cq0i2MFZNLiLssuBmZ6olbZklGwQ=; b=fl/pffVl4SQOatIDuuK5uf95/S9Co4JHwZAifyi/r5aLj+YAzyGHnx3nZd2z3/q/Q/ MxyGGyQj9+frps6MfJcYbWP2nkt5Jcja4ev+cmwGxIBwoIWWS1LbORJylCgq/TeyHjWS fYu9ZykqqcMf6HQ4lu8k0cnKDui/l1dCzuYkDu5bY1lrzL2Jn2hW3TgO22e+2WfqIEBd Ckzuy0sD274cc9fvo5X1lNpspbAFf1ayhKLaejcKE3wSf/uoxdJicZXvgwOnqIVLN0+G K6RHxQWu/+YweEXZu0QTjO/R5+pA3bUPtajeDShPaF44iC7JU9cr9GRJjVX7MMrAfvR+ /osA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1709678727; x=1710283527; 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=ZQZyzUwJSWsCwe+Cq0i2MFZNLiLssuBmZ6olbZklGwQ=; b=FypHsEHi4CxMaP1JDRwbg7dxzrQQ1yHXS6LFY1irZuhoYhwHDoyFyAf+NHtY3xUeOI ClIVp+MW7ComKpVvXly4EP6o8+qCyewQbT+cMZnWG0LY3pFmosWH6XdZ/5UfZBHKA9nt 4Cb9Svsgn4PztaoNY/qV3yhBfKJqtgjdbcpokG2sP+XPinVZld6XW2s8gyPq+jdtWIuZ tFeHNydKoTRfAYrfe6eoEIMTlkVHSC7PC/qIjSvMQ2OHmJp+Mv8tFfowNYgtediH0HRN 4bNEhbz097dQxlzaX5T+8rYKdR5J6gOyQwS10+JAt16RGMcKR05GVLTGkNv50OUuqQgY TVOg== X-Gm-Message-State: AOJu0Yw3TsUQ5wHykiUpIYWO9biHRyI5SMohOLCrJXAMXsCa5dl5jWaW MUy220FwRPUfxq970bTKge2jvutzHhao8snun0dT0Kb+Qf9WKO5Wp0dLyyz0qk9UrwgxltEWD+p l X-Google-Smtp-Source: AGHT+IHQlXRMpPhNrWjSdxyRlf4wFuacH8pdw6vr3ZWssC2YZhsc12EP5RouHp/YhU4/Mt6uO6dY8A== X-Received: by 2002:a05:600c:4ed2:b0:412:b674:28ff with SMTP id g18-20020a05600c4ed200b00412b67428ffmr9543857wmq.22.1709678726918; Tue, 05 Mar 2024 14:45:26 -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] docs/man: add shutdown reasons to xl (list) man page Date: Tue, 5 Mar 2024 23:45:13 +0100 Message-Id: <019602d6da2ff78e6582b9b6aae6d76216e150c3.1709678713.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: 1709678765989100001 Add the shutdown reasons to the paragraph of "xl list" concerning the shutdown status. I have copy/pasted the explanations from the source code : - tools/xl/xl_info.c (L379) - xen/include/public/sched.h (starting L158) Suggested-by: Roger Pau Monn=C3=A9 Signed-off-by: Cyril R=C3=A9bert / zithro --- docs/man/xl.1.pod.in | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/docs/man/xl.1.pod.in b/docs/man/xl.1.pod.in index bed8393473..2b046f97f1 100644 --- a/docs/man/xl.1.pod.in +++ b/docs/man/xl.1.pod.in @@ -370,6 +370,40 @@ scheduling by the Xen hypervisor. The guest OS has shut down (SCHEDOP_shutdown has been called) but the domain is not dying yet. =20 +There are six shutdown reasons, which will be displayed after the "s" : B<= -rscwS>. + +=3Dover 4 + +=3Dover 4 + +=3Ditem s- : poweroff + +Domain exited normally. Clean up and kill. + +=3Ditem sr : reboot + +Clean up, kill, and then restart. + +=3Ditem ss : suspend + +The domain is suspended. Clean up, save suspend info, kill. + +=3Ditem sc : crash + +Tell controller we've crashed. + +=3Ditem sw : watchdog + +Restart because watchdog time expired. + +=3Ditem sS : soft_reset + +Domain asked to perform 'soft reset' for it. The expected behavior is to r= eset internal Xen state for the domain returning it to the point where it w= as created but leaving the domain's memory contents and vCPU contexts intac= t. This will allow the domain to start over and set up all Xen specific int= erfaces again. + +=3Dback + +=3Dback + =3Ditem B =20 The domain has crashed, which is always a violent ending. Usually --=20 2.39.2