Dynamic definition scope hierarchy

[babeltrace.git] / include / babeltrace / types.h

diff --git a/include/babeltrace/types.h b/include/babeltrace/types.h
index 885a6a1b85c07ff1195e85b051606b8d6e5fb87f..34e49aef18b7be474fb74f7221701f5e709deae4 100644 (file)
--- a/include/babeltrace/types.h
+++ b/include/babeltrace/types.h
@@ -107,8 +107,11 @@ struct definition_scope {
        struct definition_scope *parent_scope;
        /*
         * Complete "path" leading to this definition scope.
        struct definition_scope *parent_scope;
        /*
         * Complete "path" leading to this definition scope.

-        * Includes trace/stream/event '.' field name '.' field name '.' ....
+        * Includes dynamic scope name '.' field name '.' field name '.' ....

         * Array of GQuark elements (which are each separated by dots).
         * Array of GQuark elements (which are each separated by dots).

+        * The dynamic scope name can contain dots, and is encoded into
+        * a single GQuark. Thus, scope_path[0] returns the GQuark
+        * identifying the dynamic scope.

         */
        GArray *scope_path;     /* array of GQuark */
 };
         */
        GArray *scope_path;     /* array of GQuark */
 };


@@ -377,6 +380,9 @@ int register_field_definition(GQuark field_name,
 struct definition_scope *
        new_definition_scope(struct definition_scope *parent_scope,
                             GQuark field_name);
 struct definition_scope *
        new_definition_scope(struct definition_scope *parent_scope,
                             GQuark field_name);

+struct definition_scope *
+       new_dynamic_definition_scope(struct definition_scope *parent_scope,
+                                    GQuark field_name);

 void free_definition_scope(struct definition_scope *scope);
 
 void declaration_ref(struct declaration *declaration);
 void free_definition_scope(struct definition_scope *scope);
 
 void declaration_ref(struct declaration *declaration);