2 * Copyright (C) 2017 Jérémie Galarneau <jeremie.galarneau@efficios.com>
4 * SPDX-License-Identifier: LGPL-2.1-only
8 #ifndef LTTNG_TRIGGER_INTERNAL_H
9 #define LTTNG_TRIGGER_INTERNAL_H
11 #include <lttng/trigger/trigger.h>
12 #include <common/credentials.h>
13 #include <common/dynamic-array.h>
14 #include <common/macros.h>
15 #include <common/optional.h>
18 #include <sys/types.h>
22 struct lttng_payload_view
;
24 struct lttng_trigger
{
25 /* Reference counting is only exposed to internal users. */
28 struct lttng_condition
*condition
;
29 struct lttng_action
*action
;
31 /* For now only the uid portion of the credentials is used. */
32 struct lttng_credentials creds
;
35 * The unique token passed to the tracer to identify an event-rule
38 LTTNG_OPTIONAL(uint64_t) tracer_token
;
41 struct lttng_triggers
{
42 struct lttng_dynamic_pointer_array array
;
45 struct lttng_trigger_comm
{
47 * Credentials, only the uid portion is used for now.
48 * Used as an override when desired by the root user.
52 * Length of the variable length payload (name, condition, and
56 /* Includes '\0' terminator. */
58 /* A null-terminated name, a condition, and an action follow. */
62 struct lttng_triggers_comm
{
65 /* Count * lttng_trigger_comm structure */
70 ssize_t
lttng_trigger_create_from_payload(struct lttng_payload_view
*view
,
71 struct lttng_trigger
**trigger
);
74 int lttng_trigger_serialize(const struct lttng_trigger
*trigger
,
75 struct lttng_payload
*payload
);
78 const struct lttng_condition
*lttng_trigger_get_const_condition(
79 const struct lttng_trigger
*trigger
);
82 const struct lttng_action
*lttng_trigger_get_const_action(
83 const struct lttng_trigger
*trigger
);
86 bool lttng_trigger_validate(struct lttng_trigger
*trigger
);
89 int lttng_trigger_assign_name(
90 struct lttng_trigger
*dst
, const struct lttng_trigger
*src
);
93 void lttng_trigger_set_tracer_token(
94 struct lttng_trigger
*trigger
, uint64_t token
);
97 uint64_t lttng_trigger_get_tracer_token(const struct lttng_trigger
*trigger
);
100 int lttng_trigger_generate_name(struct lttng_trigger
*trigger
,
104 bool lttng_trigger_is_equal(
105 const struct lttng_trigger
*a
, const struct lttng_trigger
*b
);
108 void lttng_trigger_get(struct lttng_trigger
*trigger
);
111 void lttng_trigger_put(struct lttng_trigger
*trigger
);
114 * Allocate a new set of triggers.
115 * The returned object must be freed via lttng_triggers_destroy.
118 struct lttng_triggers
*lttng_triggers_create(void);
121 * Return the a pointer to a mutable element at index "index" of an
122 * lttng_triggers set.
124 * This differs from the public `lttng_triggers_get_at_index` in that
125 * the returned pointer to a mutable trigger.
127 * The ownership of the trigger set element is NOT transfered.
128 * The returned object can NOT be freed via lttng_trigger_destroy.
131 struct lttng_trigger
*lttng_triggers_borrow_mutable_at_index(
132 const struct lttng_triggers
*triggers
, unsigned int index
);
135 * Add a trigger to the triggers set.
137 * A reference to the added trigger is acquired on behalf of the trigger set
141 int lttng_triggers_add(
142 struct lttng_triggers
*triggers
, struct lttng_trigger
*trigger
);
145 * Serialize a trigger set to an lttng_payload object.
146 * Return LTTNG_OK on success, negative lttng error code on error.
149 int lttng_triggers_serialize(const struct lttng_triggers
*triggers
,
150 struct lttng_payload
*payload
);
153 ssize_t
lttng_triggers_create_from_payload(struct lttng_payload_view
*view
,
154 struct lttng_triggers
**triggers
);
157 const struct lttng_credentials
*lttng_trigger_get_credentials(
158 const struct lttng_trigger
*trigger
);
161 void lttng_trigger_set_credentials(struct lttng_trigger
*trigger
,
162 const struct lttng_credentials
*creds
);
164 #endif /* LTTNG_TRIGGER_INTERNAL_H */