From: David Gibson <david-xT8FGy+AXnRB3Ne2BGzF6laj5H9X9Tb+@public.gmane.org>
To: Rob Herring <robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>
Cc: Julia Lawall <Julia.Lawall-L2FTfq7BK8M@public.gmane.org>,
devicetree-compiler-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
Subject: Re: [PATCH 2/3] checks: centralize printing of property names in failure messages
Date: Sat, 10 Feb 2018 12:09:33 +1100 [thread overview]
Message-ID: <20180210010933.GK11634@umbus.fritz.box> (raw)
In-Reply-To: <20180131145705.21335-3-robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>
[-- Attachment #1: Type: text/plain, Size: 16790 bytes --]
On Wed, Jan 31, 2018 at 08:57:04AM -0600, Rob Herring wrote:
> Some failure messages apply to a specific property. Add a FAIL_PROP()
> macro for failure messages which are specific to a property. With that,
> failure messages can print the property name in a standard way. Once
> source line numbers are supported, then the file and line number of the
> property can be used instead of the node file and line number.
>
> Convert the existing messages related to properties to use the FAIL_PROP
> macro and reword the messages as necessary.
>
> Signed-off-by: Rob Herring <robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>
Applied, thanks.
> ---
> checks.c | 148 ++++++++++++++++++++++++++++++++++-----------------------------
> 1 file changed, 80 insertions(+), 68 deletions(-)
>
> diff --git a/checks.c b/checks.c
> index 54df014c1c79..c07ba4da9e36 100644
> --- a/checks.c
> +++ b/checks.c
> @@ -72,8 +72,9 @@ struct check {
> #define CHECK(nm_, fn_, d_, ...) \
> CHECK_ENTRY(nm_, fn_, d_, false, false, __VA_ARGS__)
>
> -static inline void PRINTF(4, 5) check_msg(struct check *c, struct dt_info *dti,
> +static inline void PRINTF(5, 6) check_msg(struct check *c, struct dt_info *dti,
> struct node *node,
> + struct property *prop,
> const char *fmt, ...)
> {
> va_list ap;
> @@ -84,8 +85,12 @@ static inline void PRINTF(4, 5) check_msg(struct check *c, struct dt_info *dti,
> fprintf(stderr, "%s: %s (%s): ",
> strcmp(dti->outname, "-") ? dti->outname : "<stdout>",
> (c->error) ? "ERROR" : "Warning", c->name);
> - if (node)
> - fprintf(stderr, "%s: ", node->fullpath);
> + if (node) {
> + fprintf(stderr, "%s", node->fullpath);
> + if (prop)
> + fprintf(stderr, ":%s", prop->name);
> + fputs(": ", stderr);
> + }
> vfprintf(stderr, fmt, ap);
> fprintf(stderr, "\n");
> }
> @@ -96,9 +101,17 @@ static inline void PRINTF(4, 5) check_msg(struct check *c, struct dt_info *dti,
> do { \
> TRACE((c), "\t\tFAILED at %s:%d", __FILE__, __LINE__); \
> (c)->status = FAILED; \
> - check_msg((c), dti, node, __VA_ARGS__); \
> + check_msg((c), dti, node, NULL, __VA_ARGS__); \
> + } while (0)
> +
> +#define FAIL_PROP(c, dti, node, prop, ...) \
> + do { \
> + TRACE((c), "\t\tFAILED at %s:%d", __FILE__, __LINE__); \
> + (c)->status = FAILED; \
> + check_msg((c), dti, node, prop, __VA_ARGS__); \
> } while (0)
>
> +
> static void check_nodes_props(struct check *c, struct dt_info *dti, struct node *node)
> {
> struct node *child;
> @@ -129,7 +142,7 @@ static bool run_check(struct check *c, struct dt_info *dti)
> error = error || run_check(prq, dti);
> if (prq->status != PASSED) {
> c->status = PREREQ;
> - check_msg(c, dti, NULL, "Failed prerequisite '%s'",
> + check_msg(c, dti, NULL, NULL, "Failed prerequisite '%s'",
> c->prereq[i]->name);
> }
> }
> @@ -174,7 +187,7 @@ static void check_is_string(struct check *c, struct dt_info *dti,
> return; /* Not present, assumed ok */
>
> if (!data_is_one_string(prop->val))
> - FAIL(c, dti, node, "\"%s\" property is not a string", propname);
> + FAIL_PROP(c, dti, node, prop, "property is not a string");
> }
> #define WARNING_IF_NOT_STRING(nm, propname) \
> WARNING(nm, check_is_string, (propname))
> @@ -198,8 +211,7 @@ static void check_is_string_list(struct check *c, struct dt_info *dti,
> while (rem > 0) {
> l = strnlen(str, rem);
> if (l == rem) {
> - FAIL(c, dti, node, "\"%s\" property is not a string list",
> - propname);
> + FAIL_PROP(c, dti, node, prop, "property is not a string list");
> break;
> }
> rem -= l + 1;
> @@ -222,8 +234,7 @@ static void check_is_cell(struct check *c, struct dt_info *dti,
> return; /* Not present, assumed ok */
>
> if (prop->val.len != sizeof(cell_t))
> - FAIL(c, dti, node, "\"%s\" property is not a single cell",
> - propname);
> + FAIL_PROP(c, dti, node, prop, "property is not a single cell");
> }
> #define WARNING_IF_NOT_CELL(nm, propname) \
> WARNING(nm, check_is_cell, (propname))
> @@ -258,8 +269,7 @@ static void check_duplicate_property_names(struct check *c, struct dt_info *dti,
> if (prop2->deleted)
> continue;
> if (streq(prop->name, prop2->name))
> - FAIL(c, dti, node, "Duplicate property name %s",
> - prop->name);
> + FAIL_PROP(c, dti, node, prop, "Duplicate property name");
> }
> }
> }
> @@ -332,8 +342,8 @@ static void check_property_name_chars(struct check *c, struct dt_info *dti,
> int n = strspn(prop->name, c->data);
>
> if (n < strlen(prop->name))
> - FAIL(c, dti, node, "Bad character '%c' in property name \"%s\"",
> - prop->name[n], prop->name);
> + FAIL_PROP(c, dti, node, prop, "Bad character '%c' in property name",
> + prop->name[n]);
> }
> }
> ERROR(property_name_chars, check_property_name_chars, PROPNODECHARS);
> @@ -364,8 +374,8 @@ static void check_property_name_chars_strict(struct check *c,
> n = strspn(name, c->data);
> }
> if (n < strlen(name))
> - FAIL(c, dti, node, "Character '%c' not recommended in property name \"%s\"",
> - name[n], prop->name);
> + FAIL_PROP(c, dti, node, prop, "Character '%c' not recommended in property name",
> + name[n]);
> }
> }
> CHECK(property_name_chars_strict, check_property_name_chars_strict, PROPNODECHARSSTRICT);
> @@ -438,8 +448,8 @@ static cell_t check_phandle_prop(struct check *c, struct dt_info *dti,
> return 0;
>
> if (prop->val.len != sizeof(cell_t)) {
> - FAIL(c, dti, node, "bad length (%d) %s property",
> - prop->val.len, prop->name);
> + FAIL_PROP(c, dti, node, prop, "bad length (%d) %s property",
> + prop->val.len, prop->name);
> return 0;
> }
>
> @@ -464,7 +474,7 @@ static cell_t check_phandle_prop(struct check *c, struct dt_info *dti,
> phandle = propval_cell(prop);
>
> if ((phandle == 0) || (phandle == -1)) {
> - FAIL(c, dti, node, "bad value (0x%x) in %s property",
> + FAIL_PROP(c, dti, node, prop, "bad value (0x%x) in %s property",
> phandle, prop->name);
> return 0;
> }
> @@ -644,14 +654,12 @@ static void check_alias_paths(struct check *c, struct dt_info *dti,
>
> for_each_property(node, prop) {
> if (!prop->val.val || !get_node_by_path(dti->dt, prop->val.val)) {
> - FAIL(c, dti, node, "aliases property '%s' is not a valid node (%s)",
> - prop->name, prop->val.val);
> + FAIL_PROP(c, dti, node, prop, "aliases property is not a valid node (%s)",
> + prop->val.val);
> continue;
> }
> if (strspn(prop->name, LOWERCASE DIGITS "-") != strlen(prop->name))
> - FAIL(c, dti, node, "aliases property name '%s' is not valid",
> - prop->name);
> -
> + FAIL(c, dti, node, "aliases property name must include only lowercase and '-'");
> }
> }
> WARNING(alias_paths, check_alias_paths, NULL);
> @@ -696,16 +704,16 @@ static void check_reg_format(struct check *c, struct dt_info *dti,
> }
>
> if (prop->val.len == 0)
> - FAIL(c, dti, node, "\"reg\" property is empty");
> + FAIL_PROP(c, dti, node, prop, "property is empty");
>
> addr_cells = node_addr_cells(node->parent);
> size_cells = node_size_cells(node->parent);
> entrylen = (addr_cells + size_cells) * sizeof(cell_t);
>
> if (!entrylen || (prop->val.len % entrylen) != 0)
> - FAIL(c, dti, node, "\"reg\" property has invalid length (%d bytes) "
> - "(#address-cells == %d, #size-cells == %d)",
> - prop->val.len, addr_cells, size_cells);
> + FAIL_PROP(c, dti, node, prop, "property has invalid length (%d bytes) "
> + "(#address-cells == %d, #size-cells == %d)",
> + prop->val.len, addr_cells, size_cells);
> }
> WARNING(reg_format, check_reg_format, NULL, &addr_size_cells);
>
> @@ -720,7 +728,7 @@ static void check_ranges_format(struct check *c, struct dt_info *dti,
> return;
>
> if (!node->parent) {
> - FAIL(c, dti, node, "Root node has a \"ranges\" property");
> + FAIL_PROP(c, dti, node, prop, "Root node has a \"ranges\" property");
> return;
> }
>
> @@ -732,20 +740,20 @@ static void check_ranges_format(struct check *c, struct dt_info *dti,
>
> if (prop->val.len == 0) {
> if (p_addr_cells != c_addr_cells)
> - FAIL(c, dti, node, "empty \"ranges\" property but its "
> - "#address-cells (%d) differs from %s (%d)",
> - c_addr_cells, node->parent->fullpath,
> - p_addr_cells);
> + FAIL_PROP(c, dti, node, prop, "empty \"ranges\" property but its "
> + "#address-cells (%d) differs from %s (%d)",
> + c_addr_cells, node->parent->fullpath,
> + p_addr_cells);
> if (p_size_cells != c_size_cells)
> - FAIL(c, dti, node, "empty \"ranges\" property but its "
> - "#size-cells (%d) differs from %s (%d)",
> - c_size_cells, node->parent->fullpath,
> - p_size_cells);
> + FAIL_PROP(c, dti, node, prop, "empty \"ranges\" property but its "
> + "#size-cells (%d) differs from %s (%d)",
> + c_size_cells, node->parent->fullpath,
> + p_size_cells);
> } else if ((prop->val.len % entrylen) != 0) {
> - FAIL(c, dti, node, "\"ranges\" property has invalid length (%d bytes) "
> - "(parent #address-cells == %d, child #address-cells == %d, "
> - "#size-cells == %d)", prop->val.len,
> - p_addr_cells, c_addr_cells, c_size_cells);
> + FAIL_PROP(c, dti, node, prop, "\"ranges\" property has invalid length (%d bytes) "
> + "(parent #address-cells == %d, child #address-cells == %d, "
> + "#size-cells == %d)", prop->val.len,
> + p_addr_cells, c_addr_cells, c_size_cells);
> }
> }
> WARNING(ranges_format, check_ranges_format, NULL, &addr_size_cells);
> @@ -784,14 +792,14 @@ static void check_pci_bridge(struct check *c, struct dt_info *dti, struct node *
> return;
> }
> if (prop->val.len != (sizeof(cell_t) * 2)) {
> - FAIL(c, dti, node, "bus-range must be 2 cells");
> + FAIL_PROP(c, dti, node, prop, "value must be 2 cells");
> return;
> }
> cells = (cell_t *)prop->val.val;
> if (fdt32_to_cpu(cells[0]) > fdt32_to_cpu(cells[1]))
> - FAIL(c, dti, node, "bus-range 1st cell must be less than or equal to 2nd cell");
> + FAIL_PROP(c, dti, node, prop, "1st cell must be less than or equal to 2nd cell");
> if (fdt32_to_cpu(cells[1]) > 0xff)
> - FAIL(c, dti, node, "bus-range maximum bus number must be less than 256");
> + FAIL_PROP(c, dti, node, prop, "maximum bus number must be less than 256");
> }
> WARNING(pci_bridge, check_pci_bridge, NULL,
> &device_type_is_string, &addr_size_cells);
> @@ -821,8 +829,8 @@ static void check_pci_device_bus_num(struct check *c, struct dt_info *dti, struc
> max_bus = fdt32_to_cpu(cells[0]);
> }
> if ((bus_num < min_bus) || (bus_num > max_bus))
> - FAIL(c, dti, node, "PCI bus number %d out of range, expected (%d - %d)",
> - bus_num, min_bus, max_bus);
> + FAIL_PROP(c, dti, node, prop, "PCI bus number %d out of range, expected (%d - %d)",
> + bus_num, min_bus, max_bus);
> }
> WARNING(pci_device_bus_num, check_pci_device_bus_num, NULL, ®_format, &pci_bridge);
>
> @@ -845,16 +853,16 @@ static void check_pci_device_reg(struct check *c, struct dt_info *dti, struct no
>
> cells = (cell_t *)prop->val.val;
> if (cells[1] || cells[2])
> - FAIL(c, dti, node, "PCI reg config space address cells 2 and 3 must be 0");
> + FAIL_PROP(c, dti, node, prop, "PCI reg config space address cells 2 and 3 must be 0");
>
> reg = fdt32_to_cpu(cells[0]);
> dev = (reg & 0xf800) >> 11;
> func = (reg & 0x700) >> 8;
>
> if (reg & 0xff000000)
> - FAIL(c, dti, node, "PCI reg address is not configuration space");
> + FAIL_PROP(c, dti, node, prop, "PCI reg address is not configuration space");
> if (reg & 0x000000ff)
> - FAIL(c, dti, node, "PCI reg config space address register number must be 0");
> + FAIL_PROP(c, dti, node, prop, "PCI reg config space address register number must be 0");
>
> if (func == 0) {
> snprintf(unit_addr, sizeof(unit_addr), "%x", dev);
> @@ -1028,8 +1036,8 @@ static void check_obsolete_chosen_interrupt_controller(struct check *c,
>
> prop = get_property(chosen, "interrupt-controller");
> if (prop)
> - FAIL(c, dti, node, "/chosen has obsolete \"interrupt-controller\" "
> - "property");
> + FAIL_PROP(c, dti, node, prop,
> + "/chosen has obsolete \"interrupt-controller\" property");
> }
> WARNING(obsolete_chosen_interrupt_controller,
> check_obsolete_chosen_interrupt_controller, NULL);
> @@ -1075,7 +1083,7 @@ static void check_chosen_node_stdout_path(struct check *c, struct dt_info *dti,
> prop = get_property(node, "linux,stdout-path");
> if (!prop)
> return;
> - FAIL(c, dti, node, "Use 'stdout-path' instead of 'linux,stdout-path'");
> + FAIL_PROP(c, dti, node, prop, "Use 'stdout-path' instead");
> }
>
> c->data = prop->name;
> @@ -1099,8 +1107,9 @@ static void check_property_phandle_args(struct check *c,
> int cell, cellsize = 0;
>
> if (prop->val.len % sizeof(cell_t)) {
> - FAIL(c, dti, node, "property '%s' size (%d) is invalid, expected multiple of %zu",
> - prop->name, prop->val.len, sizeof(cell_t));
> + FAIL_PROP(c, dti, node, prop,
> + "property size (%d) is invalid, expected multiple of %zu",
> + prop->val.len, sizeof(cell_t));
> return;
> }
>
> @@ -1131,14 +1140,16 @@ static void check_property_phandle_args(struct check *c,
> break;
> }
> if (!m)
> - FAIL(c, dti, node, "Property '%s', cell %d is not a phandle reference",
> - prop->name, cell);
> + FAIL_PROP(c, dti, node, prop,
> + "cell %d is not a phandle reference",
> + cell);
> }
>
> provider_node = get_node_by_phandle(root, phandle);
> if (!provider_node) {
> - FAIL(c, dti, node, "Could not get phandle node for %s(cell %d)",
> - prop->name, cell);
> + FAIL_PROP(c, dti, node, prop,
> + "Could not get phandle node for (cell %d)",
> + cell);
> break;
> }
>
> @@ -1156,8 +1167,9 @@ static void check_property_phandle_args(struct check *c,
> }
>
> if (prop->val.len < ((cell + cellsize + 1) * sizeof(cell_t))) {
> - FAIL(c, dti, node, "%s property size (%d) too small for cell size %d",
> - prop->name, prop->val.len, cellsize);
> + FAIL_PROP(c, dti, node, prop,
> + "property size (%d) too small for cell size %d",
> + prop->val.len, cellsize);
> }
> }
> }
> @@ -1259,8 +1271,8 @@ static void check_deprecated_gpio_property(struct check *c,
> if (!streq(str, "gpio"))
> continue;
>
> - FAIL(c, dti, node, "'[*-]gpio' is deprecated, use '[*-]gpios' instead for %s",
> - prop->name);
> + FAIL_PROP(c, dti, node, prop,
> + "'[*-]gpio' is deprecated, use '[*-]gpios' instead");
> }
>
> }
> @@ -1294,8 +1306,8 @@ static void check_interrupts_property(struct check *c,
> return;
>
> if (irq_prop->val.len % sizeof(cell_t))
> - FAIL(c, dti, node, "property '%s' size (%d) is invalid, expected multiple of %zu",
> - irq_prop->name, irq_prop->val.len, sizeof(cell_t));
> + FAIL_PROP(c, dti, node, irq_prop, "size (%d) is invalid, expected multiple of %zu",
> + irq_prop->val.len, sizeof(cell_t));
>
> while (parent && !prop) {
> if (parent != node && node_is_interrupt_provider(parent)) {
> @@ -1313,7 +1325,7 @@ static void check_interrupts_property(struct check *c,
>
> irq_node = get_node_by_phandle(root, phandle);
> if (!irq_node) {
> - FAIL(c, dti, node, "Bad interrupt-parent phandle");
> + FAIL_PROP(c, dti, parent, prop, "Bad phandle");
> return;
> }
> if (!node_is_interrupt_provider(irq_node))
> @@ -1339,9 +1351,9 @@ static void check_interrupts_property(struct check *c,
>
> irq_cells = propval_cell(prop);
> if (irq_prop->val.len % (irq_cells * sizeof(cell_t))) {
> - FAIL(c, dti, node,
> - "interrupts size is (%d), expected multiple of %d",
> - irq_prop->val.len, (int)(irq_cells * sizeof(cell_t)));
> + FAIL_PROP(c, dti, node, prop,
> + "size is (%d), expected multiple of %d",
> + irq_prop->val.len, (int)(irq_cells * sizeof(cell_t)));
> }
> }
> WARNING(interrupts_property, check_interrupts_property, &phandle_references);
--
David Gibson | I'll have my music baroque, and my code
david AT gibson.dropbear.id.au | minimalist, thank you. NOT _the_ _other_
| _way_ _around_!
http://www.ozlabs.org/~dgibson
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
next prev parent reply other threads:[~2018-02-10 1:09 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-01-31 14:57 [PATCH 0/3] checks: failure message improvements Rob Herring
[not found] ` <20180131145705.21335-1-robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>
2018-01-31 14:57 ` [PATCH 1/3] checks: centralize printing of node path in check_msg Rob Herring
[not found] ` <20180131145705.21335-2-robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>
2018-02-09 6:53 ` David Gibson
2018-01-31 14:57 ` [PATCH 2/3] checks: centralize printing of property names in failure messages Rob Herring
[not found] ` <20180131145705.21335-3-robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>
2018-02-10 1:09 ` David Gibson [this message]
2018-01-31 14:57 ` [PATCH 3/3] checks: Use source position information for check failures Rob Herring
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20180210010933.GK11634@umbus.fritz.box \
--to=david-xt8fgy+axnrb3ne2bgzf6laj5h9x9tb+@public.gmane.org \
--cc=Julia.Lawall-L2FTfq7BK8M@public.gmane.org \
--cc=devicetree-compiler-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
--cc=robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).