xref: /openbmc/linux/drivers/base/power/trace.c (revision 6a551c11)
1 /*
2  * drivers/base/power/trace.c
3  *
4  * Copyright (C) 2006 Linus Torvalds
5  *
6  * Trace facility for suspend/resume problems, when none of the
7  * devices may be working.
8  */
9 
10 #include <linux/pm-trace.h>
11 #include <linux/export.h>
12 #include <linux/rtc.h>
13 
14 #include <asm/rtc.h>
15 
16 #include "power.h"
17 
18 /*
19  * Horrid, horrid, horrid.
20  *
21  * It turns out that the _only_ piece of hardware that actually
22  * keeps its value across a hard boot (and, more importantly, the
23  * POST init sequence) is literally the realtime clock.
24  *
25  * Never mind that an RTC chip has 114 bytes (and often a whole
26  * other bank of an additional 128 bytes) of nice SRAM that is
27  * _designed_ to keep data - the POST will clear it. So we literally
28  * can just use the few bytes of actual time data, which means that
29  * we're really limited.
30  *
31  * It means, for example, that we can't use the seconds at all
32  * (since the time between the hang and the boot might be more
33  * than a minute), and we'd better not depend on the low bits of
34  * the minutes either.
35  *
36  * There are the wday fields etc, but I wouldn't guarantee those
37  * are dependable either. And if the date isn't valid, either the
38  * hw or POST will do strange things.
39  *
40  * So we're left with:
41  *  - year: 0-99
42  *  - month: 0-11
43  *  - day-of-month: 1-28
44  *  - hour: 0-23
45  *  - min: (0-30)*2
46  *
47  * Giving us a total range of 0-16128000 (0xf61800), ie less
48  * than 24 bits of actual data we can save across reboots.
49  *
50  * And if your box can't boot in less than three minutes,
51  * you're screwed.
52  *
53  * Now, almost 24 bits of data is pitifully small, so we need
54  * to be pretty dense if we want to use it for anything nice.
55  * What we do is that instead of saving off nice readable info,
56  * we save off _hashes_ of information that we can hopefully
57  * regenerate after the reboot.
58  *
59  * In particular, this means that we might be unlucky, and hit
60  * a case where we have a hash collision, and we end up not
61  * being able to tell for certain exactly which case happened.
62  * But that's hopefully unlikely.
63  *
64  * What we do is to take the bits we can fit, and split them
65  * into three parts (16*997*1009 = 16095568), and use the values
66  * for:
67  *  - 0-15: user-settable
68  *  - 0-996: file + line number
69  *  - 0-1008: device
70  */
71 #define USERHASH (16)
72 #define FILEHASH (997)
73 #define DEVHASH (1009)
74 
75 #define DEVSEED (7919)
76 
77 static unsigned int dev_hash_value;
78 
79 static int set_magic_time(unsigned int user, unsigned int file, unsigned int device)
80 {
81 	unsigned int n = user + USERHASH*(file + FILEHASH*device);
82 
83 	// June 7th, 2006
84 	static struct rtc_time time = {
85 		.tm_sec = 0,
86 		.tm_min = 0,
87 		.tm_hour = 0,
88 		.tm_mday = 7,
89 		.tm_mon = 5,	// June - counting from zero
90 		.tm_year = 106,
91 		.tm_wday = 3,
92 		.tm_yday = 160,
93 		.tm_isdst = 1
94 	};
95 
96 	time.tm_year = (n % 100);
97 	n /= 100;
98 	time.tm_mon = (n % 12);
99 	n /= 12;
100 	time.tm_mday = (n % 28) + 1;
101 	n /= 28;
102 	time.tm_hour = (n % 24);
103 	n /= 24;
104 	time.tm_min = (n % 20) * 3;
105 	n /= 20;
106 	set_rtc_time(&time);
107 	return n ? -1 : 0;
108 }
109 
110 static unsigned int read_magic_time(void)
111 {
112 	struct rtc_time time;
113 	unsigned int val;
114 
115 	get_rtc_time(&time);
116 	pr_info("RTC time: %2d:%02d:%02d, date: %02d/%02d/%02d\n",
117 		time.tm_hour, time.tm_min, time.tm_sec,
118 		time.tm_mon + 1, time.tm_mday, time.tm_year % 100);
119 	val = time.tm_year;				/* 100 years */
120 	if (val > 100)
121 		val -= 100;
122 	val += time.tm_mon * 100;			/* 12 months */
123 	val += (time.tm_mday-1) * 100 * 12;		/* 28 month-days */
124 	val += time.tm_hour * 100 * 12 * 28;		/* 24 hours */
125 	val += (time.tm_min / 3) * 100 * 12 * 28 * 24;	/* 20 3-minute intervals */
126 	return val;
127 }
128 
129 /*
130  * This is just the sdbm hash function with a user-supplied
131  * seed and final size parameter.
132  */
133 static unsigned int hash_string(unsigned int seed, const char *data, unsigned int mod)
134 {
135 	unsigned char c;
136 	while ((c = *data++) != 0) {
137 		seed = (seed << 16) + (seed << 6) - seed + c;
138 	}
139 	return seed % mod;
140 }
141 
142 void set_trace_device(struct device *dev)
143 {
144 	dev_hash_value = hash_string(DEVSEED, dev_name(dev), DEVHASH);
145 }
146 EXPORT_SYMBOL(set_trace_device);
147 
148 /*
149  * We could just take the "tracedata" index into the .tracedata
150  * section instead. Generating a hash of the data gives us a
151  * chance to work across kernel versions, and perhaps more
152  * importantly it also gives us valid/invalid check (ie we will
153  * likely not give totally bogus reports - if the hash matches,
154  * it's not any guarantee, but it's a high _likelihood_ that
155  * the match is valid).
156  */
157 void generate_pm_trace(const void *tracedata, unsigned int user)
158 {
159 	unsigned short lineno = *(unsigned short *)tracedata;
160 	const char *file = *(const char **)(tracedata + 2);
161 	unsigned int user_hash_value, file_hash_value;
162 
163 	user_hash_value = user % USERHASH;
164 	file_hash_value = hash_string(lineno, file, FILEHASH);
165 	set_magic_time(user_hash_value, file_hash_value, dev_hash_value);
166 }
167 EXPORT_SYMBOL(generate_pm_trace);
168 
169 extern char __tracedata_start[], __tracedata_end[];
170 static int show_file_hash(unsigned int value)
171 {
172 	int match;
173 	char *tracedata;
174 
175 	match = 0;
176 	for (tracedata = __tracedata_start ; tracedata < __tracedata_end ;
177 			tracedata += 2 + sizeof(unsigned long)) {
178 		unsigned short lineno = *(unsigned short *)tracedata;
179 		const char *file = *(const char **)(tracedata + 2);
180 		unsigned int hash = hash_string(lineno, file, FILEHASH);
181 		if (hash != value)
182 			continue;
183 		pr_info("  hash matches %s:%u\n", file, lineno);
184 		match++;
185 	}
186 	return match;
187 }
188 
189 static int show_dev_hash(unsigned int value)
190 {
191 	int match = 0;
192 	struct list_head *entry;
193 
194 	device_pm_lock();
195 	entry = dpm_list.prev;
196 	while (entry != &dpm_list) {
197 		struct device * dev = to_device(entry);
198 		unsigned int hash = hash_string(DEVSEED, dev_name(dev), DEVHASH);
199 		if (hash == value) {
200 			dev_info(dev, "hash matches\n");
201 			match++;
202 		}
203 		entry = entry->prev;
204 	}
205 	device_pm_unlock();
206 	return match;
207 }
208 
209 static unsigned int hash_value_early_read;
210 
211 int show_trace_dev_match(char *buf, size_t size)
212 {
213 	unsigned int value = hash_value_early_read / (USERHASH * FILEHASH);
214 	int ret = 0;
215 	struct list_head *entry;
216 
217 	/*
218 	 * It's possible that multiple devices will match the hash and we can't
219 	 * tell which is the culprit, so it's best to output them all.
220 	 */
221 	device_pm_lock();
222 	entry = dpm_list.prev;
223 	while (size && entry != &dpm_list) {
224 		struct device *dev = to_device(entry);
225 		unsigned int hash = hash_string(DEVSEED, dev_name(dev),
226 						DEVHASH);
227 		if (hash == value) {
228 			int len = snprintf(buf, size, "%s\n",
229 					    dev_driver_string(dev));
230 			if (len > size)
231 				len = size;
232 			buf += len;
233 			ret += len;
234 			size -= len;
235 		}
236 		entry = entry->prev;
237 	}
238 	device_pm_unlock();
239 	return ret;
240 }
241 
242 static int early_resume_init(void)
243 {
244 	hash_value_early_read = read_magic_time();
245 	return 0;
246 }
247 
248 static int late_resume_init(void)
249 {
250 	unsigned int val = hash_value_early_read;
251 	unsigned int user, file, dev;
252 
253 	user = val % USERHASH;
254 	val = val / USERHASH;
255 	file = val % FILEHASH;
256 	val = val / FILEHASH;
257 	dev = val /* % DEVHASH */;
258 
259 	pr_info("  Magic number: %d:%d:%d\n", user, file, dev);
260 	show_file_hash(file);
261 	show_dev_hash(dev);
262 	return 0;
263 }
264 
265 core_initcall(early_resume_init);
266 late_initcall(late_resume_init);
267