include/babeltrace/plugin/plugin-dev.h

   1 #ifndef BABELTRACE_PLUGIN_PLUGIN_DEV_H
   2 #define BABELTRACE_PLUGIN_PLUGIN_DEV_H
   3
   4 /*
   5  * BabelTrace - Babeltrace Plug-in Development API
   6  *
   7  * This is the header that you need to include for the development of
   8  * a Babeltrace plug-in.
   9  *
  10  * Copyright 2015 Jérémie Galarneau <jeremie.galarneau@efficios.com>
  11  * Copyright 2017 Philippe Proulx <pproulx@efficios.com>
  12  *
  13  * Author: Jérémie Galarneau <jeremie.galarneau@efficios.com>
  14  *
  15  * Permission is hereby granted, free of charge, to any person obtaining a copy
  16  * of this software and associated documentation files (the "Software"), to deal
  17  * in the Software without restriction, including without limitation the rights
  18  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  19  * copies of the Software, and to permit persons to whom the Software is
  20  * furnished to do so, subject to the following conditions:
  21  *
  22  * The above copyright notice and this permission notice shall be included in
  23  * all copies or substantial portions of the Software.
  24  *
  25  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  26  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  27  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  28  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  29  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  30  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  31  * SOFTWARE.
  32  */
  33
  34 #include <stdint.h>
  35 #include <babeltrace/plugin/plugin.h>
  36 #include <babeltrace/graph/component-class.h>
  37 #include <babeltrace/graph/component-class-source.h>
  38 #include <babeltrace/graph/component-class-filter.h>
  39 #include <babeltrace/graph/component-class-sink.h>
  40
  41 #ifdef __cplusplus
  42 extern "C" {
  43 #endif
  44
  45 /*
  46  * Plugin interface's version, not synced with Babeltrace's version
  47  * (internal use).
  48  */
  49 #define __BT_PLUGIN_VERSION_MAJOR       1
  50 #define __BT_PLUGIN_VERSION_MINOR       0
  51
  52 /* Plugin initialization function type */
  53 typedef enum bt_plugin_status (*bt_plugin_init_func)(
  54                 struct bt_plugin *plugin);
  55
  56 /* Plugin exit function type */
  57 typedef enum bt_plugin_status (*bt_plugin_exit_func)(void);
  58
  59 /*
  60  * Function to call from a plugin's initialization function to add a
  61  * component class to a plugin object.
  62  */
  63 extern enum bt_plugin_status bt_plugin_add_component_class(
  64                 struct bt_plugin *plugin,
  65                 struct bt_component_class *component_class);
  66
  67 /* Plugin descriptor: describes a single plugin (internal use) */
  68 struct __bt_plugin_descriptor {
  69         /* Plugin's interface major version number */
  70         uint32_t major;
  71
  72         /* Plugin's interface minor version number */
  73         uint32_t minor;
  74
  75         /* Plugin's name */
  76         const char *name;
  77 } __attribute__((packed));
  78
  79 /* Type of a plugin attribute (internal use) */
  80 enum __bt_plugin_descriptor_attribute_type {
  81         BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_INIT                = 0,
  82         BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_EXIT                = 1,
  83         BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_AUTHOR              = 2,
  84         BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_LICENSE             = 3,
  85         BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_DESCRIPTION         = 4,
  86         BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_VERSION             = 5,
  87 };
  88
  89 /* Plugin (user) version */
  90 struct __bt_plugin_descriptor_version {
  91         uint32_t major;
  92         uint32_t minor;
  93         uint32_t patch;
  94         const char *extra;
  95 };
  96
  97 /* Plugin attribute (internal use) */
  98 struct __bt_plugin_descriptor_attribute {
  99         /* Plugin descriptor to which to associate this attribute */
 100         const struct __bt_plugin_descriptor *plugin_descriptor;
 101
 102         /* Name of the attribute's type for debug purposes */
 103         const char *type_name;
 104
 105         /* Attribute's type */
 106         enum __bt_plugin_descriptor_attribute_type type;
 107
 108         /* Attribute's value (depends on attribute's type) */
 109         union {
 110                 /* BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_INIT */
 111                 bt_plugin_init_func init;
 112
 113                 /* BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_EXIT */
 114                 bt_plugin_exit_func exit;
 115
 116                 /* BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_AUTHOR */
 117                 const char *author;
 118
 119                 /* BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_LICENSE */
 120                 const char *license;
 121
 122                 /* BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_DESCRIPTION */
 123                 const char *description;
 124
 125                 /* BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_VERSION */
 126                 struct __bt_plugin_descriptor_version version;
 127         } value;
 128 } __attribute__((packed));
 129
 130 /* Component class descriptor (internal use) */
 131 struct __bt_plugin_component_class_descriptor {
 132         /*
 133          * Plugin descriptor to which to associate this component
 134          * class descriptor.
 135          */
 136         const struct __bt_plugin_descriptor *plugin_descriptor;
 137
 138         /* Component class name */
 139         const char *name;
 140
 141         /* Component class type */
 142         enum bt_component_class_type type;
 143
 144         /* Mandatory methods (depends on component class type) */
 145         union {
 146                 /* BT_COMPONENT_CLASS_TYPE_SOURCE */
 147                 struct {
 148                         bt_component_class_notification_iterator_next_method notif_iter_next;
 149                 } source;
 150
 151                 /* BT_COMPONENT_CLASS_TYPE_FILTER */
 152                 struct {
 153                         bt_component_class_notification_iterator_next_method notif_iter_next;
 154                 } filter;
 155
 156                 /* BT_COMPONENT_CLASS_TYPE_SINK */
 157                 struct {
 158                         bt_component_class_sink_consume_method consume;
 159                 } sink;
 160         } methods;
 161 } __attribute__((packed));
 162
 163 /* Type of a component class attribute (internal use) */
 164 enum __bt_plugin_component_class_descriptor_attribute_type {
 165         BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_DESCRIPTION                         = 0,
 166         BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_HELP                                = 1,
 167         BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_INIT_METHOD                         = 2,
 168         BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_FINALIZE_METHOD                     = 3,
 169         BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_QUERY_METHOD                        = 4,
 170         BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_ACCEPT_PORT_CONNECTION_METHOD       = 5,
 171         BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_PORT_CONNECTED_METHOD               = 7,
 172         BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_PORT_DISCONNECTED_METHOD            = 8,
 173         BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_NOTIF_ITER_INIT_METHOD              = 9,
 174         BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_NOTIF_ITER_FINALIZE_METHOD          = 10,
 175         BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_NOTIF_ITER_SEEK_TIME_METHOD         = 11,
 176 };
 177
 178 /* Component class attribute (internal use) */
 179 struct __bt_plugin_component_class_descriptor_attribute {
 180         /*
 181          * Component class plugin attribute to which to associate this
 182          * component class attribute.
 183          */
 184         const struct __bt_plugin_component_class_descriptor *comp_class_descriptor;
 185
 186         /* Name of the attribute's type for debug purposes */
 187         const char *type_name;
 188
 189         /* Attribute's type */
 190         enum __bt_plugin_component_class_descriptor_attribute_type type;
 191
 192         /* Attribute's value (depends on attribute's type) */
 193         union {
 194                 /* BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_DESCRIPTION */
 195                 const char *description;
 196
 197                 /* BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_HELP */
 198                 const char *help;
 199
 200                 /* BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_INIT_METHOD */
 201                 bt_component_class_init_method init_method;
 202
 203                 /* BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_FINALIZE_METHOD */
 204                 bt_component_class_finalize_method finalize_method;
 205
 206                 /* BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_QUERY_METHOD */
 207                 bt_component_class_query_method query_method;
 208
 209                 /* BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_ACCEPT_PORT_CONNECTION_METHOD */
 210                 bt_component_class_accept_port_connection_method accept_port_connection_method;
 211
 212                 /* BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_PORT_CONNECTED_METHOD */
 213                 bt_component_class_port_connected_method port_connected_method;
 214
 215                 /* BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_PORT_DISCONNECTED_METHOD */
 216                 bt_component_class_port_disconnected_method port_disconnected_method;
 217
 218                 /* BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_NOTIF_ITER_INIT_METHOD */
 219                 bt_component_class_notification_iterator_init_method notif_iter_init_method;
 220
 221                 /* BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_NOTIF_ITER_FINALIZE_METHOD */
 222                 bt_component_class_notification_iterator_finalize_method notif_iter_finalize_method;
 223
 224                 /* BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_NOTIF_ITER_SEEK_TIME_METHOD */
 225                 bt_component_class_notification_iterator_seek_time_method notif_iter_seek_time_method;
 226         } value;
 227 } __attribute__((packed));
 228
 229 /*
 230  * Variable attributes for a plugin descriptor pointer to be added to
 231  * the plugin descriptor section (internal use).
 232  */
 233 #define __BT_PLUGIN_DESCRIPTOR_ATTRS \
 234         __attribute__((section("__bt_plugin_descriptors"), used))
 235
 236 /*
 237  * Variable attributes for a plugin attribute pointer to be added to
 238  * the plugin attribute section (internal use).
 239  */
 240 #define __BT_PLUGIN_DESCRIPTOR_ATTRIBUTES_ATTRS \
 241         __attribute__((section("__bt_plugin_descriptor_attributes"), used))
 242
 243 /*
 244  * Variable attributes for a component class descriptor pointer to be
 245  * added to the component class descriptor section (internal use).
 246  */
 247 #define __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRS \
 248         __attribute__((section("__bt_plugin_component_class_descriptors"), used))
 249
 250 /*
 251  * Variable attributes for a component class descriptor attribute
 252  * pointer to be added to the component class descriptor attribute
 253  * section (internal use).
 254  */
 255 #define __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTES_ATTRS \
 256         __attribute__((section("__bt_plugin_component_class_descriptor_attributes"), used))
 257
 258 /*
 259  * Declares a plugin descriptor pointer variable with a custom ID.
 260  *
 261  * _id: ID (any valid C identifier except `auto`).
 262  */
 263 #define BT_PLUGIN_DECLARE(_id) extern struct __bt_plugin_descriptor __bt_plugin_descriptor_##_id
 264
 265 /*
 266  * Defines a plugin descriptor with a custom ID.
 267  *
 268  * _id:   ID (any valid C identifier except `auto`).
 269  * _name: Plugin's name (C string).
 270  */
 271 #define BT_PLUGIN_WITH_ID(_id, _name)                                   \
 272         struct __bt_plugin_descriptor __bt_plugin_descriptor_##_id = {  \
 273                 .major = __BT_PLUGIN_VERSION_MAJOR,                     \
 274                 .minor = __BT_PLUGIN_VERSION_MINOR,                     \
 275                 .name = _name,                                          \
 276         };                                                              \
 277         static struct __bt_plugin_descriptor const * const __bt_plugin_descriptor_##_id##_ptr __BT_PLUGIN_DESCRIPTOR_ATTRS = &__bt_plugin_descriptor_##_id; \
 278         extern struct __bt_plugin_descriptor const *__start___bt_plugin_descriptors; \
 279         extern struct __bt_plugin_descriptor const *__stop___bt_plugin_descriptors
 280
 281 /*
 282  * Defines a plugin attribute (generic, internal use).
 283  *
 284  * _attr_name: Name of the attribute (C identifier).
 285  * _attr_type: Type of the attribute (enum __bt_plugin_descriptor_attribute_type).
 286  * _id:        Plugin descriptor ID (C identifier).
 287  * _x:         Value.
 288  */
 289 #define __BT_PLUGIN_DESCRIPTOR_ATTRIBUTE(_attr_name, _attr_type, _id, _x) \
 290         static struct __bt_plugin_descriptor_attribute __bt_plugin_descriptor_attribute_##_id##_##_attr_name = { \
 291                 .plugin_descriptor = &__bt_plugin_descriptor_##_id,     \
 292                 .type_name = #_attr_name,                               \
 293                 .type = _attr_type,                                     \
 294                 .value._attr_name = _x,                                 \
 295         };                                                              \
 296         static struct __bt_plugin_descriptor_attribute const * const __bt_plugin_descriptor_attribute_##_id##_##_attr_name##_ptr __BT_PLUGIN_DESCRIPTOR_ATTRIBUTES_ATTRS = &__bt_plugin_descriptor_attribute_##_id##_##_attr_name; \
 297         extern struct __bt_plugin_descriptor_attribute const *__start___bt_plugin_descriptor_attributes; \
 298         extern struct __bt_plugin_descriptor_attribute const *__stop___bt_plugin_descriptor_attributes
 299
 300 /*
 301  * Defines a plugin initialization function attribute attached to a
 302  * specific plugin descriptor.
 303  *
 304  * _id: Plugin descriptor ID (C identifier).
 305  * _x:  Initialization function (bt_plugin_init_func).
 306  */
 307 #define BT_PLUGIN_INIT_WITH_ID(_id, _x) \
 308         __BT_PLUGIN_DESCRIPTOR_ATTRIBUTE(init, BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_INIT, _id, _x)
 309
 310 /*
 311  * Defines a plugin exit function attribute attached to a specific
 312  * plugin descriptor.
 313  *
 314  * _id: Plugin descriptor ID (C identifier).
 315  * _x:  Exit function (bt_plugin_exit_func).
 316  */
 317 #define BT_PLUGIN_EXIT_WITH_ID(_id, _x) \
 318         __BT_PLUGIN_DESCRIPTOR_ATTRIBUTE(exit, BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_EXIT, _id, _x)
 319
 320 /*
 321  * Defines an author attribute attached to a specific plugin descriptor.
 322  *
 323  * _id: Plugin descriptor ID (C identifier).
 324  * _x:  Author (C string).
 325  */
 326 #define BT_PLUGIN_AUTHOR_WITH_ID(_id, _x) \
 327         __BT_PLUGIN_DESCRIPTOR_ATTRIBUTE(author, BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_AUTHOR, _id, _x)
 328
 329 /*
 330  * Defines a license attribute attached to a specific plugin descriptor.
 331  *
 332  * _id: Plugin descriptor ID (C identifier).
 333  * _x:  License (C string).
 334  */
 335 #define BT_PLUGIN_LICENSE_WITH_ID(_id, _x) \
 336         __BT_PLUGIN_DESCRIPTOR_ATTRIBUTE(license, BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_LICENSE, _id, _x)
 337
 338 /*
 339  * Defines a description attribute attached to a specific plugin
 340  * descriptor.
 341  *
 342  * _id: Plugin descriptor ID (C identifier).
 343  * _x:  Description (C string).
 344  */
 345 #define BT_PLUGIN_DESCRIPTION_WITH_ID(_id, _x) \
 346         __BT_PLUGIN_DESCRIPTOR_ATTRIBUTE(description, BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_DESCRIPTION, _id, _x)
 347
 348 #define __BT_PLUGIN_VERSION_STRUCT_VALUE(_major, _minor, _patch, _extra) \
 349         {.major = _major, .minor = _minor, .patch = _patch, .extra = _extra,}
 350
 351 /*
 352  * Defines a version attribute attached to a specific plugin descriptor.
 353  *
 354  * _id:    Plugin descriptor ID (C identifier).
 355  * _major: Plugin's major version (uint32_t).
 356  * _minor: Plugin's minor version (uint32_t).
 357  * _patch: Plugin's patch version (uint32_t).
 358  * _extra: Plugin's version extra information (C string).
 359  */
 360 #define BT_PLUGIN_VERSION_WITH_ID(_id, _major, _minor, _patch, _extra) \
 361         __BT_PLUGIN_DESCRIPTOR_ATTRIBUTE(version, BT_PLUGIN_DESCRIPTOR_ATTRIBUTE_TYPE_VERSION, _id, __BT_PLUGIN_VERSION_STRUCT_VALUE(_major, _minor, _patch, _extra))
 362
 363 /*
 364  * Declaration of start and stop symbols of component class descriptors
 365  * section.
 366  */
 367 #define __BT_PLUGIN_DECL_COMPONENT_CLASS_DESCRIPTORS_SECTION_START_STOP \
 368         extern struct __bt_plugin_component_class_descriptor const *__start___bt_plugin_component_class_descriptors; \
 369         extern struct __bt_plugin_component_class_descriptor const *__stop___bt_plugin_component_class_descriptors
 370
 371 /*
 372  * Defines a source component class descriptor with a custom ID.
 373  *
 374  * _id:                     ID (any valid C identifier except `auto`).
 375  * _comp_class_id:          Component class ID (C identifier).
 376  * _name:                   Component class name (C string).
 377  * _notif_iter_next_method: Component class's iterator next method
 378  *                          (bt_component_class_notification_iterator_next_method).
 379  */
 380 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_WITH_ID(_id, _comp_class_id, _name, _notif_iter_next_method) \
 381         static struct __bt_plugin_component_class_descriptor __bt_plugin_source_component_class_descriptor_##_id##_##_comp_class_id = { \
 382                 .plugin_descriptor = &__bt_plugin_descriptor_##_id,     \
 383                 .name = _name,                                          \
 384                 .type = BT_COMPONENT_CLASS_TYPE_SOURCE,                 \
 385                 .methods.source = {                                     \
 386                         .notif_iter_next = _notif_iter_next_method,     \
 387                 },                                                      \
 388         };                                                              \
 389         static struct __bt_plugin_component_class_descriptor const * const __bt_plugin_source_component_class_descriptor_##_id##_##_comp_class_id##_ptr __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRS = &__bt_plugin_source_component_class_descriptor_##_id##_##_comp_class_id; \
 390         __BT_PLUGIN_DECL_COMPONENT_CLASS_DESCRIPTORS_SECTION_START_STOP
 391
 392 /*
 393  * Defines a filter component class descriptor with a custom ID.
 394  *
 395  * _id:                   ID (any valid C identifier except `auto`).
 396  * _comp_class_id:        Component class ID (C identifier).
 397  * _name:                 Component class name (C string).
 398  * _notif_iter_next_method: Component class's iterator next method
 399  *                          (bt_component_class_notification_iterator_next_method).
 400  */
 401 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_WITH_ID(_id, _comp_class_id, _name, _notif_iter_next_method) \
 402         static struct __bt_plugin_component_class_descriptor __bt_plugin_filter_component_class_descriptor_##_id##_##_comp_class_id = { \
 403                 .plugin_descriptor = &__bt_plugin_descriptor_##_id,     \
 404                 .name = _name,                                          \
 405                 .type = BT_COMPONENT_CLASS_TYPE_FILTER,                 \
 406                 .methods.filter = {                                     \
 407                         .notif_iter_next = _notif_iter_next_method,     \
 408                 },                                                      \
 409         };                                                              \
 410         static struct __bt_plugin_component_class_descriptor const * const __bt_plugin_filter_component_class_descriptor_##_id##_##_comp_class_id##_ptr __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRS = &__bt_plugin_filter_component_class_descriptor_##_id##_##_comp_class_id; \
 411         __BT_PLUGIN_DECL_COMPONENT_CLASS_DESCRIPTORS_SECTION_START_STOP
 412
 413 /*
 414  * Defines a sink component class descriptor with a custom ID.
 415  *
 416  * _id:                 ID (any valid C identifier except `auto`).
 417  * _comp_class_id:      Component class ID (C identifier).
 418  * _name:               Component class name (C string).
 419  * _consume_method:     Component class's iterator consume method
 420  *                      (bt_component_class_sink_consume_method).
 421  */
 422 #define BT_PLUGIN_SINK_COMPONENT_CLASS_WITH_ID(_id, _comp_class_id, _name, _consume_method) \
 423         static struct __bt_plugin_component_class_descriptor __bt_plugin_sink_component_class_descriptor_##_id##_##_comp_class_id = { \
 424                 .plugin_descriptor = &__bt_plugin_descriptor_##_id,     \
 425                 .name = _name,                                          \
 426                 .type = BT_COMPONENT_CLASS_TYPE_SINK,                   \
 427                 .methods.sink = {                                       \
 428                         .consume = _consume_method,                     \
 429                 },                                                      \
 430         };                                                              \
 431         static struct __bt_plugin_component_class_descriptor const * const __bt_plugin_sink_component_class_descriptor_##_id##_##_comp_class_id##_ptr __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRS = &__bt_plugin_sink_component_class_descriptor_##_id##_##_comp_class_id; \
 432         __BT_PLUGIN_DECL_COMPONENT_CLASS_DESCRIPTORS_SECTION_START_STOP
 433
 434 /*
 435  * Defines a component class descriptor attribute (generic, internal
 436  * use).
 437  *
 438  * _id:            Plugin descriptor ID (C identifier).
 439  * _comp_class_id: Component class ID (C identifier).
 440  * _type:          Component class type (`source`, `filter`, or `sink`).
 441  * _attr_name:     Name of the attribute (C identifier).
 442  * _attr_type:     Type of the attribute
 443  *                 (enum __bt_plugin_descriptor_attribute_type).
 444  * _x:             Value.
 445  */
 446 #define __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(_attr_name, _attr_type, _id, _comp_class_id, _type, _x) \
 447         static struct __bt_plugin_component_class_descriptor_attribute __bt_plugin_##_type##_component_class_descriptor_attribute_##_id##_##_comp_class_id##_##_attr_name = { \
 448                 .comp_class_descriptor = &__bt_plugin_##_type##_component_class_descriptor_##_id##_##_comp_class_id, \
 449                 .type_name = #_attr_name,                               \
 450                 .type = _attr_type,                                     \
 451                 .value._attr_name = _x,                                 \
 452         };                                                              \
 453         static struct __bt_plugin_component_class_descriptor_attribute const * const __bt_plugin_##_type##_component_class_descriptor_attribute_##_id##_##_comp_class_id##_##_attr_name##_ptr __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTES_ATTRS = &__bt_plugin_##_type##_component_class_descriptor_attribute_##_id##_##_comp_class_id##_##_attr_name; \
 454         extern struct __bt_plugin_component_class_descriptor_attribute const *__start___bt_plugin_component_class_descriptor_attributes; \
 455         extern struct __bt_plugin_component_class_descriptor_attribute const *__stop___bt_plugin_component_class_descriptor_attributes
 456
 457 /*
 458  * Defines a description attribute attached to a specific source
 459  * component class descriptor.
 460  *
 461  * _id:            Plugin descriptor ID (C identifier).
 462  * _comp_class_id: Component class descriptor ID (C identifier).
 463  * _x:             Description (C string).
 464  */
 465 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_DESCRIPTION_WITH_ID(_id, _comp_class_id, _x) \
 466         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(description, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_DESCRIPTION, _id, _comp_class_id, source, _x)
 467
 468 /*
 469  * Defines a description attribute attached to a specific filter
 470  * component class descriptor.
 471  *
 472  * _id:            Plugin descriptor ID (C identifier).
 473  * _comp_class_id: Component class descriptor ID (C identifier).
 474  * _x:             Description (C string).
 475  */
 476 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_DESCRIPTION_WITH_ID(_id, _comp_class_id, _x) \
 477         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(description, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_DESCRIPTION, _id, _comp_class_id, filter, _x)
 478
 479 /*
 480  * Defines a description attribute attached to a specific sink
 481  * component class descriptor.
 482  *
 483  * _id:            Plugin descriptor ID (C identifier).
 484  * _comp_class_id: Component class descriptor ID (C identifier).
 485  * _x:             Description (C string).
 486  */
 487 #define BT_PLUGIN_SINK_COMPONENT_CLASS_DESCRIPTION_WITH_ID(_id, _comp_class_id, _x) \
 488         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(description, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_DESCRIPTION, _id, _comp_class_id, sink, _x)
 489
 490 /*
 491  * Defines a help attribute attached to a specific source component
 492  * class descriptor.
 493  *
 494  * _id:            Plugin descriptor ID (C identifier).
 495  * _comp_class_id: Component class descriptor ID (C identifier).
 496  * _x:             Help (C string).
 497  */
 498 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_HELP_WITH_ID(_id, _comp_class_id, _x) \
 499         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(help, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_HELP, _id, _comp_class_id, source, _x)
 500
 501 /*
 502  * Defines a help attribute attached to a specific filter component
 503  * class descriptor.
 504  *
 505  * _id:            Plugin descriptor ID (C identifier).
 506  * _comp_class_id: Component class descriptor ID (C identifier).
 507  * _x:             Help (C string).
 508  */
 509 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_HELP_WITH_ID(_id, _comp_class_id, _x) \
 510         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(help, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_HELP, _id, _comp_class_id, filter, _x)
 511
 512 /*
 513  * Defines a help attribute attached to a specific sink component class
 514  * descriptor.
 515  *
 516  * _id:            Plugin descriptor ID (C identifier).
 517  * _comp_class_id: Component class descriptor ID (C identifier).
 518  * _x:             Help (C string).
 519  */
 520 #define BT_PLUGIN_SINK_COMPONENT_CLASS_HELP_WITH_ID(_id, _comp_class_id, _x) \
 521         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(help, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_HELP, _id, _comp_class_id, sink, _x)
 522
 523 /*
 524  * Defines an initialization method attribute attached to a specific
 525  * source component class descriptor.
 526  *
 527  * _id:            Plugin descriptor ID (C identifier).
 528  * _comp_class_id: Component class descriptor ID (C identifier).
 529  * _x:             Initialization method (bt_component_class_init_method).
 530  */
 531 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_INIT_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 532         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(init_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_INIT_METHOD, _id, _comp_class_id, source, _x)
 533
 534 /*
 535  * Defines an initialization method attribute attached to a specific
 536  * filter component class descriptor.
 537  *
 538  * _id:            Plugin descriptor ID (C identifier).
 539  * _comp_class_id: Component class descriptor ID (C identifier).
 540  * _x:             Initialization method (bt_component_class_init_method).
 541  */
 542 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_INIT_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 543         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(init_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_INIT_METHOD, _id, _comp_class_id, filter, _x)
 544
 545 /*
 546  * Defines an initialization method attribute attached to a specific
 547  * sink component class descriptor.
 548  *
 549  * _id:            Plugin descriptor ID (C identifier).
 550  * _comp_class_id: Component class descriptor ID (C identifier).
 551  * _x:             Initialization method (bt_component_class_init_method).
 552  */
 553 #define BT_PLUGIN_SINK_COMPONENT_CLASS_INIT_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 554         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(init_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_INIT_METHOD, _id, _comp_class_id, sink, _x)
 555
 556 /*
 557  * Defines a finalize method attribute attached to a specific source
 558  * component class descriptor.
 559  *
 560  * _id:            Plugin descriptor ID (C identifier).
 561  * _comp_class_id: Component class descriptor ID (C identifier).
 562  * _x:             Finalize method (bt_component_class_finalize_method).
 563  */
 564 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_FINALIZE_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 565         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(finalize_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_FINALIZE_METHOD, _id, _comp_class_id, source, _x)
 566
 567 /*
 568  * Defines a finalize method attribute attached to a specific filter
 569  * component class descriptor.
 570  *
 571  * _id:            Plugin descriptor ID (C identifier).
 572  * _comp_class_id: Component class descriptor ID (C identifier).
 573  * _x:             Finalize method (bt_component_class_finalize_method).
 574  */
 575 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_FINALIZE_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 576         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(finalize_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_FINALIZE_METHOD, _id, _comp_class_id, filter, _x)
 577
 578 /*
 579  * Defines a finalize method attribute attached to a specific sink
 580  * component class descriptor.
 581  *
 582  * _id:            Plugin descriptor ID (C identifier).
 583  * _comp_class_id: Component class descriptor ID (C identifier).
 584  * _x:             Finalize method (bt_component_class_finalize_method).
 585  */
 586 #define BT_PLUGIN_SINK_COMPONENT_CLASS_FINALIZE_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 587         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(finalize_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_FINALIZE_METHOD, _id, _comp_class_id, sink, _x)
 588
 589 /*
 590  * Defines a query method attribute attached to a specific source
 591  * component class descriptor.
 592  *
 593  * _id:            Plugin descriptor ID (C identifier).
 594  * _comp_class_id: Component class descriptor ID (C identifier).
 595  * _x:             Finalize method (bt_component_class_query_method).
 596  */
 597 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_QUERY_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 598         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(query_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_QUERY_METHOD, _id, _comp_class_id, source, _x)
 599
 600 /*
 601  * Defines a query method attribute attached to a specific filter
 602  * component class descriptor.
 603  *
 604  * _id:            Plugin descriptor ID (C identifier).
 605  * _comp_class_id: Component class descriptor ID (C identifier).
 606  * _x:             Finalize method (bt_component_class_query_method).
 607  */
 608 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_QUERY_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 609         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(query_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_QUERY_METHOD, _id, _comp_class_id, filter, _x)
 610
 611 /*
 612  * Defines a query method attribute attached to a specific sink
 613  * component class descriptor.
 614  *
 615  * _id:            Plugin descriptor ID (C identifier).
 616  * _comp_class_id: Component class descriptor ID (C identifier).
 617  * _x:             Finalize method (bt_component_class_query_method).
 618  */
 619 #define BT_PLUGIN_SINK_COMPONENT_CLASS_QUERY_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 620         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(query_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_QUERY_METHOD, _id, _comp_class_id, sink, _x)
 621
 622 /*
 623  * Defines an accept port connection method attribute attached to a
 624  * specific source component class descriptor.
 625  *
 626  * _id:            Plugin descriptor ID (C identifier).
 627  * _comp_class_id: Component class descriptor ID (C identifier).
 628  * _x:             Accept port connection method
 629  *                 (bt_component_class_accept_port_connection_method).
 630  */
 631 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_ACCEPT_PORT_CONNECTION_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 632         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(accept_port_connection_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_ACCEPT_PORT_CONNECTION_METHOD, _id, _comp_class_id, source, _x)
 633
 634 /*
 635  * Defines an accept port connection method attribute attached to a
 636  * specific filter component class descriptor.
 637  *
 638  * _id:            Plugin descriptor ID (C identifier).
 639  * _comp_class_id: Component class descriptor ID (C identifier).
 640  * _x:             Accept port connection method
 641  *                 (bt_component_class_accept_port_connection_method).
 642  */
 643 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_ACCEPT_PORT_CONNECTION_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 644         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(accept_port_connection_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_ACCEPT_PORT_CONNECTION_METHOD, _id, _comp_class_id, filter, _x)
 645
 646 /*
 647  * Defines an accept port connection method attribute attached to a
 648  * specific sink component class descriptor.
 649  *
 650  * _id:            Plugin descriptor ID (C identifier).
 651  * _comp_class_id: Component class descriptor ID (C identifier).
 652  * _x:             Accept port connection method
 653  *                 (bt_component_class_accept_port_connection_method).
 654  */
 655 #define BT_PLUGIN_SINK_COMPONENT_CLASS_ACCEPT_PORT_CONNECTION_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 656         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(accept_port_connection_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_ACCEPT_PORT_CONNECTION_METHOD, _id, _comp_class_id, sink, _x)
 657
 658 /*
 659  * Defines a port connected method attribute attached to a specific
 660  * source component class descriptor.
 661  *
 662  * _id:            Plugin descriptor ID (C identifier).
 663  * _comp_class_id: Component class descriptor ID (C identifier).
 664  * _x:             Port connected method
 665  *                 (bt_component_class_port_connected_method).
 666  */
 667 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_PORT_CONNECTED_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 668         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(port_connected_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_PORT_CONNECTED_METHOD, _id, _comp_class_id, source, _x)
 669
 670 /*
 671  * Defines a port connected method attribute attached to a specific
 672  * filter component class descriptor.
 673  *
 674  * _id:            Plugin descriptor ID (C identifier).
 675  * _comp_class_id: Component class descriptor ID (C identifier).
 676  * _x:             Port connected method
 677  *                 (bt_component_class_port_connected_method).
 678  */
 679 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_PORT_CONNECTED_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 680         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(port_connected_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_PORT_CONNECTED_METHOD, _id, _comp_class_id, filter, _x)
 681
 682 /*
 683  * Defines a port connected method attribute attached to a specific
 684  * sink component class descriptor.
 685  *
 686  * _id:            Plugin descriptor ID (C identifier).
 687  * _comp_class_id: Component class descriptor ID (C identifier).
 688  * _x:             Port connected method
 689  *                 (bt_component_class_port_connected_method).
 690  */
 691 #define BT_PLUGIN_SINK_COMPONENT_CLASS_PORT_CONNECTED_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 692         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(port_connected_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_PORT_CONNECTED_METHOD, _id, _comp_class_id, sink, _x)
 693
 694 /*
 695  * Defines a port disconnected method attribute attached to a specific
 696  * source component class descriptor.
 697  *
 698  * _id:            Plugin descriptor ID (C identifier).
 699  * _comp_class_id: Component class descriptor ID (C identifier).
 700  * _x:             Port disconnected method
 701  *                 (bt_component_class_port_disconnected_method).
 702  */
 703 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_PORT_DISCONNECTED_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 704         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(port_disconnected_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_PORT_DISCONNECTED_METHOD, _id, _comp_class_id, source, _x)
 705
 706 /*
 707  * Defines a port disconnected method attribute attached to a specific
 708  * filter component class descriptor.
 709  *
 710  * _id:            Plugin descriptor ID (C identifier).
 711  * _comp_class_id: Component class descriptor ID (C identifier).
 712  * _x:             Port disconnected method
 713  *                 (bt_component_class_port_disconnected_method).
 714  */
 715 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_PORT_DISCONNECTED_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 716         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(port_disconnected_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_PORT_DISCONNECTED_METHOD, _id, _comp_class_id, filter, _x)
 717
 718 /*
 719  * Defines a port disconnected method attribute attached to a specific
 720  * sink component class descriptor.
 721  *
 722  * _id:            Plugin descriptor ID (C identifier).
 723  * _comp_class_id: Component class descriptor ID (C identifier).
 724  * _x:             Port disconnected method
 725  *                 (bt_component_class_port_disconnected_method).
 726  */
 727 #define BT_PLUGIN_SINK_COMPONENT_CLASS_PORT_DISCONNECTED_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 728         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(port_disconnected_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_PORT_DISCONNECTED_METHOD, _id, _comp_class_id, sink, _x)
 729
 730 /*
 731  * Defines an iterator initialization method attribute attached to a
 732  * specific source component class descriptor.
 733  *
 734  * _id:            Plugin descriptor ID (C identifier).
 735  * _comp_class_id: Component class descriptor ID (C identifier).
 736  * _x:             Iterator initialization method
 737  *                 (bt_component_class_notification_iterator_init_method).
 738  */
 739 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_NOTIFICATION_ITERATOR_INIT_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 740         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(notif_iter_init_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_NOTIF_ITER_INIT_METHOD, _id, _comp_class_id, source, _x)
 741
 742 /*
 743  * Defines an iterator finalize method attribute attached to a specific
 744  * source component class descriptor.
 745  *
 746  * _id:            Plugin descriptor ID (C identifier).
 747  * _comp_class_id: Component class descriptor ID (C identifier).
 748  * _x:             Iterator finalize method
 749  *                 (bt_component_class_notification_iterator_finalize_method).
 750  */
 751 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_NOTIFICATION_ITERATOR_FINALIZE_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 752         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(notif_iter_finalize_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_NOTIF_ITER_FINALIZE_METHOD, _id, _comp_class_id, source, _x)
 753
 754 /*
 755  * Defines an iterator seek time method attribute attached to a specific
 756  * source component class descriptor.
 757  *
 758  * _id:            Plugin descriptor ID (C identifier).
 759  * _comp_class_id: Component class descriptor ID (C identifier).
 760  * _x:             Iterator seek time method
 761  *                 (bt_component_class_notification_iterator_seek_time_method).
 762  */
 763 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_NOTIFICATION_ITERATOR_SEEK_TIME_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 764         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(notif_iter_seek_time_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_NOTIF_ITER_SEEK_TIME_METHOD, _id, _comp_class_id, source, _x)
 765
 766 /*
 767  * Defines an iterator initialization method attribute attached to a
 768  * specific filter component class descriptor.
 769  *
 770  * _id:            Plugin descriptor ID (C identifier).
 771  * _comp_class_id: Component class descriptor ID (C identifier).
 772  * _x:             Iterator initialization method
 773  *                 (bt_component_class_notification_iterator_init_method).
 774  */
 775 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_NOTIFICATION_ITERATOR_INIT_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 776         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(notif_iter_init_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_NOTIF_ITER_INIT_METHOD, _id, _comp_class_id, filter, _x)
 777
 778 /*
 779  * Defines an iterator finalize method attribute attached to a specific
 780  * filter component class descriptor.
 781  *
 782  * _id:            Plugin descriptor ID (C identifier).
 783  * _comp_class_id: Component class descriptor ID (C identifier).
 784  * _x:             Iterator finalize method
 785  *                 (bt_component_class_notification_iterator_finalize_method).
 786  */
 787 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_NOTIFICATION_ITERATOR_FINALIZE_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 788         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(notif_iter_finalize_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_NOTIF_ITER_FINALIZE_METHOD, _id, _comp_class_id, filter, _x)
 789
 790 /*
 791  * Defines an iterator seek time method attribute attached to a specific
 792  * filter component class descriptor.
 793  *
 794  * _id:            Plugin descriptor ID (C identifier).
 795  * _comp_class_id: Component class descriptor ID (C identifier).
 796  * _x:             Iterator seek time method
 797  *                 (bt_component_class_notification_iterator_seek_time_method).
 798  */
 799 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_NOTIFICATION_ITERATOR_SEEK_TIME_METHOD_WITH_ID(_id, _comp_class_id, _x) \
 800         __BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE(notif_iter_seek_time_method, BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_NOTIF_ITER_SEEK_TIME_METHOD, _id, _comp_class_id, filter, _x)
 801
 802 /*
 803  * Defines a plugin descriptor with an automatic ID.
 804  *
 805  * _name: Plugin's name (C string).
 806  */
 807 #define BT_PLUGIN(_name)                static BT_PLUGIN_WITH_ID(auto, #_name)
 808
 809 /*
 810  * Defines a plugin initialization function attribute attached to the
 811  * automatic plugin descriptor.
 812  *
 813  * _x: Initialization function (bt_plugin_init_func).
 814  */
 815 #define BT_PLUGIN_INIT(_x)              BT_PLUGIN_INIT_WITH_ID(auto, _x)
 816
 817  /*
 818  * Defines a plugin exit function attribute attached to the automatic
 819  * plugin descriptor.
 820  *
 821  * _x: Exit function (bt_plugin_exit_func).
 822  */
 823 #define BT_PLUGIN_EXIT(_x)              BT_PLUGIN_EXIT_WITH_ID(auto, _x)
 824
 825 /*
 826  * Defines an author attribute attached to the automatic plugin
 827  * descriptor.
 828  *
 829  * _x: Author (C string).
 830  */
 831 #define BT_PLUGIN_AUTHOR(_x)            BT_PLUGIN_AUTHOR_WITH_ID(auto, _x)
 832
 833 /*
 834  * Defines a license attribute attached to the automatic plugin
 835  * descriptor.
 836  *
 837  * _x: License (C string).
 838  */
 839 #define BT_PLUGIN_LICENSE(_x)           BT_PLUGIN_LICENSE_WITH_ID(auto, _x)
 840
 841 /*
 842  * Defines a description attribute attached to the automatic plugin
 843  * descriptor.
 844  *
 845  * _x: Description (C string).
 846  */
 847 #define BT_PLUGIN_DESCRIPTION(_x)       BT_PLUGIN_DESCRIPTION_WITH_ID(auto, _x)
 848
 849 /*
 850  * Defines a version attribute attached to the automatic plugin
 851  * descriptor.
 852  *
 853  * _major: Plugin's major version (uint32_t).
 854  * _minor: Plugin's minor version (uint32_t).
 855  * _patch: Plugin's patch version (uint32_t).
 856  * _extra: Plugin's version extra information (C string).
 857  */
 858 #define BT_PLUGIN_VERSION(_major, _minor, _patch, _extra) BT_PLUGIN_VERSION_WITH_ID(auto, _major, _minor, _patch, _extra)
 859
 860 /*
 861  * Defines a source component class attached to the automatic plugin
 862  * descriptor. Its ID is the same as its name, hence its name must be a
 863  * C identifier in this version.
 864  *
 865  * _name:                   Component class name (C identifier).
 866  * _notif_iter_next_method: Component class's iterator next method
 867  *                          (bt_component_class_notification_iterator_next_method).
 868  */
 869 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS(_name, _notif_iter_next_method) \
 870         BT_PLUGIN_SOURCE_COMPONENT_CLASS_WITH_ID(auto, _name, #_name, _notif_iter_next_method)
 871
 872 /*
 873  * Defines a filter component class attached to the automatic plugin
 874  * descriptor. Its ID is the same as its name, hence its name must be a
 875  * C identifier in this version.
 876  *
 877  * _name:                   Component class name (C identifier).
 878  * _notif_iter_next_method: Component class's iterator next method
 879  *                          (bt_component_class_notification_iterator_next_method).
 880  */
 881 #define BT_PLUGIN_FILTER_COMPONENT_CLASS(_name, _notif_iter_next_method) \
 882         BT_PLUGIN_FILTER_COMPONENT_CLASS_WITH_ID(auto, _name, #_name, _notif_iter_next_method)
 883
 884 /*
 885  * Defines a sink component class attached to the automatic plugin
 886  * descriptor. Its ID is the same as its name, hence its name must be a
 887  * C identifier in this version.
 888  *
 889  * _name:           Component class name (C identifier).
 890  * _consume_method: Component class's consume method
 891  *                  (bt_component_class_sink_consume_method).
 892  */
 893 #define BT_PLUGIN_SINK_COMPONENT_CLASS(_name, _consume_method) \
 894         BT_PLUGIN_SINK_COMPONENT_CLASS_WITH_ID(auto, _name, #_name, _consume_method)
 895
 896 /*
 897  * Defines a description attribute attached to a source component class
 898  * descriptor which is attached to the automatic plugin descriptor.
 899  *
 900  * _name: Component class name (C identifier).
 901  * _x:    Description (C string).
 902  */
 903 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_DESCRIPTION(_name, _x) \
 904         BT_PLUGIN_SOURCE_COMPONENT_CLASS_DESCRIPTION_WITH_ID(auto, _name, _x)
 905
 906 /*
 907  * Defines a description attribute attached to a filter component class
 908  * descriptor which is attached to the automatic plugin descriptor.
 909  *
 910  * _name: Component class name (C identifier).
 911  * _x:    Description (C string).
 912  */
 913 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_DESCRIPTION(_name, _x) \
 914         BT_PLUGIN_FILTER_COMPONENT_CLASS_DESCRIPTION_WITH_ID(auto, _name, _x)
 915
 916 /*
 917  * Defines a description attribute attached to a sink component class
 918  * descriptor which is attached to the automatic plugin descriptor.
 919  *
 920  * _name: Component class name (C identifier).
 921  * _x:    Description (C string).
 922  */
 923 #define BT_PLUGIN_SINK_COMPONENT_CLASS_DESCRIPTION(_name, _x) \
 924         BT_PLUGIN_SINK_COMPONENT_CLASS_DESCRIPTION_WITH_ID(auto, _name, _x)
 925
 926 /*
 927  * Defines a help attribute attached to a source component class
 928  * descriptor which is attached to the automatic plugin descriptor.
 929  *
 930  * _name: Component class name (C identifier).
 931  * _x:    Help (C string).
 932  */
 933 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_HELP(_name, _x) \
 934         BT_PLUGIN_SOURCE_COMPONENT_CLASS_HELP_WITH_ID(auto, _name, _x)
 935
 936 /*
 937  * Defines a help attribute attached to a filter component class
 938  * descriptor which is attached to the automatic plugin descriptor.
 939  *
 940  * _name: Component class name (C identifier).
 941  * _x:    Help (C string).
 942  */
 943 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_HELP(_name, _x) \
 944         BT_PLUGIN_FILTER_COMPONENT_CLASS_HELP_WITH_ID(auto, _name, _x)
 945
 946 /*
 947  * Defines a help attribute attached to a sink component class
 948  * descriptor which is attached to the automatic plugin descriptor.
 949  *
 950  * _name: Component class name (C identifier).
 951  * _x:    Help (C string).
 952  */
 953 #define BT_PLUGIN_SINK_COMPONENT_CLASS_HELP(_name, _x) \
 954         BT_PLUGIN_SINK_COMPONENT_CLASS_HELP_WITH_ID(auto, _name, _x)
 955
 956 /*
 957  * Defines an initialization method attribute attached to a source
 958  * component class descriptor which is attached to the automatic plugin
 959  * descriptor.
 960  *
 961  * _name: Component class name (C identifier).
 962  * _x:    Initialization method (bt_component_class_init_method).
 963  */
 964 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_INIT_METHOD(_name, _x) \
 965         BT_PLUGIN_SOURCE_COMPONENT_CLASS_INIT_METHOD_WITH_ID(auto, _name, _x)
 966
 967 /*
 968  * Defines an initialization method attribute attached to a filter
 969  * component class descriptor which is attached to the automatic plugin
 970  * descriptor.
 971  *
 972  * _name: Component class name (C identifier).
 973  * _x:    Initialization method (bt_component_class_init_method).
 974  */
 975 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_INIT_METHOD(_name, _x) \
 976         BT_PLUGIN_FILTER_COMPONENT_CLASS_INIT_METHOD_WITH_ID(auto, _name, _x)
 977
 978 /*
 979  * Defines an initialization method attribute attached to a sink
 980  * component class descriptor which is attached to the automatic plugin
 981  * descriptor.
 982  *
 983  * _name: Component class name (C identifier).
 984  * _x:    Initialization method (bt_component_class_init_method).
 985  */
 986 #define BT_PLUGIN_SINK_COMPONENT_CLASS_INIT_METHOD(_name, _x) \
 987         BT_PLUGIN_SINK_COMPONENT_CLASS_INIT_METHOD_WITH_ID(auto, _name, _x)
 988
 989 /*
 990  * Defines a finalize method attribute attached to a source component
 991  * class descriptor which is attached to the automatic plugin
 992  * descriptor.
 993  *
 994  * _name: Component class name (C identifier).
 995  * _x:    Initialization method (bt_component_class_finalize_method).
 996  */
 997 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_FINALIZE_METHOD(_name, _x) \
 998         BT_PLUGIN_SOURCE_COMPONENT_CLASS_FINALIZE_METHOD_WITH_ID(auto, _name, _x)
 999
1000 /*
1001  * Defines a finalize method attribute attached to a filter component
1002  * class descriptor which is attached to the automatic plugin
1003  * descriptor.
1004  *
1005  * _name: Component class name (C identifier).
1006  * _x:    Initialization method (bt_component_class_finalize_method).
1007  */
1008 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_FINALIZE_METHOD(_name, _x) \
1009         BT_PLUGIN_FILTER_COMPONENT_CLASS_FINALIZE_METHOD_WITH_ID(auto, _name, _x)
1010
1011 /*
1012  * Defines a finalize method attribute attached to a sink component class
1013  * descriptor which is attached to the automatic plugin descriptor.
1014  *
1015  * _name: Component class name (C identifier).
1016  * _x:    Initialization method (bt_component_class_finalize_method).
1017  */
1018 #define BT_PLUGIN_SINK_COMPONENT_CLASS_FINALIZE_METHOD(_name, _x) \
1019         BT_PLUGIN_SINK_COMPONENT_CLASS_FINALIZE_METHOD_WITH_ID(auto, _name, _x)
1020
1021 /*
1022  * Defines a query method attribute attached to a source component
1023  * class descriptor which is attached to the automatic plugin
1024  * descriptor.
1025  *
1026  * _name: Component class name (C identifier).
1027  * _x:    Initialization method (bt_component_class_query_method).
1028  */
1029 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_QUERY_METHOD(_name, _x) \
1030         BT_PLUGIN_SOURCE_COMPONENT_CLASS_QUERY_METHOD_WITH_ID(auto, _name, _x)
1031
1032 /*
1033  * Defines a query method attribute attached to a filter component
1034  * class descriptor which is attached to the automatic plugin
1035  * descriptor.
1036  *
1037  * _name: Component class name (C identifier).
1038  * _x:    Initialization method (bt_component_class_query_method).
1039  */
1040 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_QUERY_METHOD(_name, _x) \
1041         BT_PLUGIN_FILTER_COMPONENT_CLASS_QUERY_METHOD_WITH_ID(auto, _name, _x)
1042
1043 /*
1044  * Defines a query method attribute attached to a sink component
1045  * class descriptor which is attached to the automatic plugin
1046  * descriptor.
1047  *
1048  * _name: Component class name (C identifier).
1049  * _x:    Initialization method (bt_component_class_query_method).
1050  */
1051 #define BT_PLUGIN_SINK_COMPONENT_CLASS_QUERY_METHOD(_name, _x) \
1052         BT_PLUGIN_SINK_COMPONENT_CLASS_QUERY_METHOD_WITH_ID(auto, _name, _x)
1053
1054 /*
1055  * Defines an accept port connection method attribute attached to a
1056  * source component class descriptor which is attached to the automatic
1057  * plugin descriptor.
1058  *
1059  * _name: Component class name (C identifier).
1060  * _x:    Accept port connection method
1061  *        (bt_component_class_accept_port_connection_method).
1062  */
1063 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_ACCEPT_PORT_CONNECTION_METHOD(_name, _x) \
1064         BT_PLUGIN_SOURCE_COMPONENT_CLASS_ACCEPT_PORT_CONNECTION_METHOD_WITH_ID(auto, _name, _x)
1065
1066 /*
1067  * Defines an accept port connection method attribute attached to a
1068  * filter component class descriptor which is attached to the automatic
1069  * plugin descriptor.
1070  *
1071  * _name: Component class name (C identifier).
1072  * _x:    Accept port connection method
1073  *        (bt_component_class_accept_port_connection_method).
1074  */
1075 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_ACCEPT_PORT_CONNECTION_METHOD(_name, _x) \
1076         BT_PLUGIN_FILTER_COMPONENT_CLASS_ACCEPT_PORT_CONNECTION_METHOD_WITH_ID(auto, _name, _x)
1077
1078 /*
1079  * Defines an accept port connection method attribute attached to a sink
1080  * component class descriptor which is attached to the automatic plugin
1081  * descriptor.
1082  *
1083  * _name: Component class name (C identifier).
1084  * _x:    Accept port connection method
1085  *        (bt_component_class_accept_port_connection_method).
1086  */
1087 #define BT_PLUGIN_SINK_COMPONENT_CLASS_ACCEPT_PORT_CONNECTION_METHOD(_name, _x) \
1088         BT_PLUGIN_SINK_COMPONENT_CLASS_ACCEPT_PORT_CONNECTION_METHOD_WITH_ID(auto, _name, _x)
1089
1090 /*
1091  * Defines a port connected method attribute attached to a source
1092  * component class descriptor which is attached to the automatic plugin
1093  * descriptor.
1094  *
1095  * _name: Component class name (C identifier).
1096  * _x:    Port connected (bt_component_class_port_connected_method).
1097  */
1098 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_PORT_CONNECTED_METHOD(_name, _x) \
1099         BT_PLUGIN_SOURCE_COMPONENT_CLASS_PORT_CONNECTED_METHOD_WITH_ID(auto, _name, _x)
1100
1101 /*
1102  * Defines a port connected method attribute attached to a filter
1103  * component class descriptor which is attached to the automatic plugin
1104  * descriptor.
1105  *
1106  * _name: Component class name (C identifier).
1107  * _x:    Port connected (bt_component_class_port_connected_method).
1108  */
1109 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_PORT_CONNECTED_METHOD(_name, _x) \
1110         BT_PLUGIN_FILTER_COMPONENT_CLASS_PORT_CONNECTED_METHOD_WITH_ID(auto, _name, _x)
1111
1112 /*
1113  * Defines a port connected method attribute attached to a sink
1114  * component class descriptor which is attached to the automatic plugin
1115  * descriptor.
1116  *
1117  * _name: Component class name (C identifier).
1118  * _x:    Port connected (bt_component_class_port_connected_method).
1119  */
1120 #define BT_PLUGIN_SINK_COMPONENT_CLASS_PORT_CONNECTED_METHOD(_name, _x) \
1121         BT_PLUGIN_SINK_COMPONENT_CLASS_PORT_CONNECTED_METHOD_WITH_ID(auto, _name, _x)
1122
1123 /*
1124  * Defines a port disconnected method attribute attached to a source
1125  * component class descriptor which is attached to the automatic plugin
1126  * descriptor.
1127  *
1128  * _name: Component class name (C identifier).
1129  * _x:    Port disconnected (bt_component_class_port_disconnected_method).
1130  */
1131 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_PORT_DISCONNECTED_METHOD(_name, _x) \
1132         BT_PLUGIN_SOURCE_COMPONENT_CLASS_PORT_DISCONNECTED_METHOD_WITH_ID(auto, _name, _x)
1133
1134 /*
1135  * Defines a port disconnected method attribute attached to a filter
1136  * component class descriptor which is attached to the automatic plugin
1137  * descriptor.
1138  *
1139  * _name: Component class name (C identifier).
1140  * _x:    Port disconnected (bt_component_class_port_disconnected_method).
1141  */
1142 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_PORT_DISCONNECTED_METHOD(_name, _x) \
1143         BT_PLUGIN_FILTER_COMPONENT_CLASS_PORT_DISCONNECTED_METHOD_WITH_ID(auto, _name, _x)
1144
1145 /*
1146  * Defines a port disconnected method attribute attached to a sink
1147  * component class descriptor which is attached to the automatic plugin
1148  * descriptor.
1149  *
1150  * _name: Component class name (C identifier).
1151  * _x:    Port disconnected (bt_component_class_port_disconnected_method).
1152  */
1153 #define BT_PLUGIN_SINK_COMPONENT_CLASS_PORT_DISCONNECTED_METHOD(_name, _x) \
1154         BT_PLUGIN_SINK_COMPONENT_CLASS_PORT_DISCONNECTED_METHOD_WITH_ID(auto, _name, _x)
1155
1156 /*
1157  * Defines an iterator initialization method attribute attached to a
1158  * source component class descriptor which is attached to the automatic
1159  * plugin descriptor.
1160  *
1161  * _name: Component class name (C identifier).
1162  * _x:    Iterator initialization method
1163  *        (bt_component_class_notification_iterator_init_method).
1164  */
1165 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_NOTIFICATION_ITERATOR_INIT_METHOD(_name, _x) \
1166         BT_PLUGIN_SOURCE_COMPONENT_CLASS_NOTIFICATION_ITERATOR_INIT_METHOD_WITH_ID(auto, _name, _x)
1167
1168 /*
1169  * Defines an iterator finalize method attribute attached to a source
1170  * component class descriptor which is attached to the automatic plugin
1171  * descriptor.
1172  *
1173  * _name: Component class name (C identifier).
1174  * _x:    Iterator finalize method
1175  *        (bt_component_class_notification_iterator_finalize_method).
1176  */
1177 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_NOTIFICATION_ITERATOR_FINALIZE_METHOD(_name, _x) \
1178         BT_PLUGIN_SOURCE_COMPONENT_CLASS_NOTIFICATION_ITERATOR_FINALIZE_METHOD_WITH_ID(auto, _name, _x)
1179
1180 /*
1181  * Defines an iterator seek time method attribute attached to a source
1182  * component class descriptor which is attached to the automatic plugin
1183  * descriptor.
1184  *
1185  * _name: Component class name (C identifier).
1186  * _x:    Iterator seek time method
1187  *        (bt_component_class_notification_iterator_seek_time_method).
1188  */
1189 #define BT_PLUGIN_SOURCE_COMPONENT_CLASS_NOTIFICATION_ITERATOR_SEEK_TIME_METHOD(_name, _x) \
1190         BT_PLUGIN_SOURCE_COMPONENT_CLASS_NOTIFICATION_ITERATOR_SEEK_TIME_METHOD_WITH_ID(auto, _name, _x)
1191
1192 /*
1193  * Defines an iterator initialization method attribute attached to a
1194  * filter component class descriptor which is attached to the automatic
1195  * plugin descriptor.
1196  *
1197  * _name: Component class name (C identifier).
1198  * _x:    Iterator initialization method
1199  *        (bt_component_class_notification_iterator_init_method).
1200  */
1201 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_NOTIFICATION_ITERATOR_INIT_METHOD(_name, _x) \
1202         BT_PLUGIN_FILTER_COMPONENT_CLASS_NOTIFICATION_ITERATOR_INIT_METHOD_WITH_ID(auto, _name, _x)
1203
1204 /*
1205  * Defines an iterator finalize method attribute attached to a filter
1206  * component class descriptor which is attached to the automatic plugin
1207  * descriptor.
1208  *
1209  * _name: Component class name (C identifier).
1210  * _x:    Iterator finalize method
1211  *        (bt_component_class_notification_iterator_finalize_method).
1212  */
1213 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_NOTIFICATION_ITERATOR_FINALIZE_METHOD(_name, _x) \
1214         BT_PLUGIN_FILTER_COMPONENT_CLASS_NOTIFICATION_ITERATOR_FINALIZE_METHOD_WITH_ID(auto, _name, _x)
1215
1216 /*
1217  * Defines an iterator seek time method attribute attached to a filter
1218  * component class descriptor which is attached to the automatic plugin
1219  * descriptor.
1220  *
1221  * _name: Component class name (C identifier).
1222  * _x:    Iterator seek time method
1223  *        (bt_component_class_notification_iterator_seek_time_method).
1224  */
1225 #define BT_PLUGIN_FILTER_COMPONENT_CLASS_NOTIFICATION_ITERATOR_SEEK_TIME_METHOD(_name, _x) \
1226         BT_PLUGIN_FILTER_COMPONENT_CLASS_NOTIFICATION_ITERATOR_SEEK_TIME_METHOD_WITH_ID(auto, _name, _x)
1227
1228 #ifdef __cplusplus
1229 }
1230 #endif
1231
1232 #endif /* BABELTRACE_PLUGIN_PLUGIN_DEV_H */