Cleanup: remove old comments
[lttng-ust.git] / liblttng-ust / ust-events-internal.h
CommitLineData
d871c65b 1/*
c0c0989a 2 * SPDX-License-Identifier: MIT
d871c65b 3 *
c0c0989a 4 * Copyright 2019 (c) Francis Deslauriers <francis.deslauriers@efficios.com>
d871c65b
FD
5 */
6
c0c0989a
MJ
7#ifndef _LTTNG_UST_EVENTS_INTERNAL_H
8#define _LTTNG_UST_EVENTS_INTERNAL_H
9
d871c65b
FD
10#include <stdint.h>
11
12#include <urcu/list.h>
13#include <urcu/hlist.h>
14
d871c65b
FD
15#include <lttng/ust-events.h>
16
a084756d 17#include <ust-helper.h>
fa194c41 18#include "ust-context-provider.h"
fd17d7ce
MD
19
20struct lttng_ust_abi_obj;
06cd86a0 21struct lttng_event_notifier_group;
fd17d7ce
MD
22
23union lttng_ust_abi_args {
24 struct {
25 void *chan_data;
26 int wakeup_fd;
27 } channel;
28 struct {
29 int shm_fd;
30 int wakeup_fd;
31 } stream;
32 struct {
33 struct lttng_ust_abi_field_iter entry;
34 } field_list;
35 struct {
36 char *ctxname;
37 } app_context;
38 struct {
39 int event_notifier_notif_fd;
40 } event_notifier_handle;
41 struct {
42 void *counter_data;
43 } counter;
44 struct {
45 int shm_fd;
46 } counter_shm;
47};
48
49struct lttng_ust_abi_objd_ops {
50 long (*cmd)(int objd, unsigned int cmd, unsigned long arg,
51 union lttng_ust_abi_args *args, void *owner);
52 int (*release)(int objd);
53};
54
8665f6a4
MJ
55enum lttng_enabler_format_type {
56 LTTNG_ENABLER_FORMAT_STAR_GLOB,
57 LTTNG_ENABLER_FORMAT_EVENT,
58};
59
60/*
61 * Enabler field, within whatever object is enabling an event. Target of
62 * backward reference.
63 */
64struct lttng_enabler {
65 enum lttng_enabler_format_type format_type;
66
67 /* head list of struct lttng_ust_filter_bytecode_node */
68 struct cds_list_head filter_bytecode_head;
69 /* head list of struct lttng_ust_excluder_node */
70 struct cds_list_head excluder_head;
71
fd17d7ce 72 struct lttng_ust_abi_event event_param;
8665f6a4
MJ
73 unsigned int enabled:1;
74};
75
d871c65b
FD
76struct lttng_event_enabler {
77 struct lttng_enabler base;
78 struct cds_list_head node; /* per-session list of enablers */
e7bc0ef6 79 struct lttng_ust_channel_buffer *chan;
d871c65b
FD
80 /*
81 * Unused, but kept around to make it explicit that the tracer can do
82 * it.
83 */
daacdbfc 84 struct lttng_ust_ctx *ctx;
d871c65b
FD
85};
86
d8d2416d
FD
87struct lttng_event_notifier_enabler {
88 struct lttng_enabler base;
6566528b 89 uint64_t error_counter_index;
d37ecb3f
FD
90 struct cds_list_head node; /* per-app list of event_notifier enablers */
91 struct cds_list_head capture_bytecode_head;
d8d2416d
FD
92 struct lttng_event_notifier_group *group; /* weak ref */
93 uint64_t user_token; /* User-provided token */
d37ecb3f 94 uint64_t num_captures;
d8d2416d
FD
95};
96
22c30e27
MD
97enum lttng_ust_bytecode_type {
98 LTTNG_UST_BYTECODE_TYPE_FILTER,
99 LTTNG_UST_BYTECODE_TYPE_CAPTURE,
ab249ecf
FD
100};
101
102struct lttng_ust_bytecode_node {
22c30e27 103 enum lttng_ust_bytecode_type type;
92495593
FD
104 struct cds_list_head node;
105 struct lttng_enabler *enabler;
ab249ecf
FD
106 struct {
107 uint32_t len;
108 uint32_t reloc_offset;
109 uint64_t seqnum;
110 char data[];
111 } bc;
92495593
FD
112};
113
a2e4d05e
MD
114/*
115 * Bytecode interpreter return value.
116 */
117enum lttng_ust_bytecode_interpreter_ret {
118 LTTNG_UST_BYTECODE_INTERPRETER_ERROR = -1,
119 LTTNG_UST_BYTECODE_INTERPRETER_OK = 0,
120};
121
122struct lttng_interpreter_output;
123struct lttng_ust_bytecode_runtime_private;
124
125enum lttng_ust_bytecode_filter_result {
126 LTTNG_UST_BYTECODE_FILTER_ACCEPT = 0,
127 LTTNG_UST_BYTECODE_FILTER_REJECT = 1,
128};
129
130struct lttng_ust_bytecode_filter_ctx {
131 enum lttng_ust_bytecode_filter_result result;
132};
133
92495593
FD
134struct lttng_ust_excluder_node {
135 struct cds_list_head node;
136 struct lttng_enabler *enabler;
137 /*
138 * struct lttng_ust_event_exclusion had variable sized array,
139 * must be last field.
140 */
fd17d7ce 141 struct lttng_ust_abi_event_exclusion excluder;
92495593
FD
142};
143
bb7ad29d
MJ
144/* Data structures used by the tracer. */
145
146struct tp_list_entry {
fd17d7ce 147 struct lttng_ust_abi_tracepoint_iter tp;
bb7ad29d
MJ
148 struct cds_list_head head;
149};
150
151struct lttng_ust_tracepoint_list {
152 struct tp_list_entry *iter;
153 struct cds_list_head head;
154};
155
156struct tp_field_list_entry {
fd17d7ce 157 struct lttng_ust_abi_field_iter field;
bb7ad29d
MJ
158 struct cds_list_head head;
159};
160
161struct lttng_ust_field_list {
162 struct tp_field_list_entry *iter;
163 struct cds_list_head head;
164};
165
166/*
167 * Objects in a linked-list of enablers, owned by an event or event_notifier.
168 * This is used because an event (or a event_notifier) can be enabled by more
169 * than one enabler and we want a quick way to iterate over all enablers of an
170 * object.
171 *
172 * For example, event rules "my_app:a*" and "my_app:ab*" will both match the
173 * event with the name "my_app:abc".
174 */
175struct lttng_enabler_ref {
176 struct cds_list_head node; /* enabler ref list */
177 struct lttng_enabler *ref; /* backward ref */
178};
179
180#define LTTNG_COUNTER_DIMENSION_MAX 8
181struct lttng_counter_dimension {
182 uint64_t size;
183 uint64_t underflow_index;
184 uint64_t overflow_index;
185 uint8_t has_underflow;
186 uint8_t has_overflow;
187};
188
b5863ea7
MD
189struct lttng_counter_ops {
190 struct lib_counter *(*counter_create)(size_t nr_dimensions,
191 const struct lttng_counter_dimension *dimensions,
192 int64_t global_sum_step,
193 int global_counter_fd,
194 int nr_counter_cpu_fds,
195 const int *counter_cpu_fds,
196 bool is_daemon);
197 void (*counter_destroy)(struct lib_counter *counter);
198 int (*counter_add)(struct lib_counter *counter,
199 const size_t *dimension_indexes, int64_t v);
200 int (*counter_read)(struct lib_counter *counter,
201 const size_t *dimension_indexes, int cpu,
202 int64_t *value, bool *overflow, bool *underflow);
203 int (*counter_aggregate)(struct lib_counter *counter,
204 const size_t *dimension_indexes, int64_t *value,
205 bool *overflow, bool *underflow);
206 int (*counter_clear)(struct lib_counter *counter, const size_t *dimension_indexes);
207};
208
bb7ad29d
MJ
209struct lttng_counter {
210 int objd;
211 struct lttng_event_notifier_group *event_notifier_group; /* owner */
212 struct lttng_counter_transport *transport;
213 struct lib_counter *counter;
214 struct lttng_counter_ops *ops;
215};
216
681f6001
MD
217#define LTTNG_UST_EVENT_HT_BITS 12
218#define LTTNG_UST_EVENT_HT_SIZE (1U << LTTNG_UST_EVENT_HT_BITS)
219
220struct lttng_ust_event_ht {
221 struct cds_hlist_head table[LTTNG_UST_EVENT_HT_SIZE];
222};
223
224#define LTTNG_UST_EVENT_NOTIFIER_HT_BITS 12
225#define LTTNG_UST_EVENT_NOTIFIER_HT_SIZE (1U << LTTNG_UST_EVENT_NOTIFIER_HT_BITS)
226struct lttng_ust_event_notifier_ht {
227 struct cds_hlist_head table[LTTNG_UST_EVENT_NOTIFIER_HT_SIZE];
228};
229
230#define LTTNG_UST_ENUM_HT_BITS 12
231#define LTTNG_UST_ENUM_HT_SIZE (1U << LTTNG_UST_ENUM_HT_BITS)
232
233struct lttng_ust_enum_ht {
234 struct cds_hlist_head table[LTTNG_UST_ENUM_HT_SIZE];
235};
236
bb7ad29d
MJ
237struct lttng_event_notifier_group {
238 int objd;
239 void *owner;
240 int notification_fd;
241 struct cds_list_head node; /* Event notifier group handle list */
242 struct cds_list_head enablers_head;
243 struct cds_list_head event_notifiers_head; /* list of event_notifiers */
244 struct lttng_ust_event_notifier_ht event_notifiers_ht; /* hashtable of event_notifiers */
daacdbfc 245 struct lttng_ust_ctx *ctx; /* contexts for filters. */
bb7ad29d
MJ
246
247 struct lttng_counter *error_counter;
248 size_t error_counter_len;
249};
250
251struct lttng_transport {
252 char *name;
253 struct cds_list_head node;
49926dbd 254 struct lttng_ust_channel_ops ops;
bb7ad29d
MJ
255 const struct lttng_ust_lib_ring_buffer_config *client_config;
256};
257
258struct lttng_counter_transport {
259 char *name;
260 struct cds_list_head node;
261 struct lttng_counter_ops ops;
262 const struct lib_counter_config *client_config;
263};
264
80333dfa 265struct lttng_ust_event_common_private {
7ee76145 266 struct lttng_ust_event_common *pub; /* Public event interface */
68bb7559 267
a084756d 268 struct lttng_ust_event_desc *desc;
68bb7559
MD
269 /* Backward references: list of lttng_enabler_ref (ref to enablers) */
270 struct cds_list_head enablers_ref_head;
68bb7559 271 int registered; /* has reg'd tracepoint probe */
115db533 272 uint64_t user_token;
a2e4d05e
MD
273
274 int has_enablers_without_filter_bytecode;
275 /* list of struct lttng_ust_bytecode_runtime, sorted by seqnum */
276 struct cds_list_head filter_bytecode_runtime_head;
68bb7559
MD
277};
278
2e70391c 279struct lttng_ust_event_recorder_private {
80333dfa
MD
280 struct lttng_ust_event_common_private parent;
281
2e70391c 282 struct lttng_ust_event_recorder *pub; /* Public event interface */
ba99fbe2
MD
283 struct cds_list_head node; /* Event recorder list */
284 struct cds_hlist_node hlist; /* Hash table of event recorders */
a40b5b8c 285 struct lttng_ust_ctx *ctx;
80333dfa
MD
286};
287
115db533
MD
288struct lttng_ust_event_notifier_private {
289 struct lttng_ust_event_common_private parent;
290
d7d45c0d 291 struct lttng_ust_event_notifier *pub; /* Public event notifier interface */
115db533
MD
292 struct lttng_event_notifier_group *group; /* weak ref */
293 size_t num_captures; /* Needed to allocate the msgpack array. */
294 uint64_t error_counter_index;
ba99fbe2
MD
295 struct cds_list_head node; /* Event notifier list */
296 struct cds_hlist_node hlist; /* Hash table of event notifiers */
a2e4d05e 297 struct cds_list_head capture_bytecode_runtime_head;
115db533 298
a2e4d05e 299};
362a65de 300
a2e4d05e 301struct lttng_ust_bytecode_runtime {
22c30e27 302 enum lttng_ust_bytecode_type type;
362a65de
MD
303 struct lttng_ust_bytecode_node *bc;
304 int link_failed;
a2e4d05e
MD
305 int (*interpreter_func)(struct lttng_ust_bytecode_runtime *bytecode_runtime,
306 const char *interpreter_stack_data,
307 void *ctx);
308 struct cds_list_head node; /* list of bytecode runtime in event */
362a65de
MD
309 /*
310 * Pointer to a URCU-protected pointer owned by an `struct
311 * lttng_session`or `struct lttng_event_notifier_group`.
312 */
daacdbfc 313 struct lttng_ust_ctx **pctx;
362a65de
MD
314};
315
bdb12629 316struct lttng_ust_session_private {
f69fe5fb 317 struct lttng_ust_session *pub; /* Public session interface */
bdb12629
MD
318
319 int been_active; /* Been active ? */
320 int objd; /* Object associated */
321 struct cds_list_head chan_head; /* Channel list head */
322 struct cds_list_head events_head; /* list of events */
323 struct cds_list_head node; /* Session list */
324
bdb12629
MD
325 /* List of enablers */
326 struct cds_list_head enablers_head;
327 struct lttng_ust_event_ht events_ht; /* ht of events */
328 void *owner; /* object owner */
329 int tstate:1; /* Transient enable state */
330
bdb12629
MD
331 int statedump_pending:1;
332
bdb12629
MD
333 struct lttng_ust_enum_ht enums_ht; /* ht of enumerations */
334 struct cds_list_head enums_head;
daacdbfc 335 struct lttng_ust_ctx *ctx; /* contexts for filters. */
bdb12629
MD
336};
337
036d17fb 338struct lttng_enum {
a084756d 339 struct lttng_ust_enum_desc *desc;
f69fe5fb 340 struct lttng_ust_session *session;
036d17fb
MD
341 struct cds_list_head node; /* Enum list in session */
342 struct cds_hlist_node hlist; /* Session ht of enums */
343 uint64_t id; /* Enumeration ID in sessiond */
344};
345
e7bc0ef6
MD
346struct lttng_ust_shm_handle;
347
a880bae5
MD
348struct lttng_ust_channel_ops_private {
349 struct lttng_ust_channel_ops *pub; /* Public channels ops interface */
350
e7bc0ef6 351 struct lttng_ust_channel_buffer *(*channel_create)(const char *name,
a880bae5
MD
352 void *buf_addr,
353 size_t subbuf_size, size_t num_subbuf,
354 unsigned int switch_timer_interval,
355 unsigned int read_timer_interval,
356 unsigned char *uuid,
357 uint32_t chan_id,
358 const int *stream_fds, int nr_stream_fds,
359 int64_t blocking_timeout);
e7bc0ef6 360 void (*channel_destroy)(struct lttng_ust_channel_buffer *chan);
a880bae5
MD
361 /*
362 * packet_avail_size returns the available size in the current
363 * packet. Note that the size returned is only a hint, since it
364 * may change due to concurrent writes.
365 */
366 size_t (*packet_avail_size)(struct lttng_ust_lib_ring_buffer_channel *chan,
367 struct lttng_ust_shm_handle *handle);
368 int (*is_finalized)(struct lttng_ust_lib_ring_buffer_channel *chan);
369 int (*is_disabled)(struct lttng_ust_lib_ring_buffer_channel *chan);
370 int (*flush_buffer)(struct lttng_ust_lib_ring_buffer_channel *chan,
371 struct lttng_ust_shm_handle *handle);
372};
373
e7bc0ef6
MD
374struct lttng_ust_channel_common_private {
375 struct lttng_ust_channel_common *pub; /* Public channel interface */
376
377 int objd; /* Object associated with channel. */
378 int tstate:1; /* Transient enable state */
379};
380
381struct lttng_ust_channel_buffer_private {
382 struct lttng_ust_channel_common_private parent;
383
384 struct lttng_ust_channel_buffer *pub; /* Public channel buffer interface */
385 struct cds_list_head node; /* Channel list in session */
386 int header_type; /* 0: unset, 1: compact, 2: large */
387 unsigned int id; /* Channel ID */
388 enum lttng_ust_abi_chan_type type;
0950190a 389 struct lttng_ust_ctx *ctx;
e7bc0ef6
MD
390 unsigned char uuid[LTTNG_UST_UUID_LEN]; /* Trace session unique ID */
391};
392
f0fde1c3
MD
393/*
394 * IMPORTANT: this structure is part of the ABI between the consumer
395 * daemon and the UST library within traced applications. Changing it
396 * breaks the UST communication protocol.
397 *
398 * TODO: remove unused fields on next UST communication protocol
399 * breaking update.
400 */
401struct lttng_ust_abi_channel_config {
402 void *unused1;
403 int unused2;
404 void *unused3;
405 void *unused4;
406 int unused5;
407 struct cds_list_head unused6;
408 void *unused7;
409 int unused8;
410 void *unused9;
411
412 /* Channel ID */
413 unsigned int id;
414 enum lttng_ust_abi_chan_type unused10;
415 unsigned char uuid[LTTNG_UST_UUID_LEN]; /* Trace session unique ID */
416 int unused11:1;
417};
418
a084756d
MD
419static inline
420struct lttng_ust_type_integer *lttng_ust_get_type_integer(struct lttng_ust_type_common *type)
421{
422 if (type->type != lttng_ust_type_integer)
423 return NULL;
424 return caa_container_of(type, struct lttng_ust_type_integer, parent);
425}
426
427static inline
428struct lttng_ust_type_float *lttng_ust_get_type_float(struct lttng_ust_type_common *type)
429{
430 if (type->type != lttng_ust_type_float)
431 return NULL;
432 return caa_container_of(type, struct lttng_ust_type_float, parent);
433}
434
435static inline
436struct lttng_ust_type_string *lttng_ust_get_type_string(struct lttng_ust_type_common *type)
437{
438 if (type->type != lttng_ust_type_string)
439 return NULL;
440 return caa_container_of(type, struct lttng_ust_type_string, parent);
441}
442
443static inline
444struct lttng_ust_type_enum *lttng_ust_get_type_enum(struct lttng_ust_type_common *type)
445{
446 if (type->type != lttng_ust_type_enum)
447 return NULL;
448 return caa_container_of(type, struct lttng_ust_type_enum, parent);
449}
450
451static inline
452struct lttng_ust_type_array *lttng_ust_get_type_array(struct lttng_ust_type_common *type)
453{
454 if (type->type != lttng_ust_type_array)
455 return NULL;
456 return caa_container_of(type, struct lttng_ust_type_array, parent);
457}
458
459static inline
460struct lttng_ust_type_sequence *lttng_ust_get_type_sequence(struct lttng_ust_type_common *type)
461{
462 if (type->type != lttng_ust_type_sequence)
463 return NULL;
464 return caa_container_of(type, struct lttng_ust_type_sequence, parent);
465}
466
467static inline
468struct lttng_ust_type_struct *lttng_ust_get_type_struct(struct lttng_ust_type_common *type)
469{
470 if (type->type != lttng_ust_type_struct)
471 return NULL;
472 return caa_container_of(type, struct lttng_ust_type_struct, parent);
473}
474
475/* Create dynamically allocated types. */
476static inline
477struct lttng_ust_type_common *lttng_ust_create_type_integer(unsigned int size,
478 unsigned short alignment, bool signedness, unsigned int byte_order,
479 unsigned int base)
480{
481 struct lttng_ust_type_integer *integer_type;
482
483 integer_type = zmalloc(sizeof(struct lttng_ust_type_integer));
484 if (!integer_type)
485 return NULL;
486 integer_type->parent.type = lttng_ust_type_integer;
487 integer_type->struct_size = sizeof(struct lttng_ust_type_integer);
488 integer_type->size = size;
489 integer_type->alignment = alignment;
490 integer_type->signedness = signedness;
491 integer_type->reverse_byte_order = byte_order != BYTE_ORDER;
492 integer_type->base = base;
493 return (struct lttng_ust_type_common *) integer_type;
494}
495
496static inline
497struct lttng_ust_type_common *lttng_ust_create_type_array_text(unsigned int length)
498{
499 struct lttng_ust_type_array *array_type;
500
501 array_type = zmalloc(sizeof(struct lttng_ust_type_array));
502 if (!array_type)
503 return NULL;
504 array_type->parent.type = lttng_ust_type_array;
505 array_type->struct_size = sizeof(struct lttng_ust_type_array);
506 array_type->length = length;
507 array_type->alignment = 0;
508 array_type->encoding = lttng_ust_string_encoding_UTF8;
509 array_type->elem_type = lttng_ust_create_type_integer(sizeof(char) * CHAR_BIT,
510 lttng_alignof(char) * CHAR_BIT, lttng_is_signed_type(char),
511 BYTE_ORDER, 10);
512 if (!array_type->elem_type)
513 goto error_elem;
514 return (struct lttng_ust_type_common *) array_type;
515
516error_elem:
517 free(array_type);
518 return NULL;
519}
520
521/*
522 * Destroy dynamically allocated types, including nested types.
523 * For enumerations, it does not free the enumeration mapping description.
524 */
525static inline
526void lttng_ust_destroy_type(struct lttng_ust_type_common *type)
527{
528 if (!type)
529 return;
530
531 switch (type->type) {
532 case lttng_ust_type_integer:
533 case lttng_ust_type_string:
534 case lttng_ust_type_float:
535 case lttng_ust_type_dynamic:
536 free(type);
537 break;
538 case lttng_ust_type_enum:
539 {
540 struct lttng_ust_type_enum *enum_type = (struct lttng_ust_type_enum *) type;
541
542 lttng_ust_destroy_type(enum_type->container_type);
a9d86fd1 543 free(enum_type);
a084756d
MD
544 break;
545 }
546 case lttng_ust_type_array:
547 {
548 struct lttng_ust_type_array *array_type = (struct lttng_ust_type_array *) type;
549
550 lttng_ust_destroy_type(array_type->elem_type);
a9d86fd1 551 free(array_type);
a084756d
MD
552 break;
553 }
554 case lttng_ust_type_sequence:
555 {
556 struct lttng_ust_type_sequence *sequence_type = (struct lttng_ust_type_sequence *) type;
557
558 lttng_ust_destroy_type(sequence_type->elem_type);
a9d86fd1 559 free(sequence_type);
a084756d
MD
560 break;
561 }
562 case lttng_ust_type_struct:
563 {
564 struct lttng_ust_type_struct *struct_type = (struct lttng_ust_type_struct *) type;
565 unsigned int i;
566
567 for (i = 0; i < struct_type->nr_fields; i++)
568 lttng_ust_destroy_type(struct_type->fields[i]->type);
a9d86fd1 569 free(struct_type);
a084756d
MD
570 break;
571 }
572 default:
573 abort();
574 }
575}
576
d871c65b
FD
577static inline
578struct lttng_enabler *lttng_event_enabler_as_enabler(
579 struct lttng_event_enabler *event_enabler)
580{
581 return &event_enabler->base;
582}
583
d8d2416d
FD
584static inline
585struct lttng_enabler *lttng_event_notifier_enabler_as_enabler(
586 struct lttng_event_notifier_enabler *event_notifier_enabler)
587{
588 return &event_notifier_enabler->base;
589}
d871c65b
FD
590
591/*
592 * Allocate and initialize a `struct lttng_event_enabler` object.
593 *
594 * On success, returns a `struct lttng_event_enabler`,
595 * On memory error, returns NULL.
596 */
ddabe860 597__attribute__((visibility("hidden")))
d871c65b
FD
598struct lttng_event_enabler *lttng_event_enabler_create(
599 enum lttng_enabler_format_type format_type,
fd17d7ce 600 struct lttng_ust_abi_event *event_param,
e7bc0ef6 601 struct lttng_ust_channel_buffer *chan);
d871c65b
FD
602
603/*
604 * Destroy a `struct lttng_event_enabler` object.
605 */
ddabe860 606__attribute__((visibility("hidden")))
d871c65b
FD
607void lttng_event_enabler_destroy(struct lttng_event_enabler *enabler);
608
609/*
610 * Enable a `struct lttng_event_enabler` object and all events related to this
611 * enabler.
612 */
ddabe860 613__attribute__((visibility("hidden")))
d871c65b
FD
614int lttng_event_enabler_enable(struct lttng_event_enabler *enabler);
615
616/*
617 * Disable a `struct lttng_event_enabler` object and all events related to this
618 * enabler.
619 */
ddabe860 620__attribute__((visibility("hidden")))
d871c65b
FD
621int lttng_event_enabler_disable(struct lttng_event_enabler *enabler);
622
623/*
624 * Attach filter bytecode program to `struct lttng_event_enabler` and all
625 * events related to this enabler.
626 */
ddabe860 627__attribute__((visibility("hidden")))
a56fd376
FD
628int lttng_event_enabler_attach_filter_bytecode(
629 struct lttng_event_enabler *enabler,
ab89263e 630 struct lttng_ust_bytecode_node **bytecode);
d871c65b
FD
631
632/*
633 * Attach an application context to an event enabler.
634 *
635 * Not implemented.
636 */
ddabe860 637__attribute__((visibility("hidden")))
d871c65b 638int lttng_event_enabler_attach_context(struct lttng_event_enabler *enabler,
fd17d7ce 639 struct lttng_ust_abi_context *ctx);
d871c65b
FD
640
641/*
642 * Attach exclusion list to `struct lttng_event_enabler` and all
643 * events related to this enabler.
644 */
ddabe860 645__attribute__((visibility("hidden")))
d871c65b 646int lttng_event_enabler_attach_exclusion(struct lttng_event_enabler *enabler,
e9fe6aad 647 struct lttng_ust_excluder_node **excluder);
d871c65b
FD
648
649/*
d37ecb3f
FD
650 * Synchronize bytecodes for the enabler and the instance (event or
651 * event_notifier).
d871c65b 652 *
621c07fc 653 * This function goes over all bytecode programs of the enabler (event or
d37ecb3f 654 * event_notifier enabler) to ensure each is linked to the provided instance.
d871c65b 655 */
ddabe860 656__attribute__((visibility("hidden")))
a084756d 657void lttng_enabler_link_bytecode(struct lttng_ust_event_desc *event_desc,
daacdbfc 658 struct lttng_ust_ctx **ctx,
621c07fc
FD
659 struct cds_list_head *instance_bytecode_runtime_head,
660 struct cds_list_head *enabler_bytecode_runtime_head);
d871c65b 661
d8d2416d
FD
662/*
663 * Allocate and initialize a `struct lttng_event_notifier_group` object.
664 *
665 * On success, returns a `struct lttng_triggre_group`,
666 * on memory error, returns NULL.
667 */
ddabe860 668__attribute__((visibility("hidden")))
d8d2416d
FD
669struct lttng_event_notifier_group *lttng_event_notifier_group_create(void);
670
671/*
672 * Destroy a `struct lttng_event_notifier_group` object.
673 */
ddabe860 674__attribute__((visibility("hidden")))
d8d2416d
FD
675void lttng_event_notifier_group_destroy(
676 struct lttng_event_notifier_group *event_notifier_group);
677
678/*
679 * Allocate and initialize a `struct lttng_event_notifier_enabler` object.
680 *
681 * On success, returns a `struct lttng_event_notifier_enabler`,
682 * On memory error, returns NULL.
683 */
ddabe860 684__attribute__((visibility("hidden")))
d8d2416d
FD
685struct lttng_event_notifier_enabler *lttng_event_notifier_enabler_create(
686 struct lttng_event_notifier_group *event_notifier_group,
687 enum lttng_enabler_format_type format_type,
fd17d7ce 688 struct lttng_ust_abi_event_notifier *event_notifier_param);
d8d2416d
FD
689
690/*
691 * Destroy a `struct lttng_event_notifier_enabler` object.
692 */
ddabe860 693__attribute__((visibility("hidden")))
d8d2416d
FD
694void lttng_event_notifier_enabler_destroy(
695 struct lttng_event_notifier_enabler *event_notifier_enabler);
696
697/*
698 * Enable a `struct lttng_event_notifier_enabler` object and all event
699 * notifiers related to this enabler.
700 */
ddabe860 701__attribute__((visibility("hidden")))
d8d2416d
FD
702int lttng_event_notifier_enabler_enable(
703 struct lttng_event_notifier_enabler *event_notifier_enabler);
704
705/*
706 * Disable a `struct lttng_event_notifier_enabler` object and all event
707 * notifiers related to this enabler.
708 */
ddabe860 709__attribute__((visibility("hidden")))
d8d2416d
FD
710int lttng_event_notifier_enabler_disable(
711 struct lttng_event_notifier_enabler *event_notifier_enabler);
712
713/*
714 * Attach filter bytecode program to `struct lttng_event_notifier_enabler` and
715 * all event notifiers related to this enabler.
716 */
ddabe860 717__attribute__((visibility("hidden")))
a56fd376 718int lttng_event_notifier_enabler_attach_filter_bytecode(
d8d2416d 719 struct lttng_event_notifier_enabler *event_notifier_enabler,
ab89263e 720 struct lttng_ust_bytecode_node **bytecode);
d8d2416d 721
d37ecb3f
FD
722/*
723 * Attach capture bytecode program to `struct lttng_event_notifier_enabler` and
724 * all event_notifiers related to this enabler.
725 */
ddabe860 726__attribute__((visibility("hidden")))
d37ecb3f
FD
727int lttng_event_notifier_enabler_attach_capture_bytecode(
728 struct lttng_event_notifier_enabler *event_notifier_enabler,
49cde654 729 struct lttng_ust_bytecode_node **bytecode);
d37ecb3f 730
d8d2416d
FD
731/*
732 * Attach exclusion list to `struct lttng_event_notifier_enabler` and all
733 * event notifiers related to this enabler.
734 */
ddabe860 735__attribute__((visibility("hidden")))
d8d2416d
FD
736int lttng_event_notifier_enabler_attach_exclusion(
737 struct lttng_event_notifier_enabler *event_notifier_enabler,
e9fe6aad 738 struct lttng_ust_excluder_node **excluder);
d8d2416d 739
ddabe860 740__attribute__((visibility("hidden")))
b1f720f0 741void lttng_free_event_filter_runtime(struct lttng_ust_event_common *event);
d8d2416d
FD
742
743/*
744 * Connect the probe on all enablers matching this event description.
745 * Called on library load.
746 */
ddabe860 747__attribute__((visibility("hidden")))
d8d2416d
FD
748int lttng_fix_pending_event_notifiers(void);
749
ddabe860 750__attribute__((visibility("hidden")))
67d4e8f5
MJ
751struct lttng_counter *lttng_ust_counter_create(
752 const char *counter_transport_name,
753 size_t number_dimensions, const struct lttng_counter_dimension *dimensions);
754
bd8c1787
MJ
755#ifdef HAVE_PERF_EVENT
756
ddabe860 757__attribute__((visibility("hidden")))
bd8c1787
MJ
758int lttng_add_perf_counter_to_ctx(uint32_t type,
759 uint64_t config,
760 const char *name,
daacdbfc 761 struct lttng_ust_ctx **ctx);
ddabe860
MJ
762
763__attribute__((visibility("hidden")))
bd8c1787 764int lttng_perf_counter_init(void);
ddabe860
MJ
765
766__attribute__((visibility("hidden")))
bd8c1787
MJ
767void lttng_perf_counter_exit(void);
768
769#else /* #ifdef HAVE_PERF_EVENT */
770
771static inline
772int lttng_add_perf_counter_to_ctx(uint32_t type,
773 uint64_t config,
774 const char *name,
daacdbfc 775 struct lttng_ust_ctx **ctx)
bd8c1787
MJ
776{
777 return -ENOSYS;
778}
779static inline
780int lttng_perf_counter_init(void)
781{
782 return 0;
783}
784static inline
785void lttng_perf_counter_exit(void)
786{
787}
788#endif /* #else #ifdef HAVE_PERF_EVENT */
789
ddabe860 790__attribute__((visibility("hidden")))
7753d283 791int lttng_probes_get_event_list(struct lttng_ust_tracepoint_list *list);
ddabe860
MJ
792
793__attribute__((visibility("hidden")))
7753d283
MJ
794void lttng_probes_prune_event_list(struct lttng_ust_tracepoint_list *list);
795
ddabe860 796__attribute__((visibility("hidden")))
7753d283 797int lttng_probes_get_field_list(struct lttng_ust_field_list *list);
ddabe860
MJ
798
799__attribute__((visibility("hidden")))
7753d283
MJ
800void lttng_probes_prune_field_list(struct lttng_ust_field_list *list);
801
ddabe860 802__attribute__((visibility("hidden")))
fd17d7ce 803struct lttng_ust_abi_tracepoint_iter *
7753d283 804 lttng_ust_tracepoint_list_get_iter_next(struct lttng_ust_tracepoint_list *list);
ddabe860
MJ
805
806__attribute__((visibility("hidden")))
fd17d7ce 807struct lttng_ust_abi_field_iter *
7753d283
MJ
808 lttng_ust_field_list_get_iter_next(struct lttng_ust_field_list *list);
809
ddabe860 810__attribute__((visibility("hidden")))
f69fe5fb 811struct lttng_ust_session *lttng_session_create(void);
ddabe860
MJ
812
813__attribute__((visibility("hidden")))
f69fe5fb 814int lttng_session_enable(struct lttng_ust_session *session);
ddabe860
MJ
815
816__attribute__((visibility("hidden")))
f69fe5fb 817int lttng_session_disable(struct lttng_ust_session *session);
ddabe860
MJ
818
819__attribute__((visibility("hidden")))
f69fe5fb 820int lttng_session_statedump(struct lttng_ust_session *session);
ddabe860
MJ
821
822__attribute__((visibility("hidden")))
f69fe5fb 823void lttng_session_destroy(struct lttng_ust_session *session);
7753d283 824
a5ae46cc
MJ
825/*
826 * Called with ust lock held.
827 */
828__attribute__((visibility("hidden")))
829int lttng_session_active(void);
830
ddabe860 831__attribute__((visibility("hidden")))
7753d283
MJ
832struct cds_list_head *lttng_get_sessions(void);
833
ddabe860 834__attribute__((visibility("hidden")))
7753d283
MJ
835void lttng_handle_pending_statedump(void *owner);
836
ddabe860 837__attribute__((visibility("hidden")))
e7bc0ef6 838int lttng_channel_enable(struct lttng_ust_channel_common *lttng_channel);
7753d283 839
ddabe860 840__attribute__((visibility("hidden")))
e7bc0ef6 841int lttng_channel_disable(struct lttng_ust_channel_common *lttng_channel);
7753d283 842
ddabe860 843__attribute__((visibility("hidden")))
7753d283 844void lttng_transport_register(struct lttng_transport *transport);
ddabe860
MJ
845
846__attribute__((visibility("hidden")))
7753d283
MJ
847void lttng_transport_unregister(struct lttng_transport *transport);
848
65c48d6a
MJ
849/* This is ABI between liblttng-ust and liblttng-ust-ctl */
850struct lttng_transport *lttng_ust_transport_find(const char *name);
851
cbba5e04
MJ
852/* This is ABI between liblttng-ust and liblttng-ust-dl */
853void lttng_ust_dl_update(void *ip);
854
ddabe860 855__attribute__((visibility("hidden")))
dc11f93f 856void lttng_probe_provider_unregister_events(struct lttng_ust_probe_desc *desc);
7753d283 857
ddabe860 858__attribute__((visibility("hidden")))
7753d283
MJ
859int lttng_fix_pending_events(void);
860
ddabe860 861__attribute__((visibility("hidden")))
7753d283
MJ
862struct cds_list_head *lttng_get_probe_list_head(void);
863
ddabe860 864__attribute__((visibility("hidden")))
f69fe5fb 865struct lttng_enum *lttng_ust_enum_get_from_desc(struct lttng_ust_session *session,
a084756d 866 struct lttng_ust_enum_desc *enum_desc);
7753d283 867
ddabe860 868__attribute__((visibility("hidden")))
fd17d7ce
MD
869int lttng_abi_create_root_handle(void);
870
ddabe860 871__attribute__((visibility("hidden")))
fd17d7ce 872const struct lttng_ust_abi_objd_ops *lttng_ust_abi_objd_ops(int id);
ddabe860
MJ
873
874__attribute__((visibility("hidden")))
fd17d7ce 875int lttng_ust_abi_objd_unref(int id, int is_owner);
ddabe860
MJ
876
877__attribute__((visibility("hidden")))
fd17d7ce 878void lttng_ust_abi_exit(void);
ddabe860
MJ
879
880__attribute__((visibility("hidden")))
fd17d7ce 881void lttng_ust_abi_events_exit(void);
ddabe860
MJ
882
883__attribute__((visibility("hidden")))
fd17d7ce
MD
884void lttng_ust_abi_objd_table_owner_cleanup(void *owner);
885
e7bc0ef6
MD
886__attribute__((visibility("hidden")))
887struct lttng_ust_channel_buffer *lttng_ust_alloc_channel_buffer(void);
888
889__attribute__((visibility("hidden")))
890void lttng_ust_free_channel_common(struct lttng_ust_channel_common *chan);
891
a2e4d05e
MD
892__attribute__((visibility("hidden")))
893int lttng_ust_interpret_event_filter(struct lttng_ust_event_common *event,
894 const char *interpreter_stack_data,
895 void *filter_ctx);
896
d871c65b 897#endif /* _LTTNG_UST_EVENTS_INTERNAL_H */
This page took 0.066566 seconds and 4 git commands to generate.