Commit | Line | Data |
---|---|---|
a58c490f JG |
1 | /* |
2 | * Copyright (C) 2017 - Jérémie Galarneau <jeremie.galarneau@efficios.com> | |
3 | * | |
4 | * This library is free software; you can redistribute it and/or modify it | |
5 | * under the terms of the GNU Lesser General Public License, version 2.1 only, | |
6 | * as published by the Free Software Foundation. | |
7 | * | |
8 | * This library is distributed in the hope that it will be useful, but WITHOUT | |
9 | * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
10 | * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License | |
11 | * for more details. | |
12 | * | |
13 | * You should have received a copy of the GNU Lesser General Public License | |
14 | * along with this library; if not, write to the Free Software Foundation, | |
15 | * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA | |
16 | */ | |
17 | ||
18 | #ifndef LTTNG_NOTIFICATION_INTERNAL_H | |
19 | #define LTTNG_NOTIFICATION_INTERNAL_H | |
20 | ||
21 | #include <lttng/notification/notification.h> | |
22 | #include <common/macros.h> | |
23 | #include <common/buffer-view.h> | |
24 | #include <stdint.h> | |
25 | #include <stdbool.h> | |
26 | ||
27 | struct lttng_notification { | |
28 | struct lttng_condition *condition; | |
29 | struct lttng_evaluation *evaluation; | |
30 | /* | |
31 | * The ownership of the notification's inner-elements depends | |
32 | * on the way it was created. The notification owns both | |
33 | * the condition and evaluation if it was obtained from a notification | |
34 | * channel (i.e. created using lttng_notification_create_from_buffer) | |
35 | * as the user may never access the condition and evaluation, | |
36 | * thus never getting a chance to free them. | |
37 | * | |
38 | * However, when the _private_ lttng_notification_create() function | |
39 | * is used, no ownership of condition and evaluation is assumed by | |
40 | * the notification object. The main reason for this change in | |
41 | * behavior is that internal users of this API only use the object | |
42 | * to use its serialization facilities. | |
43 | */ | |
44 | bool owns_elements; | |
45 | }; | |
46 | ||
47 | struct lttng_notification_comm { | |
48 | /* Size of the payload following this field. */ | |
49 | uint32_t length; | |
50 | /* Condition and evaluation objects follow. */ | |
51 | char payload[]; | |
52 | } LTTNG_PACKED; | |
53 | ||
54 | LTTNG_HIDDEN | |
55 | struct lttng_notification *lttng_notification_create( | |
56 | struct lttng_condition *condition, | |
57 | struct lttng_evaluation *evaluation); | |
58 | ||
59 | LTTNG_HIDDEN | |
60 | ssize_t lttng_notification_serialize(struct lttng_notification *notification, | |
61 | char *buf); | |
62 | ||
63 | LTTNG_HIDDEN | |
64 | ssize_t lttng_notification_create_from_buffer( | |
65 | const struct lttng_buffer_view *view, | |
66 | struct lttng_notification **notification); | |
67 | ||
68 | #endif /* LTTNG_NOTIFICATION_INTERNAL_H */ |