2 * SPDX-License-Identifier: LGPL-2.1-only
4 * Copyright (C) 2010-2012 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
6 * Holds LTTng per-session event registry.
24 #include <lttng/ust-endian.h>
26 #include <urcu/arch.h>
27 #include <urcu/compiler.h>
28 #include <urcu/hlist.h>
29 #include <urcu/list.h>
30 #include <urcu/uatomic.h>
32 #include <lttng/tracepoint.h>
33 #include <lttng/ust-events.h>
35 #include <usterr-signal-safe.h>
36 #include <ust-helper.h>
37 #include <lttng/ust-ctl.h>
40 #include <ust-dynamic-type.h>
41 #include <ust-context-provider.h>
44 #include "lttng-ust-uuid.h"
46 #include "tracepoint-internal.h"
47 #include "string-utils.h"
48 #include "lttng-bytecode.h"
49 #include "lttng-tracer.h"
50 #include "lttng-tracer-core.h"
51 #include "lttng-ust-statedump.h"
52 #include "context-internal.h"
53 #include "ust-events-internal.h"
55 #include "../libringbuffer/shm.h"
56 #include "../libcounter/counter.h"
58 #include <lttng/ust-abi.h>
61 * All operations within this file are called by the communication
62 * thread, under ust_lock protection.
65 static CDS_LIST_HEAD(sessions
);
66 static CDS_LIST_HEAD(event_notifier_groups
);
68 struct cds_list_head
*lttng_get_sessions(void)
73 static void _lttng_event_destroy(struct lttng_event
*event
);
74 static void _lttng_event_notifier_destroy(
75 struct lttng_event_notifier
*event_notifier
);
76 static void _lttng_enum_destroy(struct lttng_enum
*_enum
);
79 void lttng_session_lazy_sync_event_enablers(struct lttng_session
*session
);
81 void lttng_session_sync_event_enablers(struct lttng_session
*session
);
83 void lttng_event_notifier_group_sync_enablers(
84 struct lttng_event_notifier_group
*event_notifier_group
);
86 void lttng_enabler_destroy(struct lttng_enabler
*enabler
);
89 * Called with ust lock held.
91 int lttng_session_active(void)
93 struct lttng_ust_session_private
*iter
;
95 cds_list_for_each_entry(iter
, &sessions
, node
) {
96 if (iter
->pub
->active
)
103 int lttng_loglevel_match(int loglevel
,
104 unsigned int has_loglevel
,
105 enum lttng_ust_loglevel_type req_type
,
109 loglevel
= TRACE_DEFAULT
;
111 case LTTNG_UST_LOGLEVEL_RANGE
:
112 if (loglevel
<= req_loglevel
113 || (req_loglevel
== -1 && loglevel
<= TRACE_DEBUG
))
117 case LTTNG_UST_LOGLEVEL_SINGLE
:
118 if (loglevel
== req_loglevel
119 || (req_loglevel
== -1 && loglevel
<= TRACE_DEBUG
))
123 case LTTNG_UST_LOGLEVEL_ALL
:
125 if (loglevel
<= TRACE_DEBUG
)
132 struct lttng_session
*lttng_session_create(void)
134 struct lttng_session
*session
;
135 struct lttng_ust_session_private
*session_priv
;
138 session
= zmalloc(sizeof(struct lttng_session
));
141 session
->struct_size
= sizeof(struct lttng_session
);
142 session_priv
= zmalloc(sizeof(struct lttng_ust_session_private
));
147 session
->priv
= session_priv
;
148 session_priv
->pub
= session
;
149 if (lttng_context_init_all(&session
->priv
->ctx
)) {
154 CDS_INIT_LIST_HEAD(&session
->priv
->chan_head
);
155 CDS_INIT_LIST_HEAD(&session
->priv
->events_head
);
156 CDS_INIT_LIST_HEAD(&session
->priv
->enums_head
);
157 CDS_INIT_LIST_HEAD(&session
->priv
->enablers_head
);
158 for (i
= 0; i
< LTTNG_UST_EVENT_HT_SIZE
; i
++)
159 CDS_INIT_HLIST_HEAD(&session
->priv
->events_ht
.table
[i
]);
160 for (i
= 0; i
< LTTNG_UST_ENUM_HT_SIZE
; i
++)
161 CDS_INIT_HLIST_HEAD(&session
->priv
->enums_ht
.table
[i
]);
162 cds_list_add(&session
->priv
->node
, &sessions
);
166 struct lttng_counter
*lttng_ust_counter_create(
167 const char *counter_transport_name
,
168 size_t number_dimensions
, const struct lttng_counter_dimension
*dimensions
)
170 struct lttng_counter_transport
*counter_transport
= NULL
;
171 struct lttng_counter
*counter
= NULL
;
173 counter_transport
= lttng_counter_transport_find(counter_transport_name
);
174 if (!counter_transport
)
176 counter
= zmalloc(sizeof(struct lttng_counter
));
180 counter
->ops
= &counter_transport
->ops
;
181 counter
->transport
= counter_transport
;
183 counter
->counter
= counter
->ops
->counter_create(
184 number_dimensions
, dimensions
, 0,
186 if (!counter
->counter
) {
200 void lttng_ust_counter_destroy(struct lttng_counter
*counter
)
202 counter
->ops
->counter_destroy(counter
->counter
);
206 struct lttng_event_notifier_group
*lttng_event_notifier_group_create(void)
208 struct lttng_event_notifier_group
*event_notifier_group
;
211 event_notifier_group
= zmalloc(sizeof(struct lttng_event_notifier_group
));
212 if (!event_notifier_group
)
215 /* Add all contexts. */
216 if (lttng_context_init_all(&event_notifier_group
->ctx
)) {
217 free(event_notifier_group
);
221 CDS_INIT_LIST_HEAD(&event_notifier_group
->enablers_head
);
222 CDS_INIT_LIST_HEAD(&event_notifier_group
->event_notifiers_head
);
223 for (i
= 0; i
< LTTNG_UST_EVENT_NOTIFIER_HT_SIZE
; i
++)
224 CDS_INIT_HLIST_HEAD(&event_notifier_group
->event_notifiers_ht
.table
[i
]);
226 cds_list_add(&event_notifier_group
->node
, &event_notifier_groups
);
228 return event_notifier_group
;
232 * Only used internally at session destruction.
235 void _lttng_channel_unmap(struct lttng_channel
*lttng_chan
)
237 struct channel
*chan
;
238 struct lttng_ust_shm_handle
*handle
;
240 cds_list_del(<tng_chan
->node
);
241 lttng_destroy_context(lttng_chan
->ctx
);
242 chan
= lttng_chan
->chan
;
243 handle
= lttng_chan
->handle
;
245 * note: lttng_chan is private data contained within handle. It
246 * will be freed along with the handle.
248 channel_destroy(chan
, handle
, 0);
252 void register_event(struct lttng_event
*event
)
255 const struct lttng_event_desc
*desc
;
257 assert(event
->priv
->registered
== 0);
258 desc
= event
->priv
->desc
;
259 ret
= __tracepoint_probe_register_queue_release(desc
->name
,
260 desc
->probe_callback
,
261 event
, desc
->signature
);
264 event
->priv
->registered
= 1;
268 void register_event_notifier(struct lttng_event_notifier
*event_notifier
)
271 const struct lttng_event_desc
*desc
;
273 assert(event_notifier
->registered
== 0);
274 desc
= event_notifier
->desc
;
275 ret
= __tracepoint_probe_register_queue_release(desc
->name
,
276 desc
->u
.ext
.event_notifier_callback
, event_notifier
, desc
->signature
);
279 event_notifier
->registered
= 1;
283 void unregister_event(struct lttng_event
*event
)
286 const struct lttng_event_desc
*desc
;
288 assert(event
->priv
->registered
== 1);
289 desc
= event
->priv
->desc
;
290 ret
= __tracepoint_probe_unregister_queue_release(desc
->name
,
291 desc
->probe_callback
,
295 event
->priv
->registered
= 0;
299 void unregister_event_notifier(struct lttng_event_notifier
*event_notifier
)
302 const struct lttng_event_desc
*desc
;
304 assert(event_notifier
->registered
== 1);
305 desc
= event_notifier
->desc
;
306 ret
= __tracepoint_probe_unregister_queue_release(desc
->name
,
307 desc
->u
.ext
.event_notifier_callback
, event_notifier
);
310 event_notifier
->registered
= 0;
314 * Only used internally at session destruction.
317 void _lttng_event_unregister(struct lttng_event
*event
)
319 if (event
->priv
->registered
)
320 unregister_event(event
);
324 * Only used internally at session destruction.
327 void _lttng_event_notifier_unregister(struct lttng_event_notifier
*event_notifier
)
329 if (event_notifier
->registered
)
330 unregister_event_notifier(event_notifier
);
333 void lttng_session_destroy(struct lttng_session
*session
)
335 struct lttng_channel
*chan
, *tmpchan
;
336 struct lttng_ust_event_private
*event_priv
, *tmpevent_priv
;
337 struct lttng_enum
*_enum
, *tmp_enum
;
338 struct lttng_event_enabler
*event_enabler
, *event_tmpenabler
;
340 CMM_ACCESS_ONCE(session
->active
) = 0;
341 cds_list_for_each_entry(event_priv
, &session
->priv
->events_head
, node
) {
342 _lttng_event_unregister(event_priv
->pub
);
344 lttng_ust_urcu_synchronize_rcu(); /* Wait for in-flight events to complete */
345 __tracepoint_probe_prune_release_queue();
346 cds_list_for_each_entry_safe(event_enabler
, event_tmpenabler
,
347 &session
->priv
->enablers_head
, node
)
348 lttng_event_enabler_destroy(event_enabler
);
349 cds_list_for_each_entry_safe(event_priv
, tmpevent_priv
,
350 &session
->priv
->events_head
, node
)
351 _lttng_event_destroy(event_priv
->pub
);
352 cds_list_for_each_entry_safe(_enum
, tmp_enum
,
353 &session
->priv
->enums_head
, node
)
354 _lttng_enum_destroy(_enum
);
355 cds_list_for_each_entry_safe(chan
, tmpchan
, &session
->priv
->chan_head
, node
)
356 _lttng_channel_unmap(chan
);
357 cds_list_del(&session
->priv
->node
);
358 lttng_destroy_context(session
->priv
->ctx
);
363 void lttng_event_notifier_group_destroy(
364 struct lttng_event_notifier_group
*event_notifier_group
)
367 struct lttng_event_notifier_enabler
*notifier_enabler
, *tmpnotifier_enabler
;
368 struct lttng_event_notifier
*notifier
, *tmpnotifier
;
370 if (!event_notifier_group
) {
374 cds_list_for_each_entry(notifier
,
375 &event_notifier_group
->event_notifiers_head
, node
)
376 _lttng_event_notifier_unregister(notifier
);
378 lttng_ust_urcu_synchronize_rcu();
380 cds_list_for_each_entry_safe(notifier_enabler
, tmpnotifier_enabler
,
381 &event_notifier_group
->enablers_head
, node
)
382 lttng_event_notifier_enabler_destroy(notifier_enabler
);
384 cds_list_for_each_entry_safe(notifier
, tmpnotifier
,
385 &event_notifier_group
->event_notifiers_head
, node
)
386 _lttng_event_notifier_destroy(notifier
);
388 if (event_notifier_group
->error_counter
)
389 lttng_ust_counter_destroy(event_notifier_group
->error_counter
);
391 /* Close the notification fd to the listener of event_notifiers. */
393 lttng_ust_lock_fd_tracker();
394 close_ret
= close(event_notifier_group
->notification_fd
);
396 lttng_ust_delete_fd_from_tracker(
397 event_notifier_group
->notification_fd
);
402 lttng_ust_unlock_fd_tracker();
404 cds_list_del(&event_notifier_group
->node
);
406 free(event_notifier_group
);
410 void lttng_enabler_destroy(struct lttng_enabler
*enabler
)
412 struct lttng_ust_bytecode_node
*filter_node
, *tmp_filter_node
;
413 struct lttng_ust_excluder_node
*excluder_node
, *tmp_excluder_node
;
419 /* Destroy filter bytecode */
420 cds_list_for_each_entry_safe(filter_node
, tmp_filter_node
,
421 &enabler
->filter_bytecode_head
, node
) {
425 /* Destroy excluders */
426 cds_list_for_each_entry_safe(excluder_node
, tmp_excluder_node
,
427 &enabler
->excluder_head
, node
) {
432 void lttng_event_notifier_enabler_destroy(struct lttng_event_notifier_enabler
*event_notifier_enabler
)
434 if (!event_notifier_enabler
) {
438 cds_list_del(&event_notifier_enabler
->node
);
440 lttng_enabler_destroy(lttng_event_notifier_enabler_as_enabler(event_notifier_enabler
));
442 free(event_notifier_enabler
);
446 int lttng_enum_create(const struct lttng_enum_desc
*desc
,
447 struct lttng_session
*session
)
449 const char *enum_name
= desc
->name
;
450 struct lttng_enum
*_enum
;
451 struct cds_hlist_head
*head
;
453 size_t name_len
= strlen(enum_name
);
457 /* Check if this enum is already registered for this session. */
458 hash
= jhash(enum_name
, name_len
, 0);
459 head
= &session
->priv
->enums_ht
.table
[hash
& (LTTNG_UST_ENUM_HT_SIZE
- 1)];
461 _enum
= lttng_ust_enum_get_from_desc(session
, desc
);
467 notify_socket
= lttng_get_notify_socket(session
->priv
->owner
);
468 if (notify_socket
< 0) {
473 _enum
= zmalloc(sizeof(*_enum
));
478 _enum
->session
= session
;
481 ret
= ustcomm_register_enum(notify_socket
,
488 DBG("Error (%d) registering enumeration to sessiond", ret
);
489 goto sessiond_register_error
;
491 cds_list_add(&_enum
->node
, &session
->priv
->enums_head
);
492 cds_hlist_add_head(&_enum
->hlist
, head
);
495 sessiond_register_error
:
504 int lttng_create_enum_check(const struct lttng_type
*type
,
505 struct lttng_session
*session
)
507 switch (type
->atype
) {
510 const struct lttng_enum_desc
*enum_desc
;
513 enum_desc
= type
->u
.legacy
.basic
.enumeration
.desc
;
514 ret
= lttng_enum_create(enum_desc
, session
);
515 if (ret
&& ret
!= -EEXIST
) {
516 DBG("Unable to create enum error: (%d)", ret
);
521 case atype_enum_nestable
:
523 const struct lttng_enum_desc
*enum_desc
;
526 enum_desc
= type
->u
.enum_nestable
.desc
;
527 ret
= lttng_enum_create(enum_desc
, session
);
528 if (ret
&& ret
!= -EEXIST
) {
529 DBG("Unable to create enum error: (%d)", ret
);
536 const struct lttng_event_field
*tag_field_generic
;
537 const struct lttng_enum_desc
*enum_desc
;
540 tag_field_generic
= lttng_ust_dynamic_type_tag_field();
541 enum_desc
= tag_field_generic
->type
.u
.enum_nestable
.desc
;
542 ret
= lttng_enum_create(enum_desc
, session
);
543 if (ret
&& ret
!= -EEXIST
) {
544 DBG("Unable to create enum error: (%d)", ret
);
550 /* TODO: nested types when they become supported. */
557 int lttng_create_all_event_enums(size_t nr_fields
,
558 const struct lttng_event_field
*event_fields
,
559 struct lttng_session
*session
)
564 /* For each field, ensure enum is part of the session. */
565 for (i
= 0; i
< nr_fields
; i
++) {
566 const struct lttng_type
*type
= &event_fields
[i
].type
;
568 ret
= lttng_create_enum_check(type
, session
);
576 int lttng_create_all_ctx_enums(size_t nr_fields
,
577 const struct lttng_ctx_field
*ctx_fields
,
578 struct lttng_session
*session
)
583 /* For each field, ensure enum is part of the session. */
584 for (i
= 0; i
< nr_fields
; i
++) {
585 const struct lttng_type
*type
= &ctx_fields
[i
].event_field
.type
;
587 ret
= lttng_create_enum_check(type
, session
);
595 * Ensure that a state-dump will be performed for this session at the end
596 * of the current handle_message().
598 int lttng_session_statedump(struct lttng_session
*session
)
600 session
->priv
->statedump_pending
= 1;
601 lttng_ust_sockinfo_session_enabled(session
->priv
->owner
);
605 int lttng_session_enable(struct lttng_session
*session
)
608 struct lttng_channel
*chan
;
611 if (session
->active
) {
616 notify_socket
= lttng_get_notify_socket(session
->priv
->owner
);
617 if (notify_socket
< 0)
618 return notify_socket
;
620 /* Set transient enabler state to "enabled" */
621 session
->priv
->tstate
= 1;
623 /* We need to sync enablers with session before activation. */
624 lttng_session_sync_event_enablers(session
);
627 * Snapshot the number of events per channel to know the type of header
630 cds_list_for_each_entry(chan
, &session
->priv
->chan_head
, node
) {
631 const struct lttng_ctx
*ctx
;
632 const struct lttng_ctx_field
*fields
= NULL
;
633 size_t nr_fields
= 0;
636 /* don't change it if session stop/restart */
637 if (chan
->header_type
)
641 nr_fields
= ctx
->nr_fields
;
642 fields
= ctx
->fields
;
643 ret
= lttng_create_all_ctx_enums(nr_fields
, fields
,
646 DBG("Error (%d) adding enum to session", ret
);
650 ret
= ustcomm_register_channel(notify_socket
,
659 DBG("Error (%d) registering channel to sessiond", ret
);
662 if (chan_id
!= chan
->id
) {
663 DBG("Error: channel registration id (%u) does not match id assigned at creation (%u)",
669 /* Set atomically the state to "active" */
670 CMM_ACCESS_ONCE(session
->active
) = 1;
671 CMM_ACCESS_ONCE(session
->priv
->been_active
) = 1;
673 ret
= lttng_session_statedump(session
);
680 int lttng_session_disable(struct lttng_session
*session
)
684 if (!session
->active
) {
688 /* Set atomically the state to "inactive" */
689 CMM_ACCESS_ONCE(session
->active
) = 0;
691 /* Set transient enabler state to "disabled" */
692 session
->priv
->tstate
= 0;
693 lttng_session_sync_event_enablers(session
);
698 int lttng_channel_enable(struct lttng_channel
*channel
)
702 if (channel
->enabled
) {
706 /* Set transient enabler state to "enabled" */
708 lttng_session_sync_event_enablers(channel
->session
);
709 /* Set atomically the state to "enabled" */
710 CMM_ACCESS_ONCE(channel
->enabled
) = 1;
715 int lttng_channel_disable(struct lttng_channel
*channel
)
719 if (!channel
->enabled
) {
723 /* Set atomically the state to "disabled" */
724 CMM_ACCESS_ONCE(channel
->enabled
) = 0;
725 /* Set transient enabler state to "enabled" */
727 lttng_session_sync_event_enablers(channel
->session
);
733 struct cds_hlist_head
*borrow_hash_table_bucket(
734 struct cds_hlist_head
*hash_table
,
735 unsigned int hash_table_size
,
736 const struct lttng_event_desc
*desc
)
738 const char *event_name
;
742 event_name
= desc
->name
;
743 name_len
= strlen(event_name
);
745 hash
= jhash(event_name
, name_len
, 0);
746 return &hash_table
[hash
& (hash_table_size
- 1)];
750 * Supports event creation while tracing session is active.
753 int lttng_event_create(const struct lttng_event_desc
*desc
,
754 struct lttng_channel
*chan
)
756 struct lttng_event
*event
;
757 struct lttng_ust_event_private
*event_priv
;
758 struct lttng_session
*session
= chan
->session
;
759 struct cds_hlist_head
*head
;
761 int notify_socket
, loglevel
;
764 head
= borrow_hash_table_bucket(chan
->session
->priv
->events_ht
.table
,
765 LTTNG_UST_EVENT_HT_SIZE
, desc
);
767 notify_socket
= lttng_get_notify_socket(session
->priv
->owner
);
768 if (notify_socket
< 0) {
773 ret
= lttng_create_all_event_enums(desc
->nr_fields
, desc
->fields
,
776 DBG("Error (%d) adding enum to session", ret
);
777 goto create_enum_error
;
781 * Check if loglevel match. Refuse to connect event if not.
783 event
= zmalloc(sizeof(struct lttng_event
));
788 event
->struct_size
= sizeof(struct lttng_event
);
789 event_priv
= zmalloc(sizeof(struct lttng_ust_event_private
));
794 event
->priv
= event_priv
;
795 event_priv
->pub
= event
;
798 /* Event will be enabled by enabler sync. */
800 event
->priv
->registered
= 0;
801 CDS_INIT_LIST_HEAD(&event
->filter_bytecode_runtime_head
);
802 CDS_INIT_LIST_HEAD(&event
->priv
->enablers_ref_head
);
803 event
->priv
->desc
= desc
;
806 loglevel
= *(*event
->priv
->desc
->loglevel
);
808 loglevel
= TRACE_DEFAULT
;
809 if (desc
->u
.ext
.model_emf_uri
)
810 uri
= *(desc
->u
.ext
.model_emf_uri
);
814 /* Fetch event ID from sessiond */
815 ret
= ustcomm_register_event(notify_socket
,
827 DBG("Error (%d) registering event to sessiond", ret
);
828 goto sessiond_register_error
;
831 cds_list_add(&event
->priv
->node
, &chan
->session
->priv
->events_head
);
832 cds_hlist_add_head(&event
->priv
->hlist
, head
);
835 sessiond_register_error
:
846 int lttng_event_notifier_create(const struct lttng_event_desc
*desc
,
847 uint64_t token
, uint64_t error_counter_index
,
848 struct lttng_event_notifier_group
*event_notifier_group
)
850 struct lttng_event_notifier
*event_notifier
;
851 struct cds_hlist_head
*head
;
855 * Get the hashtable bucket the created lttng_event_notifier object
856 * should be inserted.
858 head
= borrow_hash_table_bucket(
859 event_notifier_group
->event_notifiers_ht
.table
,
860 LTTNG_UST_EVENT_NOTIFIER_HT_SIZE
, desc
);
862 event_notifier
= zmalloc(sizeof(struct lttng_event_notifier
));
863 if (!event_notifier
) {
868 event_notifier
->group
= event_notifier_group
;
869 event_notifier
->user_token
= token
;
870 event_notifier
->error_counter_index
= error_counter_index
;
872 /* Event notifier will be enabled by enabler sync. */
873 event_notifier
->enabled
= 0;
874 event_notifier
->registered
= 0;
876 CDS_INIT_LIST_HEAD(&event_notifier
->filter_bytecode_runtime_head
);
877 CDS_INIT_LIST_HEAD(&event_notifier
->capture_bytecode_runtime_head
);
878 CDS_INIT_LIST_HEAD(&event_notifier
->enablers_ref_head
);
879 event_notifier
->desc
= desc
;
880 event_notifier
->notification_send
= lttng_event_notifier_notification_send
;
882 cds_list_add(&event_notifier
->node
,
883 &event_notifier_group
->event_notifiers_head
);
884 cds_hlist_add_head(&event_notifier
->hlist
, head
);
893 void _lttng_event_notifier_destroy(struct lttng_event_notifier
*event_notifier
)
895 struct lttng_enabler_ref
*enabler_ref
, *tmp_enabler_ref
;
897 /* Remove from event_notifier list. */
898 cds_list_del(&event_notifier
->node
);
899 /* Remove from event_notifier hash table. */
900 cds_hlist_del(&event_notifier
->hlist
);
902 lttng_free_event_notifier_filter_runtime(event_notifier
);
904 /* Free event_notifier enabler refs */
905 cds_list_for_each_entry_safe(enabler_ref
, tmp_enabler_ref
,
906 &event_notifier
->enablers_ref_head
, node
)
908 free(event_notifier
);
912 int lttng_desc_match_star_glob_enabler(const struct lttng_event_desc
*desc
,
913 struct lttng_enabler
*enabler
)
916 unsigned int has_loglevel
= 0;
918 assert(enabler
->format_type
== LTTNG_ENABLER_FORMAT_STAR_GLOB
);
919 if (!strutils_star_glob_match(enabler
->event_param
.name
, SIZE_MAX
,
920 desc
->name
, SIZE_MAX
))
922 if (desc
->loglevel
) {
923 loglevel
= *(*desc
->loglevel
);
926 if (!lttng_loglevel_match(loglevel
,
928 enabler
->event_param
.loglevel_type
,
929 enabler
->event_param
.loglevel
))
935 int lttng_desc_match_event_enabler(const struct lttng_event_desc
*desc
,
936 struct lttng_enabler
*enabler
)
939 unsigned int has_loglevel
= 0;
941 assert(enabler
->format_type
== LTTNG_ENABLER_FORMAT_EVENT
);
942 if (strcmp(desc
->name
, enabler
->event_param
.name
))
944 if (desc
->loglevel
) {
945 loglevel
= *(*desc
->loglevel
);
948 if (!lttng_loglevel_match(loglevel
,
950 enabler
->event_param
.loglevel_type
,
951 enabler
->event_param
.loglevel
))
957 int lttng_desc_match_enabler(const struct lttng_event_desc
*desc
,
958 struct lttng_enabler
*enabler
)
960 switch (enabler
->format_type
) {
961 case LTTNG_ENABLER_FORMAT_STAR_GLOB
:
963 struct lttng_ust_excluder_node
*excluder
;
965 if (!lttng_desc_match_star_glob_enabler(desc
, enabler
)) {
970 * If the matching event matches with an excluder,
971 * return 'does not match'
973 cds_list_for_each_entry(excluder
, &enabler
->excluder_head
, node
) {
976 for (count
= 0; count
< excluder
->excluder
.count
; count
++) {
980 excluder_name
= (char *) (excluder
->excluder
.names
)
981 + count
* LTTNG_UST_SYM_NAME_LEN
;
982 len
= strnlen(excluder_name
, LTTNG_UST_SYM_NAME_LEN
);
983 if (len
> 0 && strutils_star_glob_match(excluder_name
, len
, desc
->name
, SIZE_MAX
))
989 case LTTNG_ENABLER_FORMAT_EVENT
:
990 return lttng_desc_match_event_enabler(desc
, enabler
);
997 int lttng_event_enabler_match_event(struct lttng_event_enabler
*event_enabler
,
998 struct lttng_event
*event
)
1000 if (lttng_desc_match_enabler(event
->priv
->desc
,
1001 lttng_event_enabler_as_enabler(event_enabler
))
1002 && event
->chan
== event_enabler
->chan
)
1009 int lttng_event_notifier_enabler_match_event_notifier(
1010 struct lttng_event_notifier_enabler
*event_notifier_enabler
,
1011 struct lttng_event_notifier
*event_notifier
)
1013 int desc_matches
= lttng_desc_match_enabler(event_notifier
->desc
,
1014 lttng_event_notifier_enabler_as_enabler(event_notifier_enabler
));
1016 if (desc_matches
&& event_notifier
->group
== event_notifier_enabler
->group
&&
1017 event_notifier
->user_token
== event_notifier_enabler
->user_token
)
1024 struct lttng_enabler_ref
*lttng_enabler_ref(
1025 struct cds_list_head
*enabler_ref_list
,
1026 struct lttng_enabler
*enabler
)
1028 struct lttng_enabler_ref
*enabler_ref
;
1030 cds_list_for_each_entry(enabler_ref
, enabler_ref_list
, node
) {
1031 if (enabler_ref
->ref
== enabler
)
1038 * Create struct lttng_event if it is missing and present in the list of
1039 * tracepoint probes.
1042 void lttng_create_event_if_missing(struct lttng_event_enabler
*event_enabler
)
1044 struct lttng_session
*session
= event_enabler
->chan
->session
;
1045 struct lttng_probe_desc
*probe_desc
;
1046 const struct lttng_event_desc
*desc
;
1047 struct lttng_ust_event_private
*event_priv
;
1049 struct cds_list_head
*probe_list
;
1051 probe_list
= lttng_get_probe_list_head();
1053 * For each probe event, if we find that a probe event matches
1054 * our enabler, create an associated lttng_event if not
1057 cds_list_for_each_entry(probe_desc
, probe_list
, head
) {
1058 for (i
= 0; i
< probe_desc
->nr_events
; i
++) {
1061 struct cds_hlist_head
*head
;
1062 struct cds_hlist_node
*node
;
1064 desc
= probe_desc
->event_desc
[i
];
1065 if (!lttng_desc_match_enabler(desc
,
1066 lttng_event_enabler_as_enabler(event_enabler
)))
1069 head
= borrow_hash_table_bucket(
1070 session
->priv
->events_ht
.table
,
1071 LTTNG_UST_EVENT_HT_SIZE
, desc
);
1073 cds_hlist_for_each_entry(event_priv
, node
, head
, hlist
) {
1074 if (event_priv
->desc
== desc
1075 && event_priv
->pub
->chan
== event_enabler
->chan
) {
1084 * We need to create an event for this
1087 ret
= lttng_event_create(probe_desc
->event_desc
[i
],
1088 event_enabler
->chan
);
1090 DBG("Unable to create event %s, error %d\n",
1091 probe_desc
->event_desc
[i
]->name
, ret
);
1098 void probe_provider_event_for_each(struct lttng_probe_desc
*provider_desc
,
1099 void (*event_func
)(struct lttng_session
*session
,
1100 struct lttng_event
*event
),
1101 void (*event_notifier_func
)(struct lttng_event_notifier
*event_notifier
))
1103 struct cds_hlist_node
*node
, *tmp_node
;
1104 struct cds_list_head
*sessionsp
;
1107 /* Get handle on list of sessions. */
1108 sessionsp
= lttng_get_sessions();
1111 * Iterate over all events in the probe provider descriptions and
1112 * sessions to queue the unregistration of the events.
1114 for (i
= 0; i
< provider_desc
->nr_events
; i
++) {
1115 const struct lttng_event_desc
*event_desc
;
1116 struct lttng_event_notifier_group
*event_notifier_group
;
1117 struct lttng_event_notifier
*event_notifier
;
1118 struct lttng_ust_session_private
*session_priv
;
1119 struct cds_hlist_head
*head
;
1120 struct lttng_ust_event_private
*event_priv
;
1122 event_desc
= provider_desc
->event_desc
[i
];
1125 * Iterate over all session to find the current event
1128 cds_list_for_each_entry(session_priv
, sessionsp
, node
) {
1130 * Get the list of events in the hashtable bucket and
1131 * iterate to find the event matching this descriptor.
1133 head
= borrow_hash_table_bucket(
1134 session_priv
->events_ht
.table
,
1135 LTTNG_UST_EVENT_HT_SIZE
, event_desc
);
1137 cds_hlist_for_each_entry_safe(event_priv
, node
, tmp_node
, head
, hlist
) {
1138 if (event_desc
== event_priv
->desc
) {
1139 event_func(session_priv
->pub
, event_priv
->pub
);
1146 * Iterate over all event_notifier groups to find the current event
1149 cds_list_for_each_entry(event_notifier_group
, &event_notifier_groups
, node
) {
1151 * Get the list of event_notifiers in the hashtable bucket and
1152 * iterate to find the event_notifier matching this
1155 head
= borrow_hash_table_bucket(
1156 event_notifier_group
->event_notifiers_ht
.table
,
1157 LTTNG_UST_EVENT_NOTIFIER_HT_SIZE
, event_desc
);
1159 cds_hlist_for_each_entry_safe(event_notifier
, node
, tmp_node
, head
, hlist
) {
1160 if (event_desc
== event_notifier
->desc
) {
1161 event_notifier_func(event_notifier
);
1170 void _unregister_event(struct lttng_session
*session
,
1171 struct lttng_event
*event
)
1173 _lttng_event_unregister(event
);
1177 void _event_enum_destroy(struct lttng_session
*session
,
1178 struct lttng_event
*event
)
1182 /* Destroy enums of the current event. */
1183 for (i
= 0; i
< event
->priv
->desc
->nr_fields
; i
++) {
1184 const struct lttng_enum_desc
*enum_desc
;
1185 const struct lttng_event_field
*field
;
1186 struct lttng_enum
*curr_enum
;
1188 field
= &(event
->priv
->desc
->fields
[i
]);
1189 switch (field
->type
.atype
) {
1191 enum_desc
= field
->type
.u
.legacy
.basic
.enumeration
.desc
;
1193 case atype_enum_nestable
:
1194 enum_desc
= field
->type
.u
.enum_nestable
.desc
;
1200 curr_enum
= lttng_ust_enum_get_from_desc(session
, enum_desc
);
1202 _lttng_enum_destroy(curr_enum
);
1206 /* Destroy event. */
1207 _lttng_event_destroy(event
);
1211 * Iterate over all the UST sessions to unregister and destroy all probes from
1212 * the probe provider descriptor received as argument. Must me called with the
1215 void lttng_probe_provider_unregister_events(
1216 struct lttng_probe_desc
*provider_desc
)
1219 * Iterate over all events in the probe provider descriptions and sessions
1220 * to queue the unregistration of the events.
1222 probe_provider_event_for_each(provider_desc
, _unregister_event
,
1223 _lttng_event_notifier_unregister
);
1225 /* Wait for grace period. */
1226 lttng_ust_urcu_synchronize_rcu();
1227 /* Prune the unregistration queue. */
1228 __tracepoint_probe_prune_release_queue();
1231 * It is now safe to destroy the events and remove them from the event list
1234 probe_provider_event_for_each(provider_desc
, _event_enum_destroy
,
1235 _lttng_event_notifier_destroy
);
1239 * Create events associated with an event enabler (if not already present),
1240 * and add backward reference from the event to the enabler.
1243 int lttng_event_enabler_ref_events(struct lttng_event_enabler
*event_enabler
)
1245 struct lttng_session
*session
= event_enabler
->chan
->session
;
1246 struct lttng_ust_event_private
*event_priv
;
1248 if (!lttng_event_enabler_as_enabler(event_enabler
)->enabled
)
1251 /* First ensure that probe events are created for this enabler. */
1252 lttng_create_event_if_missing(event_enabler
);
1254 /* For each event matching enabler in session event list. */
1255 cds_list_for_each_entry(event_priv
, &session
->priv
->events_head
, node
) {
1256 struct lttng_enabler_ref
*enabler_ref
;
1258 if (!lttng_event_enabler_match_event(event_enabler
, event_priv
->pub
))
1261 enabler_ref
= lttng_enabler_ref(&event_priv
->enablers_ref_head
,
1262 lttng_event_enabler_as_enabler(event_enabler
));
1265 * If no backward ref, create it.
1266 * Add backward ref from event to enabler.
1268 enabler_ref
= zmalloc(sizeof(*enabler_ref
));
1271 enabler_ref
->ref
= lttng_event_enabler_as_enabler(
1273 cds_list_add(&enabler_ref
->node
,
1274 &event_priv
->enablers_ref_head
);
1278 * Link filter bytecodes if not linked yet.
1280 lttng_enabler_link_bytecode(event_priv
->desc
,
1281 &session
->priv
->ctx
,
1282 &event_priv
->pub
->filter_bytecode_runtime_head
,
1283 <tng_event_enabler_as_enabler(event_enabler
)->filter_bytecode_head
);
1285 /* TODO: merge event context. */
1292 * Called at library load: connect the probe on all enablers matching
1294 * Called with session mutex held.
1296 int lttng_fix_pending_events(void)
1298 struct lttng_ust_session_private
*session_priv
;
1300 cds_list_for_each_entry(session_priv
, &sessions
, node
) {
1301 lttng_session_lazy_sync_event_enablers(session_priv
->pub
);
1306 int lttng_fix_pending_event_notifiers(void)
1308 struct lttng_event_notifier_group
*event_notifier_group
;
1310 cds_list_for_each_entry(event_notifier_group
, &event_notifier_groups
, node
) {
1311 lttng_event_notifier_group_sync_enablers(event_notifier_group
);
1317 * For each session of the owner thread, execute pending statedump.
1318 * Only dump state for the sessions owned by the caller thread, because
1319 * we don't keep ust_lock across the entire iteration.
1321 void lttng_handle_pending_statedump(void *owner
)
1323 struct lttng_ust_session_private
*session_priv
;
1325 /* Execute state dump */
1326 do_lttng_ust_statedump(owner
);
1328 /* Clear pending state dump */
1332 cds_list_for_each_entry(session_priv
, &sessions
, node
) {
1333 if (session_priv
->owner
!= owner
)
1335 if (!session_priv
->statedump_pending
)
1337 session_priv
->statedump_pending
= 0;
1345 * Only used internally at session destruction.
1348 void _lttng_event_destroy(struct lttng_event
*event
)
1350 struct lttng_enabler_ref
*enabler_ref
, *tmp_enabler_ref
;
1352 /* Remove from event list. */
1353 cds_list_del(&event
->priv
->node
);
1354 /* Remove from event hash table. */
1355 cds_hlist_del(&event
->priv
->hlist
);
1357 lttng_destroy_context(event
->ctx
);
1358 lttng_free_event_filter_runtime(event
);
1359 /* Free event enabler refs */
1360 cds_list_for_each_entry_safe(enabler_ref
, tmp_enabler_ref
,
1361 &event
->priv
->enablers_ref_head
, node
)
1368 void _lttng_enum_destroy(struct lttng_enum
*_enum
)
1370 cds_list_del(&_enum
->node
);
1371 cds_hlist_del(&_enum
->hlist
);
1375 void lttng_ust_events_exit(void)
1377 struct lttng_ust_session_private
*session_priv
, *tmpsession_priv
;
1379 cds_list_for_each_entry_safe(session_priv
, tmpsession_priv
, &sessions
, node
)
1380 lttng_session_destroy(session_priv
->pub
);
1384 * Enabler management.
1386 struct lttng_event_enabler
*lttng_event_enabler_create(
1387 enum lttng_enabler_format_type format_type
,
1388 struct lttng_ust_event
*event_param
,
1389 struct lttng_channel
*chan
)
1391 struct lttng_event_enabler
*event_enabler
;
1393 event_enabler
= zmalloc(sizeof(*event_enabler
));
1396 event_enabler
->base
.format_type
= format_type
;
1397 CDS_INIT_LIST_HEAD(&event_enabler
->base
.filter_bytecode_head
);
1398 CDS_INIT_LIST_HEAD(&event_enabler
->base
.excluder_head
);
1399 memcpy(&event_enabler
->base
.event_param
, event_param
,
1400 sizeof(event_enabler
->base
.event_param
));
1401 event_enabler
->chan
= chan
;
1403 event_enabler
->base
.enabled
= 0;
1404 cds_list_add(&event_enabler
->node
, &event_enabler
->chan
->session
->priv
->enablers_head
);
1405 lttng_session_lazy_sync_event_enablers(event_enabler
->chan
->session
);
1407 return event_enabler
;
1410 struct lttng_event_notifier_enabler
*lttng_event_notifier_enabler_create(
1411 struct lttng_event_notifier_group
*event_notifier_group
,
1412 enum lttng_enabler_format_type format_type
,
1413 struct lttng_ust_event_notifier
*event_notifier_param
)
1415 struct lttng_event_notifier_enabler
*event_notifier_enabler
;
1417 event_notifier_enabler
= zmalloc(sizeof(*event_notifier_enabler
));
1418 if (!event_notifier_enabler
)
1420 event_notifier_enabler
->base
.format_type
= format_type
;
1421 CDS_INIT_LIST_HEAD(&event_notifier_enabler
->base
.filter_bytecode_head
);
1422 CDS_INIT_LIST_HEAD(&event_notifier_enabler
->capture_bytecode_head
);
1423 CDS_INIT_LIST_HEAD(&event_notifier_enabler
->base
.excluder_head
);
1425 event_notifier_enabler
->user_token
= event_notifier_param
->event
.token
;
1426 event_notifier_enabler
->error_counter_index
= event_notifier_param
->error_counter_index
;
1427 event_notifier_enabler
->num_captures
= 0;
1429 memcpy(&event_notifier_enabler
->base
.event_param
.name
,
1430 event_notifier_param
->event
.name
,
1431 sizeof(event_notifier_enabler
->base
.event_param
.name
));
1432 event_notifier_enabler
->base
.event_param
.instrumentation
=
1433 event_notifier_param
->event
.instrumentation
;
1434 event_notifier_enabler
->base
.event_param
.loglevel
=
1435 event_notifier_param
->event
.loglevel
;
1436 event_notifier_enabler
->base
.event_param
.loglevel_type
=
1437 event_notifier_param
->event
.loglevel_type
;
1439 event_notifier_enabler
->base
.enabled
= 0;
1440 event_notifier_enabler
->group
= event_notifier_group
;
1442 cds_list_add(&event_notifier_enabler
->node
,
1443 &event_notifier_group
->enablers_head
);
1445 lttng_event_notifier_group_sync_enablers(event_notifier_group
);
1447 return event_notifier_enabler
;
1450 int lttng_event_enabler_enable(struct lttng_event_enabler
*event_enabler
)
1452 lttng_event_enabler_as_enabler(event_enabler
)->enabled
= 1;
1453 lttng_session_lazy_sync_event_enablers(event_enabler
->chan
->session
);
1458 int lttng_event_enabler_disable(struct lttng_event_enabler
*event_enabler
)
1460 lttng_event_enabler_as_enabler(event_enabler
)->enabled
= 0;
1461 lttng_session_lazy_sync_event_enablers(event_enabler
->chan
->session
);
1467 void _lttng_enabler_attach_filter_bytecode(struct lttng_enabler
*enabler
,
1468 struct lttng_ust_bytecode_node
**bytecode
)
1470 (*bytecode
)->enabler
= enabler
;
1471 cds_list_add_tail(&(*bytecode
)->node
, &enabler
->filter_bytecode_head
);
1472 /* Take ownership of bytecode */
1476 int lttng_event_enabler_attach_filter_bytecode(struct lttng_event_enabler
*event_enabler
,
1477 struct lttng_ust_bytecode_node
**bytecode
)
1479 _lttng_enabler_attach_filter_bytecode(
1480 lttng_event_enabler_as_enabler(event_enabler
), bytecode
);
1482 lttng_session_lazy_sync_event_enablers(event_enabler
->chan
->session
);
1487 void _lttng_enabler_attach_exclusion(struct lttng_enabler
*enabler
,
1488 struct lttng_ust_excluder_node
**excluder
)
1490 (*excluder
)->enabler
= enabler
;
1491 cds_list_add_tail(&(*excluder
)->node
, &enabler
->excluder_head
);
1492 /* Take ownership of excluder */
1496 int lttng_event_enabler_attach_exclusion(struct lttng_event_enabler
*event_enabler
,
1497 struct lttng_ust_excluder_node
**excluder
)
1499 _lttng_enabler_attach_exclusion(
1500 lttng_event_enabler_as_enabler(event_enabler
), excluder
);
1502 lttng_session_lazy_sync_event_enablers(event_enabler
->chan
->session
);
1506 int lttng_event_notifier_enabler_enable(
1507 struct lttng_event_notifier_enabler
*event_notifier_enabler
)
1509 lttng_event_notifier_enabler_as_enabler(event_notifier_enabler
)->enabled
= 1;
1510 lttng_event_notifier_group_sync_enablers(event_notifier_enabler
->group
);
1515 int lttng_event_notifier_enabler_disable(
1516 struct lttng_event_notifier_enabler
*event_notifier_enabler
)
1518 lttng_event_notifier_enabler_as_enabler(event_notifier_enabler
)->enabled
= 0;
1519 lttng_event_notifier_group_sync_enablers(event_notifier_enabler
->group
);
1524 int lttng_event_notifier_enabler_attach_filter_bytecode(
1525 struct lttng_event_notifier_enabler
*event_notifier_enabler
,
1526 struct lttng_ust_bytecode_node
**bytecode
)
1528 _lttng_enabler_attach_filter_bytecode(
1529 lttng_event_notifier_enabler_as_enabler(event_notifier_enabler
),
1532 lttng_event_notifier_group_sync_enablers(event_notifier_enabler
->group
);
1536 int lttng_event_notifier_enabler_attach_capture_bytecode(
1537 struct lttng_event_notifier_enabler
*event_notifier_enabler
,
1538 struct lttng_ust_bytecode_node
**bytecode
)
1540 (*bytecode
)->enabler
= lttng_event_notifier_enabler_as_enabler(
1541 event_notifier_enabler
);
1542 cds_list_add_tail(&(*bytecode
)->node
,
1543 &event_notifier_enabler
->capture_bytecode_head
);
1544 /* Take ownership of bytecode */
1546 event_notifier_enabler
->num_captures
++;
1548 lttng_event_notifier_group_sync_enablers(event_notifier_enabler
->group
);
1552 int lttng_event_notifier_enabler_attach_exclusion(
1553 struct lttng_event_notifier_enabler
*event_notifier_enabler
,
1554 struct lttng_ust_excluder_node
**excluder
)
1556 _lttng_enabler_attach_exclusion(
1557 lttng_event_notifier_enabler_as_enabler(event_notifier_enabler
),
1560 lttng_event_notifier_group_sync_enablers(event_notifier_enabler
->group
);
1564 int lttng_attach_context(struct lttng_ust_context
*context_param
,
1565 union ust_args
*uargs
,
1566 struct lttng_ctx
**ctx
, struct lttng_session
*session
)
1569 * We cannot attach a context after trace has been started for a
1570 * session because the metadata does not allow expressing this
1571 * information outside of the original channel scope.
1573 if (session
->priv
->been_active
)
1576 switch (context_param
->ctx
) {
1577 case LTTNG_UST_CONTEXT_PTHREAD_ID
:
1578 return lttng_add_pthread_id_to_ctx(ctx
);
1579 case LTTNG_UST_CONTEXT_PERF_THREAD_COUNTER
:
1581 struct lttng_ust_perf_counter_ctx
*perf_ctx_param
;
1583 perf_ctx_param
= &context_param
->u
.perf_counter
;
1584 return lttng_add_perf_counter_to_ctx(
1585 perf_ctx_param
->type
,
1586 perf_ctx_param
->config
,
1587 perf_ctx_param
->name
,
1590 case LTTNG_UST_CONTEXT_VTID
:
1591 return lttng_add_vtid_to_ctx(ctx
);
1592 case LTTNG_UST_CONTEXT_VPID
:
1593 return lttng_add_vpid_to_ctx(ctx
);
1594 case LTTNG_UST_CONTEXT_PROCNAME
:
1595 return lttng_add_procname_to_ctx(ctx
);
1596 case LTTNG_UST_CONTEXT_IP
:
1597 return lttng_add_ip_to_ctx(ctx
);
1598 case LTTNG_UST_CONTEXT_CPU_ID
:
1599 return lttng_add_cpu_id_to_ctx(ctx
);
1600 case LTTNG_UST_CONTEXT_APP_CONTEXT
:
1601 return lttng_ust_add_app_context_to_ctx_rcu(uargs
->app_context
.ctxname
,
1603 case LTTNG_UST_CONTEXT_CGROUP_NS
:
1604 return lttng_add_cgroup_ns_to_ctx(ctx
);
1605 case LTTNG_UST_CONTEXT_IPC_NS
:
1606 return lttng_add_ipc_ns_to_ctx(ctx
);
1607 case LTTNG_UST_CONTEXT_MNT_NS
:
1608 return lttng_add_mnt_ns_to_ctx(ctx
);
1609 case LTTNG_UST_CONTEXT_NET_NS
:
1610 return lttng_add_net_ns_to_ctx(ctx
);
1611 case LTTNG_UST_CONTEXT_PID_NS
:
1612 return lttng_add_pid_ns_to_ctx(ctx
);
1613 case LTTNG_UST_CONTEXT_TIME_NS
:
1614 return lttng_add_time_ns_to_ctx(ctx
);
1615 case LTTNG_UST_CONTEXT_USER_NS
:
1616 return lttng_add_user_ns_to_ctx(ctx
);
1617 case LTTNG_UST_CONTEXT_UTS_NS
:
1618 return lttng_add_uts_ns_to_ctx(ctx
);
1619 case LTTNG_UST_CONTEXT_VUID
:
1620 return lttng_add_vuid_to_ctx(ctx
);
1621 case LTTNG_UST_CONTEXT_VEUID
:
1622 return lttng_add_veuid_to_ctx(ctx
);
1623 case LTTNG_UST_CONTEXT_VSUID
:
1624 return lttng_add_vsuid_to_ctx(ctx
);
1625 case LTTNG_UST_CONTEXT_VGID
:
1626 return lttng_add_vgid_to_ctx(ctx
);
1627 case LTTNG_UST_CONTEXT_VEGID
:
1628 return lttng_add_vegid_to_ctx(ctx
);
1629 case LTTNG_UST_CONTEXT_VSGID
:
1630 return lttng_add_vsgid_to_ctx(ctx
);
1636 int lttng_event_enabler_attach_context(struct lttng_event_enabler
*enabler
,
1637 struct lttng_ust_context
*context_param
)
1642 void lttng_event_enabler_destroy(struct lttng_event_enabler
*event_enabler
)
1644 if (!event_enabler
) {
1647 cds_list_del(&event_enabler
->node
);
1649 lttng_enabler_destroy(lttng_event_enabler_as_enabler(event_enabler
));
1651 lttng_destroy_context(event_enabler
->ctx
);
1652 free(event_enabler
);
1656 * lttng_session_sync_event_enablers should be called just before starting a
1660 void lttng_session_sync_event_enablers(struct lttng_session
*session
)
1662 struct lttng_event_enabler
*event_enabler
;
1663 struct lttng_ust_event_private
*event_priv
;
1665 cds_list_for_each_entry(event_enabler
, &session
->priv
->enablers_head
, node
)
1666 lttng_event_enabler_ref_events(event_enabler
);
1668 * For each event, if at least one of its enablers is enabled,
1669 * and its channel and session transient states are enabled, we
1670 * enable the event, else we disable it.
1672 cds_list_for_each_entry(event_priv
, &session
->priv
->events_head
, node
) {
1673 struct lttng_enabler_ref
*enabler_ref
;
1674 struct lttng_bytecode_runtime
*runtime
;
1675 int enabled
= 0, has_enablers_without_bytecode
= 0;
1678 cds_list_for_each_entry(enabler_ref
,
1679 &event_priv
->enablers_ref_head
, node
) {
1680 if (enabler_ref
->ref
->enabled
) {
1686 * Enabled state is based on union of enablers, with
1687 * intesection of session and channel transient enable
1690 enabled
= enabled
&& session
->priv
->tstate
&& event_priv
->pub
->chan
->tstate
;
1692 CMM_STORE_SHARED(event_priv
->pub
->enabled
, enabled
);
1694 * Sync tracepoint registration with event enabled
1698 if (!event_priv
->registered
)
1699 register_event(event_priv
->pub
);
1701 if (event_priv
->registered
)
1702 unregister_event(event_priv
->pub
);
1705 /* Check if has enablers without bytecode enabled */
1706 cds_list_for_each_entry(enabler_ref
,
1707 &event_priv
->enablers_ref_head
, node
) {
1708 if (enabler_ref
->ref
->enabled
1709 && cds_list_empty(&enabler_ref
->ref
->filter_bytecode_head
)) {
1710 has_enablers_without_bytecode
= 1;
1714 event_priv
->pub
->has_enablers_without_bytecode
=
1715 has_enablers_without_bytecode
;
1717 /* Enable filters */
1718 cds_list_for_each_entry(runtime
,
1719 &event_priv
->pub
->filter_bytecode_runtime_head
, node
) {
1720 lttng_bytecode_filter_sync_state(runtime
);
1723 __tracepoint_probe_prune_release_queue();
1726 /* Support for event notifier is introduced by probe provider major version 2. */
1728 bool lttng_ust_probe_supports_event_notifier(struct lttng_probe_desc
*probe_desc
)
1730 return probe_desc
->major
>= 2;
1734 void lttng_create_event_notifier_if_missing(
1735 struct lttng_event_notifier_enabler
*event_notifier_enabler
)
1737 struct lttng_event_notifier_group
*event_notifier_group
= event_notifier_enabler
->group
;
1738 struct lttng_probe_desc
*probe_desc
;
1739 struct cds_list_head
*probe_list
;
1742 probe_list
= lttng_get_probe_list_head();
1744 cds_list_for_each_entry(probe_desc
, probe_list
, head
) {
1745 for (i
= 0; i
< probe_desc
->nr_events
; i
++) {
1748 const struct lttng_event_desc
*desc
;
1749 struct lttng_event_notifier
*event_notifier
;
1750 struct cds_hlist_head
*head
;
1751 struct cds_hlist_node
*node
;
1753 desc
= probe_desc
->event_desc
[i
];
1755 if (!lttng_desc_match_enabler(desc
,
1756 lttng_event_notifier_enabler_as_enabler(event_notifier_enabler
)))
1760 * Given the current event_notifier group, get the bucket that
1761 * the target event_notifier would be if it was already
1764 head
= borrow_hash_table_bucket(
1765 event_notifier_group
->event_notifiers_ht
.table
,
1766 LTTNG_UST_EVENT_NOTIFIER_HT_SIZE
, desc
);
1768 cds_hlist_for_each_entry(event_notifier
, node
, head
, hlist
) {
1770 * Check if event_notifier already exists by checking
1771 * if the event_notifier and enabler share the same
1772 * description and id.
1774 if (event_notifier
->desc
== desc
&&
1775 event_notifier
->user_token
== event_notifier_enabler
->user_token
) {
1784 /* Check that the probe supports event notifiers, else report the error. */
1785 if (!lttng_ust_probe_supports_event_notifier(probe_desc
)) {
1786 ERR("Probe \"%s\" contains event \"%s\" which matches an enabled event notifier, "
1787 "but its version (%u.%u) is too old and does not implement event notifiers. "
1788 "It needs to be recompiled against a newer version of LTTng-UST, otherwise "
1789 "this event will not generate any notification.",
1790 probe_desc
->provider
,
1797 * We need to create a event_notifier for this event probe.
1799 ret
= lttng_event_notifier_create(desc
,
1800 event_notifier_enabler
->user_token
,
1801 event_notifier_enabler
->error_counter_index
,
1802 event_notifier_group
);
1804 DBG("Unable to create event_notifier %s, error %d\n",
1805 probe_desc
->event_desc
[i
]->name
, ret
);
1812 * Create event_notifiers associated with a event_notifier enabler (if not already present).
1815 int lttng_event_notifier_enabler_ref_event_notifiers(
1816 struct lttng_event_notifier_enabler
*event_notifier_enabler
)
1818 struct lttng_event_notifier_group
*event_notifier_group
= event_notifier_enabler
->group
;
1819 struct lttng_event_notifier
*event_notifier
;
1822 * Only try to create event_notifiers for enablers that are enabled, the user
1823 * might still be attaching filter or exclusion to the
1824 * event_notifier_enabler.
1826 if (!lttng_event_notifier_enabler_as_enabler(event_notifier_enabler
)->enabled
)
1829 /* First, ensure that probe event_notifiers are created for this enabler. */
1830 lttng_create_event_notifier_if_missing(event_notifier_enabler
);
1832 /* Link the created event_notifier with its associated enabler. */
1833 cds_list_for_each_entry(event_notifier
, &event_notifier_group
->event_notifiers_head
, node
) {
1834 struct lttng_enabler_ref
*enabler_ref
;
1836 if (!lttng_event_notifier_enabler_match_event_notifier(event_notifier_enabler
, event_notifier
))
1839 enabler_ref
= lttng_enabler_ref(&event_notifier
->enablers_ref_head
,
1840 lttng_event_notifier_enabler_as_enabler(event_notifier_enabler
));
1843 * If no backward ref, create it.
1844 * Add backward ref from event_notifier to enabler.
1846 enabler_ref
= zmalloc(sizeof(*enabler_ref
));
1850 enabler_ref
->ref
= lttng_event_notifier_enabler_as_enabler(
1851 event_notifier_enabler
);
1852 cds_list_add(&enabler_ref
->node
,
1853 &event_notifier
->enablers_ref_head
);
1857 * Link filter bytecodes if not linked yet.
1859 lttng_enabler_link_bytecode(event_notifier
->desc
,
1860 &event_notifier_group
->ctx
,
1861 &event_notifier
->filter_bytecode_runtime_head
,
1862 <tng_event_notifier_enabler_as_enabler(event_notifier_enabler
)->filter_bytecode_head
);
1865 * Link capture bytecodes if not linked yet.
1867 lttng_enabler_link_bytecode(event_notifier
->desc
,
1868 &event_notifier_group
->ctx
, &event_notifier
->capture_bytecode_runtime_head
,
1869 &event_notifier_enabler
->capture_bytecode_head
);
1871 event_notifier
->num_captures
= event_notifier_enabler
->num_captures
;
1878 void lttng_event_notifier_group_sync_enablers(struct lttng_event_notifier_group
*event_notifier_group
)
1880 struct lttng_event_notifier_enabler
*event_notifier_enabler
;
1881 struct lttng_event_notifier
*event_notifier
;
1883 cds_list_for_each_entry(event_notifier_enabler
, &event_notifier_group
->enablers_head
, node
)
1884 lttng_event_notifier_enabler_ref_event_notifiers(event_notifier_enabler
);
1887 * For each event_notifier, if at least one of its enablers is enabled,
1888 * we enable the event_notifier, else we disable it.
1890 cds_list_for_each_entry(event_notifier
, &event_notifier_group
->event_notifiers_head
, node
) {
1891 struct lttng_enabler_ref
*enabler_ref
;
1892 struct lttng_bytecode_runtime
*runtime
;
1893 int enabled
= 0, has_enablers_without_bytecode
= 0;
1895 /* Enable event_notifiers */
1896 cds_list_for_each_entry(enabler_ref
,
1897 &event_notifier
->enablers_ref_head
, node
) {
1898 if (enabler_ref
->ref
->enabled
) {
1904 CMM_STORE_SHARED(event_notifier
->enabled
, enabled
);
1906 * Sync tracepoint registration with event_notifier enabled
1910 if (!event_notifier
->registered
)
1911 register_event_notifier(event_notifier
);
1913 if (event_notifier
->registered
)
1914 unregister_event_notifier(event_notifier
);
1917 /* Check if has enablers without bytecode enabled */
1918 cds_list_for_each_entry(enabler_ref
,
1919 &event_notifier
->enablers_ref_head
, node
) {
1920 if (enabler_ref
->ref
->enabled
1921 && cds_list_empty(&enabler_ref
->ref
->filter_bytecode_head
)) {
1922 has_enablers_without_bytecode
= 1;
1926 event_notifier
->has_enablers_without_bytecode
=
1927 has_enablers_without_bytecode
;
1929 /* Enable filters */
1930 cds_list_for_each_entry(runtime
,
1931 &event_notifier
->filter_bytecode_runtime_head
, node
) {
1932 lttng_bytecode_filter_sync_state(runtime
);
1935 /* Enable captures. */
1936 cds_list_for_each_entry(runtime
,
1937 &event_notifier
->capture_bytecode_runtime_head
, node
) {
1938 lttng_bytecode_capture_sync_state(runtime
);
1941 __tracepoint_probe_prune_release_queue();
1945 * Apply enablers to session events, adding events to session if need
1946 * be. It is required after each modification applied to an active
1947 * session, and right before session "start".
1948 * "lazy" sync means we only sync if required.
1951 void lttng_session_lazy_sync_event_enablers(struct lttng_session
*session
)
1953 /* We can skip if session is not active */
1954 if (!session
->active
)
1956 lttng_session_sync_event_enablers(session
);
1960 * Update all sessions with the given app context.
1961 * Called with ust lock held.
1962 * This is invoked when an application context gets loaded/unloaded. It
1963 * ensures the context callbacks are in sync with the application
1964 * context (either app context callbacks, or dummy callbacks).
1966 void lttng_ust_context_set_session_provider(const char *name
,
1967 size_t (*get_size
)(struct lttng_ctx_field
*field
, size_t offset
),
1968 void (*record
)(struct lttng_ctx_field
*field
,
1969 struct lttng_ust_lib_ring_buffer_ctx
*ctx
,
1970 struct lttng_channel
*chan
),
1971 void (*get_value
)(struct lttng_ctx_field
*field
,
1972 struct lttng_ctx_value
*value
))
1974 struct lttng_ust_session_private
*session_priv
;
1976 cds_list_for_each_entry(session_priv
, &sessions
, node
) {
1977 struct lttng_channel
*chan
;
1978 struct lttng_ust_event_private
*event_priv
;
1981 ret
= lttng_ust_context_set_provider_rcu(&session_priv
->ctx
,
1982 name
, get_size
, record
, get_value
);
1985 cds_list_for_each_entry(chan
, &session_priv
->chan_head
, node
) {
1986 ret
= lttng_ust_context_set_provider_rcu(&chan
->ctx
,
1987 name
, get_size
, record
, get_value
);
1991 cds_list_for_each_entry(event_priv
, &session_priv
->events_head
, node
) {
1992 ret
= lttng_ust_context_set_provider_rcu(&event_priv
->pub
->ctx
,
1993 name
, get_size
, record
, get_value
);
2001 * Update all event_notifier groups with the given app context.
2002 * Called with ust lock held.
2003 * This is invoked when an application context gets loaded/unloaded. It
2004 * ensures the context callbacks are in sync with the application
2005 * context (either app context callbacks, or dummy callbacks).
2007 void lttng_ust_context_set_event_notifier_group_provider(const char *name
,
2008 size_t (*get_size
)(struct lttng_ctx_field
*field
, size_t offset
),
2009 void (*record
)(struct lttng_ctx_field
*field
,
2010 struct lttng_ust_lib_ring_buffer_ctx
*ctx
,
2011 struct lttng_channel
*chan
),
2012 void (*get_value
)(struct lttng_ctx_field
*field
,
2013 struct lttng_ctx_value
*value
))
2015 struct lttng_event_notifier_group
*event_notifier_group
;
2017 cds_list_for_each_entry(event_notifier_group
, &event_notifier_groups
, node
) {
2020 ret
= lttng_ust_context_set_provider_rcu(
2021 &event_notifier_group
->ctx
,
2022 name
, get_size
, record
, get_value
);