On Mon, Jan 12, 2026 at 03:19:09PM +0100, Herve Codina wrote:
> Export symbols allow to define a list of symbols exported at a given
> node level. Those exported symbols can be used by an addon when the
> addon is applied on the node exporting the symbols.
This seems to imply an addon always applies at a single node location.
I'm not sure that's a good design choice, since I don't see how it
covers the case of something that connects to several connectors.
> In order to perform
> its symbol resolution. Any unresolved phandle value will be resolved
> using those exported symbols.
>
> The feature is similar to __symbols__ involved with overlay but while
> all symbols are visible with __symbols__, only specific symbols
> (exported symbols) are visible with export symbols.
This paragraph doesn't make sense to me. What's a "symbol" if it's
not something in __symbols__ or export symbols?
> Also an exported symbol has a specific name and this name has to
> used for symbol resolution. Having this specific name allows to:
>
> - Have several nodes providing the same exported symbols
> name but each of them pointing to different nodes.
That's not a property of having a specific name, that's a property of
being local to a node.
> Without looking at the detail of the syntax, node-a and node-b
> export the same symbol foo but pointing to different node.
> node-a {
> /* export foo -> /path/foo1 */
> };
> node-b {
> /* export foo -> /path/foo2 */
> };
>
> This allow to have the exact same addon referencing 'foo' applied
> either on node-a or node-b.
>
> - Have several board describing a well defined node even if resources
> needed for exported symbols are not the same.
>
> On board A, the 'ctrl' exported symbols points to some ctrl device
> available on the SoC:
> node {
> /* export 'ctrl' -> /soc/ctrl@1000
> };
>
> On board B, the ctrl device used is on a i2c bus
> node {
> /* export 'ctrl' -> /soc/i2c@5000/ctrl@10
> };
>
> The addon can be used on board A and board B without any
> modification. It uses 'ctrl' exported by the node the it is applied
> to.
>
> Introduce the 'symbol' internal data structure and the export symbol
> list related to a node.
>
> No functional change yet but preparation for the future support
> for export symbol parsing.
>
> Signed-off-by: Herve Codina <herve.codina@bootlin.com>
> ---
> dtc-parser.y | 6 +++---
> dtc.h | 13 ++++++++++++-
> flattree.c | 2 +-
> fstree.c | 2 +-
> livetree.c | 7 ++++---
> 5 files changed, 21 insertions(+), 9 deletions(-)
>
> diff --git a/dtc-parser.y b/dtc-parser.y
> index 2e152b0..9c93673 100644
> --- a/dtc-parser.y
> +++ b/dtc-parser.y
> @@ -183,7 +183,7 @@ devicetree:
> else if (is_ref_relative($1))
> ERROR(&@2, "Label-relative reference %s not supported in plugin", $1);
> $$ = add_orphan_node(
> - name_node(build_node(NULL, NULL, NULL),
> + name_node(build_node(NULL, NULL, NULL, NULL),
> ""),
> $2, $1);
> }
> @@ -270,11 +270,11 @@ devicetree:
> nodedef:
> '{' proplist subnodes '}' ';'
> {
> - $$ = build_node($2, $3, &@$);
> + $$ = build_node($2, $3, NULL, &@$);
> }
> | '{' subnodes '}' ';'
> {
> - $$ = build_node(NULL, $2, &@$);
> + $$ = build_node(NULL, $2, NULL, &@$);
> }
> ;
>
> diff --git a/dtc.h b/dtc.h
> index c0fffd2..6508694 100644
> --- a/dtc.h
> +++ b/dtc.h
> @@ -204,6 +204,16 @@ struct label {
> struct label *next;
> };
>
> +struct symbol {
> + bool is_local;
> + char *name;
> + char *ref;
> + cell_t phandle;
> + char *fullpath;
> + struct symbol *next;
> + struct srcpos *srcpos;
> +};
> +
> struct bus_type {
> const char *name;
> };
> @@ -224,6 +234,7 @@ struct node {
> char *name;
> struct property *proplist;
> struct node *children;
> + struct symbol *exportsymlist;
>
> struct node *parent;
> struct node *next_sibling;
> @@ -272,7 +283,7 @@ struct property *chain_property(struct property *first, struct property *list);
> struct property *reverse_properties(struct property *first);
>
> struct node *build_node(struct property *proplist, struct node *children,
> - struct srcpos *srcpos);
> + struct symbol *exportsymlist, struct srcpos *srcpos);
> struct node *build_node_delete(struct srcpos *srcpos);
> struct node *name_node(struct node *node, const char *name);
> struct node *omit_node_if_unused(struct node *node);
> diff --git a/flattree.c b/flattree.c
> index bedb286..36b795d 100644
> --- a/flattree.c
> +++ b/flattree.c
> @@ -809,7 +809,7 @@ static struct node *unflatten_tree(struct inbuf *dtbuf,
> uint32_t offset;
> const char *str;
>
> - node = build_node(NULL, NULL, NULL);
> + node = build_node(NULL, NULL, NULL, NULL);
>
> flatname = flat_read_string(dtbuf);
>
> diff --git a/fstree.c b/fstree.c
> index 0f9a534..445ae53 100644
> --- a/fstree.c
> +++ b/fstree.c
> @@ -19,7 +19,7 @@ static struct node *read_fstree(const char *dirname)
> if (!d)
> die("Couldn't opendir() \"%s\": %s\n", dirname, strerror(errno));
>
> - tree = build_node(NULL, NULL, NULL);
> + tree = build_node(NULL, NULL, NULL, NULL);
>
> while ((de = readdir(d)) != NULL) {
> char *tmpname;
> diff --git a/livetree.c b/livetree.c
> index 2a0a7ed..0050492 100644
> --- a/livetree.c
> +++ b/livetree.c
> @@ -86,7 +86,7 @@ struct property *reverse_properties(struct property *first)
> }
>
> struct node *build_node(struct property *proplist, struct node *children,
> - struct srcpos *srcpos)
> + struct symbol *exportsymlist, struct srcpos *srcpos)
> {
> struct node *new = xmalloc(sizeof(*new));
> struct node *child;
> @@ -95,6 +95,7 @@ struct node *build_node(struct property *proplist, struct node *children,
>
> new->proplist = reverse_properties(proplist);
> new->children = children;
> + new->exportsymlist = exportsymlist;
> new->srcpos = srcpos_copy(srcpos);
>
> for_each_child(new, child) {
> @@ -248,7 +249,7 @@ struct node * add_orphan_node(struct node *dt, struct node *new_node, char *ref)
> xasprintf(&name, "fragment@%u",
> next_orphan_fragment++);
> name_node(new_node, "__overlay__");
> - node = build_node(p, new_node, NULL);
> + node = build_node(p, new_node, NULL, NULL);
> name_node(node, name);
> free(name);
>
> @@ -892,7 +893,7 @@ static struct node *build_and_name_child_node(struct node *parent, const char *n
> {
> struct node *node;
>
> - node = build_node(NULL, NULL, NULL);
> + node = build_node(NULL, NULL, NULL, NULL);
> name_node(node, name);
> add_child(parent, node);
>
> --
> 2.52.0
>
>
--
David Gibson (he or they) | 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