fix: isystem: delete global -isystem compile option (v5.16)
[lttng-modules.git] / src / lttng-events.c
1 /* SPDX-License-Identifier: (GPL-2.0-only or LGPL-2.1-only)
2 *
3 * lttng-events.c
4 *
5 * Holds LTTng per-session event registry.
6 *
7 * Copyright (C) 2010-2012 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
8 */
9
10 /*
11 * This page_alloc.h wrapper needs to be included before gfpflags.h because it
12 * overrides a function with a define.
13 */
14 #include "wrapper/page_alloc.h"
15
16 #include <linux/module.h>
17 #include <linux/mutex.h>
18 #include <linux/sched.h>
19 #include <linux/slab.h>
20 #include <linux/jiffies.h>
21 #include <linux/utsname.h>
22 #include <linux/err.h>
23 #include <linux/seq_file.h>
24 #include <linux/file.h>
25 #include <linux/anon_inodes.h>
26 #include <wrapper/file.h>
27 #include <linux/uaccess.h>
28 #include <linux/vmalloc.h>
29 #include <linux/dmi.h>
30
31 #include <wrapper/compiler_attributes.h>
32 #include <wrapper/uuid.h>
33 #include <wrapper/vmalloc.h> /* for wrapper_vmalloc_sync_mappings() */
34 #include <wrapper/random.h>
35 #include <wrapper/tracepoint.h>
36 #include <wrapper/list.h>
37 #include <wrapper/types.h>
38 #include <lttng/kernel-version.h>
39 #include <lttng/events.h>
40 #include <lttng/events-internal.h>
41 #include <lttng/lttng-bytecode.h>
42 #include <lttng/tracer.h>
43 #include <lttng/event-notifier-notification.h>
44 #include <lttng/abi-old.h>
45 #include <lttng/endian.h>
46 #include <lttng/string-utils.h>
47 #include <lttng/utils.h>
48 #include <ringbuffer/backend.h>
49 #include <ringbuffer/frontend.h>
50 #include <wrapper/time.h>
51
52 #if (LTTNG_LINUX_VERSION_CODE >= LTTNG_KERNEL_VERSION(5,16,0))
53 #include <linux/stdarg.h>
54 #else
55 #include <stdarg.h>
56 #endif
57
58 #define METADATA_CACHE_DEFAULT_SIZE 4096
59
60 static LIST_HEAD(sessions);
61 static LIST_HEAD(event_notifier_groups);
62 static LIST_HEAD(lttng_transport_list);
63 static LIST_HEAD(lttng_counter_transport_list);
64 /*
65 * Protect the sessions and metadata caches.
66 */
67 static DEFINE_MUTEX(sessions_mutex);
68 static struct kmem_cache *event_recorder_cache;
69 static struct kmem_cache *event_recorder_private_cache;
70 static struct kmem_cache *event_notifier_cache;
71 static struct kmem_cache *event_notifier_private_cache;
72
73 static void lttng_session_lazy_sync_event_enablers(struct lttng_kernel_session *session);
74 static void lttng_session_sync_event_enablers(struct lttng_kernel_session *session);
75 static void lttng_event_enabler_destroy(struct lttng_event_enabler *event_enabler);
76 static void lttng_event_notifier_enabler_destroy(struct lttng_event_notifier_enabler *event_notifier_enabler);
77 static void lttng_event_notifier_group_sync_enablers(struct lttng_event_notifier_group *event_notifier_group);
78
79 static void _lttng_event_destroy(struct lttng_kernel_event_common *event);
80 static void _lttng_channel_destroy(struct lttng_kernel_channel_buffer *chan);
81 static void _lttng_event_unregister(struct lttng_kernel_event_recorder *event);
82 static void _lttng_event_notifier_unregister(struct lttng_kernel_event_notifier *event_notifier);
83 static
84 int _lttng_event_metadata_statedump(struct lttng_kernel_session *session,
85 struct lttng_kernel_channel_buffer *chan,
86 struct lttng_kernel_event_recorder *event);
87 static
88 int _lttng_session_metadata_statedump(struct lttng_kernel_session *session);
89 static
90 void _lttng_metadata_channel_hangup(struct lttng_metadata_stream *stream);
91 static
92 int _lttng_type_statedump(struct lttng_kernel_session *session,
93 const struct lttng_kernel_type_common *type,
94 enum lttng_kernel_string_encoding parent_encoding,
95 size_t nesting);
96 static
97 int _lttng_field_statedump(struct lttng_kernel_session *session,
98 const struct lttng_kernel_event_field *field,
99 size_t nesting, const char **prev_field_name_p);
100
101 void synchronize_trace(void)
102 {
103 #if (LTTNG_LINUX_VERSION_CODE >= LTTNG_KERNEL_VERSION(5,1,0) || \
104 LTTNG_RHEL_KERNEL_RANGE(4,18,0,193,0,0, 4,19,0,0,0,0))
105 synchronize_rcu();
106 #else
107 synchronize_sched();
108 #endif
109
110 #if (LTTNG_LINUX_VERSION_CODE >= LTTNG_KERNEL_VERSION(3,4,0))
111 #ifdef CONFIG_PREEMPT_RT_FULL
112 synchronize_rcu();
113 #endif
114 #else /* (LTTNG_LINUX_VERSION_CODE >= LTTNG_KERNEL_VERSION(3,4,0)) */
115 #ifdef CONFIG_PREEMPT_RT
116 synchronize_rcu();
117 #endif
118 #endif /* (LTTNG_LINUX_VERSION_CODE >= LTTNG_KERNEL_VERSION(3,4,0)) */
119 }
120
121 void lttng_lock_sessions(void)
122 {
123 mutex_lock(&sessions_mutex);
124 }
125
126 void lttng_unlock_sessions(void)
127 {
128 mutex_unlock(&sessions_mutex);
129 }
130
131 static struct lttng_transport *lttng_transport_find(const char *name)
132 {
133 struct lttng_transport *transport;
134
135 list_for_each_entry(transport, &lttng_transport_list, node) {
136 if (!strcmp(transport->name, name))
137 return transport;
138 }
139 return NULL;
140 }
141
142 /*
143 * Called with sessions lock held.
144 */
145 int lttng_session_active(void)
146 {
147 struct lttng_kernel_session_private *iter;
148
149 list_for_each_entry(iter, &sessions, list) {
150 if (iter->pub->active)
151 return 1;
152 }
153 return 0;
154 }
155
156 struct lttng_kernel_session *lttng_session_create(void)
157 {
158 struct lttng_kernel_session *session;
159 struct lttng_kernel_session_private *session_priv;
160 struct lttng_metadata_cache *metadata_cache;
161 int i;
162
163 mutex_lock(&sessions_mutex);
164 session = lttng_kvzalloc(sizeof(*session), GFP_KERNEL);
165 if (!session)
166 goto err;
167 session_priv = lttng_kvzalloc(sizeof(*session_priv), GFP_KERNEL);
168 if (!session_priv)
169 goto err_free_session;
170 session->priv = session_priv;
171 session_priv->pub = session;
172
173 INIT_LIST_HEAD(&session_priv->chan);
174 INIT_LIST_HEAD(&session_priv->events);
175 lttng_guid_gen(&session_priv->uuid);
176
177 metadata_cache = kzalloc(sizeof(struct lttng_metadata_cache),
178 GFP_KERNEL);
179 if (!metadata_cache)
180 goto err_free_session_private;
181 metadata_cache->data = vzalloc(METADATA_CACHE_DEFAULT_SIZE);
182 if (!metadata_cache->data)
183 goto err_free_cache;
184 metadata_cache->cache_alloc = METADATA_CACHE_DEFAULT_SIZE;
185 kref_init(&metadata_cache->refcount);
186 mutex_init(&metadata_cache->lock);
187 session_priv->metadata_cache = metadata_cache;
188 INIT_LIST_HEAD(&metadata_cache->metadata_stream);
189 memcpy(&metadata_cache->uuid, &session_priv->uuid,
190 sizeof(metadata_cache->uuid));
191 INIT_LIST_HEAD(&session_priv->enablers_head);
192 for (i = 0; i < LTTNG_EVENT_HT_SIZE; i++)
193 INIT_HLIST_HEAD(&session_priv->events_ht.table[i]);
194 list_add(&session_priv->list, &sessions);
195
196 if (lttng_id_tracker_init(&session->pid_tracker, session, TRACKER_PID))
197 goto tracker_alloc_error;
198 if (lttng_id_tracker_init(&session->vpid_tracker, session, TRACKER_VPID))
199 goto tracker_alloc_error;
200 if (lttng_id_tracker_init(&session->uid_tracker, session, TRACKER_UID))
201 goto tracker_alloc_error;
202 if (lttng_id_tracker_init(&session->vuid_tracker, session, TRACKER_VUID))
203 goto tracker_alloc_error;
204 if (lttng_id_tracker_init(&session->gid_tracker, session, TRACKER_GID))
205 goto tracker_alloc_error;
206 if (lttng_id_tracker_init(&session->vgid_tracker, session, TRACKER_VGID))
207 goto tracker_alloc_error;
208
209 mutex_unlock(&sessions_mutex);
210
211 return session;
212
213 tracker_alloc_error:
214 lttng_id_tracker_fini(&session->pid_tracker);
215 lttng_id_tracker_fini(&session->vpid_tracker);
216 lttng_id_tracker_fini(&session->uid_tracker);
217 lttng_id_tracker_fini(&session->vuid_tracker);
218 lttng_id_tracker_fini(&session->gid_tracker);
219 lttng_id_tracker_fini(&session->vgid_tracker);
220 err_free_cache:
221 kfree(metadata_cache);
222 err_free_session_private:
223 lttng_kvfree(session_priv);
224 err_free_session:
225 lttng_kvfree(session);
226 err:
227 mutex_unlock(&sessions_mutex);
228 return NULL;
229 }
230
231 static
232 struct lttng_counter_transport *lttng_counter_transport_find(const char *name)
233 {
234 struct lttng_counter_transport *transport;
235
236 list_for_each_entry(transport, &lttng_counter_transport_list, node) {
237 if (!strcmp(transport->name, name))
238 return transport;
239 }
240 return NULL;
241 }
242
243 struct lttng_counter *lttng_kernel_counter_create(
244 const char *counter_transport_name,
245 size_t number_dimensions, const size_t *dimensions_sizes)
246 {
247 struct lttng_counter *counter = NULL;
248 struct lttng_counter_transport *counter_transport = NULL;
249
250 counter_transport = lttng_counter_transport_find(counter_transport_name);
251 if (!counter_transport) {
252 printk(KERN_WARNING "LTTng: counter transport %s not found.\n",
253 counter_transport_name);
254 goto notransport;
255 }
256 if (!try_module_get(counter_transport->owner)) {
257 printk(KERN_WARNING "LTTng: Can't lock counter transport module.\n");
258 goto notransport;
259 }
260
261 counter = lttng_kvzalloc(sizeof(struct lttng_counter), GFP_KERNEL);
262 if (!counter)
263 goto nomem;
264
265 /* Create event notifier error counter. */
266 counter->ops = &counter_transport->ops;
267 counter->transport = counter_transport;
268
269 counter->counter = counter->ops->counter_create(
270 number_dimensions, dimensions_sizes, 0);
271 if (!counter->counter) {
272 goto create_error;
273 }
274
275 return counter;
276
277 create_error:
278 lttng_kvfree(counter);
279 nomem:
280 if (counter_transport)
281 module_put(counter_transport->owner);
282 notransport:
283 return NULL;
284 }
285
286 struct lttng_event_notifier_group *lttng_event_notifier_group_create(void)
287 {
288 struct lttng_transport *transport = NULL;
289 struct lttng_event_notifier_group *event_notifier_group;
290 const char *transport_name = "relay-event-notifier";
291 size_t subbuf_size = 4096; //TODO
292 size_t num_subbuf = 16; //TODO
293 unsigned int switch_timer_interval = 0;
294 unsigned int read_timer_interval = 0;
295 int i;
296
297 mutex_lock(&sessions_mutex);
298
299 transport = lttng_transport_find(transport_name);
300 if (!transport) {
301 printk(KERN_WARNING "LTTng: transport %s not found\n",
302 transport_name);
303 goto notransport;
304 }
305 if (!try_module_get(transport->owner)) {
306 printk(KERN_WARNING "LTTng: Can't lock transport %s module.\n",
307 transport_name);
308 goto notransport;
309 }
310
311 event_notifier_group = lttng_kvzalloc(sizeof(struct lttng_event_notifier_group),
312 GFP_KERNEL);
313 if (!event_notifier_group)
314 goto nomem;
315
316 /*
317 * Initialize the ring buffer used to store event notifier
318 * notifications.
319 */
320 event_notifier_group->ops = &transport->ops;
321 event_notifier_group->chan = transport->ops.priv->channel_create(
322 transport_name, event_notifier_group, NULL,
323 subbuf_size, num_subbuf, switch_timer_interval,
324 read_timer_interval);
325 if (!event_notifier_group->chan)
326 goto create_error;
327
328 event_notifier_group->transport = transport;
329
330 INIT_LIST_HEAD(&event_notifier_group->enablers_head);
331 INIT_LIST_HEAD(&event_notifier_group->event_notifiers_head);
332 for (i = 0; i < LTTNG_EVENT_NOTIFIER_HT_SIZE; i++)
333 INIT_HLIST_HEAD(&event_notifier_group->event_notifiers_ht.table[i]);
334
335 list_add(&event_notifier_group->node, &event_notifier_groups);
336
337 mutex_unlock(&sessions_mutex);
338
339 return event_notifier_group;
340
341 create_error:
342 lttng_kvfree(event_notifier_group);
343 nomem:
344 if (transport)
345 module_put(transport->owner);
346 notransport:
347 mutex_unlock(&sessions_mutex);
348 return NULL;
349 }
350
351 void metadata_cache_destroy(struct kref *kref)
352 {
353 struct lttng_metadata_cache *cache =
354 container_of(kref, struct lttng_metadata_cache, refcount);
355 vfree(cache->data);
356 kfree(cache);
357 }
358
359 void lttng_session_destroy(struct lttng_kernel_session *session)
360 {
361 struct lttng_kernel_channel_buffer_private *chan_priv, *tmpchan_priv;
362 struct lttng_kernel_event_recorder_private *event_recorder_priv, *tmpevent_recorder_priv;
363 struct lttng_metadata_stream *metadata_stream;
364 struct lttng_event_enabler *event_enabler, *tmp_event_enabler;
365 int ret;
366
367 mutex_lock(&sessions_mutex);
368 WRITE_ONCE(session->active, 0);
369 list_for_each_entry(chan_priv, &session->priv->chan, node) {
370 ret = lttng_syscalls_unregister_channel(chan_priv->pub);
371 WARN_ON(ret);
372 }
373 list_for_each_entry(event_recorder_priv, &session->priv->events, node)
374 _lttng_event_unregister(event_recorder_priv->pub);
375 synchronize_trace(); /* Wait for in-flight events to complete */
376 list_for_each_entry(chan_priv, &session->priv->chan, node) {
377 ret = lttng_syscalls_destroy_event(chan_priv->pub);
378 WARN_ON(ret);
379 }
380 list_for_each_entry_safe(event_enabler, tmp_event_enabler,
381 &session->priv->enablers_head, node)
382 lttng_event_enabler_destroy(event_enabler);
383 list_for_each_entry_safe(event_recorder_priv, tmpevent_recorder_priv, &session->priv->events, node)
384 _lttng_event_destroy(&event_recorder_priv->pub->parent);
385 list_for_each_entry_safe(chan_priv, tmpchan_priv, &session->priv->chan, node) {
386 BUG_ON(chan_priv->channel_type == METADATA_CHANNEL);
387 _lttng_channel_destroy(chan_priv->pub);
388 }
389 mutex_lock(&session->priv->metadata_cache->lock);
390 list_for_each_entry(metadata_stream, &session->priv->metadata_cache->metadata_stream, list)
391 _lttng_metadata_channel_hangup(metadata_stream);
392 mutex_unlock(&session->priv->metadata_cache->lock);
393 lttng_id_tracker_fini(&session->pid_tracker);
394 lttng_id_tracker_fini(&session->vpid_tracker);
395 lttng_id_tracker_fini(&session->uid_tracker);
396 lttng_id_tracker_fini(&session->vuid_tracker);
397 lttng_id_tracker_fini(&session->gid_tracker);
398 lttng_id_tracker_fini(&session->vgid_tracker);
399 kref_put(&session->priv->metadata_cache->refcount, metadata_cache_destroy);
400 list_del(&session->priv->list);
401 mutex_unlock(&sessions_mutex);
402 lttng_kvfree(session->priv);
403 lttng_kvfree(session);
404 }
405
406 void lttng_event_notifier_group_destroy(
407 struct lttng_event_notifier_group *event_notifier_group)
408 {
409 struct lttng_event_notifier_enabler *event_notifier_enabler, *tmp_event_notifier_enabler;
410 struct lttng_kernel_event_notifier_private *event_notifier_priv, *tmpevent_notifier_priv;
411 int ret;
412
413 if (!event_notifier_group)
414 return;
415
416 mutex_lock(&sessions_mutex);
417
418 ret = lttng_syscalls_unregister_event_notifier_group(event_notifier_group);
419 WARN_ON(ret);
420
421 list_for_each_entry_safe(event_notifier_priv, tmpevent_notifier_priv,
422 &event_notifier_group->event_notifiers_head, node)
423 _lttng_event_notifier_unregister(event_notifier_priv->pub);
424
425 /* Wait for in-flight event notifier to complete */
426 synchronize_trace();
427
428 irq_work_sync(&event_notifier_group->wakeup_pending);
429
430 kfree(event_notifier_group->sc_filter);
431
432 list_for_each_entry_safe(event_notifier_enabler, tmp_event_notifier_enabler,
433 &event_notifier_group->enablers_head, node)
434 lttng_event_notifier_enabler_destroy(event_notifier_enabler);
435
436 list_for_each_entry_safe(event_notifier_priv, tmpevent_notifier_priv,
437 &event_notifier_group->event_notifiers_head, node)
438 _lttng_event_destroy(&event_notifier_priv->pub->parent);
439
440 if (event_notifier_group->error_counter) {
441 struct lttng_counter *error_counter = event_notifier_group->error_counter;
442
443 error_counter->ops->counter_destroy(error_counter->counter);
444 module_put(error_counter->transport->owner);
445 lttng_kvfree(error_counter);
446 event_notifier_group->error_counter = NULL;
447 }
448
449 event_notifier_group->ops->priv->channel_destroy(event_notifier_group->chan);
450 module_put(event_notifier_group->transport->owner);
451 list_del(&event_notifier_group->node);
452
453 mutex_unlock(&sessions_mutex);
454 lttng_kvfree(event_notifier_group);
455 }
456
457 int lttng_session_statedump(struct lttng_kernel_session *session)
458 {
459 int ret;
460
461 mutex_lock(&sessions_mutex);
462 ret = lttng_statedump_start(session);
463 mutex_unlock(&sessions_mutex);
464 return ret;
465 }
466
467 int lttng_session_enable(struct lttng_kernel_session *session)
468 {
469 int ret = 0;
470 struct lttng_kernel_channel_buffer_private *chan_priv;
471
472 mutex_lock(&sessions_mutex);
473 if (session->active) {
474 ret = -EBUSY;
475 goto end;
476 }
477
478 /* Set transient enabler state to "enabled" */
479 session->priv->tstate = 1;
480
481 /* We need to sync enablers with session before activation. */
482 lttng_session_sync_event_enablers(session);
483
484 /*
485 * Snapshot the number of events per channel to know the type of header
486 * we need to use.
487 */
488 list_for_each_entry(chan_priv, &session->priv->chan, node) {
489 if (chan_priv->header_type)
490 continue; /* don't change it if session stop/restart */
491 if (chan_priv->free_event_id < 31)
492 chan_priv->header_type = 1; /* compact */
493 else
494 chan_priv->header_type = 2; /* large */
495 }
496
497 /* Clear each stream's quiescent state. */
498 list_for_each_entry(chan_priv, &session->priv->chan, node) {
499 if (chan_priv->channel_type != METADATA_CHANNEL)
500 lib_ring_buffer_clear_quiescent_channel(chan_priv->rb_chan);
501 }
502
503 WRITE_ONCE(session->active, 1);
504 WRITE_ONCE(session->priv->been_active, 1);
505 ret = _lttng_session_metadata_statedump(session);
506 if (ret) {
507 WRITE_ONCE(session->active, 0);
508 goto end;
509 }
510 ret = lttng_statedump_start(session);
511 if (ret)
512 WRITE_ONCE(session->active, 0);
513 end:
514 mutex_unlock(&sessions_mutex);
515 return ret;
516 }
517
518 int lttng_session_disable(struct lttng_kernel_session *session)
519 {
520 int ret = 0;
521 struct lttng_kernel_channel_buffer_private *chan_priv;
522
523 mutex_lock(&sessions_mutex);
524 if (!session->active) {
525 ret = -EBUSY;
526 goto end;
527 }
528 WRITE_ONCE(session->active, 0);
529
530 /* Set transient enabler state to "disabled" */
531 session->priv->tstate = 0;
532 lttng_session_sync_event_enablers(session);
533
534 /* Set each stream's quiescent state. */
535 list_for_each_entry(chan_priv, &session->priv->chan, node) {
536 if (chan_priv->channel_type != METADATA_CHANNEL)
537 lib_ring_buffer_set_quiescent_channel(chan_priv->rb_chan);
538 }
539 end:
540 mutex_unlock(&sessions_mutex);
541 return ret;
542 }
543
544 int lttng_session_metadata_regenerate(struct lttng_kernel_session *session)
545 {
546 int ret = 0;
547 struct lttng_kernel_channel_buffer_private *chan_priv;
548 struct lttng_kernel_event_recorder_private *event_recorder_priv;
549 struct lttng_metadata_cache *cache = session->priv->metadata_cache;
550 struct lttng_metadata_stream *stream;
551
552 mutex_lock(&sessions_mutex);
553 if (!session->active) {
554 ret = -EBUSY;
555 goto end;
556 }
557
558 mutex_lock(&cache->lock);
559 memset(cache->data, 0, cache->cache_alloc);
560 cache->metadata_written = 0;
561 cache->version++;
562 list_for_each_entry(stream, &session->priv->metadata_cache->metadata_stream, list) {
563 stream->metadata_out = 0;
564 stream->metadata_in = 0;
565 }
566 mutex_unlock(&cache->lock);
567
568 session->priv->metadata_dumped = 0;
569 list_for_each_entry(chan_priv, &session->priv->chan, node) {
570 chan_priv->metadata_dumped = 0;
571 }
572
573 list_for_each_entry(event_recorder_priv, &session->priv->events, node) {
574 event_recorder_priv->metadata_dumped = 0;
575 }
576
577 ret = _lttng_session_metadata_statedump(session);
578
579 end:
580 mutex_unlock(&sessions_mutex);
581 return ret;
582 }
583
584 int lttng_channel_enable(struct lttng_kernel_channel_buffer *channel)
585 {
586 int ret = 0;
587
588 mutex_lock(&sessions_mutex);
589 if (channel->priv->channel_type == METADATA_CHANNEL) {
590 ret = -EPERM;
591 goto end;
592 }
593 if (channel->parent.enabled) {
594 ret = -EEXIST;
595 goto end;
596 }
597 /* Set transient enabler state to "enabled" */
598 channel->priv->parent.tstate = 1;
599 lttng_session_sync_event_enablers(channel->parent.session);
600 /* Set atomically the state to "enabled" */
601 WRITE_ONCE(channel->parent.enabled, 1);
602 end:
603 mutex_unlock(&sessions_mutex);
604 return ret;
605 }
606
607 int lttng_channel_disable(struct lttng_kernel_channel_buffer *channel)
608 {
609 int ret = 0;
610
611 mutex_lock(&sessions_mutex);
612 if (channel->priv->channel_type == METADATA_CHANNEL) {
613 ret = -EPERM;
614 goto end;
615 }
616 if (!channel->parent.enabled) {
617 ret = -EEXIST;
618 goto end;
619 }
620 /* Set atomically the state to "disabled" */
621 WRITE_ONCE(channel->parent.enabled, 0);
622 /* Set transient enabler state to "enabled" */
623 channel->priv->parent.tstate = 0;
624 lttng_session_sync_event_enablers(channel->parent.session);
625 end:
626 mutex_unlock(&sessions_mutex);
627 return ret;
628 }
629
630 int lttng_event_enable(struct lttng_kernel_event_common *event)
631 {
632 int ret = 0;
633
634 mutex_lock(&sessions_mutex);
635 switch (event->type) {
636 case LTTNG_KERNEL_EVENT_TYPE_RECORDER:
637 {
638 struct lttng_kernel_event_recorder *event_recorder =
639 container_of(event, struct lttng_kernel_event_recorder, parent);
640
641 if (event_recorder->chan->priv->channel_type == METADATA_CHANNEL) {
642 ret = -EPERM;
643 goto end;
644 }
645 break;
646 }
647 case LTTNG_KERNEL_EVENT_TYPE_NOTIFIER:
648 switch (event->priv->instrumentation) {
649 case LTTNG_KERNEL_ABI_KRETPROBE:
650 ret = -EINVAL;
651 goto end;
652 default:
653 break;
654 }
655 break;
656 default:
657 break;
658 }
659
660 if (event->enabled) {
661 ret = -EEXIST;
662 goto end;
663 }
664 switch (event->priv->instrumentation) {
665 case LTTNG_KERNEL_ABI_TRACEPOINT:
666 lttng_fallthrough;
667 case LTTNG_KERNEL_ABI_SYSCALL:
668 ret = -EINVAL;
669 break;
670
671 case LTTNG_KERNEL_ABI_KPROBE:
672 lttng_fallthrough;
673 case LTTNG_KERNEL_ABI_UPROBE:
674 WRITE_ONCE(event->enabled, 1);
675 break;
676
677 case LTTNG_KERNEL_ABI_KRETPROBE:
678 ret = lttng_kretprobes_event_enable_state(event, 1);
679 break;
680
681 case LTTNG_KERNEL_ABI_FUNCTION:
682 lttng_fallthrough;
683 case LTTNG_KERNEL_ABI_NOOP:
684 lttng_fallthrough;
685 default:
686 WARN_ON_ONCE(1);
687 ret = -EINVAL;
688 }
689 end:
690 mutex_unlock(&sessions_mutex);
691 return ret;
692 }
693
694 int lttng_event_disable(struct lttng_kernel_event_common *event)
695 {
696 int ret = 0;
697
698 mutex_lock(&sessions_mutex);
699 switch (event->type) {
700 case LTTNG_KERNEL_EVENT_TYPE_RECORDER:
701 {
702 struct lttng_kernel_event_recorder *event_recorder =
703 container_of(event, struct lttng_kernel_event_recorder, parent);
704
705 if (event_recorder->chan->priv->channel_type == METADATA_CHANNEL) {
706 ret = -EPERM;
707 goto end;
708 }
709 break;
710 }
711 case LTTNG_KERNEL_EVENT_TYPE_NOTIFIER:
712 switch (event->priv->instrumentation) {
713 case LTTNG_KERNEL_ABI_KRETPROBE:
714 ret = -EINVAL;
715 goto end;
716 default:
717 break;
718 }
719 break;
720 default:
721 break;
722 }
723
724 if (!event->enabled) {
725 ret = -EEXIST;
726 goto end;
727 }
728 switch (event->priv->instrumentation) {
729 case LTTNG_KERNEL_ABI_TRACEPOINT:
730 lttng_fallthrough;
731 case LTTNG_KERNEL_ABI_SYSCALL:
732 ret = -EINVAL;
733 break;
734
735 case LTTNG_KERNEL_ABI_KPROBE:
736 lttng_fallthrough;
737 case LTTNG_KERNEL_ABI_UPROBE:
738 WRITE_ONCE(event->enabled, 0);
739 break;
740
741 case LTTNG_KERNEL_ABI_KRETPROBE:
742 ret = lttng_kretprobes_event_enable_state(event, 0);
743 break;
744
745 case LTTNG_KERNEL_ABI_FUNCTION:
746 lttng_fallthrough;
747 case LTTNG_KERNEL_ABI_NOOP:
748 lttng_fallthrough;
749 default:
750 WARN_ON_ONCE(1);
751 ret = -EINVAL;
752 }
753 end:
754 mutex_unlock(&sessions_mutex);
755 return ret;
756 }
757
758 struct lttng_kernel_channel_buffer *lttng_channel_create(struct lttng_kernel_session *session,
759 const char *transport_name,
760 void *buf_addr,
761 size_t subbuf_size, size_t num_subbuf,
762 unsigned int switch_timer_interval,
763 unsigned int read_timer_interval,
764 enum channel_type channel_type)
765 {
766 struct lttng_kernel_channel_buffer *chan;
767 struct lttng_kernel_channel_buffer_private *chan_priv;
768 struct lttng_transport *transport = NULL;
769
770 mutex_lock(&sessions_mutex);
771 if (session->priv->been_active && channel_type != METADATA_CHANNEL)
772 goto active; /* Refuse to add channel to active session */
773 transport = lttng_transport_find(transport_name);
774 if (!transport) {
775 printk(KERN_WARNING "LTTng: transport %s not found\n",
776 transport_name);
777 goto notransport;
778 }
779 if (!try_module_get(transport->owner)) {
780 printk(KERN_WARNING "LTTng: Can't lock transport module.\n");
781 goto notransport;
782 }
783 chan = kzalloc(sizeof(struct lttng_kernel_channel_buffer), GFP_KERNEL);
784 if (!chan)
785 goto nomem;
786 chan_priv = kzalloc(sizeof(struct lttng_kernel_channel_buffer_private), GFP_KERNEL);
787 if (!chan_priv)
788 goto nomem_priv;
789 chan->priv = chan_priv;
790 chan_priv->pub = chan;
791 chan->parent.type = LTTNG_KERNEL_CHANNEL_TYPE_BUFFER;
792 chan->parent.session = session;
793 chan->priv->id = session->priv->free_chan_id++;
794 chan->ops = &transport->ops;
795 /*
796 * Note: the channel creation op already writes into the packet
797 * headers. Therefore the "chan" information used as input
798 * should be already accessible.
799 */
800 chan->priv->rb_chan = transport->ops.priv->channel_create(transport_name,
801 chan, buf_addr, subbuf_size, num_subbuf,
802 switch_timer_interval, read_timer_interval);
803 if (!chan->priv->rb_chan)
804 goto create_error;
805 chan->priv->parent.tstate = 1;
806 chan->parent.enabled = 1;
807 chan->priv->transport = transport;
808 chan->priv->channel_type = channel_type;
809 list_add(&chan->priv->node, &session->priv->chan);
810 mutex_unlock(&sessions_mutex);
811 return chan;
812
813 create_error:
814 kfree(chan_priv);
815 nomem_priv:
816 kfree(chan);
817 nomem:
818 if (transport)
819 module_put(transport->owner);
820 notransport:
821 active:
822 mutex_unlock(&sessions_mutex);
823 return NULL;
824 }
825
826 /*
827 * Only used internally at session destruction for per-cpu channels, and
828 * when metadata channel is released.
829 * Needs to be called with sessions mutex held.
830 */
831 static
832 void _lttng_channel_destroy(struct lttng_kernel_channel_buffer *chan)
833 {
834 chan->ops->priv->channel_destroy(chan->priv->rb_chan);
835 module_put(chan->priv->transport->owner);
836 list_del(&chan->priv->node);
837 lttng_kernel_destroy_context(chan->priv->ctx);
838 kfree(chan->priv);
839 kfree(chan);
840 }
841
842 void lttng_metadata_channel_destroy(struct lttng_kernel_channel_buffer *chan)
843 {
844 BUG_ON(chan->priv->channel_type != METADATA_CHANNEL);
845
846 /* Protect the metadata cache with the sessions_mutex. */
847 mutex_lock(&sessions_mutex);
848 _lttng_channel_destroy(chan);
849 mutex_unlock(&sessions_mutex);
850 }
851 EXPORT_SYMBOL_GPL(lttng_metadata_channel_destroy);
852
853 static
854 void _lttng_metadata_channel_hangup(struct lttng_metadata_stream *stream)
855 {
856 stream->finalized = 1;
857 wake_up_interruptible(&stream->read_wait);
858 }
859
860
861 /*
862 * Supports event creation while tracing session is active.
863 * Needs to be called with sessions mutex held.
864 */
865 struct lttng_kernel_event_recorder *_lttng_kernel_event_recorder_create(struct lttng_kernel_channel_buffer *chan,
866 struct lttng_kernel_abi_event *event_param,
867 const struct lttng_kernel_event_desc *event_desc,
868 enum lttng_kernel_abi_instrumentation itype)
869 {
870 struct lttng_kernel_session *session = chan->parent.session;
871 struct lttng_kernel_event_recorder *event_recorder;
872 struct lttng_kernel_event_recorder_private *event_recorder_priv;
873 const char *event_name;
874 struct hlist_head *head;
875 int ret;
876
877 if (chan->priv->free_event_id == -1U) {
878 ret = -EMFILE;
879 goto full;
880 }
881
882 switch (itype) {
883 case LTTNG_KERNEL_ABI_TRACEPOINT:
884 event_name = event_desc->event_name;
885 break;
886
887 case LTTNG_KERNEL_ABI_KPROBE:
888 lttng_fallthrough;
889 case LTTNG_KERNEL_ABI_UPROBE:
890 lttng_fallthrough;
891 case LTTNG_KERNEL_ABI_KRETPROBE:
892 lttng_fallthrough;
893 case LTTNG_KERNEL_ABI_SYSCALL:
894 event_name = event_param->name;
895 break;
896
897 case LTTNG_KERNEL_ABI_FUNCTION:
898 lttng_fallthrough;
899 case LTTNG_KERNEL_ABI_NOOP:
900 lttng_fallthrough;
901 default:
902 WARN_ON_ONCE(1);
903 ret = -EINVAL;
904 goto type_error;
905 }
906
907 head = utils_borrow_hash_table_bucket(session->priv->events_ht.table,
908 LTTNG_EVENT_HT_SIZE, event_name);
909 lttng_hlist_for_each_entry(event_recorder_priv, head, hlist) {
910 WARN_ON_ONCE(!event_recorder_priv->parent.desc);
911 if (!strncmp(event_recorder_priv->parent.desc->event_name, event_name,
912 LTTNG_KERNEL_ABI_SYM_NAME_LEN - 1)
913 && chan == event_recorder_priv->pub->chan) {
914 ret = -EEXIST;
915 goto exist;
916 }
917 }
918
919 event_recorder = kmem_cache_zalloc(event_recorder_cache, GFP_KERNEL);
920 if (!event_recorder) {
921 ret = -ENOMEM;
922 goto cache_error;
923 }
924 event_recorder_priv = kmem_cache_zalloc(event_recorder_private_cache, GFP_KERNEL);
925 if (!event_recorder_priv) {
926 ret = -ENOMEM;
927 goto cache_private_error;
928 }
929 event_recorder_priv->pub = event_recorder;
930 event_recorder_priv->parent.pub = &event_recorder->parent;
931 event_recorder->priv = event_recorder_priv;
932 event_recorder->parent.priv = &event_recorder_priv->parent;
933 event_recorder->parent.type = LTTNG_KERNEL_EVENT_TYPE_RECORDER;
934
935 event_recorder->parent.run_filter = lttng_kernel_interpret_event_filter;
936 event_recorder->chan = chan;
937 event_recorder->priv->id = chan->priv->free_event_id++;
938 event_recorder->priv->parent.instrumentation = itype;
939 INIT_LIST_HEAD(&event_recorder->priv->parent.filter_bytecode_runtime_head);
940 INIT_LIST_HEAD(&event_recorder->priv->parent.enablers_ref_head);
941
942 switch (itype) {
943 case LTTNG_KERNEL_ABI_TRACEPOINT:
944 /* Event will be enabled by enabler sync. */
945 event_recorder->parent.enabled = 0;
946 event_recorder->priv->parent.registered = 0;
947 event_recorder->priv->parent.desc = lttng_event_desc_get(event_name);
948 if (!event_recorder->priv->parent.desc) {
949 ret = -ENOENT;
950 goto register_error;
951 }
952 /* Populate lttng_event structure before event registration. */
953 smp_wmb();
954 break;
955
956 case LTTNG_KERNEL_ABI_KPROBE:
957 /*
958 * Needs to be explicitly enabled after creation, since
959 * we may want to apply filters.
960 */
961 event_recorder->parent.enabled = 0;
962 event_recorder->priv->parent.registered = 1;
963 /*
964 * Populate lttng_event structure before event
965 * registration.
966 */
967 smp_wmb();
968 ret = lttng_kprobes_register_event(event_name,
969 event_param->u.kprobe.symbol_name,
970 event_param->u.kprobe.offset,
971 event_param->u.kprobe.addr,
972 event_recorder);
973 if (ret) {
974 ret = -EINVAL;
975 goto register_error;
976 }
977 ret = try_module_get(event_recorder->priv->parent.desc->owner);
978 WARN_ON_ONCE(!ret);
979 break;
980
981 case LTTNG_KERNEL_ABI_KRETPROBE:
982 {
983 struct lttng_kernel_event_recorder *event_recorder_return;
984 struct lttng_kernel_event_recorder_private *event_recorder_return_priv;
985
986 /* kretprobe defines 2 events */
987 /*
988 * Needs to be explicitly enabled after creation, since
989 * we may want to apply filters.
990 */
991 event_recorder->parent.enabled = 0;
992 event_recorder->priv->parent.registered = 1;
993
994 event_recorder_return = kmem_cache_zalloc(event_recorder_cache, GFP_KERNEL);
995 if (!event_recorder_return) {
996 ret = -ENOMEM;
997 goto register_error;
998 }
999 event_recorder_return_priv = kmem_cache_zalloc(event_recorder_private_cache, GFP_KERNEL);
1000 if (!event_recorder_return_priv) {
1001 kmem_cache_free(event_recorder_cache, event_recorder_return);
1002 ret = -ENOMEM;
1003 goto register_error;
1004 }
1005 event_recorder_return_priv->pub = event_recorder_return;
1006 event_recorder_return_priv->parent.pub = &event_recorder_return->parent;
1007 event_recorder_return->priv = event_recorder_return_priv;
1008 event_recorder_return->parent.priv = &event_recorder_return_priv->parent;
1009 event_recorder_return->parent.type = LTTNG_KERNEL_EVENT_TYPE_RECORDER;
1010
1011 event_recorder_return->parent.run_filter = lttng_kernel_interpret_event_filter;
1012 event_recorder_return->chan = chan;
1013 event_recorder_return->priv->id = chan->priv->free_event_id++;
1014 event_recorder_return->priv->parent.instrumentation = itype;
1015 event_recorder_return->parent.enabled = 0;
1016 event_recorder_return->priv->parent.registered = 1;
1017 INIT_LIST_HEAD(&event_recorder_return->priv->parent.filter_bytecode_runtime_head);
1018 INIT_LIST_HEAD(&event_recorder_return->priv->parent.enablers_ref_head);
1019 /*
1020 * Populate lttng_event structure before kretprobe registration.
1021 */
1022 smp_wmb();
1023 ret = lttng_kretprobes_register(event_name,
1024 event_param->u.kretprobe.symbol_name,
1025 event_param->u.kretprobe.offset,
1026 event_param->u.kretprobe.addr,
1027 event_recorder, event_recorder_return);
1028 if (ret) {
1029 kmem_cache_free(event_recorder_private_cache, event_recorder_return_priv);
1030 kmem_cache_free(event_recorder_cache, event_recorder_return);
1031 ret = -EINVAL;
1032 goto register_error;
1033 }
1034 /* Take 2 refs on the module: one per event. */
1035 ret = try_module_get(event_recorder->priv->parent.desc->owner);
1036 WARN_ON_ONCE(!ret);
1037 ret = try_module_get(event_recorder_return->priv->parent.desc->owner);
1038 WARN_ON_ONCE(!ret);
1039 ret = _lttng_event_metadata_statedump(chan->parent.session, chan,
1040 event_recorder_return);
1041 WARN_ON_ONCE(ret > 0);
1042 if (ret) {
1043 kmem_cache_free(event_recorder_private_cache, event_recorder_return_priv);
1044 kmem_cache_free(event_recorder_cache, event_recorder_return);
1045 module_put(event_recorder_return->priv->parent.desc->owner);
1046 module_put(event_recorder->priv->parent.desc->owner);
1047 goto statedump_error;
1048 }
1049 list_add(&event_recorder_return->priv->node, &chan->parent.session->priv->events);
1050 break;
1051 }
1052
1053 case LTTNG_KERNEL_ABI_SYSCALL:
1054 /*
1055 * Needs to be explicitly enabled after creation, since
1056 * we may want to apply filters.
1057 */
1058 event_recorder->parent.enabled = 0;
1059 event_recorder->priv->parent.registered = 0;
1060 event_recorder->priv->parent.desc = event_desc;
1061 switch (event_param->u.syscall.entryexit) {
1062 case LTTNG_KERNEL_ABI_SYSCALL_ENTRYEXIT:
1063 ret = -EINVAL;
1064 goto register_error;
1065 case LTTNG_KERNEL_ABI_SYSCALL_ENTRY:
1066 event_recorder->priv->parent.u.syscall.entryexit = LTTNG_SYSCALL_ENTRY;
1067 break;
1068 case LTTNG_KERNEL_ABI_SYSCALL_EXIT:
1069 event_recorder->priv->parent.u.syscall.entryexit = LTTNG_SYSCALL_EXIT;
1070 break;
1071 }
1072 switch (event_param->u.syscall.abi) {
1073 case LTTNG_KERNEL_ABI_SYSCALL_ABI_ALL:
1074 ret = -EINVAL;
1075 goto register_error;
1076 case LTTNG_KERNEL_ABI_SYSCALL_ABI_NATIVE:
1077 event_recorder->priv->parent.u.syscall.abi = LTTNG_SYSCALL_ABI_NATIVE;
1078 break;
1079 case LTTNG_KERNEL_ABI_SYSCALL_ABI_COMPAT:
1080 event_recorder->priv->parent.u.syscall.abi = LTTNG_SYSCALL_ABI_COMPAT;
1081 break;
1082 }
1083 if (!event_recorder->priv->parent.desc) {
1084 ret = -EINVAL;
1085 goto register_error;
1086 }
1087 break;
1088
1089 case LTTNG_KERNEL_ABI_UPROBE:
1090 /*
1091 * Needs to be explicitly enabled after creation, since
1092 * we may want to apply filters.
1093 */
1094 event_recorder->parent.enabled = 0;
1095 event_recorder->priv->parent.registered = 1;
1096
1097 /*
1098 * Populate lttng_event structure before event
1099 * registration.
1100 */
1101 smp_wmb();
1102
1103 ret = lttng_uprobes_register_event(event_param->name,
1104 event_param->u.uprobe.fd,
1105 event_recorder);
1106 if (ret)
1107 goto register_error;
1108 ret = try_module_get(event_recorder->priv->parent.desc->owner);
1109 WARN_ON_ONCE(!ret);
1110 break;
1111
1112 case LTTNG_KERNEL_ABI_FUNCTION:
1113 lttng_fallthrough;
1114 case LTTNG_KERNEL_ABI_NOOP:
1115 lttng_fallthrough;
1116 default:
1117 WARN_ON_ONCE(1);
1118 ret = -EINVAL;
1119 goto register_error;
1120 }
1121 ret = _lttng_event_metadata_statedump(chan->parent.session, chan, event_recorder);
1122 WARN_ON_ONCE(ret > 0);
1123 if (ret) {
1124 goto statedump_error;
1125 }
1126 hlist_add_head(&event_recorder->priv->hlist, head);
1127 list_add(&event_recorder->priv->node, &chan->parent.session->priv->events);
1128 return event_recorder;
1129
1130 statedump_error:
1131 /* If a statedump error occurs, events will not be readable. */
1132 register_error:
1133 kmem_cache_free(event_recorder_private_cache, event_recorder_priv);
1134 cache_private_error:
1135 kmem_cache_free(event_recorder_cache, event_recorder);
1136 cache_error:
1137 exist:
1138 type_error:
1139 full:
1140 return ERR_PTR(ret);
1141 }
1142
1143 struct lttng_kernel_event_notifier *_lttng_event_notifier_create(
1144 const struct lttng_kernel_event_desc *event_desc,
1145 uint64_t token, uint64_t error_counter_index,
1146 struct lttng_event_notifier_group *event_notifier_group,
1147 struct lttng_kernel_abi_event_notifier *event_notifier_param,
1148 enum lttng_kernel_abi_instrumentation itype)
1149 {
1150 struct lttng_kernel_event_notifier *event_notifier;
1151 struct lttng_kernel_event_notifier_private *event_notifier_priv;
1152 struct lttng_counter *error_counter;
1153 const char *event_name;
1154 struct hlist_head *head;
1155 int ret;
1156
1157 switch (itype) {
1158 case LTTNG_KERNEL_ABI_TRACEPOINT:
1159 event_name = event_desc->event_name;
1160 break;
1161
1162 case LTTNG_KERNEL_ABI_KPROBE:
1163 lttng_fallthrough;
1164 case LTTNG_KERNEL_ABI_UPROBE:
1165 lttng_fallthrough;
1166 case LTTNG_KERNEL_ABI_SYSCALL:
1167 event_name = event_notifier_param->event.name;
1168 break;
1169
1170 case LTTNG_KERNEL_ABI_KRETPROBE:
1171 lttng_fallthrough;
1172 case LTTNG_KERNEL_ABI_FUNCTION:
1173 lttng_fallthrough;
1174 case LTTNG_KERNEL_ABI_NOOP:
1175 lttng_fallthrough;
1176 default:
1177 WARN_ON_ONCE(1);
1178 ret = -EINVAL;
1179 goto type_error;
1180 }
1181
1182 head = utils_borrow_hash_table_bucket(event_notifier_group->event_notifiers_ht.table,
1183 LTTNG_EVENT_NOTIFIER_HT_SIZE, event_name);
1184 lttng_hlist_for_each_entry(event_notifier_priv, head, hlist) {
1185 WARN_ON_ONCE(!event_notifier_priv->parent.desc);
1186 if (!strncmp(event_notifier_priv->parent.desc->event_name, event_name,
1187 LTTNG_KERNEL_ABI_SYM_NAME_LEN - 1)
1188 && event_notifier_group == event_notifier_priv->group
1189 && token == event_notifier_priv->parent.user_token) {
1190 ret = -EEXIST;
1191 goto exist;
1192 }
1193 }
1194
1195 event_notifier = kmem_cache_zalloc(event_notifier_cache, GFP_KERNEL);
1196 if (!event_notifier) {
1197 ret = -ENOMEM;
1198 goto cache_error;
1199 }
1200 event_notifier_priv = kmem_cache_zalloc(event_notifier_private_cache, GFP_KERNEL);
1201 if (!event_notifier_priv) {
1202 ret = -ENOMEM;
1203 goto cache_private_error;
1204 }
1205 event_notifier_priv->pub = event_notifier;
1206 event_notifier_priv->parent.pub = &event_notifier->parent;
1207 event_notifier->priv = event_notifier_priv;
1208 event_notifier->parent.priv = &event_notifier_priv->parent;
1209 event_notifier->parent.type = LTTNG_KERNEL_EVENT_TYPE_NOTIFIER;
1210
1211 event_notifier->priv->group = event_notifier_group;
1212 event_notifier->priv->parent.user_token = token;
1213 event_notifier->priv->error_counter_index = error_counter_index;
1214 event_notifier->priv->num_captures = 0;
1215 event_notifier->priv->parent.instrumentation = itype;
1216 event_notifier->notification_send = lttng_event_notifier_notification_send;
1217 INIT_LIST_HEAD(&event_notifier->priv->parent.filter_bytecode_runtime_head);
1218 INIT_LIST_HEAD(&event_notifier->priv->parent.enablers_ref_head);
1219 INIT_LIST_HEAD(&event_notifier->priv->capture_bytecode_runtime_head);
1220 event_notifier->parent.run_filter = lttng_kernel_interpret_event_filter;
1221
1222 switch (itype) {
1223 case LTTNG_KERNEL_ABI_TRACEPOINT:
1224 /* Event will be enabled by enabler sync. */
1225 event_notifier->parent.enabled = 0;
1226 event_notifier->priv->parent.registered = 0;
1227 event_notifier->priv->parent.desc = lttng_event_desc_get(event_name);
1228 if (!event_notifier->priv->parent.desc) {
1229 ret = -ENOENT;
1230 goto register_error;
1231 }
1232 /* Populate lttng_event_notifier structure before event registration. */
1233 smp_wmb();
1234 break;
1235
1236 case LTTNG_KERNEL_ABI_KPROBE:
1237 /*
1238 * Needs to be explicitly enabled after creation, since
1239 * we may want to apply filters.
1240 */
1241 event_notifier->parent.enabled = 0;
1242 event_notifier->priv->parent.registered = 1;
1243 /*
1244 * Populate lttng_event_notifier structure before event
1245 * registration.
1246 */
1247 smp_wmb();
1248 ret = lttng_kprobes_register_event_notifier(
1249 event_notifier_param->event.u.kprobe.symbol_name,
1250 event_notifier_param->event.u.kprobe.offset,
1251 event_notifier_param->event.u.kprobe.addr,
1252 event_notifier);
1253 if (ret) {
1254 ret = -EINVAL;
1255 goto register_error;
1256 }
1257 ret = try_module_get(event_notifier->priv->parent.desc->owner);
1258 WARN_ON_ONCE(!ret);
1259 break;
1260
1261 case LTTNG_KERNEL_ABI_SYSCALL:
1262 /*
1263 * Needs to be explicitly enabled after creation, since
1264 * we may want to apply filters.
1265 */
1266 event_notifier->parent.enabled = 0;
1267 event_notifier->priv->parent.registered = 0;
1268 event_notifier->priv->parent.desc = event_desc;
1269 switch (event_notifier_param->event.u.syscall.entryexit) {
1270 case LTTNG_KERNEL_ABI_SYSCALL_ENTRYEXIT:
1271 ret = -EINVAL;
1272 goto register_error;
1273 case LTTNG_KERNEL_ABI_SYSCALL_ENTRY:
1274 event_notifier->priv->parent.u.syscall.entryexit = LTTNG_SYSCALL_ENTRY;
1275 break;
1276 case LTTNG_KERNEL_ABI_SYSCALL_EXIT:
1277 event_notifier->priv->parent.u.syscall.entryexit = LTTNG_SYSCALL_EXIT;
1278 break;
1279 }
1280 switch (event_notifier_param->event.u.syscall.abi) {
1281 case LTTNG_KERNEL_ABI_SYSCALL_ABI_ALL:
1282 ret = -EINVAL;
1283 goto register_error;
1284 case LTTNG_KERNEL_ABI_SYSCALL_ABI_NATIVE:
1285 event_notifier->priv->parent.u.syscall.abi = LTTNG_SYSCALL_ABI_NATIVE;
1286 break;
1287 case LTTNG_KERNEL_ABI_SYSCALL_ABI_COMPAT:
1288 event_notifier->priv->parent.u.syscall.abi = LTTNG_SYSCALL_ABI_COMPAT;
1289 break;
1290 }
1291
1292 if (!event_notifier->priv->parent.desc) {
1293 ret = -EINVAL;
1294 goto register_error;
1295 }
1296 break;
1297
1298 case LTTNG_KERNEL_ABI_UPROBE:
1299 /*
1300 * Needs to be explicitly enabled after creation, since
1301 * we may want to apply filters.
1302 */
1303 event_notifier->parent.enabled = 0;
1304 event_notifier->priv->parent.registered = 1;
1305
1306 /*
1307 * Populate lttng_event_notifier structure before
1308 * event_notifier registration.
1309 */
1310 smp_wmb();
1311
1312 ret = lttng_uprobes_register_event_notifier(
1313 event_notifier_param->event.name,
1314 event_notifier_param->event.u.uprobe.fd,
1315 event_notifier);
1316 if (ret)
1317 goto register_error;
1318 ret = try_module_get(event_notifier->priv->parent.desc->owner);
1319 WARN_ON_ONCE(!ret);
1320 break;
1321
1322 case LTTNG_KERNEL_ABI_KRETPROBE:
1323 lttng_fallthrough;
1324 case LTTNG_KERNEL_ABI_FUNCTION:
1325 lttng_fallthrough;
1326 case LTTNG_KERNEL_ABI_NOOP:
1327 lttng_fallthrough;
1328 default:
1329 WARN_ON_ONCE(1);
1330 ret = -EINVAL;
1331 goto register_error;
1332 }
1333
1334 list_add(&event_notifier->priv->node, &event_notifier_group->event_notifiers_head);
1335 hlist_add_head(&event_notifier->priv->hlist, head);
1336
1337 /*
1338 * Clear the error counter bucket. The sessiond keeps track of which
1339 * bucket is currently in use. We trust it. The session lock
1340 * synchronizes against concurrent creation of the error
1341 * counter.
1342 */
1343 error_counter = event_notifier_group->error_counter;
1344 if (error_counter) {
1345 size_t dimension_index[1];
1346
1347 /*
1348 * Check that the index is within the boundary of the counter.
1349 */
1350 if (event_notifier->priv->error_counter_index >= event_notifier_group->error_counter_len) {
1351 printk(KERN_INFO "LTTng: event_notifier: Error counter index out-of-bound: counter-len=%zu, index=%llu\n",
1352 event_notifier_group->error_counter_len, event_notifier->priv->error_counter_index);
1353 ret = -EINVAL;
1354 goto register_error;
1355 }
1356
1357 dimension_index[0] = event_notifier->priv->error_counter_index;
1358 ret = error_counter->ops->counter_clear(error_counter->counter, dimension_index);
1359 if (ret) {
1360 printk(KERN_INFO "LTTng: event_notifier: Unable to clear error counter bucket %llu\n",
1361 event_notifier->priv->error_counter_index);
1362 goto register_error;
1363 }
1364 }
1365
1366 return event_notifier;
1367
1368 register_error:
1369 kmem_cache_free(event_notifier_private_cache, event_notifier_priv);
1370 cache_private_error:
1371 kmem_cache_free(event_notifier_cache, event_notifier);
1372 cache_error:
1373 exist:
1374 type_error:
1375 return ERR_PTR(ret);
1376 }
1377
1378 int lttng_kernel_counter_read(struct lttng_counter *counter,
1379 const size_t *dim_indexes, int32_t cpu,
1380 int64_t *val, bool *overflow, bool *underflow)
1381 {
1382 return counter->ops->counter_read(counter->counter, dim_indexes,
1383 cpu, val, overflow, underflow);
1384 }
1385
1386 int lttng_kernel_counter_aggregate(struct lttng_counter *counter,
1387 const size_t *dim_indexes, int64_t *val,
1388 bool *overflow, bool *underflow)
1389 {
1390 return counter->ops->counter_aggregate(counter->counter, dim_indexes,
1391 val, overflow, underflow);
1392 }
1393
1394 int lttng_kernel_counter_clear(struct lttng_counter *counter,
1395 const size_t *dim_indexes)
1396 {
1397 return counter->ops->counter_clear(counter->counter, dim_indexes);
1398 }
1399
1400 struct lttng_kernel_event_recorder *lttng_kernel_event_recorder_create(struct lttng_kernel_channel_buffer *chan,
1401 struct lttng_kernel_abi_event *event_param,
1402 const struct lttng_kernel_event_desc *event_desc,
1403 enum lttng_kernel_abi_instrumentation itype)
1404 {
1405 struct lttng_kernel_event_recorder *event;
1406
1407 mutex_lock(&sessions_mutex);
1408 event = _lttng_kernel_event_recorder_create(chan, event_param, event_desc, itype);
1409 mutex_unlock(&sessions_mutex);
1410 return event;
1411 }
1412
1413 struct lttng_kernel_event_notifier *lttng_event_notifier_create(
1414 const struct lttng_kernel_event_desc *event_desc,
1415 uint64_t id, uint64_t error_counter_index,
1416 struct lttng_event_notifier_group *event_notifier_group,
1417 struct lttng_kernel_abi_event_notifier *event_notifier_param,
1418 enum lttng_kernel_abi_instrumentation itype)
1419 {
1420 struct lttng_kernel_event_notifier *event_notifier;
1421
1422 mutex_lock(&sessions_mutex);
1423 event_notifier = _lttng_event_notifier_create(event_desc, id,
1424 error_counter_index, event_notifier_group,
1425 event_notifier_param, itype);
1426 mutex_unlock(&sessions_mutex);
1427 return event_notifier;
1428 }
1429
1430 /* Only used for tracepoints for now. */
1431 static
1432 void register_event(struct lttng_kernel_event_recorder *event_recorder)
1433 {
1434 const struct lttng_kernel_event_desc *desc;
1435 int ret = -EINVAL;
1436
1437 WARN_ON_ONCE(event_recorder->priv->parent.registered);
1438
1439 desc = event_recorder->priv->parent.desc;
1440 switch (event_recorder->priv->parent.instrumentation) {
1441 case LTTNG_KERNEL_ABI_TRACEPOINT:
1442 ret = lttng_wrapper_tracepoint_probe_register(desc->event_kname,
1443 desc->tp_class->probe_callback,
1444 event_recorder);
1445 break;
1446
1447 case LTTNG_KERNEL_ABI_SYSCALL:
1448 ret = lttng_syscall_filter_enable_event(event_recorder->chan, event_recorder);
1449 break;
1450
1451 case LTTNG_KERNEL_ABI_KPROBE:
1452 lttng_fallthrough;
1453 case LTTNG_KERNEL_ABI_UPROBE:
1454 lttng_fallthrough;
1455 case LTTNG_KERNEL_ABI_KRETPROBE:
1456 ret = 0;
1457 break;
1458
1459 case LTTNG_KERNEL_ABI_FUNCTION:
1460 lttng_fallthrough;
1461 case LTTNG_KERNEL_ABI_NOOP:
1462 lttng_fallthrough;
1463 default:
1464 WARN_ON_ONCE(1);
1465 }
1466 if (!ret)
1467 event_recorder->priv->parent.registered = 1;
1468 }
1469
1470 /*
1471 * Only used internally at session destruction.
1472 */
1473 static
1474 void unregister_event(struct lttng_kernel_event_recorder *event_recorder)
1475 {
1476 struct lttng_kernel_event_common_private *event_priv = &event_recorder->priv->parent;
1477 const struct lttng_kernel_event_desc *desc;
1478 int ret = -EINVAL;
1479
1480 WARN_ON_ONCE(!event_priv->registered);
1481
1482 desc = event_priv->desc;
1483 switch (event_priv->instrumentation) {
1484 case LTTNG_KERNEL_ABI_TRACEPOINT:
1485 ret = lttng_wrapper_tracepoint_probe_unregister(event_priv->desc->event_kname,
1486 event_priv->desc->tp_class->probe_callback,
1487 event_recorder);
1488 break;
1489
1490 case LTTNG_KERNEL_ABI_KPROBE:
1491 lttng_kprobes_unregister_event(event_recorder);
1492 ret = 0;
1493 break;
1494
1495 case LTTNG_KERNEL_ABI_KRETPROBE:
1496 lttng_kretprobes_unregister(event_recorder);
1497 ret = 0;
1498 break;
1499
1500 case LTTNG_KERNEL_ABI_SYSCALL:
1501 ret = lttng_syscall_filter_disable_event(event_recorder->chan, event_recorder);
1502 break;
1503
1504 case LTTNG_KERNEL_ABI_NOOP:
1505 ret = 0;
1506 break;
1507
1508 case LTTNG_KERNEL_ABI_UPROBE:
1509 lttng_uprobes_unregister_event(event_recorder);
1510 ret = 0;
1511 break;
1512
1513 case LTTNG_KERNEL_ABI_FUNCTION:
1514 lttng_fallthrough;
1515 default:
1516 WARN_ON_ONCE(1);
1517 }
1518 WARN_ON_ONCE(ret);
1519 if (!ret)
1520 event_priv->registered = 0;
1521 }
1522
1523 static
1524 void _lttng_event_unregister(struct lttng_kernel_event_recorder *event_recorder)
1525 {
1526 if (event_recorder->priv->parent.registered)
1527 unregister_event(event_recorder);
1528 }
1529
1530 /* Only used for tracepoints for now. */
1531 static
1532 void register_event_notifier(struct lttng_kernel_event_notifier *event_notifier)
1533 {
1534 const struct lttng_kernel_event_desc *desc;
1535 int ret = -EINVAL;
1536
1537 WARN_ON_ONCE(event_notifier->priv->parent.registered);
1538
1539 desc = event_notifier->priv->parent.desc;
1540 switch (event_notifier->priv->parent.instrumentation) {
1541 case LTTNG_KERNEL_ABI_TRACEPOINT:
1542 ret = lttng_wrapper_tracepoint_probe_register(desc->event_kname,
1543 desc->tp_class->probe_callback,
1544 event_notifier);
1545 break;
1546
1547 case LTTNG_KERNEL_ABI_SYSCALL:
1548 ret = lttng_syscall_filter_enable_event_notifier(event_notifier);
1549 break;
1550
1551 case LTTNG_KERNEL_ABI_KPROBE:
1552 lttng_fallthrough;
1553 case LTTNG_KERNEL_ABI_UPROBE:
1554 ret = 0;
1555 break;
1556
1557 case LTTNG_KERNEL_ABI_KRETPROBE:
1558 lttng_fallthrough;
1559 case LTTNG_KERNEL_ABI_FUNCTION:
1560 lttng_fallthrough;
1561 case LTTNG_KERNEL_ABI_NOOP:
1562 lttng_fallthrough;
1563 default:
1564 WARN_ON_ONCE(1);
1565 }
1566 if (!ret)
1567 event_notifier->priv->parent.registered = 1;
1568 }
1569
1570 static
1571 int unregister_event_notifier(struct lttng_kernel_event_notifier *event_notifier)
1572 {
1573 const struct lttng_kernel_event_desc *desc;
1574 int ret = -EINVAL;
1575
1576 WARN_ON_ONCE(!event_notifier->priv->parent.registered);
1577
1578 desc = event_notifier->priv->parent.desc;
1579 switch (event_notifier->priv->parent.instrumentation) {
1580 case LTTNG_KERNEL_ABI_TRACEPOINT:
1581 ret = lttng_wrapper_tracepoint_probe_unregister(event_notifier->priv->parent.desc->event_kname,
1582 event_notifier->priv->parent.desc->tp_class->probe_callback,
1583 event_notifier);
1584 break;
1585
1586 case LTTNG_KERNEL_ABI_KPROBE:
1587 lttng_kprobes_unregister_event_notifier(event_notifier);
1588 ret = 0;
1589 break;
1590
1591 case LTTNG_KERNEL_ABI_UPROBE:
1592 lttng_uprobes_unregister_event_notifier(event_notifier);
1593 ret = 0;
1594 break;
1595
1596 case LTTNG_KERNEL_ABI_SYSCALL:
1597 ret = lttng_syscall_filter_disable_event_notifier(event_notifier);
1598 break;
1599
1600 case LTTNG_KERNEL_ABI_KRETPROBE:
1601 lttng_fallthrough;
1602 case LTTNG_KERNEL_ABI_FUNCTION:
1603 lttng_fallthrough;
1604 case LTTNG_KERNEL_ABI_NOOP:
1605 lttng_fallthrough;
1606 default:
1607 WARN_ON_ONCE(1);
1608 }
1609 if (!ret)
1610 event_notifier->priv->parent.registered = 0;
1611 return ret;
1612 }
1613
1614 static
1615 void _lttng_event_notifier_unregister(struct lttng_kernel_event_notifier *event_notifier)
1616 {
1617 if (event_notifier->priv->parent.registered)
1618 unregister_event_notifier(event_notifier);
1619 }
1620
1621 /*
1622 * Only used internally at session destruction.
1623 */
1624 static
1625 void _lttng_event_destroy(struct lttng_kernel_event_common *event)
1626 {
1627 struct lttng_kernel_event_common_private *event_priv = event->priv;
1628 struct lttng_enabler_ref *enabler_ref, *tmp_enabler_ref;
1629
1630 lttng_free_event_filter_runtime(event);
1631 /* Free event enabler refs */
1632 list_for_each_entry_safe(enabler_ref, tmp_enabler_ref,
1633 &event_priv->enablers_ref_head, node)
1634 kfree(enabler_ref);
1635
1636 switch (event->type) {
1637 case LTTNG_KERNEL_EVENT_TYPE_RECORDER:
1638 {
1639 struct lttng_kernel_event_recorder *event_recorder =
1640 container_of(event, struct lttng_kernel_event_recorder, parent);
1641
1642 switch (event_priv->instrumentation) {
1643 case LTTNG_KERNEL_ABI_TRACEPOINT:
1644 lttng_event_desc_put(event_priv->desc);
1645 break;
1646
1647 case LTTNG_KERNEL_ABI_KPROBE:
1648 module_put(event_priv->desc->owner);
1649 lttng_kprobes_destroy_event_private(event_recorder);
1650 break;
1651
1652 case LTTNG_KERNEL_ABI_KRETPROBE:
1653 module_put(event_priv->desc->owner);
1654 lttng_kretprobes_destroy_private(event_recorder);
1655 break;
1656
1657 case LTTNG_KERNEL_ABI_SYSCALL:
1658 break;
1659
1660 case LTTNG_KERNEL_ABI_UPROBE:
1661 module_put(event_priv->desc->owner);
1662 lttng_uprobes_destroy_event_private(event_recorder);
1663 break;
1664
1665 case LTTNG_KERNEL_ABI_FUNCTION:
1666 lttng_fallthrough;
1667 case LTTNG_KERNEL_ABI_NOOP:
1668 lttng_fallthrough;
1669 default:
1670 WARN_ON_ONCE(1);
1671 }
1672 list_del(&event_recorder->priv->node);
1673 kmem_cache_free(event_recorder_private_cache, event_recorder->priv);
1674 kmem_cache_free(event_recorder_cache, event_recorder);
1675 break;
1676 }
1677 case LTTNG_KERNEL_EVENT_TYPE_NOTIFIER:
1678 {
1679 struct lttng_kernel_event_notifier *event_notifier =
1680 container_of(event, struct lttng_kernel_event_notifier, parent);
1681
1682 switch (event_notifier->priv->parent.instrumentation) {
1683 case LTTNG_KERNEL_ABI_TRACEPOINT:
1684 lttng_event_desc_put(event_notifier->priv->parent.desc);
1685 break;
1686
1687 case LTTNG_KERNEL_ABI_KPROBE:
1688 module_put(event_notifier->priv->parent.desc->owner);
1689 lttng_kprobes_destroy_event_notifier_private(event_notifier);
1690 break;
1691
1692 case LTTNG_KERNEL_ABI_SYSCALL:
1693 break;
1694
1695 case LTTNG_KERNEL_ABI_UPROBE:
1696 module_put(event_notifier->priv->parent.desc->owner);
1697 lttng_uprobes_destroy_event_notifier_private(event_notifier);
1698 break;
1699
1700 case LTTNG_KERNEL_ABI_KRETPROBE:
1701 lttng_fallthrough;
1702 case LTTNG_KERNEL_ABI_FUNCTION:
1703 lttng_fallthrough;
1704 case LTTNG_KERNEL_ABI_NOOP:
1705 lttng_fallthrough;
1706 default:
1707 WARN_ON_ONCE(1);
1708 }
1709 list_del(&event_notifier->priv->node);
1710 kmem_cache_free(event_notifier_private_cache, event_notifier->priv);
1711 kmem_cache_free(event_notifier_cache, event_notifier);
1712 break;
1713 }
1714 default:
1715 WARN_ON_ONCE(1);
1716 }
1717 }
1718
1719 struct lttng_kernel_id_tracker *get_tracker(struct lttng_kernel_session *session,
1720 enum tracker_type tracker_type)
1721 {
1722 switch (tracker_type) {
1723 case TRACKER_PID:
1724 return &session->pid_tracker;
1725 case TRACKER_VPID:
1726 return &session->vpid_tracker;
1727 case TRACKER_UID:
1728 return &session->uid_tracker;
1729 case TRACKER_VUID:
1730 return &session->vuid_tracker;
1731 case TRACKER_GID:
1732 return &session->gid_tracker;
1733 case TRACKER_VGID:
1734 return &session->vgid_tracker;
1735 default:
1736 WARN_ON_ONCE(1);
1737 return NULL;
1738 }
1739 }
1740
1741 int lttng_session_track_id(struct lttng_kernel_session *session,
1742 enum tracker_type tracker_type, int id)
1743 {
1744 struct lttng_kernel_id_tracker *tracker;
1745 int ret;
1746
1747 tracker = get_tracker(session, tracker_type);
1748 if (!tracker)
1749 return -EINVAL;
1750 if (id < -1)
1751 return -EINVAL;
1752 mutex_lock(&sessions_mutex);
1753 if (id == -1) {
1754 /* track all ids: destroy tracker. */
1755 lttng_id_tracker_destroy(tracker, true);
1756 ret = 0;
1757 } else {
1758 ret = lttng_id_tracker_add(tracker, id);
1759 }
1760 mutex_unlock(&sessions_mutex);
1761 return ret;
1762 }
1763
1764 int lttng_session_untrack_id(struct lttng_kernel_session *session,
1765 enum tracker_type tracker_type, int id)
1766 {
1767 struct lttng_kernel_id_tracker *tracker;
1768 int ret;
1769
1770 tracker = get_tracker(session, tracker_type);
1771 if (!tracker)
1772 return -EINVAL;
1773 if (id < -1)
1774 return -EINVAL;
1775 mutex_lock(&sessions_mutex);
1776 if (id == -1) {
1777 /* untrack all ids: replace by empty tracker. */
1778 ret = lttng_id_tracker_empty_set(tracker);
1779 } else {
1780 ret = lttng_id_tracker_del(tracker, id);
1781 }
1782 mutex_unlock(&sessions_mutex);
1783 return ret;
1784 }
1785
1786 static
1787 void *id_list_start(struct seq_file *m, loff_t *pos)
1788 {
1789 struct lttng_kernel_id_tracker *id_tracker = m->private;
1790 struct lttng_kernel_id_tracker_rcu *id_tracker_p = id_tracker->p;
1791 struct lttng_id_hash_node *e;
1792 int iter = 0, i;
1793
1794 mutex_lock(&sessions_mutex);
1795 if (id_tracker_p) {
1796 for (i = 0; i < LTTNG_ID_TABLE_SIZE; i++) {
1797 struct hlist_head *head = &id_tracker_p->id_hash[i];
1798
1799 lttng_hlist_for_each_entry(e, head, hlist) {
1800 if (iter++ >= *pos)
1801 return e;
1802 }
1803 }
1804 } else {
1805 /* ID tracker disabled. */
1806 if (iter >= *pos && iter == 0) {
1807 return id_tracker_p; /* empty tracker */
1808 }
1809 iter++;
1810 }
1811 /* End of list */
1812 return NULL;
1813 }
1814
1815 /* Called with sessions_mutex held. */
1816 static
1817 void *id_list_next(struct seq_file *m, void *p, loff_t *ppos)
1818 {
1819 struct lttng_kernel_id_tracker *id_tracker = m->private;
1820 struct lttng_kernel_id_tracker_rcu *id_tracker_p = id_tracker->p;
1821 struct lttng_id_hash_node *e;
1822 int iter = 0, i;
1823
1824 (*ppos)++;
1825 if (id_tracker_p) {
1826 for (i = 0; i < LTTNG_ID_TABLE_SIZE; i++) {
1827 struct hlist_head *head = &id_tracker_p->id_hash[i];
1828
1829 lttng_hlist_for_each_entry(e, head, hlist) {
1830 if (iter++ >= *ppos)
1831 return e;
1832 }
1833 }
1834 } else {
1835 /* ID tracker disabled. */
1836 if (iter >= *ppos && iter == 0)
1837 return p; /* empty tracker */
1838 iter++;
1839 }
1840
1841 /* End of list */
1842 return NULL;
1843 }
1844
1845 static
1846 void id_list_stop(struct seq_file *m, void *p)
1847 {
1848 mutex_unlock(&sessions_mutex);
1849 }
1850
1851 static
1852 int id_list_show(struct seq_file *m, void *p)
1853 {
1854 struct lttng_kernel_id_tracker *id_tracker = m->private;
1855 struct lttng_kernel_id_tracker_rcu *id_tracker_p = id_tracker->p;
1856 int id;
1857
1858 if (p == id_tracker_p) {
1859 /* Tracker disabled. */
1860 id = -1;
1861 } else {
1862 const struct lttng_id_hash_node *e = p;
1863
1864 id = lttng_id_tracker_get_node_id(e);
1865 }
1866 switch (id_tracker->priv->tracker_type) {
1867 case TRACKER_PID:
1868 seq_printf(m, "process { pid = %d; };\n", id);
1869 break;
1870 case TRACKER_VPID:
1871 seq_printf(m, "process { vpid = %d; };\n", id);
1872 break;
1873 case TRACKER_UID:
1874 seq_printf(m, "user { uid = %d; };\n", id);
1875 break;
1876 case TRACKER_VUID:
1877 seq_printf(m, "user { vuid = %d; };\n", id);
1878 break;
1879 case TRACKER_GID:
1880 seq_printf(m, "group { gid = %d; };\n", id);
1881 break;
1882 case TRACKER_VGID:
1883 seq_printf(m, "group { vgid = %d; };\n", id);
1884 break;
1885 default:
1886 seq_printf(m, "UNKNOWN { field = %d };\n", id);
1887 }
1888 return 0;
1889 }
1890
1891 static
1892 const struct seq_operations lttng_tracker_ids_list_seq_ops = {
1893 .start = id_list_start,
1894 .next = id_list_next,
1895 .stop = id_list_stop,
1896 .show = id_list_show,
1897 };
1898
1899 static
1900 int lttng_tracker_ids_list_open(struct inode *inode, struct file *file)
1901 {
1902 return seq_open(file, &lttng_tracker_ids_list_seq_ops);
1903 }
1904
1905 static
1906 int lttng_tracker_ids_list_release(struct inode *inode, struct file *file)
1907 {
1908 struct seq_file *m = file->private_data;
1909 struct lttng_kernel_id_tracker *id_tracker = m->private;
1910 int ret;
1911
1912 WARN_ON_ONCE(!id_tracker);
1913 ret = seq_release(inode, file);
1914 if (!ret)
1915 fput(id_tracker->priv->session->priv->file);
1916 return ret;
1917 }
1918
1919 const struct file_operations lttng_tracker_ids_list_fops = {
1920 .owner = THIS_MODULE,
1921 .open = lttng_tracker_ids_list_open,
1922 .read = seq_read,
1923 .llseek = seq_lseek,
1924 .release = lttng_tracker_ids_list_release,
1925 };
1926
1927 int lttng_session_list_tracker_ids(struct lttng_kernel_session *session,
1928 enum tracker_type tracker_type)
1929 {
1930 struct file *tracker_ids_list_file;
1931 struct seq_file *m;
1932 int file_fd, ret;
1933
1934 file_fd = lttng_get_unused_fd();
1935 if (file_fd < 0) {
1936 ret = file_fd;
1937 goto fd_error;
1938 }
1939
1940 tracker_ids_list_file = anon_inode_getfile("[lttng_tracker_ids_list]",
1941 &lttng_tracker_ids_list_fops,
1942 NULL, O_RDWR);
1943 if (IS_ERR(tracker_ids_list_file)) {
1944 ret = PTR_ERR(tracker_ids_list_file);
1945 goto file_error;
1946 }
1947 if (!atomic_long_add_unless(&session->priv->file->f_count, 1, LONG_MAX)) {
1948 ret = -EOVERFLOW;
1949 goto refcount_error;
1950 }
1951 ret = lttng_tracker_ids_list_fops.open(NULL, tracker_ids_list_file);
1952 if (ret < 0)
1953 goto open_error;
1954 m = tracker_ids_list_file->private_data;
1955
1956 m->private = get_tracker(session, tracker_type);
1957 BUG_ON(!m->private);
1958 fd_install(file_fd, tracker_ids_list_file);
1959
1960 return file_fd;
1961
1962 open_error:
1963 atomic_long_dec(&session->priv->file->f_count);
1964 refcount_error:
1965 fput(tracker_ids_list_file);
1966 file_error:
1967 put_unused_fd(file_fd);
1968 fd_error:
1969 return ret;
1970 }
1971
1972 /*
1973 * Enabler management.
1974 */
1975 static
1976 int lttng_match_enabler_star_glob(const char *desc_name,
1977 const char *pattern)
1978 {
1979 if (!strutils_star_glob_match(pattern, LTTNG_SIZE_MAX,
1980 desc_name, LTTNG_SIZE_MAX))
1981 return 0;
1982 return 1;
1983 }
1984
1985 static
1986 int lttng_match_enabler_name(const char *desc_name,
1987 const char *name)
1988 {
1989 if (strcmp(desc_name, name))
1990 return 0;
1991 return 1;
1992 }
1993
1994 int lttng_desc_match_enabler(const struct lttng_kernel_event_desc *desc,
1995 struct lttng_enabler *enabler)
1996 {
1997 const char *desc_name, *enabler_name;
1998 bool compat = false, entry = false;
1999
2000 enabler_name = enabler->event_param.name;
2001 switch (enabler->event_param.instrumentation) {
2002 case LTTNG_KERNEL_ABI_TRACEPOINT:
2003 desc_name = desc->event_name;
2004 switch (enabler->format_type) {
2005 case LTTNG_ENABLER_FORMAT_STAR_GLOB:
2006 return lttng_match_enabler_star_glob(desc_name, enabler_name);
2007 case LTTNG_ENABLER_FORMAT_NAME:
2008 return lttng_match_enabler_name(desc_name, enabler_name);
2009 default:
2010 return -EINVAL;
2011 }
2012 break;
2013
2014 case LTTNG_KERNEL_ABI_SYSCALL:
2015 desc_name = desc->event_name;
2016 if (!strncmp(desc_name, "compat_", strlen("compat_"))) {
2017 desc_name += strlen("compat_");
2018 compat = true;
2019 }
2020 if (!strncmp(desc_name, "syscall_exit_",
2021 strlen("syscall_exit_"))) {
2022 desc_name += strlen("syscall_exit_");
2023 } else if (!strncmp(desc_name, "syscall_entry_",
2024 strlen("syscall_entry_"))) {
2025 desc_name += strlen("syscall_entry_");
2026 entry = true;
2027 } else {
2028 WARN_ON_ONCE(1);
2029 return -EINVAL;
2030 }
2031 switch (enabler->event_param.u.syscall.entryexit) {
2032 case LTTNG_KERNEL_ABI_SYSCALL_ENTRYEXIT:
2033 break;
2034 case LTTNG_KERNEL_ABI_SYSCALL_ENTRY:
2035 if (!entry)
2036 return 0;
2037 break;
2038 case LTTNG_KERNEL_ABI_SYSCALL_EXIT:
2039 if (entry)
2040 return 0;
2041 break;
2042 default:
2043 return -EINVAL;
2044 }
2045 switch (enabler->event_param.u.syscall.abi) {
2046 case LTTNG_KERNEL_ABI_SYSCALL_ABI_ALL:
2047 break;
2048 case LTTNG_KERNEL_ABI_SYSCALL_ABI_NATIVE:
2049 if (compat)
2050 return 0;
2051 break;
2052 case LTTNG_KERNEL_ABI_SYSCALL_ABI_COMPAT:
2053 if (!compat)
2054 return 0;
2055 break;
2056 default:
2057 return -EINVAL;
2058 }
2059 switch (enabler->event_param.u.syscall.match) {
2060 case LTTNG_KERNEL_ABI_SYSCALL_MATCH_NAME:
2061 switch (enabler->format_type) {
2062 case LTTNG_ENABLER_FORMAT_STAR_GLOB:
2063 return lttng_match_enabler_star_glob(desc_name, enabler_name);
2064 case LTTNG_ENABLER_FORMAT_NAME:
2065 return lttng_match_enabler_name(desc_name, enabler_name);
2066 default:
2067 return -EINVAL;
2068 }
2069 break;
2070 case LTTNG_KERNEL_ABI_SYSCALL_MATCH_NR:
2071 return -EINVAL; /* Not implemented. */
2072 default:
2073 return -EINVAL;
2074 }
2075 break;
2076
2077 default:
2078 WARN_ON_ONCE(1);
2079 return -EINVAL;
2080 }
2081 }
2082
2083 static
2084 int lttng_event_enabler_match_event(struct lttng_event_enabler *event_enabler,
2085 struct lttng_kernel_event_recorder *event_recorder)
2086 {
2087 struct lttng_enabler *base_enabler = lttng_event_enabler_as_enabler(
2088 event_enabler);
2089
2090 if (base_enabler->event_param.instrumentation != event_recorder->priv->parent.instrumentation)
2091 return 0;
2092 if (lttng_desc_match_enabler(event_recorder->priv->parent.desc, base_enabler)
2093 && event_recorder->chan == event_enabler->chan)
2094 return 1;
2095 else
2096 return 0;
2097 }
2098
2099 static
2100 int lttng_event_notifier_enabler_match_event_notifier(struct lttng_event_notifier_enabler *event_notifier_enabler,
2101 struct lttng_kernel_event_notifier *event_notifier)
2102 {
2103 struct lttng_enabler *base_enabler = lttng_event_notifier_enabler_as_enabler(
2104 event_notifier_enabler);
2105
2106 if (base_enabler->event_param.instrumentation != event_notifier->priv->parent.instrumentation)
2107 return 0;
2108 if (lttng_desc_match_enabler(event_notifier->priv->parent.desc, base_enabler)
2109 && event_notifier->priv->group == event_notifier_enabler->group
2110 && event_notifier->priv->parent.user_token == event_notifier_enabler->base.user_token)
2111 return 1;
2112 else
2113 return 0;
2114 }
2115
2116 static
2117 struct lttng_enabler_ref *lttng_enabler_ref(
2118 struct list_head *enablers_ref_list,
2119 struct lttng_enabler *enabler)
2120 {
2121 struct lttng_enabler_ref *enabler_ref;
2122
2123 list_for_each_entry(enabler_ref, enablers_ref_list, node) {
2124 if (enabler_ref->ref == enabler)
2125 return enabler_ref;
2126 }
2127 return NULL;
2128 }
2129
2130 static
2131 void lttng_create_tracepoint_event_if_missing(struct lttng_event_enabler *event_enabler)
2132 {
2133 struct lttng_kernel_session *session = event_enabler->chan->parent.session;
2134 struct lttng_kernel_probe_desc *probe_desc;
2135 const struct lttng_kernel_event_desc *desc;
2136 int i;
2137 struct list_head *probe_list;
2138
2139 probe_list = lttng_get_probe_list_head();
2140 /*
2141 * For each probe event, if we find that a probe event matches
2142 * our enabler, create an associated lttng_event if not
2143 * already present.
2144 */
2145 list_for_each_entry(probe_desc, probe_list, head) {
2146 for (i = 0; i < probe_desc->nr_events; i++) {
2147 int found = 0;
2148 struct hlist_head *head;
2149 struct lttng_kernel_event_recorder_private *event_recorder_private;
2150 struct lttng_kernel_event_recorder *event_recorder;
2151
2152 desc = probe_desc->event_desc[i];
2153 if (!lttng_desc_match_enabler(desc,
2154 lttng_event_enabler_as_enabler(event_enabler)))
2155 continue;
2156
2157 /*
2158 * Check if already created.
2159 */
2160 head = utils_borrow_hash_table_bucket(
2161 session->priv->events_ht.table, LTTNG_EVENT_HT_SIZE,
2162 desc->event_name);
2163 lttng_hlist_for_each_entry(event_recorder_private, head, hlist) {
2164 if (event_recorder_private->parent.desc == desc
2165 && event_recorder_private->pub->chan == event_enabler->chan)
2166 found = 1;
2167 }
2168 if (found)
2169 continue;
2170
2171 /*
2172 * We need to create an event for this
2173 * event probe.
2174 */
2175 event_recorder = _lttng_kernel_event_recorder_create(event_enabler->chan,
2176 NULL, desc, LTTNG_KERNEL_ABI_TRACEPOINT);
2177 if (!event_recorder) {
2178 printk(KERN_INFO "LTTng: Unable to create event %s\n",
2179 probe_desc->event_desc[i]->event_name);
2180 }
2181 }
2182 }
2183 }
2184
2185 static
2186 void lttng_create_tracepoint_event_notifier_if_missing(struct lttng_event_notifier_enabler *event_notifier_enabler)
2187 {
2188 struct lttng_event_notifier_group *event_notifier_group = event_notifier_enabler->group;
2189 struct lttng_kernel_probe_desc *probe_desc;
2190 const struct lttng_kernel_event_desc *desc;
2191 int i;
2192 struct list_head *probe_list;
2193
2194 probe_list = lttng_get_probe_list_head();
2195 /*
2196 * For each probe event, if we find that a probe event matches
2197 * our enabler, create an associated lttng_event_notifier if not
2198 * already present.
2199 */
2200 list_for_each_entry(probe_desc, probe_list, head) {
2201 for (i = 0; i < probe_desc->nr_events; i++) {
2202 int found = 0;
2203 struct hlist_head *head;
2204 struct lttng_kernel_event_notifier_private *event_notifier_priv;
2205 struct lttng_kernel_event_notifier *event_notifier;
2206
2207 desc = probe_desc->event_desc[i];
2208 if (!lttng_desc_match_enabler(desc,
2209 lttng_event_notifier_enabler_as_enabler(event_notifier_enabler)))
2210 continue;
2211
2212 /*
2213 * Check if already created.
2214 */
2215 head = utils_borrow_hash_table_bucket(
2216 event_notifier_group->event_notifiers_ht.table,
2217 LTTNG_EVENT_NOTIFIER_HT_SIZE, desc->event_name);
2218 lttng_hlist_for_each_entry(event_notifier_priv, head, hlist) {
2219 if (event_notifier_priv->parent.desc == desc
2220 && event_notifier_priv->parent.user_token == event_notifier_enabler->base.user_token)
2221 found = 1;
2222 }
2223 if (found)
2224 continue;
2225
2226 /*
2227 * We need to create a event_notifier for this event probe.
2228 */
2229 event_notifier = _lttng_event_notifier_create(desc,
2230 event_notifier_enabler->base.user_token,
2231 event_notifier_enabler->error_counter_index,
2232 event_notifier_group, NULL,
2233 LTTNG_KERNEL_ABI_TRACEPOINT);
2234 if (IS_ERR(event_notifier)) {
2235 printk(KERN_INFO "Unable to create event_notifier %s\n",
2236 probe_desc->event_desc[i]->event_name);
2237 }
2238 }
2239 }
2240 }
2241
2242 static
2243 void lttng_create_syscall_event_if_missing(struct lttng_event_enabler *event_enabler)
2244 {
2245 int ret;
2246
2247 ret = lttng_syscalls_register_event(event_enabler);
2248 WARN_ON_ONCE(ret);
2249 }
2250
2251 static
2252 void lttng_create_syscall_event_notifier_if_missing(struct lttng_event_notifier_enabler *event_notifier_enabler)
2253 {
2254 int ret;
2255
2256 ret = lttng_syscalls_register_event_notifier(event_notifier_enabler);
2257 WARN_ON_ONCE(ret);
2258 ret = lttng_syscalls_create_matching_event_notifiers(event_notifier_enabler);
2259 WARN_ON_ONCE(ret);
2260 }
2261
2262 /*
2263 * Create struct lttng_kernel_event_recorder if it is missing and present in the list of
2264 * tracepoint probes.
2265 * Should be called with sessions mutex held.
2266 */
2267 static
2268 void lttng_create_event_if_missing(struct lttng_event_enabler *event_enabler)
2269 {
2270 switch (event_enabler->base.event_param.instrumentation) {
2271 case LTTNG_KERNEL_ABI_TRACEPOINT:
2272 lttng_create_tracepoint_event_if_missing(event_enabler);
2273 break;
2274
2275 case LTTNG_KERNEL_ABI_SYSCALL:
2276 lttng_create_syscall_event_if_missing(event_enabler);
2277 break;
2278
2279 default:
2280 WARN_ON_ONCE(1);
2281 break;
2282 }
2283 }
2284
2285 /*
2286 * Create events associated with an event_enabler (if not already present),
2287 * and add backward reference from the event to the enabler.
2288 * Should be called with sessions mutex held.
2289 */
2290 static
2291 int lttng_event_enabler_ref_events(struct lttng_event_enabler *event_enabler)
2292 {
2293 struct lttng_kernel_channel_buffer *chan = event_enabler->chan;
2294 struct lttng_kernel_session *session = event_enabler->chan->parent.session;
2295 struct lttng_enabler *base_enabler = lttng_event_enabler_as_enabler(event_enabler);
2296 struct lttng_kernel_event_recorder_private *event_recorder_priv;
2297
2298 if (base_enabler->event_param.instrumentation == LTTNG_KERNEL_ABI_SYSCALL &&
2299 base_enabler->event_param.u.syscall.abi == LTTNG_KERNEL_ABI_SYSCALL_ABI_ALL &&
2300 base_enabler->event_param.u.syscall.match == LTTNG_KERNEL_ABI_SYSCALL_MATCH_NAME &&
2301 !strcmp(base_enabler->event_param.name, "*")) {
2302 int enabled = base_enabler->enabled;
2303 enum lttng_kernel_abi_syscall_entryexit entryexit = base_enabler->event_param.u.syscall.entryexit;
2304
2305 if (entryexit == LTTNG_KERNEL_ABI_SYSCALL_ENTRY || entryexit == LTTNG_KERNEL_ABI_SYSCALL_ENTRYEXIT)
2306 WRITE_ONCE(chan->priv->parent.syscall_all_entry, enabled);
2307
2308 if (entryexit == LTTNG_KERNEL_ABI_SYSCALL_EXIT || entryexit == LTTNG_KERNEL_ABI_SYSCALL_ENTRYEXIT)
2309 WRITE_ONCE(chan->priv->parent.syscall_all_exit, enabled);
2310 }
2311
2312 /* First ensure that probe events are created for this enabler. */
2313 lttng_create_event_if_missing(event_enabler);
2314
2315 /* For each event matching event_enabler in session event list. */
2316 list_for_each_entry(event_recorder_priv, &session->priv->events, node) {
2317 struct lttng_kernel_event_recorder *event_recorder = event_recorder_priv->pub;
2318 struct lttng_enabler_ref *enabler_ref;
2319
2320 if (!lttng_event_enabler_match_event(event_enabler, event_recorder))
2321 continue;
2322 enabler_ref = lttng_enabler_ref(&event_recorder_priv->parent.enablers_ref_head,
2323 lttng_event_enabler_as_enabler(event_enabler));
2324 if (!enabler_ref) {
2325 /*
2326 * If no backward ref, create it.
2327 * Add backward ref from event to event_enabler.
2328 */
2329 enabler_ref = kzalloc(sizeof(*enabler_ref), GFP_KERNEL);
2330 if (!enabler_ref)
2331 return -ENOMEM;
2332 enabler_ref->ref = lttng_event_enabler_as_enabler(event_enabler);
2333 list_add(&enabler_ref->node,
2334 &event_recorder_priv->parent.enablers_ref_head);
2335 }
2336
2337 /*
2338 * Link filter bytecodes if not linked yet.
2339 */
2340 lttng_enabler_link_bytecode(event_recorder_priv->parent.desc,
2341 lttng_static_ctx,
2342 &event_recorder_priv->parent.filter_bytecode_runtime_head,
2343 &lttng_event_enabler_as_enabler(event_enabler)->filter_bytecode_head);
2344 }
2345 return 0;
2346 }
2347
2348 /*
2349 * Create struct lttng_kernel_event_notifier if it is missing and present in the list of
2350 * tracepoint probes.
2351 * Should be called with sessions mutex held.
2352 */
2353 static
2354 void lttng_create_event_notifier_if_missing(struct lttng_event_notifier_enabler *event_notifier_enabler)
2355 {
2356 switch (event_notifier_enabler->base.event_param.instrumentation) {
2357 case LTTNG_KERNEL_ABI_TRACEPOINT:
2358 lttng_create_tracepoint_event_notifier_if_missing(event_notifier_enabler);
2359 break;
2360
2361 case LTTNG_KERNEL_ABI_SYSCALL:
2362 lttng_create_syscall_event_notifier_if_missing(event_notifier_enabler);
2363 break;
2364
2365 default:
2366 WARN_ON_ONCE(1);
2367 break;
2368 }
2369 }
2370
2371 /*
2372 * Create event_notifiers associated with a event_notifier enabler (if not already present).
2373 */
2374 static
2375 int lttng_event_notifier_enabler_ref_event_notifiers(
2376 struct lttng_event_notifier_enabler *event_notifier_enabler)
2377 {
2378 struct lttng_event_notifier_group *event_notifier_group = event_notifier_enabler->group;
2379 struct lttng_enabler *base_enabler = lttng_event_notifier_enabler_as_enabler(event_notifier_enabler);
2380 struct lttng_kernel_event_notifier_private *event_notifier_priv;
2381
2382 if (base_enabler->event_param.instrumentation == LTTNG_KERNEL_ABI_SYSCALL &&
2383 base_enabler->event_param.u.syscall.abi == LTTNG_KERNEL_ABI_SYSCALL_ABI_ALL &&
2384 base_enabler->event_param.u.syscall.match == LTTNG_KERNEL_ABI_SYSCALL_MATCH_NAME &&
2385 !strcmp(base_enabler->event_param.name, "*")) {
2386
2387 int enabled = base_enabler->enabled;
2388 enum lttng_kernel_abi_syscall_entryexit entryexit = base_enabler->event_param.u.syscall.entryexit;
2389
2390 if (entryexit == LTTNG_KERNEL_ABI_SYSCALL_ENTRY || entryexit == LTTNG_KERNEL_ABI_SYSCALL_ENTRYEXIT)
2391 WRITE_ONCE(event_notifier_group->syscall_all_entry, enabled);
2392
2393 if (entryexit == LTTNG_KERNEL_ABI_SYSCALL_EXIT || entryexit == LTTNG_KERNEL_ABI_SYSCALL_ENTRYEXIT)
2394 WRITE_ONCE(event_notifier_group->syscall_all_exit, enabled);
2395
2396 }
2397
2398 /* First ensure that probe event_notifiers are created for this enabler. */
2399 lttng_create_event_notifier_if_missing(event_notifier_enabler);
2400
2401 /* Link the created event_notifier with its associated enabler. */
2402 list_for_each_entry(event_notifier_priv, &event_notifier_group->event_notifiers_head, node) {
2403 struct lttng_kernel_event_notifier *event_notifier = event_notifier_priv->pub;
2404 struct lttng_enabler_ref *enabler_ref;
2405
2406 if (!lttng_event_notifier_enabler_match_event_notifier(event_notifier_enabler, event_notifier))
2407 continue;
2408
2409 enabler_ref = lttng_enabler_ref(&event_notifier_priv->parent.enablers_ref_head,
2410 lttng_event_notifier_enabler_as_enabler(event_notifier_enabler));
2411 if (!enabler_ref) {
2412 /*
2413 * If no backward ref, create it.
2414 * Add backward ref from event_notifier to enabler.
2415 */
2416 enabler_ref = kzalloc(sizeof(*enabler_ref), GFP_KERNEL);
2417 if (!enabler_ref)
2418 return -ENOMEM;
2419
2420 enabler_ref->ref = lttng_event_notifier_enabler_as_enabler(
2421 event_notifier_enabler);
2422 list_add(&enabler_ref->node,
2423 &event_notifier_priv->parent.enablers_ref_head);
2424 }
2425
2426 /*
2427 * Link filter bytecodes if not linked yet.
2428 */
2429 lttng_enabler_link_bytecode(event_notifier_priv->parent.desc,
2430 lttng_static_ctx, &event_notifier_priv->parent.filter_bytecode_runtime_head,
2431 &lttng_event_notifier_enabler_as_enabler(event_notifier_enabler)->filter_bytecode_head);
2432
2433 /* Link capture bytecodes if not linked yet. */
2434 lttng_enabler_link_bytecode(event_notifier_priv->parent.desc,
2435 lttng_static_ctx, &event_notifier_priv->capture_bytecode_runtime_head,
2436 &event_notifier_enabler->capture_bytecode_head);
2437
2438 event_notifier_priv->num_captures = event_notifier_enabler->num_captures;
2439 }
2440 return 0;
2441 }
2442
2443 /*
2444 * Called at module load: connect the probe on all enablers matching
2445 * this event.
2446 * Called with sessions lock held.
2447 */
2448 int lttng_fix_pending_events(void)
2449 {
2450 struct lttng_kernel_session_private *session_priv;
2451
2452 list_for_each_entry(session_priv, &sessions, list)
2453 lttng_session_lazy_sync_event_enablers(session_priv->pub);
2454 return 0;
2455 }
2456
2457 static bool lttng_event_notifier_group_has_active_event_notifiers(
2458 struct lttng_event_notifier_group *event_notifier_group)
2459 {
2460 struct lttng_event_notifier_enabler *event_notifier_enabler;
2461
2462 list_for_each_entry(event_notifier_enabler, &event_notifier_group->enablers_head,
2463 node) {
2464 if (event_notifier_enabler->base.enabled)
2465 return true;
2466 }
2467 return false;
2468 }
2469
2470 bool lttng_event_notifier_active(void)
2471 {
2472 struct lttng_event_notifier_group *event_notifier_group;
2473
2474 list_for_each_entry(event_notifier_group, &event_notifier_groups, node) {
2475 if (lttng_event_notifier_group_has_active_event_notifiers(event_notifier_group))
2476 return true;
2477 }
2478 return false;
2479 }
2480
2481 int lttng_fix_pending_event_notifiers(void)
2482 {
2483 struct lttng_event_notifier_group *event_notifier_group;
2484
2485 list_for_each_entry(event_notifier_group, &event_notifier_groups, node)
2486 lttng_event_notifier_group_sync_enablers(event_notifier_group);
2487 return 0;
2488 }
2489
2490 struct lttng_event_enabler *lttng_event_enabler_create(
2491 enum lttng_enabler_format_type format_type,
2492 struct lttng_kernel_abi_event *event_param,
2493 struct lttng_kernel_channel_buffer *chan)
2494 {
2495 struct lttng_event_enabler *event_enabler;
2496
2497 event_enabler = kzalloc(sizeof(*event_enabler), GFP_KERNEL);
2498 if (!event_enabler)
2499 return NULL;
2500 event_enabler->base.format_type = format_type;
2501 INIT_LIST_HEAD(&event_enabler->base.filter_bytecode_head);
2502 memcpy(&event_enabler->base.event_param, event_param,
2503 sizeof(event_enabler->base.event_param));
2504 event_enabler->chan = chan;
2505 /* ctx left NULL */
2506 event_enabler->base.enabled = 0;
2507 mutex_lock(&sessions_mutex);
2508 list_add(&event_enabler->node, &event_enabler->chan->parent.session->priv->enablers_head);
2509 lttng_session_lazy_sync_event_enablers(event_enabler->chan->parent.session);
2510 mutex_unlock(&sessions_mutex);
2511 return event_enabler;
2512 }
2513
2514 int lttng_event_enabler_enable(struct lttng_event_enabler *event_enabler)
2515 {
2516 mutex_lock(&sessions_mutex);
2517 lttng_event_enabler_as_enabler(event_enabler)->enabled = 1;
2518 lttng_session_lazy_sync_event_enablers(event_enabler->chan->parent.session);
2519 mutex_unlock(&sessions_mutex);
2520 return 0;
2521 }
2522
2523 int lttng_event_enabler_disable(struct lttng_event_enabler *event_enabler)
2524 {
2525 mutex_lock(&sessions_mutex);
2526 lttng_event_enabler_as_enabler(event_enabler)->enabled = 0;
2527 lttng_session_lazy_sync_event_enablers(event_enabler->chan->parent.session);
2528 mutex_unlock(&sessions_mutex);
2529 return 0;
2530 }
2531
2532 static
2533 int lttng_enabler_attach_filter_bytecode(struct lttng_enabler *enabler,
2534 struct lttng_kernel_abi_filter_bytecode __user *bytecode)
2535 {
2536 struct lttng_kernel_bytecode_node *bytecode_node;
2537 uint32_t bytecode_len;
2538 int ret;
2539
2540 ret = get_user(bytecode_len, &bytecode->len);
2541 if (ret)
2542 return ret;
2543 bytecode_node = lttng_kvzalloc(sizeof(*bytecode_node) + bytecode_len,
2544 GFP_KERNEL);
2545 if (!bytecode_node)
2546 return -ENOMEM;
2547 ret = copy_from_user(&bytecode_node->bc, bytecode,
2548 sizeof(*bytecode) + bytecode_len);
2549 if (ret)
2550 goto error_free;
2551
2552 bytecode_node->type = LTTNG_KERNEL_BYTECODE_TYPE_FILTER;
2553 bytecode_node->enabler = enabler;
2554 /* Enforce length based on allocated size */
2555 bytecode_node->bc.len = bytecode_len;
2556 list_add_tail(&bytecode_node->node, &enabler->filter_bytecode_head);
2557
2558 return 0;
2559
2560 error_free:
2561 lttng_kvfree(bytecode_node);
2562 return ret;
2563 }
2564
2565 int lttng_event_enabler_attach_filter_bytecode(struct lttng_event_enabler *event_enabler,
2566 struct lttng_kernel_abi_filter_bytecode __user *bytecode)
2567 {
2568 int ret;
2569 ret = lttng_enabler_attach_filter_bytecode(
2570 lttng_event_enabler_as_enabler(event_enabler), bytecode);
2571 if (ret)
2572 goto error;
2573
2574 lttng_session_lazy_sync_event_enablers(event_enabler->chan->parent.session);
2575 return 0;
2576
2577 error:
2578 return ret;
2579 }
2580
2581 int lttng_event_add_callsite(struct lttng_kernel_event_common *event,
2582 struct lttng_kernel_abi_event_callsite __user *callsite)
2583 {
2584
2585 switch (event->priv->instrumentation) {
2586 case LTTNG_KERNEL_ABI_UPROBE:
2587 return lttng_uprobes_event_add_callsite(event, callsite);
2588 default:
2589 return -EINVAL;
2590 }
2591 }
2592
2593 static
2594 void lttng_enabler_destroy(struct lttng_enabler *enabler)
2595 {
2596 struct lttng_kernel_bytecode_node *filter_node, *tmp_filter_node;
2597
2598 /* Destroy filter bytecode */
2599 list_for_each_entry_safe(filter_node, tmp_filter_node,
2600 &enabler->filter_bytecode_head, node) {
2601 lttng_kvfree(filter_node);
2602 }
2603 }
2604
2605 static
2606 void lttng_event_enabler_destroy(struct lttng_event_enabler *event_enabler)
2607 {
2608 lttng_enabler_destroy(lttng_event_enabler_as_enabler(event_enabler));
2609
2610 list_del(&event_enabler->node);
2611 kfree(event_enabler);
2612 }
2613
2614 struct lttng_event_notifier_enabler *lttng_event_notifier_enabler_create(
2615 struct lttng_event_notifier_group *event_notifier_group,
2616 enum lttng_enabler_format_type format_type,
2617 struct lttng_kernel_abi_event_notifier *event_notifier_param)
2618 {
2619 struct lttng_event_notifier_enabler *event_notifier_enabler;
2620
2621 event_notifier_enabler = kzalloc(sizeof(*event_notifier_enabler), GFP_KERNEL);
2622 if (!event_notifier_enabler)
2623 return NULL;
2624
2625 event_notifier_enabler->base.format_type = format_type;
2626 INIT_LIST_HEAD(&event_notifier_enabler->base.filter_bytecode_head);
2627 INIT_LIST_HEAD(&event_notifier_enabler->capture_bytecode_head);
2628
2629 event_notifier_enabler->error_counter_index = event_notifier_param->error_counter_index;
2630 event_notifier_enabler->num_captures = 0;
2631
2632 memcpy(&event_notifier_enabler->base.event_param, &event_notifier_param->event,
2633 sizeof(event_notifier_enabler->base.event_param));
2634
2635 event_notifier_enabler->base.enabled = 0;
2636 event_notifier_enabler->base.user_token = event_notifier_param->event.token;
2637 event_notifier_enabler->group = event_notifier_group;
2638
2639 mutex_lock(&sessions_mutex);
2640 list_add(&event_notifier_enabler->node, &event_notifier_enabler->group->enablers_head);
2641 lttng_event_notifier_group_sync_enablers(event_notifier_enabler->group);
2642
2643 mutex_unlock(&sessions_mutex);
2644
2645 return event_notifier_enabler;
2646 }
2647
2648 int lttng_event_notifier_enabler_enable(
2649 struct lttng_event_notifier_enabler *event_notifier_enabler)
2650 {
2651 mutex_lock(&sessions_mutex);
2652 lttng_event_notifier_enabler_as_enabler(event_notifier_enabler)->enabled = 1;
2653 lttng_event_notifier_group_sync_enablers(event_notifier_enabler->group);
2654 mutex_unlock(&sessions_mutex);
2655 return 0;
2656 }
2657
2658 int lttng_event_notifier_enabler_disable(
2659 struct lttng_event_notifier_enabler *event_notifier_enabler)
2660 {
2661 mutex_lock(&sessions_mutex);
2662 lttng_event_notifier_enabler_as_enabler(event_notifier_enabler)->enabled = 0;
2663 lttng_event_notifier_group_sync_enablers(event_notifier_enabler->group);
2664 mutex_unlock(&sessions_mutex);
2665 return 0;
2666 }
2667
2668 int lttng_event_notifier_enabler_attach_filter_bytecode(
2669 struct lttng_event_notifier_enabler *event_notifier_enabler,
2670 struct lttng_kernel_abi_filter_bytecode __user *bytecode)
2671 {
2672 int ret;
2673
2674 ret = lttng_enabler_attach_filter_bytecode(
2675 lttng_event_notifier_enabler_as_enabler(event_notifier_enabler),
2676 bytecode);
2677 if (ret)
2678 goto error;
2679
2680 lttng_event_notifier_group_sync_enablers(event_notifier_enabler->group);
2681 return 0;
2682
2683 error:
2684 return ret;
2685 }
2686
2687 int lttng_event_notifier_enabler_attach_capture_bytecode(
2688 struct lttng_event_notifier_enabler *event_notifier_enabler,
2689 struct lttng_kernel_abi_capture_bytecode __user *bytecode)
2690 {
2691 struct lttng_kernel_bytecode_node *bytecode_node;
2692 struct lttng_enabler *enabler =
2693 lttng_event_notifier_enabler_as_enabler(event_notifier_enabler);
2694 uint32_t bytecode_len;
2695 int ret;
2696
2697 ret = get_user(bytecode_len, &bytecode->len);
2698 if (ret)
2699 return ret;
2700
2701 bytecode_node = lttng_kvzalloc(sizeof(*bytecode_node) + bytecode_len,
2702 GFP_KERNEL);
2703 if (!bytecode_node)
2704 return -ENOMEM;
2705
2706 ret = copy_from_user(&bytecode_node->bc, bytecode,
2707 sizeof(*bytecode) + bytecode_len);
2708 if (ret)
2709 goto error_free;
2710
2711 bytecode_node->type = LTTNG_KERNEL_BYTECODE_TYPE_CAPTURE;
2712 bytecode_node->enabler = enabler;
2713
2714 /* Enforce length based on allocated size */
2715 bytecode_node->bc.len = bytecode_len;
2716 list_add_tail(&bytecode_node->node, &event_notifier_enabler->capture_bytecode_head);
2717
2718 event_notifier_enabler->num_captures++;
2719
2720 lttng_event_notifier_group_sync_enablers(event_notifier_enabler->group);
2721 goto end;
2722
2723 error_free:
2724 lttng_kvfree(bytecode_node);
2725 end:
2726 return ret;
2727 }
2728
2729 static
2730 void lttng_event_notifier_enabler_destroy(
2731 struct lttng_event_notifier_enabler *event_notifier_enabler)
2732 {
2733 if (!event_notifier_enabler) {
2734 return;
2735 }
2736
2737 list_del(&event_notifier_enabler->node);
2738
2739 lttng_enabler_destroy(lttng_event_notifier_enabler_as_enabler(event_notifier_enabler));
2740 kfree(event_notifier_enabler);
2741 }
2742
2743 /*
2744 * lttng_session_sync_event_enablers should be called just before starting a
2745 * session.
2746 * Should be called with sessions mutex held.
2747 */
2748 static
2749 void lttng_session_sync_event_enablers(struct lttng_kernel_session *session)
2750 {
2751 struct lttng_event_enabler *event_enabler;
2752 struct lttng_kernel_event_recorder_private *event_recorder_priv;
2753
2754 list_for_each_entry(event_enabler, &session->priv->enablers_head, node)
2755 lttng_event_enabler_ref_events(event_enabler);
2756 /*
2757 * For each event, if at least one of its enablers is enabled,
2758 * and its channel and session transient states are enabled, we
2759 * enable the event, else we disable it.
2760 */
2761 list_for_each_entry(event_recorder_priv, &session->priv->events, node) {
2762 struct lttng_kernel_event_recorder *event_recorder = event_recorder_priv->pub;
2763 struct lttng_enabler_ref *enabler_ref;
2764 struct lttng_kernel_bytecode_runtime *runtime;
2765 int enabled = 0, has_enablers_without_filter_bytecode = 0;
2766 int nr_filters = 0;
2767
2768 switch (event_recorder_priv->parent.instrumentation) {
2769 case LTTNG_KERNEL_ABI_TRACEPOINT:
2770 lttng_fallthrough;
2771 case LTTNG_KERNEL_ABI_SYSCALL:
2772 /* Enable events */
2773 list_for_each_entry(enabler_ref,
2774 &event_recorder_priv->parent.enablers_ref_head, node) {
2775 if (enabler_ref->ref->enabled) {
2776 enabled = 1;
2777 break;
2778 }
2779 }
2780 break;
2781
2782 default:
2783 /* Not handled with lazy sync. */
2784 continue;
2785 }
2786 /*
2787 * Enabled state is based on union of enablers, with
2788 * intesection of session and channel transient enable
2789 * states.
2790 */
2791 enabled = enabled && session->priv->tstate && event_recorder->chan->priv->parent.tstate;
2792
2793 WRITE_ONCE(event_recorder->parent.enabled, enabled);
2794 /*
2795 * Sync tracepoint registration with event enabled
2796 * state.
2797 */
2798 if (enabled) {
2799 if (!event_recorder_priv->parent.registered)
2800 register_event(event_recorder);
2801 } else {
2802 if (event_recorder_priv->parent.registered)
2803 _lttng_event_unregister(event_recorder);
2804 }
2805
2806 /* Check if has enablers without bytecode enabled */
2807 list_for_each_entry(enabler_ref,
2808 &event_recorder_priv->parent.enablers_ref_head, node) {
2809 if (enabler_ref->ref->enabled
2810 && list_empty(&enabler_ref->ref->filter_bytecode_head)) {
2811 has_enablers_without_filter_bytecode = 1;
2812 break;
2813 }
2814 }
2815 event_recorder_priv->parent.has_enablers_without_filter_bytecode =
2816 has_enablers_without_filter_bytecode;
2817
2818 /* Enable filters */
2819 list_for_each_entry(runtime,
2820 &event_recorder_priv->parent.filter_bytecode_runtime_head, node) {
2821 lttng_bytecode_sync_state(runtime);
2822 nr_filters++;
2823 }
2824 WRITE_ONCE(event_recorder_priv->parent.pub->eval_filter,
2825 !(has_enablers_without_filter_bytecode || !nr_filters));
2826 }
2827 }
2828
2829 /*
2830 * Apply enablers to session events, adding events to session if need
2831 * be. It is required after each modification applied to an active
2832 * session, and right before session "start".
2833 * "lazy" sync means we only sync if required.
2834 * Should be called with sessions mutex held.
2835 */
2836 static
2837 void lttng_session_lazy_sync_event_enablers(struct lttng_kernel_session *session)
2838 {
2839 /* We can skip if session is not active */
2840 if (!session->active)
2841 return;
2842 lttng_session_sync_event_enablers(session);
2843 }
2844
2845 static
2846 void lttng_event_notifier_group_sync_enablers(struct lttng_event_notifier_group *event_notifier_group)
2847 {
2848 struct lttng_event_notifier_enabler *event_notifier_enabler;
2849 struct lttng_kernel_event_notifier_private *event_notifier_priv;
2850
2851 list_for_each_entry(event_notifier_enabler, &event_notifier_group->enablers_head, node)
2852 lttng_event_notifier_enabler_ref_event_notifiers(event_notifier_enabler);
2853
2854 /*
2855 * For each event_notifier, if at least one of its enablers is enabled,
2856 * we enable the event_notifier, else we disable it.
2857 */
2858 list_for_each_entry(event_notifier_priv, &event_notifier_group->event_notifiers_head, node) {
2859 struct lttng_kernel_event_notifier *event_notifier = event_notifier_priv->pub;
2860 struct lttng_enabler_ref *enabler_ref;
2861 struct lttng_kernel_bytecode_runtime *runtime;
2862 int enabled = 0, has_enablers_without_filter_bytecode = 0;
2863 int nr_filters = 0, nr_captures = 0;
2864
2865 switch (event_notifier_priv->parent.instrumentation) {
2866 case LTTNG_KERNEL_ABI_TRACEPOINT:
2867 lttng_fallthrough;
2868 case LTTNG_KERNEL_ABI_SYSCALL:
2869 /* Enable event_notifiers */
2870 list_for_each_entry(enabler_ref,
2871 &event_notifier_priv->parent.enablers_ref_head, node) {
2872 if (enabler_ref->ref->enabled) {
2873 enabled = 1;
2874 break;
2875 }
2876 }
2877 break;
2878
2879 default:
2880 /* Not handled with sync. */
2881 continue;
2882 }
2883
2884 WRITE_ONCE(event_notifier->parent.enabled, enabled);
2885 /*
2886 * Sync tracepoint registration with event_notifier enabled
2887 * state.
2888 */
2889 if (enabled) {
2890 if (!event_notifier_priv->parent.registered)
2891 register_event_notifier(event_notifier);
2892 } else {
2893 if (event_notifier_priv->parent.registered)
2894 unregister_event_notifier(event_notifier);
2895 }
2896
2897 /* Check if has enablers without bytecode enabled */
2898 list_for_each_entry(enabler_ref,
2899 &event_notifier_priv->parent.enablers_ref_head, node) {
2900 if (enabler_ref->ref->enabled
2901 && list_empty(&enabler_ref->ref->filter_bytecode_head)) {
2902 has_enablers_without_filter_bytecode = 1;
2903 break;
2904 }
2905 }
2906 event_notifier_priv->parent.has_enablers_without_filter_bytecode =
2907 has_enablers_without_filter_bytecode;
2908
2909 /* Enable filters */
2910 list_for_each_entry(runtime,
2911 &event_notifier_priv->parent.filter_bytecode_runtime_head, node) {
2912 lttng_bytecode_sync_state(runtime);
2913 nr_filters++;
2914 }
2915 WRITE_ONCE(event_notifier_priv->parent.pub->eval_filter,
2916 !(has_enablers_without_filter_bytecode || !nr_filters));
2917
2918 /* Enable captures */
2919 list_for_each_entry(runtime,
2920 &event_notifier_priv->capture_bytecode_runtime_head, node) {
2921 lttng_bytecode_sync_state(runtime);
2922 nr_captures++;
2923 }
2924 WRITE_ONCE(event_notifier->eval_capture, !!nr_captures);
2925 }
2926 }
2927
2928 /*
2929 * Serialize at most one packet worth of metadata into a metadata
2930 * channel.
2931 * We grab the metadata cache mutex to get exclusive access to our metadata
2932 * buffer and to the metadata cache. Exclusive access to the metadata buffer
2933 * allows us to do racy operations such as looking for remaining space left in
2934 * packet and write, since mutual exclusion protects us from concurrent writes.
2935 * Mutual exclusion on the metadata cache allow us to read the cache content
2936 * without racing against reallocation of the cache by updates.
2937 * Returns the number of bytes written in the channel, 0 if no data
2938 * was written and a negative value on error.
2939 */
2940 int lttng_metadata_output_channel(struct lttng_metadata_stream *stream,
2941 struct lttng_kernel_ring_buffer_channel *chan, bool *coherent)
2942 {
2943 struct lttng_kernel_ring_buffer_ctx ctx;
2944 int ret = 0;
2945 size_t len, reserve_len;
2946
2947 /*
2948 * Ensure we support mutiple get_next / put sequences followed by
2949 * put_next. The metadata cache lock protects reading the metadata
2950 * cache. It can indeed be read concurrently by "get_next_subbuf" and
2951 * "flush" operations on the buffer invoked by different processes.
2952 * Moreover, since the metadata cache memory can be reallocated, we
2953 * need to have exclusive access against updates even though we only
2954 * read it.
2955 */
2956 mutex_lock(&stream->metadata_cache->lock);
2957 WARN_ON(stream->metadata_in < stream->metadata_out);
2958 if (stream->metadata_in != stream->metadata_out)
2959 goto end;
2960
2961 /* Metadata regenerated, change the version. */
2962 if (stream->metadata_cache->version != stream->version)
2963 stream->version = stream->metadata_cache->version;
2964
2965 len = stream->metadata_cache->metadata_written -
2966 stream->metadata_in;
2967 if (!len)
2968 goto end;
2969 reserve_len = min_t(size_t,
2970 stream->transport->ops.priv->packet_avail_size(chan),
2971 len);
2972 lib_ring_buffer_ctx_init(&ctx, chan, reserve_len,
2973 sizeof(char), NULL);
2974 /*
2975 * If reservation failed, return an error to the caller.
2976 */
2977 ret = stream->transport->ops.event_reserve(&ctx);
2978 if (ret != 0) {
2979 printk(KERN_WARNING "LTTng: Metadata event reservation failed\n");
2980 stream->coherent = false;
2981 goto end;
2982 }
2983 stream->transport->ops.event_write(&ctx,
2984 stream->metadata_cache->data + stream->metadata_in,
2985 reserve_len, 1);
2986 stream->transport->ops.event_commit(&ctx);
2987 stream->metadata_in += reserve_len;
2988 if (reserve_len < len)
2989 stream->coherent = false;
2990 else
2991 stream->coherent = true;
2992 ret = reserve_len;
2993
2994 end:
2995 if (coherent)
2996 *coherent = stream->coherent;
2997 mutex_unlock(&stream->metadata_cache->lock);
2998 return ret;
2999 }
3000
3001 static
3002 void lttng_metadata_begin(struct lttng_kernel_session *session)
3003 {
3004 if (atomic_inc_return(&session->priv->metadata_cache->producing) == 1)
3005 mutex_lock(&session->priv->metadata_cache->lock);
3006 }
3007
3008 static
3009 void lttng_metadata_end(struct lttng_kernel_session *session)
3010 {
3011 WARN_ON_ONCE(!atomic_read(&session->priv->metadata_cache->producing));
3012 if (atomic_dec_return(&session->priv->metadata_cache->producing) == 0) {
3013 struct lttng_metadata_stream *stream;
3014
3015 list_for_each_entry(stream, &session->priv->metadata_cache->metadata_stream, list)
3016 wake_up_interruptible(&stream->read_wait);
3017 mutex_unlock(&session->priv->metadata_cache->lock);
3018 }
3019 }
3020
3021 /*
3022 * Write the metadata to the metadata cache.
3023 * Must be called with sessions_mutex held.
3024 * The metadata cache lock protects us from concurrent read access from
3025 * thread outputting metadata content to ring buffer.
3026 * The content of the printf is printed as a single atomic metadata
3027 * transaction.
3028 */
3029 int lttng_metadata_printf(struct lttng_kernel_session *session,
3030 const char *fmt, ...)
3031 {
3032 char *str;
3033 size_t len;
3034 va_list ap;
3035
3036 WARN_ON_ONCE(!LTTNG_READ_ONCE(session->active));
3037
3038 va_start(ap, fmt);
3039 str = kvasprintf(GFP_KERNEL, fmt, ap);
3040 va_end(ap);
3041 if (!str)
3042 return -ENOMEM;
3043
3044 len = strlen(str);
3045 WARN_ON_ONCE(!atomic_read(&session->priv->metadata_cache->producing));
3046 if (session->priv->metadata_cache->metadata_written + len >
3047 session->priv->metadata_cache->cache_alloc) {
3048 char *tmp_cache_realloc;
3049 unsigned int tmp_cache_alloc_size;
3050
3051 tmp_cache_alloc_size = max_t(unsigned int,
3052 session->priv->metadata_cache->cache_alloc + len,
3053 session->priv->metadata_cache->cache_alloc << 1);
3054 tmp_cache_realloc = vzalloc(tmp_cache_alloc_size);
3055 if (!tmp_cache_realloc)
3056 goto err;
3057 if (session->priv->metadata_cache->data) {
3058 memcpy(tmp_cache_realloc,
3059 session->priv->metadata_cache->data,
3060 session->priv->metadata_cache->cache_alloc);
3061 vfree(session->priv->metadata_cache->data);
3062 }
3063
3064 session->priv->metadata_cache->cache_alloc = tmp_cache_alloc_size;
3065 session->priv->metadata_cache->data = tmp_cache_realloc;
3066 }
3067 memcpy(session->priv->metadata_cache->data +
3068 session->priv->metadata_cache->metadata_written,
3069 str, len);
3070 session->priv->metadata_cache->metadata_written += len;
3071 kfree(str);
3072
3073 return 0;
3074
3075 err:
3076 kfree(str);
3077 return -ENOMEM;
3078 }
3079
3080 static
3081 int print_tabs(struct lttng_kernel_session *session, size_t nesting)
3082 {
3083 size_t i;
3084
3085 for (i = 0; i < nesting; i++) {
3086 int ret;
3087
3088 ret = lttng_metadata_printf(session, " ");
3089 if (ret) {
3090 return ret;
3091 }
3092 }
3093 return 0;
3094 }
3095
3096 static
3097 int lttng_field_name_statedump(struct lttng_kernel_session *session,
3098 const struct lttng_kernel_event_field *field,
3099 size_t nesting)
3100 {
3101 return lttng_metadata_printf(session, " _%s;\n", field->name);
3102 }
3103
3104 static
3105 int _lttng_integer_type_statedump(struct lttng_kernel_session *session,
3106 const struct lttng_kernel_type_integer *type,
3107 enum lttng_kernel_string_encoding parent_encoding,
3108 size_t nesting)
3109 {
3110 int ret;
3111
3112 ret = print_tabs(session, nesting);
3113 if (ret)
3114 return ret;
3115 ret = lttng_metadata_printf(session,
3116 "integer { size = %u; align = %u; signed = %u; encoding = %s; base = %u;%s }",
3117 type->size,
3118 type->alignment,
3119 type->signedness,
3120 (parent_encoding == lttng_kernel_string_encoding_none)
3121 ? "none"
3122 : (parent_encoding == lttng_kernel_string_encoding_UTF8)
3123 ? "UTF8"
3124 : "ASCII",
3125 type->base,
3126 #if __BYTE_ORDER == __BIG_ENDIAN
3127 type->reverse_byte_order ? " byte_order = le;" : ""
3128 #else
3129 type->reverse_byte_order ? " byte_order = be;" : ""
3130 #endif
3131 );
3132 return ret;
3133 }
3134
3135 /*
3136 * Must be called with sessions_mutex held.
3137 */
3138 static
3139 int _lttng_struct_type_statedump(struct lttng_kernel_session *session,
3140 const struct lttng_kernel_type_struct *type,
3141 size_t nesting)
3142 {
3143 const char *prev_field_name = NULL;
3144 int ret;
3145 uint32_t i, nr_fields;
3146 unsigned int alignment;
3147
3148 ret = print_tabs(session, nesting);
3149 if (ret)
3150 return ret;
3151 ret = lttng_metadata_printf(session,
3152 "struct {\n");
3153 if (ret)
3154 return ret;
3155 nr_fields = type->nr_fields;
3156 for (i = 0; i < nr_fields; i++) {
3157 const struct lttng_kernel_event_field *iter_field;
3158
3159 iter_field = type->fields[i];
3160 ret = _lttng_field_statedump(session, iter_field, nesting + 1, &prev_field_name);
3161 if (ret)
3162 return ret;
3163 }
3164 ret = print_tabs(session, nesting);
3165 if (ret)
3166 return ret;
3167 alignment = type->alignment;
3168 if (alignment) {
3169 ret = lttng_metadata_printf(session,
3170 "} align(%u)",
3171 alignment);
3172 } else {
3173 ret = lttng_metadata_printf(session,
3174 "}");
3175 }
3176 return ret;
3177 }
3178
3179 /*
3180 * Must be called with sessions_mutex held.
3181 */
3182 static
3183 int _lttng_struct_field_statedump(struct lttng_kernel_session *session,
3184 const struct lttng_kernel_event_field *field,
3185 size_t nesting)
3186 {
3187 int ret;
3188
3189 ret = _lttng_struct_type_statedump(session,
3190 lttng_kernel_get_type_struct(field->type), nesting);
3191 if (ret)
3192 return ret;
3193 return lttng_field_name_statedump(session, field, nesting);
3194 }
3195
3196 /*
3197 * Must be called with sessions_mutex held.
3198 */
3199 static
3200 int _lttng_variant_type_statedump(struct lttng_kernel_session *session,
3201 const struct lttng_kernel_type_variant *type,
3202 size_t nesting,
3203 const char *prev_field_name)
3204 {
3205 const char *tag_name;
3206 int ret;
3207 uint32_t i, nr_choices;
3208
3209 tag_name = type->tag_name;
3210 if (!tag_name)
3211 tag_name = prev_field_name;
3212 if (!tag_name)
3213 return -EINVAL;
3214 /*
3215 * CTF 1.8 does not allow expressing nonzero variant alignment in a nestable way.
3216 */
3217 if (type->alignment != 0)
3218 return -EINVAL;
3219 ret = print_tabs(session, nesting);
3220 if (ret)
3221 return ret;
3222 ret = lttng_metadata_printf(session,
3223 "variant <_%s> {\n",
3224 tag_name);
3225 if (ret)
3226 return ret;
3227 nr_choices = type->nr_choices;
3228 for (i = 0; i < nr_choices; i++) {
3229 const struct lttng_kernel_event_field *iter_field;
3230
3231 iter_field = type->choices[i];
3232 ret = _lttng_field_statedump(session, iter_field, nesting + 1, NULL);
3233 if (ret)
3234 return ret;
3235 }
3236 ret = print_tabs(session, nesting);
3237 if (ret)
3238 return ret;
3239 ret = lttng_metadata_printf(session,
3240 "}");
3241 return ret;
3242 }
3243
3244 /*
3245 * Must be called with sessions_mutex held.
3246 */
3247 static
3248 int _lttng_variant_field_statedump(struct lttng_kernel_session *session,
3249 const struct lttng_kernel_event_field *field,
3250 size_t nesting,
3251 const char *prev_field_name)
3252 {
3253 int ret;
3254
3255 ret = _lttng_variant_type_statedump(session,
3256 lttng_kernel_get_type_variant(field->type), nesting,
3257 prev_field_name);
3258 if (ret)
3259 return ret;
3260 return lttng_field_name_statedump(session, field, nesting);
3261 }
3262
3263 /*
3264 * Must be called with sessions_mutex held.
3265 */
3266 static
3267 int _lttng_array_field_statedump(struct lttng_kernel_session *session,
3268 const struct lttng_kernel_event_field *field,
3269 size_t nesting)
3270 {
3271 int ret;
3272 const struct lttng_kernel_type_array *array_type;
3273 const struct lttng_kernel_type_common *elem_type;
3274
3275 array_type = lttng_kernel_get_type_array(field->type);
3276 WARN_ON_ONCE(!array_type);
3277
3278 if (array_type->alignment) {
3279 ret = print_tabs(session, nesting);
3280 if (ret)
3281 return ret;
3282 ret = lttng_metadata_printf(session,
3283 "struct { } align(%u) _%s_padding;\n",
3284 array_type->alignment * CHAR_BIT,
3285 field->name);
3286 if (ret)
3287 return ret;
3288 }
3289 /*
3290 * Nested compound types: Only array of structures and variants are
3291 * currently supported.
3292 */
3293 elem_type = array_type->elem_type;
3294 switch (elem_type->type) {
3295 case lttng_kernel_type_integer:
3296 case lttng_kernel_type_struct:
3297 case lttng_kernel_type_variant:
3298 ret = _lttng_type_statedump(session, elem_type,
3299 array_type->encoding, nesting);
3300 if (ret)
3301 return ret;
3302 break;
3303
3304 default:
3305 return -EINVAL;
3306 }
3307 ret = lttng_metadata_printf(session,
3308 " _%s[%u];\n",
3309 field->name,
3310 array_type->length);
3311 return ret;
3312 }
3313
3314 /*
3315 * Must be called with sessions_mutex held.
3316 */
3317 static
3318 int _lttng_sequence_field_statedump(struct lttng_kernel_session *session,
3319 const struct lttng_kernel_event_field *field,
3320 size_t nesting,
3321 const char *prev_field_name)
3322 {
3323 int ret;
3324 const char *length_name;
3325 const struct lttng_kernel_type_sequence *sequence_type;
3326 const struct lttng_kernel_type_common *elem_type;
3327
3328 sequence_type = lttng_kernel_get_type_sequence(field->type);
3329 WARN_ON_ONCE(!sequence_type);
3330
3331 length_name = sequence_type->length_name;
3332 if (!length_name)
3333 length_name = prev_field_name;
3334 if (!length_name)
3335 return -EINVAL;
3336
3337 if (sequence_type->alignment) {
3338 ret = print_tabs(session, nesting);
3339 if (ret)
3340 return ret;
3341 ret = lttng_metadata_printf(session,
3342 "struct { } align(%u) _%s_padding;\n",
3343 sequence_type->alignment * CHAR_BIT,
3344 field->name);
3345 if (ret)
3346 return ret;
3347 }
3348
3349 /*
3350 * Nested compound types: Only array of structures and variants are
3351 * currently supported.
3352 */
3353 elem_type = sequence_type->elem_type;
3354 switch (elem_type->type) {
3355 case lttng_kernel_type_integer:
3356 case lttng_kernel_type_struct:
3357 case lttng_kernel_type_variant:
3358 ret = _lttng_type_statedump(session, elem_type,
3359 sequence_type->encoding, nesting);
3360 if (ret)
3361 return ret;
3362 break;
3363
3364 default:
3365 return -EINVAL;
3366 }
3367 ret = lttng_metadata_printf(session,
3368 " _%s[ _%s ];\n",
3369 field->name,
3370 length_name);
3371 return ret;
3372 }
3373
3374 /*
3375 * Must be called with sessions_mutex held.
3376 */
3377 static
3378 int _lttng_enum_type_statedump(struct lttng_kernel_session *session,
3379 const struct lttng_kernel_type_enum *type,
3380 size_t nesting)
3381 {
3382 const struct lttng_kernel_enum_desc *enum_desc;
3383 const struct lttng_kernel_type_common *container_type;
3384 int ret;
3385 unsigned int i, nr_entries;
3386
3387 container_type = type->container_type;
3388 if (container_type->type != lttng_kernel_type_integer) {
3389 ret = -EINVAL;
3390 goto end;
3391 }
3392 enum_desc = type->desc;
3393 nr_entries = enum_desc->nr_entries;
3394
3395 ret = print_tabs(session, nesting);
3396 if (ret)
3397 goto end;
3398 ret = lttng_metadata_printf(session, "enum : ");
3399 if (ret)
3400 goto end;
3401 ret = _lttng_integer_type_statedump(session, lttng_kernel_get_type_integer(container_type),
3402 lttng_kernel_string_encoding_none, 0);
3403 if (ret)
3404 goto end;
3405 ret = lttng_metadata_printf(session, " {\n");
3406 if (ret)
3407 goto end;
3408 /* Dump all entries */
3409 for (i = 0; i < nr_entries; i++) {
3410 const struct lttng_kernel_enum_entry *entry = enum_desc->entries[i];
3411 int j, len;
3412
3413 ret = print_tabs(session, nesting + 1);
3414 if (ret)
3415 goto end;
3416 ret = lttng_metadata_printf(session,
3417 "\"");
3418 if (ret)
3419 goto end;
3420 len = strlen(entry->string);
3421 /* Escape the character '"' */
3422 for (j = 0; j < len; j++) {
3423 char c = entry->string[j];
3424
3425 switch (c) {
3426 case '"':
3427 ret = lttng_metadata_printf(session,
3428 "\\\"");
3429 break;
3430 case '\\':
3431 ret = lttng_metadata_printf(session,
3432 "\\\\");
3433 break;
3434 default:
3435 ret = lttng_metadata_printf(session,
3436 "%c", c);
3437 break;
3438 }
3439 if (ret)
3440 goto end;
3441 }
3442 ret = lttng_metadata_printf(session, "\"");
3443 if (ret)
3444 goto end;
3445
3446 if (entry->options.is_auto) {
3447 ret = lttng_metadata_printf(session, ",\n");
3448 if (ret)
3449 goto end;
3450 } else {
3451 ret = lttng_metadata_printf(session,
3452 " = ");
3453 if (ret)
3454 goto end;
3455 if (entry->start.signedness)
3456 ret = lttng_metadata_printf(session,
3457 "%lld", (long long) entry->start.value);
3458 else
3459 ret = lttng_metadata_printf(session,
3460 "%llu", entry->start.value);
3461 if (ret)
3462 goto end;
3463 if (entry->start.signedness == entry->end.signedness &&
3464 entry->start.value
3465 == entry->end.value) {
3466 ret = lttng_metadata_printf(session,
3467 ",\n");
3468 } else {
3469 if (entry->end.signedness) {
3470 ret = lttng_metadata_printf(session,
3471 " ... %lld,\n",
3472 (long long) entry->end.value);
3473 } else {
3474 ret = lttng_metadata_printf(session,
3475 " ... %llu,\n",
3476 entry->end.value);
3477 }
3478 }
3479 if (ret)
3480 goto end;
3481 }
3482 }
3483 ret = print_tabs(session, nesting);
3484 if (ret)
3485 goto end;
3486 ret = lttng_metadata_printf(session, "}");
3487 end:
3488 return ret;
3489 }
3490
3491 /*
3492 * Must be called with sessions_mutex held.
3493 */
3494 static
3495 int _lttng_enum_field_statedump(struct lttng_kernel_session *session,
3496 const struct lttng_kernel_event_field *field,
3497 size_t nesting)
3498 {
3499 int ret;
3500 const struct lttng_kernel_type_enum *enum_type;
3501
3502 enum_type = lttng_kernel_get_type_enum(field->type);
3503 WARN_ON_ONCE(!enum_type);
3504 ret = _lttng_enum_type_statedump(session, enum_type, nesting);
3505 if (ret)
3506 return ret;
3507 return lttng_field_name_statedump(session, field, nesting);
3508 }
3509
3510 static
3511 int _lttng_integer_field_statedump(struct lttng_kernel_session *session,
3512 const struct lttng_kernel_event_field *field,
3513 size_t nesting)
3514 {
3515 int ret;
3516
3517 ret = _lttng_integer_type_statedump(session, lttng_kernel_get_type_integer(field->type),
3518 lttng_kernel_string_encoding_none, nesting);
3519 if (ret)
3520 return ret;
3521 return lttng_field_name_statedump(session, field, nesting);
3522 }
3523
3524 static
3525 int _lttng_string_type_statedump(struct lttng_kernel_session *session,
3526 const struct lttng_kernel_type_string *type,
3527 size_t nesting)
3528 {
3529 int ret;
3530
3531 /* Default encoding is UTF8 */
3532 ret = print_tabs(session, nesting);
3533 if (ret)
3534 return ret;
3535 ret = lttng_metadata_printf(session,
3536 "string%s",
3537 type->encoding == lttng_kernel_string_encoding_ASCII ?
3538 " { encoding = ASCII; }" : "");
3539 return ret;
3540 }
3541
3542 static
3543 int _lttng_string_field_statedump(struct lttng_kernel_session *session,
3544 const struct lttng_kernel_event_field *field,
3545 size_t nesting)
3546 {
3547 const struct lttng_kernel_type_string *string_type;
3548 int ret;
3549
3550 string_type = lttng_kernel_get_type_string(field->type);
3551 WARN_ON_ONCE(!string_type);
3552 ret = _lttng_string_type_statedump(session, string_type, nesting);
3553 if (ret)
3554 return ret;
3555 return lttng_field_name_statedump(session, field, nesting);
3556 }
3557
3558 /*
3559 * Must be called with sessions_mutex held.
3560 */
3561 static
3562 int _lttng_type_statedump(struct lttng_kernel_session *session,
3563 const struct lttng_kernel_type_common *type,
3564 enum lttng_kernel_string_encoding parent_encoding,
3565 size_t nesting)
3566 {
3567 int ret = 0;
3568
3569 switch (type->type) {
3570 case lttng_kernel_type_integer:
3571 ret = _lttng_integer_type_statedump(session,
3572 lttng_kernel_get_type_integer(type),
3573 parent_encoding, nesting);
3574 break;
3575 case lttng_kernel_type_enum:
3576 ret = _lttng_enum_type_statedump(session,
3577 lttng_kernel_get_type_enum(type),
3578 nesting);
3579 break;
3580 case lttng_kernel_type_string:
3581 ret = _lttng_string_type_statedump(session,
3582 lttng_kernel_get_type_string(type),
3583 nesting);
3584 break;
3585 case lttng_kernel_type_struct:
3586 ret = _lttng_struct_type_statedump(session,
3587 lttng_kernel_get_type_struct(type),
3588 nesting);
3589 break;
3590 case lttng_kernel_type_variant:
3591 ret = _lttng_variant_type_statedump(session,
3592 lttng_kernel_get_type_variant(type),
3593 nesting, NULL);
3594 break;
3595
3596 /* Nested arrays and sequences are not supported yet. */
3597 case lttng_kernel_type_array:
3598 case lttng_kernel_type_sequence:
3599 default:
3600 WARN_ON_ONCE(1);
3601 return -EINVAL;
3602 }
3603 return ret;
3604 }
3605
3606 /*
3607 * Must be called with sessions_mutex held.
3608 */
3609 static
3610 int _lttng_field_statedump(struct lttng_kernel_session *session,
3611 const struct lttng_kernel_event_field *field,
3612 size_t nesting,
3613 const char **prev_field_name_p)
3614 {
3615 const char *prev_field_name = NULL;
3616 int ret = 0;
3617
3618 if (prev_field_name_p)
3619 prev_field_name = *prev_field_name_p;
3620 switch (field->type->type) {
3621 case lttng_kernel_type_integer:
3622 ret = _lttng_integer_field_statedump(session, field, nesting);
3623 break;
3624 case lttng_kernel_type_enum:
3625 ret = _lttng_enum_field_statedump(session, field, nesting);
3626 break;
3627 case lttng_kernel_type_string:
3628 ret = _lttng_string_field_statedump(session, field, nesting);
3629 break;
3630 case lttng_kernel_type_struct:
3631 ret = _lttng_struct_field_statedump(session, field, nesting);
3632 break;
3633 case lttng_kernel_type_array:
3634 ret = _lttng_array_field_statedump(session, field, nesting);
3635 break;
3636 case lttng_kernel_type_sequence:
3637 ret = _lttng_sequence_field_statedump(session, field, nesting, prev_field_name);
3638 break;
3639 case lttng_kernel_type_variant:
3640 ret = _lttng_variant_field_statedump(session, field, nesting, prev_field_name);
3641 break;
3642
3643 default:
3644 WARN_ON_ONCE(1);
3645 return -EINVAL;
3646 }
3647 if (prev_field_name_p)
3648 *prev_field_name_p = field->name;
3649 return ret;
3650 }
3651
3652 static
3653 int _lttng_context_metadata_statedump(struct lttng_kernel_session *session,
3654 struct lttng_kernel_ctx *ctx)
3655 {
3656 const char *prev_field_name = NULL;
3657 int ret = 0;
3658 int i;
3659
3660 if (!ctx)
3661 return 0;
3662 for (i = 0; i < ctx->nr_fields; i++) {
3663 const struct lttng_kernel_ctx_field *field = &ctx->fields[i];
3664
3665 ret = _lttng_field_statedump(session, field->event_field, 2, &prev_field_name);
3666 if (ret)
3667 return ret;
3668 }
3669 return ret;
3670 }
3671
3672 static
3673 int _lttng_fields_metadata_statedump(struct lttng_kernel_session *session,
3674 struct lttng_kernel_event_recorder *event_recorder)
3675 {
3676 const char *prev_field_name = NULL;
3677 const struct lttng_kernel_event_desc *desc = event_recorder->priv->parent.desc;
3678 int ret = 0;
3679 int i;
3680
3681 for (i = 0; i < desc->tp_class->nr_fields; i++) {
3682 const struct lttng_kernel_event_field *field = desc->tp_class->fields[i];
3683
3684 ret = _lttng_field_statedump(session, field, 2, &prev_field_name);
3685 if (ret)
3686 return ret;
3687 }
3688 return ret;
3689 }
3690
3691 /*
3692 * Must be called with sessions_mutex held.
3693 * The entire event metadata is printed as a single atomic metadata
3694 * transaction.
3695 */
3696 static
3697 int _lttng_event_metadata_statedump(struct lttng_kernel_session *session,
3698 struct lttng_kernel_channel_buffer *chan,
3699 struct lttng_kernel_event_recorder *event_recorder)
3700 {
3701 int ret = 0;
3702
3703 if (event_recorder->priv->metadata_dumped || !LTTNG_READ_ONCE(session->active))
3704 return 0;
3705 if (chan->priv->channel_type == METADATA_CHANNEL)
3706 return 0;
3707
3708 lttng_metadata_begin(session);
3709
3710 ret = lttng_metadata_printf(session,
3711 "event {\n"
3712 " name = \"%s\";\n"
3713 " id = %u;\n"
3714 " stream_id = %u;\n",
3715 event_recorder->priv->parent.desc->event_name,
3716 event_recorder->priv->id,
3717 event_recorder->chan->priv->id);
3718 if (ret)
3719 goto end;
3720
3721 ret = lttng_metadata_printf(session,
3722 " fields := struct {\n"
3723 );
3724 if (ret)
3725 goto end;
3726
3727 ret = _lttng_fields_metadata_statedump(session, event_recorder);
3728 if (ret)
3729 goto end;
3730
3731 /*
3732 * LTTng space reservation can only reserve multiples of the
3733 * byte size.
3734 */
3735 ret = lttng_metadata_printf(session,
3736 " };\n"
3737 "};\n\n");
3738 if (ret)
3739 goto end;
3740
3741 event_recorder->priv->metadata_dumped = 1;
3742 end:
3743 lttng_metadata_end(session);
3744 return ret;
3745
3746 }
3747
3748 /*
3749 * Must be called with sessions_mutex held.
3750 * The entire channel metadata is printed as a single atomic metadata
3751 * transaction.
3752 */
3753 static
3754 int _lttng_channel_metadata_statedump(struct lttng_kernel_session *session,
3755 struct lttng_kernel_channel_buffer *chan)
3756 {
3757 int ret = 0;
3758
3759 if (chan->priv->metadata_dumped || !LTTNG_READ_ONCE(session->active))
3760 return 0;
3761
3762 if (chan->priv->channel_type == METADATA_CHANNEL)
3763 return 0;
3764
3765 lttng_metadata_begin(session);
3766
3767 WARN_ON_ONCE(!chan->priv->header_type);
3768 ret = lttng_metadata_printf(session,
3769 "stream {\n"
3770 " id = %u;\n"
3771 " event.header := %s;\n"
3772 " packet.context := struct packet_context;\n",
3773 chan->priv->id,
3774 chan->priv->header_type == 1 ? "struct event_header_compact" :
3775 "struct event_header_large");
3776 if (ret)
3777 goto end;
3778
3779 if (chan->priv->ctx) {
3780 ret = lttng_metadata_printf(session,
3781 " event.context := struct {\n");
3782 if (ret)
3783 goto end;
3784 }
3785 ret = _lttng_context_metadata_statedump(session, chan->priv->ctx);
3786 if (ret)
3787 goto end;
3788 if (chan->priv->ctx) {
3789 ret = lttng_metadata_printf(session,
3790 " };\n");
3791 if (ret)
3792 goto end;
3793 }
3794
3795 ret = lttng_metadata_printf(session,
3796 "};\n\n");
3797
3798 chan->priv->metadata_dumped = 1;
3799 end:
3800 lttng_metadata_end(session);
3801 return ret;
3802 }
3803
3804 /*
3805 * Must be called with sessions_mutex held.
3806 */
3807 static
3808 int _lttng_stream_packet_context_declare(struct lttng_kernel_session *session)
3809 {
3810 return lttng_metadata_printf(session,
3811 "struct packet_context {\n"
3812 " uint64_clock_monotonic_t timestamp_begin;\n"
3813 " uint64_clock_monotonic_t timestamp_end;\n"
3814 " uint64_t content_size;\n"
3815 " uint64_t packet_size;\n"
3816 " uint64_t packet_seq_num;\n"
3817 " unsigned long events_discarded;\n"
3818 " uint32_t cpu_id;\n"
3819 "};\n\n"
3820 );
3821 }
3822
3823 /*
3824 * Compact header:
3825 * id: range: 0 - 30.
3826 * id 31 is reserved to indicate an extended header.
3827 *
3828 * Large header:
3829 * id: range: 0 - 65534.
3830 * id 65535 is reserved to indicate an extended header.
3831 *
3832 * Must be called with sessions_mutex held.
3833 */
3834 static
3835 int _lttng_event_header_declare(struct lttng_kernel_session *session)
3836 {
3837 return lttng_metadata_printf(session,
3838 "struct event_header_compact {\n"
3839 " enum : uint5_t { compact = 0 ... 30, extended = 31 } id;\n"
3840 " variant <id> {\n"
3841 " struct {\n"
3842 " uint27_clock_monotonic_t timestamp;\n"
3843 " } compact;\n"
3844 " struct {\n"
3845 " uint32_t id;\n"
3846 " uint64_clock_monotonic_t timestamp;\n"
3847 " } extended;\n"
3848 " } v;\n"
3849 "} align(%u);\n"
3850 "\n"
3851 "struct event_header_large {\n"
3852 " enum : uint16_t { compact = 0 ... 65534, extended = 65535 } id;\n"
3853 " variant <id> {\n"
3854 " struct {\n"
3855 " uint32_clock_monotonic_t timestamp;\n"
3856 " } compact;\n"
3857 " struct {\n"
3858 " uint32_t id;\n"
3859 " uint64_clock_monotonic_t timestamp;\n"
3860 " } extended;\n"
3861 " } v;\n"
3862 "} align(%u);\n\n",
3863 lttng_alignof(uint32_t) * CHAR_BIT,
3864 lttng_alignof(uint16_t) * CHAR_BIT
3865 );
3866 }
3867
3868 /*
3869 * Approximation of NTP time of day to clock monotonic correlation,
3870 * taken at start of trace.
3871 * Yes, this is only an approximation. Yes, we can (and will) do better
3872 * in future versions.
3873 * This function may return a negative offset. It may happen if the
3874 * system sets the REALTIME clock to 0 after boot.
3875 *
3876 * Use 64bit timespec on kernels that have it, this makes 32bit arch
3877 * y2038 compliant.
3878 */
3879 static
3880 int64_t measure_clock_offset(void)
3881 {
3882 uint64_t monotonic_avg, monotonic[2], realtime;
3883 uint64_t tcf = trace_clock_freq();
3884 int64_t offset;
3885 unsigned long flags;
3886 #ifdef LTTNG_KERNEL_HAS_TIMESPEC64
3887 struct timespec64 rts = { 0, 0 };
3888 #else
3889 struct timespec rts = { 0, 0 };
3890 #endif
3891
3892 /* Disable interrupts to increase correlation precision. */
3893 local_irq_save(flags);
3894 monotonic[0] = trace_clock_read64();
3895 #ifdef LTTNG_KERNEL_HAS_TIMESPEC64
3896 ktime_get_real_ts64(&rts);
3897 #else
3898 getnstimeofday(&rts);
3899 #endif
3900 monotonic[1] = trace_clock_read64();
3901 local_irq_restore(flags);
3902
3903 monotonic_avg = (monotonic[0] + monotonic[1]) >> 1;
3904 realtime = (uint64_t) rts.tv_sec * tcf;
3905 if (tcf == NSEC_PER_SEC) {
3906 realtime += rts.tv_nsec;
3907 } else {
3908 uint64_t n = rts.tv_nsec * tcf;
3909
3910 do_div(n, NSEC_PER_SEC);
3911 realtime += n;
3912 }
3913 offset = (int64_t) realtime - monotonic_avg;
3914 return offset;
3915 }
3916
3917 static
3918 int print_escaped_ctf_string(struct lttng_kernel_session *session, const char *string)
3919 {
3920 int ret = 0;
3921 size_t i;
3922 char cur;
3923
3924 i = 0;
3925 cur = string[i];
3926 while (cur != '\0') {
3927 switch (cur) {
3928 case '\n':
3929 ret = lttng_metadata_printf(session, "%s", "\\n");
3930 break;
3931 case '\\':
3932 case '"':
3933 ret = lttng_metadata_printf(session, "%c", '\\');
3934 if (ret)
3935 goto error;
3936 /* We still print the current char */
3937 lttng_fallthrough;
3938 default:
3939 ret = lttng_metadata_printf(session, "%c", cur);
3940 break;
3941 }
3942
3943 if (ret)
3944 goto error;
3945
3946 cur = string[++i];
3947 }
3948 error:
3949 return ret;
3950 }
3951
3952 static
3953 int print_metadata_escaped_field(struct lttng_kernel_session *session, const char *field,
3954 const char *field_value)
3955 {
3956 int ret;
3957
3958 ret = lttng_metadata_printf(session, " %s = \"", field);
3959 if (ret)
3960 goto error;
3961
3962 ret = print_escaped_ctf_string(session, field_value);
3963 if (ret)
3964 goto error;
3965
3966 ret = lttng_metadata_printf(session, "\";\n");
3967
3968 error:
3969 return ret;
3970 }
3971
3972 /*
3973 * Output metadata into this session's metadata buffers.
3974 * Must be called with sessions_mutex held.
3975 */
3976 static
3977 int _lttng_session_metadata_statedump(struct lttng_kernel_session *session)
3978 {
3979 unsigned char *uuid_c = session->priv->uuid.b;
3980 unsigned char uuid_s[37], clock_uuid_s[BOOT_ID_LEN];
3981 const char *product_uuid;
3982 struct lttng_kernel_channel_buffer_private *chan_priv;
3983 struct lttng_kernel_event_recorder_private *event_recorder_priv;
3984 int ret = 0;
3985
3986 if (!LTTNG_READ_ONCE(session->active))
3987 return 0;
3988
3989 lttng_metadata_begin(session);
3990
3991 if (session->priv->metadata_dumped)
3992 goto skip_session;
3993
3994 snprintf(uuid_s, sizeof(uuid_s),
3995 "%02x%02x%02x%02x-%02x%02x-%02x%02x-%02x%02x-%02x%02x%02x%02x%02x%02x",
3996 uuid_c[0], uuid_c[1], uuid_c[2], uuid_c[3],
3997 uuid_c[4], uuid_c[5], uuid_c[6], uuid_c[7],
3998 uuid_c[8], uuid_c[9], uuid_c[10], uuid_c[11],
3999 uuid_c[12], uuid_c[13], uuid_c[14], uuid_c[15]);
4000
4001 ret = lttng_metadata_printf(session,
4002 "typealias integer { size = 8; align = %u; signed = false; } := uint8_t;\n"
4003 "typealias integer { size = 16; align = %u; signed = false; } := uint16_t;\n"
4004 "typealias integer { size = 32; align = %u; signed = false; } := uint32_t;\n"
4005 "typealias integer { size = 64; align = %u; signed = false; } := uint64_t;\n"
4006 "typealias integer { size = %u; align = %u; signed = false; } := unsigned long;\n"
4007 "typealias integer { size = 5; align = 1; signed = false; } := uint5_t;\n"
4008 "typealias integer { size = 27; align = 1; signed = false; } := uint27_t;\n"
4009 "\n"
4010 "trace {\n"
4011 " major = %u;\n"
4012 " minor = %u;\n"
4013 " uuid = \"%s\";\n"
4014 " byte_order = %s;\n"
4015 " packet.header := struct {\n"
4016 " uint32_t magic;\n"
4017 " uint8_t uuid[16];\n"
4018 " uint32_t stream_id;\n"
4019 " uint64_t stream_instance_id;\n"
4020 " };\n"
4021 "};\n\n",
4022 lttng_alignof(uint8_t) * CHAR_BIT,
4023 lttng_alignof(uint16_t) * CHAR_BIT,
4024 lttng_alignof(uint32_t) * CHAR_BIT,
4025 lttng_alignof(uint64_t) * CHAR_BIT,
4026 sizeof(unsigned long) * CHAR_BIT,
4027 lttng_alignof(unsigned long) * CHAR_BIT,
4028 CTF_SPEC_MAJOR,
4029 CTF_SPEC_MINOR,
4030 uuid_s,
4031 #if __BYTE_ORDER == __BIG_ENDIAN
4032 "be"
4033 #else
4034 "le"
4035 #endif
4036 );
4037 if (ret)
4038 goto end;
4039
4040 ret = lttng_metadata_printf(session,
4041 "env {\n"
4042 " hostname = \"%s\";\n"
4043 " domain = \"kernel\";\n"
4044 " sysname = \"%s\";\n"
4045 " kernel_release = \"%s\";\n"
4046 " kernel_version = \"%s\";\n"
4047 " tracer_name = \"lttng-modules\";\n"
4048 " tracer_major = %d;\n"
4049 " tracer_minor = %d;\n"
4050 " tracer_patchlevel = %d;\n"
4051 " trace_buffering_scheme = \"global\";\n",
4052 current->nsproxy->uts_ns->name.nodename,
4053 utsname()->sysname,
4054 utsname()->release,
4055 utsname()->version,
4056 LTTNG_MODULES_MAJOR_VERSION,
4057 LTTNG_MODULES_MINOR_VERSION,
4058 LTTNG_MODULES_PATCHLEVEL_VERSION
4059 );
4060 if (ret)
4061 goto end;
4062
4063 ret = print_metadata_escaped_field(session, "trace_name", session->priv->name);
4064 if (ret)
4065 goto end;
4066 ret = print_metadata_escaped_field(session, "trace_creation_datetime",
4067 session->priv->creation_time);
4068 if (ret)
4069 goto end;
4070
4071 /* Add the product UUID to the 'env' section */
4072 product_uuid = dmi_get_system_info(DMI_PRODUCT_UUID);
4073 if (product_uuid) {
4074 ret = lttng_metadata_printf(session,
4075 " product_uuid = \"%s\";\n",
4076 product_uuid
4077 );
4078 if (ret)
4079 goto end;
4080 }
4081
4082 /* Close the 'env' section */
4083 ret = lttng_metadata_printf(session, "};\n\n");
4084 if (ret)
4085 goto end;
4086
4087 ret = lttng_metadata_printf(session,
4088 "clock {\n"
4089 " name = \"%s\";\n",
4090 trace_clock_name()
4091 );
4092 if (ret)
4093 goto end;
4094
4095 if (!trace_clock_uuid(clock_uuid_s)) {
4096 ret = lttng_metadata_printf(session,
4097 " uuid = \"%s\";\n",
4098 clock_uuid_s
4099 );
4100 if (ret)
4101 goto end;
4102 }
4103
4104 ret = lttng_metadata_printf(session,
4105 " description = \"%s\";\n"
4106 " freq = %llu; /* Frequency, in Hz */\n"
4107 " /* clock value offset from Epoch is: offset * (1/freq) */\n"
4108 " offset = %lld;\n"
4109 "};\n\n",
4110 trace_clock_description(),
4111 (unsigned long long) trace_clock_freq(),
4112 (long long) measure_clock_offset()
4113 );
4114 if (ret)
4115 goto end;
4116
4117 ret = lttng_metadata_printf(session,
4118 "typealias integer {\n"
4119 " size = 27; align = 1; signed = false;\n"
4120 " map = clock.%s.value;\n"
4121 "} := uint27_clock_monotonic_t;\n"
4122 "\n"
4123 "typealias integer {\n"
4124 " size = 32; align = %u; signed = false;\n"
4125 " map = clock.%s.value;\n"
4126 "} := uint32_clock_monotonic_t;\n"
4127 "\n"
4128 "typealias integer {\n"
4129 " size = 64; align = %u; signed = false;\n"
4130 " map = clock.%s.value;\n"
4131 "} := uint64_clock_monotonic_t;\n\n",
4132 trace_clock_name(),
4133 lttng_alignof(uint32_t) * CHAR_BIT,
4134 trace_clock_name(),
4135 lttng_alignof(uint64_t) * CHAR_BIT,
4136 trace_clock_name()
4137 );
4138 if (ret)
4139 goto end;
4140
4141 ret = _lttng_stream_packet_context_declare(session);
4142 if (ret)
4143 goto end;
4144
4145 ret = _lttng_event_header_declare(session);
4146 if (ret)
4147 goto end;
4148
4149 skip_session:
4150 list_for_each_entry(chan_priv, &session->priv->chan, node) {
4151 ret = _lttng_channel_metadata_statedump(session, chan_priv->pub);
4152 if (ret)
4153 goto end;
4154 }
4155
4156 list_for_each_entry(event_recorder_priv, &session->priv->events, node) {
4157 ret = _lttng_event_metadata_statedump(session, event_recorder_priv->pub->chan,
4158 event_recorder_priv->pub);
4159 if (ret)
4160 goto end;
4161 }
4162 session->priv->metadata_dumped = 1;
4163 end:
4164 lttng_metadata_end(session);
4165 return ret;
4166 }
4167
4168 /**
4169 * lttng_transport_register - LTT transport registration
4170 * @transport: transport structure
4171 *
4172 * Registers a transport which can be used as output to extract the data out of
4173 * LTTng. The module calling this registration function must ensure that no
4174 * trap-inducing code will be executed by the transport functions. E.g.
4175 * vmalloc_sync_mappings() must be called between a vmalloc and the moment the memory
4176 * is made visible to the transport function. This registration acts as a
4177 * vmalloc_sync_mappings. Therefore, only if the module allocates virtual memory
4178 * after its registration must it synchronize the TLBs.
4179 */
4180 void lttng_transport_register(struct lttng_transport *transport)
4181 {
4182 /*
4183 * Make sure no page fault can be triggered by the module about to be
4184 * registered. We deal with this here so we don't have to call
4185 * vmalloc_sync_mappings() in each module's init.
4186 */
4187 wrapper_vmalloc_sync_mappings();
4188
4189 mutex_lock(&sessions_mutex);
4190 list_add_tail(&transport->node, &lttng_transport_list);
4191 mutex_unlock(&sessions_mutex);
4192 }
4193 EXPORT_SYMBOL_GPL(lttng_transport_register);
4194
4195 /**
4196 * lttng_transport_unregister - LTT transport unregistration
4197 * @transport: transport structure
4198 */
4199 void lttng_transport_unregister(struct lttng_transport *transport)
4200 {
4201 mutex_lock(&sessions_mutex);
4202 list_del(&transport->node);
4203 mutex_unlock(&sessions_mutex);
4204 }
4205 EXPORT_SYMBOL_GPL(lttng_transport_unregister);
4206
4207 void lttng_counter_transport_register(struct lttng_counter_transport *transport)
4208 {
4209 /*
4210 * Make sure no page fault can be triggered by the module about to be
4211 * registered. We deal with this here so we don't have to call
4212 * vmalloc_sync_mappings() in each module's init.
4213 */
4214 wrapper_vmalloc_sync_mappings();
4215
4216 mutex_lock(&sessions_mutex);
4217 list_add_tail(&transport->node, &lttng_counter_transport_list);
4218 mutex_unlock(&sessions_mutex);
4219 }
4220 EXPORT_SYMBOL_GPL(lttng_counter_transport_register);
4221
4222 void lttng_counter_transport_unregister(struct lttng_counter_transport *transport)
4223 {
4224 mutex_lock(&sessions_mutex);
4225 list_del(&transport->node);
4226 mutex_unlock(&sessions_mutex);
4227 }
4228 EXPORT_SYMBOL_GPL(lttng_counter_transport_unregister);
4229
4230 #if (LTTNG_LINUX_VERSION_CODE >= LTTNG_KERNEL_VERSION(4,10,0))
4231
4232 enum cpuhp_state lttng_hp_prepare;
4233 enum cpuhp_state lttng_hp_online;
4234
4235 static int lttng_hotplug_prepare(unsigned int cpu, struct hlist_node *node)
4236 {
4237 struct lttng_cpuhp_node *lttng_node;
4238
4239 lttng_node = container_of(node, struct lttng_cpuhp_node, node);
4240 switch (lttng_node->component) {
4241 case LTTNG_RING_BUFFER_FRONTEND:
4242 return 0;
4243 case LTTNG_RING_BUFFER_BACKEND:
4244 return lttng_cpuhp_rb_backend_prepare(cpu, lttng_node);
4245 case LTTNG_RING_BUFFER_ITER:
4246 return 0;
4247 case LTTNG_CONTEXT_PERF_COUNTERS:
4248 return 0;
4249 default:
4250 return -EINVAL;
4251 }
4252 }
4253
4254 static int lttng_hotplug_dead(unsigned int cpu, struct hlist_node *node)
4255 {
4256 struct lttng_cpuhp_node *lttng_node;
4257
4258 lttng_node = container_of(node, struct lttng_cpuhp_node, node);
4259 switch (lttng_node->component) {
4260 case LTTNG_RING_BUFFER_FRONTEND:
4261 return lttng_cpuhp_rb_frontend_dead(cpu, lttng_node);
4262 case LTTNG_RING_BUFFER_BACKEND:
4263 return 0;
4264 case LTTNG_RING_BUFFER_ITER:
4265 return 0;
4266 case LTTNG_CONTEXT_PERF_COUNTERS:
4267 return lttng_cpuhp_perf_counter_dead(cpu, lttng_node);
4268 default:
4269 return -EINVAL;
4270 }
4271 }
4272
4273 static int lttng_hotplug_online(unsigned int cpu, struct hlist_node *node)
4274 {
4275 struct lttng_cpuhp_node *lttng_node;
4276
4277 lttng_node = container_of(node, struct lttng_cpuhp_node, node);
4278 switch (lttng_node->component) {
4279 case LTTNG_RING_BUFFER_FRONTEND:
4280 return lttng_cpuhp_rb_frontend_online(cpu, lttng_node);
4281 case LTTNG_RING_BUFFER_BACKEND:
4282 return 0;
4283 case LTTNG_RING_BUFFER_ITER:
4284 return lttng_cpuhp_rb_iter_online(cpu, lttng_node);
4285 case LTTNG_CONTEXT_PERF_COUNTERS:
4286 return lttng_cpuhp_perf_counter_online(cpu, lttng_node);
4287 default:
4288 return -EINVAL;
4289 }
4290 }
4291
4292 static int lttng_hotplug_offline(unsigned int cpu, struct hlist_node *node)
4293 {
4294 struct lttng_cpuhp_node *lttng_node;
4295
4296 lttng_node = container_of(node, struct lttng_cpuhp_node, node);
4297 switch (lttng_node->component) {
4298 case LTTNG_RING_BUFFER_FRONTEND:
4299 return lttng_cpuhp_rb_frontend_offline(cpu, lttng_node);
4300 case LTTNG_RING_BUFFER_BACKEND:
4301 return 0;
4302 case LTTNG_RING_BUFFER_ITER:
4303 return 0;
4304 case LTTNG_CONTEXT_PERF_COUNTERS:
4305 return 0;
4306 default:
4307 return -EINVAL;
4308 }
4309 }
4310
4311 static int __init lttng_init_cpu_hotplug(void)
4312 {
4313 int ret;
4314
4315 ret = cpuhp_setup_state_multi(CPUHP_BP_PREPARE_DYN, "lttng:prepare",
4316 lttng_hotplug_prepare,
4317 lttng_hotplug_dead);
4318 if (ret < 0) {
4319 return ret;
4320 }
4321 lttng_hp_prepare = ret;
4322 lttng_rb_set_hp_prepare(ret);
4323
4324 ret = cpuhp_setup_state_multi(CPUHP_AP_ONLINE_DYN, "lttng:online",
4325 lttng_hotplug_online,
4326 lttng_hotplug_offline);
4327 if (ret < 0) {
4328 cpuhp_remove_multi_state(lttng_hp_prepare);
4329 lttng_hp_prepare = 0;
4330 return ret;
4331 }
4332 lttng_hp_online = ret;
4333 lttng_rb_set_hp_online(ret);
4334
4335 return 0;
4336 }
4337
4338 static void __exit lttng_exit_cpu_hotplug(void)
4339 {
4340 lttng_rb_set_hp_online(0);
4341 cpuhp_remove_multi_state(lttng_hp_online);
4342 lttng_rb_set_hp_prepare(0);
4343 cpuhp_remove_multi_state(lttng_hp_prepare);
4344 }
4345
4346 #else /* #if (LTTNG_LINUX_VERSION_CODE >= LTTNG_KERNEL_VERSION(4,10,0)) */
4347 static int lttng_init_cpu_hotplug(void)
4348 {
4349 return 0;
4350 }
4351 static void lttng_exit_cpu_hotplug(void)
4352 {
4353 }
4354 #endif /* #else #if (LTTNG_LINUX_VERSION_CODE >= LTTNG_KERNEL_VERSION(4,10,0)) */
4355
4356 static int __init lttng_events_init(void)
4357 {
4358 int ret;
4359
4360 ret = wrapper_lttng_fixup_sig(THIS_MODULE);
4361 if (ret)
4362 return ret;
4363 ret = wrapper_get_pfnblock_flags_mask_init();
4364 if (ret)
4365 return ret;
4366 ret = wrapper_get_pageblock_flags_mask_init();
4367 if (ret)
4368 return ret;
4369 ret = lttng_probes_init();
4370 if (ret)
4371 return ret;
4372 ret = lttng_context_init();
4373 if (ret)
4374 return ret;
4375 ret = lttng_tracepoint_init();
4376 if (ret)
4377 goto error_tp;
4378 event_recorder_cache = KMEM_CACHE(lttng_kernel_event_recorder, 0);
4379 if (!event_recorder_cache) {
4380 ret = -ENOMEM;
4381 goto error_kmem_event_recorder;
4382 }
4383 event_recorder_private_cache = KMEM_CACHE(lttng_kernel_event_recorder_private, 0);
4384 if (!event_recorder_private_cache) {
4385 ret = -ENOMEM;
4386 goto error_kmem_event_recorder_private;
4387 }
4388 event_notifier_cache = KMEM_CACHE(lttng_kernel_event_notifier, 0);
4389 if (!event_notifier_cache) {
4390 ret = -ENOMEM;
4391 goto error_kmem_event_notifier;
4392 }
4393 event_notifier_private_cache = KMEM_CACHE(lttng_kernel_event_notifier_private, 0);
4394 if (!event_notifier_private_cache) {
4395 ret = -ENOMEM;
4396 goto error_kmem_event_notifier_private;
4397 }
4398 ret = lttng_abi_init();
4399 if (ret)
4400 goto error_abi;
4401 ret = lttng_logger_init();
4402 if (ret)
4403 goto error_logger;
4404 ret = lttng_init_cpu_hotplug();
4405 if (ret)
4406 goto error_hotplug;
4407 printk(KERN_NOTICE "LTTng: Loaded modules v%s.%s.%s%s (%s)%s%s\n",
4408 __stringify(LTTNG_MODULES_MAJOR_VERSION),
4409 __stringify(LTTNG_MODULES_MINOR_VERSION),
4410 __stringify(LTTNG_MODULES_PATCHLEVEL_VERSION),
4411 LTTNG_MODULES_EXTRAVERSION,
4412 LTTNG_VERSION_NAME,
4413 #ifdef LTTNG_EXTRA_VERSION_GIT
4414 LTTNG_EXTRA_VERSION_GIT[0] == '\0' ? "" : " - " LTTNG_EXTRA_VERSION_GIT,
4415 #else
4416 "",
4417 #endif
4418 #ifdef LTTNG_EXTRA_VERSION_NAME
4419 LTTNG_EXTRA_VERSION_NAME[0] == '\0' ? "" : " - " LTTNG_EXTRA_VERSION_NAME);
4420 #else
4421 "");
4422 #endif
4423 #ifdef CONFIG_LTTNG_EXPERIMENTAL_BITWISE_ENUM
4424 printk(KERN_NOTICE "LTTng: Experimental bitwise enum enabled.\n");
4425 #endif /* CONFIG_LTTNG_EXPERIMENTAL_BITWISE_ENUM */
4426 return 0;
4427
4428 error_hotplug:
4429 lttng_logger_exit();
4430 error_logger:
4431 lttng_abi_exit();
4432 error_abi:
4433 kmem_cache_destroy(event_notifier_private_cache);
4434 error_kmem_event_notifier_private:
4435 kmem_cache_destroy(event_notifier_cache);
4436 error_kmem_event_notifier:
4437 kmem_cache_destroy(event_recorder_private_cache);
4438 error_kmem_event_recorder_private:
4439 kmem_cache_destroy(event_recorder_cache);
4440 error_kmem_event_recorder:
4441 lttng_tracepoint_exit();
4442 error_tp:
4443 lttng_context_exit();
4444 printk(KERN_NOTICE "LTTng: Failed to load modules v%s.%s.%s%s (%s)%s%s\n",
4445 __stringify(LTTNG_MODULES_MAJOR_VERSION),
4446 __stringify(LTTNG_MODULES_MINOR_VERSION),
4447 __stringify(LTTNG_MODULES_PATCHLEVEL_VERSION),
4448 LTTNG_MODULES_EXTRAVERSION,
4449 LTTNG_VERSION_NAME,
4450 #ifdef LTTNG_EXTRA_VERSION_GIT
4451 LTTNG_EXTRA_VERSION_GIT[0] == '\0' ? "" : " - " LTTNG_EXTRA_VERSION_GIT,
4452 #else
4453 "",
4454 #endif
4455 #ifdef LTTNG_EXTRA_VERSION_NAME
4456 LTTNG_EXTRA_VERSION_NAME[0] == '\0' ? "" : " - " LTTNG_EXTRA_VERSION_NAME);
4457 #else
4458 "");
4459 #endif
4460 return ret;
4461 }
4462
4463 module_init(lttng_events_init);
4464
4465 static void __exit lttng_events_exit(void)
4466 {
4467 struct lttng_kernel_session_private *session_priv, *tmpsession_priv;
4468
4469 lttng_exit_cpu_hotplug();
4470 lttng_logger_exit();
4471 lttng_abi_exit();
4472 list_for_each_entry_safe(session_priv, tmpsession_priv, &sessions, list)
4473 lttng_session_destroy(session_priv->pub);
4474 kmem_cache_destroy(event_recorder_cache);
4475 kmem_cache_destroy(event_recorder_private_cache);
4476 kmem_cache_destroy(event_notifier_cache);
4477 kmem_cache_destroy(event_notifier_private_cache);
4478 lttng_tracepoint_exit();
4479 lttng_context_exit();
4480 printk(KERN_NOTICE "LTTng: Unloaded modules v%s.%s.%s%s (%s)%s%s\n",
4481 __stringify(LTTNG_MODULES_MAJOR_VERSION),
4482 __stringify(LTTNG_MODULES_MINOR_VERSION),
4483 __stringify(LTTNG_MODULES_PATCHLEVEL_VERSION),
4484 LTTNG_MODULES_EXTRAVERSION,
4485 LTTNG_VERSION_NAME,
4486 #ifdef LTTNG_EXTRA_VERSION_GIT
4487 LTTNG_EXTRA_VERSION_GIT[0] == '\0' ? "" : " - " LTTNG_EXTRA_VERSION_GIT,
4488 #else
4489 "",
4490 #endif
4491 #ifdef LTTNG_EXTRA_VERSION_NAME
4492 LTTNG_EXTRA_VERSION_NAME[0] == '\0' ? "" : " - " LTTNG_EXTRA_VERSION_NAME);
4493 #else
4494 "");
4495 #endif
4496 }
4497
4498 module_exit(lttng_events_exit);
4499
4500 #include <generated/patches.h>
4501 #ifdef LTTNG_EXTRA_VERSION_GIT
4502 MODULE_INFO(extra_version_git, LTTNG_EXTRA_VERSION_GIT);
4503 #endif
4504 #ifdef LTTNG_EXTRA_VERSION_NAME
4505 MODULE_INFO(extra_version_name, LTTNG_EXTRA_VERSION_NAME);
4506 #endif
4507 MODULE_LICENSE("GPL and additional rights");
4508 MODULE_AUTHOR("Mathieu Desnoyers <mathieu.desnoyers@efficios.com>");
4509 MODULE_DESCRIPTION("LTTng tracer");
4510 MODULE_VERSION(__stringify(LTTNG_MODULES_MAJOR_VERSION) "."
4511 __stringify(LTTNG_MODULES_MINOR_VERSION) "."
4512 __stringify(LTTNG_MODULES_PATCHLEVEL_VERSION)
4513 LTTNG_MODULES_EXTRAVERSION);
This page took 0.124274 seconds and 4 git commands to generate.