trigger: implement trigger naming
[lttng-tools.git] / src / bin / lttng-sessiond / notification-thread-events.c
1 /*
2 * Copyright (C) 2017 Jérémie Galarneau <jeremie.galarneau@efficios.com>
3 *
4 * SPDX-License-Identifier: GPL-2.0-only
5 *
6 */
7
8 #include "lttng/action/action.h"
9 #include "lttng/trigger/trigger-internal.h"
10 #define _LGPL_SOURCE
11 #include <urcu.h>
12 #include <urcu/rculfhash.h>
13
14 #include <common/defaults.h>
15 #include <common/error.h>
16 #include <common/futex.h>
17 #include <common/unix.h>
18 #include <common/dynamic-buffer.h>
19 #include <common/hashtable/utils.h>
20 #include <common/sessiond-comm/sessiond-comm.h>
21 #include <common/macros.h>
22 #include <lttng/condition/condition.h>
23 #include <lttng/action/action-internal.h>
24 #include <lttng/notification/notification-internal.h>
25 #include <lttng/condition/condition-internal.h>
26 #include <lttng/condition/buffer-usage-internal.h>
27 #include <lttng/condition/session-consumed-size-internal.h>
28 #include <lttng/condition/session-rotation-internal.h>
29 #include <lttng/notification/channel-internal.h>
30 #include <lttng/trigger/trigger-internal.h>
31
32 #include <time.h>
33 #include <unistd.h>
34 #include <assert.h>
35 #include <inttypes.h>
36 #include <fcntl.h>
37
38 #include "notification-thread.h"
39 #include "notification-thread-events.h"
40 #include "notification-thread-commands.h"
41 #include "lttng-sessiond.h"
42 #include "kernel.h"
43
44 #define CLIENT_POLL_MASK_IN (LPOLLIN | LPOLLERR | LPOLLHUP | LPOLLRDHUP)
45 #define CLIENT_POLL_MASK_IN_OUT (CLIENT_POLL_MASK_IN | LPOLLOUT)
46
47 enum lttng_object_type {
48 LTTNG_OBJECT_TYPE_UNKNOWN,
49 LTTNG_OBJECT_TYPE_NONE,
50 LTTNG_OBJECT_TYPE_CHANNEL,
51 LTTNG_OBJECT_TYPE_SESSION,
52 };
53
54 struct lttng_trigger_list_element {
55 /* No ownership of the trigger object is assumed. */
56 struct lttng_trigger *trigger;
57 struct cds_list_head node;
58 };
59
60 struct lttng_channel_trigger_list {
61 struct channel_key channel_key;
62 /* List of struct lttng_trigger_list_element. */
63 struct cds_list_head list;
64 /* Node in the channel_triggers_ht */
65 struct cds_lfht_node channel_triggers_ht_node;
66 /* call_rcu delayed reclaim. */
67 struct rcu_head rcu_node;
68 };
69
70 /*
71 * List of triggers applying to a given session.
72 *
73 * See:
74 * - lttng_session_trigger_list_create()
75 * - lttng_session_trigger_list_build()
76 * - lttng_session_trigger_list_destroy()
77 * - lttng_session_trigger_list_add()
78 */
79 struct lttng_session_trigger_list {
80 /*
81 * Not owned by this; points to the session_info structure's
82 * session name.
83 */
84 const char *session_name;
85 /* List of struct lttng_trigger_list_element. */
86 struct cds_list_head list;
87 /* Node in the session_triggers_ht */
88 struct cds_lfht_node session_triggers_ht_node;
89 /*
90 * Weak reference to the notification system's session triggers
91 * hashtable.
92 *
93 * The session trigger list structure structure is owned by
94 * the session's session_info.
95 *
96 * The session_info is kept alive the the channel_infos holding a
97 * reference to it (reference counting). When those channels are
98 * destroyed (at runtime or on teardown), the reference they hold
99 * to the session_info are released. On destruction of session_info,
100 * session_info_destroy() will remove the list of triggers applying
101 * to this session from the notification system's state.
102 *
103 * This implies that the session_triggers_ht must be destroyed
104 * after the channels.
105 */
106 struct cds_lfht *session_triggers_ht;
107 /* Used for delayed RCU reclaim. */
108 struct rcu_head rcu_node;
109 };
110
111 struct lttng_trigger_ht_element {
112 struct lttng_trigger *trigger;
113 struct cds_lfht_node node;
114 struct cds_lfht_node node_by_name_uid;
115 /* call_rcu delayed reclaim. */
116 struct rcu_head rcu_node;
117 };
118
119 struct lttng_condition_list_element {
120 struct lttng_condition *condition;
121 struct cds_list_head node;
122 };
123
124 struct channel_state_sample {
125 struct channel_key key;
126 struct cds_lfht_node channel_state_ht_node;
127 uint64_t highest_usage;
128 uint64_t lowest_usage;
129 uint64_t channel_total_consumed;
130 /* call_rcu delayed reclaim. */
131 struct rcu_head rcu_node;
132 };
133
134 static unsigned long hash_channel_key(struct channel_key *key);
135 static int evaluate_buffer_condition(const struct lttng_condition *condition,
136 struct lttng_evaluation **evaluation,
137 const struct notification_thread_state *state,
138 const struct channel_state_sample *previous_sample,
139 const struct channel_state_sample *latest_sample,
140 uint64_t previous_session_consumed_total,
141 uint64_t latest_session_consumed_total,
142 struct channel_info *channel_info);
143 static
144 int send_evaluation_to_clients(const struct lttng_trigger *trigger,
145 const struct lttng_evaluation *evaluation,
146 struct notification_client_list *client_list,
147 struct notification_thread_state *state,
148 uid_t channel_uid, gid_t channel_gid);
149
150
151 /* session_info API */
152 static
153 void session_info_destroy(void *_data);
154 static
155 void session_info_get(struct session_info *session_info);
156 static
157 void session_info_put(struct session_info *session_info);
158 static
159 struct session_info *session_info_create(const char *name,
160 uid_t uid, gid_t gid,
161 struct lttng_session_trigger_list *trigger_list,
162 struct cds_lfht *sessions_ht);
163 static
164 void session_info_add_channel(struct session_info *session_info,
165 struct channel_info *channel_info);
166 static
167 void session_info_remove_channel(struct session_info *session_info,
168 struct channel_info *channel_info);
169
170 /* lttng_session_trigger_list API */
171 static
172 struct lttng_session_trigger_list *lttng_session_trigger_list_create(
173 const char *session_name,
174 struct cds_lfht *session_triggers_ht);
175 static
176 struct lttng_session_trigger_list *lttng_session_trigger_list_build(
177 const struct notification_thread_state *state,
178 const char *session_name);
179 static
180 void lttng_session_trigger_list_destroy(
181 struct lttng_session_trigger_list *list);
182 static
183 int lttng_session_trigger_list_add(struct lttng_session_trigger_list *list,
184 struct lttng_trigger *trigger);
185
186 static
187 int client_handle_transmission_status(
188 struct notification_client *client,
189 enum client_transmission_status transmission_status,
190 struct notification_thread_state *state);
191
192 static
193 void free_lttng_trigger_ht_element_rcu(struct rcu_head *node);
194
195 static
196 int match_client_socket(struct cds_lfht_node *node, const void *key)
197 {
198 /* This double-cast is intended to supress pointer-to-cast warning. */
199 const int socket = (int) (intptr_t) key;
200 const struct notification_client *client = caa_container_of(node,
201 struct notification_client, client_socket_ht_node);
202
203 return client->socket == socket;
204 }
205
206 static
207 int match_client_id(struct cds_lfht_node *node, const void *key)
208 {
209 /* This double-cast is intended to supress pointer-to-cast warning. */
210 const notification_client_id id = *((notification_client_id *) key);
211 const struct notification_client *client = caa_container_of(
212 node, struct notification_client, client_id_ht_node);
213
214 return client->id == id;
215 }
216
217 static
218 int match_channel_trigger_list(struct cds_lfht_node *node, const void *key)
219 {
220 struct channel_key *channel_key = (struct channel_key *) key;
221 struct lttng_channel_trigger_list *trigger_list;
222
223 trigger_list = caa_container_of(node, struct lttng_channel_trigger_list,
224 channel_triggers_ht_node);
225
226 return !!((channel_key->key == trigger_list->channel_key.key) &&
227 (channel_key->domain == trigger_list->channel_key.domain));
228 }
229
230 static
231 int match_session_trigger_list(struct cds_lfht_node *node, const void *key)
232 {
233 const char *session_name = (const char *) key;
234 struct lttng_session_trigger_list *trigger_list;
235
236 trigger_list = caa_container_of(node, struct lttng_session_trigger_list,
237 session_triggers_ht_node);
238
239 return !!(strcmp(trigger_list->session_name, session_name) == 0);
240 }
241
242 static
243 int match_channel_state_sample(struct cds_lfht_node *node, const void *key)
244 {
245 struct channel_key *channel_key = (struct channel_key *) key;
246 struct channel_state_sample *sample;
247
248 sample = caa_container_of(node, struct channel_state_sample,
249 channel_state_ht_node);
250
251 return !!((channel_key->key == sample->key.key) &&
252 (channel_key->domain == sample->key.domain));
253 }
254
255 static
256 int match_channel_info(struct cds_lfht_node *node, const void *key)
257 {
258 struct channel_key *channel_key = (struct channel_key *) key;
259 struct channel_info *channel_info;
260
261 channel_info = caa_container_of(node, struct channel_info,
262 channels_ht_node);
263
264 return !!((channel_key->key == channel_info->key.key) &&
265 (channel_key->domain == channel_info->key.domain));
266 }
267
268 static
269 int match_trigger(struct cds_lfht_node *node, const void *key)
270 {
271 struct lttng_trigger *trigger_key = (struct lttng_trigger *) key;
272 struct lttng_trigger_ht_element *trigger_ht_element;
273
274 trigger_ht_element = caa_container_of(node, struct lttng_trigger_ht_element,
275 node);
276
277 return !!lttng_trigger_is_equal(trigger_key, trigger_ht_element->trigger);
278 }
279
280 static
281 int match_client_list_condition(struct cds_lfht_node *node, const void *key)
282 {
283 struct lttng_condition *condition_key = (struct lttng_condition *) key;
284 struct notification_client_list *client_list;
285 const struct lttng_condition *condition;
286
287 assert(condition_key);
288
289 client_list = caa_container_of(node, struct notification_client_list,
290 notification_trigger_clients_ht_node);
291 condition = lttng_trigger_get_const_condition(client_list->trigger);
292
293 return !!lttng_condition_is_equal(condition_key, condition);
294 }
295
296 static
297 int match_session(struct cds_lfht_node *node, const void *key)
298 {
299 const char *name = key;
300 struct session_info *session_info = caa_container_of(
301 node, struct session_info, sessions_ht_node);
302
303 return !strcmp(session_info->name, name);
304 }
305
306 /*
307 * Match trigger based on name and credentials only.
308 * Name duplication is NOT allowed for the same uid.
309 */
310 static
311 int match_trigger_by_name_uid(struct cds_lfht_node *node,
312 const void *key)
313 {
314 bool match = false;
315 const char *name;
316 const char *key_name;
317 enum lttng_trigger_status status;
318 const struct lttng_credentials *key_creds;
319 const struct lttng_credentials *node_creds;
320 const struct lttng_trigger *trigger_key =
321 (const struct lttng_trigger *) key;
322 const struct lttng_trigger_ht_element *trigger_ht_element =
323 caa_container_of(node,
324 struct lttng_trigger_ht_element,
325 node_by_name_uid);
326
327 status = lttng_trigger_get_name(trigger_ht_element->trigger, &name);
328 assert(status == LTTNG_TRIGGER_STATUS_OK);
329
330 status = lttng_trigger_get_name(trigger_key, &key_name);
331 assert(status == LTTNG_TRIGGER_STATUS_OK);
332
333 /* Compare the names. */
334 if (strcmp(name, key_name) != 0) {
335 goto end;
336 }
337
338 /* Compare the owners' UIDs. */
339 key_creds = lttng_trigger_get_credentials(trigger_key);
340 node_creds = lttng_trigger_get_credentials(trigger_ht_element->trigger);
341
342 match = lttng_credentials_is_equal_uid(key_creds, node_creds);
343
344 end:
345 return match;
346 }
347
348 /*
349 * Hash trigger based on name and credentials only.
350 */
351 static
352 unsigned long hash_trigger_by_name_uid(const struct lttng_trigger *trigger)
353 {
354 unsigned long hash = 0;
355 const struct lttng_credentials *trigger_creds;
356 const char *trigger_name;
357 enum lttng_trigger_status status;
358
359 status = lttng_trigger_get_name(trigger, &trigger_name);
360 if (status == LTTNG_TRIGGER_STATUS_OK) {
361 hash = hash_key_str(trigger_name, lttng_ht_seed);
362 }
363
364 trigger_creds = lttng_trigger_get_credentials(trigger);
365 hash ^= hash_key_ulong((void *) (unsigned long) LTTNG_OPTIONAL_GET(trigger_creds->uid),
366 lttng_ht_seed);
367
368 return hash;
369 }
370
371 static
372 unsigned long lttng_condition_buffer_usage_hash(
373 const struct lttng_condition *_condition)
374 {
375 unsigned long hash;
376 unsigned long condition_type;
377 struct lttng_condition_buffer_usage *condition;
378
379 condition = container_of(_condition,
380 struct lttng_condition_buffer_usage, parent);
381
382 condition_type = (unsigned long) condition->parent.type;
383 hash = hash_key_ulong((void *) condition_type, lttng_ht_seed);
384 if (condition->session_name) {
385 hash ^= hash_key_str(condition->session_name, lttng_ht_seed);
386 }
387 if (condition->channel_name) {
388 hash ^= hash_key_str(condition->channel_name, lttng_ht_seed);
389 }
390 if (condition->domain.set) {
391 hash ^= hash_key_ulong(
392 (void *) condition->domain.type,
393 lttng_ht_seed);
394 }
395 if (condition->threshold_ratio.set) {
396 uint64_t val;
397
398 val = condition->threshold_ratio.value * (double) UINT32_MAX;
399 hash ^= hash_key_u64(&val, lttng_ht_seed);
400 } else if (condition->threshold_bytes.set) {
401 uint64_t val;
402
403 val = condition->threshold_bytes.value;
404 hash ^= hash_key_u64(&val, lttng_ht_seed);
405 }
406 return hash;
407 }
408
409 static
410 unsigned long lttng_condition_session_consumed_size_hash(
411 const struct lttng_condition *_condition)
412 {
413 unsigned long hash;
414 unsigned long condition_type =
415 (unsigned long) LTTNG_CONDITION_TYPE_SESSION_CONSUMED_SIZE;
416 struct lttng_condition_session_consumed_size *condition;
417 uint64_t val;
418
419 condition = container_of(_condition,
420 struct lttng_condition_session_consumed_size, parent);
421
422 hash = hash_key_ulong((void *) condition_type, lttng_ht_seed);
423 if (condition->session_name) {
424 hash ^= hash_key_str(condition->session_name, lttng_ht_seed);
425 }
426 val = condition->consumed_threshold_bytes.value;
427 hash ^= hash_key_u64(&val, lttng_ht_seed);
428 return hash;
429 }
430
431 static
432 unsigned long lttng_condition_session_rotation_hash(
433 const struct lttng_condition *_condition)
434 {
435 unsigned long hash, condition_type;
436 struct lttng_condition_session_rotation *condition;
437
438 condition = container_of(_condition,
439 struct lttng_condition_session_rotation, parent);
440 condition_type = (unsigned long) condition->parent.type;
441 hash = hash_key_ulong((void *) condition_type, lttng_ht_seed);
442 assert(condition->session_name);
443 hash ^= hash_key_str(condition->session_name, lttng_ht_seed);
444 return hash;
445 }
446
447 /*
448 * The lttng_condition hashing code is kept in this file (rather than
449 * condition.c) since it makes use of GPLv2 code (hashtable utils), which we
450 * don't want to link in liblttng-ctl.
451 */
452 static
453 unsigned long lttng_condition_hash(const struct lttng_condition *condition)
454 {
455 switch (condition->type) {
456 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_LOW:
457 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_HIGH:
458 return lttng_condition_buffer_usage_hash(condition);
459 case LTTNG_CONDITION_TYPE_SESSION_CONSUMED_SIZE:
460 return lttng_condition_session_consumed_size_hash(condition);
461 case LTTNG_CONDITION_TYPE_SESSION_ROTATION_ONGOING:
462 case LTTNG_CONDITION_TYPE_SESSION_ROTATION_COMPLETED:
463 return lttng_condition_session_rotation_hash(condition);
464 default:
465 ERR("[notification-thread] Unexpected condition type caught");
466 abort();
467 }
468 }
469
470 static
471 unsigned long hash_channel_key(struct channel_key *key)
472 {
473 unsigned long key_hash = hash_key_u64(&key->key, lttng_ht_seed);
474 unsigned long domain_hash = hash_key_ulong(
475 (void *) (unsigned long) key->domain, lttng_ht_seed);
476
477 return key_hash ^ domain_hash;
478 }
479
480 static
481 unsigned long hash_client_socket(int socket)
482 {
483 return hash_key_ulong((void *) (unsigned long) socket, lttng_ht_seed);
484 }
485
486 static
487 unsigned long hash_client_id(notification_client_id id)
488 {
489 return hash_key_u64(&id, lttng_ht_seed);
490 }
491
492 /*
493 * Get the type of object to which a given condition applies. Bindings let
494 * the notification system evaluate a trigger's condition when a given
495 * object's state is updated.
496 *
497 * For instance, a condition bound to a channel will be evaluated everytime
498 * the channel's state is changed by a channel monitoring sample.
499 */
500 static
501 enum lttng_object_type get_condition_binding_object(
502 const struct lttng_condition *condition)
503 {
504 switch (lttng_condition_get_type(condition)) {
505 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_LOW:
506 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_HIGH:
507 case LTTNG_CONDITION_TYPE_SESSION_CONSUMED_SIZE:
508 return LTTNG_OBJECT_TYPE_CHANNEL;
509 case LTTNG_CONDITION_TYPE_SESSION_ROTATION_ONGOING:
510 case LTTNG_CONDITION_TYPE_SESSION_ROTATION_COMPLETED:
511 return LTTNG_OBJECT_TYPE_SESSION;
512 default:
513 return LTTNG_OBJECT_TYPE_UNKNOWN;
514 }
515 }
516
517 static
518 void free_channel_info_rcu(struct rcu_head *node)
519 {
520 free(caa_container_of(node, struct channel_info, rcu_node));
521 }
522
523 static
524 void channel_info_destroy(struct channel_info *channel_info)
525 {
526 if (!channel_info) {
527 return;
528 }
529
530 if (channel_info->session_info) {
531 session_info_remove_channel(channel_info->session_info,
532 channel_info);
533 session_info_put(channel_info->session_info);
534 }
535 if (channel_info->name) {
536 free(channel_info->name);
537 }
538 call_rcu(&channel_info->rcu_node, free_channel_info_rcu);
539 }
540
541 static
542 void free_session_info_rcu(struct rcu_head *node)
543 {
544 free(caa_container_of(node, struct session_info, rcu_node));
545 }
546
547 /* Don't call directly, use the ref-counting mechanism. */
548 static
549 void session_info_destroy(void *_data)
550 {
551 struct session_info *session_info = _data;
552 int ret;
553
554 assert(session_info);
555 if (session_info->channel_infos_ht) {
556 ret = cds_lfht_destroy(session_info->channel_infos_ht, NULL);
557 if (ret) {
558 ERR("[notification-thread] Failed to destroy channel information hash table");
559 }
560 }
561 lttng_session_trigger_list_destroy(session_info->trigger_list);
562
563 rcu_read_lock();
564 cds_lfht_del(session_info->sessions_ht,
565 &session_info->sessions_ht_node);
566 rcu_read_unlock();
567 free(session_info->name);
568 call_rcu(&session_info->rcu_node, free_session_info_rcu);
569 }
570
571 static
572 void session_info_get(struct session_info *session_info)
573 {
574 if (!session_info) {
575 return;
576 }
577 lttng_ref_get(&session_info->ref);
578 }
579
580 static
581 void session_info_put(struct session_info *session_info)
582 {
583 if (!session_info) {
584 return;
585 }
586 lttng_ref_put(&session_info->ref);
587 }
588
589 static
590 struct session_info *session_info_create(const char *name, uid_t uid, gid_t gid,
591 struct lttng_session_trigger_list *trigger_list,
592 struct cds_lfht *sessions_ht)
593 {
594 struct session_info *session_info;
595
596 assert(name);
597
598 session_info = zmalloc(sizeof(*session_info));
599 if (!session_info) {
600 goto end;
601 }
602 lttng_ref_init(&session_info->ref, session_info_destroy);
603
604 session_info->channel_infos_ht = cds_lfht_new(DEFAULT_HT_SIZE,
605 1, 0, CDS_LFHT_AUTO_RESIZE | CDS_LFHT_ACCOUNTING, NULL);
606 if (!session_info->channel_infos_ht) {
607 goto error;
608 }
609
610 cds_lfht_node_init(&session_info->sessions_ht_node);
611 session_info->name = strdup(name);
612 if (!session_info->name) {
613 goto error;
614 }
615 session_info->uid = uid;
616 session_info->gid = gid;
617 session_info->trigger_list = trigger_list;
618 session_info->sessions_ht = sessions_ht;
619 end:
620 return session_info;
621 error:
622 session_info_put(session_info);
623 return NULL;
624 }
625
626 static
627 void session_info_add_channel(struct session_info *session_info,
628 struct channel_info *channel_info)
629 {
630 rcu_read_lock();
631 cds_lfht_add(session_info->channel_infos_ht,
632 hash_channel_key(&channel_info->key),
633 &channel_info->session_info_channels_ht_node);
634 rcu_read_unlock();
635 }
636
637 static
638 void session_info_remove_channel(struct session_info *session_info,
639 struct channel_info *channel_info)
640 {
641 rcu_read_lock();
642 cds_lfht_del(session_info->channel_infos_ht,
643 &channel_info->session_info_channels_ht_node);
644 rcu_read_unlock();
645 }
646
647 static
648 struct channel_info *channel_info_create(const char *channel_name,
649 struct channel_key *channel_key, uint64_t channel_capacity,
650 struct session_info *session_info)
651 {
652 struct channel_info *channel_info = zmalloc(sizeof(*channel_info));
653
654 if (!channel_info) {
655 goto end;
656 }
657
658 cds_lfht_node_init(&channel_info->channels_ht_node);
659 cds_lfht_node_init(&channel_info->session_info_channels_ht_node);
660 memcpy(&channel_info->key, channel_key, sizeof(*channel_key));
661 channel_info->capacity = channel_capacity;
662
663 channel_info->name = strdup(channel_name);
664 if (!channel_info->name) {
665 goto error;
666 }
667
668 /*
669 * Set the references between session and channel infos:
670 * - channel_info holds a strong reference to session_info
671 * - session_info holds a weak reference to channel_info
672 */
673 session_info_get(session_info);
674 session_info_add_channel(session_info, channel_info);
675 channel_info->session_info = session_info;
676 end:
677 return channel_info;
678 error:
679 channel_info_destroy(channel_info);
680 return NULL;
681 }
682
683 LTTNG_HIDDEN
684 bool notification_client_list_get(struct notification_client_list *list)
685 {
686 return urcu_ref_get_unless_zero(&list->ref);
687 }
688
689 static
690 void free_notification_client_list_rcu(struct rcu_head *node)
691 {
692 free(caa_container_of(node, struct notification_client_list,
693 rcu_node));
694 }
695
696 static
697 void notification_client_list_release(struct urcu_ref *list_ref)
698 {
699 struct notification_client_list *list =
700 container_of(list_ref, typeof(*list), ref);
701 struct notification_client_list_element *client_list_element, *tmp;
702
703 if (list->notification_trigger_clients_ht) {
704 rcu_read_lock();
705 cds_lfht_del(list->notification_trigger_clients_ht,
706 &list->notification_trigger_clients_ht_node);
707 rcu_read_unlock();
708 list->notification_trigger_clients_ht = NULL;
709 }
710 cds_list_for_each_entry_safe(client_list_element, tmp,
711 &list->list, node) {
712 free(client_list_element);
713 }
714 pthread_mutex_destroy(&list->lock);
715 call_rcu(&list->rcu_node, free_notification_client_list_rcu);
716 }
717
718 static
719 struct notification_client_list *notification_client_list_create(
720 const struct lttng_trigger *trigger)
721 {
722 struct notification_client_list *client_list =
723 zmalloc(sizeof(*client_list));
724
725 if (!client_list) {
726 goto error;
727 }
728 pthread_mutex_init(&client_list->lock, NULL);
729 urcu_ref_init(&client_list->ref);
730 cds_lfht_node_init(&client_list->notification_trigger_clients_ht_node);
731 CDS_INIT_LIST_HEAD(&client_list->list);
732 client_list->trigger = trigger;
733 error:
734 return client_list;
735 }
736
737 static
738 void publish_notification_client_list(
739 struct notification_thread_state *state,
740 struct notification_client_list *list)
741 {
742 const struct lttng_condition *condition =
743 lttng_trigger_get_const_condition(list->trigger);
744
745 assert(!list->notification_trigger_clients_ht);
746 notification_client_list_get(list);
747
748 list->notification_trigger_clients_ht =
749 state->notification_trigger_clients_ht;
750
751 rcu_read_lock();
752 cds_lfht_add(state->notification_trigger_clients_ht,
753 lttng_condition_hash(condition),
754 &list->notification_trigger_clients_ht_node);
755 rcu_read_unlock();
756 }
757
758 LTTNG_HIDDEN
759 void notification_client_list_put(struct notification_client_list *list)
760 {
761 if (!list) {
762 return;
763 }
764 return urcu_ref_put(&list->ref, notification_client_list_release);
765 }
766
767 /* Provides a reference to the returned list. */
768 static
769 struct notification_client_list *get_client_list_from_condition(
770 struct notification_thread_state *state,
771 const struct lttng_condition *condition)
772 {
773 struct cds_lfht_node *node;
774 struct cds_lfht_iter iter;
775 struct notification_client_list *list = NULL;
776
777 rcu_read_lock();
778 cds_lfht_lookup(state->notification_trigger_clients_ht,
779 lttng_condition_hash(condition),
780 match_client_list_condition,
781 condition,
782 &iter);
783 node = cds_lfht_iter_get_node(&iter);
784 if (node) {
785 list = container_of(node, struct notification_client_list,
786 notification_trigger_clients_ht_node);
787 list = notification_client_list_get(list) ? list : NULL;
788 }
789
790 rcu_read_unlock();
791 return list;
792 }
793
794 static
795 int evaluate_channel_condition_for_client(
796 const struct lttng_condition *condition,
797 struct notification_thread_state *state,
798 struct lttng_evaluation **evaluation,
799 uid_t *session_uid, gid_t *session_gid)
800 {
801 int ret;
802 struct cds_lfht_iter iter;
803 struct cds_lfht_node *node;
804 struct channel_info *channel_info = NULL;
805 struct channel_key *channel_key = NULL;
806 struct channel_state_sample *last_sample = NULL;
807 struct lttng_channel_trigger_list *channel_trigger_list = NULL;
808
809 rcu_read_lock();
810
811 /* Find the channel associated with the condition. */
812 cds_lfht_for_each_entry(state->channel_triggers_ht, &iter,
813 channel_trigger_list, channel_triggers_ht_node) {
814 struct lttng_trigger_list_element *element;
815
816 cds_list_for_each_entry(element, &channel_trigger_list->list, node) {
817 const struct lttng_condition *current_condition =
818 lttng_trigger_get_const_condition(
819 element->trigger);
820
821 assert(current_condition);
822 if (!lttng_condition_is_equal(condition,
823 current_condition)) {
824 continue;
825 }
826
827 /* Found the trigger, save the channel key. */
828 channel_key = &channel_trigger_list->channel_key;
829 break;
830 }
831 if (channel_key) {
832 /* The channel key was found stop iteration. */
833 break;
834 }
835 }
836
837 if (!channel_key){
838 /* No channel found; normal exit. */
839 DBG("[notification-thread] No known channel associated with newly subscribed-to condition");
840 ret = 0;
841 goto end;
842 }
843
844 /* Fetch channel info for the matching channel. */
845 cds_lfht_lookup(state->channels_ht,
846 hash_channel_key(channel_key),
847 match_channel_info,
848 channel_key,
849 &iter);
850 node = cds_lfht_iter_get_node(&iter);
851 assert(node);
852 channel_info = caa_container_of(node, struct channel_info,
853 channels_ht_node);
854
855 /* Retrieve the channel's last sample, if it exists. */
856 cds_lfht_lookup(state->channel_state_ht,
857 hash_channel_key(channel_key),
858 match_channel_state_sample,
859 channel_key,
860 &iter);
861 node = cds_lfht_iter_get_node(&iter);
862 if (node) {
863 last_sample = caa_container_of(node,
864 struct channel_state_sample,
865 channel_state_ht_node);
866 } else {
867 /* Nothing to evaluate, no sample was ever taken. Normal exit */
868 DBG("[notification-thread] No channel sample associated with newly subscribed-to condition");
869 ret = 0;
870 goto end;
871 }
872
873 ret = evaluate_buffer_condition(condition, evaluation, state,
874 NULL, last_sample,
875 0, channel_info->session_info->consumed_data_size,
876 channel_info);
877 if (ret) {
878 WARN("[notification-thread] Fatal error occurred while evaluating a newly subscribed-to condition");
879 goto end;
880 }
881
882 *session_uid = channel_info->session_info->uid;
883 *session_gid = channel_info->session_info->gid;
884 end:
885 rcu_read_unlock();
886 return ret;
887 }
888
889 static
890 const char *get_condition_session_name(const struct lttng_condition *condition)
891 {
892 const char *session_name = NULL;
893 enum lttng_condition_status status;
894
895 switch (lttng_condition_get_type(condition)) {
896 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_LOW:
897 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_HIGH:
898 status = lttng_condition_buffer_usage_get_session_name(
899 condition, &session_name);
900 break;
901 case LTTNG_CONDITION_TYPE_SESSION_CONSUMED_SIZE:
902 status = lttng_condition_session_consumed_size_get_session_name(
903 condition, &session_name);
904 break;
905 case LTTNG_CONDITION_TYPE_SESSION_ROTATION_ONGOING:
906 case LTTNG_CONDITION_TYPE_SESSION_ROTATION_COMPLETED:
907 status = lttng_condition_session_rotation_get_session_name(
908 condition, &session_name);
909 break;
910 default:
911 abort();
912 }
913 if (status != LTTNG_CONDITION_STATUS_OK) {
914 ERR("[notification-thread] Failed to retrieve session rotation condition's session name");
915 goto end;
916 }
917 end:
918 return session_name;
919 }
920
921 static
922 int evaluate_session_condition_for_client(
923 const struct lttng_condition *condition,
924 struct notification_thread_state *state,
925 struct lttng_evaluation **evaluation,
926 uid_t *session_uid, gid_t *session_gid)
927 {
928 int ret;
929 struct cds_lfht_iter iter;
930 struct cds_lfht_node *node;
931 const char *session_name;
932 struct session_info *session_info = NULL;
933
934 rcu_read_lock();
935 session_name = get_condition_session_name(condition);
936
937 /* Find the session associated with the trigger. */
938 cds_lfht_lookup(state->sessions_ht,
939 hash_key_str(session_name, lttng_ht_seed),
940 match_session,
941 session_name,
942 &iter);
943 node = cds_lfht_iter_get_node(&iter);
944 if (!node) {
945 DBG("[notification-thread] No known session matching name \"%s\"",
946 session_name);
947 ret = 0;
948 goto end;
949 }
950
951 session_info = caa_container_of(node, struct session_info,
952 sessions_ht_node);
953 session_info_get(session_info);
954
955 /*
956 * Evaluation is performed in-line here since only one type of
957 * session-bound condition is handled for the moment.
958 */
959 switch (lttng_condition_get_type(condition)) {
960 case LTTNG_CONDITION_TYPE_SESSION_ROTATION_ONGOING:
961 if (!session_info->rotation.ongoing) {
962 ret = 0;
963 goto end_session_put;
964 }
965
966 *evaluation = lttng_evaluation_session_rotation_ongoing_create(
967 session_info->rotation.id);
968 if (!*evaluation) {
969 /* Fatal error. */
970 ERR("[notification-thread] Failed to create session rotation ongoing evaluation for session \"%s\"",
971 session_info->name);
972 ret = -1;
973 goto end_session_put;
974 }
975 ret = 0;
976 break;
977 default:
978 ret = 0;
979 goto end_session_put;
980 }
981
982 *session_uid = session_info->uid;
983 *session_gid = session_info->gid;
984
985 end_session_put:
986 session_info_put(session_info);
987 end:
988 rcu_read_unlock();
989 return ret;
990 }
991
992 static
993 int evaluate_condition_for_client(const struct lttng_trigger *trigger,
994 const struct lttng_condition *condition,
995 struct notification_client *client,
996 struct notification_thread_state *state)
997 {
998 int ret;
999 struct lttng_evaluation *evaluation = NULL;
1000 struct notification_client_list client_list = {
1001 .lock = PTHREAD_MUTEX_INITIALIZER,
1002 };
1003 struct notification_client_list_element client_list_element = { 0 };
1004 uid_t object_uid = 0;
1005 gid_t object_gid = 0;
1006
1007 assert(trigger);
1008 assert(condition);
1009 assert(client);
1010 assert(state);
1011
1012 switch (get_condition_binding_object(condition)) {
1013 case LTTNG_OBJECT_TYPE_SESSION:
1014 ret = evaluate_session_condition_for_client(condition, state,
1015 &evaluation, &object_uid, &object_gid);
1016 break;
1017 case LTTNG_OBJECT_TYPE_CHANNEL:
1018 ret = evaluate_channel_condition_for_client(condition, state,
1019 &evaluation, &object_uid, &object_gid);
1020 break;
1021 case LTTNG_OBJECT_TYPE_NONE:
1022 ret = 0;
1023 goto end;
1024 case LTTNG_OBJECT_TYPE_UNKNOWN:
1025 default:
1026 ret = -1;
1027 goto end;
1028 }
1029 if (ret) {
1030 /* Fatal error. */
1031 goto end;
1032 }
1033 if (!evaluation) {
1034 /* Evaluation yielded nothing. Normal exit. */
1035 DBG("[notification-thread] Newly subscribed-to condition evaluated to false, nothing to report to client");
1036 ret = 0;
1037 goto end;
1038 }
1039
1040 /*
1041 * Create a temporary client list with the client currently
1042 * subscribing.
1043 */
1044 cds_lfht_node_init(&client_list.notification_trigger_clients_ht_node);
1045 CDS_INIT_LIST_HEAD(&client_list.list);
1046 client_list.trigger = trigger;
1047
1048 CDS_INIT_LIST_HEAD(&client_list_element.node);
1049 client_list_element.client = client;
1050 cds_list_add(&client_list_element.node, &client_list.list);
1051
1052 /* Send evaluation result to the newly-subscribed client. */
1053 DBG("[notification-thread] Newly subscribed-to condition evaluated to true, notifying client");
1054 ret = send_evaluation_to_clients(trigger, evaluation, &client_list,
1055 state, object_uid, object_gid);
1056
1057 end:
1058 return ret;
1059 }
1060
1061 static
1062 int notification_thread_client_subscribe(struct notification_client *client,
1063 struct lttng_condition *condition,
1064 struct notification_thread_state *state,
1065 enum lttng_notification_channel_status *_status)
1066 {
1067 int ret = 0;
1068 struct notification_client_list *client_list = NULL;
1069 struct lttng_condition_list_element *condition_list_element = NULL;
1070 struct notification_client_list_element *client_list_element = NULL;
1071 enum lttng_notification_channel_status status =
1072 LTTNG_NOTIFICATION_CHANNEL_STATUS_OK;
1073
1074 /*
1075 * Ensure that the client has not already subscribed to this condition
1076 * before.
1077 */
1078 cds_list_for_each_entry(condition_list_element, &client->condition_list, node) {
1079 if (lttng_condition_is_equal(condition_list_element->condition,
1080 condition)) {
1081 status = LTTNG_NOTIFICATION_CHANNEL_STATUS_ALREADY_SUBSCRIBED;
1082 goto end;
1083 }
1084 }
1085
1086 condition_list_element = zmalloc(sizeof(*condition_list_element));
1087 if (!condition_list_element) {
1088 ret = -1;
1089 goto error;
1090 }
1091 client_list_element = zmalloc(sizeof(*client_list_element));
1092 if (!client_list_element) {
1093 ret = -1;
1094 goto error;
1095 }
1096
1097 /*
1098 * Add the newly-subscribed condition to the client's subscription list.
1099 */
1100 CDS_INIT_LIST_HEAD(&condition_list_element->node);
1101 condition_list_element->condition = condition;
1102 cds_list_add(&condition_list_element->node, &client->condition_list);
1103
1104 client_list = get_client_list_from_condition(state, condition);
1105 if (!client_list) {
1106 /*
1107 * No notification-emiting trigger registered with this
1108 * condition. We don't evaluate the condition right away
1109 * since this trigger is not registered yet.
1110 */
1111 free(client_list_element);
1112 goto end;
1113 }
1114
1115 /*
1116 * The condition to which the client just subscribed is evaluated
1117 * at this point so that conditions that are already TRUE result
1118 * in a notification being sent out.
1119 *
1120 * The client_list's trigger is used without locking the list itself.
1121 * This is correct since the list doesn't own the trigger and the
1122 * object is immutable.
1123 */
1124 if (evaluate_condition_for_client(client_list->trigger, condition,
1125 client, state)) {
1126 WARN("[notification-thread] Evaluation of a condition on client subscription failed, aborting.");
1127 ret = -1;
1128 free(client_list_element);
1129 goto end;
1130 }
1131
1132 /*
1133 * Add the client to the list of clients interested in a given trigger
1134 * if a "notification" trigger with a corresponding condition was
1135 * added prior.
1136 */
1137 client_list_element->client = client;
1138 CDS_INIT_LIST_HEAD(&client_list_element->node);
1139
1140 pthread_mutex_lock(&client_list->lock);
1141 cds_list_add(&client_list_element->node, &client_list->list);
1142 pthread_mutex_unlock(&client_list->lock);
1143 end:
1144 if (_status) {
1145 *_status = status;
1146 }
1147 if (client_list) {
1148 notification_client_list_put(client_list);
1149 }
1150 return ret;
1151 error:
1152 free(condition_list_element);
1153 free(client_list_element);
1154 return ret;
1155 }
1156
1157 static
1158 int notification_thread_client_unsubscribe(
1159 struct notification_client *client,
1160 struct lttng_condition *condition,
1161 struct notification_thread_state *state,
1162 enum lttng_notification_channel_status *_status)
1163 {
1164 struct notification_client_list *client_list;
1165 struct lttng_condition_list_element *condition_list_element,
1166 *condition_tmp;
1167 struct notification_client_list_element *client_list_element,
1168 *client_tmp;
1169 bool condition_found = false;
1170 enum lttng_notification_channel_status status =
1171 LTTNG_NOTIFICATION_CHANNEL_STATUS_OK;
1172
1173 /* Remove the condition from the client's condition list. */
1174 cds_list_for_each_entry_safe(condition_list_element, condition_tmp,
1175 &client->condition_list, node) {
1176 if (!lttng_condition_is_equal(condition_list_element->condition,
1177 condition)) {
1178 continue;
1179 }
1180
1181 cds_list_del(&condition_list_element->node);
1182 /*
1183 * The caller may be iterating on the client's conditions to
1184 * tear down a client's connection. In this case, the condition
1185 * will be destroyed at the end.
1186 */
1187 if (condition != condition_list_element->condition) {
1188 lttng_condition_destroy(
1189 condition_list_element->condition);
1190 }
1191 free(condition_list_element);
1192 condition_found = true;
1193 break;
1194 }
1195
1196 if (!condition_found) {
1197 status = LTTNG_NOTIFICATION_CHANNEL_STATUS_UNKNOWN_CONDITION;
1198 goto end;
1199 }
1200
1201 /*
1202 * Remove the client from the list of clients interested the trigger
1203 * matching the condition.
1204 */
1205 client_list = get_client_list_from_condition(state, condition);
1206 if (!client_list) {
1207 goto end;
1208 }
1209
1210 pthread_mutex_lock(&client_list->lock);
1211 cds_list_for_each_entry_safe(client_list_element, client_tmp,
1212 &client_list->list, node) {
1213 if (client_list_element->client->id != client->id) {
1214 continue;
1215 }
1216 cds_list_del(&client_list_element->node);
1217 free(client_list_element);
1218 break;
1219 }
1220 pthread_mutex_unlock(&client_list->lock);
1221 notification_client_list_put(client_list);
1222 client_list = NULL;
1223 end:
1224 lttng_condition_destroy(condition);
1225 if (_status) {
1226 *_status = status;
1227 }
1228 return 0;
1229 }
1230
1231 static
1232 void free_notification_client_rcu(struct rcu_head *node)
1233 {
1234 free(caa_container_of(node, struct notification_client, rcu_node));
1235 }
1236
1237 static
1238 void notification_client_destroy(struct notification_client *client,
1239 struct notification_thread_state *state)
1240 {
1241 if (!client) {
1242 return;
1243 }
1244
1245 /*
1246 * The client object is not reachable by other threads, no need to lock
1247 * the client here.
1248 */
1249 if (client->socket >= 0) {
1250 (void) lttcomm_close_unix_sock(client->socket);
1251 client->socket = -1;
1252 }
1253 client->communication.active = false;
1254 lttng_payload_reset(&client->communication.inbound.payload);
1255 lttng_payload_reset(&client->communication.outbound.payload);
1256 pthread_mutex_destroy(&client->lock);
1257 call_rcu(&client->rcu_node, free_notification_client_rcu);
1258 }
1259
1260 /*
1261 * Call with rcu_read_lock held (and hold for the lifetime of the returned
1262 * client pointer).
1263 */
1264 static
1265 struct notification_client *get_client_from_socket(int socket,
1266 struct notification_thread_state *state)
1267 {
1268 struct cds_lfht_iter iter;
1269 struct cds_lfht_node *node;
1270 struct notification_client *client = NULL;
1271
1272 cds_lfht_lookup(state->client_socket_ht,
1273 hash_client_socket(socket),
1274 match_client_socket,
1275 (void *) (unsigned long) socket,
1276 &iter);
1277 node = cds_lfht_iter_get_node(&iter);
1278 if (!node) {
1279 goto end;
1280 }
1281
1282 client = caa_container_of(node, struct notification_client,
1283 client_socket_ht_node);
1284 end:
1285 return client;
1286 }
1287
1288 /*
1289 * Call with rcu_read_lock held (and hold for the lifetime of the returned
1290 * client pointer).
1291 */
1292 static
1293 struct notification_client *get_client_from_id(notification_client_id id,
1294 struct notification_thread_state *state)
1295 {
1296 struct cds_lfht_iter iter;
1297 struct cds_lfht_node *node;
1298 struct notification_client *client = NULL;
1299
1300 cds_lfht_lookup(state->client_id_ht,
1301 hash_client_id(id),
1302 match_client_id,
1303 &id,
1304 &iter);
1305 node = cds_lfht_iter_get_node(&iter);
1306 if (!node) {
1307 goto end;
1308 }
1309
1310 client = caa_container_of(node, struct notification_client,
1311 client_id_ht_node);
1312 end:
1313 return client;
1314 }
1315
1316 static
1317 bool buffer_usage_condition_applies_to_channel(
1318 const struct lttng_condition *condition,
1319 const struct channel_info *channel_info)
1320 {
1321 enum lttng_condition_status status;
1322 enum lttng_domain_type condition_domain;
1323 const char *condition_session_name = NULL;
1324 const char *condition_channel_name = NULL;
1325
1326 status = lttng_condition_buffer_usage_get_domain_type(condition,
1327 &condition_domain);
1328 assert(status == LTTNG_CONDITION_STATUS_OK);
1329 if (channel_info->key.domain != condition_domain) {
1330 goto fail;
1331 }
1332
1333 status = lttng_condition_buffer_usage_get_session_name(
1334 condition, &condition_session_name);
1335 assert((status == LTTNG_CONDITION_STATUS_OK) && condition_session_name);
1336
1337 status = lttng_condition_buffer_usage_get_channel_name(
1338 condition, &condition_channel_name);
1339 assert((status == LTTNG_CONDITION_STATUS_OK) && condition_channel_name);
1340
1341 if (strcmp(channel_info->session_info->name, condition_session_name)) {
1342 goto fail;
1343 }
1344 if (strcmp(channel_info->name, condition_channel_name)) {
1345 goto fail;
1346 }
1347
1348 return true;
1349 fail:
1350 return false;
1351 }
1352
1353 static
1354 bool session_consumed_size_condition_applies_to_channel(
1355 const struct lttng_condition *condition,
1356 const struct channel_info *channel_info)
1357 {
1358 enum lttng_condition_status status;
1359 const char *condition_session_name = NULL;
1360
1361 status = lttng_condition_session_consumed_size_get_session_name(
1362 condition, &condition_session_name);
1363 assert((status == LTTNG_CONDITION_STATUS_OK) && condition_session_name);
1364
1365 if (strcmp(channel_info->session_info->name, condition_session_name)) {
1366 goto fail;
1367 }
1368
1369 return true;
1370 fail:
1371 return false;
1372 }
1373
1374 static
1375 bool trigger_applies_to_channel(const struct lttng_trigger *trigger,
1376 const struct channel_info *channel_info)
1377 {
1378 const struct lttng_condition *condition;
1379 bool trigger_applies;
1380
1381 condition = lttng_trigger_get_const_condition(trigger);
1382 if (!condition) {
1383 goto fail;
1384 }
1385
1386 switch (lttng_condition_get_type(condition)) {
1387 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_LOW:
1388 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_HIGH:
1389 trigger_applies = buffer_usage_condition_applies_to_channel(
1390 condition, channel_info);
1391 break;
1392 case LTTNG_CONDITION_TYPE_SESSION_CONSUMED_SIZE:
1393 trigger_applies = session_consumed_size_condition_applies_to_channel(
1394 condition, channel_info);
1395 break;
1396 default:
1397 goto fail;
1398 }
1399
1400 return trigger_applies;
1401 fail:
1402 return false;
1403 }
1404
1405 static
1406 bool trigger_applies_to_client(struct lttng_trigger *trigger,
1407 struct notification_client *client)
1408 {
1409 bool applies = false;
1410 struct lttng_condition_list_element *condition_list_element;
1411
1412 cds_list_for_each_entry(condition_list_element, &client->condition_list,
1413 node) {
1414 applies = lttng_condition_is_equal(
1415 condition_list_element->condition,
1416 lttng_trigger_get_condition(trigger));
1417 if (applies) {
1418 break;
1419 }
1420 }
1421 return applies;
1422 }
1423
1424 /* Must be called with RCU read lock held. */
1425 static
1426 struct lttng_session_trigger_list *get_session_trigger_list(
1427 struct notification_thread_state *state,
1428 const char *session_name)
1429 {
1430 struct lttng_session_trigger_list *list = NULL;
1431 struct cds_lfht_node *node;
1432 struct cds_lfht_iter iter;
1433
1434 cds_lfht_lookup(state->session_triggers_ht,
1435 hash_key_str(session_name, lttng_ht_seed),
1436 match_session_trigger_list,
1437 session_name,
1438 &iter);
1439 node = cds_lfht_iter_get_node(&iter);
1440 if (!node) {
1441 /*
1442 * Not an error, the list of triggers applying to that session
1443 * will be initialized when the session is created.
1444 */
1445 DBG("[notification-thread] No trigger list found for session \"%s\" as it is not yet known to the notification system",
1446 session_name);
1447 goto end;
1448 }
1449
1450 list = caa_container_of(node,
1451 struct lttng_session_trigger_list,
1452 session_triggers_ht_node);
1453 end:
1454 return list;
1455 }
1456
1457 /*
1458 * Allocate an empty lttng_session_trigger_list for the session named
1459 * 'session_name'.
1460 *
1461 * No ownership of 'session_name' is assumed by the session trigger list.
1462 * It is the caller's responsability to ensure the session name is alive
1463 * for as long as this list is.
1464 */
1465 static
1466 struct lttng_session_trigger_list *lttng_session_trigger_list_create(
1467 const char *session_name,
1468 struct cds_lfht *session_triggers_ht)
1469 {
1470 struct lttng_session_trigger_list *list;
1471
1472 list = zmalloc(sizeof(*list));
1473 if (!list) {
1474 goto end;
1475 }
1476 list->session_name = session_name;
1477 CDS_INIT_LIST_HEAD(&list->list);
1478 cds_lfht_node_init(&list->session_triggers_ht_node);
1479 list->session_triggers_ht = session_triggers_ht;
1480
1481 rcu_read_lock();
1482 /* Publish the list through the session_triggers_ht. */
1483 cds_lfht_add(session_triggers_ht,
1484 hash_key_str(session_name, lttng_ht_seed),
1485 &list->session_triggers_ht_node);
1486 rcu_read_unlock();
1487 end:
1488 return list;
1489 }
1490
1491 static
1492 void free_session_trigger_list_rcu(struct rcu_head *node)
1493 {
1494 free(caa_container_of(node, struct lttng_session_trigger_list,
1495 rcu_node));
1496 }
1497
1498 static
1499 void lttng_session_trigger_list_destroy(struct lttng_session_trigger_list *list)
1500 {
1501 struct lttng_trigger_list_element *trigger_list_element, *tmp;
1502
1503 /* Empty the list element by element, and then free the list itself. */
1504 cds_list_for_each_entry_safe(trigger_list_element, tmp,
1505 &list->list, node) {
1506 cds_list_del(&trigger_list_element->node);
1507 free(trigger_list_element);
1508 }
1509 rcu_read_lock();
1510 /* Unpublish the list from the session_triggers_ht. */
1511 cds_lfht_del(list->session_triggers_ht,
1512 &list->session_triggers_ht_node);
1513 rcu_read_unlock();
1514 call_rcu(&list->rcu_node, free_session_trigger_list_rcu);
1515 }
1516
1517 static
1518 int lttng_session_trigger_list_add(struct lttng_session_trigger_list *list,
1519 struct lttng_trigger *trigger)
1520 {
1521 int ret = 0;
1522 struct lttng_trigger_list_element *new_element =
1523 zmalloc(sizeof(*new_element));
1524
1525 if (!new_element) {
1526 ret = -1;
1527 goto end;
1528 }
1529 CDS_INIT_LIST_HEAD(&new_element->node);
1530 new_element->trigger = trigger;
1531 cds_list_add(&new_element->node, &list->list);
1532 end:
1533 return ret;
1534 }
1535
1536 static
1537 bool trigger_applies_to_session(const struct lttng_trigger *trigger,
1538 const char *session_name)
1539 {
1540 bool applies = false;
1541 const struct lttng_condition *condition;
1542
1543 condition = lttng_trigger_get_const_condition(trigger);
1544 switch (lttng_condition_get_type(condition)) {
1545 case LTTNG_CONDITION_TYPE_SESSION_ROTATION_ONGOING:
1546 case LTTNG_CONDITION_TYPE_SESSION_ROTATION_COMPLETED:
1547 {
1548 enum lttng_condition_status condition_status;
1549 const char *condition_session_name;
1550
1551 condition_status = lttng_condition_session_rotation_get_session_name(
1552 condition, &condition_session_name);
1553 if (condition_status != LTTNG_CONDITION_STATUS_OK) {
1554 ERR("[notification-thread] Failed to retrieve session rotation condition's session name");
1555 goto end;
1556 }
1557
1558 assert(condition_session_name);
1559 applies = !strcmp(condition_session_name, session_name);
1560 break;
1561 }
1562 default:
1563 goto end;
1564 }
1565 end:
1566 return applies;
1567 }
1568
1569 /*
1570 * Allocate and initialize an lttng_session_trigger_list which contains
1571 * all triggers that apply to the session named 'session_name'.
1572 *
1573 * No ownership of 'session_name' is assumed by the session trigger list.
1574 * It is the caller's responsability to ensure the session name is alive
1575 * for as long as this list is.
1576 */
1577 static
1578 struct lttng_session_trigger_list *lttng_session_trigger_list_build(
1579 const struct notification_thread_state *state,
1580 const char *session_name)
1581 {
1582 int trigger_count = 0;
1583 struct lttng_session_trigger_list *session_trigger_list = NULL;
1584 struct lttng_trigger_ht_element *trigger_ht_element = NULL;
1585 struct cds_lfht_iter iter;
1586
1587 session_trigger_list = lttng_session_trigger_list_create(session_name,
1588 state->session_triggers_ht);
1589
1590 /* Add all triggers applying to the session named 'session_name'. */
1591 cds_lfht_for_each_entry(state->triggers_ht, &iter, trigger_ht_element,
1592 node) {
1593 int ret;
1594
1595 if (!trigger_applies_to_session(trigger_ht_element->trigger,
1596 session_name)) {
1597 continue;
1598 }
1599
1600 ret = lttng_session_trigger_list_add(session_trigger_list,
1601 trigger_ht_element->trigger);
1602 if (ret) {
1603 goto error;
1604 }
1605
1606 trigger_count++;
1607 }
1608
1609 DBG("[notification-thread] Found %i triggers that apply to newly created session",
1610 trigger_count);
1611 return session_trigger_list;
1612 error:
1613 lttng_session_trigger_list_destroy(session_trigger_list);
1614 return NULL;
1615 }
1616
1617 static
1618 struct session_info *find_or_create_session_info(
1619 struct notification_thread_state *state,
1620 const char *name, uid_t uid, gid_t gid)
1621 {
1622 struct session_info *session = NULL;
1623 struct cds_lfht_node *node;
1624 struct cds_lfht_iter iter;
1625 struct lttng_session_trigger_list *trigger_list;
1626
1627 rcu_read_lock();
1628 cds_lfht_lookup(state->sessions_ht,
1629 hash_key_str(name, lttng_ht_seed),
1630 match_session,
1631 name,
1632 &iter);
1633 node = cds_lfht_iter_get_node(&iter);
1634 if (node) {
1635 DBG("[notification-thread] Found session info of session \"%s\" (uid = %i, gid = %i)",
1636 name, uid, gid);
1637 session = caa_container_of(node, struct session_info,
1638 sessions_ht_node);
1639 assert(session->uid == uid);
1640 assert(session->gid == gid);
1641 session_info_get(session);
1642 goto end;
1643 }
1644
1645 trigger_list = lttng_session_trigger_list_build(state, name);
1646 if (!trigger_list) {
1647 goto error;
1648 }
1649
1650 session = session_info_create(name, uid, gid, trigger_list,
1651 state->sessions_ht);
1652 if (!session) {
1653 ERR("[notification-thread] Failed to allocation session info for session \"%s\" (uid = %i, gid = %i)",
1654 name, uid, gid);
1655 lttng_session_trigger_list_destroy(trigger_list);
1656 goto error;
1657 }
1658 trigger_list = NULL;
1659
1660 cds_lfht_add(state->sessions_ht, hash_key_str(name, lttng_ht_seed),
1661 &session->sessions_ht_node);
1662 end:
1663 rcu_read_unlock();
1664 return session;
1665 error:
1666 rcu_read_unlock();
1667 session_info_put(session);
1668 return NULL;
1669 }
1670
1671 static
1672 int handle_notification_thread_command_add_channel(
1673 struct notification_thread_state *state,
1674 const char *session_name, uid_t session_uid, gid_t session_gid,
1675 const char *channel_name, enum lttng_domain_type channel_domain,
1676 uint64_t channel_key_int, uint64_t channel_capacity,
1677 enum lttng_error_code *cmd_result)
1678 {
1679 struct cds_list_head trigger_list;
1680 struct channel_info *new_channel_info = NULL;
1681 struct channel_key channel_key = {
1682 .key = channel_key_int,
1683 .domain = channel_domain,
1684 };
1685 struct lttng_channel_trigger_list *channel_trigger_list = NULL;
1686 struct lttng_trigger_ht_element *trigger_ht_element = NULL;
1687 int trigger_count = 0;
1688 struct cds_lfht_iter iter;
1689 struct session_info *session_info = NULL;
1690
1691 DBG("[notification-thread] Adding channel %s from session %s, channel key = %" PRIu64 " in %s domain",
1692 channel_name, session_name, channel_key_int,
1693 channel_domain == LTTNG_DOMAIN_KERNEL ? "kernel" : "user space");
1694
1695 CDS_INIT_LIST_HEAD(&trigger_list);
1696
1697 session_info = find_or_create_session_info(state, session_name,
1698 session_uid, session_gid);
1699 if (!session_info) {
1700 /* Allocation error or an internal error occurred. */
1701 goto error;
1702 }
1703
1704 new_channel_info = channel_info_create(channel_name, &channel_key,
1705 channel_capacity, session_info);
1706 if (!new_channel_info) {
1707 goto error;
1708 }
1709
1710 rcu_read_lock();
1711 /* Build a list of all triggers applying to the new channel. */
1712 cds_lfht_for_each_entry(state->triggers_ht, &iter, trigger_ht_element,
1713 node) {
1714 struct lttng_trigger_list_element *new_element;
1715
1716 if (!trigger_applies_to_channel(trigger_ht_element->trigger,
1717 new_channel_info)) {
1718 continue;
1719 }
1720
1721 new_element = zmalloc(sizeof(*new_element));
1722 if (!new_element) {
1723 rcu_read_unlock();
1724 goto error;
1725 }
1726 CDS_INIT_LIST_HEAD(&new_element->node);
1727 new_element->trigger = trigger_ht_element->trigger;
1728 cds_list_add(&new_element->node, &trigger_list);
1729 trigger_count++;
1730 }
1731 rcu_read_unlock();
1732
1733 DBG("[notification-thread] Found %i triggers that apply to newly added channel",
1734 trigger_count);
1735 channel_trigger_list = zmalloc(sizeof(*channel_trigger_list));
1736 if (!channel_trigger_list) {
1737 goto error;
1738 }
1739 channel_trigger_list->channel_key = new_channel_info->key;
1740 CDS_INIT_LIST_HEAD(&channel_trigger_list->list);
1741 cds_lfht_node_init(&channel_trigger_list->channel_triggers_ht_node);
1742 cds_list_splice(&trigger_list, &channel_trigger_list->list);
1743
1744 rcu_read_lock();
1745 /* Add channel to the channel_ht which owns the channel_infos. */
1746 cds_lfht_add(state->channels_ht,
1747 hash_channel_key(&new_channel_info->key),
1748 &new_channel_info->channels_ht_node);
1749 /*
1750 * Add the list of triggers associated with this channel to the
1751 * channel_triggers_ht.
1752 */
1753 cds_lfht_add(state->channel_triggers_ht,
1754 hash_channel_key(&new_channel_info->key),
1755 &channel_trigger_list->channel_triggers_ht_node);
1756 rcu_read_unlock();
1757 session_info_put(session_info);
1758 *cmd_result = LTTNG_OK;
1759 return 0;
1760 error:
1761 channel_info_destroy(new_channel_info);
1762 session_info_put(session_info);
1763 return 1;
1764 }
1765
1766 static
1767 void free_channel_trigger_list_rcu(struct rcu_head *node)
1768 {
1769 free(caa_container_of(node, struct lttng_channel_trigger_list,
1770 rcu_node));
1771 }
1772
1773 static
1774 void free_channel_state_sample_rcu(struct rcu_head *node)
1775 {
1776 free(caa_container_of(node, struct channel_state_sample,
1777 rcu_node));
1778 }
1779
1780 static
1781 int handle_notification_thread_command_remove_channel(
1782 struct notification_thread_state *state,
1783 uint64_t channel_key, enum lttng_domain_type domain,
1784 enum lttng_error_code *cmd_result)
1785 {
1786 struct cds_lfht_node *node;
1787 struct cds_lfht_iter iter;
1788 struct lttng_channel_trigger_list *trigger_list;
1789 struct lttng_trigger_list_element *trigger_list_element, *tmp;
1790 struct channel_key key = { .key = channel_key, .domain = domain };
1791 struct channel_info *channel_info;
1792
1793 DBG("[notification-thread] Removing channel key = %" PRIu64 " in %s domain",
1794 channel_key, domain == LTTNG_DOMAIN_KERNEL ? "kernel" : "user space");
1795
1796 rcu_read_lock();
1797
1798 cds_lfht_lookup(state->channel_triggers_ht,
1799 hash_channel_key(&key),
1800 match_channel_trigger_list,
1801 &key,
1802 &iter);
1803 node = cds_lfht_iter_get_node(&iter);
1804 /*
1805 * There is a severe internal error if we are being asked to remove a
1806 * channel that doesn't exist.
1807 */
1808 if (!node) {
1809 ERR("[notification-thread] Channel being removed is unknown to the notification thread");
1810 goto end;
1811 }
1812
1813 /* Free the list of triggers associated with this channel. */
1814 trigger_list = caa_container_of(node, struct lttng_channel_trigger_list,
1815 channel_triggers_ht_node);
1816 cds_list_for_each_entry_safe(trigger_list_element, tmp,
1817 &trigger_list->list, node) {
1818 cds_list_del(&trigger_list_element->node);
1819 free(trigger_list_element);
1820 }
1821 cds_lfht_del(state->channel_triggers_ht, node);
1822 call_rcu(&trigger_list->rcu_node, free_channel_trigger_list_rcu);
1823
1824 /* Free sampled channel state. */
1825 cds_lfht_lookup(state->channel_state_ht,
1826 hash_channel_key(&key),
1827 match_channel_state_sample,
1828 &key,
1829 &iter);
1830 node = cds_lfht_iter_get_node(&iter);
1831 /*
1832 * This is expected to be NULL if the channel is destroyed before we
1833 * received a sample.
1834 */
1835 if (node) {
1836 struct channel_state_sample *sample = caa_container_of(node,
1837 struct channel_state_sample,
1838 channel_state_ht_node);
1839
1840 cds_lfht_del(state->channel_state_ht, node);
1841 call_rcu(&sample->rcu_node, free_channel_state_sample_rcu);
1842 }
1843
1844 /* Remove the channel from the channels_ht and free it. */
1845 cds_lfht_lookup(state->channels_ht,
1846 hash_channel_key(&key),
1847 match_channel_info,
1848 &key,
1849 &iter);
1850 node = cds_lfht_iter_get_node(&iter);
1851 assert(node);
1852 channel_info = caa_container_of(node, struct channel_info,
1853 channels_ht_node);
1854 cds_lfht_del(state->channels_ht, node);
1855 channel_info_destroy(channel_info);
1856 end:
1857 rcu_read_unlock();
1858 *cmd_result = LTTNG_OK;
1859 return 0;
1860 }
1861
1862 static
1863 int handle_notification_thread_command_session_rotation(
1864 struct notification_thread_state *state,
1865 enum notification_thread_command_type cmd_type,
1866 const char *session_name, uid_t session_uid, gid_t session_gid,
1867 uint64_t trace_archive_chunk_id,
1868 struct lttng_trace_archive_location *location,
1869 enum lttng_error_code *_cmd_result)
1870 {
1871 int ret = 0;
1872 enum lttng_error_code cmd_result = LTTNG_OK;
1873 struct lttng_session_trigger_list *trigger_list;
1874 struct lttng_trigger_list_element *trigger_list_element;
1875 struct session_info *session_info;
1876 const struct lttng_credentials session_creds = {
1877 .uid = LTTNG_OPTIONAL_INIT_VALUE(session_uid),
1878 .gid = LTTNG_OPTIONAL_INIT_VALUE(session_gid),
1879 };
1880
1881 rcu_read_lock();
1882
1883 session_info = find_or_create_session_info(state, session_name,
1884 session_uid, session_gid);
1885 if (!session_info) {
1886 /* Allocation error or an internal error occurred. */
1887 ret = -1;
1888 cmd_result = LTTNG_ERR_NOMEM;
1889 goto end;
1890 }
1891
1892 session_info->rotation.ongoing =
1893 cmd_type == NOTIFICATION_COMMAND_TYPE_SESSION_ROTATION_ONGOING;
1894 session_info->rotation.id = trace_archive_chunk_id;
1895 trigger_list = get_session_trigger_list(state, session_name);
1896 if (!trigger_list) {
1897 DBG("[notification-thread] No triggers applying to session \"%s\" found",
1898 session_name);
1899 goto end;
1900 }
1901
1902 cds_list_for_each_entry(trigger_list_element, &trigger_list->list,
1903 node) {
1904 const struct lttng_condition *condition;
1905 struct lttng_trigger *trigger;
1906 struct notification_client_list *client_list;
1907 struct lttng_evaluation *evaluation = NULL;
1908 enum lttng_condition_type condition_type;
1909 enum action_executor_status executor_status;
1910
1911 trigger = trigger_list_element->trigger;
1912 condition = lttng_trigger_get_const_condition(trigger);
1913 assert(condition);
1914 condition_type = lttng_condition_get_type(condition);
1915
1916 if (condition_type == LTTNG_CONDITION_TYPE_SESSION_ROTATION_ONGOING &&
1917 cmd_type != NOTIFICATION_COMMAND_TYPE_SESSION_ROTATION_ONGOING) {
1918 continue;
1919 } else if (condition_type == LTTNG_CONDITION_TYPE_SESSION_ROTATION_COMPLETED &&
1920 cmd_type != NOTIFICATION_COMMAND_TYPE_SESSION_ROTATION_COMPLETED) {
1921 continue;
1922 }
1923
1924 client_list = get_client_list_from_condition(state, condition);
1925 if (cmd_type == NOTIFICATION_COMMAND_TYPE_SESSION_ROTATION_ONGOING) {
1926 evaluation = lttng_evaluation_session_rotation_ongoing_create(
1927 trace_archive_chunk_id);
1928 } else {
1929 evaluation = lttng_evaluation_session_rotation_completed_create(
1930 trace_archive_chunk_id, location);
1931 }
1932
1933 if (!evaluation) {
1934 /* Internal error */
1935 ret = -1;
1936 cmd_result = LTTNG_ERR_UNK;
1937 goto put_list;
1938 }
1939
1940 /*
1941 * Ownership of `evaluation` transferred to the action executor
1942 * no matter the result.
1943 */
1944 executor_status = action_executor_enqueue(state->executor,
1945 trigger, evaluation, &session_creds,
1946 client_list);
1947 evaluation = NULL;
1948 switch (executor_status) {
1949 case ACTION_EXECUTOR_STATUS_OK:
1950 break;
1951 case ACTION_EXECUTOR_STATUS_ERROR:
1952 case ACTION_EXECUTOR_STATUS_INVALID:
1953 /*
1954 * TODO Add trigger identification (name/id) when
1955 * it is added to the API.
1956 */
1957 ERR("Fatal error occurred while enqueuing action associated with session rotation trigger");
1958 ret = -1;
1959 goto put_list;
1960 case ACTION_EXECUTOR_STATUS_OVERFLOW:
1961 /*
1962 * TODO Add trigger identification (name/id) when
1963 * it is added to the API.
1964 *
1965 * Not a fatal error.
1966 */
1967 WARN("No space left when enqueuing action associated with session rotation trigger");
1968 ret = 0;
1969 goto put_list;
1970 default:
1971 abort();
1972 }
1973
1974 put_list:
1975 notification_client_list_put(client_list);
1976 if (caa_unlikely(ret)) {
1977 break;
1978 }
1979 }
1980 end:
1981 session_info_put(session_info);
1982 *_cmd_result = cmd_result;
1983 rcu_read_unlock();
1984 return ret;
1985 }
1986
1987 static
1988 int condition_is_supported(struct lttng_condition *condition)
1989 {
1990 int ret;
1991
1992 switch (lttng_condition_get_type(condition)) {
1993 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_LOW:
1994 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_HIGH:
1995 {
1996 enum lttng_domain_type domain;
1997
1998 ret = lttng_condition_buffer_usage_get_domain_type(condition,
1999 &domain);
2000 if (ret) {
2001 ret = -1;
2002 goto end;
2003 }
2004
2005 if (domain != LTTNG_DOMAIN_KERNEL) {
2006 ret = 1;
2007 goto end;
2008 }
2009
2010 /*
2011 * Older kernel tracers don't expose the API to monitor their
2012 * buffers. Therefore, we reject triggers that require that
2013 * mechanism to be available to be evaluated.
2014 */
2015 ret = kernel_supports_ring_buffer_snapshot_sample_positions();
2016 break;
2017 }
2018 default:
2019 ret = 1;
2020 }
2021 end:
2022 return ret;
2023 }
2024
2025 /* Must be called with RCU read lock held. */
2026 static
2027 int bind_trigger_to_matching_session(struct lttng_trigger *trigger,
2028 struct notification_thread_state *state)
2029 {
2030 int ret = 0;
2031 const struct lttng_condition *condition;
2032 const char *session_name;
2033 struct lttng_session_trigger_list *trigger_list;
2034
2035 condition = lttng_trigger_get_const_condition(trigger);
2036 switch (lttng_condition_get_type(condition)) {
2037 case LTTNG_CONDITION_TYPE_SESSION_ROTATION_ONGOING:
2038 case LTTNG_CONDITION_TYPE_SESSION_ROTATION_COMPLETED:
2039 {
2040 enum lttng_condition_status status;
2041
2042 status = lttng_condition_session_rotation_get_session_name(
2043 condition, &session_name);
2044 if (status != LTTNG_CONDITION_STATUS_OK) {
2045 ERR("[notification-thread] Failed to bind trigger to session: unable to get 'session_rotation' condition's session name");
2046 ret = -1;
2047 goto end;
2048 }
2049 break;
2050 }
2051 default:
2052 ret = -1;
2053 goto end;
2054 }
2055
2056 trigger_list = get_session_trigger_list(state, session_name);
2057 if (!trigger_list) {
2058 DBG("[notification-thread] Unable to bind trigger applying to session \"%s\" as it is not yet known to the notification system",
2059 session_name);
2060 goto end;
2061
2062 }
2063
2064 DBG("[notification-thread] Newly registered trigger bound to session \"%s\"",
2065 session_name);
2066 ret = lttng_session_trigger_list_add(trigger_list, trigger);
2067 end:
2068 return ret;
2069 }
2070
2071 /* Must be called with RCU read lock held. */
2072 static
2073 int bind_trigger_to_matching_channels(struct lttng_trigger *trigger,
2074 struct notification_thread_state *state)
2075 {
2076 int ret = 0;
2077 struct cds_lfht_node *node;
2078 struct cds_lfht_iter iter;
2079 struct channel_info *channel;
2080
2081 cds_lfht_for_each_entry(state->channels_ht, &iter, channel,
2082 channels_ht_node) {
2083 struct lttng_trigger_list_element *trigger_list_element;
2084 struct lttng_channel_trigger_list *trigger_list;
2085 struct cds_lfht_iter lookup_iter;
2086
2087 if (!trigger_applies_to_channel(trigger, channel)) {
2088 continue;
2089 }
2090
2091 cds_lfht_lookup(state->channel_triggers_ht,
2092 hash_channel_key(&channel->key),
2093 match_channel_trigger_list,
2094 &channel->key,
2095 &lookup_iter);
2096 node = cds_lfht_iter_get_node(&lookup_iter);
2097 assert(node);
2098 trigger_list = caa_container_of(node,
2099 struct lttng_channel_trigger_list,
2100 channel_triggers_ht_node);
2101
2102 trigger_list_element = zmalloc(sizeof(*trigger_list_element));
2103 if (!trigger_list_element) {
2104 ret = -1;
2105 goto end;
2106 }
2107 CDS_INIT_LIST_HEAD(&trigger_list_element->node);
2108 trigger_list_element->trigger = trigger;
2109 cds_list_add(&trigger_list_element->node, &trigger_list->list);
2110 DBG("[notification-thread] Newly registered trigger bound to channel \"%s\"",
2111 channel->name);
2112 }
2113 end:
2114 return ret;
2115 }
2116
2117 static
2118 bool is_trigger_action_notify(const struct lttng_trigger *trigger)
2119 {
2120 bool is_notify = false;
2121 unsigned int i, count;
2122 enum lttng_action_status action_status;
2123 const struct lttng_action *action =
2124 lttng_trigger_get_const_action(trigger);
2125 enum lttng_action_type action_type;
2126
2127 assert(action);
2128 action_type = lttng_action_get_type(action);
2129 if (action_type == LTTNG_ACTION_TYPE_NOTIFY) {
2130 is_notify = true;
2131 goto end;
2132 } else if (action_type != LTTNG_ACTION_TYPE_GROUP) {
2133 goto end;
2134 }
2135
2136 action_status = lttng_action_group_get_count(action, &count);
2137 assert(action_status == LTTNG_ACTION_STATUS_OK);
2138
2139 for (i = 0; i < count; i++) {
2140 const struct lttng_action *inner_action =
2141 lttng_action_group_get_at_index(
2142 action, i);
2143
2144 action_type = lttng_action_get_type(inner_action);
2145 if (action_type == LTTNG_ACTION_TYPE_NOTIFY) {
2146 is_notify = true;
2147 goto end;
2148 }
2149 }
2150
2151 end:
2152 return is_notify;
2153 }
2154
2155 static bool trigger_name_taken(struct notification_thread_state *state,
2156 const struct lttng_trigger *trigger)
2157 {
2158 struct cds_lfht_iter iter;
2159
2160 /*
2161 * No duplicata is allowed in the triggers_by_name_uid_ht.
2162 * The match is done against the trigger name and uid.
2163 */
2164 cds_lfht_lookup(state->triggers_by_name_uid_ht,
2165 hash_trigger_by_name_uid(trigger),
2166 match_trigger_by_name_uid,
2167 trigger,
2168 &iter);
2169 return !!cds_lfht_iter_get_node(&iter);
2170 }
2171
2172 static
2173 enum lttng_error_code generate_trigger_name(
2174 struct notification_thread_state *state,
2175 struct lttng_trigger *trigger, const char **name)
2176 {
2177 enum lttng_error_code ret_code = LTTNG_OK;
2178 bool taken = false;
2179 enum lttng_trigger_status status;
2180
2181 do {
2182 const int ret = lttng_trigger_generate_name(trigger,
2183 state->trigger_id.name_offset++);
2184 if (ret) {
2185 /* The only reason this can fail right now. */
2186 ret_code = LTTNG_ERR_NOMEM;
2187 break;
2188 }
2189
2190 status = lttng_trigger_get_name(trigger, name);
2191 assert(status == LTTNG_TRIGGER_STATUS_OK);
2192
2193 taken = trigger_name_taken(state, trigger);
2194 } while (taken || state->trigger_id.name_offset == UINT64_MAX);
2195
2196 return ret_code;
2197 }
2198
2199 /*
2200 * FIXME A client's credentials are not checked when registering a trigger.
2201 *
2202 * The effects of this are benign since:
2203 * - The client will succeed in registering the trigger, as it is valid,
2204 * - The trigger will, internally, be bound to the channel/session,
2205 * - The notifications will not be sent since the client's credentials
2206 * are checked against the channel at that moment.
2207 *
2208 * If this function returns a non-zero value, it means something is
2209 * fundamentally broken and the whole subsystem/thread will be torn down.
2210 *
2211 * If a non-fatal error occurs, just set the cmd_result to the appropriate
2212 * error code.
2213 */
2214 static
2215 int handle_notification_thread_command_register_trigger(
2216 struct notification_thread_state *state,
2217 struct lttng_trigger *trigger,
2218 enum lttng_error_code *cmd_result)
2219 {
2220 int ret = 0;
2221 struct lttng_condition *condition;
2222 struct notification_client *client;
2223 struct notification_client_list *client_list = NULL;
2224 struct lttng_trigger_ht_element *trigger_ht_element = NULL;
2225 struct notification_client_list_element *client_list_element;
2226 struct cds_lfht_node *node;
2227 struct cds_lfht_iter iter;
2228 const char* trigger_name;
2229 bool free_trigger = true;
2230 struct lttng_evaluation *evaluation = NULL;
2231 struct lttng_credentials object_creds;
2232 uid_t object_uid;
2233 gid_t object_gid;
2234 enum action_executor_status executor_status;
2235
2236 rcu_read_lock();
2237
2238 if (lttng_trigger_get_name(trigger, &trigger_name) ==
2239 LTTNG_TRIGGER_STATUS_UNSET) {
2240 const enum lttng_error_code ret_code = generate_trigger_name(
2241 state, trigger, &trigger_name);
2242
2243 if (ret_code != LTTNG_OK) {
2244 /* Fatal error. */
2245 ret = -1;
2246 *cmd_result = ret_code;
2247 goto error;
2248 }
2249 } else if (trigger_name_taken(state, trigger)) {
2250 /* Not a fatal error. */
2251 *cmd_result = LTTNG_ERR_TRIGGER_EXISTS;
2252 ret = 0;
2253 goto error;
2254 }
2255
2256 condition = lttng_trigger_get_condition(trigger);
2257 assert(condition);
2258
2259 ret = condition_is_supported(condition);
2260 if (ret < 0) {
2261 goto error;
2262 } else if (ret == 0) {
2263 *cmd_result = LTTNG_ERR_NOT_SUPPORTED;
2264 goto error;
2265 } else {
2266 /* Feature is supported, continue. */
2267 ret = 0;
2268 }
2269
2270 trigger_ht_element = zmalloc(sizeof(*trigger_ht_element));
2271 if (!trigger_ht_element) {
2272 ret = -1;
2273 goto error;
2274 }
2275
2276 /* Add trigger to the trigger_ht. */
2277 cds_lfht_node_init(&trigger_ht_element->node);
2278 cds_lfht_node_init(&trigger_ht_element->node_by_name_uid);
2279 trigger_ht_element->trigger = trigger;
2280
2281 node = cds_lfht_add_unique(state->triggers_ht,
2282 lttng_condition_hash(condition),
2283 match_trigger,
2284 trigger,
2285 &trigger_ht_element->node);
2286 if (node != &trigger_ht_element->node) {
2287 /* Not a fatal error, simply report it to the client. */
2288 *cmd_result = LTTNG_ERR_TRIGGER_EXISTS;
2289 goto error_free_ht_element;
2290 }
2291
2292 node = cds_lfht_add_unique(state->triggers_by_name_uid_ht,
2293 hash_trigger_by_name_uid(trigger),
2294 match_trigger_by_name_uid,
2295 trigger,
2296 &trigger_ht_element->node_by_name_uid);
2297 if (node != &trigger_ht_element->node_by_name_uid) {
2298 /* Not a fatal error, simply report it to the client. */
2299 cds_lfht_del(state->triggers_ht, &trigger_ht_element->node);
2300 *cmd_result = LTTNG_ERR_TRIGGER_EXISTS;
2301 goto error_free_ht_element;
2302 }
2303
2304 /*
2305 * Ownership of the trigger and of its wrapper was transfered to
2306 * the triggers_ht.
2307 */
2308 trigger_ht_element = NULL;
2309 free_trigger = false;
2310
2311 /*
2312 * The rest only applies to triggers that have a "notify" action.
2313 * It is not skipped as this is the only action type currently
2314 * supported.
2315 */
2316 if (is_trigger_action_notify(trigger)) {
2317 client_list = notification_client_list_create(trigger);
2318 if (!client_list) {
2319 ret = -1;
2320 goto error_free_ht_element;
2321 }
2322
2323 /* Build a list of clients to which this new trigger applies. */
2324 cds_lfht_for_each_entry (state->client_socket_ht, &iter, client,
2325 client_socket_ht_node) {
2326 if (!trigger_applies_to_client(trigger, client)) {
2327 continue;
2328 }
2329
2330 client_list_element =
2331 zmalloc(sizeof(*client_list_element));
2332 if (!client_list_element) {
2333 ret = -1;
2334 goto error_put_client_list;
2335 }
2336
2337 CDS_INIT_LIST_HEAD(&client_list_element->node);
2338 client_list_element->client = client;
2339 cds_list_add(&client_list_element->node,
2340 &client_list->list);
2341 }
2342
2343 /*
2344 * Client list ownership transferred to the
2345 * notification_trigger_clients_ht.
2346 */
2347 publish_notification_client_list(state, client_list);
2348 }
2349
2350 switch (get_condition_binding_object(condition)) {
2351 case LTTNG_OBJECT_TYPE_SESSION:
2352 /* Add the trigger to the list if it matches a known session. */
2353 ret = bind_trigger_to_matching_session(trigger, state);
2354 if (ret) {
2355 goto error_put_client_list;
2356 }
2357 break;
2358 case LTTNG_OBJECT_TYPE_CHANNEL:
2359 /*
2360 * Add the trigger to list of triggers bound to the channels
2361 * currently known.
2362 */
2363 ret = bind_trigger_to_matching_channels(trigger, state);
2364 if (ret) {
2365 goto error_put_client_list;
2366 }
2367 break;
2368 case LTTNG_OBJECT_TYPE_NONE:
2369 break;
2370 default:
2371 ERR("Unknown object type on which to bind a newly registered trigger was encountered");
2372 ret = -1;
2373 goto error_put_client_list;
2374 }
2375
2376 /*
2377 * The new trigger's condition must be evaluated against the current
2378 * state.
2379 *
2380 * In the case of `notify` action, nothing preventing clients from
2381 * subscribing to a condition before the corresponding trigger is
2382 * registered, we have to evaluate this new condition right away.
2383 *
2384 * At some point, we were waiting for the next "evaluation" (e.g. on
2385 * reception of a channel sample) to evaluate this new condition, but
2386 * that was broken.
2387 *
2388 * The reason it was broken is that waiting for the next sample
2389 * does not allow us to properly handle transitions for edge-triggered
2390 * conditions.
2391 *
2392 * Consider this example: when we handle a new channel sample, we
2393 * evaluate each conditions twice: once with the previous state, and
2394 * again with the newest state. We then use those two results to
2395 * determine whether a state change happened: a condition was false and
2396 * became true. If a state change happened, we have to notify clients.
2397 *
2398 * Now, if a client subscribes to a given notification and registers
2399 * a trigger *after* that subscription, we have to make sure the
2400 * condition is evaluated at this point while considering only the
2401 * current state. Otherwise, the next evaluation cycle may only see
2402 * that the evaluations remain the same (true for samples n-1 and n) and
2403 * the client will never know that the condition has been met.
2404 */
2405 switch (get_condition_binding_object(condition)) {
2406 case LTTNG_OBJECT_TYPE_SESSION:
2407 ret = evaluate_session_condition_for_client(condition, state,
2408 &evaluation, &object_uid,
2409 &object_gid);
2410 break;
2411 case LTTNG_OBJECT_TYPE_CHANNEL:
2412 ret = evaluate_channel_condition_for_client(condition, state,
2413 &evaluation, &object_uid,
2414 &object_gid);
2415 break;
2416 case LTTNG_OBJECT_TYPE_NONE:
2417 ret = 0;
2418 break;
2419 case LTTNG_OBJECT_TYPE_UNKNOWN:
2420 default:
2421 ret = -1;
2422 break;
2423 }
2424
2425 if (ret) {
2426 /* Fatal error. */
2427 goto error_put_client_list;
2428 }
2429
2430 LTTNG_OPTIONAL_SET(&object_creds.uid, object_uid);
2431 LTTNG_OPTIONAL_SET(&object_creds.gid, object_gid);
2432
2433 DBG("Newly registered trigger's condition evaluated to %s",
2434 evaluation ? "true" : "false");
2435 if (!evaluation) {
2436 /* Evaluation yielded nothing. Normal exit. */
2437 ret = 0;
2438 goto end;
2439 }
2440
2441 /*
2442 * Ownership of `evaluation` transferred to the action executor
2443 * no matter the result.
2444 */
2445 executor_status = action_executor_enqueue(state->executor, trigger,
2446 evaluation, &object_creds, client_list);
2447 evaluation = NULL;
2448 switch (executor_status) {
2449 case ACTION_EXECUTOR_STATUS_OK:
2450 break;
2451 case ACTION_EXECUTOR_STATUS_ERROR:
2452 case ACTION_EXECUTOR_STATUS_INVALID:
2453 /*
2454 * TODO Add trigger identification (name/id) when
2455 * it is added to the API.
2456 */
2457 ERR("Fatal error occurred while enqueuing action associated to newly registered trigger");
2458 ret = -1;
2459 goto error_put_client_list;
2460 case ACTION_EXECUTOR_STATUS_OVERFLOW:
2461 /*
2462 * TODO Add trigger identification (name/id) when
2463 * it is added to the API.
2464 *
2465 * Not a fatal error.
2466 */
2467 WARN("No space left when enqueuing action associated to newly registered trigger");
2468 ret = 0;
2469 goto end;
2470 default:
2471 abort();
2472 }
2473
2474 end:
2475 *cmd_result = LTTNG_OK;
2476
2477 error_put_client_list:
2478 notification_client_list_put(client_list);
2479
2480 error_free_ht_element:
2481 if (trigger_ht_element) {
2482 /* Delayed removal due to RCU constraint on delete. */
2483 call_rcu(&trigger_ht_element->rcu_node,
2484 free_lttng_trigger_ht_element_rcu);
2485 }
2486
2487 error:
2488 if (free_trigger) {
2489 lttng_trigger_destroy(trigger);
2490 }
2491 rcu_read_unlock();
2492 return ret;
2493 }
2494
2495 static
2496 void free_lttng_trigger_ht_element_rcu(struct rcu_head *node)
2497 {
2498 free(caa_container_of(node, struct lttng_trigger_ht_element,
2499 rcu_node));
2500 }
2501
2502 static
2503 int handle_notification_thread_command_unregister_trigger(
2504 struct notification_thread_state *state,
2505 struct lttng_trigger *trigger,
2506 enum lttng_error_code *_cmd_reply)
2507 {
2508 struct cds_lfht_iter iter;
2509 struct cds_lfht_node *triggers_ht_node;
2510 struct lttng_channel_trigger_list *trigger_list;
2511 struct notification_client_list *client_list;
2512 struct lttng_trigger_ht_element *trigger_ht_element = NULL;
2513 struct lttng_condition *condition = lttng_trigger_get_condition(
2514 trigger);
2515 enum lttng_error_code cmd_reply;
2516
2517 rcu_read_lock();
2518
2519 cds_lfht_lookup(state->triggers_ht,
2520 lttng_condition_hash(condition),
2521 match_trigger,
2522 trigger,
2523 &iter);
2524 triggers_ht_node = cds_lfht_iter_get_node(&iter);
2525 if (!triggers_ht_node) {
2526 cmd_reply = LTTNG_ERR_TRIGGER_NOT_FOUND;
2527 goto end;
2528 } else {
2529 cmd_reply = LTTNG_OK;
2530 }
2531
2532 /* Remove trigger from channel_triggers_ht. */
2533 cds_lfht_for_each_entry(state->channel_triggers_ht, &iter, trigger_list,
2534 channel_triggers_ht_node) {
2535 struct lttng_trigger_list_element *trigger_element, *tmp;
2536
2537 cds_list_for_each_entry_safe(trigger_element, tmp,
2538 &trigger_list->list, node) {
2539 const struct lttng_condition *current_condition =
2540 lttng_trigger_get_const_condition(
2541 trigger_element->trigger);
2542
2543 assert(current_condition);
2544 if (!lttng_condition_is_equal(condition,
2545 current_condition)) {
2546 continue;
2547 }
2548
2549 DBG("[notification-thread] Removed trigger from channel_triggers_ht");
2550 cds_list_del(&trigger_element->node);
2551 /* A trigger can only appear once per channel */
2552 break;
2553 }
2554 }
2555
2556 /*
2557 * Remove and release the client list from
2558 * notification_trigger_clients_ht.
2559 */
2560 client_list = get_client_list_from_condition(state, condition);
2561 assert(client_list);
2562
2563 /* Put new reference and the hashtable's reference. */
2564 notification_client_list_put(client_list);
2565 notification_client_list_put(client_list);
2566 client_list = NULL;
2567
2568 /* Remove trigger from triggers_ht. */
2569 trigger_ht_element = caa_container_of(triggers_ht_node,
2570 struct lttng_trigger_ht_element, node);
2571 cds_lfht_del(state->triggers_by_name_uid_ht, &trigger_ht_element->node_by_name_uid);
2572 cds_lfht_del(state->triggers_ht, triggers_ht_node);
2573
2574 /* Release the ownership of the trigger. */
2575 lttng_trigger_destroy(trigger_ht_element->trigger);
2576 call_rcu(&trigger_ht_element->rcu_node, free_lttng_trigger_ht_element_rcu);
2577 end:
2578 rcu_read_unlock();
2579 if (_cmd_reply) {
2580 *_cmd_reply = cmd_reply;
2581 }
2582 return 0;
2583 }
2584
2585 /* Returns 0 on success, 1 on exit requested, negative value on error. */
2586 int handle_notification_thread_command(
2587 struct notification_thread_handle *handle,
2588 struct notification_thread_state *state)
2589 {
2590 int ret;
2591 uint64_t counter;
2592 struct notification_thread_command *cmd;
2593
2594 /* Read the event pipe to put it back into a quiescent state. */
2595 ret = lttng_read(lttng_pipe_get_readfd(handle->cmd_queue.event_pipe), &counter,
2596 sizeof(counter));
2597 if (ret != sizeof(counter)) {
2598 goto error;
2599 }
2600
2601 pthread_mutex_lock(&handle->cmd_queue.lock);
2602 cmd = cds_list_first_entry(&handle->cmd_queue.list,
2603 struct notification_thread_command, cmd_list_node);
2604 cds_list_del(&cmd->cmd_list_node);
2605 pthread_mutex_unlock(&handle->cmd_queue.lock);
2606 switch (cmd->type) {
2607 case NOTIFICATION_COMMAND_TYPE_REGISTER_TRIGGER:
2608 DBG("[notification-thread] Received register trigger command");
2609 ret = handle_notification_thread_command_register_trigger(
2610 state, cmd->parameters.trigger,
2611 &cmd->reply_code);
2612 break;
2613 case NOTIFICATION_COMMAND_TYPE_UNREGISTER_TRIGGER:
2614 DBG("[notification-thread] Received unregister trigger command");
2615 ret = handle_notification_thread_command_unregister_trigger(
2616 state, cmd->parameters.trigger,
2617 &cmd->reply_code);
2618 break;
2619 case NOTIFICATION_COMMAND_TYPE_ADD_CHANNEL:
2620 DBG("[notification-thread] Received add channel command");
2621 ret = handle_notification_thread_command_add_channel(
2622 state,
2623 cmd->parameters.add_channel.session.name,
2624 cmd->parameters.add_channel.session.uid,
2625 cmd->parameters.add_channel.session.gid,
2626 cmd->parameters.add_channel.channel.name,
2627 cmd->parameters.add_channel.channel.domain,
2628 cmd->parameters.add_channel.channel.key,
2629 cmd->parameters.add_channel.channel.capacity,
2630 &cmd->reply_code);
2631 break;
2632 case NOTIFICATION_COMMAND_TYPE_REMOVE_CHANNEL:
2633 DBG("[notification-thread] Received remove channel command");
2634 ret = handle_notification_thread_command_remove_channel(
2635 state, cmd->parameters.remove_channel.key,
2636 cmd->parameters.remove_channel.domain,
2637 &cmd->reply_code);
2638 break;
2639 case NOTIFICATION_COMMAND_TYPE_SESSION_ROTATION_ONGOING:
2640 case NOTIFICATION_COMMAND_TYPE_SESSION_ROTATION_COMPLETED:
2641 DBG("[notification-thread] Received session rotation %s command",
2642 cmd->type == NOTIFICATION_COMMAND_TYPE_SESSION_ROTATION_ONGOING ?
2643 "ongoing" : "completed");
2644 ret = handle_notification_thread_command_session_rotation(
2645 state,
2646 cmd->type,
2647 cmd->parameters.session_rotation.session_name,
2648 cmd->parameters.session_rotation.uid,
2649 cmd->parameters.session_rotation.gid,
2650 cmd->parameters.session_rotation.trace_archive_chunk_id,
2651 cmd->parameters.session_rotation.location,
2652 &cmd->reply_code);
2653 break;
2654 case NOTIFICATION_COMMAND_TYPE_QUIT:
2655 DBG("[notification-thread] Received quit command");
2656 cmd->reply_code = LTTNG_OK;
2657 ret = 1;
2658 goto end;
2659 case NOTIFICATION_COMMAND_TYPE_CLIENT_COMMUNICATION_UPDATE:
2660 {
2661 const enum client_transmission_status client_status =
2662 cmd->parameters.client_communication_update
2663 .status;
2664 const notification_client_id client_id =
2665 cmd->parameters.client_communication_update.id;
2666 struct notification_client *client;
2667
2668 rcu_read_lock();
2669 client = get_client_from_id(client_id, state);
2670
2671 if (!client) {
2672 /*
2673 * Client error was probably already picked-up by the
2674 * notification thread or it has disconnected
2675 * gracefully while this command was queued.
2676 */
2677 DBG("Failed to find notification client to update communication status, client id = %" PRIu64,
2678 client_id);
2679 ret = 0;
2680 } else {
2681 ret = client_handle_transmission_status(
2682 client, client_status, state);
2683 }
2684 rcu_read_unlock();
2685 break;
2686 }
2687 default:
2688 ERR("[notification-thread] Unknown internal command received");
2689 goto error_unlock;
2690 }
2691
2692 if (ret) {
2693 goto error_unlock;
2694 }
2695 end:
2696 if (cmd->is_async) {
2697 free(cmd);
2698 cmd = NULL;
2699 } else {
2700 lttng_waiter_wake_up(&cmd->reply_waiter);
2701 }
2702 return ret;
2703 error_unlock:
2704 /* Wake-up and return a fatal error to the calling thread. */
2705 lttng_waiter_wake_up(&cmd->reply_waiter);
2706 cmd->reply_code = LTTNG_ERR_FATAL;
2707 error:
2708 /* Indicate a fatal error to the caller. */
2709 return -1;
2710 }
2711
2712 static
2713 int socket_set_non_blocking(int socket)
2714 {
2715 int ret, flags;
2716
2717 /* Set the pipe as non-blocking. */
2718 ret = fcntl(socket, F_GETFL, 0);
2719 if (ret == -1) {
2720 PERROR("fcntl get socket flags");
2721 goto end;
2722 }
2723 flags = ret;
2724
2725 ret = fcntl(socket, F_SETFL, flags | O_NONBLOCK);
2726 if (ret == -1) {
2727 PERROR("fcntl set O_NONBLOCK socket flag");
2728 goto end;
2729 }
2730 DBG("Client socket (fd = %i) set as non-blocking", socket);
2731 end:
2732 return ret;
2733 }
2734
2735 static
2736 int client_reset_inbound_state(struct notification_client *client)
2737 {
2738 int ret;
2739
2740
2741 lttng_payload_clear(&client->communication.inbound.payload);
2742
2743 client->communication.inbound.bytes_to_receive =
2744 sizeof(struct lttng_notification_channel_message);
2745 client->communication.inbound.msg_type =
2746 LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_UNKNOWN;
2747 LTTNG_SOCK_SET_UID_CRED(&client->communication.inbound.creds, -1);
2748 LTTNG_SOCK_SET_GID_CRED(&client->communication.inbound.creds, -1);
2749 ret = lttng_dynamic_buffer_set_size(
2750 &client->communication.inbound.payload.buffer,
2751 client->communication.inbound.bytes_to_receive);
2752
2753 return ret;
2754 }
2755
2756 int handle_notification_thread_client_connect(
2757 struct notification_thread_state *state)
2758 {
2759 int ret;
2760 struct notification_client *client;
2761
2762 DBG("[notification-thread] Handling new notification channel client connection");
2763
2764 client = zmalloc(sizeof(*client));
2765 if (!client) {
2766 /* Fatal error. */
2767 ret = -1;
2768 goto error;
2769 }
2770
2771 pthread_mutex_init(&client->lock, NULL);
2772 client->id = state->next_notification_client_id++;
2773 CDS_INIT_LIST_HEAD(&client->condition_list);
2774 lttng_payload_init(&client->communication.inbound.payload);
2775 lttng_payload_init(&client->communication.outbound.payload);
2776 client->communication.inbound.expect_creds = true;
2777
2778 ret = client_reset_inbound_state(client);
2779 if (ret) {
2780 ERR("[notification-thread] Failed to reset client communication's inbound state");
2781 ret = 0;
2782 goto error;
2783 }
2784
2785 ret = lttcomm_accept_unix_sock(state->notification_channel_socket);
2786 if (ret < 0) {
2787 ERR("[notification-thread] Failed to accept new notification channel client connection");
2788 ret = 0;
2789 goto error;
2790 }
2791
2792 client->socket = ret;
2793
2794 ret = socket_set_non_blocking(client->socket);
2795 if (ret) {
2796 ERR("[notification-thread] Failed to set new notification channel client connection socket as non-blocking");
2797 goto error;
2798 }
2799
2800 ret = lttcomm_setsockopt_creds_unix_sock(client->socket);
2801 if (ret < 0) {
2802 ERR("[notification-thread] Failed to set socket options on new notification channel client socket");
2803 ret = 0;
2804 goto error;
2805 }
2806
2807 ret = lttng_poll_add(&state->events, client->socket,
2808 LPOLLIN | LPOLLERR |
2809 LPOLLHUP | LPOLLRDHUP);
2810 if (ret < 0) {
2811 ERR("[notification-thread] Failed to add notification channel client socket to poll set");
2812 ret = 0;
2813 goto error;
2814 }
2815 DBG("[notification-thread] Added new notification channel client socket (%i) to poll set",
2816 client->socket);
2817
2818 rcu_read_lock();
2819 cds_lfht_add(state->client_socket_ht,
2820 hash_client_socket(client->socket),
2821 &client->client_socket_ht_node);
2822 cds_lfht_add(state->client_id_ht,
2823 hash_client_id(client->id),
2824 &client->client_id_ht_node);
2825 rcu_read_unlock();
2826
2827 return ret;
2828
2829 error:
2830 notification_client_destroy(client, state);
2831 return ret;
2832 }
2833
2834 /*
2835 * RCU read-lock must be held by the caller.
2836 * Client lock must _not_ be held by the caller.
2837 */
2838 static
2839 int notification_thread_client_disconnect(
2840 struct notification_client *client,
2841 struct notification_thread_state *state)
2842 {
2843 int ret;
2844 struct lttng_condition_list_element *condition_list_element, *tmp;
2845
2846 /* Acquire the client lock to disable its communication atomically. */
2847 pthread_mutex_lock(&client->lock);
2848 client->communication.active = false;
2849 cds_lfht_del(state->client_socket_ht, &client->client_socket_ht_node);
2850 cds_lfht_del(state->client_id_ht, &client->client_id_ht_node);
2851 pthread_mutex_unlock(&client->lock);
2852
2853 ret = lttng_poll_del(&state->events, client->socket);
2854 if (ret) {
2855 ERR("[notification-thread] Failed to remove client socket %d from poll set",
2856 client->socket);
2857 }
2858
2859 /* Release all conditions to which the client was subscribed. */
2860 cds_list_for_each_entry_safe(condition_list_element, tmp,
2861 &client->condition_list, node) {
2862 (void) notification_thread_client_unsubscribe(client,
2863 condition_list_element->condition, state, NULL);
2864 }
2865
2866 /*
2867 * Client no longer accessible to other threads (through the
2868 * client lists).
2869 */
2870 notification_client_destroy(client, state);
2871 return ret;
2872 }
2873
2874 int handle_notification_thread_client_disconnect(
2875 int client_socket, struct notification_thread_state *state)
2876 {
2877 int ret = 0;
2878 struct notification_client *client;
2879
2880 rcu_read_lock();
2881 DBG("[notification-thread] Closing client connection (socket fd = %i)",
2882 client_socket);
2883 client = get_client_from_socket(client_socket, state);
2884 if (!client) {
2885 /* Internal state corruption, fatal error. */
2886 ERR("[notification-thread] Unable to find client (socket fd = %i)",
2887 client_socket);
2888 ret = -1;
2889 goto end;
2890 }
2891
2892 ret = notification_thread_client_disconnect(client, state);
2893 end:
2894 rcu_read_unlock();
2895 return ret;
2896 }
2897
2898 int handle_notification_thread_client_disconnect_all(
2899 struct notification_thread_state *state)
2900 {
2901 struct cds_lfht_iter iter;
2902 struct notification_client *client;
2903 bool error_encoutered = false;
2904
2905 rcu_read_lock();
2906 DBG("[notification-thread] Closing all client connections");
2907 cds_lfht_for_each_entry(state->client_socket_ht, &iter, client,
2908 client_socket_ht_node) {
2909 int ret;
2910
2911 ret = notification_thread_client_disconnect(
2912 client, state);
2913 if (ret) {
2914 error_encoutered = true;
2915 }
2916 }
2917 rcu_read_unlock();
2918 return error_encoutered ? 1 : 0;
2919 }
2920
2921 int handle_notification_thread_trigger_unregister_all(
2922 struct notification_thread_state *state)
2923 {
2924 bool error_occurred = false;
2925 struct cds_lfht_iter iter;
2926 struct lttng_trigger_ht_element *trigger_ht_element;
2927
2928 rcu_read_lock();
2929 cds_lfht_for_each_entry(state->triggers_ht, &iter, trigger_ht_element,
2930 node) {
2931 int ret = handle_notification_thread_command_unregister_trigger(
2932 state, trigger_ht_element->trigger, NULL);
2933 if (ret) {
2934 error_occurred = true;
2935 }
2936 }
2937 rcu_read_unlock();
2938 return error_occurred ? -1 : 0;
2939 }
2940
2941 static
2942 int client_handle_transmission_status(
2943 struct notification_client *client,
2944 enum client_transmission_status transmission_status,
2945 struct notification_thread_state *state)
2946 {
2947 int ret = 0;
2948
2949 switch (transmission_status) {
2950 case CLIENT_TRANSMISSION_STATUS_COMPLETE:
2951 ret = lttng_poll_mod(&state->events, client->socket,
2952 CLIENT_POLL_MASK_IN);
2953 if (ret) {
2954 goto end;
2955 }
2956
2957 break;
2958 case CLIENT_TRANSMISSION_STATUS_QUEUED:
2959 /*
2960 * We want to be notified whenever there is buffer space
2961 * available to send the rest of the payload.
2962 */
2963 ret = lttng_poll_mod(&state->events, client->socket,
2964 CLIENT_POLL_MASK_IN_OUT);
2965 if (ret) {
2966 goto end;
2967 }
2968 break;
2969 case CLIENT_TRANSMISSION_STATUS_FAIL:
2970 ret = notification_thread_client_disconnect(client, state);
2971 if (ret) {
2972 goto end;
2973 }
2974 break;
2975 case CLIENT_TRANSMISSION_STATUS_ERROR:
2976 ret = -1;
2977 goto end;
2978 default:
2979 abort();
2980 }
2981 end:
2982 return ret;
2983 }
2984
2985 /* Client lock must be acquired by caller. */
2986 static
2987 enum client_transmission_status client_flush_outgoing_queue(
2988 struct notification_client *client)
2989 {
2990 ssize_t ret;
2991 size_t to_send_count;
2992 enum client_transmission_status status;
2993 struct lttng_payload_view pv = lttng_payload_view_from_payload(
2994 &client->communication.outbound.payload, 0, -1);
2995 const int fds_to_send_count =
2996 lttng_payload_view_get_fd_handle_count(&pv);
2997
2998 ASSERT_LOCKED(client->lock);
2999
3000 if (!client->communication.active) {
3001 status = CLIENT_TRANSMISSION_STATUS_FAIL;
3002 goto end;
3003 }
3004
3005 if (pv.buffer.size == 0) {
3006 /*
3007 * If both data and fds are equal to zero, we are in an invalid
3008 * state.
3009 */
3010 assert(fds_to_send_count != 0);
3011 goto send_fds;
3012 }
3013
3014 /* Send data. */
3015 to_send_count = pv.buffer.size;
3016 DBG("[notification-thread] Flushing client (socket fd = %i) outgoing queue",
3017 client->socket);
3018
3019 ret = lttcomm_send_unix_sock_non_block(client->socket,
3020 pv.buffer.data,
3021 to_send_count);
3022 if ((ret >= 0 && ret < to_send_count)) {
3023 DBG("[notification-thread] Client (socket fd = %i) outgoing queue could not be completely flushed",
3024 client->socket);
3025 to_send_count -= max(ret, 0);
3026
3027 memmove(client->communication.outbound.payload.buffer.data,
3028 pv.buffer.data +
3029 pv.buffer.size - to_send_count,
3030 to_send_count);
3031 ret = lttng_dynamic_buffer_set_size(
3032 &client->communication.outbound.payload.buffer,
3033 to_send_count);
3034 if (ret) {
3035 goto error;
3036 }
3037
3038 status = CLIENT_TRANSMISSION_STATUS_QUEUED;
3039 goto end;
3040 } else if (ret < 0) {
3041 /* Generic error, disable the client's communication. */
3042 ERR("[notification-thread] Failed to flush outgoing queue, disconnecting client (socket fd = %i)",
3043 client->socket);
3044 client->communication.active = false;
3045 status = CLIENT_TRANSMISSION_STATUS_FAIL;
3046 goto end;
3047 } else {
3048 /*
3049 * No error and flushed the queue completely.
3050 *
3051 * The payload buffer size is used later to
3052 * check if there is notifications queued. So albeit that the
3053 * direct caller knows that the transmission is complete, we
3054 * need to set the buffer size to zero.
3055 */
3056 ret = lttng_dynamic_buffer_set_size(
3057 &client->communication.outbound.payload.buffer, 0);
3058 if (ret) {
3059 goto error;
3060 }
3061 }
3062
3063 send_fds:
3064 /* No fds to send, transmission is complete. */
3065 if (fds_to_send_count == 0) {
3066 status = CLIENT_TRANSMISSION_STATUS_COMPLETE;
3067 goto end;
3068 }
3069
3070 ret = lttcomm_send_payload_view_fds_unix_sock_non_block(
3071 client->socket, &pv);
3072 if (ret < 0) {
3073 /* Generic error, disable the client's communication. */
3074 ERR("[notification-thread] Failed to flush outgoing fds queue, disconnecting client (socket fd = %i)",
3075 client->socket);
3076 client->communication.active = false;
3077 status = CLIENT_TRANSMISSION_STATUS_FAIL;
3078 goto end;
3079 } else if (ret == 0) {
3080 /* Nothing could be sent. */
3081 status = CLIENT_TRANSMISSION_STATUS_QUEUED;
3082 } else {
3083 /* Fd passing is an all or nothing kind of thing. */
3084 status = CLIENT_TRANSMISSION_STATUS_COMPLETE;
3085 /*
3086 * The payload _fd_array count is used later to
3087 * check if there is notifications queued. So although the
3088 * direct caller knows that the transmission is complete, we
3089 * need to clear the _fd_array for the queuing check.
3090 */
3091 lttng_dynamic_pointer_array_clear(
3092 &client->communication.outbound.payload
3093 ._fd_handles);
3094 }
3095
3096 end:
3097 if (status == CLIENT_TRANSMISSION_STATUS_COMPLETE) {
3098 client->communication.outbound.queued_command_reply = false;
3099 client->communication.outbound.dropped_notification = false;
3100 lttng_payload_clear(&client->communication.outbound.payload);
3101 }
3102
3103 return status;
3104 error:
3105 return CLIENT_TRANSMISSION_STATUS_ERROR;
3106 }
3107
3108 static
3109 bool client_has_outbound_data_left(
3110 const struct notification_client *client)
3111 {
3112 const struct lttng_payload_view pv = lttng_payload_view_from_payload(
3113 &client->communication.outbound.payload, 0, -1);
3114 const bool has_data = pv.buffer.size != 0;
3115 const bool has_fds = lttng_payload_view_get_fd_handle_count(&pv);
3116
3117 return has_data || has_fds;
3118 }
3119
3120 /* Client lock must _not_ be held by the caller. */
3121 static
3122 int client_send_command_reply(struct notification_client *client,
3123 struct notification_thread_state *state,
3124 enum lttng_notification_channel_status status)
3125 {
3126 int ret;
3127 struct lttng_notification_channel_command_reply reply = {
3128 .status = (int8_t) status,
3129 };
3130 struct lttng_notification_channel_message msg = {
3131 .type = (int8_t) LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_COMMAND_REPLY,
3132 .size = sizeof(reply),
3133 };
3134 char buffer[sizeof(msg) + sizeof(reply)];
3135 enum client_transmission_status transmission_status;
3136
3137 memcpy(buffer, &msg, sizeof(msg));
3138 memcpy(buffer + sizeof(msg), &reply, sizeof(reply));
3139 DBG("[notification-thread] Send command reply (%i)", (int) status);
3140
3141 pthread_mutex_lock(&client->lock);
3142 if (client->communication.outbound.queued_command_reply) {
3143 /* Protocol error. */
3144 goto error_unlock;
3145 }
3146
3147 /* Enqueue buffer to outgoing queue and flush it. */
3148 ret = lttng_dynamic_buffer_append(
3149 &client->communication.outbound.payload.buffer,
3150 buffer, sizeof(buffer));
3151 if (ret) {
3152 goto error_unlock;
3153 }
3154
3155 transmission_status = client_flush_outgoing_queue(client);
3156
3157 if (client_has_outbound_data_left(client)) {
3158 /* Queue could not be emptied. */
3159 client->communication.outbound.queued_command_reply = true;
3160 }
3161
3162 pthread_mutex_unlock(&client->lock);
3163 ret = client_handle_transmission_status(
3164 client, transmission_status, state);
3165 if (ret) {
3166 goto error;
3167 }
3168
3169 return 0;
3170 error_unlock:
3171 pthread_mutex_unlock(&client->lock);
3172 error:
3173 return -1;
3174 }
3175
3176 static
3177 int client_handle_message_unknown(struct notification_client *client,
3178 struct notification_thread_state *state)
3179 {
3180 int ret;
3181 /*
3182 * Receiving message header. The function will be called again
3183 * once the rest of the message as been received and can be
3184 * interpreted.
3185 */
3186 const struct lttng_notification_channel_message *msg;
3187
3188 assert(sizeof(*msg) == client->communication.inbound.payload.buffer.size);
3189 msg = (const struct lttng_notification_channel_message *)
3190 client->communication.inbound.payload.buffer.data;
3191
3192 if (msg->size == 0 ||
3193 msg->size > DEFAULT_MAX_NOTIFICATION_CLIENT_MESSAGE_PAYLOAD_SIZE) {
3194 ERR("[notification-thread] Invalid notification channel message: length = %u",
3195 msg->size);
3196 ret = -1;
3197 goto end;
3198 }
3199
3200 switch (msg->type) {
3201 case LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_SUBSCRIBE:
3202 case LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_UNSUBSCRIBE:
3203 case LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_HANDSHAKE:
3204 break;
3205 default:
3206 ret = -1;
3207 ERR("[notification-thread] Invalid notification channel message: unexpected message type");
3208 goto end;
3209 }
3210
3211 client->communication.inbound.bytes_to_receive = msg->size;
3212 client->communication.inbound.fds_to_receive = msg->fds;
3213 client->communication.inbound.msg_type =
3214 (enum lttng_notification_channel_message_type) msg->type;
3215 ret = lttng_dynamic_buffer_set_size(
3216 &client->communication.inbound.payload.buffer, msg->size);
3217
3218 /* msg is not valid anymore due to lttng_dynamic_buffer_set_size. */
3219 msg = NULL;
3220 end:
3221 return ret;
3222 }
3223
3224 static
3225 int client_handle_message_handshake(struct notification_client *client,
3226 struct notification_thread_state *state)
3227 {
3228 int ret;
3229 struct lttng_notification_channel_command_handshake *handshake_client;
3230 const struct lttng_notification_channel_command_handshake handshake_reply = {
3231 .major = LTTNG_NOTIFICATION_CHANNEL_VERSION_MAJOR,
3232 .minor = LTTNG_NOTIFICATION_CHANNEL_VERSION_MINOR,
3233 };
3234 const struct lttng_notification_channel_message msg_header = {
3235 .type = LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_HANDSHAKE,
3236 .size = sizeof(handshake_reply),
3237 };
3238 enum lttng_notification_channel_status status =
3239 LTTNG_NOTIFICATION_CHANNEL_STATUS_OK;
3240 char send_buffer[sizeof(msg_header) + sizeof(handshake_reply)];
3241
3242 memcpy(send_buffer, &msg_header, sizeof(msg_header));
3243 memcpy(send_buffer + sizeof(msg_header), &handshake_reply,
3244 sizeof(handshake_reply));
3245
3246 handshake_client =
3247 (struct lttng_notification_channel_command_handshake *)
3248 client->communication.inbound.payload.buffer
3249 .data;
3250 client->major = handshake_client->major;
3251 client->minor = handshake_client->minor;
3252 if (!client->communication.inbound.creds_received) {
3253 ERR("[notification-thread] No credentials received from client");
3254 ret = -1;
3255 goto end;
3256 }
3257
3258 client->uid = LTTNG_SOCK_GET_UID_CRED(
3259 &client->communication.inbound.creds);
3260 client->gid = LTTNG_SOCK_GET_GID_CRED(
3261 &client->communication.inbound.creds);
3262 DBG("[notification-thread] Received handshake from client (uid = %u, gid = %u) with version %i.%i",
3263 client->uid, client->gid, (int) client->major,
3264 (int) client->minor);
3265
3266 if (handshake_client->major !=
3267 LTTNG_NOTIFICATION_CHANNEL_VERSION_MAJOR) {
3268 status = LTTNG_NOTIFICATION_CHANNEL_STATUS_UNSUPPORTED_VERSION;
3269 }
3270
3271 pthread_mutex_lock(&client->lock);
3272 /* Outgoing queue will be flushed when the command reply is sent. */
3273 ret = lttng_dynamic_buffer_append(
3274 &client->communication.outbound.payload.buffer, send_buffer,
3275 sizeof(send_buffer));
3276 if (ret) {
3277 ERR("[notification-thread] Failed to send protocol version to notification channel client");
3278 goto end_unlock;
3279 }
3280
3281 client->validated = true;
3282 client->communication.active = true;
3283 pthread_mutex_unlock(&client->lock);
3284
3285 /* Set reception state to receive the next message header. */
3286 ret = client_reset_inbound_state(client);
3287 if (ret) {
3288 ERR("[notification-thread] Failed to reset client communication's inbound state");
3289 goto end;
3290 }
3291
3292 /* Flushes the outgoing queue. */
3293 ret = client_send_command_reply(client, state, status);
3294 if (ret) {
3295 ERR("[notification-thread] Failed to send reply to notification channel client");
3296 goto end;
3297 }
3298
3299 goto end;
3300 end_unlock:
3301 pthread_mutex_unlock(&client->lock);
3302 end:
3303 return ret;
3304 }
3305
3306 static
3307 int client_handle_message_subscription(
3308 struct notification_client *client,
3309 enum lttng_notification_channel_message_type msg_type,
3310 struct notification_thread_state *state)
3311 {
3312 int ret;
3313 struct lttng_condition *condition;
3314 enum lttng_notification_channel_status status =
3315 LTTNG_NOTIFICATION_CHANNEL_STATUS_OK;
3316 struct lttng_payload_view condition_view =
3317 lttng_payload_view_from_payload(
3318 &client->communication.inbound.payload,
3319 0, -1);
3320 size_t expected_condition_size;
3321
3322 /*
3323 * No need to lock client to sample the inbound state as the only
3324 * other thread accessing clients (action executor) only uses the
3325 * outbound state.
3326 */
3327 expected_condition_size = client->communication.inbound.payload.buffer.size;
3328 ret = lttng_condition_create_from_payload(&condition_view, &condition);
3329 if (ret != expected_condition_size) {
3330 ERR("[notification-thread] Malformed condition received from client");
3331 goto end;
3332 }
3333
3334 if (msg_type == LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_SUBSCRIBE) {
3335 ret = notification_thread_client_subscribe(
3336 client, condition, state, &status);
3337 } else {
3338 ret = notification_thread_client_unsubscribe(
3339 client, condition, state, &status);
3340 }
3341
3342 if (ret) {
3343 goto end;
3344 }
3345
3346 /* Set reception state to receive the next message header. */
3347 ret = client_reset_inbound_state(client);
3348 if (ret) {
3349 ERR("[notification-thread] Failed to reset client communication's inbound state");
3350 goto end;
3351 }
3352
3353 ret = client_send_command_reply(client, state, status);
3354 if (ret) {
3355 ERR("[notification-thread] Failed to send reply to notification channel client");
3356 goto end;
3357 }
3358
3359 end:
3360 return ret;
3361 }
3362
3363 static
3364 int client_dispatch_message(struct notification_client *client,
3365 struct notification_thread_state *state)
3366 {
3367 int ret = 0;
3368
3369 if (client->communication.inbound.msg_type !=
3370 LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_HANDSHAKE &&
3371 client->communication.inbound.msg_type !=
3372 LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_UNKNOWN &&
3373 !client->validated) {
3374 WARN("[notification-thread] client attempted a command before handshake");
3375 ret = -1;
3376 goto end;
3377 }
3378
3379 switch (client->communication.inbound.msg_type) {
3380 case LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_UNKNOWN:
3381 {
3382 ret = client_handle_message_unknown(client, state);
3383 break;
3384 }
3385 case LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_HANDSHAKE:
3386 {
3387 ret = client_handle_message_handshake(client, state);
3388 break;
3389 }
3390 case LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_SUBSCRIBE:
3391 case LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_UNSUBSCRIBE:
3392 {
3393 ret = client_handle_message_subscription(client,
3394 client->communication.inbound.msg_type, state);
3395 break;
3396 }
3397 default:
3398 abort();
3399 }
3400 end:
3401 return ret;
3402 }
3403
3404 /* Incoming data from client. */
3405 int handle_notification_thread_client_in(
3406 struct notification_thread_state *state, int socket)
3407 {
3408 int ret = 0;
3409 struct notification_client *client;
3410 ssize_t recv_ret;
3411 size_t offset;
3412
3413 rcu_read_lock();
3414 client = get_client_from_socket(socket, state);
3415 if (!client) {
3416 /* Internal error, abort. */
3417 ret = -1;
3418 goto end;
3419 }
3420
3421 offset = client->communication.inbound.payload.buffer.size -
3422 client->communication.inbound.bytes_to_receive;
3423 if (client->communication.inbound.expect_creds) {
3424 recv_ret = lttcomm_recv_creds_unix_sock(socket,
3425 client->communication.inbound.payload.buffer.data + offset,
3426 client->communication.inbound.bytes_to_receive,
3427 &client->communication.inbound.creds);
3428 if (recv_ret > 0) {
3429 client->communication.inbound.expect_creds = false;
3430 client->communication.inbound.creds_received = true;
3431 }
3432 } else {
3433 recv_ret = lttcomm_recv_unix_sock_non_block(socket,
3434 client->communication.inbound.payload.buffer.data + offset,
3435 client->communication.inbound.bytes_to_receive);
3436 }
3437 if (recv_ret >= 0) {
3438 client->communication.inbound.bytes_to_receive -= recv_ret;
3439 } else {
3440 goto error_disconnect_client;
3441 }
3442
3443 if (client->communication.inbound.bytes_to_receive != 0) {
3444 /* Message incomplete wait for more data. */
3445 ret = 0;
3446 goto end;
3447 }
3448
3449 assert(client->communication.inbound.bytes_to_receive == 0);
3450
3451 /* Receive fds. */
3452 if (client->communication.inbound.fds_to_receive != 0) {
3453 ret = lttcomm_recv_payload_fds_unix_sock_non_block(
3454 client->socket,
3455 client->communication.inbound.fds_to_receive,
3456 &client->communication.inbound.payload);
3457 if (ret > 0) {
3458 /*
3459 * Fds received. non blocking fds passing is all
3460 * or nothing.
3461 */
3462 ssize_t expected_size;
3463
3464 expected_size = sizeof(int) *
3465 client->communication.inbound
3466 .fds_to_receive;
3467 assert(ret == expected_size);
3468 client->communication.inbound.fds_to_receive = 0;
3469 } else if (ret == 0) {
3470 /* Received nothing. */
3471 ret = 0;
3472 goto end;
3473 } else {
3474 goto error_disconnect_client;
3475 }
3476 }
3477
3478 /* At this point the message is complete.*/
3479 assert(client->communication.inbound.bytes_to_receive == 0 &&
3480 client->communication.inbound.fds_to_receive == 0);
3481 ret = client_dispatch_message(client, state);
3482 if (ret) {
3483 /*
3484 * Only returns an error if this client must be
3485 * disconnected.
3486 */
3487 goto error_disconnect_client;
3488 }
3489
3490 end:
3491 rcu_read_unlock();
3492 return ret;
3493
3494 error_disconnect_client:
3495 ret = notification_thread_client_disconnect(client, state);
3496 goto end;
3497 }
3498
3499 /* Client ready to receive outgoing data. */
3500 int handle_notification_thread_client_out(
3501 struct notification_thread_state *state, int socket)
3502 {
3503 int ret;
3504 struct notification_client *client;
3505 enum client_transmission_status transmission_status;
3506
3507 rcu_read_lock();
3508 client = get_client_from_socket(socket, state);
3509 if (!client) {
3510 /* Internal error, abort. */
3511 ret = -1;
3512 goto end;
3513 }
3514
3515 pthread_mutex_lock(&client->lock);
3516 transmission_status = client_flush_outgoing_queue(client);
3517 pthread_mutex_unlock(&client->lock);
3518
3519 ret = client_handle_transmission_status(
3520 client, transmission_status, state);
3521 if (ret) {
3522 goto end;
3523 }
3524 end:
3525 rcu_read_unlock();
3526 return ret;
3527 }
3528
3529 static
3530 bool evaluate_buffer_usage_condition(const struct lttng_condition *condition,
3531 const struct channel_state_sample *sample,
3532 uint64_t buffer_capacity)
3533 {
3534 bool result = false;
3535 uint64_t threshold;
3536 enum lttng_condition_type condition_type;
3537 const struct lttng_condition_buffer_usage *use_condition = container_of(
3538 condition, struct lttng_condition_buffer_usage,
3539 parent);
3540
3541 if (use_condition->threshold_bytes.set) {
3542 threshold = use_condition->threshold_bytes.value;
3543 } else {
3544 /*
3545 * Threshold was expressed as a ratio.
3546 *
3547 * TODO the threshold (in bytes) of conditions expressed
3548 * as a ratio of total buffer size could be cached to
3549 * forego this double-multiplication or it could be performed
3550 * as fixed-point math.
3551 *
3552 * Note that caching should accommodates the case where the
3553 * condition applies to multiple channels (i.e. don't assume
3554 * that all channels matching my_chann* have the same size...)
3555 */
3556 threshold = (uint64_t) (use_condition->threshold_ratio.value *
3557 (double) buffer_capacity);
3558 }
3559
3560 condition_type = lttng_condition_get_type(condition);
3561 if (condition_type == LTTNG_CONDITION_TYPE_BUFFER_USAGE_LOW) {
3562 DBG("[notification-thread] Low buffer usage condition being evaluated: threshold = %" PRIu64 ", highest usage = %" PRIu64,
3563 threshold, sample->highest_usage);
3564
3565 /*
3566 * The low condition should only be triggered once _all_ of the
3567 * streams in a channel have gone below the "low" threshold.
3568 */
3569 if (sample->highest_usage <= threshold) {
3570 result = true;
3571 }
3572 } else {
3573 DBG("[notification-thread] High buffer usage condition being evaluated: threshold = %" PRIu64 ", highest usage = %" PRIu64,
3574 threshold, sample->highest_usage);
3575
3576 /*
3577 * For high buffer usage scenarios, we want to trigger whenever
3578 * _any_ of the streams has reached the "high" threshold.
3579 */
3580 if (sample->highest_usage >= threshold) {
3581 result = true;
3582 }
3583 }
3584
3585 return result;
3586 }
3587
3588 static
3589 bool evaluate_session_consumed_size_condition(
3590 const struct lttng_condition *condition,
3591 uint64_t session_consumed_size)
3592 {
3593 uint64_t threshold;
3594 const struct lttng_condition_session_consumed_size *size_condition =
3595 container_of(condition,
3596 struct lttng_condition_session_consumed_size,
3597 parent);
3598
3599 threshold = size_condition->consumed_threshold_bytes.value;
3600 DBG("[notification-thread] Session consumed size condition being evaluated: threshold = %" PRIu64 ", current size = %" PRIu64,
3601 threshold, session_consumed_size);
3602 return session_consumed_size >= threshold;
3603 }
3604
3605 static
3606 int evaluate_buffer_condition(const struct lttng_condition *condition,
3607 struct lttng_evaluation **evaluation,
3608 const struct notification_thread_state *state,
3609 const struct channel_state_sample *previous_sample,
3610 const struct channel_state_sample *latest_sample,
3611 uint64_t previous_session_consumed_total,
3612 uint64_t latest_session_consumed_total,
3613 struct channel_info *channel_info)
3614 {
3615 int ret = 0;
3616 enum lttng_condition_type condition_type;
3617 const bool previous_sample_available = !!previous_sample;
3618 bool previous_sample_result = false;
3619 bool latest_sample_result;
3620
3621 condition_type = lttng_condition_get_type(condition);
3622
3623 switch (condition_type) {
3624 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_LOW:
3625 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_HIGH:
3626 if (caa_likely(previous_sample_available)) {
3627 previous_sample_result =
3628 evaluate_buffer_usage_condition(condition,
3629 previous_sample, channel_info->capacity);
3630 }
3631 latest_sample_result = evaluate_buffer_usage_condition(
3632 condition, latest_sample,
3633 channel_info->capacity);
3634 break;
3635 case LTTNG_CONDITION_TYPE_SESSION_CONSUMED_SIZE:
3636 if (caa_likely(previous_sample_available)) {
3637 previous_sample_result =
3638 evaluate_session_consumed_size_condition(
3639 condition,
3640 previous_session_consumed_total);
3641 }
3642 latest_sample_result =
3643 evaluate_session_consumed_size_condition(
3644 condition,
3645 latest_session_consumed_total);
3646 break;
3647 default:
3648 /* Unknown condition type; internal error. */
3649 abort();
3650 }
3651
3652 if (!latest_sample_result ||
3653 (previous_sample_result == latest_sample_result)) {
3654 /*
3655 * Only trigger on a condition evaluation transition.
3656 *
3657 * NOTE: This edge-triggered logic may not be appropriate for
3658 * future condition types.
3659 */
3660 goto end;
3661 }
3662
3663 if (!evaluation || !latest_sample_result) {
3664 goto end;
3665 }
3666
3667 switch (condition_type) {
3668 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_LOW:
3669 case LTTNG_CONDITION_TYPE_BUFFER_USAGE_HIGH:
3670 *evaluation = lttng_evaluation_buffer_usage_create(
3671 condition_type,
3672 latest_sample->highest_usage,
3673 channel_info->capacity);
3674 break;
3675 case LTTNG_CONDITION_TYPE_SESSION_CONSUMED_SIZE:
3676 *evaluation = lttng_evaluation_session_consumed_size_create(
3677 latest_session_consumed_total);
3678 break;
3679 default:
3680 abort();
3681 }
3682
3683 if (!*evaluation) {
3684 ret = -1;
3685 goto end;
3686 }
3687 end:
3688 return ret;
3689 }
3690
3691 static
3692 int client_notification_overflow(struct notification_client *client)
3693 {
3694 int ret = 0;
3695 const struct lttng_notification_channel_message msg = {
3696 .type = (int8_t) LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_NOTIFICATION_DROPPED,
3697 };
3698
3699 ASSERT_LOCKED(client->lock);
3700
3701 DBG("Dropping notification addressed to client (socket fd = %i)",
3702 client->socket);
3703 if (client->communication.outbound.dropped_notification) {
3704 /*
3705 * The client already has a "notification dropped" message
3706 * in its outgoing queue. Nothing to do since all
3707 * of those messages are coalesced.
3708 */
3709 goto end;
3710 }
3711
3712 client->communication.outbound.dropped_notification = true;
3713 ret = lttng_dynamic_buffer_append(
3714 &client->communication.outbound.payload.buffer, &msg,
3715 sizeof(msg));
3716 if (ret) {
3717 PERROR("Failed to enqueue \"dropped notification\" message in client's (socket fd = %i) outgoing queue",
3718 client->socket);
3719 }
3720 end:
3721 return ret;
3722 }
3723
3724 static int client_handle_transmission_status_wrapper(
3725 struct notification_client *client,
3726 enum client_transmission_status status,
3727 void *user_data)
3728 {
3729 return client_handle_transmission_status(client, status,
3730 (struct notification_thread_state *) user_data);
3731 }
3732
3733 static
3734 int send_evaluation_to_clients(const struct lttng_trigger *trigger,
3735 const struct lttng_evaluation *evaluation,
3736 struct notification_client_list* client_list,
3737 struct notification_thread_state *state,
3738 uid_t object_uid, gid_t object_gid)
3739 {
3740 const struct lttng_credentials creds = {
3741 .uid = LTTNG_OPTIONAL_INIT_VALUE(object_uid),
3742 .gid = LTTNG_OPTIONAL_INIT_VALUE(object_gid),
3743 };
3744
3745 return notification_client_list_send_evaluation(client_list,
3746 lttng_trigger_get_const_condition(trigger), evaluation,
3747 lttng_trigger_get_credentials(trigger),
3748 &creds,
3749 client_handle_transmission_status_wrapper, state);
3750 }
3751
3752 /*
3753 * Permission checks relative to notification channel clients are performed
3754 * here. Notice how object, client, and trigger credentials are involved in
3755 * this check.
3756 *
3757 * The `object` credentials are the credentials associated with the "subject"
3758 * of a condition. For instance, a `rotation completed` condition applies
3759 * to a session. When that condition is met, it will produce an evaluation
3760 * against a session. Hence, in this case, the `object` credentials are the
3761 * credentials of the "subject" session.
3762 *
3763 * The `trigger` credentials are the credentials of the user that registered the
3764 * trigger.
3765 *
3766 * The `client` credentials are the credentials of the user that created a given
3767 * notification channel.
3768 *
3769 * In terms of visibility, it is expected that non-privilieged users can only
3770 * register triggers against "their" objects (their own sessions and
3771 * applications they are allowed to interact with). They can then open a
3772 * notification channel and subscribe to notifications associated with those
3773 * triggers.
3774 *
3775 * As for privilieged users, they can register triggers against the objects of
3776 * other users. They can then subscribe to the notifications associated to their
3777 * triggers. Privilieged users _can't_ subscribe to the notifications of
3778 * triggers owned by other users; they must create their own triggers.
3779 *
3780 * This is more a concern of usability than security. It would be difficult for
3781 * a root user reliably subscribe to a specific set of conditions without
3782 * interference from external users (those could, for instance, unregister
3783 * their triggers).
3784 */
3785 LTTNG_HIDDEN
3786 int notification_client_list_send_evaluation(
3787 struct notification_client_list *client_list,
3788 const struct lttng_condition *condition,
3789 const struct lttng_evaluation *evaluation,
3790 const struct lttng_credentials *trigger_creds,
3791 const struct lttng_credentials *source_object_creds,
3792 report_client_transmission_result_cb client_report,
3793 void *user_data)
3794 {
3795 int ret = 0;
3796 struct lttng_payload msg_payload;
3797 struct notification_client_list_element *client_list_element, *tmp;
3798 const struct lttng_notification notification = {
3799 .condition = (struct lttng_condition *) condition,
3800 .evaluation = (struct lttng_evaluation *) evaluation,
3801 };
3802 struct lttng_notification_channel_message msg_header = {
3803 .type = (int8_t) LTTNG_NOTIFICATION_CHANNEL_MESSAGE_TYPE_NOTIFICATION,
3804 };
3805
3806 lttng_payload_init(&msg_payload);
3807
3808 ret = lttng_dynamic_buffer_append(&msg_payload.buffer, &msg_header,
3809 sizeof(msg_header));
3810 if (ret) {
3811 goto end;
3812 }
3813
3814 ret = lttng_notification_serialize(&notification, &msg_payload);
3815 if (ret) {
3816 ERR("[notification-thread] Failed to serialize notification");
3817 ret = -1;
3818 goto end;
3819 }
3820
3821 /* Update payload size. */
3822 ((struct lttng_notification_channel_message *) msg_payload.buffer.data)
3823 ->size = (uint32_t)(
3824 msg_payload.buffer.size - sizeof(msg_header));
3825
3826 /* Update the payload number of fds. */
3827 {
3828 const struct lttng_payload_view pv = lttng_payload_view_from_payload(
3829 &msg_payload, 0, -1);
3830
3831 ((struct lttng_notification_channel_message *)
3832 msg_payload.buffer.data)->fds = (uint32_t)
3833 lttng_payload_view_get_fd_handle_count(&pv);
3834 }
3835
3836 pthread_mutex_lock(&client_list->lock);
3837 cds_list_for_each_entry_safe(client_list_element, tmp,
3838 &client_list->list, node) {
3839 enum client_transmission_status transmission_status;
3840 struct notification_client *client =
3841 client_list_element->client;
3842
3843 ret = 0;
3844 pthread_mutex_lock(&client->lock);
3845 if (!client->communication.active) {
3846 /*
3847 * Skip inactive client (protocol error or
3848 * disconnecting).
3849 */
3850 DBG("Skipping client at it is marked as inactive");
3851 goto skip_client;
3852 }
3853
3854 if (source_object_creds) {
3855 if (client->uid != lttng_credentials_get_uid(source_object_creds) &&
3856 client->gid != lttng_credentials_get_gid(source_object_creds) &&
3857 client->uid != 0) {
3858 /*
3859 * Client is not allowed to monitor this
3860 * object.
3861 */
3862 DBG("[notification-thread] Skipping client at it does not have the object permission to receive notification for this trigger");
3863 goto skip_client;
3864 }
3865 }
3866
3867 if (client->uid != lttng_credentials_get_uid(trigger_creds) && client->gid != lttng_credentials_get_gid(trigger_creds)) {
3868 DBG("[notification-thread] Skipping client at it does not have the permission to receive notification for this trigger");
3869 goto skip_client;
3870 }
3871
3872 DBG("[notification-thread] Sending notification to client (fd = %i, %zu bytes)",
3873 client->socket, msg_payload.buffer.size);
3874
3875 if (client_has_outbound_data_left(client)) {
3876 /*
3877 * Outgoing data is already buffered for this client;
3878 * drop the notification and enqueue a "dropped
3879 * notification" message if this is the first dropped
3880 * notification since the socket spilled-over to the
3881 * queue.
3882 */
3883 ret = client_notification_overflow(client);
3884 if (ret) {
3885 /* Fatal error. */
3886 goto skip_client;
3887 }
3888 }
3889
3890 ret = lttng_payload_copy(&msg_payload, &client->communication.outbound.payload);
3891 if (ret) {
3892 /* Fatal error. */
3893 goto skip_client;
3894 }
3895
3896 transmission_status = client_flush_outgoing_queue(client);
3897 pthread_mutex_unlock(&client->lock);
3898 ret = client_report(client, transmission_status, user_data);
3899 if (ret) {
3900 /* Fatal error. */
3901 goto end_unlock_list;
3902 }
3903
3904 continue;
3905
3906 skip_client:
3907 pthread_mutex_unlock(&client->lock);
3908 if (ret) {
3909 /* Fatal error. */
3910 goto end_unlock_list;
3911 }
3912 }
3913 ret = 0;
3914
3915 end_unlock_list:
3916 pthread_mutex_unlock(&client_list->lock);
3917 end:
3918 lttng_payload_reset(&msg_payload);
3919 return ret;
3920 }
3921
3922 int handle_notification_thread_channel_sample(
3923 struct notification_thread_state *state, int pipe,
3924 enum lttng_domain_type domain)
3925 {
3926 int ret = 0;
3927 struct lttcomm_consumer_channel_monitor_msg sample_msg;
3928 struct channel_info *channel_info;
3929 struct cds_lfht_node *node;
3930 struct cds_lfht_iter iter;
3931 struct lttng_channel_trigger_list *trigger_list;
3932 struct lttng_trigger_list_element *trigger_list_element;
3933 bool previous_sample_available = false;
3934 struct channel_state_sample previous_sample, latest_sample;
3935 uint64_t previous_session_consumed_total, latest_session_consumed_total;
3936 struct lttng_credentials channel_creds;
3937
3938 /*
3939 * The monitoring pipe only holds messages smaller than PIPE_BUF,
3940 * ensuring that read/write of sampling messages are atomic.
3941 */
3942 ret = lttng_read(pipe, &sample_msg, sizeof(sample_msg));
3943 if (ret != sizeof(sample_msg)) {
3944 ERR("[notification-thread] Failed to read from monitoring pipe (fd = %i)",
3945 pipe);
3946 ret = -1;
3947 goto end;
3948 }
3949
3950 ret = 0;
3951 latest_sample.key.key = sample_msg.key;
3952 latest_sample.key.domain = domain;
3953 latest_sample.highest_usage = sample_msg.highest;
3954 latest_sample.lowest_usage = sample_msg.lowest;
3955 latest_sample.channel_total_consumed = sample_msg.total_consumed;
3956
3957 rcu_read_lock();
3958
3959 /* Retrieve the channel's informations */
3960 cds_lfht_lookup(state->channels_ht,
3961 hash_channel_key(&latest_sample.key),
3962 match_channel_info,
3963 &latest_sample.key,
3964 &iter);
3965 node = cds_lfht_iter_get_node(&iter);
3966 if (caa_unlikely(!node)) {
3967 /*
3968 * Not an error since the consumer can push a sample to the pipe
3969 * and the rest of the session daemon could notify us of the
3970 * channel's destruction before we get a chance to process that
3971 * sample.
3972 */
3973 DBG("[notification-thread] Received a sample for an unknown channel from consumerd, key = %" PRIu64 " in %s domain",
3974 latest_sample.key.key,
3975 domain == LTTNG_DOMAIN_KERNEL ? "kernel" :
3976 "user space");
3977 goto end_unlock;
3978 }
3979 channel_info = caa_container_of(node, struct channel_info,
3980 channels_ht_node);
3981 DBG("[notification-thread] Handling channel sample for channel %s (key = %" PRIu64 ") in session %s (highest usage = %" PRIu64 ", lowest usage = %" PRIu64", total consumed = %" PRIu64")",
3982 channel_info->name,
3983 latest_sample.key.key,
3984 channel_info->session_info->name,
3985 latest_sample.highest_usage,
3986 latest_sample.lowest_usage,
3987 latest_sample.channel_total_consumed);
3988
3989 previous_session_consumed_total =
3990 channel_info->session_info->consumed_data_size;
3991
3992 /* Retrieve the channel's last sample, if it exists, and update it. */
3993 cds_lfht_lookup(state->channel_state_ht,
3994 hash_channel_key(&latest_sample.key),
3995 match_channel_state_sample,
3996 &latest_sample.key,
3997 &iter);
3998 node = cds_lfht_iter_get_node(&iter);
3999 if (caa_likely(node)) {
4000 struct channel_state_sample *stored_sample;
4001
4002 /* Update the sample stored. */
4003 stored_sample = caa_container_of(node,
4004 struct channel_state_sample,
4005 channel_state_ht_node);
4006
4007 memcpy(&previous_sample, stored_sample,
4008 sizeof(previous_sample));
4009 stored_sample->highest_usage = latest_sample.highest_usage;
4010 stored_sample->lowest_usage = latest_sample.lowest_usage;
4011 stored_sample->channel_total_consumed = latest_sample.channel_total_consumed;
4012 previous_sample_available = true;
4013
4014 latest_session_consumed_total =
4015 previous_session_consumed_total +
4016 (latest_sample.channel_total_consumed - previous_sample.channel_total_consumed);
4017 } else {
4018 /*
4019 * This is the channel's first sample, allocate space for and
4020 * store the new sample.
4021 */
4022 struct channel_state_sample *stored_sample;
4023
4024 stored_sample = zmalloc(sizeof(*stored_sample));
4025 if (!stored_sample) {
4026 ret = -1;
4027 goto end_unlock;
4028 }
4029
4030 memcpy(stored_sample, &latest_sample, sizeof(*stored_sample));
4031 cds_lfht_node_init(&stored_sample->channel_state_ht_node);
4032 cds_lfht_add(state->channel_state_ht,
4033 hash_channel_key(&stored_sample->key),
4034 &stored_sample->channel_state_ht_node);
4035
4036 latest_session_consumed_total =
4037 previous_session_consumed_total +
4038 latest_sample.channel_total_consumed;
4039 }
4040
4041 channel_info->session_info->consumed_data_size =
4042 latest_session_consumed_total;
4043
4044 /* Find triggers associated with this channel. */
4045 cds_lfht_lookup(state->channel_triggers_ht,
4046 hash_channel_key(&latest_sample.key),
4047 match_channel_trigger_list,
4048 &latest_sample.key,
4049 &iter);
4050 node = cds_lfht_iter_get_node(&iter);
4051 if (caa_likely(!node)) {
4052 goto end_unlock;
4053 }
4054
4055 channel_creds = (typeof(channel_creds)) {
4056 .uid = LTTNG_OPTIONAL_INIT_VALUE(channel_info->session_info->uid),
4057 .gid = LTTNG_OPTIONAL_INIT_VALUE(channel_info->session_info->gid),
4058 };
4059
4060 trigger_list = caa_container_of(node, struct lttng_channel_trigger_list,
4061 channel_triggers_ht_node);
4062 cds_list_for_each_entry(trigger_list_element, &trigger_list->list,
4063 node) {
4064 const struct lttng_condition *condition;
4065 struct lttng_trigger *trigger;
4066 struct notification_client_list *client_list = NULL;
4067 struct lttng_evaluation *evaluation = NULL;
4068 enum action_executor_status executor_status;
4069
4070 ret = 0;
4071 trigger = trigger_list_element->trigger;
4072 condition = lttng_trigger_get_const_condition(trigger);
4073 assert(condition);
4074
4075 /*
4076 * Check if any client is subscribed to the result of this
4077 * evaluation.
4078 */
4079 client_list = get_client_list_from_condition(state, condition);
4080
4081 ret = evaluate_buffer_condition(condition, &evaluation, state,
4082 previous_sample_available ? &previous_sample : NULL,
4083 &latest_sample,
4084 previous_session_consumed_total,
4085 latest_session_consumed_total,
4086 channel_info);
4087 if (caa_unlikely(ret)) {
4088 goto put_list;
4089 }
4090
4091 if (caa_likely(!evaluation)) {
4092 goto put_list;
4093 }
4094
4095 /*
4096 * Ownership of `evaluation` transferred to the action executor
4097 * no matter the result.
4098 */
4099 executor_status = action_executor_enqueue(state->executor,
4100 trigger, evaluation, &channel_creds,
4101 client_list);
4102 evaluation = NULL;
4103 switch (executor_status) {
4104 case ACTION_EXECUTOR_STATUS_OK:
4105 break;
4106 case ACTION_EXECUTOR_STATUS_ERROR:
4107 case ACTION_EXECUTOR_STATUS_INVALID:
4108 /*
4109 * TODO Add trigger identification (name/id) when
4110 * it is added to the API.
4111 */
4112 ERR("Fatal error occurred while enqueuing action associated with buffer-condition trigger");
4113 ret = -1;
4114 goto put_list;
4115 case ACTION_EXECUTOR_STATUS_OVERFLOW:
4116 /*
4117 * TODO Add trigger identification (name/id) when
4118 * it is added to the API.
4119 *
4120 * Not a fatal error.
4121 */
4122 WARN("No space left when enqueuing action associated with buffer-condition trigger");
4123 ret = 0;
4124 goto put_list;
4125 default:
4126 abort();
4127 }
4128
4129 put_list:
4130 notification_client_list_put(client_list);
4131 if (caa_unlikely(ret)) {
4132 break;
4133 }
4134 }
4135 end_unlock:
4136 rcu_read_unlock();
4137 end:
4138 return ret;
4139 }
This page took 0.165307 seconds and 5 git commands to generate.