SoW-2019-0007-2: Dynamic Snapshot: Triggers send partial event payload with notifications
[deliverable/lttng-ust.git] / liblttng-ust / lttng-events.c
CommitLineData
8020ceb5 1/*
7dd08bec 2 * lttng-events.c
8020ceb5 3 *
8020ceb5
MD
4 * Holds LTTng per-session event registry.
5 *
e92f3e28
MD
6 * Copyright (C) 2010-2012 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
7 *
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; only
11 * version 2.1 of the License.
12 *
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
17 *
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
8020ceb5
MD
21 */
22
b5234c06 23#define _GNU_SOURCE
3fbec7dc 24#define _LGPL_SOURCE
b5234c06 25#include <stdio.h>
cb11f03a 26#include <assert.h>
b5234c06 27#include <errno.h>
cb11f03a
FD
28#include <limits.h>
29#include <pthread.h>
f4681817
MD
30#include <sys/shm.h>
31#include <sys/ipc.h>
44c72f10
MD
32#include <stdint.h>
33#include <stddef.h>
28b12049
MD
34#include <inttypes.h>
35#include <time.h>
196ec2df 36#include <stdbool.h>
cb11f03a 37#include <unistd.h>
2ae57758 38#include <lttng/ust-endian.h>
44c72f10
MD
39
40#include <urcu-bp.h>
cb11f03a 41#include <urcu/arch.h>
44c72f10 42#include <urcu/compiler.h>
cb11f03a
FD
43#include <urcu/hlist.h>
44#include <urcu/list.h>
44c72f10 45#include <urcu/uatomic.h>
44c72f10
MD
46
47#include <lttng/tracepoint.h>
4318ae1b 48#include <lttng/ust-events.h>
44c72f10
MD
49
50#include <usterr-signal-safe.h>
51#include <helper.h>
7d3e35b6 52#include <lttng/ust-ctl.h>
32ce8569 53#include <ust-comm.h>
cb11f03a 54#include <ust-fd.h>
53569322
MD
55#include <lttng/ust-dynamic-type.h>
56#include <lttng/ust-context-provider.h>
1f18504e 57#include "error.h"
08114193 58#include "compat.h"
eda498b8 59#include "lttng-ust-uuid.h"
44c72f10 60
457a6b58 61#include "tracepoint-internal.h"
196ec2df 62#include "string-utils.h"
cb11f03a 63#include "lttng-bytecode.h"
7dd08bec
MD
64#include "lttng-tracer.h"
65#include "lttng-tracer-core.h"
cf73e0fe 66#include "lttng-ust-statedump.h"
cb11f03a
FD
67#include "context-internal.h"
68#include "ust-events-internal.h"
b728d87e 69#include "wait.h"
8d8a24c8 70#include "../libringbuffer/shm.h"
596c4223 71#include "jhash.h"
cb11f03a 72#include <lttng/ust-abi.h>
8165c8da
MD
73
74/*
3327ac33
MD
75 * All operations within this file are called by the communication
76 * thread, under ust_lock protection.
8165c8da 77 */
8165c8da 78
b5234c06 79static CDS_LIST_HEAD(sessions);
cb11f03a 80static CDS_LIST_HEAD(trigger_groups);
8165c8da 81
37dddb65
MD
82struct cds_list_head *_lttng_get_sessions(void)
83{
84 return &sessions;
85}
86
7dd08bec 87static void _lttng_event_destroy(struct lttng_event *event);
cb11f03a 88static void _lttng_trigger_destroy(struct lttng_trigger *trigger);
c785c634 89static void _lttng_enum_destroy(struct lttng_enum *_enum);
8020ceb5 90
e58095ef 91static
cb11f03a
FD
92void lttng_session_lazy_sync_event_enablers(struct lttng_session *session);
93static
94void lttng_session_sync_event_enablers(struct lttng_session *session);
e58095ef 95static
cb11f03a 96void lttng_trigger_group_sync_enablers(struct lttng_trigger_group *trigger_group);
e58095ef
MD
97static
98void lttng_enabler_destroy(struct lttng_enabler *enabler);
99
6715d7d1
MD
100/*
101 * Called with ust lock held.
102 */
103int lttng_session_active(void)
104{
105 struct lttng_session *iter;
106
107 cds_list_for_each_entry(iter, &sessions, node) {
108 if (iter->active)
109 return 1;
110 }
111 return 0;
112}
113
e58095ef
MD
114static
115int lttng_loglevel_match(int loglevel,
116 unsigned int has_loglevel,
457a6b58
MD
117 enum lttng_ust_loglevel_type req_type,
118 int req_loglevel)
119{
e58095ef
MD
120 if (!has_loglevel)
121 loglevel = TRACE_DEFAULT;
457a6b58
MD
122 switch (req_type) {
123 case LTTNG_UST_LOGLEVEL_RANGE:
aacb3774 124 if (loglevel <= req_loglevel
67ada458 125 || (req_loglevel == -1 && loglevel <= TRACE_DEBUG))
457a6b58
MD
126 return 1;
127 else
128 return 0;
129 case LTTNG_UST_LOGLEVEL_SINGLE:
aacb3774 130 if (loglevel == req_loglevel
67ada458 131 || (req_loglevel == -1 && loglevel <= TRACE_DEBUG))
457a6b58
MD
132 return 1;
133 else
134 return 0;
135 case LTTNG_UST_LOGLEVEL_ALL:
136 default:
67ada458 137 if (loglevel <= TRACE_DEBUG)
aacb3774
MD
138 return 1;
139 else
140 return 0;
457a6b58
MD
141 }
142}
143
8020ceb5
MD
144void synchronize_trace(void)
145{
8020ceb5 146 synchronize_rcu();
8020ceb5
MD
147}
148
7dd08bec 149struct lttng_session *lttng_session_create(void)
8020ceb5 150{
7dd08bec 151 struct lttng_session *session;
74d81a6c 152 int i;
8020ceb5 153
7dd08bec 154 session = zmalloc(sizeof(struct lttng_session));
8020ceb5
MD
155 if (!session)
156 return NULL;
cb11f03a 157 if (lttng_context_init_all(&session->ctx)) {
53569322
MD
158 free(session);
159 return NULL;
160 }
e58095ef
MD
161 CDS_INIT_LIST_HEAD(&session->chan_head);
162 CDS_INIT_LIST_HEAD(&session->events_head);
c785c634 163 CDS_INIT_LIST_HEAD(&session->enums_head);
e58095ef 164 CDS_INIT_LIST_HEAD(&session->enablers_head);
d56fa719
MD
165 for (i = 0; i < LTTNG_UST_EVENT_HT_SIZE; i++)
166 CDS_INIT_HLIST_HEAD(&session->events_ht.table[i]);
c785c634
MD
167 for (i = 0; i < LTTNG_UST_ENUM_HT_SIZE; i++)
168 CDS_INIT_HLIST_HEAD(&session->enums_ht.table[i]);
e58095ef 169 cds_list_add(&session->node, &sessions);
8020ceb5
MD
170 return session;
171}
172
cb11f03a
FD
173struct lttng_trigger_group *lttng_trigger_group_create(void)
174{
175 struct lttng_trigger_group *trigger_group;
176 int i;
177
178 trigger_group = zmalloc(sizeof(struct lttng_trigger_group));
179 if (!trigger_group)
180 return NULL;
181
182 /* Add all contexts. */
183 if (lttng_context_init_all(&trigger_group->ctx)) {
184 free(trigger_group);
185 return NULL;
186 }
187
188 CDS_INIT_LIST_HEAD(&trigger_group->enablers_head);
189 CDS_INIT_LIST_HEAD(&trigger_group->triggers_head);
190 for (i = 0; i < LTTNG_UST_TRIGGER_HT_SIZE; i++)
191 CDS_INIT_HLIST_HEAD(&trigger_group->triggers_ht.table[i]);
192
193 cds_list_add(&trigger_group->node, &trigger_groups);
194
195 return trigger_group;
196}
197
74d81a6c
MD
198/*
199 * Only used internally at session destruction.
200 */
201static
202void _lttng_channel_unmap(struct lttng_channel *lttng_chan)
203{
204 struct channel *chan;
205 struct lttng_ust_shm_handle *handle;
206
207 cds_list_del(&lttng_chan->node);
208 lttng_destroy_context(lttng_chan->ctx);
209 chan = lttng_chan->chan;
210 handle = lttng_chan->handle;
211 /*
212 * note: lttng_chan is private data contained within handle. It
213 * will be freed along with the handle.
214 */
215 channel_destroy(chan, handle, 0);
216}
217
ac6b4ac6
MD
218static
219void register_event(struct lttng_event *event)
220{
221 int ret;
222 const struct lttng_event_desc *desc;
223
224 assert(event->registered == 0);
225 desc = event->desc;
baa1e0bc 226 ret = __tracepoint_probe_register_queue_release(desc->name,
ac6b4ac6
MD
227 desc->probe_callback,
228 event, desc->signature);
229 WARN_ON_ONCE(ret);
230 if (!ret)
231 event->registered = 1;
232}
233
cb11f03a
FD
234static
235void register_trigger(struct lttng_trigger *trigger)
236{
237 int ret;
238 const struct lttng_event_desc *desc;
239
240 assert(trigger->registered == 0);
241 desc = trigger->desc;
242 ret = __tracepoint_probe_register_queue_release(desc->name,
243 desc->u.ext.trigger_callback, trigger, desc->signature);
244 WARN_ON_ONCE(ret);
245 if (!ret)
246 trigger->registered = 1;
247}
248
ac6b4ac6
MD
249static
250void unregister_event(struct lttng_event *event)
251{
252 int ret;
253 const struct lttng_event_desc *desc;
254
255 assert(event->registered == 1);
256 desc = event->desc;
baa1e0bc 257 ret = __tracepoint_probe_unregister_queue_release(desc->name,
ac6b4ac6
MD
258 desc->probe_callback,
259 event);
260 WARN_ON_ONCE(ret);
261 if (!ret)
262 event->registered = 0;
263}
264
cb11f03a
FD
265static
266void unregister_trigger(struct lttng_trigger *trigger)
267{
268 int ret;
269 const struct lttng_event_desc *desc;
270
271 assert(trigger->registered == 1);
272 desc = trigger->desc;
273 ret = __tracepoint_probe_unregister_queue_release(desc->name,
274 desc->u.ext.trigger_callback, trigger);
275 WARN_ON_ONCE(ret);
276 if (!ret)
277 trigger->registered = 0;
278}
279
ac6b4ac6
MD
280/*
281 * Only used internally at session destruction.
282 */
283static
284void _lttng_event_unregister(struct lttng_event *event)
285{
286 if (event->registered)
287 unregister_event(event);
288}
289
cb11f03a
FD
290/*
291 * Only used internally at session destruction.
292 */
293static
294void _lttng_trigger_unregister(struct lttng_trigger *trigger)
295{
296 if (trigger->registered)
297 unregister_trigger(trigger);
298}
299
7dd08bec 300void lttng_session_destroy(struct lttng_session *session)
8020ceb5 301{
7dd08bec
MD
302 struct lttng_channel *chan, *tmpchan;
303 struct lttng_event *event, *tmpevent;
c785c634 304 struct lttng_enum *_enum, *tmp_enum;
cb11f03a 305 struct lttng_event_enabler *event_enabler, *event_tmpenabler;
8020ceb5 306
b5234c06 307 CMM_ACCESS_ONCE(session->active) = 0;
e58095ef 308 cds_list_for_each_entry(event, &session->events_head, node) {
ac6b4ac6 309 _lttng_event_unregister(event);
8020ceb5
MD
310 }
311 synchronize_trace(); /* Wait for in-flight events to complete */
baa1e0bc 312 __tracepoint_probe_prune_release_queue();
cb11f03a 313 cds_list_for_each_entry_safe(event_enabler, event_tmpenabler,
e58095ef 314 &session->enablers_head, node)
cb11f03a 315 lttng_event_enabler_destroy(event_enabler);
e58095ef
MD
316 cds_list_for_each_entry_safe(event, tmpevent,
317 &session->events_head, node)
7dd08bec 318 _lttng_event_destroy(event);
c785c634
MD
319 cds_list_for_each_entry_safe(_enum, tmp_enum,
320 &session->enums_head, node)
321 _lttng_enum_destroy(_enum);
e58095ef 322 cds_list_for_each_entry_safe(chan, tmpchan, &session->chan_head, node)
74d81a6c 323 _lttng_channel_unmap(chan);
e58095ef 324 cds_list_del(&session->node);
53569322 325 lttng_destroy_context(session->ctx);
b5234c06 326 free(session);
8020ceb5
MD
327}
328
cb11f03a
FD
329void lttng_trigger_group_destroy(
330 struct lttng_trigger_group *trigger_group)
331{
332 int close_ret;
333 struct lttng_trigger_enabler *trigger_enabler, *tmptrigger_enabler;
334 struct lttng_trigger *trigger, *tmptrigger;
335
336 if (!trigger_group) {
337 return;
338 }
339
340 cds_list_for_each_entry(trigger, &trigger_group->triggers_head, node)
341 _lttng_trigger_unregister(trigger);
342
343 synchronize_trace();
344
345 cds_list_for_each_entry_safe(trigger_enabler, tmptrigger_enabler,
346 &trigger_group->enablers_head, node)
347 lttng_trigger_enabler_destroy(trigger_enabler);
348
349 cds_list_for_each_entry_safe(trigger, tmptrigger,
350 &trigger_group->triggers_head, node)
351 _lttng_trigger_destroy(trigger);
352
353 /* Close the notification fd to the listener of triggers. */
354
355 lttng_ust_lock_fd_tracker();
356 close_ret = close(trigger_group->notification_fd);
357 if (!close_ret) {
358 lttng_ust_delete_fd_from_tracker(trigger_group->notification_fd);
359 } else {
360 PERROR("close");
361 abort();
362 }
363 lttng_ust_unlock_fd_tracker();
364
365 cds_list_del(&trigger_group->node);
366
367 free(trigger_group);
368}
369
370static
371void lttng_enabler_destroy(struct lttng_enabler *enabler)
372{
373 struct lttng_ust_bytecode_node *filter_node, *tmp_filter_node;
374 struct lttng_ust_excluder_node *excluder_node, *tmp_excluder_node;
375
376 if (!enabler) {
377 return;
378 }
379
380 /* Destroy filter bytecode */
381 cds_list_for_each_entry_safe(filter_node, tmp_filter_node,
382 &enabler->filter_bytecode_head, node) {
383 free(filter_node);
384 }
385
386 /* Destroy excluders */
387 cds_list_for_each_entry_safe(excluder_node, tmp_excluder_node,
388 &enabler->excluder_head, node) {
389 free(excluder_node);
390 }
391}
392
393 void lttng_trigger_enabler_destroy(struct lttng_trigger_enabler *trigger_enabler)
394{
395 if (!trigger_enabler) {
396 return;
397 }
398
399 cds_list_del(&trigger_enabler->node);
400
401 lttng_enabler_destroy(lttng_trigger_enabler_as_enabler(trigger_enabler));
402
403 free(trigger_enabler);
404}
405
53569322
MD
406static
407int lttng_enum_create(const struct lttng_enum_desc *desc,
408 struct lttng_session *session)
409{
410 const char *enum_name = desc->name;
411 struct lttng_enum *_enum;
412 struct cds_hlist_head *head;
53569322
MD
413 int ret = 0;
414 size_t name_len = strlen(enum_name);
415 uint32_t hash;
416 int notify_socket;
417
b33b46f7 418 /* Check if this enum is already registered for this session. */
53569322
MD
419 hash = jhash(enum_name, name_len, 0);
420 head = &session->enums_ht.table[hash & (LTTNG_UST_ENUM_HT_SIZE - 1)];
b33b46f7
FD
421
422 _enum = lttng_ust_enum_get_from_desc(session, desc);
423 if (_enum) {
424 ret = -EEXIST;
425 goto exist;
53569322
MD
426 }
427
428 notify_socket = lttng_get_notify_socket(session->owner);
429 if (notify_socket < 0) {
430 ret = notify_socket;
431 goto socket_error;
432 }
433
434 _enum = zmalloc(sizeof(*_enum));
435 if (!_enum) {
436 ret = -ENOMEM;
437 goto cache_error;
438 }
439 _enum->session = session;
440 _enum->desc = desc;
441
442 ret = ustcomm_register_enum(notify_socket,
443 session->objd,
444 enum_name,
445 desc->nr_entries,
446 desc->entries,
447 &_enum->id);
448 if (ret < 0) {
449 DBG("Error (%d) registering enumeration to sessiond", ret);
450 goto sessiond_register_error;
451 }
452 cds_list_add(&_enum->node, &session->enums_head);
453 cds_hlist_add_head(&_enum->hlist, head);
454 return 0;
455
456sessiond_register_error:
457 free(_enum);
458cache_error:
459socket_error:
460exist:
461 return ret;
462}
463
464static
465int lttng_create_enum_check(const struct lttng_type *type,
466 struct lttng_session *session)
467{
468 switch (type->atype) {
469 case atype_enum:
470 {
471 const struct lttng_enum_desc *enum_desc;
472 int ret;
473
218deb69
MD
474 enum_desc = type->u.legacy.basic.enumeration.desc;
475 ret = lttng_enum_create(enum_desc, session);
476 if (ret && ret != -EEXIST) {
477 DBG("Unable to create enum error: (%d)", ret);
478 return ret;
479 }
480 break;
481 }
482 case atype_enum_nestable:
483 {
484 const struct lttng_enum_desc *enum_desc;
485 int ret;
486
487 enum_desc = type->u.enum_nestable.desc;
53569322
MD
488 ret = lttng_enum_create(enum_desc, session);
489 if (ret && ret != -EEXIST) {
490 DBG("Unable to create enum error: (%d)", ret);
491 return ret;
492 }
493 break;
494 }
495 case atype_dynamic:
496 {
497 const struct lttng_event_field *tag_field_generic;
498 const struct lttng_enum_desc *enum_desc;
499 int ret;
500
501 tag_field_generic = lttng_ust_dynamic_type_tag_field();
218deb69 502 enum_desc = tag_field_generic->type.u.enum_nestable.desc;
53569322
MD
503 ret = lttng_enum_create(enum_desc, session);
504 if (ret && ret != -EEXIST) {
505 DBG("Unable to create enum error: (%d)", ret);
506 return ret;
507 }
508 break;
509 }
510 default:
511 /* TODO: nested types when they become supported. */
512 break;
513 }
514 return 0;
515}
516
517static
518int lttng_create_all_event_enums(size_t nr_fields,
519 const struct lttng_event_field *event_fields,
520 struct lttng_session *session)
521{
522 size_t i;
523 int ret;
524
525 /* For each field, ensure enum is part of the session. */
526 for (i = 0; i < nr_fields; i++) {
527 const struct lttng_type *type = &event_fields[i].type;
528
529 ret = lttng_create_enum_check(type, session);
530 if (ret)
531 return ret;
532 }
533 return 0;
534}
535
536static
537int lttng_create_all_ctx_enums(size_t nr_fields,
538 const struct lttng_ctx_field *ctx_fields,
539 struct lttng_session *session)
540{
541 size_t i;
542 int ret;
543
544 /* For each field, ensure enum is part of the session. */
545 for (i = 0; i < nr_fields; i++) {
546 const struct lttng_type *type = &ctx_fields[i].event_field.type;
547
548 ret = lttng_create_enum_check(type, session);
549 if (ret)
550 return ret;
551 }
552 return 0;
553}
554
710b8ee3
MD
555/*
556 * Ensure that a state-dump will be performed for this session at the end
557 * of the current handle_message().
558 */
559int lttng_session_statedump(struct lttng_session *session)
560{
561 session->statedump_pending = 1;
562 lttng_ust_sockinfo_session_enabled(session->owner);
563 return 0;
564}
53569322 565
7dd08bec 566int lttng_session_enable(struct lttng_session *session)
8020ceb5
MD
567{
568 int ret = 0;
7dd08bec 569 struct lttng_channel *chan;
32ce8569 570 int notify_socket;
8020ceb5 571
8020ceb5
MD
572 if (session->active) {
573 ret = -EBUSY;
574 goto end;
575 }
576
32ce8569
MD
577 notify_socket = lttng_get_notify_socket(session->owner);
578 if (notify_socket < 0)
579 return notify_socket;
580
ac6b4ac6
MD
581 /* Set transient enabler state to "enabled" */
582 session->tstate = 1;
e58095ef 583
3ff7660f 584 /* We need to sync enablers with session before activation. */
cb11f03a 585 lttng_session_sync_event_enablers(session);
3ff7660f 586
8020ceb5
MD
587 /*
588 * Snapshot the number of events per channel to know the type of header
589 * we need to use.
590 */
e58095ef 591 cds_list_for_each_entry(chan, &session->chan_head, node) {
32ce8569 592 const struct lttng_ctx *ctx;
83e43212 593 const struct lttng_ctx_field *fields = NULL;
32ce8569 594 size_t nr_fields = 0;
6ca18e66 595 uint32_t chan_id;
32ce8569
MD
596
597 /* don't change it if session stop/restart */
8020ceb5 598 if (chan->header_type)
32ce8569
MD
599 continue;
600 ctx = chan->ctx;
601 if (ctx) {
602 nr_fields = ctx->nr_fields;
83e43212 603 fields = ctx->fields;
53569322
MD
604 ret = lttng_create_all_ctx_enums(nr_fields, fields,
605 session);
606 if (ret < 0) {
607 DBG("Error (%d) adding enum to session", ret);
608 return ret;
609 }
32ce8569
MD
610 }
611 ret = ustcomm_register_channel(notify_socket,
53569322 612 session,
32ce8569
MD
613 session->objd,
614 chan->objd,
615 nr_fields,
616 fields,
6ca18e66 617 &chan_id,
32ce8569 618 &chan->header_type);
b869b5ae
MD
619 if (ret) {
620 DBG("Error (%d) registering channel to sessiond", ret);
32ce8569 621 return ret;
b869b5ae 622 }
6ca18e66
MD
623 if (chan_id != chan->id) {
624 DBG("Error: channel registration id (%u) does not match id assigned at creation (%u)",
625 chan_id, chan->id);
626 return -EINVAL;
627 }
8020ceb5
MD
628 }
629
ac6b4ac6 630 /* Set atomically the state to "active" */
b5234c06
MD
631 CMM_ACCESS_ONCE(session->active) = 1;
632 CMM_ACCESS_ONCE(session->been_active) = 1;
95c25348 633
710b8ee3
MD
634 ret = lttng_session_statedump(session);
635 if (ret)
636 return ret;
8020ceb5 637end:
8020ceb5
MD
638 return ret;
639}
640
7dd08bec 641int lttng_session_disable(struct lttng_session *session)
8020ceb5
MD
642{
643 int ret = 0;
644
8020ceb5
MD
645 if (!session->active) {
646 ret = -EBUSY;
647 goto end;
648 }
ac6b4ac6 649 /* Set atomically the state to "inactive" */
b5234c06 650 CMM_ACCESS_ONCE(session->active) = 0;
ac6b4ac6
MD
651
652 /* Set transient enabler state to "disabled" */
653 session->tstate = 0;
cb11f03a 654 lttng_session_sync_event_enablers(session);
8020ceb5 655end:
8020ceb5
MD
656 return ret;
657}
658
7dd08bec 659int lttng_channel_enable(struct lttng_channel *channel)
976fe9ea 660{
ac6b4ac6 661 int ret = 0;
976fe9ea 662
ac6b4ac6
MD
663 if (channel->enabled) {
664 ret = -EBUSY;
665 goto end;
666 }
667 /* Set transient enabler state to "enabled" */
668 channel->tstate = 1;
cb11f03a 669 lttng_session_sync_event_enablers(channel->session);
ac6b4ac6
MD
670 /* Set atomically the state to "enabled" */
671 CMM_ACCESS_ONCE(channel->enabled) = 1;
672end:
673 return ret;
976fe9ea
MD
674}
675
7dd08bec 676int lttng_channel_disable(struct lttng_channel *channel)
976fe9ea 677{
ac6b4ac6 678 int ret = 0;
976fe9ea 679
ac6b4ac6
MD
680 if (!channel->enabled) {
681 ret = -EBUSY;
682 goto end;
683 }
684 /* Set atomically the state to "disabled" */
685 CMM_ACCESS_ONCE(channel->enabled) = 0;
686 /* Set transient enabler state to "enabled" */
687 channel->tstate = 0;
cb11f03a 688 lttng_session_sync_event_enablers(channel->session);
ac6b4ac6
MD
689end:
690 return ret;
976fe9ea
MD
691}
692
cb11f03a
FD
693static inline
694struct cds_hlist_head *borrow_hash_table_bucket(
695 struct cds_hlist_head *hash_table,
696 unsigned int hash_table_size,
697 const struct lttng_event_desc *desc)
698{
699 const char *event_name;
700 size_t name_len;
701 uint32_t hash;
702
703 event_name = desc->name;
704 name_len = strlen(event_name);
705
706 hash = jhash(event_name, name_len, 0);
707 return &hash_table[hash & (hash_table_size - 1)];
708}
709
8020ceb5
MD
710/*
711 * Supports event creation while tracing session is active.
712 */
e58095ef
MD
713static
714int lttng_event_create(const struct lttng_event_desc *desc,
715 struct lttng_channel *chan)
8020ceb5 716{
7dd08bec 717 struct lttng_event *event;
32ce8569 718 struct lttng_session *session = chan->session;
d56fa719 719 struct cds_hlist_head *head;
576599a0 720 int ret = 0;
32ce8569
MD
721 int notify_socket, loglevel;
722 const char *uri;
8020ceb5 723
cb11f03a
FD
724 head = borrow_hash_table_bucket(chan->session->events_ht.table,
725 LTTNG_UST_EVENT_HT_SIZE, desc);
457a6b58 726
32ce8569
MD
727 notify_socket = lttng_get_notify_socket(session->owner);
728 if (notify_socket < 0) {
729 ret = notify_socket;
730 goto socket_error;
731 }
732
53569322
MD
733 ret = lttng_create_all_event_enums(desc->nr_fields, desc->fields,
734 session);
c785c634
MD
735 if (ret < 0) {
736 DBG("Error (%d) adding enum to session", ret);
737 goto create_enum_error;
738 }
739
457a6b58
MD
740 /*
741 * Check if loglevel match. Refuse to connect event if not.
742 */
7dd08bec 743 event = zmalloc(sizeof(struct lttng_event));
576599a0
MD
744 if (!event) {
745 ret = -ENOMEM;
8020ceb5 746 goto cache_error;
576599a0 747 }
8020ceb5 748 event->chan = chan;
e58095ef 749
ac6b4ac6
MD
750 /* Event will be enabled by enabler sync. */
751 event->enabled = 0;
752 event->registered = 0;
cb11f03a 753 CDS_INIT_LIST_HEAD(&event->filter_bytecode_runtime_head);
e58095ef
MD
754 CDS_INIT_LIST_HEAD(&event->enablers_ref_head);
755 event->desc = desc;
32ce8569
MD
756
757 if (desc->loglevel)
758 loglevel = *(*event->desc->loglevel);
759 else
760 loglevel = TRACE_DEFAULT;
761 if (desc->u.ext.model_emf_uri)
762 uri = *(desc->u.ext.model_emf_uri);
763 else
764 uri = NULL;
765
13b21cd6
MD
766 /* Fetch event ID from sessiond */
767 ret = ustcomm_register_event(notify_socket,
c785c634 768 session,
13b21cd6
MD
769 session->objd,
770 chan->objd,
cb11f03a 771 desc->name,
13b21cd6
MD
772 loglevel,
773 desc->signature,
774 desc->nr_fields,
775 desc->fields,
776 uri,
777 &event->id);
778 if (ret < 0) {
779 DBG("Error (%d) registering event to sessiond", ret);
780 goto sessiond_register_error;
32ce8569 781 }
2b213b16 782
e58095ef 783 cds_list_add(&event->node, &chan->session->events_head);
d56fa719 784 cds_hlist_add_head(&event->hlist, head);
576599a0 785 return 0;
8020ceb5 786
32ce8569 787sessiond_register_error:
b5234c06 788 free(event);
8020ceb5 789cache_error:
c785c634 790create_enum_error:
32ce8569 791socket_error:
576599a0 792 return ret;
8020ceb5
MD
793}
794
cb11f03a
FD
795static
796int lttng_trigger_create(const struct lttng_event_desc *desc,
797 uint64_t id, struct lttng_trigger_group *trigger_group)
798{
799 struct lttng_trigger *trigger;
800 struct cds_hlist_head *head;
801 int ret = 0;
802
803 /*
804 * Get the hashtable bucket the created lttng_trigger object should be
805 * inserted.
806 */
807 head = borrow_hash_table_bucket(trigger_group->triggers_ht.table,
808 LTTNG_UST_TRIGGER_HT_SIZE, desc);
809
810 trigger = zmalloc(sizeof(struct lttng_trigger));
811 if (!trigger) {
812 ret = -ENOMEM;
813 goto error;
814 }
815
816 trigger->group = trigger_group;
817 trigger->id = id;
818
819 /* Trigger will be enabled by enabler sync. */
820 trigger->enabled = 0;
821 trigger->registered = 0;
822
823 CDS_INIT_LIST_HEAD(&trigger->filter_bytecode_runtime_head);
824 CDS_INIT_LIST_HEAD(&trigger->capture_bytecode_runtime_head);
825 CDS_INIT_LIST_HEAD(&trigger->enablers_ref_head);
826 trigger->desc = desc;
827
828 cds_list_add(&trigger->node, &trigger_group->triggers_head);
829 cds_hlist_add_head(&trigger->hlist, head);
830
831 return 0;
832
833error:
834 return ret;
835}
836
837static
838void _lttng_trigger_destroy(struct lttng_trigger *trigger)
839{
840 struct lttng_enabler_ref *enabler_ref, *tmp_enabler_ref;
841
842 /* Remove from trigger list. */
843 cds_list_del(&trigger->node);
844 /* Remove from trigger hash table. */
845 cds_hlist_del(&trigger->hlist);
846
847 lttng_free_trigger_filter_runtime(trigger);
848
849 /* Free trigger enabler refs */
850 cds_list_for_each_entry_safe(enabler_ref, tmp_enabler_ref,
851 &trigger->enablers_ref_head, node)
852 free(enabler_ref);
853 free(trigger);
854}
855
e58095ef 856static
196ec2df 857int lttng_desc_match_star_glob_enabler(const struct lttng_event_desc *desc,
e58095ef
MD
858 struct lttng_enabler *enabler)
859{
860 int loglevel = 0;
7e2e405c 861 unsigned int has_loglevel = 0;
e58095ef 862
cb11f03a 863 assert(enabler->format_type == LTTNG_ENABLER_FORMAT_STAR_GLOB);
1f6f42e6
MD
864 if (!strutils_star_glob_match(enabler->event_param.name, SIZE_MAX,
865 desc->name, SIZE_MAX))
e58095ef
MD
866 return 0;
867 if (desc->loglevel) {
868 loglevel = *(*desc->loglevel);
869 has_loglevel = 1;
870 }
871 if (!lttng_loglevel_match(loglevel,
872 has_loglevel,
873 enabler->event_param.loglevel_type,
874 enabler->event_param.loglevel))
875 return 0;
876 return 1;
877}
878
879static
880int lttng_desc_match_event_enabler(const struct lttng_event_desc *desc,
881 struct lttng_enabler *enabler)
882{
883 int loglevel = 0;
884 unsigned int has_loglevel = 0;
885
cb11f03a 886 assert(enabler->format_type == LTTNG_ENABLER_FORMAT_EVENT);
e58095ef
MD
887 if (strcmp(desc->name, enabler->event_param.name))
888 return 0;
889 if (desc->loglevel) {
890 loglevel = *(*desc->loglevel);
891 has_loglevel = 1;
892 }
893 if (!lttng_loglevel_match(loglevel,
894 has_loglevel,
895 enabler->event_param.loglevel_type,
896 enabler->event_param.loglevel))
897 return 0;
898 return 1;
899}
900
901static
902int lttng_desc_match_enabler(const struct lttng_event_desc *desc,
903 struct lttng_enabler *enabler)
904{
cb11f03a
FD
905 switch (enabler->format_type) {
906 case LTTNG_ENABLER_FORMAT_STAR_GLOB:
196ec2df
PP
907 {
908 struct lttng_ust_excluder_node *excluder;
909
910 if (!lttng_desc_match_star_glob_enabler(desc, enabler)) {
911 return 0;
912 }
913
914 /*
915 * If the matching event matches with an excluder,
916 * return 'does not match'
917 */
918 cds_list_for_each_entry(excluder, &enabler->excluder_head, node) {
919 int count;
920
921 for (count = 0; count < excluder->excluder.count; count++) {
922 int len;
923 char *excluder_name;
924
925 excluder_name = (char *) (excluder->excluder.names)
926 + count * LTTNG_UST_SYM_NAME_LEN;
927 len = strnlen(excluder_name, LTTNG_UST_SYM_NAME_LEN);
1f6f42e6 928 if (len > 0 && strutils_star_glob_match(excluder_name, len, desc->name, SIZE_MAX))
196ec2df 929 return 0;
ed5b5bbd
JI
930 }
931 }
196ec2df 932 return 1;
ed5b5bbd 933 }
cb11f03a 934 case LTTNG_ENABLER_FORMAT_EVENT:
e58095ef
MD
935 return lttng_desc_match_event_enabler(desc, enabler);
936 default:
937 return -EINVAL;
938 }
939}
940
941static
cb11f03a
FD
942int lttng_event_enabler_match_event(struct lttng_event_enabler *event_enabler,
943 struct lttng_event *event)
944{
945 if (lttng_desc_match_enabler(event->desc,
946 lttng_event_enabler_as_enabler(event_enabler))
947 && event->chan == event_enabler->chan)
948 return 1;
949 else
950 return 0;
951}
952
953static
954int lttng_trigger_enabler_match_trigger(
955 struct lttng_trigger_enabler *trigger_enabler,
956 struct lttng_trigger *trigger)
e58095ef 957{
cb11f03a
FD
958 int desc_matches = lttng_desc_match_enabler(trigger->desc,
959 lttng_trigger_enabler_as_enabler(trigger_enabler));
960
961 if (desc_matches && trigger->group == trigger_enabler->group &&
962 trigger->id == trigger_enabler->id)
d970f72e
MD
963 return 1;
964 else
965 return 0;
e58095ef
MD
966}
967
968static
cb11f03a
FD
969struct lttng_enabler_ref *lttng_enabler_ref(
970 struct cds_list_head *enabler_ref_list,
e58095ef
MD
971 struct lttng_enabler *enabler)
972{
973 struct lttng_enabler_ref *enabler_ref;
974
cb11f03a 975 cds_list_for_each_entry(enabler_ref, enabler_ref_list, node) {
e58095ef
MD
976 if (enabler_ref->ref == enabler)
977 return enabler_ref;
978 }
979 return NULL;
980}
981
8020ceb5 982/*
e58095ef
MD
983 * Create struct lttng_event if it is missing and present in the list of
984 * tracepoint probes.
8020ceb5 985 */
e58095ef 986static
cb11f03a 987void lttng_create_event_if_missing(struct lttng_event_enabler *event_enabler)
8020ceb5 988{
cb11f03a 989 struct lttng_session *session = event_enabler->chan->session;
e58095ef
MD
990 struct lttng_probe_desc *probe_desc;
991 const struct lttng_event_desc *desc;
992 struct lttng_event *event;
993 int i;
994 struct cds_list_head *probe_list;
995
996 probe_list = lttng_get_probe_list_head();
997 /*
998 * For each probe event, if we find that a probe event matches
999 * our enabler, create an associated lttng_event if not
1000 * already present.
1001 */
1002 cds_list_for_each_entry(probe_desc, probe_list, head) {
1003 for (i = 0; i < probe_desc->nr_events; i++) {
98a97f24
FD
1004 int ret;
1005 bool found = false;
d56fa719
MD
1006 struct cds_hlist_head *head;
1007 struct cds_hlist_node *node;
e58095ef
MD
1008
1009 desc = probe_desc->event_desc[i];
cb11f03a
FD
1010 if (!lttng_desc_match_enabler(desc,
1011 lttng_event_enabler_as_enabler(event_enabler)))
e58095ef
MD
1012 continue;
1013
cb11f03a
FD
1014 head = borrow_hash_table_bucket(
1015 session->events_ht.table,
1016 LTTNG_UST_EVENT_HT_SIZE, desc);
1017
d56fa719 1018 cds_hlist_for_each_entry(event, node, head, hlist) {
d970f72e 1019 if (event->desc == desc
cb11f03a 1020 && event->chan == event_enabler->chan) {
98a97f24 1021 found = true;
3140bffe
FD
1022 break;
1023 }
e58095ef
MD
1024 }
1025 if (found)
1026 continue;
1027
1028 /*
1029 * We need to create an event for this
1030 * event probe.
1031 */
1032 ret = lttng_event_create(probe_desc->event_desc[i],
cb11f03a 1033 event_enabler->chan);
e58095ef 1034 if (ret) {
32ce8569
MD
1035 DBG("Unable to create event %s, error %d\n",
1036 probe_desc->event_desc[i]->name, ret);
e58095ef 1037 }
8165c8da 1038 }
8020ceb5 1039 }
8020ceb5
MD
1040}
1041
cb11f03a
FD
1042static
1043void probe_provider_event_for_each(struct lttng_probe_desc *provider_desc,
1044 void (*event_func)(struct lttng_session *session,
1045 struct lttng_event *event),
1046 void (*trigger_func)(struct lttng_trigger *trigger))
35ac38cb
FD
1047{
1048 struct cds_hlist_node *node, *tmp_node;
1049 struct cds_list_head *sessionsp;
cb11f03a 1050 unsigned int i;
35ac38cb
FD
1051
1052 /* Get handle on list of sessions. */
1053 sessionsp = _lttng_get_sessions();
1054
1055 /*
cb11f03a
FD
1056 * Iterate over all events in the probe provider descriptions and
1057 * sessions to queue the unregistration of the events.
35ac38cb
FD
1058 */
1059 for (i = 0; i < provider_desc->nr_events; i++) {
1060 const struct lttng_event_desc *event_desc;
cb11f03a
FD
1061 struct lttng_trigger_group *trigger_group;
1062 struct lttng_trigger *trigger;
1063 struct lttng_session *session;
1064 struct cds_hlist_head *head;
1065 struct lttng_event *event;
35ac38cb
FD
1066
1067 event_desc = provider_desc->event_desc[i];
35ac38cb 1068
cb11f03a
FD
1069 /*
1070 * Iterate over all session to find the current event
1071 * description.
1072 */
35ac38cb
FD
1073 cds_list_for_each_entry(session, sessionsp, node) {
1074 /*
cb11f03a
FD
1075 * Get the list of events in the hashtable bucket and
1076 * iterate to find the event matching this descriptor.
35ac38cb 1077 */
cb11f03a
FD
1078 head = borrow_hash_table_bucket(
1079 session->events_ht.table,
1080 LTTNG_UST_EVENT_HT_SIZE, event_desc);
1081
1082 cds_hlist_for_each_entry_safe(event, node, tmp_node, head, hlist) {
35ac38cb 1083 if (event_desc == event->desc) {
cb11f03a
FD
1084 event_func(session, event);
1085 break;
1086 }
1087 }
1088 }
1089
1090 /*
1091 * Iterate over all trigger groups to find the current event
1092 * description.
1093 */
1094 cds_list_for_each_entry(trigger_group, &trigger_groups, node) {
1095 /*
1096 * Get the list of triggers in the hashtable bucket and
1097 * iterate to find the trigger matching this
1098 * descriptor.
1099 */
1100 head = borrow_hash_table_bucket(
1101 trigger_group->triggers_ht.table,
1102 LTTNG_UST_TRIGGER_HT_SIZE, event_desc);
1103
1104 cds_hlist_for_each_entry_safe(trigger, node, tmp_node, head, hlist) {
1105 if (event_desc == trigger->desc) {
1106 trigger_func(trigger);
35ac38cb
FD
1107 break;
1108 }
1109 }
1110 }
1111 }
cb11f03a
FD
1112}
1113
1114static
1115void _unregister_event(struct lttng_session *session,
1116 struct lttng_event *event)
1117{
1118 _lttng_event_unregister(event);
1119}
1120
1121static
1122void _event_enum_destroy(struct lttng_session *session,
1123 struct lttng_event *event)
1124{
1125 unsigned int i;
1126
1127 /* Destroy enums of the current event. */
1128 for (i = 0; i < event->desc->nr_fields; i++) {
1129 const struct lttng_enum_desc *enum_desc;
1130 const struct lttng_event_field *field;
1131 struct lttng_enum *curr_enum;
1132
1133 field = &(event->desc->fields[i]);
1134 switch (field->type.atype) {
1135 case atype_enum:
1136 enum_desc = field->type.u.legacy.basic.enumeration.desc;
1137 break;
1138 case atype_enum_nestable:
1139 enum_desc = field->type.u.enum_nestable.desc;
1140 break;
1141 default:
1142 continue;
1143 }
1144
1145 curr_enum = lttng_ust_enum_get_from_desc(session, enum_desc);
1146 if (curr_enum) {
1147 _lttng_enum_destroy(curr_enum);
1148 }
1149 }
1150
1151 /* Destroy event. */
1152 _lttng_event_destroy(event);
1153}
1154
1155/*
1156 * Iterate over all the UST sessions to unregister and destroy all probes from
1157 * the probe provider descriptor received as argument. Must me called with the
1158 * ust_lock held.
1159 */
1160void lttng_probe_provider_unregister_events(
1161 struct lttng_probe_desc *provider_desc)
1162{
1163 /*
1164 * Iterate over all events in the probe provider descriptions and sessions
1165 * to queue the unregistration of the events.
1166 */
1167 probe_provider_event_for_each(provider_desc, _unregister_event,
1168 _lttng_trigger_unregister);
35ac38cb
FD
1169
1170 /* Wait for grace period. */
1171 synchronize_trace();
1172 /* Prune the unregistration queue. */
1173 __tracepoint_probe_prune_release_queue();
1174
1175 /*
1176 * It is now safe to destroy the events and remove them from the event list
1177 * and hashtables.
1178 */
cb11f03a
FD
1179 probe_provider_event_for_each(provider_desc, _event_enum_destroy,
1180 _lttng_trigger_destroy);
35ac38cb
FD
1181}
1182
8020ceb5 1183/*
cb11f03a 1184 * Create events associated with an event enabler (if not already present),
e58095ef 1185 * and add backward reference from the event to the enabler.
8020ceb5
MD
1186 */
1187static
cb11f03a 1188int lttng_event_enabler_ref_events(struct lttng_event_enabler *event_enabler)
8020ceb5 1189{
cb11f03a 1190 struct lttng_session *session = event_enabler->chan->session;
e58095ef
MD
1191 struct lttng_event *event;
1192
cb11f03a 1193 if (!lttng_event_enabler_as_enabler(event_enabler)->enabled)
de713d8a
FD
1194 goto end;
1195
e58095ef 1196 /* First ensure that probe events are created for this enabler. */
cb11f03a 1197 lttng_create_event_if_missing(event_enabler);
e58095ef
MD
1198
1199 /* For each event matching enabler in session event list. */
1200 cds_list_for_each_entry(event, &session->events_head, node) {
1201 struct lttng_enabler_ref *enabler_ref;
1202
cb11f03a 1203 if (!lttng_event_enabler_match_event(event_enabler, event))
e58095ef
MD
1204 continue;
1205
cb11f03a
FD
1206 enabler_ref = lttng_enabler_ref(&event->enablers_ref_head,
1207 lttng_event_enabler_as_enabler(event_enabler));
e58095ef
MD
1208 if (!enabler_ref) {
1209 /*
1210 * If no backward ref, create it.
1211 * Add backward ref from event to enabler.
1212 */
1213 enabler_ref = zmalloc(sizeof(*enabler_ref));
1214 if (!enabler_ref)
1215 return -ENOMEM;
cb11f03a
FD
1216 enabler_ref->ref = lttng_event_enabler_as_enabler(
1217 event_enabler);
e58095ef
MD
1218 cds_list_add(&enabler_ref->node,
1219 &event->enablers_ref_head);
8165c8da 1220 }
e58095ef
MD
1221
1222 /*
1223 * Link filter bytecodes if not linked yet.
1224 */
cb11f03a
FD
1225 lttng_enabler_link_bytecode(event->desc,
1226 &session->ctx,
1227 &event->filter_bytecode_runtime_head,
1228 &lttng_event_enabler_as_enabler(event_enabler)->filter_bytecode_head);
e58095ef
MD
1229
1230 /* TODO: merge event context. */
1231 }
de713d8a 1232end:
e58095ef
MD
1233 return 0;
1234}
1235
1236/*
1237 * Called at library load: connect the probe on all enablers matching
1238 * this event.
5f733922 1239 * Called with session mutex held.
e58095ef 1240 */
5f733922 1241int lttng_fix_pending_events(void)
e58095ef
MD
1242{
1243 struct lttng_session *session;
1244
1245 cds_list_for_each_entry(session, &sessions, node) {
cb11f03a
FD
1246 lttng_session_lazy_sync_event_enablers(session);
1247 }
1248 return 0;
1249}
1250
1251int lttng_fix_pending_triggers(void)
1252{
1253 struct lttng_trigger_group *trigger_group;
1254
1255 cds_list_for_each_entry(trigger_group, &trigger_groups, node) {
1256 lttng_trigger_group_sync_enablers(trigger_group);
8020ceb5 1257 }
e58095ef
MD
1258 return 0;
1259}
1260
246be17e 1261/*
37dddb65
MD
1262 * For each session of the owner thread, execute pending statedump.
1263 * Only dump state for the sessions owned by the caller thread, because
1264 * we don't keep ust_lock across the entire iteration.
246be17e 1265 */
3327ac33 1266void lttng_handle_pending_statedump(void *owner)
246be17e
PW
1267{
1268 struct lttng_session *session;
1269
37dddb65 1270 /* Execute state dump */
cf73e0fe 1271 do_lttng_ust_statedump(owner);
37dddb65
MD
1272
1273 /* Clear pending state dump */
3327ac33
MD
1274 if (ust_lock()) {
1275 goto end;
1276 }
246be17e 1277 cds_list_for_each_entry(session, &sessions, node) {
37dddb65
MD
1278 if (session->owner != owner)
1279 continue;
1280 if (!session->statedump_pending)
1281 continue;
1282 session->statedump_pending = 0;
246be17e 1283 }
3327ac33 1284end:
37dddb65 1285 ust_unlock();
3327ac33 1286 return;
246be17e
PW
1287}
1288
e58095ef
MD
1289/*
1290 * Only used internally at session destruction.
1291 */
1292static
1293void _lttng_event_destroy(struct lttng_event *event)
1294{
1295 struct lttng_enabler_ref *enabler_ref, *tmp_enabler_ref;
1296
35ac38cb 1297 /* Remove from event list. */
e58095ef 1298 cds_list_del(&event->node);
35ac38cb
FD
1299 /* Remove from event hash table. */
1300 cds_hlist_del(&event->hlist);
1301
8020ceb5 1302 lttng_destroy_context(event->ctx);
f488575f 1303 lttng_free_event_filter_runtime(event);
e58095ef
MD
1304 /* Free event enabler refs */
1305 cds_list_for_each_entry_safe(enabler_ref, tmp_enabler_ref,
1306 &event->enablers_ref_head, node)
1307 free(enabler_ref);
b5234c06 1308 free(event);
8020ceb5
MD
1309}
1310
c785c634
MD
1311static
1312void _lttng_enum_destroy(struct lttng_enum *_enum)
1313{
1314 cds_list_del(&_enum->node);
35ac38cb 1315 cds_hlist_del(&_enum->hlist);
c785c634
MD
1316 free(_enum);
1317}
1318
003fedf4 1319void lttng_ust_events_exit(void)
8020ceb5 1320{
7dd08bec 1321 struct lttng_session *session, *tmpsession;
8020ceb5 1322
e58095ef 1323 cds_list_for_each_entry_safe(session, tmpsession, &sessions, node)
7dd08bec 1324 lttng_session_destroy(session);
8020ceb5 1325}
457a6b58 1326
e58095ef
MD
1327/*
1328 * Enabler management.
1329 */
cb11f03a
FD
1330struct lttng_event_enabler *lttng_event_enabler_create(
1331 enum lttng_enabler_format_type format_type,
e58095ef
MD
1332 struct lttng_ust_event *event_param,
1333 struct lttng_channel *chan)
457a6b58 1334{
cb11f03a 1335 struct lttng_event_enabler *event_enabler;
e58095ef 1336
cb11f03a
FD
1337 event_enabler = zmalloc(sizeof(*event_enabler));
1338 if (!event_enabler)
e58095ef 1339 return NULL;
cb11f03a
FD
1340 event_enabler->base.format_type = format_type;
1341 CDS_INIT_LIST_HEAD(&event_enabler->base.filter_bytecode_head);
1342 CDS_INIT_LIST_HEAD(&event_enabler->base.excluder_head);
1343 memcpy(&event_enabler->base.event_param, event_param,
1344 sizeof(event_enabler->base.event_param));
1345 event_enabler->chan = chan;
e58095ef 1346 /* ctx left NULL */
cb11f03a
FD
1347 event_enabler->base.enabled = 0;
1348 cds_list_add(&event_enabler->node, &event_enabler->chan->session->enablers_head);
1349 lttng_session_lazy_sync_event_enablers(event_enabler->chan->session);
1350
1351 return event_enabler;
457a6b58
MD
1352}
1353
cb11f03a
FD
1354struct lttng_trigger_enabler *lttng_trigger_enabler_create(
1355 struct lttng_trigger_group *trigger_group,
1356 enum lttng_enabler_format_type format_type,
1357 struct lttng_ust_trigger *trigger_param)
457a6b58 1358{
cb11f03a
FD
1359 struct lttng_trigger_enabler *trigger_enabler;
1360
1361 trigger_enabler = zmalloc(sizeof(*trigger_enabler));
1362 if (!trigger_enabler)
1363 return NULL;
1364 trigger_enabler->base.format_type = format_type;
1365 CDS_INIT_LIST_HEAD(&trigger_enabler->base.filter_bytecode_head);
1366 CDS_INIT_LIST_HEAD(&trigger_enabler->capture_bytecode_head);
1367 CDS_INIT_LIST_HEAD(&trigger_enabler->base.excluder_head);
1368
1369 trigger_enabler->id = trigger_param->id;
1370 trigger_enabler->num_captures = 0;
1371
1372 memcpy(&trigger_enabler->base.event_param.name, trigger_param->name,
1373 sizeof(trigger_enabler->base.event_param.name));
1374 trigger_enabler->base.event_param.instrumentation = trigger_param->instrumentation;
1375 trigger_enabler->base.event_param.loglevel = trigger_param->loglevel;
1376 trigger_enabler->base.event_param.loglevel_type = trigger_param->loglevel_type;
1377
1378 trigger_enabler->base.enabled = 0;
1379 trigger_enabler->group = trigger_group;
1380
1381 cds_list_add(&trigger_enabler->node, &trigger_group->enablers_head);
1382
1383 lttng_trigger_group_sync_enablers(trigger_group);
1384
1385 return trigger_enabler;
1386}
1387
1388int lttng_event_enabler_enable(struct lttng_event_enabler *event_enabler)
1389{
1390 lttng_event_enabler_as_enabler(event_enabler)->enabled = 1;
1391 lttng_session_lazy_sync_event_enablers(event_enabler->chan->session);
1392
e58095ef 1393 return 0;
457a6b58 1394}
457a6b58 1395
cb11f03a 1396int lttng_event_enabler_disable(struct lttng_event_enabler *event_enabler)
457a6b58 1397{
cb11f03a
FD
1398 lttng_event_enabler_as_enabler(event_enabler)->enabled = 0;
1399 lttng_session_lazy_sync_event_enablers(event_enabler->chan->session);
1400
e58095ef
MD
1401 return 0;
1402}
457a6b58 1403
cb11f03a
FD
1404static
1405void _lttng_enabler_attach_filter_bytecode(struct lttng_enabler *enabler,
1406 struct lttng_ust_bytecode_node *bytecode)
e58095ef
MD
1407{
1408 bytecode->enabler = enabler;
1409 cds_list_add_tail(&bytecode->node, &enabler->filter_bytecode_head);
cb11f03a
FD
1410}
1411
1412int lttng_event_enabler_attach_filter_bytecode(struct lttng_event_enabler *event_enabler,
1413 struct lttng_ust_bytecode_node *bytecode)
1414{
1415 _lttng_enabler_attach_filter_bytecode(
1416 lttng_event_enabler_as_enabler(event_enabler), bytecode);
1417
1418 lttng_session_lazy_sync_event_enablers(event_enabler->chan->session);
e58095ef 1419 return 0;
0bfb5cbd
JI
1420}
1421
cb11f03a
FD
1422static
1423void _lttng_enabler_attach_exclusion(struct lttng_enabler *enabler,
0bfb5cbd
JI
1424 struct lttng_ust_excluder_node *excluder)
1425{
1426 excluder->enabler = enabler;
1427 cds_list_add_tail(&excluder->node, &enabler->excluder_head);
cb11f03a
FD
1428}
1429
1430int lttng_event_enabler_attach_exclusion(struct lttng_event_enabler *event_enabler,
1431 struct lttng_ust_excluder_node *excluder)
1432{
1433 _lttng_enabler_attach_exclusion(
1434 lttng_event_enabler_as_enabler(event_enabler), excluder);
1435
1436 lttng_session_lazy_sync_event_enablers(event_enabler->chan->session);
1437 return 0;
1438}
1439
1440int lttng_trigger_enabler_enable(struct lttng_trigger_enabler *trigger_enabler)
1441{
1442 lttng_trigger_enabler_as_enabler(trigger_enabler)->enabled = 1;
1443 lttng_trigger_group_sync_enablers(trigger_enabler->group);
1444
1445 return 0;
1446}
1447
1448int lttng_trigger_enabler_disable(struct lttng_trigger_enabler *trigger_enabler)
1449{
1450 lttng_trigger_enabler_as_enabler(trigger_enabler)->enabled = 0;
1451 lttng_trigger_group_sync_enablers(trigger_enabler->group);
1452
1453 return 0;
1454}
1455
1456int lttng_trigger_enabler_attach_filter_bytecode(
1457 struct lttng_trigger_enabler *trigger_enabler,
1458 struct lttng_ust_bytecode_node *bytecode)
1459{
1460 _lttng_enabler_attach_filter_bytecode(
1461 lttng_trigger_enabler_as_enabler(trigger_enabler), bytecode);
1462
1463 lttng_trigger_group_sync_enablers(trigger_enabler->group);
1464 return 0;
1465}
1466
1467int lttng_trigger_enabler_attach_capture_bytecode(
1468 struct lttng_trigger_enabler *trigger_enabler,
1469 struct lttng_ust_bytecode_node *bytecode)
1470{
1471 bytecode->enabler = lttng_trigger_enabler_as_enabler(trigger_enabler);
1472 cds_list_add_tail(&bytecode->node, &trigger_enabler->capture_bytecode_head);
1473 trigger_enabler->num_captures++;
1474
1475 lttng_trigger_group_sync_enablers(trigger_enabler->group);
1476 return 0;
1477}
1478
1479int lttng_trigger_enabler_attach_exclusion(
1480 struct lttng_trigger_enabler *trigger_enabler,
1481 struct lttng_ust_excluder_node *excluder)
1482{
1483 _lttng_enabler_attach_exclusion(
1484 lttng_trigger_enabler_as_enabler(trigger_enabler), excluder);
1485
1486 lttng_trigger_group_sync_enablers(trigger_enabler->group);
0bfb5cbd 1487 return 0;
e58095ef 1488}
f488575f 1489
e58095ef 1490int lttng_attach_context(struct lttng_ust_context *context_param,
8e696cfa 1491 union ust_args *uargs,
e58095ef
MD
1492 struct lttng_ctx **ctx, struct lttng_session *session)
1493{
457a6b58 1494 /*
e58095ef
MD
1495 * We cannot attach a context after trace has been started for a
1496 * session because the metadata does not allow expressing this
1497 * information outside of the original channel scope.
457a6b58 1498 */
e58095ef
MD
1499 if (session->been_active)
1500 return -EPERM;
457a6b58 1501
e58095ef
MD
1502 switch (context_param->ctx) {
1503 case LTTNG_UST_CONTEXT_PTHREAD_ID:
1504 return lttng_add_pthread_id_to_ctx(ctx);
d58d1454
MD
1505 case LTTNG_UST_CONTEXT_PERF_THREAD_COUNTER:
1506 {
1507 struct lttng_ust_perf_counter_ctx *perf_ctx_param;
1508
1509 perf_ctx_param = &context_param->u.perf_counter;
1510 return lttng_add_perf_counter_to_ctx(
1511 perf_ctx_param->type,
1512 perf_ctx_param->config,
1513 perf_ctx_param->name,
1514 ctx);
1515 }
e58095ef
MD
1516 case LTTNG_UST_CONTEXT_VTID:
1517 return lttng_add_vtid_to_ctx(ctx);
1518 case LTTNG_UST_CONTEXT_VPID:
1519 return lttng_add_vpid_to_ctx(ctx);
1520 case LTTNG_UST_CONTEXT_PROCNAME:
1521 return lttng_add_procname_to_ctx(ctx);
96f85541
MD
1522 case LTTNG_UST_CONTEXT_IP:
1523 return lttng_add_ip_to_ctx(ctx);
c7ea8487
MD
1524 case LTTNG_UST_CONTEXT_CPU_ID:
1525 return lttng_add_cpu_id_to_ctx(ctx);
8e696cfa
MD
1526 case LTTNG_UST_CONTEXT_APP_CONTEXT:
1527 return lttng_ust_add_app_context_to_ctx_rcu(uargs->app_context.ctxname,
1528 ctx);
735bef47
MJ
1529 case LTTNG_UST_CONTEXT_CGROUP_NS:
1530 return lttng_add_cgroup_ns_to_ctx(ctx);
1531 case LTTNG_UST_CONTEXT_IPC_NS:
1532 return lttng_add_ipc_ns_to_ctx(ctx);
1533 case LTTNG_UST_CONTEXT_MNT_NS:
1534 return lttng_add_mnt_ns_to_ctx(ctx);
1535 case LTTNG_UST_CONTEXT_NET_NS:
1536 return lttng_add_net_ns_to_ctx(ctx);
1537 case LTTNG_UST_CONTEXT_PID_NS:
1538 return lttng_add_pid_ns_to_ctx(ctx);
1539 case LTTNG_UST_CONTEXT_USER_NS:
1540 return lttng_add_user_ns_to_ctx(ctx);
1541 case LTTNG_UST_CONTEXT_UTS_NS:
1542 return lttng_add_uts_ns_to_ctx(ctx);
fca2f191
MJ
1543 case LTTNG_UST_CONTEXT_VUID:
1544 return lttng_add_vuid_to_ctx(ctx);
1545 case LTTNG_UST_CONTEXT_VEUID:
1546 return lttng_add_veuid_to_ctx(ctx);
1547 case LTTNG_UST_CONTEXT_VSUID:
1548 return lttng_add_vsuid_to_ctx(ctx);
1549 case LTTNG_UST_CONTEXT_VGID:
1550 return lttng_add_vgid_to_ctx(ctx);
1551 case LTTNG_UST_CONTEXT_VEGID:
1552 return lttng_add_vegid_to_ctx(ctx);
1553 case LTTNG_UST_CONTEXT_VSGID:
1554 return lttng_add_vsgid_to_ctx(ctx);
e58095ef
MD
1555 default:
1556 return -EINVAL;
457a6b58 1557 }
457a6b58
MD
1558}
1559
cb11f03a 1560int lttng_event_enabler_attach_context(struct lttng_event_enabler *enabler,
e58095ef 1561 struct lttng_ust_context *context_param)
457a6b58 1562{
e58095ef 1563 return -ENOSYS;
457a6b58
MD
1564}
1565
cb11f03a 1566void lttng_event_enabler_destroy(struct lttng_event_enabler *event_enabler)
457a6b58 1567{
cb11f03a
FD
1568 if (!event_enabler) {
1569 return;
0f63324a 1570 }
cb11f03a 1571 cds_list_del(&event_enabler->node);
0f63324a 1572
cb11f03a 1573 lttng_enabler_destroy(lttng_event_enabler_as_enabler(event_enabler));
e58095ef 1574
cb11f03a
FD
1575 lttng_destroy_context(event_enabler->ctx);
1576 free(event_enabler);
457a6b58
MD
1577}
1578
e58095ef 1579/*
cb11f03a 1580 * lttng_session_sync_event_enablers should be called just before starting a
e58095ef
MD
1581 * session.
1582 */
457a6b58 1583static
cb11f03a 1584void lttng_session_sync_event_enablers(struct lttng_session *session)
457a6b58 1585{
cb11f03a 1586 struct lttng_event_enabler *event_enabler;
e58095ef 1587 struct lttng_event *event;
457a6b58 1588
cb11f03a
FD
1589 cds_list_for_each_entry(event_enabler, &session->enablers_head, node)
1590 lttng_event_enabler_ref_events(event_enabler);
e58095ef
MD
1591 /*
1592 * For each event, if at least one of its enablers is enabled,
ac6b4ac6
MD
1593 * and its channel and session transient states are enabled, we
1594 * enable the event, else we disable it.
e58095ef
MD
1595 */
1596 cds_list_for_each_entry(event, &session->events_head, node) {
1597 struct lttng_enabler_ref *enabler_ref;
1598 struct lttng_bytecode_runtime *runtime;
dcdeaff0 1599 int enabled = 0, has_enablers_without_bytecode = 0;
e58095ef
MD
1600
1601 /* Enable events */
1602 cds_list_for_each_entry(enabler_ref,
1603 &event->enablers_ref_head, node) {
1604 if (enabler_ref->ref->enabled) {
1605 enabled = 1;
1606 break;
1607 }
1608 }
ac6b4ac6
MD
1609 /*
1610 * Enabled state is based on union of enablers, with
1611 * intesection of session and channel transient enable
1612 * states.
1613 */
1614 enabled = enabled && session->tstate && event->chan->tstate;
1615
1616 CMM_STORE_SHARED(event->enabled, enabled);
1617 /*
1618 * Sync tracepoint registration with event enabled
1619 * state.
1620 */
1621 if (enabled) {
1622 if (!event->registered)
1623 register_event(event);
1624 } else {
1625 if (event->registered)
1626 unregister_event(event);
1627 }
457a6b58 1628
1f49fc05 1629 /* Check if has enablers without bytecode enabled */
dcdeaff0
MD
1630 cds_list_for_each_entry(enabler_ref,
1631 &event->enablers_ref_head, node) {
1f49fc05
MD
1632 if (enabler_ref->ref->enabled
1633 && cds_list_empty(&enabler_ref->ref->filter_bytecode_head)) {
dcdeaff0
MD
1634 has_enablers_without_bytecode = 1;
1635 break;
1636 }
1637 }
1638 event->has_enablers_without_bytecode =
1639 has_enablers_without_bytecode;
1640
e58095ef
MD
1641 /* Enable filters */
1642 cds_list_for_each_entry(runtime,
cb11f03a
FD
1643 &event->filter_bytecode_runtime_head, node) {
1644 lttng_bytecode_filter_sync_state(runtime);
1645 }
1646 }
1647 __tracepoint_probe_prune_release_queue();
1648}
1649
1650static
1651void lttng_create_trigger_if_missing(struct lttng_trigger_enabler *trigger_enabler)
1652{
1653 struct lttng_trigger_group *trigger_group = trigger_enabler->group;
1654 struct lttng_probe_desc *probe_desc;
1655 struct cds_list_head *probe_list;
1656 int i;
1657
1658 probe_list = lttng_get_probe_list_head();
1659
1660 cds_list_for_each_entry(probe_desc, probe_list, head) {
1661 for (i = 0; i < probe_desc->nr_events; i++) {
1662 int ret;
1663 bool found = false;
1664 const struct lttng_event_desc *desc;
1665 struct lttng_trigger *trigger;
1666 struct cds_hlist_head *head;
1667 struct cds_hlist_node *node;
1668
1669 desc = probe_desc->event_desc[i];
1670
1671 if (!lttng_desc_match_enabler(desc,
1672 lttng_trigger_enabler_as_enabler(trigger_enabler)))
1673 continue;
1674
1675 /*
1676 * Given the current trigger group, get the bucket that
1677 * the target trigger would be if it was already
1678 * created.
1679 */
1680 head = borrow_hash_table_bucket(
1681 trigger_group->triggers_ht.table,
1682 LTTNG_UST_TRIGGER_HT_SIZE, desc);
1683
1684 cds_hlist_for_each_entry(trigger, node, head, hlist) {
1685 /*
1686 * Check if trigger already exists by checking
1687 * if the trigger and enabler share the same
1688 * description and id.
1689 */
1690 if (trigger->desc == desc &&
1691 trigger->id == trigger_enabler->id) {
1692 found = true;
1693 break;
1694 }
1695 }
1696
1697 if (found)
1698 continue;
1699
1700 /*
1701 * We need to create a trigger for this event probe.
1702 */
1703 ret = lttng_trigger_create(desc, trigger_enabler->id,
1704 trigger_group);
1705 if (ret) {
1706 DBG("Unable to create trigger %s, error %d\n",
1707 probe_desc->event_desc[i]->name, ret);
1708 }
1709 }
1710 }
1711}
1712
1713/*
1714 * Create triggers associated with a trigger enabler (if not already present).
1715 */
1716static
1717int lttng_trigger_enabler_ref_triggers(struct lttng_trigger_enabler *trigger_enabler)
1718{
1719 struct lttng_trigger_group *trigger_group = trigger_enabler->group;
1720 struct lttng_trigger *trigger;
1721
1722 /*
1723 * Only try to create triggers for enablers that are enabled, the user
1724 * might still be attaching filter or exclusion to the
1725 * trigger_enabler.
1726 */
1727 if (!lttng_trigger_enabler_as_enabler(trigger_enabler)->enabled)
1728 goto end;
1729
1730 /* First, ensure that probe triggers are created for this enabler. */
1731 lttng_create_trigger_if_missing(trigger_enabler);
1732
1733 /* Link the created trigger with its associated enabler. */
1734 cds_list_for_each_entry(trigger, &trigger_group->triggers_head, node) {
1735 struct lttng_enabler_ref *enabler_ref;
1736
1737 if (!lttng_trigger_enabler_match_trigger(trigger_enabler, trigger))
1738 continue;
1739
1740 enabler_ref = lttng_enabler_ref(&trigger->enablers_ref_head,
1741 lttng_trigger_enabler_as_enabler(trigger_enabler));
1742 if (!enabler_ref) {
1743 /*
1744 * If no backward ref, create it.
1745 * Add backward ref from trigger to enabler.
1746 */
1747 enabler_ref = zmalloc(sizeof(*enabler_ref));
1748 if (!enabler_ref)
1749 return -ENOMEM;
1750
1751 enabler_ref->ref = lttng_trigger_enabler_as_enabler(
1752 trigger_enabler);
1753 cds_list_add(&enabler_ref->node,
1754 &trigger->enablers_ref_head);
1755 }
1756
1757 /*
1758 * Link filter bytecodes if not linked yet.
1759 */
1760 lttng_enabler_link_bytecode(trigger->desc,
1761 &trigger_group->ctx, &trigger->filter_bytecode_runtime_head,
1762 &lttng_trigger_enabler_as_enabler(trigger_enabler)->filter_bytecode_head);
1763
1764 /*
1765 * Link capture bytecodes if not linked yet.
1766 */
1767 lttng_enabler_link_bytecode(trigger->desc,
1768 &trigger_group->ctx, &trigger->capture_bytecode_runtime_head,
1769 &trigger_enabler->capture_bytecode_head);
1770 trigger->num_captures = trigger_enabler->num_captures;
1771 }
1772end:
1773 return 0;
1774}
1775
1776static
1777void lttng_trigger_group_sync_enablers(struct lttng_trigger_group *trigger_group)
1778{
1779 struct lttng_trigger_enabler *trigger_enabler;
1780 struct lttng_trigger *trigger;
1781
1782 cds_list_for_each_entry(trigger_enabler, &trigger_group->enablers_head, node)
1783 lttng_trigger_enabler_ref_triggers(trigger_enabler);
1784
1785 /*
1786 * For each trigger, if at least one of its enablers is enabled,
1787 * we enable the trigger, else we disable it.
1788 */
1789 cds_list_for_each_entry(trigger, &trigger_group->triggers_head, node) {
1790 struct lttng_enabler_ref *enabler_ref;
1791 struct lttng_bytecode_runtime *runtime;
1792 int enabled = 0, has_enablers_without_bytecode = 0;
1793
1794 /* Enable triggers */
1795 cds_list_for_each_entry(enabler_ref,
1796 &trigger->enablers_ref_head, node) {
1797 if (enabler_ref->ref->enabled) {
1798 enabled = 1;
1799 break;
1800 }
1801 }
1802
1803 CMM_STORE_SHARED(trigger->enabled, enabled);
1804 /*
1805 * Sync tracepoint registration with trigger enabled
1806 * state.
1807 */
1808 if (enabled) {
1809 if (!trigger->registered)
1810 register_trigger(trigger);
1811 } else {
1812 if (trigger->registered)
1813 unregister_trigger(trigger);
1814 }
1815
1816 /* Check if has enablers without bytecode enabled */
1817 cds_list_for_each_entry(enabler_ref,
1818 &trigger->enablers_ref_head, node) {
1819 if (enabler_ref->ref->enabled
1820 && cds_list_empty(&enabler_ref->ref->filter_bytecode_head)) {
1821 has_enablers_without_bytecode = 1;
1822 break;
1823 }
1824 }
1825 trigger->has_enablers_without_bytecode =
1826 has_enablers_without_bytecode;
1827
1828 /* Enable filters */
1829 cds_list_for_each_entry(runtime,
1830 &trigger->filter_bytecode_runtime_head, node) {
1831 lttng_bytecode_filter_sync_state(runtime);
1832 }
1833
1834 /* Enable captures. */
1835 cds_list_for_each_entry(runtime,
1836 &trigger->capture_bytecode_runtime_head, node) {
1837 lttng_bytecode_capture_sync_state(runtime);
457a6b58
MD
1838 }
1839 }
baa1e0bc 1840 __tracepoint_probe_prune_release_queue();
457a6b58
MD
1841}
1842
e58095ef
MD
1843/*
1844 * Apply enablers to session events, adding events to session if need
1845 * be. It is required after each modification applied to an active
1846 * session, and right before session "start".
1847 * "lazy" sync means we only sync if required.
1848 */
1849static
cb11f03a 1850void lttng_session_lazy_sync_event_enablers(struct lttng_session *session)
457a6b58 1851{
e58095ef
MD
1852 /* We can skip if session is not active */
1853 if (!session->active)
1854 return;
cb11f03a 1855 lttng_session_sync_event_enablers(session);
457a6b58 1856}
53569322
MD
1857
1858/*
1859 * Update all sessions with the given app context.
1860 * Called with ust lock held.
1861 * This is invoked when an application context gets loaded/unloaded. It
1862 * ensures the context callbacks are in sync with the application
1863 * context (either app context callbacks, or dummy callbacks).
1864 */
1865void lttng_ust_context_set_session_provider(const char *name,
1866 size_t (*get_size)(struct lttng_ctx_field *field, size_t offset),
1867 void (*record)(struct lttng_ctx_field *field,
1868 struct lttng_ust_lib_ring_buffer_ctx *ctx,
1869 struct lttng_channel *chan),
1870 void (*get_value)(struct lttng_ctx_field *field,
1871 struct lttng_ctx_value *value))
1872{
1873 struct lttng_session *session;
1874
1875 cds_list_for_each_entry(session, &sessions, node) {
1876 struct lttng_channel *chan;
1877 struct lttng_event *event;
1878 int ret;
1879
1880 ret = lttng_ust_context_set_provider_rcu(&session->ctx,
1881 name, get_size, record, get_value);
1882 if (ret)
1883 abort();
1884 cds_list_for_each_entry(chan, &session->chan_head, node) {
1885 ret = lttng_ust_context_set_provider_rcu(&chan->ctx,
1886 name, get_size, record, get_value);
1887 if (ret)
1888 abort();
1889 }
1890 cds_list_for_each_entry(event, &session->events_head, node) {
1891 ret = lttng_ust_context_set_provider_rcu(&event->ctx,
1892 name, get_size, record, get_value);
1893 if (ret)
1894 abort();
1895 }
1896 }
1897}
cb11f03a
FD
1898
1899/*
1900 * Update all trigger groups with the given app context.
1901 * Called with ust lock held.
1902 * This is invoked when an application context gets loaded/unloaded. It
1903 * ensures the context callbacks are in sync with the application
1904 * context (either app context callbacks, or dummy callbacks).
1905 */
1906void lttng_ust_context_set_trigger_group_provider(const char *name,
1907 size_t (*get_size)(struct lttng_ctx_field *field, size_t offset),
1908 void (*record)(struct lttng_ctx_field *field,
1909 struct lttng_ust_lib_ring_buffer_ctx *ctx,
1910 struct lttng_channel *chan),
1911 void (*get_value)(struct lttng_ctx_field *field,
1912 struct lttng_ctx_value *value))
1913{
1914 struct lttng_trigger_group *trigger_group;
1915
1916 cds_list_for_each_entry(trigger_group, &trigger_groups, node) {
1917 int ret;
1918
1919 ret = lttng_ust_context_set_provider_rcu(&trigger_group->ctx,
1920 name, get_size, record, get_value);
1921 if (ret)
1922 abort();
1923 }
1924}
This page took 0.138448 seconds and 5 git commands to generate.