xref: /linux/drivers/of/unittest.c (revision a1a9b71ebd6582c94090ee5b70fb3eabf7088f22)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Self tests for device tree subsystem
4  */
5 
6 #define pr_fmt(fmt) "### dt-test ### " fmt
7 
8 #include <linux/memblock.h>
9 #include <linux/clk.h>
10 #include <linux/dma-direct.h> /* to test phys_to_dma/dma_to_phys */
11 #include <linux/err.h>
12 #include <linux/errno.h>
13 #include <linux/hashtable.h>
14 #include <linux/libfdt.h>
15 #include <linux/of.h>
16 #include <linux/of_address.h>
17 #include <linux/of_fdt.h>
18 #include <linux/of_irq.h>
19 #include <linux/of_platform.h>
20 #include <linux/list.h>
21 #include <linux/mutex.h>
22 #include <linux/slab.h>
23 #include <linux/device.h>
24 #include <linux/platform_device.h>
25 #include <linux/kernel.h>
26 
27 #include <linux/i2c.h>
28 #include <linux/i2c-mux.h>
29 #include <linux/gpio/driver.h>
30 
31 #include <linux/bitops.h>
32 
33 #include "of_private.h"
34 
35 static struct unittest_results {
36 	int passed;
37 	int failed;
38 } unittest_results;
39 
40 #define unittest(result, fmt, ...) ({ \
41 	bool failed = !(result); \
42 	if (failed) { \
43 		unittest_results.failed++; \
44 		pr_err("FAIL %s():%i " fmt, __func__, __LINE__, ##__VA_ARGS__); \
45 	} else { \
46 		unittest_results.passed++; \
47 		pr_info("pass %s():%i\n", __func__, __LINE__); \
48 	} \
49 	failed; \
50 })
51 
52 /*
53  * Expected message may have a message level other than KERN_INFO.
54  * Print the expected message only if the current loglevel will allow
55  * the actual message to print.
56  *
57  * Do not use EXPECT_BEGIN() or EXPECT_END() for messages generated by
58  * pr_debug().
59  */
60 #define EXPECT_BEGIN(level, fmt, ...) \
61 	printk(level pr_fmt("EXPECT \\ : ") fmt, ##__VA_ARGS__)
62 
63 #define EXPECT_END(level, fmt, ...) \
64 	printk(level pr_fmt("EXPECT / : ") fmt, ##__VA_ARGS__)
65 
66 static void __init of_unittest_find_node_by_name(void)
67 {
68 	struct device_node *np;
69 	const char *options, *name;
70 
71 	np = of_find_node_by_path("/testcase-data");
72 	name = kasprintf(GFP_KERNEL, "%pOF", np);
73 	unittest(np && !strcmp("/testcase-data", name),
74 		"find /testcase-data failed\n");
75 	of_node_put(np);
76 	kfree(name);
77 
78 	/* Test if trailing '/' works */
79 	np = of_find_node_by_path("/testcase-data/");
80 	unittest(!np, "trailing '/' on /testcase-data/ should fail\n");
81 
82 	np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
83 	name = kasprintf(GFP_KERNEL, "%pOF", np);
84 	unittest(np && !strcmp("/testcase-data/phandle-tests/consumer-a", name),
85 		"find /testcase-data/phandle-tests/consumer-a failed\n");
86 	of_node_put(np);
87 	kfree(name);
88 
89 	np = of_find_node_by_path("testcase-alias");
90 	name = kasprintf(GFP_KERNEL, "%pOF", np);
91 	unittest(np && !strcmp("/testcase-data", name),
92 		"find testcase-alias failed\n");
93 	of_node_put(np);
94 	kfree(name);
95 
96 	/* Test if trailing '/' works on aliases */
97 	np = of_find_node_by_path("testcase-alias/");
98 	unittest(!np, "trailing '/' on testcase-alias/ should fail\n");
99 
100 	np = of_find_node_by_path("testcase-alias/phandle-tests/consumer-a");
101 	name = kasprintf(GFP_KERNEL, "%pOF", np);
102 	unittest(np && !strcmp("/testcase-data/phandle-tests/consumer-a", name),
103 		"find testcase-alias/phandle-tests/consumer-a failed\n");
104 	of_node_put(np);
105 	kfree(name);
106 
107 	np = of_find_node_by_path("/testcase-data/missing-path");
108 	unittest(!np, "non-existent path returned node %pOF\n", np);
109 	of_node_put(np);
110 
111 	np = of_find_node_by_path("missing-alias");
112 	unittest(!np, "non-existent alias returned node %pOF\n", np);
113 	of_node_put(np);
114 
115 	np = of_find_node_by_path("testcase-alias/missing-path");
116 	unittest(!np, "non-existent alias with relative path returned node %pOF\n", np);
117 	of_node_put(np);
118 
119 	np = of_find_node_opts_by_path("/testcase-data:testoption", &options);
120 	unittest(np && !strcmp("testoption", options),
121 		 "option path test failed\n");
122 	of_node_put(np);
123 
124 	np = of_find_node_opts_by_path("/testcase-data:test/option", &options);
125 	unittest(np && !strcmp("test/option", options),
126 		 "option path test, subcase #1 failed\n");
127 	of_node_put(np);
128 
129 	np = of_find_node_opts_by_path("/testcase-data/testcase-device1:test/option", &options);
130 	unittest(np && !strcmp("test/option", options),
131 		 "option path test, subcase #2 failed\n");
132 	of_node_put(np);
133 
134 	np = of_find_node_opts_by_path("/testcase-data:testoption", NULL);
135 	unittest(np, "NULL option path test failed\n");
136 	of_node_put(np);
137 
138 	np = of_find_node_opts_by_path("testcase-alias:testaliasoption",
139 				       &options);
140 	unittest(np && !strcmp("testaliasoption", options),
141 		 "option alias path test failed\n");
142 	of_node_put(np);
143 
144 	np = of_find_node_opts_by_path("testcase-alias:test/alias/option",
145 				       &options);
146 	unittest(np && !strcmp("test/alias/option", options),
147 		 "option alias path test, subcase #1 failed\n");
148 	of_node_put(np);
149 
150 	np = of_find_node_opts_by_path("testcase-alias:testaliasoption", NULL);
151 	unittest(np, "NULL option alias path test failed\n");
152 	of_node_put(np);
153 
154 	options = "testoption";
155 	np = of_find_node_opts_by_path("testcase-alias", &options);
156 	unittest(np && !options, "option clearing test failed\n");
157 	of_node_put(np);
158 
159 	options = "testoption";
160 	np = of_find_node_opts_by_path("/", &options);
161 	unittest(np && !options, "option clearing root node test failed\n");
162 	of_node_put(np);
163 }
164 
165 static void __init of_unittest_dynamic(void)
166 {
167 	struct device_node *np;
168 	struct property *prop;
169 
170 	np = of_find_node_by_path("/testcase-data");
171 	if (!np) {
172 		pr_err("missing testcase data\n");
173 		return;
174 	}
175 
176 	/* Array of 4 properties for the purpose of testing */
177 	prop = kcalloc(4, sizeof(*prop), GFP_KERNEL);
178 	if (!prop) {
179 		unittest(0, "kzalloc() failed\n");
180 		return;
181 	}
182 
183 	/* Add a new property - should pass*/
184 	prop->name = "new-property";
185 	prop->value = "new-property-data";
186 	prop->length = strlen(prop->value) + 1;
187 	unittest(of_add_property(np, prop) == 0, "Adding a new property failed\n");
188 
189 	/* Try to add an existing property - should fail */
190 	prop++;
191 	prop->name = "new-property";
192 	prop->value = "new-property-data-should-fail";
193 	prop->length = strlen(prop->value) + 1;
194 	unittest(of_add_property(np, prop) != 0,
195 		 "Adding an existing property should have failed\n");
196 
197 	/* Try to modify an existing property - should pass */
198 	prop->value = "modify-property-data-should-pass";
199 	prop->length = strlen(prop->value) + 1;
200 	unittest(of_update_property(np, prop) == 0,
201 		 "Updating an existing property should have passed\n");
202 
203 	/* Try to modify non-existent property - should pass*/
204 	prop++;
205 	prop->name = "modify-property";
206 	prop->value = "modify-missing-property-data-should-pass";
207 	prop->length = strlen(prop->value) + 1;
208 	unittest(of_update_property(np, prop) == 0,
209 		 "Updating a missing property should have passed\n");
210 
211 	/* Remove property - should pass */
212 	unittest(of_remove_property(np, prop) == 0,
213 		 "Removing a property should have passed\n");
214 
215 	/* Adding very large property - should pass */
216 	prop++;
217 	prop->name = "large-property-PAGE_SIZEx8";
218 	prop->length = PAGE_SIZE * 8;
219 	prop->value = kzalloc(prop->length, GFP_KERNEL);
220 	unittest(prop->value != NULL, "Unable to allocate large buffer\n");
221 	if (prop->value)
222 		unittest(of_add_property(np, prop) == 0,
223 			 "Adding a large property should have passed\n");
224 }
225 
226 static int __init of_unittest_check_node_linkage(struct device_node *np)
227 {
228 	struct device_node *child;
229 	int count = 0, rc;
230 
231 	for_each_child_of_node(np, child) {
232 		if (child->parent != np) {
233 			pr_err("Child node %pOFn links to wrong parent %pOFn\n",
234 				 child, np);
235 			rc = -EINVAL;
236 			goto put_child;
237 		}
238 
239 		rc = of_unittest_check_node_linkage(child);
240 		if (rc < 0)
241 			goto put_child;
242 		count += rc;
243 	}
244 
245 	return count + 1;
246 put_child:
247 	of_node_put(child);
248 	return rc;
249 }
250 
251 static void __init of_unittest_check_tree_linkage(void)
252 {
253 	struct device_node *np;
254 	int allnode_count = 0, child_count;
255 
256 	if (!of_root)
257 		return;
258 
259 	for_each_of_allnodes(np)
260 		allnode_count++;
261 	child_count = of_unittest_check_node_linkage(of_root);
262 
263 	unittest(child_count > 0, "Device node data structure is corrupted\n");
264 	unittest(child_count == allnode_count,
265 		 "allnodes list size (%i) doesn't match sibling lists size (%i)\n",
266 		 allnode_count, child_count);
267 	pr_debug("allnodes list size (%i); sibling lists size (%i)\n", allnode_count, child_count);
268 }
269 
270 static void __init of_unittest_printf_one(struct device_node *np, const char *fmt,
271 					  const char *expected)
272 {
273 	unsigned char *buf;
274 	int buf_size;
275 	int size, i;
276 
277 	buf_size = strlen(expected) + 10;
278 	buf = kmalloc(buf_size, GFP_KERNEL);
279 	if (!buf)
280 		return;
281 
282 	/* Baseline; check conversion with a large size limit */
283 	memset(buf, 0xff, buf_size);
284 	size = snprintf(buf, buf_size - 2, fmt, np);
285 
286 	/* use strcmp() instead of strncmp() here to be absolutely sure strings match */
287 	unittest((strcmp(buf, expected) == 0) && (buf[size+1] == 0xff),
288 		"sprintf failed; fmt='%s' expected='%s' rslt='%s'\n",
289 		fmt, expected, buf);
290 
291 	/* Make sure length limits work */
292 	size++;
293 	for (i = 0; i < 2; i++, size--) {
294 		/* Clear the buffer, and make sure it works correctly still */
295 		memset(buf, 0xff, buf_size);
296 		snprintf(buf, size+1, fmt, np);
297 		unittest(strncmp(buf, expected, size) == 0 && (buf[size+1] == 0xff),
298 			"snprintf failed; size=%i fmt='%s' expected='%s' rslt='%s'\n",
299 			size, fmt, expected, buf);
300 	}
301 	kfree(buf);
302 }
303 
304 static void __init of_unittest_printf(void)
305 {
306 	struct device_node *np;
307 	const char *full_name = "/testcase-data/platform-tests/test-device@1/dev@100";
308 	char phandle_str[16] = "";
309 
310 	np = of_find_node_by_path(full_name);
311 	if (!np) {
312 		unittest(np, "testcase data missing\n");
313 		return;
314 	}
315 
316 	num_to_str(phandle_str, sizeof(phandle_str), np->phandle, 0);
317 
318 	of_unittest_printf_one(np, "%pOF",  full_name);
319 	of_unittest_printf_one(np, "%pOFf", full_name);
320 	of_unittest_printf_one(np, "%pOFn", "dev");
321 	of_unittest_printf_one(np, "%2pOFn", "dev");
322 	of_unittest_printf_one(np, "%5pOFn", "  dev");
323 	of_unittest_printf_one(np, "%pOFnc", "dev:test-sub-device");
324 	of_unittest_printf_one(np, "%pOFp", phandle_str);
325 	of_unittest_printf_one(np, "%pOFP", "dev@100");
326 	of_unittest_printf_one(np, "ABC %pOFP ABC", "ABC dev@100 ABC");
327 	of_unittest_printf_one(np, "%10pOFP", "   dev@100");
328 	of_unittest_printf_one(np, "%-10pOFP", "dev@100   ");
329 	of_unittest_printf_one(of_root, "%pOFP", "/");
330 	of_unittest_printf_one(np, "%pOFF", "----");
331 	of_unittest_printf_one(np, "%pOFPF", "dev@100:----");
332 	of_unittest_printf_one(np, "%pOFPFPc", "dev@100:----:dev@100:test-sub-device");
333 	of_unittest_printf_one(np, "%pOFc", "test-sub-device");
334 	of_unittest_printf_one(np, "%pOFC",
335 			"\"test-sub-device\",\"test-compat2\",\"test-compat3\"");
336 }
337 
338 struct node_hash {
339 	struct hlist_node node;
340 	struct device_node *np;
341 };
342 
343 static DEFINE_HASHTABLE(phandle_ht, 8);
344 static void __init of_unittest_check_phandles(void)
345 {
346 	struct device_node *np;
347 	struct node_hash *nh;
348 	struct hlist_node *tmp;
349 	int i, dup_count = 0, phandle_count = 0;
350 
351 	for_each_of_allnodes(np) {
352 		if (!np->phandle)
353 			continue;
354 
355 		hash_for_each_possible(phandle_ht, nh, node, np->phandle) {
356 			if (nh->np->phandle == np->phandle) {
357 				pr_info("Duplicate phandle! %i used by %pOF and %pOF\n",
358 					np->phandle, nh->np, np);
359 				dup_count++;
360 				break;
361 			}
362 		}
363 
364 		nh = kzalloc(sizeof(*nh), GFP_KERNEL);
365 		if (!nh)
366 			return;
367 
368 		nh->np = np;
369 		hash_add(phandle_ht, &nh->node, np->phandle);
370 		phandle_count++;
371 	}
372 	unittest(dup_count == 0, "Found %i duplicates in %i phandles\n",
373 		 dup_count, phandle_count);
374 
375 	/* Clean up */
376 	hash_for_each_safe(phandle_ht, i, tmp, nh, node) {
377 		hash_del(&nh->node);
378 		kfree(nh);
379 	}
380 }
381 
382 static void __init of_unittest_parse_phandle_with_args(void)
383 {
384 	struct device_node *np;
385 	struct of_phandle_args args;
386 	int i, rc;
387 
388 	np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
389 	if (!np) {
390 		pr_err("missing testcase data\n");
391 		return;
392 	}
393 
394 	rc = of_count_phandle_with_args(np, "phandle-list", "#phandle-cells");
395 	unittest(rc == 7, "of_count_phandle_with_args() returned %i, expected 7\n", rc);
396 
397 	for (i = 0; i < 8; i++) {
398 		bool passed = true;
399 
400 		memset(&args, 0, sizeof(args));
401 		rc = of_parse_phandle_with_args(np, "phandle-list",
402 						"#phandle-cells", i, &args);
403 
404 		/* Test the values from tests-phandle.dtsi */
405 		switch (i) {
406 		case 0:
407 			passed &= !rc;
408 			passed &= (args.args_count == 1);
409 			passed &= (args.args[0] == (i + 1));
410 			break;
411 		case 1:
412 			passed &= !rc;
413 			passed &= (args.args_count == 2);
414 			passed &= (args.args[0] == (i + 1));
415 			passed &= (args.args[1] == 0);
416 			break;
417 		case 2:
418 			passed &= (rc == -ENOENT);
419 			break;
420 		case 3:
421 			passed &= !rc;
422 			passed &= (args.args_count == 3);
423 			passed &= (args.args[0] == (i + 1));
424 			passed &= (args.args[1] == 4);
425 			passed &= (args.args[2] == 3);
426 			break;
427 		case 4:
428 			passed &= !rc;
429 			passed &= (args.args_count == 2);
430 			passed &= (args.args[0] == (i + 1));
431 			passed &= (args.args[1] == 100);
432 			break;
433 		case 5:
434 			passed &= !rc;
435 			passed &= (args.args_count == 0);
436 			break;
437 		case 6:
438 			passed &= !rc;
439 			passed &= (args.args_count == 1);
440 			passed &= (args.args[0] == (i + 1));
441 			break;
442 		case 7:
443 			passed &= (rc == -ENOENT);
444 			break;
445 		default:
446 			passed = false;
447 		}
448 
449 		unittest(passed, "index %i - data error on node %pOF rc=%i\n",
450 			 i, args.np, rc);
451 	}
452 
453 	/* Check for missing list property */
454 	memset(&args, 0, sizeof(args));
455 	rc = of_parse_phandle_with_args(np, "phandle-list-missing",
456 					"#phandle-cells", 0, &args);
457 	unittest(rc == -ENOENT, "expected:%i got:%i\n", -ENOENT, rc);
458 	rc = of_count_phandle_with_args(np, "phandle-list-missing",
459 					"#phandle-cells");
460 	unittest(rc == -ENOENT, "expected:%i got:%i\n", -ENOENT, rc);
461 
462 	/* Check for missing cells property */
463 	memset(&args, 0, sizeof(args));
464 
465 	EXPECT_BEGIN(KERN_INFO,
466 		     "OF: /testcase-data/phandle-tests/consumer-a: could not get #phandle-cells-missing for /testcase-data/phandle-tests/provider1");
467 
468 	rc = of_parse_phandle_with_args(np, "phandle-list",
469 					"#phandle-cells-missing", 0, &args);
470 
471 	EXPECT_END(KERN_INFO,
472 		   "OF: /testcase-data/phandle-tests/consumer-a: could not get #phandle-cells-missing for /testcase-data/phandle-tests/provider1");
473 
474 	unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
475 
476 	EXPECT_BEGIN(KERN_INFO,
477 		     "OF: /testcase-data/phandle-tests/consumer-a: could not get #phandle-cells-missing for /testcase-data/phandle-tests/provider1");
478 
479 	rc = of_count_phandle_with_args(np, "phandle-list",
480 					"#phandle-cells-missing");
481 
482 	EXPECT_END(KERN_INFO,
483 		   "OF: /testcase-data/phandle-tests/consumer-a: could not get #phandle-cells-missing for /testcase-data/phandle-tests/provider1");
484 
485 	unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
486 
487 	/* Check for bad phandle in list */
488 	memset(&args, 0, sizeof(args));
489 
490 	EXPECT_BEGIN(KERN_INFO,
491 		     "OF: /testcase-data/phandle-tests/consumer-a: could not find phandle");
492 
493 	rc = of_parse_phandle_with_args(np, "phandle-list-bad-phandle",
494 					"#phandle-cells", 0, &args);
495 
496 	EXPECT_END(KERN_INFO,
497 		   "OF: /testcase-data/phandle-tests/consumer-a: could not find phandle");
498 
499 	unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
500 
501 	EXPECT_BEGIN(KERN_INFO,
502 		     "OF: /testcase-data/phandle-tests/consumer-a: could not find phandle");
503 
504 	rc = of_count_phandle_with_args(np, "phandle-list-bad-phandle",
505 					"#phandle-cells");
506 
507 	EXPECT_END(KERN_INFO,
508 		   "OF: /testcase-data/phandle-tests/consumer-a: could not find phandle");
509 
510 	unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
511 
512 	/* Check for incorrectly formed argument list */
513 	memset(&args, 0, sizeof(args));
514 
515 	EXPECT_BEGIN(KERN_INFO,
516 		     "OF: /testcase-data/phandle-tests/consumer-a: #phandle-cells = 3 found 1");
517 
518 	rc = of_parse_phandle_with_args(np, "phandle-list-bad-args",
519 					"#phandle-cells", 1, &args);
520 
521 	EXPECT_END(KERN_INFO,
522 		   "OF: /testcase-data/phandle-tests/consumer-a: #phandle-cells = 3 found 1");
523 
524 	unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
525 
526 	EXPECT_BEGIN(KERN_INFO,
527 		     "OF: /testcase-data/phandle-tests/consumer-a: #phandle-cells = 3 found 1");
528 
529 	rc = of_count_phandle_with_args(np, "phandle-list-bad-args",
530 					"#phandle-cells");
531 
532 	EXPECT_END(KERN_INFO,
533 		   "OF: /testcase-data/phandle-tests/consumer-a: #phandle-cells = 3 found 1");
534 
535 	unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
536 }
537 
538 static void __init of_unittest_parse_phandle_with_args_map(void)
539 {
540 	struct device_node *np, *p0, *p1, *p2, *p3;
541 	struct of_phandle_args args;
542 	int i, rc;
543 
544 	np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-b");
545 	if (!np) {
546 		pr_err("missing testcase data\n");
547 		return;
548 	}
549 
550 	p0 = of_find_node_by_path("/testcase-data/phandle-tests/provider0");
551 	if (!p0) {
552 		pr_err("missing testcase data\n");
553 		return;
554 	}
555 
556 	p1 = of_find_node_by_path("/testcase-data/phandle-tests/provider1");
557 	if (!p1) {
558 		pr_err("missing testcase data\n");
559 		return;
560 	}
561 
562 	p2 = of_find_node_by_path("/testcase-data/phandle-tests/provider2");
563 	if (!p2) {
564 		pr_err("missing testcase data\n");
565 		return;
566 	}
567 
568 	p3 = of_find_node_by_path("/testcase-data/phandle-tests/provider3");
569 	if (!p3) {
570 		pr_err("missing testcase data\n");
571 		return;
572 	}
573 
574 	rc = of_count_phandle_with_args(np, "phandle-list", "#phandle-cells");
575 	unittest(rc == 7, "of_count_phandle_with_args() returned %i, expected 7\n", rc);
576 
577 	for (i = 0; i < 8; i++) {
578 		bool passed = true;
579 
580 		memset(&args, 0, sizeof(args));
581 		rc = of_parse_phandle_with_args_map(np, "phandle-list",
582 						    "phandle", i, &args);
583 
584 		/* Test the values from tests-phandle.dtsi */
585 		switch (i) {
586 		case 0:
587 			passed &= !rc;
588 			passed &= (args.np == p1);
589 			passed &= (args.args_count == 1);
590 			passed &= (args.args[0] == 1);
591 			break;
592 		case 1:
593 			passed &= !rc;
594 			passed &= (args.np == p3);
595 			passed &= (args.args_count == 3);
596 			passed &= (args.args[0] == 2);
597 			passed &= (args.args[1] == 5);
598 			passed &= (args.args[2] == 3);
599 			break;
600 		case 2:
601 			passed &= (rc == -ENOENT);
602 			break;
603 		case 3:
604 			passed &= !rc;
605 			passed &= (args.np == p0);
606 			passed &= (args.args_count == 0);
607 			break;
608 		case 4:
609 			passed &= !rc;
610 			passed &= (args.np == p1);
611 			passed &= (args.args_count == 1);
612 			passed &= (args.args[0] == 3);
613 			break;
614 		case 5:
615 			passed &= !rc;
616 			passed &= (args.np == p0);
617 			passed &= (args.args_count == 0);
618 			break;
619 		case 6:
620 			passed &= !rc;
621 			passed &= (args.np == p2);
622 			passed &= (args.args_count == 2);
623 			passed &= (args.args[0] == 15);
624 			passed &= (args.args[1] == 0x20);
625 			break;
626 		case 7:
627 			passed &= (rc == -ENOENT);
628 			break;
629 		default:
630 			passed = false;
631 		}
632 
633 		unittest(passed, "index %i - data error on node %s rc=%i\n",
634 			 i, args.np->full_name, rc);
635 	}
636 
637 	/* Check for missing list property */
638 	memset(&args, 0, sizeof(args));
639 	rc = of_parse_phandle_with_args_map(np, "phandle-list-missing",
640 					    "phandle", 0, &args);
641 	unittest(rc == -ENOENT, "expected:%i got:%i\n", -ENOENT, rc);
642 
643 	/* Check for missing cells,map,mask property */
644 	memset(&args, 0, sizeof(args));
645 
646 	EXPECT_BEGIN(KERN_INFO,
647 		     "OF: /testcase-data/phandle-tests/consumer-b: could not get #phandle-missing-cells for /testcase-data/phandle-tests/provider1");
648 
649 	rc = of_parse_phandle_with_args_map(np, "phandle-list",
650 					    "phandle-missing", 0, &args);
651 	EXPECT_END(KERN_INFO,
652 		   "OF: /testcase-data/phandle-tests/consumer-b: could not get #phandle-missing-cells for /testcase-data/phandle-tests/provider1");
653 
654 	unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
655 
656 	/* Check for bad phandle in list */
657 	memset(&args, 0, sizeof(args));
658 
659 	EXPECT_BEGIN(KERN_INFO,
660 		     "OF: /testcase-data/phandle-tests/consumer-b: could not find phandle");
661 
662 	rc = of_parse_phandle_with_args_map(np, "phandle-list-bad-phandle",
663 					    "phandle", 0, &args);
664 	EXPECT_END(KERN_INFO,
665 		   "OF: /testcase-data/phandle-tests/consumer-b: could not find phandle");
666 
667 	unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
668 
669 	/* Check for incorrectly formed argument list */
670 	memset(&args, 0, sizeof(args));
671 
672 	EXPECT_BEGIN(KERN_INFO,
673 		     "OF: /testcase-data/phandle-tests/consumer-b: #phandle-cells = 2 found 1");
674 
675 	rc = of_parse_phandle_with_args_map(np, "phandle-list-bad-args",
676 					    "phandle", 1, &args);
677 	EXPECT_END(KERN_INFO,
678 		   "OF: /testcase-data/phandle-tests/consumer-b: #phandle-cells = 2 found 1");
679 
680 	unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
681 }
682 
683 static void __init of_unittest_property_string(void)
684 {
685 	const char *strings[4];
686 	struct device_node *np;
687 	int rc;
688 
689 	np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
690 	if (!np) {
691 		pr_err("No testcase data in device tree\n");
692 		return;
693 	}
694 
695 	rc = of_property_match_string(np, "phandle-list-names", "first");
696 	unittest(rc == 0, "first expected:0 got:%i\n", rc);
697 	rc = of_property_match_string(np, "phandle-list-names", "second");
698 	unittest(rc == 1, "second expected:1 got:%i\n", rc);
699 	rc = of_property_match_string(np, "phandle-list-names", "third");
700 	unittest(rc == 2, "third expected:2 got:%i\n", rc);
701 	rc = of_property_match_string(np, "phandle-list-names", "fourth");
702 	unittest(rc == -ENODATA, "unmatched string; rc=%i\n", rc);
703 	rc = of_property_match_string(np, "missing-property", "blah");
704 	unittest(rc == -EINVAL, "missing property; rc=%i\n", rc);
705 	rc = of_property_match_string(np, "empty-property", "blah");
706 	unittest(rc == -ENODATA, "empty property; rc=%i\n", rc);
707 	rc = of_property_match_string(np, "unterminated-string", "blah");
708 	unittest(rc == -EILSEQ, "unterminated string; rc=%i\n", rc);
709 
710 	/* of_property_count_strings() tests */
711 	rc = of_property_count_strings(np, "string-property");
712 	unittest(rc == 1, "Incorrect string count; rc=%i\n", rc);
713 	rc = of_property_count_strings(np, "phandle-list-names");
714 	unittest(rc == 3, "Incorrect string count; rc=%i\n", rc);
715 	rc = of_property_count_strings(np, "unterminated-string");
716 	unittest(rc == -EILSEQ, "unterminated string; rc=%i\n", rc);
717 	rc = of_property_count_strings(np, "unterminated-string-list");
718 	unittest(rc == -EILSEQ, "unterminated string array; rc=%i\n", rc);
719 
720 	/* of_property_read_string_index() tests */
721 	rc = of_property_read_string_index(np, "string-property", 0, strings);
722 	unittest(rc == 0 && !strcmp(strings[0], "foobar"), "of_property_read_string_index() failure; rc=%i\n", rc);
723 	strings[0] = NULL;
724 	rc = of_property_read_string_index(np, "string-property", 1, strings);
725 	unittest(rc == -ENODATA && strings[0] == NULL, "of_property_read_string_index() failure; rc=%i\n", rc);
726 	rc = of_property_read_string_index(np, "phandle-list-names", 0, strings);
727 	unittest(rc == 0 && !strcmp(strings[0], "first"), "of_property_read_string_index() failure; rc=%i\n", rc);
728 	rc = of_property_read_string_index(np, "phandle-list-names", 1, strings);
729 	unittest(rc == 0 && !strcmp(strings[0], "second"), "of_property_read_string_index() failure; rc=%i\n", rc);
730 	rc = of_property_read_string_index(np, "phandle-list-names", 2, strings);
731 	unittest(rc == 0 && !strcmp(strings[0], "third"), "of_property_read_string_index() failure; rc=%i\n", rc);
732 	strings[0] = NULL;
733 	rc = of_property_read_string_index(np, "phandle-list-names", 3, strings);
734 	unittest(rc == -ENODATA && strings[0] == NULL, "of_property_read_string_index() failure; rc=%i\n", rc);
735 	strings[0] = NULL;
736 	rc = of_property_read_string_index(np, "unterminated-string", 0, strings);
737 	unittest(rc == -EILSEQ && strings[0] == NULL, "of_property_read_string_index() failure; rc=%i\n", rc);
738 	rc = of_property_read_string_index(np, "unterminated-string-list", 0, strings);
739 	unittest(rc == 0 && !strcmp(strings[0], "first"), "of_property_read_string_index() failure; rc=%i\n", rc);
740 	strings[0] = NULL;
741 	rc = of_property_read_string_index(np, "unterminated-string-list", 2, strings); /* should fail */
742 	unittest(rc == -EILSEQ && strings[0] == NULL, "of_property_read_string_index() failure; rc=%i\n", rc);
743 	strings[1] = NULL;
744 
745 	/* of_property_read_string_array() tests */
746 	rc = of_property_read_string_array(np, "string-property", strings, 4);
747 	unittest(rc == 1, "Incorrect string count; rc=%i\n", rc);
748 	rc = of_property_read_string_array(np, "phandle-list-names", strings, 4);
749 	unittest(rc == 3, "Incorrect string count; rc=%i\n", rc);
750 	rc = of_property_read_string_array(np, "unterminated-string", strings, 4);
751 	unittest(rc == -EILSEQ, "unterminated string; rc=%i\n", rc);
752 	/* -- An incorrectly formed string should cause a failure */
753 	rc = of_property_read_string_array(np, "unterminated-string-list", strings, 4);
754 	unittest(rc == -EILSEQ, "unterminated string array; rc=%i\n", rc);
755 	/* -- parsing the correctly formed strings should still work: */
756 	strings[2] = NULL;
757 	rc = of_property_read_string_array(np, "unterminated-string-list", strings, 2);
758 	unittest(rc == 2 && strings[2] == NULL, "of_property_read_string_array() failure; rc=%i\n", rc);
759 	strings[1] = NULL;
760 	rc = of_property_read_string_array(np, "phandle-list-names", strings, 1);
761 	unittest(rc == 1 && strings[1] == NULL, "Overwrote end of string array; rc=%i, str='%s'\n", rc, strings[1]);
762 }
763 
764 #define propcmp(p1, p2) (((p1)->length == (p2)->length) && \
765 			(p1)->value && (p2)->value && \
766 			!memcmp((p1)->value, (p2)->value, (p1)->length) && \
767 			!strcmp((p1)->name, (p2)->name))
768 static void __init of_unittest_property_copy(void)
769 {
770 #ifdef CONFIG_OF_DYNAMIC
771 	struct property p1 = { .name = "p1", .length = 0, .value = "" };
772 	struct property p2 = { .name = "p2", .length = 5, .value = "abcd" };
773 	struct property *new;
774 
775 	new = __of_prop_dup(&p1, GFP_KERNEL);
776 	unittest(new && propcmp(&p1, new), "empty property didn't copy correctly\n");
777 	kfree(new->value);
778 	kfree(new->name);
779 	kfree(new);
780 
781 	new = __of_prop_dup(&p2, GFP_KERNEL);
782 	unittest(new && propcmp(&p2, new), "non-empty property didn't copy correctly\n");
783 	kfree(new->value);
784 	kfree(new->name);
785 	kfree(new);
786 #endif
787 }
788 
789 static void __init of_unittest_changeset(void)
790 {
791 #ifdef CONFIG_OF_DYNAMIC
792 	struct property *ppadd, padd = { .name = "prop-add", .length = 1, .value = "" };
793 	struct property *ppname_n1,  pname_n1  = { .name = "name", .length = 3, .value = "n1"  };
794 	struct property *ppname_n2,  pname_n2  = { .name = "name", .length = 3, .value = "n2"  };
795 	struct property *ppname_n21, pname_n21 = { .name = "name", .length = 3, .value = "n21" };
796 	struct property *ppupdate, pupdate = { .name = "prop-update", .length = 5, .value = "abcd" };
797 	struct property *ppremove;
798 	struct device_node *n1, *n2, *n21, *nchangeset, *nremove, *parent, *np;
799 	struct of_changeset chgset;
800 
801 	n1 = __of_node_dup(NULL, "n1");
802 	unittest(n1, "testcase setup failure\n");
803 
804 	n2 = __of_node_dup(NULL, "n2");
805 	unittest(n2, "testcase setup failure\n");
806 
807 	n21 = __of_node_dup(NULL, "n21");
808 	unittest(n21, "testcase setup failure %p\n", n21);
809 
810 	nchangeset = of_find_node_by_path("/testcase-data/changeset");
811 	nremove = of_get_child_by_name(nchangeset, "node-remove");
812 	unittest(nremove, "testcase setup failure\n");
813 
814 	ppadd = __of_prop_dup(&padd, GFP_KERNEL);
815 	unittest(ppadd, "testcase setup failure\n");
816 
817 	ppname_n1  = __of_prop_dup(&pname_n1, GFP_KERNEL);
818 	unittest(ppname_n1, "testcase setup failure\n");
819 
820 	ppname_n2  = __of_prop_dup(&pname_n2, GFP_KERNEL);
821 	unittest(ppname_n2, "testcase setup failure\n");
822 
823 	ppname_n21 = __of_prop_dup(&pname_n21, GFP_KERNEL);
824 	unittest(ppname_n21, "testcase setup failure\n");
825 
826 	ppupdate = __of_prop_dup(&pupdate, GFP_KERNEL);
827 	unittest(ppupdate, "testcase setup failure\n");
828 
829 	parent = nchangeset;
830 	n1->parent = parent;
831 	n2->parent = parent;
832 	n21->parent = n2;
833 
834 	ppremove = of_find_property(parent, "prop-remove", NULL);
835 	unittest(ppremove, "failed to find removal prop");
836 
837 	of_changeset_init(&chgset);
838 
839 	unittest(!of_changeset_attach_node(&chgset, n1), "fail attach n1\n");
840 	unittest(!of_changeset_add_property(&chgset, n1, ppname_n1), "fail add prop name\n");
841 
842 	unittest(!of_changeset_attach_node(&chgset, n2), "fail attach n2\n");
843 	unittest(!of_changeset_add_property(&chgset, n2, ppname_n2), "fail add prop name\n");
844 
845 	unittest(!of_changeset_detach_node(&chgset, nremove), "fail remove node\n");
846 	unittest(!of_changeset_add_property(&chgset, n21, ppname_n21), "fail add prop name\n");
847 
848 	unittest(!of_changeset_attach_node(&chgset, n21), "fail attach n21\n");
849 
850 	unittest(!of_changeset_add_property(&chgset, parent, ppadd), "fail add prop prop-add\n");
851 	unittest(!of_changeset_update_property(&chgset, parent, ppupdate), "fail update prop\n");
852 	unittest(!of_changeset_remove_property(&chgset, parent, ppremove), "fail remove prop\n");
853 
854 	unittest(!of_changeset_apply(&chgset), "apply failed\n");
855 
856 	of_node_put(nchangeset);
857 
858 	/* Make sure node names are constructed correctly */
859 	unittest((np = of_find_node_by_path("/testcase-data/changeset/n2/n21")),
860 		 "'%pOF' not added\n", n21);
861 	of_node_put(np);
862 
863 	unittest(!of_changeset_revert(&chgset), "revert failed\n");
864 
865 	of_changeset_destroy(&chgset);
866 
867 	of_node_put(n1);
868 	of_node_put(n2);
869 	of_node_put(n21);
870 #endif
871 }
872 
873 static void __init of_unittest_dma_get_max_cpu_address(void)
874 {
875 	struct device_node *np;
876 	phys_addr_t cpu_addr;
877 
878 	if (!IS_ENABLED(CONFIG_OF_ADDRESS))
879 		return;
880 
881 	np = of_find_node_by_path("/testcase-data/address-tests");
882 	if (!np) {
883 		pr_err("missing testcase data\n");
884 		return;
885 	}
886 
887 	cpu_addr = of_dma_get_max_cpu_address(np);
888 	unittest(cpu_addr == 0x4fffffff,
889 		 "of_dma_get_max_cpu_address: wrong CPU addr %pad (expecting %x)\n",
890 		 &cpu_addr, 0x4fffffff);
891 }
892 
893 static void __init of_unittest_dma_ranges_one(const char *path,
894 		u64 expect_dma_addr, u64 expect_paddr)
895 {
896 #ifdef CONFIG_HAS_DMA
897 	struct device_node *np;
898 	const struct bus_dma_region *map = NULL;
899 	int rc;
900 
901 	np = of_find_node_by_path(path);
902 	if (!np) {
903 		pr_err("missing testcase data\n");
904 		return;
905 	}
906 
907 	rc = of_dma_get_range(np, &map);
908 
909 	unittest(!rc, "of_dma_get_range failed on node %pOF rc=%i\n", np, rc);
910 
911 	if (!rc) {
912 		phys_addr_t	paddr;
913 		dma_addr_t	dma_addr;
914 		struct device	*dev_bogus;
915 
916 		dev_bogus = kzalloc(sizeof(struct device), GFP_KERNEL);
917 		if (!dev_bogus) {
918 			unittest(0, "kzalloc() failed\n");
919 			kfree(map);
920 			return;
921 		}
922 
923 		dev_bogus->dma_range_map = map;
924 		paddr = dma_to_phys(dev_bogus, expect_dma_addr);
925 		dma_addr = phys_to_dma(dev_bogus, expect_paddr);
926 
927 		unittest(paddr == expect_paddr,
928 			 "of_dma_get_range: wrong phys addr %pap (expecting %llx) on node %pOF\n",
929 			 &paddr, expect_paddr, np);
930 		unittest(dma_addr == expect_dma_addr,
931 			 "of_dma_get_range: wrong DMA addr %pad (expecting %llx) on node %pOF\n",
932 			 &dma_addr, expect_dma_addr, np);
933 
934 		kfree(map);
935 		kfree(dev_bogus);
936 	}
937 	of_node_put(np);
938 #endif
939 }
940 
941 static void __init of_unittest_parse_dma_ranges(void)
942 {
943 	of_unittest_dma_ranges_one("/testcase-data/address-tests/device@70000000",
944 		0x0, 0x20000000);
945 	if (IS_ENABLED(CONFIG_ARCH_DMA_ADDR_T_64BIT))
946 		of_unittest_dma_ranges_one("/testcase-data/address-tests/bus@80000000/device@1000",
947 			0x100000000, 0x20000000);
948 	of_unittest_dma_ranges_one("/testcase-data/address-tests/pci@90000000",
949 		0x80000000, 0x20000000);
950 }
951 
952 static void __init of_unittest_pci_dma_ranges(void)
953 {
954 	struct device_node *np;
955 	struct of_pci_range range;
956 	struct of_pci_range_parser parser;
957 	int i = 0;
958 
959 	if (!IS_ENABLED(CONFIG_PCI))
960 		return;
961 
962 	np = of_find_node_by_path("/testcase-data/address-tests/pci@90000000");
963 	if (!np) {
964 		pr_err("missing testcase data\n");
965 		return;
966 	}
967 
968 	if (of_pci_dma_range_parser_init(&parser, np)) {
969 		pr_err("missing dma-ranges property\n");
970 		return;
971 	}
972 
973 	/*
974 	 * Get the dma-ranges from the device tree
975 	 */
976 	for_each_of_pci_range(&parser, &range) {
977 		if (!i) {
978 			unittest(range.size == 0x10000000,
979 				 "for_each_of_pci_range wrong size on node %pOF size=%llx\n",
980 				 np, range.size);
981 			unittest(range.cpu_addr == 0x20000000,
982 				 "for_each_of_pci_range wrong CPU addr (%llx) on node %pOF",
983 				 range.cpu_addr, np);
984 			unittest(range.pci_addr == 0x80000000,
985 				 "for_each_of_pci_range wrong DMA addr (%llx) on node %pOF",
986 				 range.pci_addr, np);
987 		} else {
988 			unittest(range.size == 0x10000000,
989 				 "for_each_of_pci_range wrong size on node %pOF size=%llx\n",
990 				 np, range.size);
991 			unittest(range.cpu_addr == 0x40000000,
992 				 "for_each_of_pci_range wrong CPU addr (%llx) on node %pOF",
993 				 range.cpu_addr, np);
994 			unittest(range.pci_addr == 0xc0000000,
995 				 "for_each_of_pci_range wrong DMA addr (%llx) on node %pOF",
996 				 range.pci_addr, np);
997 		}
998 		i++;
999 	}
1000 
1001 	of_node_put(np);
1002 }
1003 
1004 static void __init of_unittest_parse_interrupts(void)
1005 {
1006 	struct device_node *np;
1007 	struct of_phandle_args args;
1008 	int i, rc;
1009 
1010 	if (of_irq_workarounds & OF_IMAP_OLDWORLD_MAC)
1011 		return;
1012 
1013 	np = of_find_node_by_path("/testcase-data/interrupts/interrupts0");
1014 	if (!np) {
1015 		pr_err("missing testcase data\n");
1016 		return;
1017 	}
1018 
1019 	for (i = 0; i < 4; i++) {
1020 		bool passed = true;
1021 
1022 		memset(&args, 0, sizeof(args));
1023 		rc = of_irq_parse_one(np, i, &args);
1024 
1025 		passed &= !rc;
1026 		passed &= (args.args_count == 1);
1027 		passed &= (args.args[0] == (i + 1));
1028 
1029 		unittest(passed, "index %i - data error on node %pOF rc=%i\n",
1030 			 i, args.np, rc);
1031 	}
1032 	of_node_put(np);
1033 
1034 	np = of_find_node_by_path("/testcase-data/interrupts/interrupts1");
1035 	if (!np) {
1036 		pr_err("missing testcase data\n");
1037 		return;
1038 	}
1039 
1040 	for (i = 0; i < 4; i++) {
1041 		bool passed = true;
1042 
1043 		memset(&args, 0, sizeof(args));
1044 		rc = of_irq_parse_one(np, i, &args);
1045 
1046 		/* Test the values from tests-phandle.dtsi */
1047 		switch (i) {
1048 		case 0:
1049 			passed &= !rc;
1050 			passed &= (args.args_count == 1);
1051 			passed &= (args.args[0] == 9);
1052 			break;
1053 		case 1:
1054 			passed &= !rc;
1055 			passed &= (args.args_count == 3);
1056 			passed &= (args.args[0] == 10);
1057 			passed &= (args.args[1] == 11);
1058 			passed &= (args.args[2] == 12);
1059 			break;
1060 		case 2:
1061 			passed &= !rc;
1062 			passed &= (args.args_count == 2);
1063 			passed &= (args.args[0] == 13);
1064 			passed &= (args.args[1] == 14);
1065 			break;
1066 		case 3:
1067 			passed &= !rc;
1068 			passed &= (args.args_count == 2);
1069 			passed &= (args.args[0] == 15);
1070 			passed &= (args.args[1] == 16);
1071 			break;
1072 		default:
1073 			passed = false;
1074 		}
1075 		unittest(passed, "index %i - data error on node %pOF rc=%i\n",
1076 			 i, args.np, rc);
1077 	}
1078 	of_node_put(np);
1079 }
1080 
1081 static void __init of_unittest_parse_interrupts_extended(void)
1082 {
1083 	struct device_node *np;
1084 	struct of_phandle_args args;
1085 	int i, rc;
1086 
1087 	if (of_irq_workarounds & OF_IMAP_OLDWORLD_MAC)
1088 		return;
1089 
1090 	np = of_find_node_by_path("/testcase-data/interrupts/interrupts-extended0");
1091 	if (!np) {
1092 		pr_err("missing testcase data\n");
1093 		return;
1094 	}
1095 
1096 	for (i = 0; i < 7; i++) {
1097 		bool passed = true;
1098 
1099 		memset(&args, 0, sizeof(args));
1100 		rc = of_irq_parse_one(np, i, &args);
1101 
1102 		/* Test the values from tests-phandle.dtsi */
1103 		switch (i) {
1104 		case 0:
1105 			passed &= !rc;
1106 			passed &= (args.args_count == 1);
1107 			passed &= (args.args[0] == 1);
1108 			break;
1109 		case 1:
1110 			passed &= !rc;
1111 			passed &= (args.args_count == 3);
1112 			passed &= (args.args[0] == 2);
1113 			passed &= (args.args[1] == 3);
1114 			passed &= (args.args[2] == 4);
1115 			break;
1116 		case 2:
1117 			passed &= !rc;
1118 			passed &= (args.args_count == 2);
1119 			passed &= (args.args[0] == 5);
1120 			passed &= (args.args[1] == 6);
1121 			break;
1122 		case 3:
1123 			passed &= !rc;
1124 			passed &= (args.args_count == 1);
1125 			passed &= (args.args[0] == 9);
1126 			break;
1127 		case 4:
1128 			passed &= !rc;
1129 			passed &= (args.args_count == 3);
1130 			passed &= (args.args[0] == 10);
1131 			passed &= (args.args[1] == 11);
1132 			passed &= (args.args[2] == 12);
1133 			break;
1134 		case 5:
1135 			passed &= !rc;
1136 			passed &= (args.args_count == 2);
1137 			passed &= (args.args[0] == 13);
1138 			passed &= (args.args[1] == 14);
1139 			break;
1140 		case 6:
1141 			/*
1142 			 * Tests child node that is missing property
1143 			 * #address-cells.  See the comments in
1144 			 * drivers/of/unittest-data/tests-interrupts.dtsi
1145 			 * nodes intmap1 and interrupts-extended0
1146 			 */
1147 			passed &= !rc;
1148 			passed &= (args.args_count == 1);
1149 			passed &= (args.args[0] == 15);
1150 			break;
1151 		default:
1152 			passed = false;
1153 		}
1154 
1155 		unittest(passed, "index %i - data error on node %pOF rc=%i\n",
1156 			 i, args.np, rc);
1157 	}
1158 	of_node_put(np);
1159 }
1160 
1161 static const struct of_device_id match_node_table[] = {
1162 	{ .data = "A", .name = "name0", }, /* Name alone is lowest priority */
1163 	{ .data = "B", .type = "type1", }, /* followed by type alone */
1164 
1165 	{ .data = "Ca", .name = "name2", .type = "type1", }, /* followed by both together */
1166 	{ .data = "Cb", .name = "name2", }, /* Only match when type doesn't match */
1167 	{ .data = "Cc", .name = "name2", .type = "type2", },
1168 
1169 	{ .data = "E", .compatible = "compat3" },
1170 	{ .data = "G", .compatible = "compat2", },
1171 	{ .data = "H", .compatible = "compat2", .name = "name5", },
1172 	{ .data = "I", .compatible = "compat2", .type = "type1", },
1173 	{ .data = "J", .compatible = "compat2", .type = "type1", .name = "name8", },
1174 	{ .data = "K", .compatible = "compat2", .name = "name9", },
1175 	{}
1176 };
1177 
1178 static struct {
1179 	const char *path;
1180 	const char *data;
1181 } match_node_tests[] = {
1182 	{ .path = "/testcase-data/match-node/name0", .data = "A", },
1183 	{ .path = "/testcase-data/match-node/name1", .data = "B", },
1184 	{ .path = "/testcase-data/match-node/a/name2", .data = "Ca", },
1185 	{ .path = "/testcase-data/match-node/b/name2", .data = "Cb", },
1186 	{ .path = "/testcase-data/match-node/c/name2", .data = "Cc", },
1187 	{ .path = "/testcase-data/match-node/name3", .data = "E", },
1188 	{ .path = "/testcase-data/match-node/name4", .data = "G", },
1189 	{ .path = "/testcase-data/match-node/name5", .data = "H", },
1190 	{ .path = "/testcase-data/match-node/name6", .data = "G", },
1191 	{ .path = "/testcase-data/match-node/name7", .data = "I", },
1192 	{ .path = "/testcase-data/match-node/name8", .data = "J", },
1193 	{ .path = "/testcase-data/match-node/name9", .data = "K", },
1194 };
1195 
1196 static void __init of_unittest_match_node(void)
1197 {
1198 	struct device_node *np;
1199 	const struct of_device_id *match;
1200 	int i;
1201 
1202 	for (i = 0; i < ARRAY_SIZE(match_node_tests); i++) {
1203 		np = of_find_node_by_path(match_node_tests[i].path);
1204 		if (!np) {
1205 			unittest(0, "missing testcase node %s\n",
1206 				match_node_tests[i].path);
1207 			continue;
1208 		}
1209 
1210 		match = of_match_node(match_node_table, np);
1211 		if (!match) {
1212 			unittest(0, "%s didn't match anything\n",
1213 				match_node_tests[i].path);
1214 			continue;
1215 		}
1216 
1217 		if (strcmp(match->data, match_node_tests[i].data) != 0) {
1218 			unittest(0, "%s got wrong match. expected %s, got %s\n",
1219 				match_node_tests[i].path, match_node_tests[i].data,
1220 				(const char *)match->data);
1221 			continue;
1222 		}
1223 		unittest(1, "passed");
1224 	}
1225 }
1226 
1227 static struct resource test_bus_res = DEFINE_RES_MEM(0xfffffff8, 2);
1228 static const struct platform_device_info test_bus_info = {
1229 	.name = "unittest-bus",
1230 };
1231 static void __init of_unittest_platform_populate(void)
1232 {
1233 	int irq, rc;
1234 	struct device_node *np, *child, *grandchild;
1235 	struct platform_device *pdev, *test_bus;
1236 	const struct of_device_id match[] = {
1237 		{ .compatible = "test-device", },
1238 		{}
1239 	};
1240 
1241 	np = of_find_node_by_path("/testcase-data");
1242 	of_platform_default_populate(np, NULL, NULL);
1243 
1244 	/* Test that a missing irq domain returns -EPROBE_DEFER */
1245 	np = of_find_node_by_path("/testcase-data/testcase-device1");
1246 	pdev = of_find_device_by_node(np);
1247 	unittest(pdev, "device 1 creation failed\n");
1248 
1249 	if (!(of_irq_workarounds & OF_IMAP_OLDWORLD_MAC)) {
1250 		irq = platform_get_irq(pdev, 0);
1251 		unittest(irq == -EPROBE_DEFER,
1252 			 "device deferred probe failed - %d\n", irq);
1253 
1254 		/* Test that a parsing failure does not return -EPROBE_DEFER */
1255 		np = of_find_node_by_path("/testcase-data/testcase-device2");
1256 		pdev = of_find_device_by_node(np);
1257 		unittest(pdev, "device 2 creation failed\n");
1258 
1259 		EXPECT_BEGIN(KERN_INFO,
1260 			     "platform testcase-data:testcase-device2: error -ENXIO: IRQ index 0 not found");
1261 
1262 		irq = platform_get_irq(pdev, 0);
1263 
1264 		EXPECT_END(KERN_INFO,
1265 			   "platform testcase-data:testcase-device2: error -ENXIO: IRQ index 0 not found");
1266 
1267 		unittest(irq < 0 && irq != -EPROBE_DEFER,
1268 			 "device parsing error failed - %d\n", irq);
1269 	}
1270 
1271 	np = of_find_node_by_path("/testcase-data/platform-tests");
1272 	unittest(np, "No testcase data in device tree\n");
1273 	if (!np)
1274 		return;
1275 
1276 	test_bus = platform_device_register_full(&test_bus_info);
1277 	rc = PTR_ERR_OR_ZERO(test_bus);
1278 	unittest(!rc, "testbus registration failed; rc=%i\n", rc);
1279 	if (rc) {
1280 		of_node_put(np);
1281 		return;
1282 	}
1283 	test_bus->dev.of_node = np;
1284 
1285 	/*
1286 	 * Add a dummy resource to the test bus node after it is
1287 	 * registered to catch problems with un-inserted resources. The
1288 	 * DT code doesn't insert the resources, and it has caused the
1289 	 * kernel to oops in the past. This makes sure the same bug
1290 	 * doesn't crop up again.
1291 	 */
1292 	platform_device_add_resources(test_bus, &test_bus_res, 1);
1293 
1294 	of_platform_populate(np, match, NULL, &test_bus->dev);
1295 	for_each_child_of_node(np, child) {
1296 		for_each_child_of_node(child, grandchild) {
1297 			pdev = of_find_device_by_node(grandchild);
1298 			unittest(pdev,
1299 				 "Could not create device for node '%pOFn'\n",
1300 				 grandchild);
1301 			platform_device_put(pdev);
1302 		}
1303 	}
1304 
1305 	of_platform_depopulate(&test_bus->dev);
1306 	for_each_child_of_node(np, child) {
1307 		for_each_child_of_node(child, grandchild)
1308 			unittest(!of_find_device_by_node(grandchild),
1309 				 "device didn't get destroyed '%pOFn'\n",
1310 				 grandchild);
1311 	}
1312 
1313 	platform_device_unregister(test_bus);
1314 	of_node_put(np);
1315 }
1316 
1317 /**
1318  *	update_node_properties - adds the properties
1319  *	of np into dup node (present in live tree) and
1320  *	updates parent of children of np to dup.
1321  *
1322  *	@np:	node whose properties are being added to the live tree
1323  *	@dup:	node present in live tree to be updated
1324  */
1325 static void update_node_properties(struct device_node *np,
1326 					struct device_node *dup)
1327 {
1328 	struct property *prop;
1329 	struct property *save_next;
1330 	struct device_node *child;
1331 	int ret;
1332 
1333 	for_each_child_of_node(np, child)
1334 		child->parent = dup;
1335 
1336 	/*
1337 	 * "unittest internal error: unable to add testdata property"
1338 	 *
1339 	 *    If this message reports a property in node '/__symbols__' then
1340 	 *    the respective unittest overlay contains a label that has the
1341 	 *    same name as a label in the live devicetree.  The label will
1342 	 *    be in the live devicetree only if the devicetree source was
1343 	 *    compiled with the '-@' option.  If you encounter this error,
1344 	 *    please consider renaming __all__ of the labels in the unittest
1345 	 *    overlay dts files with an odd prefix that is unlikely to be
1346 	 *    used in a real devicetree.
1347 	 */
1348 
1349 	/*
1350 	 * open code for_each_property_of_node() because of_add_property()
1351 	 * sets prop->next to NULL
1352 	 */
1353 	for (prop = np->properties; prop != NULL; prop = save_next) {
1354 		save_next = prop->next;
1355 		ret = of_add_property(dup, prop);
1356 		if (ret) {
1357 			if (ret == -EEXIST && !strcmp(prop->name, "name"))
1358 				continue;
1359 			pr_err("unittest internal error: unable to add testdata property %pOF/%s",
1360 			       np, prop->name);
1361 		}
1362 	}
1363 }
1364 
1365 /**
1366  *	attach_node_and_children - attaches nodes
1367  *	and its children to live tree.
1368  *	CAUTION: misleading function name - if node @np already exists in
1369  *	the live tree then children of @np are *not* attached to the live
1370  *	tree.  This works for the current test devicetree nodes because such
1371  *	nodes do not have child nodes.
1372  *
1373  *	@np:	Node to attach to live tree
1374  */
1375 static void attach_node_and_children(struct device_node *np)
1376 {
1377 	struct device_node *next, *dup, *child;
1378 	unsigned long flags;
1379 	const char *full_name;
1380 
1381 	full_name = kasprintf(GFP_KERNEL, "%pOF", np);
1382 
1383 	if (!strcmp(full_name, "/__local_fixups__") ||
1384 	    !strcmp(full_name, "/__fixups__")) {
1385 		kfree(full_name);
1386 		return;
1387 	}
1388 
1389 	dup = of_find_node_by_path(full_name);
1390 	kfree(full_name);
1391 	if (dup) {
1392 		update_node_properties(np, dup);
1393 		return;
1394 	}
1395 
1396 	child = np->child;
1397 	np->child = NULL;
1398 
1399 	mutex_lock(&of_mutex);
1400 	raw_spin_lock_irqsave(&devtree_lock, flags);
1401 	np->sibling = np->parent->child;
1402 	np->parent->child = np;
1403 	of_node_clear_flag(np, OF_DETACHED);
1404 	raw_spin_unlock_irqrestore(&devtree_lock, flags);
1405 
1406 	__of_attach_node_sysfs(np);
1407 	mutex_unlock(&of_mutex);
1408 
1409 	while (child) {
1410 		next = child->sibling;
1411 		attach_node_and_children(child);
1412 		child = next;
1413 	}
1414 }
1415 
1416 /**
1417  *	unittest_data_add - Reads, copies data from
1418  *	linked tree and attaches it to the live tree
1419  */
1420 static int __init unittest_data_add(void)
1421 {
1422 	void *unittest_data;
1423 	void *unittest_data_align;
1424 	struct device_node *unittest_data_node = NULL, *np;
1425 	/*
1426 	 * __dtb_testcases_begin[] and __dtb_testcases_end[] are magically
1427 	 * created by cmd_dt_S_dtb in scripts/Makefile.lib
1428 	 */
1429 	extern uint8_t __dtb_testcases_begin[];
1430 	extern uint8_t __dtb_testcases_end[];
1431 	const int size = __dtb_testcases_end - __dtb_testcases_begin;
1432 	int rc;
1433 	void *ret;
1434 
1435 	if (!size) {
1436 		pr_warn("%s: testcases is empty\n", __func__);
1437 		return -ENODATA;
1438 	}
1439 
1440 	/* creating copy */
1441 	unittest_data = kmalloc(size + FDT_ALIGN_SIZE, GFP_KERNEL);
1442 	if (!unittest_data)
1443 		return -ENOMEM;
1444 
1445 	unittest_data_align = PTR_ALIGN(unittest_data, FDT_ALIGN_SIZE);
1446 	memcpy(unittest_data_align, __dtb_testcases_begin, size);
1447 
1448 	ret = of_fdt_unflatten_tree(unittest_data_align, NULL, &unittest_data_node);
1449 	if (!ret) {
1450 		pr_warn("%s: unflatten testcases tree failed\n", __func__);
1451 		kfree(unittest_data);
1452 		return -ENODATA;
1453 	}
1454 	if (!unittest_data_node) {
1455 		pr_warn("%s: testcases tree is empty\n", __func__);
1456 		kfree(unittest_data);
1457 		return -ENODATA;
1458 	}
1459 
1460 	/*
1461 	 * This lock normally encloses of_resolve_phandles()
1462 	 */
1463 	of_overlay_mutex_lock();
1464 
1465 	rc = of_resolve_phandles(unittest_data_node);
1466 	if (rc) {
1467 		pr_err("%s: Failed to resolve phandles (rc=%i)\n", __func__, rc);
1468 		of_overlay_mutex_unlock();
1469 		return -EINVAL;
1470 	}
1471 
1472 	if (!of_root) {
1473 		of_root = unittest_data_node;
1474 		for_each_of_allnodes(np)
1475 			__of_attach_node_sysfs(np);
1476 		of_aliases = of_find_node_by_path("/aliases");
1477 		of_chosen = of_find_node_by_path("/chosen");
1478 		of_overlay_mutex_unlock();
1479 		return 0;
1480 	}
1481 
1482 	EXPECT_BEGIN(KERN_INFO,
1483 		     "Duplicate name in testcase-data, renamed to \"duplicate-name#1\"");
1484 
1485 	/* attach the sub-tree to live tree */
1486 	np = unittest_data_node->child;
1487 	while (np) {
1488 		struct device_node *next = np->sibling;
1489 
1490 		np->parent = of_root;
1491 		attach_node_and_children(np);
1492 		np = next;
1493 	}
1494 
1495 	EXPECT_END(KERN_INFO,
1496 		   "Duplicate name in testcase-data, renamed to \"duplicate-name#1\"");
1497 
1498 	of_overlay_mutex_unlock();
1499 
1500 	return 0;
1501 }
1502 
1503 #ifdef CONFIG_OF_OVERLAY
1504 static int __init overlay_data_apply(const char *overlay_name, int *ovcs_id);
1505 
1506 static int unittest_probe(struct platform_device *pdev)
1507 {
1508 	struct device *dev = &pdev->dev;
1509 	struct device_node *np = dev->of_node;
1510 
1511 	if (np == NULL) {
1512 		dev_err(dev, "No OF data for device\n");
1513 		return -EINVAL;
1514 
1515 	}
1516 
1517 	dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
1518 
1519 	of_platform_populate(np, NULL, NULL, &pdev->dev);
1520 
1521 	return 0;
1522 }
1523 
1524 static int unittest_remove(struct platform_device *pdev)
1525 {
1526 	struct device *dev = &pdev->dev;
1527 	struct device_node *np = dev->of_node;
1528 
1529 	dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
1530 	return 0;
1531 }
1532 
1533 static const struct of_device_id unittest_match[] = {
1534 	{ .compatible = "unittest", },
1535 	{},
1536 };
1537 
1538 static struct platform_driver unittest_driver = {
1539 	.probe			= unittest_probe,
1540 	.remove			= unittest_remove,
1541 	.driver = {
1542 		.name		= "unittest",
1543 		.of_match_table	= of_match_ptr(unittest_match),
1544 	},
1545 };
1546 
1547 /* get the platform device instantiated at the path */
1548 static struct platform_device *of_path_to_platform_device(const char *path)
1549 {
1550 	struct device_node *np;
1551 	struct platform_device *pdev;
1552 
1553 	np = of_find_node_by_path(path);
1554 	if (np == NULL)
1555 		return NULL;
1556 
1557 	pdev = of_find_device_by_node(np);
1558 	of_node_put(np);
1559 
1560 	return pdev;
1561 }
1562 
1563 /* find out if a platform device exists at that path */
1564 static int of_path_platform_device_exists(const char *path)
1565 {
1566 	struct platform_device *pdev;
1567 
1568 	pdev = of_path_to_platform_device(path);
1569 	platform_device_put(pdev);
1570 	return pdev != NULL;
1571 }
1572 
1573 #ifdef CONFIG_OF_GPIO
1574 
1575 struct unittest_gpio_dev {
1576 	struct gpio_chip chip;
1577 };
1578 
1579 static int unittest_gpio_chip_request_count;
1580 static int unittest_gpio_probe_count;
1581 static int unittest_gpio_probe_pass_count;
1582 
1583 static int unittest_gpio_chip_request(struct gpio_chip *chip, unsigned int offset)
1584 {
1585 	unittest_gpio_chip_request_count++;
1586 
1587 	pr_debug("%s(): %s %d %d\n", __func__, chip->label, offset,
1588 		 unittest_gpio_chip_request_count);
1589 	return 0;
1590 }
1591 
1592 static int unittest_gpio_probe(struct platform_device *pdev)
1593 {
1594 	struct unittest_gpio_dev *devptr;
1595 	int ret;
1596 
1597 	unittest_gpio_probe_count++;
1598 
1599 	devptr = kzalloc(sizeof(*devptr), GFP_KERNEL);
1600 	if (!devptr)
1601 		return -ENOMEM;
1602 
1603 	platform_set_drvdata(pdev, devptr);
1604 
1605 	devptr->chip.of_node = pdev->dev.of_node;
1606 	devptr->chip.label = "of-unittest-gpio";
1607 	devptr->chip.base = -1; /* dynamic allocation */
1608 	devptr->chip.ngpio = 5;
1609 	devptr->chip.request = unittest_gpio_chip_request;
1610 
1611 	ret = gpiochip_add_data(&devptr->chip, NULL);
1612 
1613 	unittest(!ret,
1614 		 "gpiochip_add_data() for node @%pOF failed, ret = %d\n", devptr->chip.of_node, ret);
1615 
1616 	if (!ret)
1617 		unittest_gpio_probe_pass_count++;
1618 	return ret;
1619 }
1620 
1621 static int unittest_gpio_remove(struct platform_device *pdev)
1622 {
1623 	struct unittest_gpio_dev *gdev = platform_get_drvdata(pdev);
1624 	struct device *dev = &pdev->dev;
1625 	struct device_node *np = pdev->dev.of_node;
1626 
1627 	dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
1628 
1629 	if (!gdev)
1630 		return -EINVAL;
1631 
1632 	if (gdev->chip.base != -1)
1633 		gpiochip_remove(&gdev->chip);
1634 
1635 	platform_set_drvdata(pdev, NULL);
1636 	kfree(gdev);
1637 
1638 	return 0;
1639 }
1640 
1641 static const struct of_device_id unittest_gpio_id[] = {
1642 	{ .compatible = "unittest-gpio", },
1643 	{}
1644 };
1645 
1646 static struct platform_driver unittest_gpio_driver = {
1647 	.probe	= unittest_gpio_probe,
1648 	.remove	= unittest_gpio_remove,
1649 	.driver	= {
1650 		.name		= "unittest-gpio",
1651 		.of_match_table	= of_match_ptr(unittest_gpio_id),
1652 	},
1653 };
1654 
1655 static void __init of_unittest_overlay_gpio(void)
1656 {
1657 	int chip_request_count;
1658 	int probe_pass_count;
1659 	int ret;
1660 
1661 	/*
1662 	 * tests: apply overlays before registering driver
1663 	 * Similar to installing a driver as a module, the
1664 	 * driver is registered after applying the overlays.
1665 	 *
1666 	 * The overlays are applied by overlay_data_apply()
1667 	 * instead of of_unittest_apply_overlay() so that they
1668 	 * will not be tracked.  Thus they will not be removed
1669 	 * by of_unittest_remove_tracked_overlays().
1670 	 *
1671 	 * - apply overlay_gpio_01
1672 	 * - apply overlay_gpio_02a
1673 	 * - apply overlay_gpio_02b
1674 	 * - register driver
1675 	 *
1676 	 * register driver will result in
1677 	 *   - probe and processing gpio hog for overlay_gpio_01
1678 	 *   - probe for overlay_gpio_02a
1679 	 *   - processing gpio for overlay_gpio_02b
1680 	 */
1681 
1682 	probe_pass_count = unittest_gpio_probe_pass_count;
1683 	chip_request_count = unittest_gpio_chip_request_count;
1684 
1685 	/*
1686 	 * overlay_gpio_01 contains gpio node and child gpio hog node
1687 	 * overlay_gpio_02a contains gpio node
1688 	 * overlay_gpio_02b contains child gpio hog node
1689 	 */
1690 
1691 	unittest(overlay_data_apply("overlay_gpio_01", NULL),
1692 		 "Adding overlay 'overlay_gpio_01' failed\n");
1693 
1694 	unittest(overlay_data_apply("overlay_gpio_02a", NULL),
1695 		 "Adding overlay 'overlay_gpio_02a' failed\n");
1696 
1697 	unittest(overlay_data_apply("overlay_gpio_02b", NULL),
1698 		 "Adding overlay 'overlay_gpio_02b' failed\n");
1699 
1700 	/*
1701 	 * messages are the result of the probes, after the
1702 	 * driver is registered
1703 	 */
1704 
1705 	EXPECT_BEGIN(KERN_INFO,
1706 		     "gpio-<<int>> (line-B-input): hogged as input\n");
1707 
1708 	EXPECT_BEGIN(KERN_INFO,
1709 		     "gpio-<<int>> (line-A-input): hogged as input\n");
1710 
1711 	ret = platform_driver_register(&unittest_gpio_driver);
1712 	if (unittest(ret == 0, "could not register unittest gpio driver\n"))
1713 		return;
1714 
1715 	EXPECT_END(KERN_INFO,
1716 		   "gpio-<<int>> (line-A-input): hogged as input\n");
1717 	EXPECT_END(KERN_INFO,
1718 		   "gpio-<<int>> (line-B-input): hogged as input\n");
1719 
1720 	unittest(probe_pass_count + 2 == unittest_gpio_probe_pass_count,
1721 		 "unittest_gpio_probe() failed or not called\n");
1722 
1723 	unittest(chip_request_count + 2 == unittest_gpio_chip_request_count,
1724 		 "unittest_gpio_chip_request() called %d times (expected 1 time)\n",
1725 		 unittest_gpio_chip_request_count - chip_request_count);
1726 
1727 	/*
1728 	 * tests: apply overlays after registering driver
1729 	 *
1730 	 * Similar to a driver built-in to the kernel, the
1731 	 * driver is registered before applying the overlays.
1732 	 *
1733 	 * overlay_gpio_03 contains gpio node and child gpio hog node
1734 	 *
1735 	 * - apply overlay_gpio_03
1736 	 *
1737 	 * apply overlay will result in
1738 	 *   - probe and processing gpio hog.
1739 	 */
1740 
1741 	probe_pass_count = unittest_gpio_probe_pass_count;
1742 	chip_request_count = unittest_gpio_chip_request_count;
1743 
1744 	EXPECT_BEGIN(KERN_INFO,
1745 		     "gpio-<<int>> (line-D-input): hogged as input\n");
1746 
1747 	/* overlay_gpio_03 contains gpio node and child gpio hog node */
1748 
1749 	unittest(overlay_data_apply("overlay_gpio_03", NULL),
1750 		 "Adding overlay 'overlay_gpio_03' failed\n");
1751 
1752 	EXPECT_END(KERN_INFO,
1753 		   "gpio-<<int>> (line-D-input): hogged as input\n");
1754 
1755 	unittest(probe_pass_count + 1 == unittest_gpio_probe_pass_count,
1756 		 "unittest_gpio_probe() failed or not called\n");
1757 
1758 	unittest(chip_request_count + 1 == unittest_gpio_chip_request_count,
1759 		 "unittest_gpio_chip_request() called %d times (expected 1 time)\n",
1760 		 unittest_gpio_chip_request_count - chip_request_count);
1761 
1762 	/*
1763 	 * overlay_gpio_04a contains gpio node
1764 	 *
1765 	 * - apply overlay_gpio_04a
1766 	 *
1767 	 * apply the overlay will result in
1768 	 *   - probe for overlay_gpio_04a
1769 	 */
1770 
1771 	probe_pass_count = unittest_gpio_probe_pass_count;
1772 	chip_request_count = unittest_gpio_chip_request_count;
1773 
1774 	/* overlay_gpio_04a contains gpio node */
1775 
1776 	unittest(overlay_data_apply("overlay_gpio_04a", NULL),
1777 		 "Adding overlay 'overlay_gpio_04a' failed\n");
1778 
1779 	unittest(probe_pass_count + 1 == unittest_gpio_probe_pass_count,
1780 		 "unittest_gpio_probe() failed or not called\n");
1781 
1782 	/*
1783 	 * overlay_gpio_04b contains child gpio hog node
1784 	 *
1785 	 * - apply overlay_gpio_04b
1786 	 *
1787 	 * apply the overlay will result in
1788 	 *   - processing gpio for overlay_gpio_04b
1789 	 */
1790 
1791 	EXPECT_BEGIN(KERN_INFO,
1792 		     "gpio-<<int>> (line-C-input): hogged as input\n");
1793 
1794 	/* overlay_gpio_04b contains child gpio hog node */
1795 
1796 	unittest(overlay_data_apply("overlay_gpio_04b", NULL),
1797 		 "Adding overlay 'overlay_gpio_04b' failed\n");
1798 
1799 	EXPECT_END(KERN_INFO,
1800 		   "gpio-<<int>> (line-C-input): hogged as input\n");
1801 
1802 	unittest(chip_request_count + 1 == unittest_gpio_chip_request_count,
1803 		 "unittest_gpio_chip_request() called %d times (expected 1 time)\n",
1804 		 unittest_gpio_chip_request_count - chip_request_count);
1805 }
1806 
1807 #else
1808 
1809 static void __init of_unittest_overlay_gpio(void)
1810 {
1811 	/* skip tests */
1812 }
1813 
1814 #endif
1815 
1816 #if IS_BUILTIN(CONFIG_I2C)
1817 
1818 /* get the i2c client device instantiated at the path */
1819 static struct i2c_client *of_path_to_i2c_client(const char *path)
1820 {
1821 	struct device_node *np;
1822 	struct i2c_client *client;
1823 
1824 	np = of_find_node_by_path(path);
1825 	if (np == NULL)
1826 		return NULL;
1827 
1828 	client = of_find_i2c_device_by_node(np);
1829 	of_node_put(np);
1830 
1831 	return client;
1832 }
1833 
1834 /* find out if a i2c client device exists at that path */
1835 static int of_path_i2c_client_exists(const char *path)
1836 {
1837 	struct i2c_client *client;
1838 
1839 	client = of_path_to_i2c_client(path);
1840 	if (client)
1841 		put_device(&client->dev);
1842 	return client != NULL;
1843 }
1844 #else
1845 static int of_path_i2c_client_exists(const char *path)
1846 {
1847 	return 0;
1848 }
1849 #endif
1850 
1851 enum overlay_type {
1852 	PDEV_OVERLAY,
1853 	I2C_OVERLAY
1854 };
1855 
1856 static int of_path_device_type_exists(const char *path,
1857 		enum overlay_type ovtype)
1858 {
1859 	switch (ovtype) {
1860 	case PDEV_OVERLAY:
1861 		return of_path_platform_device_exists(path);
1862 	case I2C_OVERLAY:
1863 		return of_path_i2c_client_exists(path);
1864 	}
1865 	return 0;
1866 }
1867 
1868 static const char *unittest_path(int nr, enum overlay_type ovtype)
1869 {
1870 	const char *base;
1871 	static char buf[256];
1872 
1873 	switch (ovtype) {
1874 	case PDEV_OVERLAY:
1875 		base = "/testcase-data/overlay-node/test-bus";
1876 		break;
1877 	case I2C_OVERLAY:
1878 		base = "/testcase-data/overlay-node/test-bus/i2c-test-bus";
1879 		break;
1880 	default:
1881 		buf[0] = '\0';
1882 		return buf;
1883 	}
1884 	snprintf(buf, sizeof(buf) - 1, "%s/test-unittest%d", base, nr);
1885 	buf[sizeof(buf) - 1] = '\0';
1886 	return buf;
1887 }
1888 
1889 static int of_unittest_device_exists(int unittest_nr, enum overlay_type ovtype)
1890 {
1891 	const char *path;
1892 
1893 	path = unittest_path(unittest_nr, ovtype);
1894 
1895 	switch (ovtype) {
1896 	case PDEV_OVERLAY:
1897 		return of_path_platform_device_exists(path);
1898 	case I2C_OVERLAY:
1899 		return of_path_i2c_client_exists(path);
1900 	}
1901 	return 0;
1902 }
1903 
1904 static const char *overlay_name_from_nr(int nr)
1905 {
1906 	static char buf[256];
1907 
1908 	snprintf(buf, sizeof(buf) - 1,
1909 		"overlay_%d", nr);
1910 	buf[sizeof(buf) - 1] = '\0';
1911 
1912 	return buf;
1913 }
1914 
1915 static const char *bus_path = "/testcase-data/overlay-node/test-bus";
1916 
1917 #define MAX_TRACK_OVCS_IDS 256
1918 
1919 static int track_ovcs_id[MAX_TRACK_OVCS_IDS];
1920 static int track_ovcs_id_overlay_nr[MAX_TRACK_OVCS_IDS];
1921 static int track_ovcs_id_cnt;
1922 
1923 static void of_unittest_track_overlay(int ovcs_id, int overlay_nr)
1924 {
1925 	if (WARN_ON(track_ovcs_id_cnt >= MAX_TRACK_OVCS_IDS))
1926 		return;
1927 
1928 	track_ovcs_id[track_ovcs_id_cnt] = ovcs_id;
1929 	track_ovcs_id_overlay_nr[track_ovcs_id_cnt] = overlay_nr;
1930 	track_ovcs_id_cnt++;
1931 }
1932 
1933 static void of_unittest_untrack_overlay(int ovcs_id)
1934 {
1935 	if (WARN_ON(track_ovcs_id_cnt < 1))
1936 		return;
1937 
1938 	track_ovcs_id_cnt--;
1939 
1940 	/* If out of synch then test is broken.  Do not try to recover. */
1941 	WARN_ON(track_ovcs_id[track_ovcs_id_cnt] != ovcs_id);
1942 }
1943 
1944 static void of_unittest_remove_tracked_overlays(void)
1945 {
1946 	int ret, ovcs_id, overlay_nr, save_ovcs_id;
1947 	const char *overlay_name;
1948 
1949 	while (track_ovcs_id_cnt > 0) {
1950 
1951 		ovcs_id = track_ovcs_id[track_ovcs_id_cnt - 1];
1952 		overlay_nr = track_ovcs_id_overlay_nr[track_ovcs_id_cnt - 1];
1953 		save_ovcs_id = ovcs_id;
1954 		ret = of_overlay_remove(&ovcs_id);
1955 		if (ret == -ENODEV) {
1956 			overlay_name = overlay_name_from_nr(overlay_nr);
1957 			pr_warn("%s: of_overlay_remove() for overlay \"%s\" failed, ret = %d\n",
1958 				__func__, overlay_name, ret);
1959 		}
1960 		of_unittest_untrack_overlay(save_ovcs_id);
1961 	}
1962 
1963 }
1964 
1965 static int __init of_unittest_apply_overlay(int overlay_nr, int *ovcs_id)
1966 {
1967 	/*
1968 	 * The overlay will be tracked, thus it will be removed
1969 	 * by of_unittest_remove_tracked_overlays().
1970 	 */
1971 
1972 	const char *overlay_name;
1973 
1974 	overlay_name = overlay_name_from_nr(overlay_nr);
1975 
1976 	if (!overlay_data_apply(overlay_name, ovcs_id)) {
1977 		unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
1978 		return -EFAULT;
1979 	}
1980 	of_unittest_track_overlay(*ovcs_id, overlay_nr);
1981 
1982 	return 0;
1983 }
1984 
1985 /* apply an overlay while checking before and after states */
1986 static int __init of_unittest_apply_overlay_check(int overlay_nr,
1987 		int unittest_nr, int before, int after,
1988 		enum overlay_type ovtype)
1989 {
1990 	int ret, ovcs_id;
1991 
1992 	/* unittest device must not be in before state */
1993 	if (of_unittest_device_exists(unittest_nr, ovtype) != before) {
1994 		unittest(0, "%s with device @\"%s\" %s\n",
1995 				overlay_name_from_nr(overlay_nr),
1996 				unittest_path(unittest_nr, ovtype),
1997 				!before ? "enabled" : "disabled");
1998 		return -EINVAL;
1999 	}
2000 
2001 	ovcs_id = 0;
2002 	ret = of_unittest_apply_overlay(overlay_nr, &ovcs_id);
2003 	if (ret != 0) {
2004 		/* of_unittest_apply_overlay already called unittest() */
2005 		return ret;
2006 	}
2007 
2008 	/* unittest device must be to set to after state */
2009 	if (of_unittest_device_exists(unittest_nr, ovtype) != after) {
2010 		unittest(0, "%s failed to create @\"%s\" %s\n",
2011 				overlay_name_from_nr(overlay_nr),
2012 				unittest_path(unittest_nr, ovtype),
2013 				!after ? "enabled" : "disabled");
2014 		return -EINVAL;
2015 	}
2016 
2017 	return 0;
2018 }
2019 
2020 /* apply an overlay and then revert it while checking before, after states */
2021 static int __init of_unittest_apply_revert_overlay_check(int overlay_nr,
2022 		int unittest_nr, int before, int after,
2023 		enum overlay_type ovtype)
2024 {
2025 	int ret, ovcs_id, save_ovcs_id;
2026 
2027 	/* unittest device must be in before state */
2028 	if (of_unittest_device_exists(unittest_nr, ovtype) != before) {
2029 		unittest(0, "%s with device @\"%s\" %s\n",
2030 				overlay_name_from_nr(overlay_nr),
2031 				unittest_path(unittest_nr, ovtype),
2032 				!before ? "enabled" : "disabled");
2033 		return -EINVAL;
2034 	}
2035 
2036 	/* apply the overlay */
2037 	ovcs_id = 0;
2038 	ret = of_unittest_apply_overlay(overlay_nr, &ovcs_id);
2039 	if (ret != 0) {
2040 		/* of_unittest_apply_overlay already called unittest() */
2041 		return ret;
2042 	}
2043 
2044 	/* unittest device must be in after state */
2045 	if (of_unittest_device_exists(unittest_nr, ovtype) != after) {
2046 		unittest(0, "%s failed to create @\"%s\" %s\n",
2047 				overlay_name_from_nr(overlay_nr),
2048 				unittest_path(unittest_nr, ovtype),
2049 				!after ? "enabled" : "disabled");
2050 		return -EINVAL;
2051 	}
2052 
2053 	save_ovcs_id = ovcs_id;
2054 	ret = of_overlay_remove(&ovcs_id);
2055 	if (ret != 0) {
2056 		unittest(0, "%s failed to be destroyed @\"%s\"\n",
2057 				overlay_name_from_nr(overlay_nr),
2058 				unittest_path(unittest_nr, ovtype));
2059 		return ret;
2060 	}
2061 	of_unittest_untrack_overlay(save_ovcs_id);
2062 
2063 	/* unittest device must be again in before state */
2064 	if (of_unittest_device_exists(unittest_nr, PDEV_OVERLAY) != before) {
2065 		unittest(0, "%s with device @\"%s\" %s\n",
2066 				overlay_name_from_nr(overlay_nr),
2067 				unittest_path(unittest_nr, ovtype),
2068 				!before ? "enabled" : "disabled");
2069 		return -EINVAL;
2070 	}
2071 
2072 	return 0;
2073 }
2074 
2075 /* test activation of device */
2076 static void __init of_unittest_overlay_0(void)
2077 {
2078 	int ret;
2079 
2080 	EXPECT_BEGIN(KERN_INFO,
2081 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest0/status");
2082 
2083 	/* device should enable */
2084 	ret = of_unittest_apply_overlay_check(0, 0, 0, 1, PDEV_OVERLAY);
2085 
2086 	EXPECT_END(KERN_INFO,
2087 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest0/status");
2088 
2089 	if (ret)
2090 		return;
2091 
2092 	unittest(1, "overlay test %d passed\n", 0);
2093 }
2094 
2095 /* test deactivation of device */
2096 static void __init of_unittest_overlay_1(void)
2097 {
2098 	int ret;
2099 
2100 	EXPECT_BEGIN(KERN_INFO,
2101 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest1/status");
2102 
2103 	/* device should disable */
2104 	ret = of_unittest_apply_overlay_check(1, 1, 1, 0, PDEV_OVERLAY);
2105 
2106 	EXPECT_END(KERN_INFO,
2107 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest1/status");
2108 
2109 	if (ret)
2110 		return;
2111 
2112 	unittest(1, "overlay test %d passed\n", 1);
2113 
2114 }
2115 
2116 /* test activation of device */
2117 static void __init of_unittest_overlay_2(void)
2118 {
2119 	int ret;
2120 
2121 	EXPECT_BEGIN(KERN_INFO,
2122 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest2/status");
2123 
2124 	/* device should enable */
2125 	ret = of_unittest_apply_overlay_check(2, 2, 0, 1, PDEV_OVERLAY);
2126 
2127 	EXPECT_END(KERN_INFO,
2128 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest2/status");
2129 
2130 	if (ret)
2131 		return;
2132 	unittest(1, "overlay test %d passed\n", 2);
2133 }
2134 
2135 /* test deactivation of device */
2136 static void __init of_unittest_overlay_3(void)
2137 {
2138 	int ret;
2139 
2140 	EXPECT_BEGIN(KERN_INFO,
2141 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest3/status");
2142 
2143 	/* device should disable */
2144 	ret = of_unittest_apply_overlay_check(3, 3, 1, 0, PDEV_OVERLAY);
2145 
2146 	EXPECT_END(KERN_INFO,
2147 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest3/status");
2148 
2149 	if (ret)
2150 		return;
2151 
2152 	unittest(1, "overlay test %d passed\n", 3);
2153 }
2154 
2155 /* test activation of a full device node */
2156 static void __init of_unittest_overlay_4(void)
2157 {
2158 	/* device should disable */
2159 	if (of_unittest_apply_overlay_check(4, 4, 0, 1, PDEV_OVERLAY))
2160 		return;
2161 
2162 	unittest(1, "overlay test %d passed\n", 4);
2163 }
2164 
2165 /* test overlay apply/revert sequence */
2166 static void __init of_unittest_overlay_5(void)
2167 {
2168 	int ret;
2169 
2170 	EXPECT_BEGIN(KERN_INFO,
2171 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest5/status");
2172 
2173 	/* device should disable */
2174 	ret = of_unittest_apply_revert_overlay_check(5, 5, 0, 1, PDEV_OVERLAY);
2175 
2176 	EXPECT_END(KERN_INFO,
2177 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest5/status");
2178 
2179 	if (ret)
2180 		return;
2181 
2182 	unittest(1, "overlay test %d passed\n", 5);
2183 }
2184 
2185 /* test overlay application in sequence */
2186 static void __init of_unittest_overlay_6(void)
2187 {
2188 	int i, save_ovcs_id[2], ovcs_id;
2189 	int overlay_nr = 6, unittest_nr = 6;
2190 	int before = 0, after = 1;
2191 	const char *overlay_name;
2192 
2193 	int ret;
2194 
2195 	/* unittest device must be in before state */
2196 	for (i = 0; i < 2; i++) {
2197 		if (of_unittest_device_exists(unittest_nr + i, PDEV_OVERLAY)
2198 				!= before) {
2199 			unittest(0, "%s with device @\"%s\" %s\n",
2200 					overlay_name_from_nr(overlay_nr + i),
2201 					unittest_path(unittest_nr + i,
2202 						PDEV_OVERLAY),
2203 					!before ? "enabled" : "disabled");
2204 			return;
2205 		}
2206 	}
2207 
2208 	/* apply the overlays */
2209 
2210 	EXPECT_BEGIN(KERN_INFO,
2211 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest6/status");
2212 
2213 	overlay_name = overlay_name_from_nr(overlay_nr + 0);
2214 
2215 	ret = overlay_data_apply(overlay_name, &ovcs_id);
2216 
2217 	if (!ret) {
2218 		unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
2219 			return;
2220 	}
2221 	save_ovcs_id[0] = ovcs_id;
2222 	of_unittest_track_overlay(ovcs_id, overlay_nr + 0);
2223 
2224 	EXPECT_END(KERN_INFO,
2225 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest6/status");
2226 
2227 	EXPECT_BEGIN(KERN_INFO,
2228 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest7/status");
2229 
2230 	overlay_name = overlay_name_from_nr(overlay_nr + 1);
2231 
2232 	ret = overlay_data_apply(overlay_name, &ovcs_id);
2233 
2234 	if (!ret) {
2235 		unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
2236 			return;
2237 	}
2238 	save_ovcs_id[1] = ovcs_id;
2239 	of_unittest_track_overlay(ovcs_id, overlay_nr + 1);
2240 
2241 	EXPECT_END(KERN_INFO,
2242 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest7/status");
2243 
2244 
2245 	for (i = 0; i < 2; i++) {
2246 		/* unittest device must be in after state */
2247 		if (of_unittest_device_exists(unittest_nr + i, PDEV_OVERLAY)
2248 				!= after) {
2249 			unittest(0, "overlay @\"%s\" failed @\"%s\" %s\n",
2250 					overlay_name_from_nr(overlay_nr + i),
2251 					unittest_path(unittest_nr + i,
2252 						PDEV_OVERLAY),
2253 					!after ? "enabled" : "disabled");
2254 			return;
2255 		}
2256 	}
2257 
2258 	for (i = 1; i >= 0; i--) {
2259 		ovcs_id = save_ovcs_id[i];
2260 		if (of_overlay_remove(&ovcs_id)) {
2261 			unittest(0, "%s failed destroy @\"%s\"\n",
2262 					overlay_name_from_nr(overlay_nr + i),
2263 					unittest_path(unittest_nr + i,
2264 						PDEV_OVERLAY));
2265 			return;
2266 		}
2267 		of_unittest_untrack_overlay(save_ovcs_id[i]);
2268 	}
2269 
2270 	for (i = 0; i < 2; i++) {
2271 		/* unittest device must be again in before state */
2272 		if (of_unittest_device_exists(unittest_nr + i, PDEV_OVERLAY)
2273 				!= before) {
2274 			unittest(0, "%s with device @\"%s\" %s\n",
2275 					overlay_name_from_nr(overlay_nr + i),
2276 					unittest_path(unittest_nr + i,
2277 						PDEV_OVERLAY),
2278 					!before ? "enabled" : "disabled");
2279 			return;
2280 		}
2281 	}
2282 
2283 	unittest(1, "overlay test %d passed\n", 6);
2284 
2285 }
2286 
2287 /* test overlay application in sequence */
2288 static void __init of_unittest_overlay_8(void)
2289 {
2290 	int i, save_ovcs_id[2], ovcs_id;
2291 	int overlay_nr = 8, unittest_nr = 8;
2292 	const char *overlay_name;
2293 	int ret;
2294 
2295 	/* we don't care about device state in this test */
2296 
2297 	EXPECT_BEGIN(KERN_INFO,
2298 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest8/status");
2299 
2300 	overlay_name = overlay_name_from_nr(overlay_nr + 0);
2301 
2302 	ret = overlay_data_apply(overlay_name, &ovcs_id);
2303 	if (!ret)
2304 		unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
2305 
2306 	EXPECT_END(KERN_INFO,
2307 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest8/status");
2308 
2309 	if (!ret)
2310 		return;
2311 
2312 	save_ovcs_id[0] = ovcs_id;
2313 	of_unittest_track_overlay(ovcs_id, overlay_nr + 0);
2314 
2315 	overlay_name = overlay_name_from_nr(overlay_nr + 1);
2316 
2317 	EXPECT_BEGIN(KERN_INFO,
2318 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest8/property-foo");
2319 
2320 	/* apply the overlays */
2321 	ret = overlay_data_apply(overlay_name, &ovcs_id);
2322 
2323 	EXPECT_END(KERN_INFO,
2324 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest8/property-foo");
2325 
2326 	if (!ret) {
2327 		unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
2328 		return;
2329 	}
2330 
2331 	save_ovcs_id[1] = ovcs_id;
2332 	of_unittest_track_overlay(ovcs_id, overlay_nr + 1);
2333 
2334 	/* now try to remove first overlay (it should fail) */
2335 	ovcs_id = save_ovcs_id[0];
2336 
2337 	EXPECT_BEGIN(KERN_INFO,
2338 		     "OF: overlay: node_overlaps_later_cs: #6 overlaps with #7 @/testcase-data/overlay-node/test-bus/test-unittest8");
2339 
2340 	EXPECT_BEGIN(KERN_INFO,
2341 		     "OF: overlay: overlay #6 is not topmost");
2342 
2343 	ret = of_overlay_remove(&ovcs_id);
2344 
2345 	EXPECT_END(KERN_INFO,
2346 		   "OF: overlay: overlay #6 is not topmost");
2347 
2348 	EXPECT_END(KERN_INFO,
2349 		   "OF: overlay: node_overlaps_later_cs: #6 overlaps with #7 @/testcase-data/overlay-node/test-bus/test-unittest8");
2350 
2351 	if (!ret) {
2352 		/*
2353 		 * Should never get here.  If we do, expect a lot of
2354 		 * subsequent tracking and overlay removal related errors.
2355 		 */
2356 		unittest(0, "%s was destroyed @\"%s\"\n",
2357 				overlay_name_from_nr(overlay_nr + 0),
2358 				unittest_path(unittest_nr,
2359 					PDEV_OVERLAY));
2360 		return;
2361 	}
2362 
2363 	/* removing them in order should work */
2364 	for (i = 1; i >= 0; i--) {
2365 		ovcs_id = save_ovcs_id[i];
2366 		if (of_overlay_remove(&ovcs_id)) {
2367 			unittest(0, "%s not destroyed @\"%s\"\n",
2368 					overlay_name_from_nr(overlay_nr + i),
2369 					unittest_path(unittest_nr,
2370 						PDEV_OVERLAY));
2371 			return;
2372 		}
2373 		of_unittest_untrack_overlay(save_ovcs_id[i]);
2374 	}
2375 
2376 	unittest(1, "overlay test %d passed\n", 8);
2377 }
2378 
2379 /* test insertion of a bus with parent devices */
2380 static void __init of_unittest_overlay_10(void)
2381 {
2382 	int ret;
2383 	char *child_path;
2384 
2385 	/* device should disable */
2386 	ret = of_unittest_apply_overlay_check(10, 10, 0, 1, PDEV_OVERLAY);
2387 
2388 	if (unittest(ret == 0,
2389 			"overlay test %d failed; overlay application\n", 10))
2390 		return;
2391 
2392 	child_path = kasprintf(GFP_KERNEL, "%s/test-unittest101",
2393 			unittest_path(10, PDEV_OVERLAY));
2394 	if (unittest(child_path, "overlay test %d failed; kasprintf\n", 10))
2395 		return;
2396 
2397 	ret = of_path_device_type_exists(child_path, PDEV_OVERLAY);
2398 	kfree(child_path);
2399 
2400 	unittest(ret, "overlay test %d failed; no child device\n", 10);
2401 }
2402 
2403 /* test insertion of a bus with parent devices (and revert) */
2404 static void __init of_unittest_overlay_11(void)
2405 {
2406 	int ret;
2407 
2408 	/* device should disable */
2409 	ret = of_unittest_apply_revert_overlay_check(11, 11, 0, 1,
2410 			PDEV_OVERLAY);
2411 
2412 	unittest(ret == 0, "overlay test %d failed; overlay apply\n", 11);
2413 }
2414 
2415 #if IS_BUILTIN(CONFIG_I2C) && IS_ENABLED(CONFIG_OF_OVERLAY)
2416 
2417 struct unittest_i2c_bus_data {
2418 	struct platform_device	*pdev;
2419 	struct i2c_adapter	adap;
2420 };
2421 
2422 static int unittest_i2c_master_xfer(struct i2c_adapter *adap,
2423 		struct i2c_msg *msgs, int num)
2424 {
2425 	struct unittest_i2c_bus_data *std = i2c_get_adapdata(adap);
2426 
2427 	(void)std;
2428 
2429 	return num;
2430 }
2431 
2432 static u32 unittest_i2c_functionality(struct i2c_adapter *adap)
2433 {
2434 	return I2C_FUNC_I2C | I2C_FUNC_SMBUS_EMUL;
2435 }
2436 
2437 static const struct i2c_algorithm unittest_i2c_algo = {
2438 	.master_xfer	= unittest_i2c_master_xfer,
2439 	.functionality	= unittest_i2c_functionality,
2440 };
2441 
2442 static int unittest_i2c_bus_probe(struct platform_device *pdev)
2443 {
2444 	struct device *dev = &pdev->dev;
2445 	struct device_node *np = dev->of_node;
2446 	struct unittest_i2c_bus_data *std;
2447 	struct i2c_adapter *adap;
2448 	int ret;
2449 
2450 	if (np == NULL) {
2451 		dev_err(dev, "No OF data for device\n");
2452 		return -EINVAL;
2453 
2454 	}
2455 
2456 	dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2457 
2458 	std = devm_kzalloc(dev, sizeof(*std), GFP_KERNEL);
2459 	if (!std)
2460 		return -ENOMEM;
2461 
2462 	/* link them together */
2463 	std->pdev = pdev;
2464 	platform_set_drvdata(pdev, std);
2465 
2466 	adap = &std->adap;
2467 	i2c_set_adapdata(adap, std);
2468 	adap->nr = -1;
2469 	strlcpy(adap->name, pdev->name, sizeof(adap->name));
2470 	adap->class = I2C_CLASS_DEPRECATED;
2471 	adap->algo = &unittest_i2c_algo;
2472 	adap->dev.parent = dev;
2473 	adap->dev.of_node = dev->of_node;
2474 	adap->timeout = 5 * HZ;
2475 	adap->retries = 3;
2476 
2477 	ret = i2c_add_numbered_adapter(adap);
2478 	if (ret != 0) {
2479 		dev_err(dev, "Failed to add I2C adapter\n");
2480 		return ret;
2481 	}
2482 
2483 	return 0;
2484 }
2485 
2486 static int unittest_i2c_bus_remove(struct platform_device *pdev)
2487 {
2488 	struct device *dev = &pdev->dev;
2489 	struct device_node *np = dev->of_node;
2490 	struct unittest_i2c_bus_data *std = platform_get_drvdata(pdev);
2491 
2492 	dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2493 	i2c_del_adapter(&std->adap);
2494 
2495 	return 0;
2496 }
2497 
2498 static const struct of_device_id unittest_i2c_bus_match[] = {
2499 	{ .compatible = "unittest-i2c-bus", },
2500 	{},
2501 };
2502 
2503 static struct platform_driver unittest_i2c_bus_driver = {
2504 	.probe			= unittest_i2c_bus_probe,
2505 	.remove			= unittest_i2c_bus_remove,
2506 	.driver = {
2507 		.name		= "unittest-i2c-bus",
2508 		.of_match_table	= of_match_ptr(unittest_i2c_bus_match),
2509 	},
2510 };
2511 
2512 static int unittest_i2c_dev_probe(struct i2c_client *client,
2513 		const struct i2c_device_id *id)
2514 {
2515 	struct device *dev = &client->dev;
2516 	struct device_node *np = client->dev.of_node;
2517 
2518 	if (!np) {
2519 		dev_err(dev, "No OF node\n");
2520 		return -EINVAL;
2521 	}
2522 
2523 	dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2524 
2525 	return 0;
2526 };
2527 
2528 static int unittest_i2c_dev_remove(struct i2c_client *client)
2529 {
2530 	struct device *dev = &client->dev;
2531 	struct device_node *np = client->dev.of_node;
2532 
2533 	dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2534 	return 0;
2535 }
2536 
2537 static const struct i2c_device_id unittest_i2c_dev_id[] = {
2538 	{ .name = "unittest-i2c-dev" },
2539 	{ }
2540 };
2541 
2542 static struct i2c_driver unittest_i2c_dev_driver = {
2543 	.driver = {
2544 		.name = "unittest-i2c-dev",
2545 	},
2546 	.probe = unittest_i2c_dev_probe,
2547 	.remove = unittest_i2c_dev_remove,
2548 	.id_table = unittest_i2c_dev_id,
2549 };
2550 
2551 #if IS_BUILTIN(CONFIG_I2C_MUX)
2552 
2553 static int unittest_i2c_mux_select_chan(struct i2c_mux_core *muxc, u32 chan)
2554 {
2555 	return 0;
2556 }
2557 
2558 static int unittest_i2c_mux_probe(struct i2c_client *client,
2559 		const struct i2c_device_id *id)
2560 {
2561 	int i, nchans;
2562 	struct device *dev = &client->dev;
2563 	struct i2c_adapter *adap = client->adapter;
2564 	struct device_node *np = client->dev.of_node, *child;
2565 	struct i2c_mux_core *muxc;
2566 	u32 reg, max_reg;
2567 
2568 	dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2569 
2570 	if (!np) {
2571 		dev_err(dev, "No OF node\n");
2572 		return -EINVAL;
2573 	}
2574 
2575 	max_reg = (u32)-1;
2576 	for_each_child_of_node(np, child) {
2577 		if (of_property_read_u32(child, "reg", &reg))
2578 			continue;
2579 		if (max_reg == (u32)-1 || reg > max_reg)
2580 			max_reg = reg;
2581 	}
2582 	nchans = max_reg == (u32)-1 ? 0 : max_reg + 1;
2583 	if (nchans == 0) {
2584 		dev_err(dev, "No channels\n");
2585 		return -EINVAL;
2586 	}
2587 
2588 	muxc = i2c_mux_alloc(adap, dev, nchans, 0, 0,
2589 			     unittest_i2c_mux_select_chan, NULL);
2590 	if (!muxc)
2591 		return -ENOMEM;
2592 	for (i = 0; i < nchans; i++) {
2593 		if (i2c_mux_add_adapter(muxc, 0, i, 0)) {
2594 			dev_err(dev, "Failed to register mux #%d\n", i);
2595 			i2c_mux_del_adapters(muxc);
2596 			return -ENODEV;
2597 		}
2598 	}
2599 
2600 	i2c_set_clientdata(client, muxc);
2601 
2602 	return 0;
2603 };
2604 
2605 static int unittest_i2c_mux_remove(struct i2c_client *client)
2606 {
2607 	struct device *dev = &client->dev;
2608 	struct device_node *np = client->dev.of_node;
2609 	struct i2c_mux_core *muxc = i2c_get_clientdata(client);
2610 
2611 	dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2612 	i2c_mux_del_adapters(muxc);
2613 	return 0;
2614 }
2615 
2616 static const struct i2c_device_id unittest_i2c_mux_id[] = {
2617 	{ .name = "unittest-i2c-mux" },
2618 	{ }
2619 };
2620 
2621 static struct i2c_driver unittest_i2c_mux_driver = {
2622 	.driver = {
2623 		.name = "unittest-i2c-mux",
2624 	},
2625 	.probe = unittest_i2c_mux_probe,
2626 	.remove = unittest_i2c_mux_remove,
2627 	.id_table = unittest_i2c_mux_id,
2628 };
2629 
2630 #endif
2631 
2632 static int of_unittest_overlay_i2c_init(void)
2633 {
2634 	int ret;
2635 
2636 	ret = i2c_add_driver(&unittest_i2c_dev_driver);
2637 	if (unittest(ret == 0,
2638 			"could not register unittest i2c device driver\n"))
2639 		return ret;
2640 
2641 	ret = platform_driver_register(&unittest_i2c_bus_driver);
2642 
2643 	if (unittest(ret == 0,
2644 			"could not register unittest i2c bus driver\n"))
2645 		return ret;
2646 
2647 #if IS_BUILTIN(CONFIG_I2C_MUX)
2648 
2649 	EXPECT_BEGIN(KERN_INFO,
2650 		     "i2c i2c-1: Added multiplexed i2c bus 2");
2651 
2652 	ret = i2c_add_driver(&unittest_i2c_mux_driver);
2653 
2654 	EXPECT_END(KERN_INFO,
2655 		   "i2c i2c-1: Added multiplexed i2c bus 2");
2656 
2657 	if (unittest(ret == 0,
2658 			"could not register unittest i2c mux driver\n"))
2659 		return ret;
2660 #endif
2661 
2662 	return 0;
2663 }
2664 
2665 static void of_unittest_overlay_i2c_cleanup(void)
2666 {
2667 #if IS_BUILTIN(CONFIG_I2C_MUX)
2668 	i2c_del_driver(&unittest_i2c_mux_driver);
2669 #endif
2670 	platform_driver_unregister(&unittest_i2c_bus_driver);
2671 	i2c_del_driver(&unittest_i2c_dev_driver);
2672 }
2673 
2674 static void __init of_unittest_overlay_i2c_12(void)
2675 {
2676 	int ret;
2677 
2678 	/* device should enable */
2679 	EXPECT_BEGIN(KERN_INFO,
2680 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/i2c-test-bus/test-unittest12/status");
2681 
2682 	ret = of_unittest_apply_overlay_check(12, 12, 0, 1, I2C_OVERLAY);
2683 
2684 	EXPECT_END(KERN_INFO,
2685 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/i2c-test-bus/test-unittest12/status");
2686 
2687 	if (ret)
2688 		return;
2689 
2690 	unittest(1, "overlay test %d passed\n", 12);
2691 }
2692 
2693 /* test deactivation of device */
2694 static void __init of_unittest_overlay_i2c_13(void)
2695 {
2696 	int ret;
2697 
2698 	EXPECT_BEGIN(KERN_INFO,
2699 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/i2c-test-bus/test-unittest13/status");
2700 
2701 	/* device should disable */
2702 	ret = of_unittest_apply_overlay_check(13, 13, 1, 0, I2C_OVERLAY);
2703 
2704 	EXPECT_END(KERN_INFO,
2705 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/i2c-test-bus/test-unittest13/status");
2706 
2707 	if (ret)
2708 		return;
2709 
2710 	unittest(1, "overlay test %d passed\n", 13);
2711 }
2712 
2713 /* just check for i2c mux existence */
2714 static void of_unittest_overlay_i2c_14(void)
2715 {
2716 }
2717 
2718 static void __init of_unittest_overlay_i2c_15(void)
2719 {
2720 	int ret;
2721 
2722 	/* device should enable */
2723 	EXPECT_BEGIN(KERN_INFO,
2724 		     "i2c i2c-1: Added multiplexed i2c bus 3");
2725 
2726 	ret = of_unittest_apply_overlay_check(15, 15, 0, 1, I2C_OVERLAY);
2727 
2728 	EXPECT_END(KERN_INFO,
2729 		   "i2c i2c-1: Added multiplexed i2c bus 3");
2730 
2731 	if (ret)
2732 		return;
2733 
2734 	unittest(1, "overlay test %d passed\n", 15);
2735 }
2736 
2737 #else
2738 
2739 static inline void of_unittest_overlay_i2c_14(void) { }
2740 static inline void of_unittest_overlay_i2c_15(void) { }
2741 
2742 #endif
2743 
2744 static int of_notify(struct notifier_block *nb, unsigned long action,
2745 		     void *arg)
2746 {
2747 	struct of_overlay_notify_data *nd = arg;
2748 	struct device_node *found;
2749 	int ret;
2750 
2751 	/*
2752 	 * For overlay_16 .. overlay_19, check that returning an error
2753 	 * works for each of the actions by setting an arbitrary return
2754 	 * error number that matches the test number.  e.g. for unittest16,
2755 	 * ret = -EBUSY which is -16.
2756 	 *
2757 	 * OVERLAY_INFO() for the overlays is declared to expect the same
2758 	 * error number, so overlay_data_apply() will return no error.
2759 	 *
2760 	 * overlay_20 will return NOTIFY_DONE
2761 	 */
2762 
2763 	ret = 0;
2764 	of_node_get(nd->overlay);
2765 
2766 	switch (action) {
2767 
2768 	case OF_OVERLAY_PRE_APPLY:
2769 		found = of_find_node_by_name(nd->overlay, "test-unittest16");
2770 		if (found) {
2771 			of_node_put(found);
2772 			ret = -EBUSY;
2773 		}
2774 		break;
2775 
2776 	case OF_OVERLAY_POST_APPLY:
2777 		found = of_find_node_by_name(nd->overlay, "test-unittest17");
2778 		if (found) {
2779 			of_node_put(found);
2780 			ret = -EEXIST;
2781 		}
2782 		break;
2783 
2784 	case OF_OVERLAY_PRE_REMOVE:
2785 		found = of_find_node_by_name(nd->overlay, "test-unittest18");
2786 		if (found) {
2787 			of_node_put(found);
2788 			ret = -EXDEV;
2789 		}
2790 		break;
2791 
2792 	case OF_OVERLAY_POST_REMOVE:
2793 		found = of_find_node_by_name(nd->overlay, "test-unittest19");
2794 		if (found) {
2795 			of_node_put(found);
2796 			ret = -ENODEV;
2797 		}
2798 		break;
2799 
2800 	default:			/* should not happen */
2801 		of_node_put(nd->overlay);
2802 		ret = -EINVAL;
2803 		break;
2804 	}
2805 
2806 	if (ret)
2807 		return notifier_from_errno(ret);
2808 
2809 	return NOTIFY_DONE;
2810 }
2811 
2812 static struct notifier_block of_nb = {
2813 	.notifier_call = of_notify,
2814 };
2815 
2816 static void __init of_unittest_overlay_notify(void)
2817 {
2818 	int ovcs_id;
2819 	int ret;
2820 
2821 	ret = of_overlay_notifier_register(&of_nb);
2822 	unittest(!ret,
2823 		 "of_overlay_notifier_register() failed, ret = %d\n", ret);
2824 	if (ret)
2825 		return;
2826 
2827 	/*
2828 	 * The overlays are applied by overlay_data_apply()
2829 	 * instead of of_unittest_apply_overlay() so that they
2830 	 * will not be tracked.  Thus they will not be removed
2831 	 * by of_unittest_remove_tracked_overlays().
2832 	 *
2833 	 * Applying overlays 16 - 19 will each trigger an error for a
2834 	 * different action in of_notify().
2835 	 *
2836 	 * Applying overlay 20 will not trigger any error in of_notify().
2837 	 */
2838 
2839 	/* ---  overlay 16  --- */
2840 
2841 	EXPECT_BEGIN(KERN_INFO, "OF: overlay: overlay changeset pre-apply notifier error -16, target: /testcase-data/overlay-node/test-bus");
2842 
2843 	unittest(overlay_data_apply("overlay_16", &ovcs_id),
2844 		 "test OF_OVERLAY_PRE_APPLY notify injected error\n");
2845 
2846 	EXPECT_END(KERN_INFO, "OF: overlay: overlay changeset pre-apply notifier error -16, target: /testcase-data/overlay-node/test-bus");
2847 
2848 	unittest(ovcs_id, "ovcs_id not created for overlay_16\n");
2849 
2850 	/* ---  overlay 17  --- */
2851 
2852 	EXPECT_BEGIN(KERN_INFO, "OF: overlay: overlay changeset post-apply notifier error -17, target: /testcase-data/overlay-node/test-bus");
2853 
2854 	unittest(overlay_data_apply("overlay_17", &ovcs_id),
2855 		 "test OF_OVERLAY_POST_APPLY notify injected error\n");
2856 
2857 	EXPECT_END(KERN_INFO, "OF: overlay: overlay changeset post-apply notifier error -17, target: /testcase-data/overlay-node/test-bus");
2858 
2859 	unittest(ovcs_id, "ovcs_id not created for overlay_17\n");
2860 
2861 	if (ovcs_id) {
2862 		ret = of_overlay_remove(&ovcs_id);
2863 		unittest(!ret,
2864 			"overlay_17 of_overlay_remove(), ret = %d\n", ret);
2865 	}
2866 
2867 	/* ---  overlay 18  --- */
2868 
2869 	unittest(overlay_data_apply("overlay_18", &ovcs_id),
2870 		 "OF_OVERLAY_PRE_REMOVE notify injected error\n");
2871 
2872 	unittest(ovcs_id, "ovcs_id not created for overlay_18\n");
2873 
2874 	if (ovcs_id) {
2875 		EXPECT_BEGIN(KERN_INFO, "OF: overlay: overlay changeset pre-remove notifier error -18, target: /testcase-data/overlay-node/test-bus");
2876 
2877 		ret = of_overlay_remove(&ovcs_id);
2878 		EXPECT_END(KERN_INFO, "OF: overlay: overlay changeset pre-remove notifier error -18, target: /testcase-data/overlay-node/test-bus");
2879 		if (ret == -EXDEV) {
2880 			/*
2881 			 * change set ovcs_id should still exist
2882 			 */
2883 			unittest(1, "overlay_18 of_overlay_remove() injected error for OF_OVERLAY_PRE_REMOVE\n");
2884 		} else {
2885 			unittest(0, "overlay_18 of_overlay_remove() injected error for OF_OVERLAY_PRE_REMOVE not returned\n");
2886 		}
2887 	} else {
2888 		unittest(1, "ovcs_id not created for overlay_18\n");
2889 	}
2890 
2891 	unittest(ovcs_id, "ovcs_id removed for overlay_18\n");
2892 
2893 	/* ---  overlay 19  --- */
2894 
2895 	unittest(overlay_data_apply("overlay_19", &ovcs_id),
2896 		 "OF_OVERLAY_POST_REMOVE notify injected error\n");
2897 
2898 	unittest(ovcs_id, "ovcs_id not created for overlay_19\n");
2899 
2900 	if (ovcs_id) {
2901 		EXPECT_BEGIN(KERN_INFO, "OF: overlay: overlay changeset post-remove notifier error -19, target: /testcase-data/overlay-node/test-bus");
2902 		ret = of_overlay_remove(&ovcs_id);
2903 		EXPECT_END(KERN_INFO, "OF: overlay: overlay changeset post-remove notifier error -19, target: /testcase-data/overlay-node/test-bus");
2904 		if (ret == -ENODEV)
2905 			unittest(1, "overlay_19 of_overlay_remove() injected error for OF_OVERLAY_POST_REMOVE\n");
2906 		else
2907 			unittest(0, "overlay_19 of_overlay_remove() injected error for OF_OVERLAY_POST_REMOVE not returned\n");
2908 	} else {
2909 		unittest(1, "ovcs_id removed for overlay_19\n");
2910 	}
2911 
2912 	unittest(!ovcs_id, "changeset ovcs_id = %d not removed for overlay_19\n",
2913 		 ovcs_id);
2914 
2915 	/* ---  overlay 20  --- */
2916 
2917 	unittest(overlay_data_apply("overlay_20", &ovcs_id),
2918 		 "overlay notify no injected error\n");
2919 
2920 	if (ovcs_id) {
2921 		ret = of_overlay_remove(&ovcs_id);
2922 		if (ret)
2923 			unittest(1, "overlay_20 failed to be destroyed, ret = %d\n",
2924 				 ret);
2925 	} else {
2926 		unittest(1, "ovcs_id not created for overlay_20\n");
2927 	}
2928 
2929 	unittest(!of_overlay_notifier_unregister(&of_nb),
2930 		 "of_overlay_notifier_unregister() failed, ret = %d\n", ret);
2931 }
2932 
2933 static void __init of_unittest_overlay(void)
2934 {
2935 	struct device_node *bus_np = NULL;
2936 
2937 	if (platform_driver_register(&unittest_driver)) {
2938 		unittest(0, "could not register unittest driver\n");
2939 		goto out;
2940 	}
2941 
2942 	bus_np = of_find_node_by_path(bus_path);
2943 	if (bus_np == NULL) {
2944 		unittest(0, "could not find bus_path \"%s\"\n", bus_path);
2945 		goto out;
2946 	}
2947 
2948 	if (of_platform_default_populate(bus_np, NULL, NULL)) {
2949 		unittest(0, "could not populate bus @ \"%s\"\n", bus_path);
2950 		goto out;
2951 	}
2952 
2953 	if (!of_unittest_device_exists(100, PDEV_OVERLAY)) {
2954 		unittest(0, "could not find unittest0 @ \"%s\"\n",
2955 				unittest_path(100, PDEV_OVERLAY));
2956 		goto out;
2957 	}
2958 
2959 	if (of_unittest_device_exists(101, PDEV_OVERLAY)) {
2960 		unittest(0, "unittest1 @ \"%s\" should not exist\n",
2961 				unittest_path(101, PDEV_OVERLAY));
2962 		goto out;
2963 	}
2964 
2965 	unittest(1, "basic infrastructure of overlays passed");
2966 
2967 	/* tests in sequence */
2968 	of_unittest_overlay_0();
2969 	of_unittest_overlay_1();
2970 	of_unittest_overlay_2();
2971 	of_unittest_overlay_3();
2972 	of_unittest_overlay_4();
2973 	of_unittest_overlay_5();
2974 	of_unittest_overlay_6();
2975 	of_unittest_overlay_8();
2976 
2977 	of_unittest_overlay_10();
2978 	of_unittest_overlay_11();
2979 
2980 #if IS_BUILTIN(CONFIG_I2C)
2981 	if (unittest(of_unittest_overlay_i2c_init() == 0, "i2c init failed\n"))
2982 		goto out;
2983 
2984 	of_unittest_overlay_i2c_12();
2985 	of_unittest_overlay_i2c_13();
2986 	of_unittest_overlay_i2c_14();
2987 	of_unittest_overlay_i2c_15();
2988 
2989 	of_unittest_overlay_i2c_cleanup();
2990 #endif
2991 
2992 	of_unittest_overlay_gpio();
2993 
2994 	of_unittest_remove_tracked_overlays();
2995 
2996 	of_unittest_overlay_notify();
2997 
2998 out:
2999 	of_node_put(bus_np);
3000 }
3001 
3002 #else
3003 static inline void __init of_unittest_overlay(void) { }
3004 #endif
3005 
3006 #ifdef CONFIG_OF_OVERLAY
3007 
3008 /*
3009  * __dtb_ot_begin[] and __dtb_ot_end[] are created by cmd_dt_S_dtb
3010  * in scripts/Makefile.lib
3011  */
3012 
3013 #define OVERLAY_INFO_EXTERN(name) \
3014 	extern uint8_t __dtb_##name##_begin[]; \
3015 	extern uint8_t __dtb_##name##_end[]
3016 
3017 #define OVERLAY_INFO(overlay_name, expected)             \
3018 {	.dtb_begin       = __dtb_##overlay_name##_begin, \
3019 	.dtb_end         = __dtb_##overlay_name##_end,   \
3020 	.expected_result = expected,                     \
3021 	.name            = #overlay_name,                \
3022 }
3023 
3024 struct overlay_info {
3025 	uint8_t		*dtb_begin;
3026 	uint8_t		*dtb_end;
3027 	int		expected_result;
3028 	int		ovcs_id;
3029 	char		*name;
3030 };
3031 
3032 OVERLAY_INFO_EXTERN(overlay_base);
3033 OVERLAY_INFO_EXTERN(overlay);
3034 OVERLAY_INFO_EXTERN(overlay_0);
3035 OVERLAY_INFO_EXTERN(overlay_1);
3036 OVERLAY_INFO_EXTERN(overlay_2);
3037 OVERLAY_INFO_EXTERN(overlay_3);
3038 OVERLAY_INFO_EXTERN(overlay_4);
3039 OVERLAY_INFO_EXTERN(overlay_5);
3040 OVERLAY_INFO_EXTERN(overlay_6);
3041 OVERLAY_INFO_EXTERN(overlay_7);
3042 OVERLAY_INFO_EXTERN(overlay_8);
3043 OVERLAY_INFO_EXTERN(overlay_9);
3044 OVERLAY_INFO_EXTERN(overlay_10);
3045 OVERLAY_INFO_EXTERN(overlay_11);
3046 OVERLAY_INFO_EXTERN(overlay_12);
3047 OVERLAY_INFO_EXTERN(overlay_13);
3048 OVERLAY_INFO_EXTERN(overlay_15);
3049 OVERLAY_INFO_EXTERN(overlay_16);
3050 OVERLAY_INFO_EXTERN(overlay_17);
3051 OVERLAY_INFO_EXTERN(overlay_18);
3052 OVERLAY_INFO_EXTERN(overlay_19);
3053 OVERLAY_INFO_EXTERN(overlay_20);
3054 OVERLAY_INFO_EXTERN(overlay_gpio_01);
3055 OVERLAY_INFO_EXTERN(overlay_gpio_02a);
3056 OVERLAY_INFO_EXTERN(overlay_gpio_02b);
3057 OVERLAY_INFO_EXTERN(overlay_gpio_03);
3058 OVERLAY_INFO_EXTERN(overlay_gpio_04a);
3059 OVERLAY_INFO_EXTERN(overlay_gpio_04b);
3060 OVERLAY_INFO_EXTERN(overlay_bad_add_dup_node);
3061 OVERLAY_INFO_EXTERN(overlay_bad_add_dup_prop);
3062 OVERLAY_INFO_EXTERN(overlay_bad_phandle);
3063 OVERLAY_INFO_EXTERN(overlay_bad_symbol);
3064 
3065 /* entries found by name */
3066 static struct overlay_info overlays[] = {
3067 	OVERLAY_INFO(overlay_base, -9999),
3068 	OVERLAY_INFO(overlay, 0),
3069 	OVERLAY_INFO(overlay_0, 0),
3070 	OVERLAY_INFO(overlay_1, 0),
3071 	OVERLAY_INFO(overlay_2, 0),
3072 	OVERLAY_INFO(overlay_3, 0),
3073 	OVERLAY_INFO(overlay_4, 0),
3074 	OVERLAY_INFO(overlay_5, 0),
3075 	OVERLAY_INFO(overlay_6, 0),
3076 	OVERLAY_INFO(overlay_7, 0),
3077 	OVERLAY_INFO(overlay_8, 0),
3078 	OVERLAY_INFO(overlay_9, 0),
3079 	OVERLAY_INFO(overlay_10, 0),
3080 	OVERLAY_INFO(overlay_11, 0),
3081 	OVERLAY_INFO(overlay_12, 0),
3082 	OVERLAY_INFO(overlay_13, 0),
3083 	OVERLAY_INFO(overlay_15, 0),
3084 	OVERLAY_INFO(overlay_16, -EBUSY),
3085 	OVERLAY_INFO(overlay_17, -EEXIST),
3086 	OVERLAY_INFO(overlay_18, 0),
3087 	OVERLAY_INFO(overlay_19, 0),
3088 	OVERLAY_INFO(overlay_20, 0),
3089 	OVERLAY_INFO(overlay_gpio_01, 0),
3090 	OVERLAY_INFO(overlay_gpio_02a, 0),
3091 	OVERLAY_INFO(overlay_gpio_02b, 0),
3092 	OVERLAY_INFO(overlay_gpio_03, 0),
3093 	OVERLAY_INFO(overlay_gpio_04a, 0),
3094 	OVERLAY_INFO(overlay_gpio_04b, 0),
3095 	OVERLAY_INFO(overlay_bad_add_dup_node, -EINVAL),
3096 	OVERLAY_INFO(overlay_bad_add_dup_prop, -EINVAL),
3097 	OVERLAY_INFO(overlay_bad_phandle, -EINVAL),
3098 	OVERLAY_INFO(overlay_bad_symbol, -EINVAL),
3099 	/* end marker */
3100 	{.dtb_begin = NULL, .dtb_end = NULL, .expected_result = 0, .name = NULL}
3101 };
3102 
3103 static struct device_node *overlay_base_root;
3104 
3105 static void * __init dt_alloc_memory(u64 size, u64 align)
3106 {
3107 	void *ptr = memblock_alloc(size, align);
3108 
3109 	if (!ptr)
3110 		panic("%s: Failed to allocate %llu bytes align=0x%llx\n",
3111 		      __func__, size, align);
3112 
3113 	return ptr;
3114 }
3115 
3116 /*
3117  * Create base device tree for the overlay unittest.
3118  *
3119  * This is called from very early boot code.
3120  *
3121  * Do as much as possible the same way as done in __unflatten_device_tree
3122  * and other early boot steps for the normal FDT so that the overlay base
3123  * unflattened tree will have the same characteristics as the real tree
3124  * (such as having memory allocated by the early allocator).  The goal
3125  * is to test "the real thing" as much as possible, and test "test setup
3126  * code" as little as possible.
3127  *
3128  * Have to stop before resolving phandles, because that uses kmalloc.
3129  */
3130 void __init unittest_unflatten_overlay_base(void)
3131 {
3132 	struct overlay_info *info;
3133 	u32 data_size;
3134 	void *new_fdt;
3135 	u32 size;
3136 	int found = 0;
3137 	const char *overlay_name = "overlay_base";
3138 
3139 	for (info = overlays; info && info->name; info++) {
3140 		if (!strcmp(overlay_name, info->name)) {
3141 			found = 1;
3142 			break;
3143 		}
3144 	}
3145 	if (!found) {
3146 		pr_err("no overlay data for %s\n", overlay_name);
3147 		return;
3148 	}
3149 
3150 	info = &overlays[0];
3151 
3152 	if (info->expected_result != -9999) {
3153 		pr_err("No dtb 'overlay_base' to attach\n");
3154 		return;
3155 	}
3156 
3157 	data_size = info->dtb_end - info->dtb_begin;
3158 	if (!data_size) {
3159 		pr_err("No dtb 'overlay_base' to attach\n");
3160 		return;
3161 	}
3162 
3163 	size = fdt_totalsize(info->dtb_begin);
3164 	if (size != data_size) {
3165 		pr_err("dtb 'overlay_base' header totalsize != actual size");
3166 		return;
3167 	}
3168 
3169 	new_fdt = dt_alloc_memory(size, roundup_pow_of_two(FDT_V17_SIZE));
3170 	if (!new_fdt) {
3171 		pr_err("alloc for dtb 'overlay_base' failed");
3172 		return;
3173 	}
3174 
3175 	memcpy(new_fdt, info->dtb_begin, size);
3176 
3177 	__unflatten_device_tree(new_fdt, NULL, &overlay_base_root,
3178 				dt_alloc_memory, true);
3179 }
3180 
3181 /*
3182  * The purpose of of_unittest_overlay_data_add is to add an
3183  * overlay in the normal fashion.  This is a test of the whole
3184  * picture, instead of testing individual elements.
3185  *
3186  * A secondary purpose is to be able to verify that the contents of
3187  * /proc/device-tree/ contains the updated structure and values from
3188  * the overlay.  That must be verified separately in user space.
3189  *
3190  * Return 0 on unexpected error.
3191  */
3192 static int __init overlay_data_apply(const char *overlay_name, int *ovcs_id)
3193 {
3194 	struct overlay_info *info;
3195 	int found = 0;
3196 	int ret;
3197 	u32 size;
3198 
3199 	for (info = overlays; info && info->name; info++) {
3200 		if (!strcmp(overlay_name, info->name)) {
3201 			found = 1;
3202 			break;
3203 		}
3204 	}
3205 	if (!found) {
3206 		pr_err("no overlay data for %s\n", overlay_name);
3207 		return 0;
3208 	}
3209 
3210 	size = info->dtb_end - info->dtb_begin;
3211 	if (!size)
3212 		pr_err("no overlay data for %s\n", overlay_name);
3213 
3214 	ret = of_overlay_fdt_apply(info->dtb_begin, size, &info->ovcs_id);
3215 	if (ovcs_id)
3216 		*ovcs_id = info->ovcs_id;
3217 	if (ret < 0)
3218 		goto out;
3219 
3220 	pr_debug("%s applied\n", overlay_name);
3221 
3222 out:
3223 	if (ret != info->expected_result)
3224 		pr_err("of_overlay_fdt_apply() expected %d, ret=%d, %s\n",
3225 		       info->expected_result, ret, overlay_name);
3226 
3227 	return (ret == info->expected_result);
3228 }
3229 
3230 /*
3231  * The purpose of of_unittest_overlay_high_level is to add an overlay
3232  * in the normal fashion.  This is a test of the whole picture,
3233  * instead of individual elements.
3234  *
3235  * The first part of the function is _not_ normal overlay usage; it is
3236  * finishing splicing the base overlay device tree into the live tree.
3237  */
3238 static __init void of_unittest_overlay_high_level(void)
3239 {
3240 	struct device_node *last_sibling;
3241 	struct device_node *np;
3242 	struct device_node *of_symbols;
3243 	struct device_node *overlay_base_symbols;
3244 	struct device_node **pprev;
3245 	struct property *prop;
3246 	int ret;
3247 
3248 	if (!overlay_base_root) {
3249 		unittest(0, "overlay_base_root not initialized\n");
3250 		return;
3251 	}
3252 
3253 	/*
3254 	 * Could not fixup phandles in unittest_unflatten_overlay_base()
3255 	 * because kmalloc() was not yet available.
3256 	 */
3257 	of_overlay_mutex_lock();
3258 	of_resolve_phandles(overlay_base_root);
3259 	of_overlay_mutex_unlock();
3260 
3261 
3262 	/*
3263 	 * do not allow overlay_base to duplicate any node already in
3264 	 * tree, this greatly simplifies the code
3265 	 */
3266 
3267 	/*
3268 	 * remove overlay_base_root node "__local_fixups", after
3269 	 * being used by of_resolve_phandles()
3270 	 */
3271 	pprev = &overlay_base_root->child;
3272 	for (np = overlay_base_root->child; np; np = np->sibling) {
3273 		if (of_node_name_eq(np, "__local_fixups__")) {
3274 			*pprev = np->sibling;
3275 			break;
3276 		}
3277 		pprev = &np->sibling;
3278 	}
3279 
3280 	/* remove overlay_base_root node "__symbols__" if in live tree */
3281 	of_symbols = of_get_child_by_name(of_root, "__symbols__");
3282 	if (of_symbols) {
3283 		/* will have to graft properties from node into live tree */
3284 		pprev = &overlay_base_root->child;
3285 		for (np = overlay_base_root->child; np; np = np->sibling) {
3286 			if (of_node_name_eq(np, "__symbols__")) {
3287 				overlay_base_symbols = np;
3288 				*pprev = np->sibling;
3289 				break;
3290 			}
3291 			pprev = &np->sibling;
3292 		}
3293 	}
3294 
3295 	for_each_child_of_node(overlay_base_root, np) {
3296 		struct device_node *base_child;
3297 		for_each_child_of_node(of_root, base_child) {
3298 			if (!strcmp(np->full_name, base_child->full_name)) {
3299 				unittest(0, "illegal node name in overlay_base %pOFn",
3300 					 np);
3301 				of_node_put(np);
3302 				of_node_put(base_child);
3303 				return;
3304 			}
3305 		}
3306 	}
3307 
3308 	/*
3309 	 * overlay 'overlay_base' is not allowed to have root
3310 	 * properties, so only need to splice nodes into main device tree.
3311 	 *
3312 	 * root node of *overlay_base_root will not be freed, it is lost
3313 	 * memory.
3314 	 */
3315 
3316 	for (np = overlay_base_root->child; np; np = np->sibling)
3317 		np->parent = of_root;
3318 
3319 	mutex_lock(&of_mutex);
3320 
3321 	for (last_sibling = np = of_root->child; np; np = np->sibling)
3322 		last_sibling = np;
3323 
3324 	if (last_sibling)
3325 		last_sibling->sibling = overlay_base_root->child;
3326 	else
3327 		of_root->child = overlay_base_root->child;
3328 
3329 	for_each_of_allnodes_from(overlay_base_root, np)
3330 		__of_attach_node_sysfs(np);
3331 
3332 	if (of_symbols) {
3333 		struct property *new_prop;
3334 		for_each_property_of_node(overlay_base_symbols, prop) {
3335 
3336 			new_prop = __of_prop_dup(prop, GFP_KERNEL);
3337 			if (!new_prop) {
3338 				unittest(0, "__of_prop_dup() of '%s' from overlay_base node __symbols__",
3339 					 prop->name);
3340 				goto err_unlock;
3341 			}
3342 			if (__of_add_property(of_symbols, new_prop)) {
3343 				kfree(new_prop->name);
3344 				kfree(new_prop->value);
3345 				kfree(new_prop);
3346 				/* "name" auto-generated by unflatten */
3347 				if (!strcmp(prop->name, "name"))
3348 					continue;
3349 				unittest(0, "duplicate property '%s' in overlay_base node __symbols__",
3350 					 prop->name);
3351 				goto err_unlock;
3352 			}
3353 			if (__of_add_property_sysfs(of_symbols, new_prop)) {
3354 				unittest(0, "unable to add property '%s' in overlay_base node __symbols__ to sysfs",
3355 					 prop->name);
3356 				goto err_unlock;
3357 			}
3358 		}
3359 	}
3360 
3361 	mutex_unlock(&of_mutex);
3362 
3363 
3364 	/* now do the normal overlay usage test */
3365 
3366 	EXPECT_BEGIN(KERN_ERR,
3367 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/substation@100/status");
3368 	EXPECT_BEGIN(KERN_ERR,
3369 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/status");
3370 	EXPECT_BEGIN(KERN_ERR,
3371 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/ride@100/track@30/incline-up");
3372 	EXPECT_BEGIN(KERN_ERR,
3373 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/ride@100/track@40/incline-up");
3374 	EXPECT_BEGIN(KERN_ERR,
3375 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/status");
3376 	EXPECT_BEGIN(KERN_ERR,
3377 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/color");
3378 	EXPECT_BEGIN(KERN_ERR,
3379 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/rate");
3380 	EXPECT_BEGIN(KERN_ERR,
3381 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/hvac_2");
3382 	EXPECT_BEGIN(KERN_ERR,
3383 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200");
3384 	EXPECT_BEGIN(KERN_ERR,
3385 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200_left");
3386 	EXPECT_BEGIN(KERN_ERR,
3387 		     "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200_right");
3388 
3389 	ret = overlay_data_apply("overlay", NULL);
3390 
3391 	EXPECT_END(KERN_ERR,
3392 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200_right");
3393 	EXPECT_END(KERN_ERR,
3394 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200_left");
3395 	EXPECT_END(KERN_ERR,
3396 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200");
3397 	EXPECT_END(KERN_ERR,
3398 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/hvac_2");
3399 	EXPECT_END(KERN_ERR,
3400 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/rate");
3401 	EXPECT_END(KERN_ERR,
3402 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/color");
3403 	EXPECT_END(KERN_ERR,
3404 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/status");
3405 	EXPECT_END(KERN_ERR,
3406 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/ride@100/track@40/incline-up");
3407 	EXPECT_END(KERN_ERR,
3408 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/ride@100/track@30/incline-up");
3409 	EXPECT_END(KERN_ERR,
3410 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/status");
3411 	EXPECT_END(KERN_ERR,
3412 		   "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/substation@100/status");
3413 
3414 	unittest(ret, "Adding overlay 'overlay' failed\n");
3415 
3416 	EXPECT_BEGIN(KERN_ERR,
3417 		     "OF: overlay: ERROR: multiple fragments add and/or delete node /testcase-data-2/substation@100/motor-1/controller");
3418 	EXPECT_BEGIN(KERN_ERR,
3419 		     "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/controller/name");
3420 
3421 	unittest(overlay_data_apply("overlay_bad_add_dup_node", NULL),
3422 		 "Adding overlay 'overlay_bad_add_dup_node' failed\n");
3423 
3424 	EXPECT_END(KERN_ERR,
3425 		   "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/controller/name");
3426 	EXPECT_END(KERN_ERR,
3427 		   "OF: overlay: ERROR: multiple fragments add and/or delete node /testcase-data-2/substation@100/motor-1/controller");
3428 
3429 	EXPECT_BEGIN(KERN_ERR,
3430 		     "OF: overlay: ERROR: multiple fragments add and/or delete node /testcase-data-2/substation@100/motor-1/electric");
3431 	EXPECT_BEGIN(KERN_ERR,
3432 		     "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/electric/rpm_avail");
3433 	EXPECT_BEGIN(KERN_ERR,
3434 		     "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/electric/name");
3435 
3436 	unittest(overlay_data_apply("overlay_bad_add_dup_prop", NULL),
3437 		 "Adding overlay 'overlay_bad_add_dup_prop' failed\n");
3438 
3439 	EXPECT_END(KERN_ERR,
3440 		     "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/electric/name");
3441 	EXPECT_END(KERN_ERR,
3442 		     "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/electric/rpm_avail");
3443 	EXPECT_END(KERN_ERR,
3444 		     "OF: overlay: ERROR: multiple fragments add and/or delete node /testcase-data-2/substation@100/motor-1/electric");
3445 
3446 	unittest(overlay_data_apply("overlay_bad_phandle", NULL),
3447 		 "Adding overlay 'overlay_bad_phandle' failed\n");
3448 
3449 	unittest(overlay_data_apply("overlay_bad_symbol", NULL),
3450 		 "Adding overlay 'overlay_bad_symbol' failed\n");
3451 
3452 	return;
3453 
3454 err_unlock:
3455 	mutex_unlock(&of_mutex);
3456 }
3457 
3458 #else
3459 
3460 static inline __init void of_unittest_overlay_high_level(void) {}
3461 
3462 #endif
3463 
3464 static int __init of_unittest(void)
3465 {
3466 	struct device_node *np;
3467 	int res;
3468 
3469 	pr_info("start of unittest - you will see error messages\n");
3470 
3471 	/* adding data for unittest */
3472 
3473 	if (IS_ENABLED(CONFIG_UML))
3474 		unittest_unflatten_overlay_base();
3475 
3476 	res = unittest_data_add();
3477 	if (res)
3478 		return res;
3479 	if (!of_aliases)
3480 		of_aliases = of_find_node_by_path("/aliases");
3481 
3482 	np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
3483 	if (!np) {
3484 		pr_info("No testcase data in device tree; not running tests\n");
3485 		return 0;
3486 	}
3487 	of_node_put(np);
3488 
3489 	of_unittest_check_tree_linkage();
3490 	of_unittest_check_phandles();
3491 	of_unittest_find_node_by_name();
3492 	of_unittest_dynamic();
3493 	of_unittest_parse_phandle_with_args();
3494 	of_unittest_parse_phandle_with_args_map();
3495 	of_unittest_printf();
3496 	of_unittest_property_string();
3497 	of_unittest_property_copy();
3498 	of_unittest_changeset();
3499 	of_unittest_parse_interrupts();
3500 	of_unittest_parse_interrupts_extended();
3501 	of_unittest_dma_get_max_cpu_address();
3502 	of_unittest_parse_dma_ranges();
3503 	of_unittest_pci_dma_ranges();
3504 	of_unittest_match_node();
3505 	of_unittest_platform_populate();
3506 	of_unittest_overlay();
3507 
3508 	/* Double check linkage after removing testcase data */
3509 	of_unittest_check_tree_linkage();
3510 
3511 	of_unittest_overlay_high_level();
3512 
3513 	pr_info("end of unittest - %i passed, %i failed\n",
3514 		unittest_results.passed, unittest_results.failed);
3515 
3516 	return 0;
3517 }
3518 late_initcall(of_unittest);
3519