Back to home page

OSCL-LXR

 
 

    


0001 // SPDX-License-Identifier: GPL-2.0
0002 /*
0003  * Self tests for device tree subsystem
0004  */
0005 
0006 #define pr_fmt(fmt) "### dt-test ### " fmt
0007 
0008 #include <linux/memblock.h>
0009 #include <linux/clk.h>
0010 #include <linux/dma-direct.h> /* to test phys_to_dma/dma_to_phys */
0011 #include <linux/err.h>
0012 #include <linux/errno.h>
0013 #include <linux/hashtable.h>
0014 #include <linux/libfdt.h>
0015 #include <linux/of.h>
0016 #include <linux/of_address.h>
0017 #include <linux/of_fdt.h>
0018 #include <linux/of_irq.h>
0019 #include <linux/of_platform.h>
0020 #include <linux/list.h>
0021 #include <linux/mutex.h>
0022 #include <linux/slab.h>
0023 #include <linux/device.h>
0024 #include <linux/platform_device.h>
0025 #include <linux/kernel.h>
0026 
0027 #include <linux/i2c.h>
0028 #include <linux/i2c-mux.h>
0029 #include <linux/gpio/driver.h>
0030 
0031 #include <linux/bitops.h>
0032 
0033 #include "of_private.h"
0034 
0035 static struct unittest_results {
0036     int passed;
0037     int failed;
0038 } unittest_results;
0039 
0040 #define unittest(result, fmt, ...) ({ \
0041     bool failed = !(result); \
0042     if (failed) { \
0043         unittest_results.failed++; \
0044         pr_err("FAIL %s():%i " fmt, __func__, __LINE__, ##__VA_ARGS__); \
0045     } else { \
0046         unittest_results.passed++; \
0047         pr_info("pass %s():%i\n", __func__, __LINE__); \
0048     } \
0049     failed; \
0050 })
0051 
0052 /*
0053  * Expected message may have a message level other than KERN_INFO.
0054  * Print the expected message only if the current loglevel will allow
0055  * the actual message to print.
0056  *
0057  * Do not use EXPECT_BEGIN() or EXPECT_END() for messages generated by
0058  * pr_debug().
0059  */
0060 #define EXPECT_BEGIN(level, fmt, ...) \
0061     printk(level pr_fmt("EXPECT \\ : ") fmt, ##__VA_ARGS__)
0062 
0063 #define EXPECT_END(level, fmt, ...) \
0064     printk(level pr_fmt("EXPECT / : ") fmt, ##__VA_ARGS__)
0065 
0066 static void __init of_unittest_find_node_by_name(void)
0067 {
0068     struct device_node *np;
0069     const char *options, *name;
0070 
0071     np = of_find_node_by_path("/testcase-data");
0072     name = kasprintf(GFP_KERNEL, "%pOF", np);
0073     unittest(np && !strcmp("/testcase-data", name),
0074         "find /testcase-data failed\n");
0075     of_node_put(np);
0076     kfree(name);
0077 
0078     /* Test if trailing '/' works */
0079     np = of_find_node_by_path("/testcase-data/");
0080     unittest(!np, "trailing '/' on /testcase-data/ should fail\n");
0081 
0082     np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
0083     name = kasprintf(GFP_KERNEL, "%pOF", np);
0084     unittest(np && !strcmp("/testcase-data/phandle-tests/consumer-a", name),
0085         "find /testcase-data/phandle-tests/consumer-a failed\n");
0086     of_node_put(np);
0087     kfree(name);
0088 
0089     np = of_find_node_by_path("testcase-alias");
0090     name = kasprintf(GFP_KERNEL, "%pOF", np);
0091     unittest(np && !strcmp("/testcase-data", name),
0092         "find testcase-alias failed\n");
0093     of_node_put(np);
0094     kfree(name);
0095 
0096     /* Test if trailing '/' works on aliases */
0097     np = of_find_node_by_path("testcase-alias/");
0098     unittest(!np, "trailing '/' on testcase-alias/ should fail\n");
0099 
0100     np = of_find_node_by_path("testcase-alias/phandle-tests/consumer-a");
0101     name = kasprintf(GFP_KERNEL, "%pOF", np);
0102     unittest(np && !strcmp("/testcase-data/phandle-tests/consumer-a", name),
0103         "find testcase-alias/phandle-tests/consumer-a failed\n");
0104     of_node_put(np);
0105     kfree(name);
0106 
0107     np = of_find_node_by_path("/testcase-data/missing-path");
0108     unittest(!np, "non-existent path returned node %pOF\n", np);
0109     of_node_put(np);
0110 
0111     np = of_find_node_by_path("missing-alias");
0112     unittest(!np, "non-existent alias returned node %pOF\n", np);
0113     of_node_put(np);
0114 
0115     np = of_find_node_by_path("testcase-alias/missing-path");
0116     unittest(!np, "non-existent alias with relative path returned node %pOF\n", np);
0117     of_node_put(np);
0118 
0119     np = of_find_node_opts_by_path("/testcase-data:testoption", &options);
0120     unittest(np && !strcmp("testoption", options),
0121          "option path test failed\n");
0122     of_node_put(np);
0123 
0124     np = of_find_node_opts_by_path("/testcase-data:test/option", &options);
0125     unittest(np && !strcmp("test/option", options),
0126          "option path test, subcase #1 failed\n");
0127     of_node_put(np);
0128 
0129     np = of_find_node_opts_by_path("/testcase-data/testcase-device1:test/option", &options);
0130     unittest(np && !strcmp("test/option", options),
0131          "option path test, subcase #2 failed\n");
0132     of_node_put(np);
0133 
0134     np = of_find_node_opts_by_path("/testcase-data:testoption", NULL);
0135     unittest(np, "NULL option path test failed\n");
0136     of_node_put(np);
0137 
0138     np = of_find_node_opts_by_path("testcase-alias:testaliasoption",
0139                        &options);
0140     unittest(np && !strcmp("testaliasoption", options),
0141          "option alias path test failed\n");
0142     of_node_put(np);
0143 
0144     np = of_find_node_opts_by_path("testcase-alias:test/alias/option",
0145                        &options);
0146     unittest(np && !strcmp("test/alias/option", options),
0147          "option alias path test, subcase #1 failed\n");
0148     of_node_put(np);
0149 
0150     np = of_find_node_opts_by_path("testcase-alias:testaliasoption", NULL);
0151     unittest(np, "NULL option alias path test failed\n");
0152     of_node_put(np);
0153 
0154     options = "testoption";
0155     np = of_find_node_opts_by_path("testcase-alias", &options);
0156     unittest(np && !options, "option clearing test failed\n");
0157     of_node_put(np);
0158 
0159     options = "testoption";
0160     np = of_find_node_opts_by_path("/", &options);
0161     unittest(np && !options, "option clearing root node test failed\n");
0162     of_node_put(np);
0163 }
0164 
0165 static void __init of_unittest_dynamic(void)
0166 {
0167     struct device_node *np;
0168     struct property *prop;
0169 
0170     np = of_find_node_by_path("/testcase-data");
0171     if (!np) {
0172         pr_err("missing testcase data\n");
0173         return;
0174     }
0175 
0176     /* Array of 4 properties for the purpose of testing */
0177     prop = kcalloc(4, sizeof(*prop), GFP_KERNEL);
0178     if (!prop) {
0179         unittest(0, "kzalloc() failed\n");
0180         return;
0181     }
0182 
0183     /* Add a new property - should pass*/
0184     prop->name = "new-property";
0185     prop->value = "new-property-data";
0186     prop->length = strlen(prop->value) + 1;
0187     unittest(of_add_property(np, prop) == 0, "Adding a new property failed\n");
0188 
0189     /* Try to add an existing property - should fail */
0190     prop++;
0191     prop->name = "new-property";
0192     prop->value = "new-property-data-should-fail";
0193     prop->length = strlen(prop->value) + 1;
0194     unittest(of_add_property(np, prop) != 0,
0195          "Adding an existing property should have failed\n");
0196 
0197     /* Try to modify an existing property - should pass */
0198     prop->value = "modify-property-data-should-pass";
0199     prop->length = strlen(prop->value) + 1;
0200     unittest(of_update_property(np, prop) == 0,
0201          "Updating an existing property should have passed\n");
0202 
0203     /* Try to modify non-existent property - should pass*/
0204     prop++;
0205     prop->name = "modify-property";
0206     prop->value = "modify-missing-property-data-should-pass";
0207     prop->length = strlen(prop->value) + 1;
0208     unittest(of_update_property(np, prop) == 0,
0209          "Updating a missing property should have passed\n");
0210 
0211     /* Remove property - should pass */
0212     unittest(of_remove_property(np, prop) == 0,
0213          "Removing a property should have passed\n");
0214 
0215     /* Adding very large property - should pass */
0216     prop++;
0217     prop->name = "large-property-PAGE_SIZEx8";
0218     prop->length = PAGE_SIZE * 8;
0219     prop->value = kzalloc(prop->length, GFP_KERNEL);
0220     unittest(prop->value != NULL, "Unable to allocate large buffer\n");
0221     if (prop->value)
0222         unittest(of_add_property(np, prop) == 0,
0223              "Adding a large property should have passed\n");
0224 }
0225 
0226 static int __init of_unittest_check_node_linkage(struct device_node *np)
0227 {
0228     struct device_node *child;
0229     int count = 0, rc;
0230 
0231     for_each_child_of_node(np, child) {
0232         if (child->parent != np) {
0233             pr_err("Child node %pOFn links to wrong parent %pOFn\n",
0234                  child, np);
0235             rc = -EINVAL;
0236             goto put_child;
0237         }
0238 
0239         rc = of_unittest_check_node_linkage(child);
0240         if (rc < 0)
0241             goto put_child;
0242         count += rc;
0243     }
0244 
0245     return count + 1;
0246 put_child:
0247     of_node_put(child);
0248     return rc;
0249 }
0250 
0251 static void __init of_unittest_check_tree_linkage(void)
0252 {
0253     struct device_node *np;
0254     int allnode_count = 0, child_count;
0255 
0256     if (!of_root)
0257         return;
0258 
0259     for_each_of_allnodes(np)
0260         allnode_count++;
0261     child_count = of_unittest_check_node_linkage(of_root);
0262 
0263     unittest(child_count > 0, "Device node data structure is corrupted\n");
0264     unittest(child_count == allnode_count,
0265          "allnodes list size (%i) doesn't match sibling lists size (%i)\n",
0266          allnode_count, child_count);
0267     pr_debug("allnodes list size (%i); sibling lists size (%i)\n", allnode_count, child_count);
0268 }
0269 
0270 static void __init of_unittest_printf_one(struct device_node *np, const char *fmt,
0271                       const char *expected)
0272 {
0273     unsigned char *buf;
0274     int buf_size;
0275     int size, i;
0276 
0277     buf_size = strlen(expected) + 10;
0278     buf = kmalloc(buf_size, GFP_KERNEL);
0279     if (!buf)
0280         return;
0281 
0282     /* Baseline; check conversion with a large size limit */
0283     memset(buf, 0xff, buf_size);
0284     size = snprintf(buf, buf_size - 2, fmt, np);
0285 
0286     /* use strcmp() instead of strncmp() here to be absolutely sure strings match */
0287     unittest((strcmp(buf, expected) == 0) && (buf[size+1] == 0xff),
0288         "sprintf failed; fmt='%s' expected='%s' rslt='%s'\n",
0289         fmt, expected, buf);
0290 
0291     /* Make sure length limits work */
0292     size++;
0293     for (i = 0; i < 2; i++, size--) {
0294         /* Clear the buffer, and make sure it works correctly still */
0295         memset(buf, 0xff, buf_size);
0296         snprintf(buf, size+1, fmt, np);
0297         unittest(strncmp(buf, expected, size) == 0 && (buf[size+1] == 0xff),
0298             "snprintf failed; size=%i fmt='%s' expected='%s' rslt='%s'\n",
0299             size, fmt, expected, buf);
0300     }
0301     kfree(buf);
0302 }
0303 
0304 static void __init of_unittest_printf(void)
0305 {
0306     struct device_node *np;
0307     const char *full_name = "/testcase-data/platform-tests/test-device@1/dev@100";
0308     char phandle_str[16] = "";
0309 
0310     np = of_find_node_by_path(full_name);
0311     if (!np) {
0312         unittest(np, "testcase data missing\n");
0313         return;
0314     }
0315 
0316     num_to_str(phandle_str, sizeof(phandle_str), np->phandle, 0);
0317 
0318     of_unittest_printf_one(np, "%pOF",  full_name);
0319     of_unittest_printf_one(np, "%pOFf", full_name);
0320     of_unittest_printf_one(np, "%pOFn", "dev");
0321     of_unittest_printf_one(np, "%2pOFn", "dev");
0322     of_unittest_printf_one(np, "%5pOFn", "  dev");
0323     of_unittest_printf_one(np, "%pOFnc", "dev:test-sub-device");
0324     of_unittest_printf_one(np, "%pOFp", phandle_str);
0325     of_unittest_printf_one(np, "%pOFP", "dev@100");
0326     of_unittest_printf_one(np, "ABC %pOFP ABC", "ABC dev@100 ABC");
0327     of_unittest_printf_one(np, "%10pOFP", "   dev@100");
0328     of_unittest_printf_one(np, "%-10pOFP", "dev@100   ");
0329     of_unittest_printf_one(of_root, "%pOFP", "/");
0330     of_unittest_printf_one(np, "%pOFF", "----");
0331     of_unittest_printf_one(np, "%pOFPF", "dev@100:----");
0332     of_unittest_printf_one(np, "%pOFPFPc", "dev@100:----:dev@100:test-sub-device");
0333     of_unittest_printf_one(np, "%pOFc", "test-sub-device");
0334     of_unittest_printf_one(np, "%pOFC",
0335             "\"test-sub-device\",\"test-compat2\",\"test-compat3\"");
0336 }
0337 
0338 struct node_hash {
0339     struct hlist_node node;
0340     struct device_node *np;
0341 };
0342 
0343 static DEFINE_HASHTABLE(phandle_ht, 8);
0344 static void __init of_unittest_check_phandles(void)
0345 {
0346     struct device_node *np;
0347     struct node_hash *nh;
0348     struct hlist_node *tmp;
0349     int i, dup_count = 0, phandle_count = 0;
0350 
0351     for_each_of_allnodes(np) {
0352         if (!np->phandle)
0353             continue;
0354 
0355         hash_for_each_possible(phandle_ht, nh, node, np->phandle) {
0356             if (nh->np->phandle == np->phandle) {
0357                 pr_info("Duplicate phandle! %i used by %pOF and %pOF\n",
0358                     np->phandle, nh->np, np);
0359                 dup_count++;
0360                 break;
0361             }
0362         }
0363 
0364         nh = kzalloc(sizeof(*nh), GFP_KERNEL);
0365         if (!nh)
0366             return;
0367 
0368         nh->np = np;
0369         hash_add(phandle_ht, &nh->node, np->phandle);
0370         phandle_count++;
0371     }
0372     unittest(dup_count == 0, "Found %i duplicates in %i phandles\n",
0373          dup_count, phandle_count);
0374 
0375     /* Clean up */
0376     hash_for_each_safe(phandle_ht, i, tmp, nh, node) {
0377         hash_del(&nh->node);
0378         kfree(nh);
0379     }
0380 }
0381 
0382 static void __init of_unittest_parse_phandle_with_args(void)
0383 {
0384     struct device_node *np;
0385     struct of_phandle_args args;
0386     int i, rc;
0387 
0388     np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
0389     if (!np) {
0390         pr_err("missing testcase data\n");
0391         return;
0392     }
0393 
0394     rc = of_count_phandle_with_args(np, "phandle-list", "#phandle-cells");
0395     unittest(rc == 7, "of_count_phandle_with_args() returned %i, expected 7\n", rc);
0396 
0397     for (i = 0; i < 8; i++) {
0398         bool passed = true;
0399 
0400         memset(&args, 0, sizeof(args));
0401         rc = of_parse_phandle_with_args(np, "phandle-list",
0402                         "#phandle-cells", i, &args);
0403 
0404         /* Test the values from tests-phandle.dtsi */
0405         switch (i) {
0406         case 0:
0407             passed &= !rc;
0408             passed &= (args.args_count == 1);
0409             passed &= (args.args[0] == (i + 1));
0410             break;
0411         case 1:
0412             passed &= !rc;
0413             passed &= (args.args_count == 2);
0414             passed &= (args.args[0] == (i + 1));
0415             passed &= (args.args[1] == 0);
0416             break;
0417         case 2:
0418             passed &= (rc == -ENOENT);
0419             break;
0420         case 3:
0421             passed &= !rc;
0422             passed &= (args.args_count == 3);
0423             passed &= (args.args[0] == (i + 1));
0424             passed &= (args.args[1] == 4);
0425             passed &= (args.args[2] == 3);
0426             break;
0427         case 4:
0428             passed &= !rc;
0429             passed &= (args.args_count == 2);
0430             passed &= (args.args[0] == (i + 1));
0431             passed &= (args.args[1] == 100);
0432             break;
0433         case 5:
0434             passed &= !rc;
0435             passed &= (args.args_count == 0);
0436             break;
0437         case 6:
0438             passed &= !rc;
0439             passed &= (args.args_count == 1);
0440             passed &= (args.args[0] == (i + 1));
0441             break;
0442         case 7:
0443             passed &= (rc == -ENOENT);
0444             break;
0445         default:
0446             passed = false;
0447         }
0448 
0449         unittest(passed, "index %i - data error on node %pOF rc=%i\n",
0450              i, args.np, rc);
0451     }
0452 
0453     /* Check for missing list property */
0454     memset(&args, 0, sizeof(args));
0455     rc = of_parse_phandle_with_args(np, "phandle-list-missing",
0456                     "#phandle-cells", 0, &args);
0457     unittest(rc == -ENOENT, "expected:%i got:%i\n", -ENOENT, rc);
0458     rc = of_count_phandle_with_args(np, "phandle-list-missing",
0459                     "#phandle-cells");
0460     unittest(rc == -ENOENT, "expected:%i got:%i\n", -ENOENT, rc);
0461 
0462     /* Check for missing cells property */
0463     memset(&args, 0, sizeof(args));
0464 
0465     EXPECT_BEGIN(KERN_INFO,
0466              "OF: /testcase-data/phandle-tests/consumer-a: could not get #phandle-cells-missing for /testcase-data/phandle-tests/provider1");
0467 
0468     rc = of_parse_phandle_with_args(np, "phandle-list",
0469                     "#phandle-cells-missing", 0, &args);
0470 
0471     EXPECT_END(KERN_INFO,
0472            "OF: /testcase-data/phandle-tests/consumer-a: could not get #phandle-cells-missing for /testcase-data/phandle-tests/provider1");
0473 
0474     unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
0475 
0476     EXPECT_BEGIN(KERN_INFO,
0477              "OF: /testcase-data/phandle-tests/consumer-a: could not get #phandle-cells-missing for /testcase-data/phandle-tests/provider1");
0478 
0479     rc = of_count_phandle_with_args(np, "phandle-list",
0480                     "#phandle-cells-missing");
0481 
0482     EXPECT_END(KERN_INFO,
0483            "OF: /testcase-data/phandle-tests/consumer-a: could not get #phandle-cells-missing for /testcase-data/phandle-tests/provider1");
0484 
0485     unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
0486 
0487     /* Check for bad phandle in list */
0488     memset(&args, 0, sizeof(args));
0489 
0490     EXPECT_BEGIN(KERN_INFO,
0491              "OF: /testcase-data/phandle-tests/consumer-a: could not find phandle");
0492 
0493     rc = of_parse_phandle_with_args(np, "phandle-list-bad-phandle",
0494                     "#phandle-cells", 0, &args);
0495 
0496     EXPECT_END(KERN_INFO,
0497            "OF: /testcase-data/phandle-tests/consumer-a: could not find phandle");
0498 
0499     unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
0500 
0501     EXPECT_BEGIN(KERN_INFO,
0502              "OF: /testcase-data/phandle-tests/consumer-a: could not find phandle");
0503 
0504     rc = of_count_phandle_with_args(np, "phandle-list-bad-phandle",
0505                     "#phandle-cells");
0506 
0507     EXPECT_END(KERN_INFO,
0508            "OF: /testcase-data/phandle-tests/consumer-a: could not find phandle");
0509 
0510     unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
0511 
0512     /* Check for incorrectly formed argument list */
0513     memset(&args, 0, sizeof(args));
0514 
0515     EXPECT_BEGIN(KERN_INFO,
0516              "OF: /testcase-data/phandle-tests/consumer-a: #phandle-cells = 3 found 1");
0517 
0518     rc = of_parse_phandle_with_args(np, "phandle-list-bad-args",
0519                     "#phandle-cells", 1, &args);
0520 
0521     EXPECT_END(KERN_INFO,
0522            "OF: /testcase-data/phandle-tests/consumer-a: #phandle-cells = 3 found 1");
0523 
0524     unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
0525 
0526     EXPECT_BEGIN(KERN_INFO,
0527              "OF: /testcase-data/phandle-tests/consumer-a: #phandle-cells = 3 found 1");
0528 
0529     rc = of_count_phandle_with_args(np, "phandle-list-bad-args",
0530                     "#phandle-cells");
0531 
0532     EXPECT_END(KERN_INFO,
0533            "OF: /testcase-data/phandle-tests/consumer-a: #phandle-cells = 3 found 1");
0534 
0535     unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
0536 }
0537 
0538 static void __init of_unittest_parse_phandle_with_args_map(void)
0539 {
0540     struct device_node *np, *p0, *p1, *p2, *p3;
0541     struct of_phandle_args args;
0542     int i, rc;
0543 
0544     np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-b");
0545     if (!np) {
0546         pr_err("missing testcase data\n");
0547         return;
0548     }
0549 
0550     p0 = of_find_node_by_path("/testcase-data/phandle-tests/provider0");
0551     if (!p0) {
0552         pr_err("missing testcase data\n");
0553         return;
0554     }
0555 
0556     p1 = of_find_node_by_path("/testcase-data/phandle-tests/provider1");
0557     if (!p1) {
0558         pr_err("missing testcase data\n");
0559         return;
0560     }
0561 
0562     p2 = of_find_node_by_path("/testcase-data/phandle-tests/provider2");
0563     if (!p2) {
0564         pr_err("missing testcase data\n");
0565         return;
0566     }
0567 
0568     p3 = of_find_node_by_path("/testcase-data/phandle-tests/provider3");
0569     if (!p3) {
0570         pr_err("missing testcase data\n");
0571         return;
0572     }
0573 
0574     rc = of_count_phandle_with_args(np, "phandle-list", "#phandle-cells");
0575     unittest(rc == 7, "of_count_phandle_with_args() returned %i, expected 7\n", rc);
0576 
0577     for (i = 0; i < 8; i++) {
0578         bool passed = true;
0579 
0580         memset(&args, 0, sizeof(args));
0581         rc = of_parse_phandle_with_args_map(np, "phandle-list",
0582                             "phandle", i, &args);
0583 
0584         /* Test the values from tests-phandle.dtsi */
0585         switch (i) {
0586         case 0:
0587             passed &= !rc;
0588             passed &= (args.np == p1);
0589             passed &= (args.args_count == 1);
0590             passed &= (args.args[0] == 1);
0591             break;
0592         case 1:
0593             passed &= !rc;
0594             passed &= (args.np == p3);
0595             passed &= (args.args_count == 3);
0596             passed &= (args.args[0] == 2);
0597             passed &= (args.args[1] == 5);
0598             passed &= (args.args[2] == 3);
0599             break;
0600         case 2:
0601             passed &= (rc == -ENOENT);
0602             break;
0603         case 3:
0604             passed &= !rc;
0605             passed &= (args.np == p0);
0606             passed &= (args.args_count == 0);
0607             break;
0608         case 4:
0609             passed &= !rc;
0610             passed &= (args.np == p1);
0611             passed &= (args.args_count == 1);
0612             passed &= (args.args[0] == 3);
0613             break;
0614         case 5:
0615             passed &= !rc;
0616             passed &= (args.np == p0);
0617             passed &= (args.args_count == 0);
0618             break;
0619         case 6:
0620             passed &= !rc;
0621             passed &= (args.np == p2);
0622             passed &= (args.args_count == 2);
0623             passed &= (args.args[0] == 15);
0624             passed &= (args.args[1] == 0x20);
0625             break;
0626         case 7:
0627             passed &= (rc == -ENOENT);
0628             break;
0629         default:
0630             passed = false;
0631         }
0632 
0633         unittest(passed, "index %i - data error on node %s rc=%i\n",
0634              i, args.np->full_name, rc);
0635     }
0636 
0637     /* Check for missing list property */
0638     memset(&args, 0, sizeof(args));
0639     rc = of_parse_phandle_with_args_map(np, "phandle-list-missing",
0640                         "phandle", 0, &args);
0641     unittest(rc == -ENOENT, "expected:%i got:%i\n", -ENOENT, rc);
0642 
0643     /* Check for missing cells,map,mask property */
0644     memset(&args, 0, sizeof(args));
0645 
0646     EXPECT_BEGIN(KERN_INFO,
0647              "OF: /testcase-data/phandle-tests/consumer-b: could not get #phandle-missing-cells for /testcase-data/phandle-tests/provider1");
0648 
0649     rc = of_parse_phandle_with_args_map(np, "phandle-list",
0650                         "phandle-missing", 0, &args);
0651     EXPECT_END(KERN_INFO,
0652            "OF: /testcase-data/phandle-tests/consumer-b: could not get #phandle-missing-cells for /testcase-data/phandle-tests/provider1");
0653 
0654     unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
0655 
0656     /* Check for bad phandle in list */
0657     memset(&args, 0, sizeof(args));
0658 
0659     EXPECT_BEGIN(KERN_INFO,
0660              "OF: /testcase-data/phandle-tests/consumer-b: could not find phandle");
0661 
0662     rc = of_parse_phandle_with_args_map(np, "phandle-list-bad-phandle",
0663                         "phandle", 0, &args);
0664     EXPECT_END(KERN_INFO,
0665            "OF: /testcase-data/phandle-tests/consumer-b: could not find phandle");
0666 
0667     unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
0668 
0669     /* Check for incorrectly formed argument list */
0670     memset(&args, 0, sizeof(args));
0671 
0672     EXPECT_BEGIN(KERN_INFO,
0673              "OF: /testcase-data/phandle-tests/consumer-b: #phandle-cells = 2 found 1");
0674 
0675     rc = of_parse_phandle_with_args_map(np, "phandle-list-bad-args",
0676                         "phandle", 1, &args);
0677     EXPECT_END(KERN_INFO,
0678            "OF: /testcase-data/phandle-tests/consumer-b: #phandle-cells = 2 found 1");
0679 
0680     unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
0681 }
0682 
0683 static void __init of_unittest_property_string(void)
0684 {
0685     const char *strings[4];
0686     struct device_node *np;
0687     int rc;
0688 
0689     np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
0690     if (!np) {
0691         pr_err("No testcase data in device tree\n");
0692         return;
0693     }
0694 
0695     rc = of_property_match_string(np, "phandle-list-names", "first");
0696     unittest(rc == 0, "first expected:0 got:%i\n", rc);
0697     rc = of_property_match_string(np, "phandle-list-names", "second");
0698     unittest(rc == 1, "second expected:1 got:%i\n", rc);
0699     rc = of_property_match_string(np, "phandle-list-names", "third");
0700     unittest(rc == 2, "third expected:2 got:%i\n", rc);
0701     rc = of_property_match_string(np, "phandle-list-names", "fourth");
0702     unittest(rc == -ENODATA, "unmatched string; rc=%i\n", rc);
0703     rc = of_property_match_string(np, "missing-property", "blah");
0704     unittest(rc == -EINVAL, "missing property; rc=%i\n", rc);
0705     rc = of_property_match_string(np, "empty-property", "blah");
0706     unittest(rc == -ENODATA, "empty property; rc=%i\n", rc);
0707     rc = of_property_match_string(np, "unterminated-string", "blah");
0708     unittest(rc == -EILSEQ, "unterminated string; rc=%i\n", rc);
0709 
0710     /* of_property_count_strings() tests */
0711     rc = of_property_count_strings(np, "string-property");
0712     unittest(rc == 1, "Incorrect string count; rc=%i\n", rc);
0713     rc = of_property_count_strings(np, "phandle-list-names");
0714     unittest(rc == 3, "Incorrect string count; rc=%i\n", rc);
0715     rc = of_property_count_strings(np, "unterminated-string");
0716     unittest(rc == -EILSEQ, "unterminated string; rc=%i\n", rc);
0717     rc = of_property_count_strings(np, "unterminated-string-list");
0718     unittest(rc == -EILSEQ, "unterminated string array; rc=%i\n", rc);
0719 
0720     /* of_property_read_string_index() tests */
0721     rc = of_property_read_string_index(np, "string-property", 0, strings);
0722     unittest(rc == 0 && !strcmp(strings[0], "foobar"), "of_property_read_string_index() failure; rc=%i\n", rc);
0723     strings[0] = NULL;
0724     rc = of_property_read_string_index(np, "string-property", 1, strings);
0725     unittest(rc == -ENODATA && strings[0] == NULL, "of_property_read_string_index() failure; rc=%i\n", rc);
0726     rc = of_property_read_string_index(np, "phandle-list-names", 0, strings);
0727     unittest(rc == 0 && !strcmp(strings[0], "first"), "of_property_read_string_index() failure; rc=%i\n", rc);
0728     rc = of_property_read_string_index(np, "phandle-list-names", 1, strings);
0729     unittest(rc == 0 && !strcmp(strings[0], "second"), "of_property_read_string_index() failure; rc=%i\n", rc);
0730     rc = of_property_read_string_index(np, "phandle-list-names", 2, strings);
0731     unittest(rc == 0 && !strcmp(strings[0], "third"), "of_property_read_string_index() failure; rc=%i\n", rc);
0732     strings[0] = NULL;
0733     rc = of_property_read_string_index(np, "phandle-list-names", 3, strings);
0734     unittest(rc == -ENODATA && strings[0] == NULL, "of_property_read_string_index() failure; rc=%i\n", rc);
0735     strings[0] = NULL;
0736     rc = of_property_read_string_index(np, "unterminated-string", 0, strings);
0737     unittest(rc == -EILSEQ && strings[0] == NULL, "of_property_read_string_index() failure; rc=%i\n", rc);
0738     rc = of_property_read_string_index(np, "unterminated-string-list", 0, strings);
0739     unittest(rc == 0 && !strcmp(strings[0], "first"), "of_property_read_string_index() failure; rc=%i\n", rc);
0740     strings[0] = NULL;
0741     rc = of_property_read_string_index(np, "unterminated-string-list", 2, strings); /* should fail */
0742     unittest(rc == -EILSEQ && strings[0] == NULL, "of_property_read_string_index() failure; rc=%i\n", rc);
0743     strings[1] = NULL;
0744 
0745     /* of_property_read_string_array() tests */
0746     rc = of_property_read_string_array(np, "string-property", strings, 4);
0747     unittest(rc == 1, "Incorrect string count; rc=%i\n", rc);
0748     rc = of_property_read_string_array(np, "phandle-list-names", strings, 4);
0749     unittest(rc == 3, "Incorrect string count; rc=%i\n", rc);
0750     rc = of_property_read_string_array(np, "unterminated-string", strings, 4);
0751     unittest(rc == -EILSEQ, "unterminated string; rc=%i\n", rc);
0752     /* -- An incorrectly formed string should cause a failure */
0753     rc = of_property_read_string_array(np, "unterminated-string-list", strings, 4);
0754     unittest(rc == -EILSEQ, "unterminated string array; rc=%i\n", rc);
0755     /* -- parsing the correctly formed strings should still work: */
0756     strings[2] = NULL;
0757     rc = of_property_read_string_array(np, "unterminated-string-list", strings, 2);
0758     unittest(rc == 2 && strings[2] == NULL, "of_property_read_string_array() failure; rc=%i\n", rc);
0759     strings[1] = NULL;
0760     rc = of_property_read_string_array(np, "phandle-list-names", strings, 1);
0761     unittest(rc == 1 && strings[1] == NULL, "Overwrote end of string array; rc=%i, str='%s'\n", rc, strings[1]);
0762 }
0763 
0764 #define propcmp(p1, p2) (((p1)->length == (p2)->length) && \
0765             (p1)->value && (p2)->value && \
0766             !memcmp((p1)->value, (p2)->value, (p1)->length) && \
0767             !strcmp((p1)->name, (p2)->name))
0768 static void __init of_unittest_property_copy(void)
0769 {
0770 #ifdef CONFIG_OF_DYNAMIC
0771     struct property p1 = { .name = "p1", .length = 0, .value = "" };
0772     struct property p2 = { .name = "p2", .length = 5, .value = "abcd" };
0773     struct property *new;
0774 
0775     new = __of_prop_dup(&p1, GFP_KERNEL);
0776     unittest(new && propcmp(&p1, new), "empty property didn't copy correctly\n");
0777     kfree(new->value);
0778     kfree(new->name);
0779     kfree(new);
0780 
0781     new = __of_prop_dup(&p2, GFP_KERNEL);
0782     unittest(new && propcmp(&p2, new), "non-empty property didn't copy correctly\n");
0783     kfree(new->value);
0784     kfree(new->name);
0785     kfree(new);
0786 #endif
0787 }
0788 
0789 static void __init of_unittest_changeset(void)
0790 {
0791 #ifdef CONFIG_OF_DYNAMIC
0792     struct property *ppadd, padd = { .name = "prop-add", .length = 1, .value = "" };
0793     struct property *ppname_n1,  pname_n1  = { .name = "name", .length = 3, .value = "n1"  };
0794     struct property *ppname_n2,  pname_n2  = { .name = "name", .length = 3, .value = "n2"  };
0795     struct property *ppname_n21, pname_n21 = { .name = "name", .length = 3, .value = "n21" };
0796     struct property *ppupdate, pupdate = { .name = "prop-update", .length = 5, .value = "abcd" };
0797     struct property *ppremove;
0798     struct device_node *n1, *n2, *n21, *nchangeset, *nremove, *parent, *np;
0799     struct of_changeset chgset;
0800 
0801     n1 = __of_node_dup(NULL, "n1");
0802     unittest(n1, "testcase setup failure\n");
0803 
0804     n2 = __of_node_dup(NULL, "n2");
0805     unittest(n2, "testcase setup failure\n");
0806 
0807     n21 = __of_node_dup(NULL, "n21");
0808     unittest(n21, "testcase setup failure %p\n", n21);
0809 
0810     nchangeset = of_find_node_by_path("/testcase-data/changeset");
0811     nremove = of_get_child_by_name(nchangeset, "node-remove");
0812     unittest(nremove, "testcase setup failure\n");
0813 
0814     ppadd = __of_prop_dup(&padd, GFP_KERNEL);
0815     unittest(ppadd, "testcase setup failure\n");
0816 
0817     ppname_n1  = __of_prop_dup(&pname_n1, GFP_KERNEL);
0818     unittest(ppname_n1, "testcase setup failure\n");
0819 
0820     ppname_n2  = __of_prop_dup(&pname_n2, GFP_KERNEL);
0821     unittest(ppname_n2, "testcase setup failure\n");
0822 
0823     ppname_n21 = __of_prop_dup(&pname_n21, GFP_KERNEL);
0824     unittest(ppname_n21, "testcase setup failure\n");
0825 
0826     ppupdate = __of_prop_dup(&pupdate, GFP_KERNEL);
0827     unittest(ppupdate, "testcase setup failure\n");
0828 
0829     parent = nchangeset;
0830     n1->parent = parent;
0831     n2->parent = parent;
0832     n21->parent = n2;
0833 
0834     ppremove = of_find_property(parent, "prop-remove", NULL);
0835     unittest(ppremove, "failed to find removal prop");
0836 
0837     of_changeset_init(&chgset);
0838 
0839     unittest(!of_changeset_attach_node(&chgset, n1), "fail attach n1\n");
0840     unittest(!of_changeset_add_property(&chgset, n1, ppname_n1), "fail add prop name\n");
0841 
0842     unittest(!of_changeset_attach_node(&chgset, n2), "fail attach n2\n");
0843     unittest(!of_changeset_add_property(&chgset, n2, ppname_n2), "fail add prop name\n");
0844 
0845     unittest(!of_changeset_detach_node(&chgset, nremove), "fail remove node\n");
0846     unittest(!of_changeset_add_property(&chgset, n21, ppname_n21), "fail add prop name\n");
0847 
0848     unittest(!of_changeset_attach_node(&chgset, n21), "fail attach n21\n");
0849 
0850     unittest(!of_changeset_add_property(&chgset, parent, ppadd), "fail add prop prop-add\n");
0851     unittest(!of_changeset_update_property(&chgset, parent, ppupdate), "fail update prop\n");
0852     unittest(!of_changeset_remove_property(&chgset, parent, ppremove), "fail remove prop\n");
0853 
0854     unittest(!of_changeset_apply(&chgset), "apply failed\n");
0855 
0856     of_node_put(nchangeset);
0857 
0858     /* Make sure node names are constructed correctly */
0859     unittest((np = of_find_node_by_path("/testcase-data/changeset/n2/n21")),
0860          "'%pOF' not added\n", n21);
0861     of_node_put(np);
0862 
0863     unittest(!of_changeset_revert(&chgset), "revert failed\n");
0864 
0865     of_changeset_destroy(&chgset);
0866 
0867     of_node_put(n1);
0868     of_node_put(n2);
0869     of_node_put(n21);
0870 #endif
0871 }
0872 
0873 static void __init of_unittest_dma_get_max_cpu_address(void)
0874 {
0875     struct device_node *np;
0876     phys_addr_t cpu_addr;
0877 
0878     if (!IS_ENABLED(CONFIG_OF_ADDRESS))
0879         return;
0880 
0881     np = of_find_node_by_path("/testcase-data/address-tests");
0882     if (!np) {
0883         pr_err("missing testcase data\n");
0884         return;
0885     }
0886 
0887     cpu_addr = of_dma_get_max_cpu_address(np);
0888     unittest(cpu_addr == 0x4fffffff,
0889          "of_dma_get_max_cpu_address: wrong CPU addr %pad (expecting %x)\n",
0890          &cpu_addr, 0x4fffffff);
0891 }
0892 
0893 static void __init of_unittest_dma_ranges_one(const char *path,
0894         u64 expect_dma_addr, u64 expect_paddr)
0895 {
0896 #ifdef CONFIG_HAS_DMA
0897     struct device_node *np;
0898     const struct bus_dma_region *map = NULL;
0899     int rc;
0900 
0901     np = of_find_node_by_path(path);
0902     if (!np) {
0903         pr_err("missing testcase data\n");
0904         return;
0905     }
0906 
0907     rc = of_dma_get_range(np, &map);
0908 
0909     unittest(!rc, "of_dma_get_range failed on node %pOF rc=%i\n", np, rc);
0910 
0911     if (!rc) {
0912         phys_addr_t paddr;
0913         dma_addr_t  dma_addr;
0914         struct device   *dev_bogus;
0915 
0916         dev_bogus = kzalloc(sizeof(struct device), GFP_KERNEL);
0917         if (!dev_bogus) {
0918             unittest(0, "kzalloc() failed\n");
0919             kfree(map);
0920             return;
0921         }
0922 
0923         dev_bogus->dma_range_map = map;
0924         paddr = dma_to_phys(dev_bogus, expect_dma_addr);
0925         dma_addr = phys_to_dma(dev_bogus, expect_paddr);
0926 
0927         unittest(paddr == expect_paddr,
0928              "of_dma_get_range: wrong phys addr %pap (expecting %llx) on node %pOF\n",
0929              &paddr, expect_paddr, np);
0930         unittest(dma_addr == expect_dma_addr,
0931              "of_dma_get_range: wrong DMA addr %pad (expecting %llx) on node %pOF\n",
0932              &dma_addr, expect_dma_addr, np);
0933 
0934         kfree(map);
0935         kfree(dev_bogus);
0936     }
0937     of_node_put(np);
0938 #endif
0939 }
0940 
0941 static void __init of_unittest_parse_dma_ranges(void)
0942 {
0943     of_unittest_dma_ranges_one("/testcase-data/address-tests/device@70000000",
0944         0x0, 0x20000000);
0945     if (IS_ENABLED(CONFIG_ARCH_DMA_ADDR_T_64BIT))
0946         of_unittest_dma_ranges_one("/testcase-data/address-tests/bus@80000000/device@1000",
0947             0x100000000, 0x20000000);
0948     of_unittest_dma_ranges_one("/testcase-data/address-tests/pci@90000000",
0949         0x80000000, 0x20000000);
0950 }
0951 
0952 static void __init of_unittest_pci_dma_ranges(void)
0953 {
0954     struct device_node *np;
0955     struct of_pci_range range;
0956     struct of_pci_range_parser parser;
0957     int i = 0;
0958 
0959     if (!IS_ENABLED(CONFIG_PCI))
0960         return;
0961 
0962     np = of_find_node_by_path("/testcase-data/address-tests/pci@90000000");
0963     if (!np) {
0964         pr_err("missing testcase data\n");
0965         return;
0966     }
0967 
0968     if (of_pci_dma_range_parser_init(&parser, np)) {
0969         pr_err("missing dma-ranges property\n");
0970         return;
0971     }
0972 
0973     /*
0974      * Get the dma-ranges from the device tree
0975      */
0976     for_each_of_pci_range(&parser, &range) {
0977         if (!i) {
0978             unittest(range.size == 0x10000000,
0979                  "for_each_of_pci_range wrong size on node %pOF size=%llx\n",
0980                  np, range.size);
0981             unittest(range.cpu_addr == 0x20000000,
0982                  "for_each_of_pci_range wrong CPU addr (%llx) on node %pOF",
0983                  range.cpu_addr, np);
0984             unittest(range.pci_addr == 0x80000000,
0985                  "for_each_of_pci_range wrong DMA addr (%llx) on node %pOF",
0986                  range.pci_addr, np);
0987         } else {
0988             unittest(range.size == 0x10000000,
0989                  "for_each_of_pci_range wrong size on node %pOF size=%llx\n",
0990                  np, range.size);
0991             unittest(range.cpu_addr == 0x40000000,
0992                  "for_each_of_pci_range wrong CPU addr (%llx) on node %pOF",
0993                  range.cpu_addr, np);
0994             unittest(range.pci_addr == 0xc0000000,
0995                  "for_each_of_pci_range wrong DMA addr (%llx) on node %pOF",
0996                  range.pci_addr, np);
0997         }
0998         i++;
0999     }
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.fwnode = dev_fwnode(&pdev->dev);
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 @%pfw failed, ret = %d\n", devptr->chip.fwnode, 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 *devptr = platform_get_drvdata(pdev);
1624     struct device *dev = &pdev->dev;
1625 
1626     dev_dbg(dev, "%s for node @%pfw\n", __func__, devptr->chip.fwnode);
1627 
1628     if (!devptr)
1629         return -EINVAL;
1630 
1631     if (devptr->chip.base != -1)
1632         gpiochip_remove(&devptr->chip);
1633 
1634     platform_set_drvdata(pdev, NULL);
1635     kfree(devptr);
1636 
1637     return 0;
1638 }
1639 
1640 static const struct of_device_id unittest_gpio_id[] = {
1641     { .compatible = "unittest-gpio", },
1642     {}
1643 };
1644 
1645 static struct platform_driver unittest_gpio_driver = {
1646     .probe  = unittest_gpio_probe,
1647     .remove = unittest_gpio_remove,
1648     .driver = {
1649         .name       = "unittest-gpio",
1650         .of_match_table = of_match_ptr(unittest_gpio_id),
1651     },
1652 };
1653 
1654 static void __init of_unittest_overlay_gpio(void)
1655 {
1656     int chip_request_count;
1657     int probe_pass_count;
1658     int ret;
1659 
1660     /*
1661      * tests: apply overlays before registering driver
1662      * Similar to installing a driver as a module, the
1663      * driver is registered after applying the overlays.
1664      *
1665      * The overlays are applied by overlay_data_apply()
1666      * instead of of_unittest_apply_overlay() so that they
1667      * will not be tracked.  Thus they will not be removed
1668      * by of_unittest_remove_tracked_overlays().
1669      *
1670      * - apply overlay_gpio_01
1671      * - apply overlay_gpio_02a
1672      * - apply overlay_gpio_02b
1673      * - register driver
1674      *
1675      * register driver will result in
1676      *   - probe and processing gpio hog for overlay_gpio_01
1677      *   - probe for overlay_gpio_02a
1678      *   - processing gpio for overlay_gpio_02b
1679      */
1680 
1681     probe_pass_count = unittest_gpio_probe_pass_count;
1682     chip_request_count = unittest_gpio_chip_request_count;
1683 
1684     /*
1685      * overlay_gpio_01 contains gpio node and child gpio hog node
1686      * overlay_gpio_02a contains gpio node
1687      * overlay_gpio_02b contains child gpio hog node
1688      */
1689 
1690     unittest(overlay_data_apply("overlay_gpio_01", NULL),
1691          "Adding overlay 'overlay_gpio_01' failed\n");
1692 
1693     unittest(overlay_data_apply("overlay_gpio_02a", NULL),
1694          "Adding overlay 'overlay_gpio_02a' failed\n");
1695 
1696     unittest(overlay_data_apply("overlay_gpio_02b", NULL),
1697          "Adding overlay 'overlay_gpio_02b' failed\n");
1698 
1699     /*
1700      * messages are the result of the probes, after the
1701      * driver is registered
1702      */
1703 
1704     EXPECT_BEGIN(KERN_INFO,
1705              "gpio-<<int>> (line-B-input): hogged as input\n");
1706 
1707     EXPECT_BEGIN(KERN_INFO,
1708              "gpio-<<int>> (line-A-input): hogged as input\n");
1709 
1710     ret = platform_driver_register(&unittest_gpio_driver);
1711     if (unittest(ret == 0, "could not register unittest gpio driver\n"))
1712         return;
1713 
1714     EXPECT_END(KERN_INFO,
1715            "gpio-<<int>> (line-A-input): hogged as input\n");
1716     EXPECT_END(KERN_INFO,
1717            "gpio-<<int>> (line-B-input): hogged as input\n");
1718 
1719     unittest(probe_pass_count + 2 == unittest_gpio_probe_pass_count,
1720          "unittest_gpio_probe() failed or not called\n");
1721 
1722     unittest(chip_request_count + 2 == unittest_gpio_chip_request_count,
1723          "unittest_gpio_chip_request() called %d times (expected 1 time)\n",
1724          unittest_gpio_chip_request_count - chip_request_count);
1725 
1726     /*
1727      * tests: apply overlays after registering driver
1728      *
1729      * Similar to a driver built-in to the kernel, the
1730      * driver is registered before applying the overlays.
1731      *
1732      * overlay_gpio_03 contains gpio node and child gpio hog node
1733      *
1734      * - apply overlay_gpio_03
1735      *
1736      * apply overlay will result in
1737      *   - probe and processing gpio hog.
1738      */
1739 
1740     probe_pass_count = unittest_gpio_probe_pass_count;
1741     chip_request_count = unittest_gpio_chip_request_count;
1742 
1743     EXPECT_BEGIN(KERN_INFO,
1744              "gpio-<<int>> (line-D-input): hogged as input\n");
1745 
1746     /* overlay_gpio_03 contains gpio node and child gpio hog node */
1747 
1748     unittest(overlay_data_apply("overlay_gpio_03", NULL),
1749          "Adding overlay 'overlay_gpio_03' failed\n");
1750 
1751     EXPECT_END(KERN_INFO,
1752            "gpio-<<int>> (line-D-input): hogged as input\n");
1753 
1754     unittest(probe_pass_count + 1 == unittest_gpio_probe_pass_count,
1755          "unittest_gpio_probe() failed or not called\n");
1756 
1757     unittest(chip_request_count + 1 == unittest_gpio_chip_request_count,
1758          "unittest_gpio_chip_request() called %d times (expected 1 time)\n",
1759          unittest_gpio_chip_request_count - chip_request_count);
1760 
1761     /*
1762      * overlay_gpio_04a contains gpio node
1763      *
1764      * - apply overlay_gpio_04a
1765      *
1766      * apply the overlay will result in
1767      *   - probe for overlay_gpio_04a
1768      */
1769 
1770     probe_pass_count = unittest_gpio_probe_pass_count;
1771     chip_request_count = unittest_gpio_chip_request_count;
1772 
1773     /* overlay_gpio_04a contains gpio node */
1774 
1775     unittest(overlay_data_apply("overlay_gpio_04a", NULL),
1776          "Adding overlay 'overlay_gpio_04a' failed\n");
1777 
1778     unittest(probe_pass_count + 1 == unittest_gpio_probe_pass_count,
1779          "unittest_gpio_probe() failed or not called\n");
1780 
1781     /*
1782      * overlay_gpio_04b contains child gpio hog node
1783      *
1784      * - apply overlay_gpio_04b
1785      *
1786      * apply the overlay will result in
1787      *   - processing gpio for overlay_gpio_04b
1788      */
1789 
1790     EXPECT_BEGIN(KERN_INFO,
1791              "gpio-<<int>> (line-C-input): hogged as input\n");
1792 
1793     /* overlay_gpio_04b contains child gpio hog node */
1794 
1795     unittest(overlay_data_apply("overlay_gpio_04b", NULL),
1796          "Adding overlay 'overlay_gpio_04b' failed\n");
1797 
1798     EXPECT_END(KERN_INFO,
1799            "gpio-<<int>> (line-C-input): hogged as input\n");
1800 
1801     unittest(chip_request_count + 1 == unittest_gpio_chip_request_count,
1802          "unittest_gpio_chip_request() called %d times (expected 1 time)\n",
1803          unittest_gpio_chip_request_count - chip_request_count);
1804 }
1805 
1806 #else
1807 
1808 static void __init of_unittest_overlay_gpio(void)
1809 {
1810     /* skip tests */
1811 }
1812 
1813 #endif
1814 
1815 #if IS_BUILTIN(CONFIG_I2C)
1816 
1817 /* get the i2c client device instantiated at the path */
1818 static struct i2c_client *of_path_to_i2c_client(const char *path)
1819 {
1820     struct device_node *np;
1821     struct i2c_client *client;
1822 
1823     np = of_find_node_by_path(path);
1824     if (np == NULL)
1825         return NULL;
1826 
1827     client = of_find_i2c_device_by_node(np);
1828     of_node_put(np);
1829 
1830     return client;
1831 }
1832 
1833 /* find out if a i2c client device exists at that path */
1834 static int of_path_i2c_client_exists(const char *path)
1835 {
1836     struct i2c_client *client;
1837 
1838     client = of_path_to_i2c_client(path);
1839     if (client)
1840         put_device(&client->dev);
1841     return client != NULL;
1842 }
1843 #else
1844 static int of_path_i2c_client_exists(const char *path)
1845 {
1846     return 0;
1847 }
1848 #endif
1849 
1850 enum overlay_type {
1851     PDEV_OVERLAY,
1852     I2C_OVERLAY
1853 };
1854 
1855 static int of_path_device_type_exists(const char *path,
1856         enum overlay_type ovtype)
1857 {
1858     switch (ovtype) {
1859     case PDEV_OVERLAY:
1860         return of_path_platform_device_exists(path);
1861     case I2C_OVERLAY:
1862         return of_path_i2c_client_exists(path);
1863     }
1864     return 0;
1865 }
1866 
1867 static const char *unittest_path(int nr, enum overlay_type ovtype)
1868 {
1869     const char *base;
1870     static char buf[256];
1871 
1872     switch (ovtype) {
1873     case PDEV_OVERLAY:
1874         base = "/testcase-data/overlay-node/test-bus";
1875         break;
1876     case I2C_OVERLAY:
1877         base = "/testcase-data/overlay-node/test-bus/i2c-test-bus";
1878         break;
1879     default:
1880         buf[0] = '\0';
1881         return buf;
1882     }
1883     snprintf(buf, sizeof(buf) - 1, "%s/test-unittest%d", base, nr);
1884     buf[sizeof(buf) - 1] = '\0';
1885     return buf;
1886 }
1887 
1888 static int of_unittest_device_exists(int unittest_nr, enum overlay_type ovtype)
1889 {
1890     const char *path;
1891 
1892     path = unittest_path(unittest_nr, ovtype);
1893 
1894     switch (ovtype) {
1895     case PDEV_OVERLAY:
1896         return of_path_platform_device_exists(path);
1897     case I2C_OVERLAY:
1898         return of_path_i2c_client_exists(path);
1899     }
1900     return 0;
1901 }
1902 
1903 static const char *overlay_name_from_nr(int nr)
1904 {
1905     static char buf[256];
1906 
1907     snprintf(buf, sizeof(buf) - 1,
1908         "overlay_%d", nr);
1909     buf[sizeof(buf) - 1] = '\0';
1910 
1911     return buf;
1912 }
1913 
1914 static const char *bus_path = "/testcase-data/overlay-node/test-bus";
1915 
1916 #define MAX_TRACK_OVCS_IDS 256
1917 
1918 static int track_ovcs_id[MAX_TRACK_OVCS_IDS];
1919 static int track_ovcs_id_overlay_nr[MAX_TRACK_OVCS_IDS];
1920 static int track_ovcs_id_cnt;
1921 
1922 static void of_unittest_track_overlay(int ovcs_id, int overlay_nr)
1923 {
1924     if (WARN_ON(track_ovcs_id_cnt >= MAX_TRACK_OVCS_IDS))
1925         return;
1926 
1927     track_ovcs_id[track_ovcs_id_cnt] = ovcs_id;
1928     track_ovcs_id_overlay_nr[track_ovcs_id_cnt] = overlay_nr;
1929     track_ovcs_id_cnt++;
1930 }
1931 
1932 static void of_unittest_untrack_overlay(int ovcs_id)
1933 {
1934     if (WARN_ON(track_ovcs_id_cnt < 1))
1935         return;
1936 
1937     track_ovcs_id_cnt--;
1938 
1939     /* If out of synch then test is broken.  Do not try to recover. */
1940     WARN_ON(track_ovcs_id[track_ovcs_id_cnt] != ovcs_id);
1941 }
1942 
1943 static void of_unittest_remove_tracked_overlays(void)
1944 {
1945     int ret, ovcs_id, overlay_nr, save_ovcs_id;
1946     const char *overlay_name;
1947 
1948     while (track_ovcs_id_cnt > 0) {
1949 
1950         ovcs_id = track_ovcs_id[track_ovcs_id_cnt - 1];
1951         overlay_nr = track_ovcs_id_overlay_nr[track_ovcs_id_cnt - 1];
1952         save_ovcs_id = ovcs_id;
1953         ret = of_overlay_remove(&ovcs_id);
1954         if (ret == -ENODEV) {
1955             overlay_name = overlay_name_from_nr(overlay_nr);
1956             pr_warn("%s: of_overlay_remove() for overlay \"%s\" failed, ret = %d\n",
1957                 __func__, overlay_name, ret);
1958         }
1959         of_unittest_untrack_overlay(save_ovcs_id);
1960     }
1961 
1962 }
1963 
1964 static int __init of_unittest_apply_overlay(int overlay_nr, int *ovcs_id)
1965 {
1966     /*
1967      * The overlay will be tracked, thus it will be removed
1968      * by of_unittest_remove_tracked_overlays().
1969      */
1970 
1971     const char *overlay_name;
1972 
1973     overlay_name = overlay_name_from_nr(overlay_nr);
1974 
1975     if (!overlay_data_apply(overlay_name, ovcs_id)) {
1976         unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
1977         return -EFAULT;
1978     }
1979     of_unittest_track_overlay(*ovcs_id, overlay_nr);
1980 
1981     return 0;
1982 }
1983 
1984 /* apply an overlay while checking before and after states */
1985 static int __init of_unittest_apply_overlay_check(int overlay_nr,
1986         int unittest_nr, int before, int after,
1987         enum overlay_type ovtype)
1988 {
1989     int ret, ovcs_id;
1990 
1991     /* unittest device must not be in before state */
1992     if (of_unittest_device_exists(unittest_nr, ovtype) != before) {
1993         unittest(0, "%s with device @\"%s\" %s\n",
1994                 overlay_name_from_nr(overlay_nr),
1995                 unittest_path(unittest_nr, ovtype),
1996                 !before ? "enabled" : "disabled");
1997         return -EINVAL;
1998     }
1999 
2000     ovcs_id = 0;
2001     ret = of_unittest_apply_overlay(overlay_nr, &ovcs_id);
2002     if (ret != 0) {
2003         /* of_unittest_apply_overlay already called unittest() */
2004         return ret;
2005     }
2006 
2007     /* unittest device must be to set to after state */
2008     if (of_unittest_device_exists(unittest_nr, ovtype) != after) {
2009         unittest(0, "%s failed to create @\"%s\" %s\n",
2010                 overlay_name_from_nr(overlay_nr),
2011                 unittest_path(unittest_nr, ovtype),
2012                 !after ? "enabled" : "disabled");
2013         return -EINVAL;
2014     }
2015 
2016     return 0;
2017 }
2018 
2019 /* apply an overlay and then revert it while checking before, after states */
2020 static int __init of_unittest_apply_revert_overlay_check(int overlay_nr,
2021         int unittest_nr, int before, int after,
2022         enum overlay_type ovtype)
2023 {
2024     int ret, ovcs_id, save_ovcs_id;
2025 
2026     /* unittest device must be in before state */
2027     if (of_unittest_device_exists(unittest_nr, ovtype) != before) {
2028         unittest(0, "%s with device @\"%s\" %s\n",
2029                 overlay_name_from_nr(overlay_nr),
2030                 unittest_path(unittest_nr, ovtype),
2031                 !before ? "enabled" : "disabled");
2032         return -EINVAL;
2033     }
2034 
2035     /* apply the overlay */
2036     ovcs_id = 0;
2037     ret = of_unittest_apply_overlay(overlay_nr, &ovcs_id);
2038     if (ret != 0) {
2039         /* of_unittest_apply_overlay already called unittest() */
2040         return ret;
2041     }
2042 
2043     /* unittest device must be in after state */
2044     if (of_unittest_device_exists(unittest_nr, ovtype) != after) {
2045         unittest(0, "%s failed to create @\"%s\" %s\n",
2046                 overlay_name_from_nr(overlay_nr),
2047                 unittest_path(unittest_nr, ovtype),
2048                 !after ? "enabled" : "disabled");
2049         return -EINVAL;
2050     }
2051 
2052     save_ovcs_id = ovcs_id;
2053     ret = of_overlay_remove(&ovcs_id);
2054     if (ret != 0) {
2055         unittest(0, "%s failed to be destroyed @\"%s\"\n",
2056                 overlay_name_from_nr(overlay_nr),
2057                 unittest_path(unittest_nr, ovtype));
2058         return ret;
2059     }
2060     of_unittest_untrack_overlay(save_ovcs_id);
2061 
2062     /* unittest device must be again in before state */
2063     if (of_unittest_device_exists(unittest_nr, PDEV_OVERLAY) != before) {
2064         unittest(0, "%s with device @\"%s\" %s\n",
2065                 overlay_name_from_nr(overlay_nr),
2066                 unittest_path(unittest_nr, ovtype),
2067                 !before ? "enabled" : "disabled");
2068         return -EINVAL;
2069     }
2070 
2071     return 0;
2072 }
2073 
2074 /* test activation of device */
2075 static void __init of_unittest_overlay_0(void)
2076 {
2077     int ret;
2078 
2079     EXPECT_BEGIN(KERN_INFO,
2080              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest0/status");
2081 
2082     /* device should enable */
2083     ret = of_unittest_apply_overlay_check(0, 0, 0, 1, PDEV_OVERLAY);
2084 
2085     EXPECT_END(KERN_INFO,
2086            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest0/status");
2087 
2088     if (ret)
2089         return;
2090 
2091     unittest(1, "overlay test %d passed\n", 0);
2092 }
2093 
2094 /* test deactivation of device */
2095 static void __init of_unittest_overlay_1(void)
2096 {
2097     int ret;
2098 
2099     EXPECT_BEGIN(KERN_INFO,
2100              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest1/status");
2101 
2102     /* device should disable */
2103     ret = of_unittest_apply_overlay_check(1, 1, 1, 0, PDEV_OVERLAY);
2104 
2105     EXPECT_END(KERN_INFO,
2106            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest1/status");
2107 
2108     if (ret)
2109         return;
2110 
2111     unittest(1, "overlay test %d passed\n", 1);
2112 
2113 }
2114 
2115 /* test activation of device */
2116 static void __init of_unittest_overlay_2(void)
2117 {
2118     int ret;
2119 
2120     EXPECT_BEGIN(KERN_INFO,
2121              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest2/status");
2122 
2123     /* device should enable */
2124     ret = of_unittest_apply_overlay_check(2, 2, 0, 1, PDEV_OVERLAY);
2125 
2126     EXPECT_END(KERN_INFO,
2127            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest2/status");
2128 
2129     if (ret)
2130         return;
2131     unittest(1, "overlay test %d passed\n", 2);
2132 }
2133 
2134 /* test deactivation of device */
2135 static void __init of_unittest_overlay_3(void)
2136 {
2137     int ret;
2138 
2139     EXPECT_BEGIN(KERN_INFO,
2140              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest3/status");
2141 
2142     /* device should disable */
2143     ret = of_unittest_apply_overlay_check(3, 3, 1, 0, PDEV_OVERLAY);
2144 
2145     EXPECT_END(KERN_INFO,
2146            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest3/status");
2147 
2148     if (ret)
2149         return;
2150 
2151     unittest(1, "overlay test %d passed\n", 3);
2152 }
2153 
2154 /* test activation of a full device node */
2155 static void __init of_unittest_overlay_4(void)
2156 {
2157     /* device should disable */
2158     if (of_unittest_apply_overlay_check(4, 4, 0, 1, PDEV_OVERLAY))
2159         return;
2160 
2161     unittest(1, "overlay test %d passed\n", 4);
2162 }
2163 
2164 /* test overlay apply/revert sequence */
2165 static void __init of_unittest_overlay_5(void)
2166 {
2167     int ret;
2168 
2169     EXPECT_BEGIN(KERN_INFO,
2170              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest5/status");
2171 
2172     /* device should disable */
2173     ret = of_unittest_apply_revert_overlay_check(5, 5, 0, 1, PDEV_OVERLAY);
2174 
2175     EXPECT_END(KERN_INFO,
2176            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest5/status");
2177 
2178     if (ret)
2179         return;
2180 
2181     unittest(1, "overlay test %d passed\n", 5);
2182 }
2183 
2184 /* test overlay application in sequence */
2185 static void __init of_unittest_overlay_6(void)
2186 {
2187     int i, save_ovcs_id[2], ovcs_id;
2188     int overlay_nr = 6, unittest_nr = 6;
2189     int before = 0, after = 1;
2190     const char *overlay_name;
2191 
2192     int ret;
2193 
2194     /* unittest device must be in before state */
2195     for (i = 0; i < 2; i++) {
2196         if (of_unittest_device_exists(unittest_nr + i, PDEV_OVERLAY)
2197                 != before) {
2198             unittest(0, "%s with device @\"%s\" %s\n",
2199                     overlay_name_from_nr(overlay_nr + i),
2200                     unittest_path(unittest_nr + i,
2201                         PDEV_OVERLAY),
2202                     !before ? "enabled" : "disabled");
2203             return;
2204         }
2205     }
2206 
2207     /* apply the overlays */
2208 
2209     EXPECT_BEGIN(KERN_INFO,
2210              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest6/status");
2211 
2212     overlay_name = overlay_name_from_nr(overlay_nr + 0);
2213 
2214     ret = overlay_data_apply(overlay_name, &ovcs_id);
2215 
2216     if (!ret) {
2217         unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
2218             return;
2219     }
2220     save_ovcs_id[0] = ovcs_id;
2221     of_unittest_track_overlay(ovcs_id, overlay_nr + 0);
2222 
2223     EXPECT_END(KERN_INFO,
2224            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest6/status");
2225 
2226     EXPECT_BEGIN(KERN_INFO,
2227              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest7/status");
2228 
2229     overlay_name = overlay_name_from_nr(overlay_nr + 1);
2230 
2231     ret = overlay_data_apply(overlay_name, &ovcs_id);
2232 
2233     if (!ret) {
2234         unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
2235             return;
2236     }
2237     save_ovcs_id[1] = ovcs_id;
2238     of_unittest_track_overlay(ovcs_id, overlay_nr + 1);
2239 
2240     EXPECT_END(KERN_INFO,
2241            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest7/status");
2242 
2243 
2244     for (i = 0; i < 2; i++) {
2245         /* unittest device must be in after state */
2246         if (of_unittest_device_exists(unittest_nr + i, PDEV_OVERLAY)
2247                 != after) {
2248             unittest(0, "overlay @\"%s\" failed @\"%s\" %s\n",
2249                     overlay_name_from_nr(overlay_nr + i),
2250                     unittest_path(unittest_nr + i,
2251                         PDEV_OVERLAY),
2252                     !after ? "enabled" : "disabled");
2253             return;
2254         }
2255     }
2256 
2257     for (i = 1; i >= 0; i--) {
2258         ovcs_id = save_ovcs_id[i];
2259         if (of_overlay_remove(&ovcs_id)) {
2260             unittest(0, "%s failed destroy @\"%s\"\n",
2261                     overlay_name_from_nr(overlay_nr + i),
2262                     unittest_path(unittest_nr + i,
2263                         PDEV_OVERLAY));
2264             return;
2265         }
2266         of_unittest_untrack_overlay(save_ovcs_id[i]);
2267     }
2268 
2269     for (i = 0; i < 2; i++) {
2270         /* unittest device must be again in before state */
2271         if (of_unittest_device_exists(unittest_nr + i, PDEV_OVERLAY)
2272                 != before) {
2273             unittest(0, "%s with device @\"%s\" %s\n",
2274                     overlay_name_from_nr(overlay_nr + i),
2275                     unittest_path(unittest_nr + i,
2276                         PDEV_OVERLAY),
2277                     !before ? "enabled" : "disabled");
2278             return;
2279         }
2280     }
2281 
2282     unittest(1, "overlay test %d passed\n", 6);
2283 
2284 }
2285 
2286 /* test overlay application in sequence */
2287 static void __init of_unittest_overlay_8(void)
2288 {
2289     int i, save_ovcs_id[2], ovcs_id;
2290     int overlay_nr = 8, unittest_nr = 8;
2291     const char *overlay_name;
2292     int ret;
2293 
2294     /* we don't care about device state in this test */
2295 
2296     EXPECT_BEGIN(KERN_INFO,
2297              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest8/status");
2298 
2299     overlay_name = overlay_name_from_nr(overlay_nr + 0);
2300 
2301     ret = overlay_data_apply(overlay_name, &ovcs_id);
2302     if (!ret)
2303         unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
2304 
2305     EXPECT_END(KERN_INFO,
2306            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest8/status");
2307 
2308     if (!ret)
2309         return;
2310 
2311     save_ovcs_id[0] = ovcs_id;
2312     of_unittest_track_overlay(ovcs_id, overlay_nr + 0);
2313 
2314     overlay_name = overlay_name_from_nr(overlay_nr + 1);
2315 
2316     EXPECT_BEGIN(KERN_INFO,
2317              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest8/property-foo");
2318 
2319     /* apply the overlays */
2320     ret = overlay_data_apply(overlay_name, &ovcs_id);
2321 
2322     EXPECT_END(KERN_INFO,
2323            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest8/property-foo");
2324 
2325     if (!ret) {
2326         unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
2327         return;
2328     }
2329 
2330     save_ovcs_id[1] = ovcs_id;
2331     of_unittest_track_overlay(ovcs_id, overlay_nr + 1);
2332 
2333     /* now try to remove first overlay (it should fail) */
2334     ovcs_id = save_ovcs_id[0];
2335 
2336     EXPECT_BEGIN(KERN_INFO,
2337              "OF: overlay: node_overlaps_later_cs: #6 overlaps with #7 @/testcase-data/overlay-node/test-bus/test-unittest8");
2338 
2339     EXPECT_BEGIN(KERN_INFO,
2340              "OF: overlay: overlay #6 is not topmost");
2341 
2342     ret = of_overlay_remove(&ovcs_id);
2343 
2344     EXPECT_END(KERN_INFO,
2345            "OF: overlay: overlay #6 is not topmost");
2346 
2347     EXPECT_END(KERN_INFO,
2348            "OF: overlay: node_overlaps_later_cs: #6 overlaps with #7 @/testcase-data/overlay-node/test-bus/test-unittest8");
2349 
2350     if (!ret) {
2351         /*
2352          * Should never get here.  If we do, expect a lot of
2353          * subsequent tracking and overlay removal related errors.
2354          */
2355         unittest(0, "%s was destroyed @\"%s\"\n",
2356                 overlay_name_from_nr(overlay_nr + 0),
2357                 unittest_path(unittest_nr,
2358                     PDEV_OVERLAY));
2359         return;
2360     }
2361 
2362     /* removing them in order should work */
2363     for (i = 1; i >= 0; i--) {
2364         ovcs_id = save_ovcs_id[i];
2365         if (of_overlay_remove(&ovcs_id)) {
2366             unittest(0, "%s not destroyed @\"%s\"\n",
2367                     overlay_name_from_nr(overlay_nr + i),
2368                     unittest_path(unittest_nr,
2369                         PDEV_OVERLAY));
2370             return;
2371         }
2372         of_unittest_untrack_overlay(save_ovcs_id[i]);
2373     }
2374 
2375     unittest(1, "overlay test %d passed\n", 8);
2376 }
2377 
2378 /* test insertion of a bus with parent devices */
2379 static void __init of_unittest_overlay_10(void)
2380 {
2381     int ret;
2382     char *child_path;
2383 
2384     /* device should disable */
2385     ret = of_unittest_apply_overlay_check(10, 10, 0, 1, PDEV_OVERLAY);
2386 
2387     if (unittest(ret == 0,
2388             "overlay test %d failed; overlay application\n", 10))
2389         return;
2390 
2391     child_path = kasprintf(GFP_KERNEL, "%s/test-unittest101",
2392             unittest_path(10, PDEV_OVERLAY));
2393     if (unittest(child_path, "overlay test %d failed; kasprintf\n", 10))
2394         return;
2395 
2396     ret = of_path_device_type_exists(child_path, PDEV_OVERLAY);
2397     kfree(child_path);
2398 
2399     unittest(ret, "overlay test %d failed; no child device\n", 10);
2400 }
2401 
2402 /* test insertion of a bus with parent devices (and revert) */
2403 static void __init of_unittest_overlay_11(void)
2404 {
2405     int ret;
2406 
2407     /* device should disable */
2408     ret = of_unittest_apply_revert_overlay_check(11, 11, 0, 1,
2409             PDEV_OVERLAY);
2410 
2411     unittest(ret == 0, "overlay test %d failed; overlay apply\n", 11);
2412 }
2413 
2414 #if IS_BUILTIN(CONFIG_I2C) && IS_ENABLED(CONFIG_OF_OVERLAY)
2415 
2416 struct unittest_i2c_bus_data {
2417     struct platform_device  *pdev;
2418     struct i2c_adapter  adap;
2419 };
2420 
2421 static int unittest_i2c_master_xfer(struct i2c_adapter *adap,
2422         struct i2c_msg *msgs, int num)
2423 {
2424     struct unittest_i2c_bus_data *std = i2c_get_adapdata(adap);
2425 
2426     (void)std;
2427 
2428     return num;
2429 }
2430 
2431 static u32 unittest_i2c_functionality(struct i2c_adapter *adap)
2432 {
2433     return I2C_FUNC_I2C | I2C_FUNC_SMBUS_EMUL;
2434 }
2435 
2436 static const struct i2c_algorithm unittest_i2c_algo = {
2437     .master_xfer    = unittest_i2c_master_xfer,
2438     .functionality  = unittest_i2c_functionality,
2439 };
2440 
2441 static int unittest_i2c_bus_probe(struct platform_device *pdev)
2442 {
2443     struct device *dev = &pdev->dev;
2444     struct device_node *np = dev->of_node;
2445     struct unittest_i2c_bus_data *std;
2446     struct i2c_adapter *adap;
2447     int ret;
2448 
2449     if (np == NULL) {
2450         dev_err(dev, "No OF data for device\n");
2451         return -EINVAL;
2452 
2453     }
2454 
2455     dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2456 
2457     std = devm_kzalloc(dev, sizeof(*std), GFP_KERNEL);
2458     if (!std)
2459         return -ENOMEM;
2460 
2461     /* link them together */
2462     std->pdev = pdev;
2463     platform_set_drvdata(pdev, std);
2464 
2465     adap = &std->adap;
2466     i2c_set_adapdata(adap, std);
2467     adap->nr = -1;
2468     strlcpy(adap->name, pdev->name, sizeof(adap->name));
2469     adap->class = I2C_CLASS_DEPRECATED;
2470     adap->algo = &unittest_i2c_algo;
2471     adap->dev.parent = dev;
2472     adap->dev.of_node = dev->of_node;
2473     adap->timeout = 5 * HZ;
2474     adap->retries = 3;
2475 
2476     ret = i2c_add_numbered_adapter(adap);
2477     if (ret != 0) {
2478         dev_err(dev, "Failed to add I2C adapter\n");
2479         return ret;
2480     }
2481 
2482     return 0;
2483 }
2484 
2485 static int unittest_i2c_bus_remove(struct platform_device *pdev)
2486 {
2487     struct device *dev = &pdev->dev;
2488     struct device_node *np = dev->of_node;
2489     struct unittest_i2c_bus_data *std = platform_get_drvdata(pdev);
2490 
2491     dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2492     i2c_del_adapter(&std->adap);
2493 
2494     return 0;
2495 }
2496 
2497 static const struct of_device_id unittest_i2c_bus_match[] = {
2498     { .compatible = "unittest-i2c-bus", },
2499     {},
2500 };
2501 
2502 static struct platform_driver unittest_i2c_bus_driver = {
2503     .probe          = unittest_i2c_bus_probe,
2504     .remove         = unittest_i2c_bus_remove,
2505     .driver = {
2506         .name       = "unittest-i2c-bus",
2507         .of_match_table = of_match_ptr(unittest_i2c_bus_match),
2508     },
2509 };
2510 
2511 static int unittest_i2c_dev_probe(struct i2c_client *client,
2512         const struct i2c_device_id *id)
2513 {
2514     struct device *dev = &client->dev;
2515     struct device_node *np = client->dev.of_node;
2516 
2517     if (!np) {
2518         dev_err(dev, "No OF node\n");
2519         return -EINVAL;
2520     }
2521 
2522     dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2523 
2524     return 0;
2525 };
2526 
2527 static int unittest_i2c_dev_remove(struct i2c_client *client)
2528 {
2529     struct device *dev = &client->dev;
2530     struct device_node *np = client->dev.of_node;
2531 
2532     dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2533     return 0;
2534 }
2535 
2536 static const struct i2c_device_id unittest_i2c_dev_id[] = {
2537     { .name = "unittest-i2c-dev" },
2538     { }
2539 };
2540 
2541 static struct i2c_driver unittest_i2c_dev_driver = {
2542     .driver = {
2543         .name = "unittest-i2c-dev",
2544     },
2545     .probe = unittest_i2c_dev_probe,
2546     .remove = unittest_i2c_dev_remove,
2547     .id_table = unittest_i2c_dev_id,
2548 };
2549 
2550 #if IS_BUILTIN(CONFIG_I2C_MUX)
2551 
2552 static int unittest_i2c_mux_select_chan(struct i2c_mux_core *muxc, u32 chan)
2553 {
2554     return 0;
2555 }
2556 
2557 static int unittest_i2c_mux_probe(struct i2c_client *client,
2558         const struct i2c_device_id *id)
2559 {
2560     int i, nchans;
2561     struct device *dev = &client->dev;
2562     struct i2c_adapter *adap = client->adapter;
2563     struct device_node *np = client->dev.of_node, *child;
2564     struct i2c_mux_core *muxc;
2565     u32 reg, max_reg;
2566 
2567     dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2568 
2569     if (!np) {
2570         dev_err(dev, "No OF node\n");
2571         return -EINVAL;
2572     }
2573 
2574     max_reg = (u32)-1;
2575     for_each_child_of_node(np, child) {
2576         if (of_property_read_u32(child, "reg", &reg))
2577             continue;
2578         if (max_reg == (u32)-1 || reg > max_reg)
2579             max_reg = reg;
2580     }
2581     nchans = max_reg == (u32)-1 ? 0 : max_reg + 1;
2582     if (nchans == 0) {
2583         dev_err(dev, "No channels\n");
2584         return -EINVAL;
2585     }
2586 
2587     muxc = i2c_mux_alloc(adap, dev, nchans, 0, 0,
2588                  unittest_i2c_mux_select_chan, NULL);
2589     if (!muxc)
2590         return -ENOMEM;
2591     for (i = 0; i < nchans; i++) {
2592         if (i2c_mux_add_adapter(muxc, 0, i, 0)) {
2593             dev_err(dev, "Failed to register mux #%d\n", i);
2594             i2c_mux_del_adapters(muxc);
2595             return -ENODEV;
2596         }
2597     }
2598 
2599     i2c_set_clientdata(client, muxc);
2600 
2601     return 0;
2602 };
2603 
2604 static int unittest_i2c_mux_remove(struct i2c_client *client)
2605 {
2606     struct device *dev = &client->dev;
2607     struct device_node *np = client->dev.of_node;
2608     struct i2c_mux_core *muxc = i2c_get_clientdata(client);
2609 
2610     dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2611     i2c_mux_del_adapters(muxc);
2612     return 0;
2613 }
2614 
2615 static const struct i2c_device_id unittest_i2c_mux_id[] = {
2616     { .name = "unittest-i2c-mux" },
2617     { }
2618 };
2619 
2620 static struct i2c_driver unittest_i2c_mux_driver = {
2621     .driver = {
2622         .name = "unittest-i2c-mux",
2623     },
2624     .probe = unittest_i2c_mux_probe,
2625     .remove = unittest_i2c_mux_remove,
2626     .id_table = unittest_i2c_mux_id,
2627 };
2628 
2629 #endif
2630 
2631 static int of_unittest_overlay_i2c_init(void)
2632 {
2633     int ret;
2634 
2635     ret = i2c_add_driver(&unittest_i2c_dev_driver);
2636     if (unittest(ret == 0,
2637             "could not register unittest i2c device driver\n"))
2638         return ret;
2639 
2640     ret = platform_driver_register(&unittest_i2c_bus_driver);
2641 
2642     if (unittest(ret == 0,
2643             "could not register unittest i2c bus driver\n"))
2644         return ret;
2645 
2646 #if IS_BUILTIN(CONFIG_I2C_MUX)
2647 
2648     EXPECT_BEGIN(KERN_INFO,
2649              "i2c i2c-1: Added multiplexed i2c bus 2");
2650 
2651     ret = i2c_add_driver(&unittest_i2c_mux_driver);
2652 
2653     EXPECT_END(KERN_INFO,
2654            "i2c i2c-1: Added multiplexed i2c bus 2");
2655 
2656     if (unittest(ret == 0,
2657             "could not register unittest i2c mux driver\n"))
2658         return ret;
2659 #endif
2660 
2661     return 0;
2662 }
2663 
2664 static void of_unittest_overlay_i2c_cleanup(void)
2665 {
2666 #if IS_BUILTIN(CONFIG_I2C_MUX)
2667     i2c_del_driver(&unittest_i2c_mux_driver);
2668 #endif
2669     platform_driver_unregister(&unittest_i2c_bus_driver);
2670     i2c_del_driver(&unittest_i2c_dev_driver);
2671 }
2672 
2673 static void __init of_unittest_overlay_i2c_12(void)
2674 {
2675     int ret;
2676 
2677     /* device should enable */
2678     EXPECT_BEGIN(KERN_INFO,
2679              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/i2c-test-bus/test-unittest12/status");
2680 
2681     ret = of_unittest_apply_overlay_check(12, 12, 0, 1, I2C_OVERLAY);
2682 
2683     EXPECT_END(KERN_INFO,
2684            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/i2c-test-bus/test-unittest12/status");
2685 
2686     if (ret)
2687         return;
2688 
2689     unittest(1, "overlay test %d passed\n", 12);
2690 }
2691 
2692 /* test deactivation of device */
2693 static void __init of_unittest_overlay_i2c_13(void)
2694 {
2695     int ret;
2696 
2697     EXPECT_BEGIN(KERN_INFO,
2698              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/i2c-test-bus/test-unittest13/status");
2699 
2700     /* device should disable */
2701     ret = of_unittest_apply_overlay_check(13, 13, 1, 0, I2C_OVERLAY);
2702 
2703     EXPECT_END(KERN_INFO,
2704            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/i2c-test-bus/test-unittest13/status");
2705 
2706     if (ret)
2707         return;
2708 
2709     unittest(1, "overlay test %d passed\n", 13);
2710 }
2711 
2712 /* just check for i2c mux existence */
2713 static void of_unittest_overlay_i2c_14(void)
2714 {
2715 }
2716 
2717 static void __init of_unittest_overlay_i2c_15(void)
2718 {
2719     int ret;
2720 
2721     /* device should enable */
2722     EXPECT_BEGIN(KERN_INFO,
2723              "i2c i2c-1: Added multiplexed i2c bus 3");
2724 
2725     ret = of_unittest_apply_overlay_check(15, 15, 0, 1, I2C_OVERLAY);
2726 
2727     EXPECT_END(KERN_INFO,
2728            "i2c i2c-1: Added multiplexed i2c bus 3");
2729 
2730     if (ret)
2731         return;
2732 
2733     unittest(1, "overlay test %d passed\n", 15);
2734 }
2735 
2736 #else
2737 
2738 static inline void of_unittest_overlay_i2c_14(void) { }
2739 static inline void of_unittest_overlay_i2c_15(void) { }
2740 
2741 #endif
2742 
2743 static int of_notify(struct notifier_block *nb, unsigned long action,
2744              void *arg)
2745 {
2746     struct of_overlay_notify_data *nd = arg;
2747     struct device_node *found;
2748     int ret;
2749 
2750     /*
2751      * For overlay_16 .. overlay_19, check that returning an error
2752      * works for each of the actions by setting an arbitrary return
2753      * error number that matches the test number.  e.g. for unittest16,
2754      * ret = -EBUSY which is -16.
2755      *
2756      * OVERLAY_INFO() for the overlays is declared to expect the same
2757      * error number, so overlay_data_apply() will return no error.
2758      *
2759      * overlay_20 will return NOTIFY_DONE
2760      */
2761 
2762     ret = 0;
2763     of_node_get(nd->overlay);
2764 
2765     switch (action) {
2766 
2767     case OF_OVERLAY_PRE_APPLY:
2768         found = of_find_node_by_name(nd->overlay, "test-unittest16");
2769         if (found) {
2770             of_node_put(found);
2771             ret = -EBUSY;
2772         }
2773         break;
2774 
2775     case OF_OVERLAY_POST_APPLY:
2776         found = of_find_node_by_name(nd->overlay, "test-unittest17");
2777         if (found) {
2778             of_node_put(found);
2779             ret = -EEXIST;
2780         }
2781         break;
2782 
2783     case OF_OVERLAY_PRE_REMOVE:
2784         found = of_find_node_by_name(nd->overlay, "test-unittest18");
2785         if (found) {
2786             of_node_put(found);
2787             ret = -EXDEV;
2788         }
2789         break;
2790 
2791     case OF_OVERLAY_POST_REMOVE:
2792         found = of_find_node_by_name(nd->overlay, "test-unittest19");
2793         if (found) {
2794             of_node_put(found);
2795             ret = -ENODEV;
2796         }
2797         break;
2798 
2799     default:            /* should not happen */
2800         of_node_put(nd->overlay);
2801         ret = -EINVAL;
2802         break;
2803     }
2804 
2805     if (ret)
2806         return notifier_from_errno(ret);
2807 
2808     return NOTIFY_DONE;
2809 }
2810 
2811 static struct notifier_block of_nb = {
2812     .notifier_call = of_notify,
2813 };
2814 
2815 static void __init of_unittest_overlay_notify(void)
2816 {
2817     int ovcs_id;
2818     int ret;
2819 
2820     ret = of_overlay_notifier_register(&of_nb);
2821     unittest(!ret,
2822          "of_overlay_notifier_register() failed, ret = %d\n", ret);
2823     if (ret)
2824         return;
2825 
2826     /*
2827      * The overlays are applied by overlay_data_apply()
2828      * instead of of_unittest_apply_overlay() so that they
2829      * will not be tracked.  Thus they will not be removed
2830      * by of_unittest_remove_tracked_overlays().
2831      *
2832      * Applying overlays 16 - 19 will each trigger an error for a
2833      * different action in of_notify().
2834      *
2835      * Applying overlay 20 will not trigger any error in of_notify().
2836      */
2837 
2838     /* ---  overlay 16  --- */
2839 
2840     EXPECT_BEGIN(KERN_INFO, "OF: overlay: overlay changeset pre-apply notifier error -16, target: /testcase-data/overlay-node/test-bus");
2841 
2842     unittest(overlay_data_apply("overlay_16", &ovcs_id),
2843          "test OF_OVERLAY_PRE_APPLY notify injected error\n");
2844 
2845     EXPECT_END(KERN_INFO, "OF: overlay: overlay changeset pre-apply notifier error -16, target: /testcase-data/overlay-node/test-bus");
2846 
2847     unittest(ovcs_id, "ovcs_id not created for overlay_16\n");
2848 
2849     /* ---  overlay 17  --- */
2850 
2851     EXPECT_BEGIN(KERN_INFO, "OF: overlay: overlay changeset post-apply notifier error -17, target: /testcase-data/overlay-node/test-bus");
2852 
2853     unittest(overlay_data_apply("overlay_17", &ovcs_id),
2854          "test OF_OVERLAY_POST_APPLY notify injected error\n");
2855 
2856     EXPECT_END(KERN_INFO, "OF: overlay: overlay changeset post-apply notifier error -17, target: /testcase-data/overlay-node/test-bus");
2857 
2858     unittest(ovcs_id, "ovcs_id not created for overlay_17\n");
2859 
2860     if (ovcs_id) {
2861         ret = of_overlay_remove(&ovcs_id);
2862         unittest(!ret,
2863             "overlay_17 of_overlay_remove(), ret = %d\n", ret);
2864     }
2865 
2866     /* ---  overlay 18  --- */
2867 
2868     unittest(overlay_data_apply("overlay_18", &ovcs_id),
2869          "OF_OVERLAY_PRE_REMOVE notify injected error\n");
2870 
2871     unittest(ovcs_id, "ovcs_id not created for overlay_18\n");
2872 
2873     if (ovcs_id) {
2874         EXPECT_BEGIN(KERN_INFO, "OF: overlay: overlay changeset pre-remove notifier error -18, target: /testcase-data/overlay-node/test-bus");
2875 
2876         ret = of_overlay_remove(&ovcs_id);
2877         EXPECT_END(KERN_INFO, "OF: overlay: overlay changeset pre-remove notifier error -18, target: /testcase-data/overlay-node/test-bus");
2878         if (ret == -EXDEV) {
2879             /*
2880              * change set ovcs_id should still exist
2881              */
2882             unittest(1, "overlay_18 of_overlay_remove() injected error for OF_OVERLAY_PRE_REMOVE\n");
2883         } else {
2884             unittest(0, "overlay_18 of_overlay_remove() injected error for OF_OVERLAY_PRE_REMOVE not returned\n");
2885         }
2886     } else {
2887         unittest(1, "ovcs_id not created for overlay_18\n");
2888     }
2889 
2890     unittest(ovcs_id, "ovcs_id removed for overlay_18\n");
2891 
2892     /* ---  overlay 19  --- */
2893 
2894     unittest(overlay_data_apply("overlay_19", &ovcs_id),
2895          "OF_OVERLAY_POST_REMOVE notify injected error\n");
2896 
2897     unittest(ovcs_id, "ovcs_id not created for overlay_19\n");
2898 
2899     if (ovcs_id) {
2900         EXPECT_BEGIN(KERN_INFO, "OF: overlay: overlay changeset post-remove notifier error -19, target: /testcase-data/overlay-node/test-bus");
2901         ret = of_overlay_remove(&ovcs_id);
2902         EXPECT_END(KERN_INFO, "OF: overlay: overlay changeset post-remove notifier error -19, target: /testcase-data/overlay-node/test-bus");
2903         if (ret == -ENODEV)
2904             unittest(1, "overlay_19 of_overlay_remove() injected error for OF_OVERLAY_POST_REMOVE\n");
2905         else
2906             unittest(0, "overlay_19 of_overlay_remove() injected error for OF_OVERLAY_POST_REMOVE not returned\n");
2907     } else {
2908         unittest(1, "ovcs_id removed for overlay_19\n");
2909     }
2910 
2911     unittest(!ovcs_id, "changeset ovcs_id = %d not removed for overlay_19\n",
2912          ovcs_id);
2913 
2914     /* ---  overlay 20  --- */
2915 
2916     unittest(overlay_data_apply("overlay_20", &ovcs_id),
2917          "overlay notify no injected error\n");
2918 
2919     if (ovcs_id) {
2920         ret = of_overlay_remove(&ovcs_id);
2921         if (ret)
2922             unittest(1, "overlay_20 failed to be destroyed, ret = %d\n",
2923                  ret);
2924     } else {
2925         unittest(1, "ovcs_id not created for overlay_20\n");
2926     }
2927 
2928     unittest(!of_overlay_notifier_unregister(&of_nb),
2929          "of_overlay_notifier_unregister() failed, ret = %d\n", ret);
2930 }
2931 
2932 static void __init of_unittest_overlay(void)
2933 {
2934     struct device_node *bus_np = NULL;
2935 
2936     if (platform_driver_register(&unittest_driver)) {
2937         unittest(0, "could not register unittest driver\n");
2938         goto out;
2939     }
2940 
2941     bus_np = of_find_node_by_path(bus_path);
2942     if (bus_np == NULL) {
2943         unittest(0, "could not find bus_path \"%s\"\n", bus_path);
2944         goto out;
2945     }
2946 
2947     if (of_platform_default_populate(bus_np, NULL, NULL)) {
2948         unittest(0, "could not populate bus @ \"%s\"\n", bus_path);
2949         goto out;
2950     }
2951 
2952     if (!of_unittest_device_exists(100, PDEV_OVERLAY)) {
2953         unittest(0, "could not find unittest0 @ \"%s\"\n",
2954                 unittest_path(100, PDEV_OVERLAY));
2955         goto out;
2956     }
2957 
2958     if (of_unittest_device_exists(101, PDEV_OVERLAY)) {
2959         unittest(0, "unittest1 @ \"%s\" should not exist\n",
2960                 unittest_path(101, PDEV_OVERLAY));
2961         goto out;
2962     }
2963 
2964     unittest(1, "basic infrastructure of overlays passed");
2965 
2966     /* tests in sequence */
2967     of_unittest_overlay_0();
2968     of_unittest_overlay_1();
2969     of_unittest_overlay_2();
2970     of_unittest_overlay_3();
2971     of_unittest_overlay_4();
2972     of_unittest_overlay_5();
2973     of_unittest_overlay_6();
2974     of_unittest_overlay_8();
2975 
2976     of_unittest_overlay_10();
2977     of_unittest_overlay_11();
2978 
2979 #if IS_BUILTIN(CONFIG_I2C)
2980     if (unittest(of_unittest_overlay_i2c_init() == 0, "i2c init failed\n"))
2981         goto out;
2982 
2983     of_unittest_overlay_i2c_12();
2984     of_unittest_overlay_i2c_13();
2985     of_unittest_overlay_i2c_14();
2986     of_unittest_overlay_i2c_15();
2987 
2988     of_unittest_overlay_i2c_cleanup();
2989 #endif
2990 
2991     of_unittest_overlay_gpio();
2992 
2993     of_unittest_remove_tracked_overlays();
2994 
2995     of_unittest_overlay_notify();
2996 
2997 out:
2998     of_node_put(bus_np);
2999 }
3000 
3001 #else
3002 static inline void __init of_unittest_overlay(void) { }
3003 #endif
3004 
3005 #ifdef CONFIG_OF_OVERLAY
3006 
3007 /*
3008  * __dtb_ot_begin[] and __dtb_ot_end[] are created by cmd_dt_S_dtb
3009  * in scripts/Makefile.lib
3010  */
3011 
3012 #define OVERLAY_INFO_EXTERN(name) \
3013     extern uint8_t __dtb_##name##_begin[]; \
3014     extern uint8_t __dtb_##name##_end[]
3015 
3016 #define OVERLAY_INFO(overlay_name, expected)             \
3017 {   .dtb_begin       = __dtb_##overlay_name##_begin, \
3018     .dtb_end         = __dtb_##overlay_name##_end,   \
3019     .expected_result = expected,                     \
3020     .name            = #overlay_name,                \
3021 }
3022 
3023 struct overlay_info {
3024     uint8_t     *dtb_begin;
3025     uint8_t     *dtb_end;
3026     int     expected_result;
3027     int     ovcs_id;
3028     char        *name;
3029 };
3030 
3031 OVERLAY_INFO_EXTERN(overlay_base);
3032 OVERLAY_INFO_EXTERN(overlay);
3033 OVERLAY_INFO_EXTERN(overlay_0);
3034 OVERLAY_INFO_EXTERN(overlay_1);
3035 OVERLAY_INFO_EXTERN(overlay_2);
3036 OVERLAY_INFO_EXTERN(overlay_3);
3037 OVERLAY_INFO_EXTERN(overlay_4);
3038 OVERLAY_INFO_EXTERN(overlay_5);
3039 OVERLAY_INFO_EXTERN(overlay_6);
3040 OVERLAY_INFO_EXTERN(overlay_7);
3041 OVERLAY_INFO_EXTERN(overlay_8);
3042 OVERLAY_INFO_EXTERN(overlay_9);
3043 OVERLAY_INFO_EXTERN(overlay_10);
3044 OVERLAY_INFO_EXTERN(overlay_11);
3045 OVERLAY_INFO_EXTERN(overlay_12);
3046 OVERLAY_INFO_EXTERN(overlay_13);
3047 OVERLAY_INFO_EXTERN(overlay_15);
3048 OVERLAY_INFO_EXTERN(overlay_16);
3049 OVERLAY_INFO_EXTERN(overlay_17);
3050 OVERLAY_INFO_EXTERN(overlay_18);
3051 OVERLAY_INFO_EXTERN(overlay_19);
3052 OVERLAY_INFO_EXTERN(overlay_20);
3053 OVERLAY_INFO_EXTERN(overlay_gpio_01);
3054 OVERLAY_INFO_EXTERN(overlay_gpio_02a);
3055 OVERLAY_INFO_EXTERN(overlay_gpio_02b);
3056 OVERLAY_INFO_EXTERN(overlay_gpio_03);
3057 OVERLAY_INFO_EXTERN(overlay_gpio_04a);
3058 OVERLAY_INFO_EXTERN(overlay_gpio_04b);
3059 OVERLAY_INFO_EXTERN(overlay_bad_add_dup_node);
3060 OVERLAY_INFO_EXTERN(overlay_bad_add_dup_prop);
3061 OVERLAY_INFO_EXTERN(overlay_bad_phandle);
3062 OVERLAY_INFO_EXTERN(overlay_bad_symbol);
3063 
3064 /* entries found by name */
3065 static struct overlay_info overlays[] = {
3066     OVERLAY_INFO(overlay_base, -9999),
3067     OVERLAY_INFO(overlay, 0),
3068     OVERLAY_INFO(overlay_0, 0),
3069     OVERLAY_INFO(overlay_1, 0),
3070     OVERLAY_INFO(overlay_2, 0),
3071     OVERLAY_INFO(overlay_3, 0),
3072     OVERLAY_INFO(overlay_4, 0),
3073     OVERLAY_INFO(overlay_5, 0),
3074     OVERLAY_INFO(overlay_6, 0),
3075     OVERLAY_INFO(overlay_7, 0),
3076     OVERLAY_INFO(overlay_8, 0),
3077     OVERLAY_INFO(overlay_9, 0),
3078     OVERLAY_INFO(overlay_10, 0),
3079     OVERLAY_INFO(overlay_11, 0),
3080     OVERLAY_INFO(overlay_12, 0),
3081     OVERLAY_INFO(overlay_13, 0),
3082     OVERLAY_INFO(overlay_15, 0),
3083     OVERLAY_INFO(overlay_16, -EBUSY),
3084     OVERLAY_INFO(overlay_17, -EEXIST),
3085     OVERLAY_INFO(overlay_18, 0),
3086     OVERLAY_INFO(overlay_19, 0),
3087     OVERLAY_INFO(overlay_20, 0),
3088     OVERLAY_INFO(overlay_gpio_01, 0),
3089     OVERLAY_INFO(overlay_gpio_02a, 0),
3090     OVERLAY_INFO(overlay_gpio_02b, 0),
3091     OVERLAY_INFO(overlay_gpio_03, 0),
3092     OVERLAY_INFO(overlay_gpio_04a, 0),
3093     OVERLAY_INFO(overlay_gpio_04b, 0),
3094     OVERLAY_INFO(overlay_bad_add_dup_node, -EINVAL),
3095     OVERLAY_INFO(overlay_bad_add_dup_prop, -EINVAL),
3096     OVERLAY_INFO(overlay_bad_phandle, -EINVAL),
3097     OVERLAY_INFO(overlay_bad_symbol, -EINVAL),
3098     /* end marker */
3099     {.dtb_begin = NULL, .dtb_end = NULL, .expected_result = 0, .name = NULL}
3100 };
3101 
3102 static struct device_node *overlay_base_root;
3103 
3104 static void * __init dt_alloc_memory(u64 size, u64 align)
3105 {
3106     void *ptr = memblock_alloc(size, align);
3107 
3108     if (!ptr)
3109         panic("%s: Failed to allocate %llu bytes align=0x%llx\n",
3110               __func__, size, align);
3111 
3112     return ptr;
3113 }
3114 
3115 /*
3116  * Create base device tree for the overlay unittest.
3117  *
3118  * This is called from very early boot code.
3119  *
3120  * Do as much as possible the same way as done in __unflatten_device_tree
3121  * and other early boot steps for the normal FDT so that the overlay base
3122  * unflattened tree will have the same characteristics as the real tree
3123  * (such as having memory allocated by the early allocator).  The goal
3124  * is to test "the real thing" as much as possible, and test "test setup
3125  * code" as little as possible.
3126  *
3127  * Have to stop before resolving phandles, because that uses kmalloc.
3128  */
3129 void __init unittest_unflatten_overlay_base(void)
3130 {
3131     struct overlay_info *info;
3132     u32 data_size;
3133     void *new_fdt;
3134     u32 size;
3135     int found = 0;
3136     const char *overlay_name = "overlay_base";
3137 
3138     for (info = overlays; info && info->name; info++) {
3139         if (!strcmp(overlay_name, info->name)) {
3140             found = 1;
3141             break;
3142         }
3143     }
3144     if (!found) {
3145         pr_err("no overlay data for %s\n", overlay_name);
3146         return;
3147     }
3148 
3149     info = &overlays[0];
3150 
3151     if (info->expected_result != -9999) {
3152         pr_err("No dtb 'overlay_base' to attach\n");
3153         return;
3154     }
3155 
3156     data_size = info->dtb_end - info->dtb_begin;
3157     if (!data_size) {
3158         pr_err("No dtb 'overlay_base' to attach\n");
3159         return;
3160     }
3161 
3162     size = fdt_totalsize(info->dtb_begin);
3163     if (size != data_size) {
3164         pr_err("dtb 'overlay_base' header totalsize != actual size");
3165         return;
3166     }
3167 
3168     new_fdt = dt_alloc_memory(size, roundup_pow_of_two(FDT_V17_SIZE));
3169     if (!new_fdt) {
3170         pr_err("alloc for dtb 'overlay_base' failed");
3171         return;
3172     }
3173 
3174     memcpy(new_fdt, info->dtb_begin, size);
3175 
3176     __unflatten_device_tree(new_fdt, NULL, &overlay_base_root,
3177                 dt_alloc_memory, true);
3178 }
3179 
3180 /*
3181  * The purpose of of_unittest_overlay_data_add is to add an
3182  * overlay in the normal fashion.  This is a test of the whole
3183  * picture, instead of testing individual elements.
3184  *
3185  * A secondary purpose is to be able to verify that the contents of
3186  * /proc/device-tree/ contains the updated structure and values from
3187  * the overlay.  That must be verified separately in user space.
3188  *
3189  * Return 0 on unexpected error.
3190  */
3191 static int __init overlay_data_apply(const char *overlay_name, int *ovcs_id)
3192 {
3193     struct overlay_info *info;
3194     int found = 0;
3195     int ret;
3196     u32 size;
3197 
3198     for (info = overlays; info && info->name; info++) {
3199         if (!strcmp(overlay_name, info->name)) {
3200             found = 1;
3201             break;
3202         }
3203     }
3204     if (!found) {
3205         pr_err("no overlay data for %s\n", overlay_name);
3206         return 0;
3207     }
3208 
3209     size = info->dtb_end - info->dtb_begin;
3210     if (!size)
3211         pr_err("no overlay data for %s\n", overlay_name);
3212 
3213     ret = of_overlay_fdt_apply(info->dtb_begin, size, &info->ovcs_id);
3214     if (ovcs_id)
3215         *ovcs_id = info->ovcs_id;
3216     if (ret < 0)
3217         goto out;
3218 
3219     pr_debug("%s applied\n", overlay_name);
3220 
3221 out:
3222     if (ret != info->expected_result)
3223         pr_err("of_overlay_fdt_apply() expected %d, ret=%d, %s\n",
3224                info->expected_result, ret, overlay_name);
3225 
3226     return (ret == info->expected_result);
3227 }
3228 
3229 /*
3230  * The purpose of of_unittest_overlay_high_level is to add an overlay
3231  * in the normal fashion.  This is a test of the whole picture,
3232  * instead of individual elements.
3233  *
3234  * The first part of the function is _not_ normal overlay usage; it is
3235  * finishing splicing the base overlay device tree into the live tree.
3236  */
3237 static __init void of_unittest_overlay_high_level(void)
3238 {
3239     struct device_node *last_sibling;
3240     struct device_node *np;
3241     struct device_node *of_symbols;
3242     struct device_node *overlay_base_symbols;
3243     struct device_node **pprev;
3244     struct property *prop;
3245     int ret;
3246 
3247     if (!overlay_base_root) {
3248         unittest(0, "overlay_base_root not initialized\n");
3249         return;
3250     }
3251 
3252     /*
3253      * Could not fixup phandles in unittest_unflatten_overlay_base()
3254      * because kmalloc() was not yet available.
3255      */
3256     of_overlay_mutex_lock();
3257     of_resolve_phandles(overlay_base_root);
3258     of_overlay_mutex_unlock();
3259 
3260 
3261     /*
3262      * do not allow overlay_base to duplicate any node already in
3263      * tree, this greatly simplifies the code
3264      */
3265 
3266     /*
3267      * remove overlay_base_root node "__local_fixups", after
3268      * being used by of_resolve_phandles()
3269      */
3270     pprev = &overlay_base_root->child;
3271     for (np = overlay_base_root->child; np; np = np->sibling) {
3272         if (of_node_name_eq(np, "__local_fixups__")) {
3273             *pprev = np->sibling;
3274             break;
3275         }
3276         pprev = &np->sibling;
3277     }
3278 
3279     /* remove overlay_base_root node "__symbols__" if in live tree */
3280     of_symbols = of_get_child_by_name(of_root, "__symbols__");
3281     if (of_symbols) {
3282         /* will have to graft properties from node into live tree */
3283         pprev = &overlay_base_root->child;
3284         for (np = overlay_base_root->child; np; np = np->sibling) {
3285             if (of_node_name_eq(np, "__symbols__")) {
3286                 overlay_base_symbols = np;
3287                 *pprev = np->sibling;
3288                 break;
3289             }
3290             pprev = &np->sibling;
3291         }
3292     }
3293 
3294     for_each_child_of_node(overlay_base_root, np) {
3295         struct device_node *base_child;
3296         for_each_child_of_node(of_root, base_child) {
3297             if (!strcmp(np->full_name, base_child->full_name)) {
3298                 unittest(0, "illegal node name in overlay_base %pOFn",
3299                      np);
3300                 of_node_put(np);
3301                 of_node_put(base_child);
3302                 return;
3303             }
3304         }
3305     }
3306 
3307     /*
3308      * overlay 'overlay_base' is not allowed to have root
3309      * properties, so only need to splice nodes into main device tree.
3310      *
3311      * root node of *overlay_base_root will not be freed, it is lost
3312      * memory.
3313      */
3314 
3315     for (np = overlay_base_root->child; np; np = np->sibling)
3316         np->parent = of_root;
3317 
3318     mutex_lock(&of_mutex);
3319 
3320     for (last_sibling = np = of_root->child; np; np = np->sibling)
3321         last_sibling = np;
3322 
3323     if (last_sibling)
3324         last_sibling->sibling = overlay_base_root->child;
3325     else
3326         of_root->child = overlay_base_root->child;
3327 
3328     for_each_of_allnodes_from(overlay_base_root, np)
3329         __of_attach_node_sysfs(np);
3330 
3331     if (of_symbols) {
3332         struct property *new_prop;
3333         for_each_property_of_node(overlay_base_symbols, prop) {
3334 
3335             new_prop = __of_prop_dup(prop, GFP_KERNEL);
3336             if (!new_prop) {
3337                 unittest(0, "__of_prop_dup() of '%s' from overlay_base node __symbols__",
3338                      prop->name);
3339                 goto err_unlock;
3340             }
3341             if (__of_add_property(of_symbols, new_prop)) {
3342                 kfree(new_prop->name);
3343                 kfree(new_prop->value);
3344                 kfree(new_prop);
3345                 /* "name" auto-generated by unflatten */
3346                 if (!strcmp(prop->name, "name"))
3347                     continue;
3348                 unittest(0, "duplicate property '%s' in overlay_base node __symbols__",
3349                      prop->name);
3350                 goto err_unlock;
3351             }
3352             if (__of_add_property_sysfs(of_symbols, new_prop)) {
3353                 unittest(0, "unable to add property '%s' in overlay_base node __symbols__ to sysfs",
3354                      prop->name);
3355                 goto err_unlock;
3356             }
3357         }
3358     }
3359 
3360     mutex_unlock(&of_mutex);
3361 
3362 
3363     /* now do the normal overlay usage test */
3364 
3365     EXPECT_BEGIN(KERN_ERR,
3366              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/substation@100/status");
3367     EXPECT_BEGIN(KERN_ERR,
3368              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/status");
3369     EXPECT_BEGIN(KERN_ERR,
3370              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/ride@100/track@30/incline-up");
3371     EXPECT_BEGIN(KERN_ERR,
3372              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/ride@100/track@40/incline-up");
3373     EXPECT_BEGIN(KERN_ERR,
3374              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/status");
3375     EXPECT_BEGIN(KERN_ERR,
3376              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/color");
3377     EXPECT_BEGIN(KERN_ERR,
3378              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/rate");
3379     EXPECT_BEGIN(KERN_ERR,
3380              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/hvac_2");
3381     EXPECT_BEGIN(KERN_ERR,
3382              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200");
3383     EXPECT_BEGIN(KERN_ERR,
3384              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200_left");
3385     EXPECT_BEGIN(KERN_ERR,
3386              "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200_right");
3387 
3388     ret = overlay_data_apply("overlay", NULL);
3389 
3390     EXPECT_END(KERN_ERR,
3391            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200_right");
3392     EXPECT_END(KERN_ERR,
3393            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200_left");
3394     EXPECT_END(KERN_ERR,
3395            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200");
3396     EXPECT_END(KERN_ERR,
3397            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/hvac_2");
3398     EXPECT_END(KERN_ERR,
3399            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/rate");
3400     EXPECT_END(KERN_ERR,
3401            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/color");
3402     EXPECT_END(KERN_ERR,
3403            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/status");
3404     EXPECT_END(KERN_ERR,
3405            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/ride@100/track@40/incline-up");
3406     EXPECT_END(KERN_ERR,
3407            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/ride@100/track@30/incline-up");
3408     EXPECT_END(KERN_ERR,
3409            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/status");
3410     EXPECT_END(KERN_ERR,
3411            "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/substation@100/status");
3412 
3413     unittest(ret, "Adding overlay 'overlay' failed\n");
3414 
3415     EXPECT_BEGIN(KERN_ERR,
3416              "OF: overlay: ERROR: multiple fragments add and/or delete node /testcase-data-2/substation@100/motor-1/controller");
3417     EXPECT_BEGIN(KERN_ERR,
3418              "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/controller/name");
3419 
3420     unittest(overlay_data_apply("overlay_bad_add_dup_node", NULL),
3421          "Adding overlay 'overlay_bad_add_dup_node' failed\n");
3422 
3423     EXPECT_END(KERN_ERR,
3424            "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/controller/name");
3425     EXPECT_END(KERN_ERR,
3426            "OF: overlay: ERROR: multiple fragments add and/or delete node /testcase-data-2/substation@100/motor-1/controller");
3427 
3428     EXPECT_BEGIN(KERN_ERR,
3429              "OF: overlay: ERROR: multiple fragments add and/or delete node /testcase-data-2/substation@100/motor-1/electric");
3430     EXPECT_BEGIN(KERN_ERR,
3431              "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/electric/rpm_avail");
3432     EXPECT_BEGIN(KERN_ERR,
3433              "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/electric/name");
3434 
3435     unittest(overlay_data_apply("overlay_bad_add_dup_prop", NULL),
3436          "Adding overlay 'overlay_bad_add_dup_prop' failed\n");
3437 
3438     EXPECT_END(KERN_ERR,
3439              "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/electric/name");
3440     EXPECT_END(KERN_ERR,
3441              "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/electric/rpm_avail");
3442     EXPECT_END(KERN_ERR,
3443              "OF: overlay: ERROR: multiple fragments add and/or delete node /testcase-data-2/substation@100/motor-1/electric");
3444 
3445     unittest(overlay_data_apply("overlay_bad_phandle", NULL),
3446          "Adding overlay 'overlay_bad_phandle' failed\n");
3447 
3448     unittest(overlay_data_apply("overlay_bad_symbol", NULL),
3449          "Adding overlay 'overlay_bad_symbol' failed\n");
3450 
3451     return;
3452 
3453 err_unlock:
3454     mutex_unlock(&of_mutex);
3455 }
3456 
3457 #else
3458 
3459 static inline __init void of_unittest_overlay_high_level(void) {}
3460 
3461 #endif
3462 
3463 static int __init of_unittest(void)
3464 {
3465     struct device_node *np;
3466     int res;
3467 
3468     pr_info("start of unittest - you will see error messages\n");
3469 
3470     /* adding data for unittest */
3471 
3472     if (IS_ENABLED(CONFIG_UML))
3473         unittest_unflatten_overlay_base();
3474 
3475     res = unittest_data_add();
3476     if (res)
3477         return res;
3478     if (!of_aliases)
3479         of_aliases = of_find_node_by_path("/aliases");
3480 
3481     np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
3482     if (!np) {
3483         pr_info("No testcase data in device tree; not running tests\n");
3484         return 0;
3485     }
3486     of_node_put(np);
3487 
3488     of_unittest_check_tree_linkage();
3489     of_unittest_check_phandles();
3490     of_unittest_find_node_by_name();
3491     of_unittest_dynamic();
3492     of_unittest_parse_phandle_with_args();
3493     of_unittest_parse_phandle_with_args_map();
3494     of_unittest_printf();
3495     of_unittest_property_string();
3496     of_unittest_property_copy();
3497     of_unittest_changeset();
3498     of_unittest_parse_interrupts();
3499     of_unittest_parse_interrupts_extended();
3500     of_unittest_dma_get_max_cpu_address();
3501     of_unittest_parse_dma_ranges();
3502     of_unittest_pci_dma_ranges();
3503     of_unittest_match_node();
3504     of_unittest_platform_populate();
3505     of_unittest_overlay();
3506 
3507     /* Double check linkage after removing testcase data */
3508     of_unittest_check_tree_linkage();
3509 
3510     of_unittest_overlay_high_level();
3511 
3512     pr_info("end of unittest - %i passed, %i failed\n",
3513         unittest_results.passed, unittest_results.failed);
3514 
3515     return 0;
3516 }
3517 late_initcall(of_unittest);