2 * Copyright (C) 2011 - David Goulet <david.goulet@polymtl.ca>
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License, version 2 only,
6 * as published by the Free Software Foundation.
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
13 * You should have received a copy of the GNU General Public License along
14 * with this program; if not, write to the Free Software Foundation, Inc.,
15 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21 #include <urcu/list.h>
24 #include <lttng/lttng.h>
25 #include <common/error.h>
26 #include <common/sessiond-comm/sessiond-comm.h>
31 #include "lttng-sessiond.h"
34 #include "trace-kernel.h"
35 #include "trace-ust.h"
39 * Add unique UST event based on the event name, filter bytecode and loglevel.
41 static void add_unique_ust_event(struct lttng_ht
*ht
,
42 struct ltt_ust_event
*event
)
44 struct cds_lfht_node
*node_ptr
;
45 struct ltt_ust_ht_key key
;
51 key
.name
= event
->attr
.name
;
52 key
.filter
= (struct lttng_filter_bytecode
*) event
->filter
;
53 key
.loglevel
= event
->attr
.loglevel
;
54 key
.exclusion
= event
->exclusion
;
56 node_ptr
= cds_lfht_add_unique(ht
->ht
,
57 ht
->hash_fct(event
->node
.key
, lttng_ht_seed
),
58 trace_ust_ht_match_event
, &key
, &event
->node
.node
);
59 assert(node_ptr
== &event
->node
.node
);
63 * Disable kernel tracepoint event for a channel from the kernel session.
65 int event_kernel_disable_event(struct ltt_kernel_channel
*kchan
,
69 struct ltt_kernel_event
*kevent
;
73 kevent
= trace_kernel_get_event_by_name(event_name
, kchan
,
76 ret
= LTTNG_ERR_NO_EVENT
;
80 ret
= kernel_disable_event(kevent
);
82 ret
= LTTNG_ERR_KERN_DISABLE_FAIL
;
86 DBG("Kernel event %s disable for channel %s.",
87 kevent
->event
->name
, kchan
->channel
->name
);
96 * Disable kernel tracepoint events for a channel from the kernel session.
98 int event_kernel_disable_event_type(struct ltt_kernel_channel
*kchan
,
99 enum lttng_event_type type
)
102 struct ltt_kernel_event
*kevent
;
106 /* For each event in the kernel session */
107 cds_list_for_each_entry(kevent
, &kchan
->events_list
.head
, list
) {
108 if (type
!= LTTNG_EVENT_ALL
&& kevent
->type
!= type
)
110 ret
= kernel_disable_event(kevent
);
112 /* We continue disabling the rest */
121 * Disable all kernel event for a channel from the kernel session.
123 int event_kernel_disable_event_all(struct ltt_kernel_channel
*kchan
)
125 return event_kernel_disable_event_type(kchan
, LTTNG_EVENT_ALL
);
129 * Enable kernel tracepoint event for a channel from the kernel session.
130 * We own filter_expression and filter.
132 int event_kernel_enable_event(struct ltt_kernel_channel
*kchan
,
133 struct lttng_event
*event
, char *filter_expression
,
134 struct lttng_filter_bytecode
*filter
)
137 struct ltt_kernel_event
*kevent
;
142 kevent
= trace_kernel_find_event(event
->name
, kchan
,
143 event
->type
, filter
);
144 if (kevent
== NULL
) {
145 ret
= kernel_create_event(event
, kchan
,
146 filter_expression
, filter
);
147 /* We have passed ownership */
148 filter_expression
= NULL
;
153 ret
= LTTNG_ERR_KERN_EVENT_EXIST
;
156 ret
= LTTNG_ERR_KERN_EVENT_ENOSYS
;
159 ret
= LTTNG_ERR_KERN_ENABLE_FAIL
;
164 } else if (kevent
->enabled
== 0) {
165 ret
= kernel_enable_event(kevent
);
167 ret
= LTTNG_ERR_KERN_ENABLE_FAIL
;
171 /* At this point, the event is considered enabled */
172 ret
= LTTNG_ERR_KERN_EVENT_EXIST
;
178 free(filter_expression
);
184 * ============================
185 * UST : The Ultimate Frontier!
186 * ============================
190 * Enable UST tracepoint event for a channel from a UST session.
191 * We own filter_expression, filter, and exclusion.
193 int event_ust_enable_tracepoint(struct ltt_ust_session
*usess
,
194 struct ltt_ust_channel
*uchan
, struct lttng_event
*event
,
195 char *filter_expression
,
196 struct lttng_filter_bytecode
*filter
,
197 struct lttng_event_exclusion
*exclusion
,
200 int ret
= LTTNG_OK
, to_create
= 0;
201 struct ltt_ust_event
*uevent
;
209 uevent
= trace_ust_find_event(uchan
->events
, event
->name
, filter
,
210 event
->loglevel
, exclusion
);
212 uevent
= trace_ust_create_event(event
, filter_expression
,
213 filter
, exclusion
, internal_event
);
214 /* We have passed ownership */
215 filter_expression
= NULL
;
218 if (uevent
== NULL
) {
219 ret
= LTTNG_ERR_UST_ENABLE_FAIL
;
223 /* Valid to set it after the goto error since uevent is still NULL */
227 if (uevent
->enabled
) {
228 /* It's already enabled so everything is OK */
229 ret
= LTTNG_ERR_UST_EVENT_ENABLED
;
236 /* Create event on all UST registered apps for session */
237 ret
= ust_app_create_event_glb(usess
, uchan
, uevent
);
239 /* Enable event on all UST registered apps for session */
240 ret
= ust_app_enable_event_glb(usess
, uchan
, uevent
);
244 if (ret
== -LTTNG_UST_ERR_EXIST
) {
245 ret
= LTTNG_ERR_UST_EVENT_EXIST
;
248 ret
= LTTNG_ERR_UST_ENABLE_FAIL
;
254 /* Add ltt ust event to channel */
255 add_unique_ust_event(uchan
->events
, uevent
);
258 DBG("Event UST %s %s in channel %s", uevent
->attr
.name
,
259 to_create
? "created" : "enabled", uchan
->name
);
265 free(filter_expression
);
272 * Only destroy event on creation time (not enabling time) because if the
273 * event is found in the channel (to_create == 0), it means that at some
274 * point the enable_event worked and it's thus valid to keep it alive.
275 * Destroying it also implies that we also destroy it's shadow copy to sync
279 /* In this code path, the uevent was not added to the hash table */
280 trace_ust_destroy_event(uevent
);
283 free(filter_expression
);
290 * Disable UST tracepoint of a channel from a UST session.
292 int event_ust_disable_tracepoint(struct ltt_ust_session
*usess
,
293 struct ltt_ust_channel
*uchan
, char *event_name
)
296 struct ltt_ust_event
*uevent
;
297 struct lttng_ht_node_str
*node
;
298 struct lttng_ht_iter iter
;
310 * We use a custom lookup since we need the iterator for the next_duplicate
311 * call in the do while loop below.
313 cds_lfht_lookup(ht
->ht
, ht
->hash_fct((void *) event_name
, lttng_ht_seed
),
314 trace_ust_ht_match_event_by_name
, event_name
, &iter
.iter
);
315 node
= lttng_ht_iter_get_node_str(&iter
);
317 DBG2("Trace UST event NOT found by name %s", event_name
);
318 ret
= LTTNG_ERR_UST_EVENT_NOT_FOUND
;
323 uevent
= caa_container_of(node
, struct ltt_ust_event
, node
);
326 if (uevent
->enabled
== 0) {
327 /* It's already disabled so everything is OK */
331 ret
= ust_app_disable_event_glb(usess
, uchan
, uevent
);
332 if (ret
< 0 && ret
!= -LTTNG_UST_ERR_EXIST
) {
333 ret
= LTTNG_ERR_UST_DISABLE_FAIL
;
338 DBG2("Event UST %s disabled in channel %s", uevent
->attr
.name
,
342 /* Get next duplicate event by name. */
343 cds_lfht_next_duplicate(ht
->ht
, trace_ust_ht_match_event_by_name
,
344 event_name
, &iter
.iter
);
345 node
= lttng_ht_iter_get_node_str(&iter
);
356 * Enable all agent event for a given UST session.
358 * Return LTTNG_OK on success or else a LTTNG_ERR* code.
360 int event_agent_enable_all(struct ltt_ust_session
*usess
,
361 struct agent
*agt
, struct lttng_event
*event
,
362 struct lttng_filter_bytecode
*filter
,char *filter_expression
)
365 struct agent_event
*aevent
;
366 struct lttng_ht_iter iter
;
370 DBG("Event agent enabling ALL events for session %" PRIu64
, usess
->id
);
372 /* Enable event on agent application through TCP socket. */
373 ret
= event_agent_enable(usess
, agt
, event
, filter
, filter_expression
);
374 if (ret
!= LTTNG_OK
) {
378 /* Flag every event that they are now enabled. */
380 cds_lfht_for_each_entry(agt
->events
->ht
, &iter
.iter
, aevent
,
393 * Enable a single agent event for a given UST session.
395 * Return LTTNG_OK on success or else a LTTNG_ERR* code.
397 int event_agent_enable(struct ltt_ust_session
*usess
,
398 struct agent
*agt
, struct lttng_event
*event
,
399 struct lttng_filter_bytecode
*filter
,
400 char *filter_expression
)
402 int ret
, created
= 0;
403 struct agent_event
*aevent
;
409 DBG("Event agent enabling %s for session %" PRIu64
" with loglevel type %d "
410 ", loglevel %d and filter \"%s\"", event
->name
,
411 usess
->id
, event
->loglevel_type
, event
->loglevel
,
412 filter_expression
? filter_expression
: "NULL");
414 aevent
= agent_find_event(event
->name
, event
->loglevel
, agt
);
416 aevent
= agent_create_event(event
->name
, event
->loglevel
,
417 event
->loglevel_type
, filter
,
420 ret
= LTTNG_ERR_NOMEM
;
426 /* Already enabled? */
427 if (aevent
->enabled
) {
431 ret
= agent_enable_event(aevent
, agt
->domain
);
432 if (ret
!= LTTNG_OK
) {
436 /* If the event was created prior to the enable, add it to the domain. */
438 agent_add_event(aevent
, agt
);
446 agent_destroy_event(aevent
);
452 * Return the default event name associated with the provided UST domain. Return
455 const char *event_get_default_agent_ust_name(enum lttng_domain_type domain
)
457 const char *default_event_name
= NULL
;
460 case LTTNG_DOMAIN_LOG4J
:
461 default_event_name
= DEFAULT_LOG4J_EVENT_NAME
;
463 case LTTNG_DOMAIN_JUL
:
464 default_event_name
= DEFAULT_JUL_EVENT_NAME
;
466 case LTTNG_DOMAIN_PYTHON
:
467 default_event_name
= DEFAULT_PYTHON_EVENT_NAME
;
473 return default_event_name
;
477 * Disable a single agent event for a given UST session.
479 * Return LTTNG_OK on success or else a LTTNG_ERR* code.
481 int event_agent_disable(struct ltt_ust_session
*usess
, struct agent
*agt
,
485 struct agent_event
*aevent
;
486 struct ltt_ust_event
*uevent
= NULL
;
487 struct ltt_ust_channel
*uchan
= NULL
;
488 const char *ust_event_name
, *ust_channel_name
;
494 DBG("Event agent disabling %s for session %" PRIu64
, event_name
, usess
->id
);
496 aevent
= agent_find_event_by_name(event_name
, agt
);
498 ret
= LTTNG_ERR_UST_EVENT_NOT_FOUND
;
502 /* Already disabled? */
503 if (!aevent
->enabled
) {
507 if (agt
->domain
== LTTNG_DOMAIN_JUL
) {
508 ust_channel_name
= DEFAULT_JUL_CHANNEL_NAME
;
509 } else if (agt
->domain
== LTTNG_DOMAIN_LOG4J
) {
510 ust_channel_name
= DEFAULT_LOG4J_CHANNEL_NAME
;
511 } else if (agt
->domain
== LTTNG_DOMAIN_PYTHON
) {
512 ust_channel_name
= DEFAULT_PYTHON_CHANNEL_NAME
;
514 ret
= LTTNG_ERR_INVALID
;
519 * Disable it on the UST side. First get the channel reference then find
520 * the event and finally disable it.
522 uchan
= trace_ust_find_channel_by_name(usess
->domain_global
.channels
,
523 (char *) ust_channel_name
);
525 ret
= LTTNG_ERR_UST_CHAN_NOT_FOUND
;
529 ust_event_name
= event_get_default_agent_ust_name(agt
->domain
);
530 if (!ust_event_name
) {
531 ret
= LTTNG_ERR_FATAL
;
536 * The loglevel is hardcoded with 0 here since the agent ust event is set
537 * with the loglevel type to ALL thus the loglevel stays 0. The event's
538 * filter is the one handling the loglevel for agent.
540 uevent
= trace_ust_find_event(uchan
->events
, (char *) ust_event_name
,
541 aevent
->filter
, 0, NULL
);
542 /* If the agent event exists, it must be available on the UST side. */
545 ret
= ust_app_disable_event_glb(usess
, uchan
, uevent
);
546 if (ret
< 0 && ret
!= -LTTNG_UST_ERR_EXIST
) {
547 ret
= LTTNG_ERR_UST_DISABLE_FAIL
;
552 * Flag event that it's disabled so the shadow copy on the ust app side
553 * will disable it if an application shows up.
557 ret
= agent_disable_event(aevent
, agt
->domain
);
558 if (ret
!= LTTNG_OK
) {
569 * Disable all agent event for a given UST session.
571 * Return LTTNG_OK on success or else a LTTNG_ERR* code.
573 int event_agent_disable_all(struct ltt_ust_session
*usess
,
577 struct agent_event
*aevent
;
578 struct lttng_ht_iter iter
;
584 * Disable event on agent application. Continue to disable all other events
585 * if the * event is not found.
587 ret
= event_agent_disable(usess
, agt
, "*");
588 if (ret
!= LTTNG_OK
&& ret
!= LTTNG_ERR_UST_EVENT_NOT_FOUND
) {
592 /* Flag every event that they are now enabled. */
594 cds_lfht_for_each_entry(agt
->events
->ht
, &iter
.iter
, aevent
,
596 if (!aevent
->enabled
) {
600 ret
= event_agent_disable(usess
, agt
, aevent
->name
);
601 if (ret
!= LTTNG_OK
) {