DebuggingKernelSuspend

Differences between revisions 32 and 33
Revision 32 as of 2009-08-27 23:34:53
Size: 4955
Editor: p549F132E
Comment: FeistyFawn isn't the only release with a kernel >= 2.6.20 anymore
Revision 33 as of 2010-01-27 21:46:35
Size: 4958
Editor: 53774a97
Comment: By default Ubuntu users can't log in as root, hence the usage of "sudo sh -c"
Deletions are marked like this. Additions are marked like this.
Line 22: Line 22:
OK. With that understood.... In order to simulate your suspend/resume process, enter the following commands (as root): OK. With that understood.... In order to simulate your suspend/resume process, enter the following commands:
Line 25: Line 25:
sync; echo 1 > /sys/power/pm_trace; pm-suspend sudo sh -c "sync; echo 1 > /sys/power/pm_trace; pm-suspend"

Debugging Central

This page is part of the debugging series — pages with debugging details for a variety of Ubuntu packages.

Introduction

This page describes how to debug Suspend to RAM/Resume problems on your computer. Do not confuse this with Suspend to disk (also known as hibernate). UnderstandingSuspend may have useful background information on where problems can occur.

Suspend and Resume use facilities within your BIOS called ACPI, or Advanced Configuration and Power Interface. Linux provides an ACPI subsystem that manages the suspend and resume process. The usual problem occurs when resuming, and normally the culprit is a device driver that does not recover from a powered down state. If your computer successfully performs a suspend, then it is quite likely any resume problems are due to another device driver and not the ACPI subsystem.

The debugging procedure described below requires a linux kernel 2.6.20 (and newer) for the ability of "/sys/power/pm_trace". FeistyFawn and later release have a new enough kernel version. You can check the version of the kernel you are running by uname -r from a terminal. You can also just look in the directory /sys/power/ (from a terminal type ls /sys/power/) to see if a file called pm_trace exists; it will only do so if the kernel supports the following debugging procedure.

"resume-trace" debugging procedure for finding buggy drivers

Resume problems are difficult to debug. The approach used here needs to make notes on progress during resume and be able to recover it after a manual reboot. But there is no non-volatile storage available at the time resume is bringing up your computer. The only hardware on a PC motherboard that retains information across power cycles is the real time clock (RTC), so that is what is used. For those that want to know the details, read Documentation/power/s2ram.txt in your kernel sources. The implementation of suspend/resume debug trace is in drivers/base/power/trace.c.

Caveat Emptor: Using the following debug suggestions will radically change the values in your RTC chip, so much so that your file system will think it has been eons since the last fsck. You can avoid a long fsck delay by using 'tune2fs'. For example, 'tune2fs -i 0 /dev/sda1' disables fsck on boot. But first you'll want to use 'tune2fs -l <device>' to get the current information of your settings - look at the "Check interval" setting.

From a fresh Hardy install, the default time interval is 15552000, which is 6 months.

Remember that when you are all done, you'll want to set your RTC clock back. Note that NTP by itself is not sufficient to recover the correct time of day, since by default NTP is configured to do nothing if the time is off by more than 1000 seconds. You must first use the 'ntpdate' or 'date' command to get the clock close.

OK. With that understood.... In order to simulate your suspend/resume process, enter the following commands:

sudo sh -c "sync; echo 1 > /sys/power/pm_trace; pm-suspend"

At this point your computer should enter the suspend state within a few seconds. Usually the power LED will slowly flash when in the suspended state. When that has happened, initiate the resume process by pressing the power button. Observe closely if the disk light comes on briefly. This indicates that resume has begun. If resume fails to complete, then press the power button until the computer turns off. Power on your computer making sure that it loads the same kernel that exhibited the resume problem. You have about 3 minutes to start this boot process before the information saved in the RTC gets corrupted.

Start a console and enter:

dmesg > dmesg.txt

You can edit this file and find line similar to these:

[   11.323206]   Magic number: 0:798:264
[   11.323257]   hash matches drivers/base/power/resume.c:46

There may well be another 'hash matches' line beyond that. If so, then you are in luck because the last one is the likely culprit. For example:

hash matches device i2c-9191

The only way to prove this is to remove the module prior to initiating suspend. Repeat as needed...

If you get a device number rather than name, lspci and /sys/devices/pci* are your friends.

Further hints

Detailed analysis of ACPI kernel code for debugging a suspend problem


Also see:


CategoryBugSquad CategoryDebugging

DebuggingKernelSuspend (last edited 2019-01-28 21:01:56 by penalvch)