[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-Id: <be73fd8eea115d7aa9867a6c1e83b645469488c0.1468491815.git.yu.c.chen@intel.com>
Date: Thu, 14 Jul 2016 18:45:30 +0800
From: Chen Yu <yu.c.chen@...el.com>
To: linux-pm@...r.kernel.org
Cc: "Rafael J. Wysocki" <rjw@...ysocki.net>,
Pavel Machek <pavel@....cz>, Len Brown <lenb@...nel.org>,
linux-kernel@...r.kernel.org, Chen Yu <yu.c.chen@...el.com>
Subject: [PATCH 2/2][RFC v3] PM / Documentation: Add description for snapshot test mode
Introduce snapshot test mode for hibernation debugging, and
update the document accordingly.
Signed-off-by: Chen Yu <yu.c.chen@...el.com>
---
Documentation/power/basic-pm-debugging.txt | 15 ++++++++++++---
1 file changed, 12 insertions(+), 3 deletions(-)
diff --git a/Documentation/power/basic-pm-debugging.txt b/Documentation/power/basic-pm-debugging.txt
index b96098c..5cc5b21 100644
--- a/Documentation/power/basic-pm-debugging.txt
+++ b/Documentation/power/basic-pm-debugging.txt
@@ -41,7 +41,7 @@ a) Test modes of hibernation
To find out why hibernation fails on your system, you can use a special testing
facility available if the kernel is compiled with CONFIG_PM_DEBUG set. Then,
there is the file /sys/power/pm_test that can be used to make the hibernation
-core run in a test mode. There are 5 test modes available:
+core run in a test mode. There are 6 test modes available:
freezer
- test the freezing of processes
@@ -62,6 +62,11 @@ core
control methods(*), the disabling of nonboot CPUs and suspending of
platform/system devices
+snapshot
+- test the freezing of processes, suspending of devices, platform global
+ control methods(*), the disabling of nonboot CPUs, suspending of
+ platform/system devices and the restoring of snapshot image
+
(*) the platform global control methods are only available on ACPI systems
and are only tested if the hibernation mode is set to "platform"
@@ -95,7 +100,7 @@ one and the "core" level tests the hardware and drivers as deeply as possible
without creating a hibernation image. Obviously, if the "devices" test fails,
the "platform" test will fail as well and so on. Thus, as a rule of thumb, you
should try the test modes starting from "freezer", through "devices", "platform"
-and "processors" up to "core" (repeat the test on each level a couple of times
+, "processors" and "core" up to "snapshot" (repeat the test on each level a couple of times
to make sure that any random factors are avoided).
If the "freezer" test fails, there is a task that cannot be frozen (in that case
@@ -140,7 +145,11 @@ devices has failed (these devices are suspended on one CPU with interrupts off),
the problem is most probably hardware-related and serious, so it should be
reported.
-A failure of any of the "platform", "processors" or "core" tests may cause your
+If the "snapshot" test fails, which means that restoring of the pages from the
+swap device has failed, it might be caused by a broken swap device, or other memory
+management issues, so it should be reported.
+
+A failure of any of the "platform", "processors" "core" or "snapshot" tests may cause your
system to hang or become unstable, so please beware. Such a failure usually
indicates a serious problem that very well may be related to the hardware, but
please report it anyway.
--
2.7.4
Powered by blists - more mailing lists