Commit | Line | Data |
---|---|---|
022d91ba | 1 | /* |
ab5be9fa MJ |
2 | * Copyright (C) 2013 David Goulet <dgoulet@efficios.com> |
3 | * Copyright (C) 2016 Jérémie Galarneau <jeremie.galarneau@efficios.com> | |
022d91ba | 4 | * |
ab5be9fa | 5 | * SPDX-License-Identifier: GPL-2.0-only |
022d91ba | 6 | * |
022d91ba DG |
7 | */ |
8 | ||
9 | #ifndef LTTNG_SESSIOND_AGENT_H | |
10 | #define LTTNG_SESSIOND_AGENT_H | |
11 | ||
c9e313bc | 12 | #include <common/hashtable/hashtable.hpp> |
28f23191 | 13 | |
022d91ba DG |
14 | #include <lttng/lttng.h> |
15 | ||
28f23191 | 16 | #include <inttypes.h> |
13d03b1e | 17 | #include <urcu/urcu.h> |
28f23191 | 18 | |
9474416f | 19 | /* Agent protocol version that is verified during the agent registration. */ |
28f23191 JG |
20 | #define AGENT_MAJOR_VERSION 2 |
21 | #define AGENT_MINOR_VERSION 0 | |
9474416f | 22 | |
022d91ba DG |
23 | /* |
24 | * Hash table that contains the agent app created upon registration indexed by | |
7c1d2758 | 25 | * socket. Global to the session daemon. |
022d91ba | 26 | */ |
412d7227 | 27 | extern struct lttng_ht *the_agent_apps_ht_by_sock; |
022d91ba | 28 | |
44760c20 JR |
29 | /* |
30 | * Hash table that contains the trigger agents by domain */ | |
412d7227 | 31 | extern struct lttng_ht *the_trigger_agents_ht_by_domain; |
44760c20 | 32 | |
022d91ba DG |
33 | struct agent_ht_key { |
34 | const char *name; | |
2106efa0 | 35 | int loglevel_value; |
a9319624 | 36 | enum lttng_loglevel_type loglevel_type; |
44760c20 | 37 | const char *filter_expression; |
022d91ba DG |
38 | }; |
39 | ||
40 | /* | |
41 | * Registration message payload from an agent application. The PID is used to | |
42 | * find back the corresponding UST app object so both socket can be linked. | |
43 | */ | |
44 | struct agent_register_msg { | |
fefd409b DG |
45 | /* This maps to a lttng_domain_type. */ |
46 | uint32_t domain; | |
022d91ba | 47 | uint32_t pid; |
9474416f DG |
48 | uint32_t major_version; |
49 | uint32_t minor_version; | |
022d91ba DG |
50 | }; |
51 | ||
52 | /* | |
53 | * Agent application object created after a successful registration. This | |
54 | * object is linked to its associated UST app by their PID through hash table | |
55 | * lookups. | |
56 | */ | |
57 | struct agent_app { | |
58 | /* | |
d53e2992 | 59 | * PID sent during registration of an agent application. |
022d91ba DG |
60 | */ |
61 | pid_t pid; | |
62 | ||
fefd409b DG |
63 | /* Domain of the application. */ |
64 | enum lttng_domain_type domain; | |
65 | ||
022d91ba DG |
66 | /* |
67 | * AGENT TCP socket that was created upon registration. | |
68 | */ | |
69 | struct lttcomm_sock *sock; | |
70 | ||
71 | /* Initialized with the AGENT sock value. */ | |
72 | struct lttng_ht_node_ulong node; | |
73 | }; | |
74 | ||
75 | /* | |
76 | * Agent event representation. | |
44760c20 | 77 | * Accesses to this structure are protected by the session list lock. |
022d91ba DG |
78 | */ |
79 | struct agent_event { | |
80 | /* Name of the event. */ | |
81 | char name[LTTNG_SYMBOL_NAME_LEN]; | |
2106efa0 | 82 | int loglevel_value; |
022d91ba DG |
83 | enum lttng_loglevel_type loglevel_type; |
84 | ||
85 | /* | |
44760c20 JR |
86 | * Tells if the event is enabled or not on the agent. While this can be |
87 | * implicitly tested as a boolean, it is in fact a reference count and | |
88 | * the AGENT_EVENT_IS_ENABLED macro should be used to prevent accidental | |
89 | * comparisons to non-zero literals (e.g. '1'). | |
90 | * | |
91 | * Multiple triggers and events can map to the same agent event as it | |
92 | * is merely a "filter" in front of a user space tracer enabler. | |
93 | * | |
94 | * This count is updated to ensure an event is only disabled when all | |
95 | * matching enablers are disabled. | |
022d91ba | 96 | */ |
44760c20 | 97 | unsigned int enabled_count; |
022d91ba DG |
98 | |
99 | /* Hash table node of the agent domain object. */ | |
100 | struct lttng_ht_node_str node; | |
101 | ||
51755dc8 | 102 | /* Filter associated with the event. NULL if none. */ |
2b00d462 | 103 | struct lttng_bytecode *filter; |
51755dc8 JG |
104 | char *filter_expression; |
105 | struct lttng_event_exclusion *exclusion; | |
022d91ba DG |
106 | }; |
107 | ||
0f4aa1a8 | 108 | #define AGENT_EVENT_IS_ENABLED(agent_event) (!!(agent_event)->enabled_count) |
44760c20 | 109 | |
022d91ba | 110 | /* |
44760c20 JR |
111 | * Agent object containing events enabled/disabled for a given domain in a |
112 | * scope. The scope is typically a session, but can also be "global" in the | |
113 | * context of event notifiers: see event_notifiers_find_agent(). | |
022d91ba DG |
114 | */ |
115 | struct agent { | |
116 | /* | |
117 | * This indicates if that domain is being used meaning if at least one | |
118 | * event has been at some point in time added to it. This is used so when | |
119 | * listing domains for a session, we can tell or not if the agent is | |
120 | * actually enabled. | |
121 | */ | |
122 | unsigned int being_used:1; | |
fefd409b DG |
123 | |
124 | /* What domain this agent is. */ | |
125 | enum lttng_domain_type domain; | |
126 | ||
022d91ba DG |
127 | /* Contains event indexed by name. */ |
128 | struct lttng_ht *events; | |
fefd409b | 129 | |
bdf64013 JG |
130 | /* Application context list (struct agent_app_ctx). */ |
131 | struct cds_list_head app_ctx_list; | |
132 | ||
fefd409b DG |
133 | /* Node used for the hash table indexed by domain type. */ |
134 | struct lttng_ht_node_u64 node; | |
022d91ba DG |
135 | }; |
136 | ||
6a4e4039 | 137 | /* Allocate agent apps hash table */ |
0f4aa1a8 | 138 | int agent_app_ht_alloc(); |
6a4e4039 | 139 | /* Clean-up agent apps hash table */ |
0f4aa1a8 | 140 | void agent_app_ht_clean(); |
022d91ba DG |
141 | |
142 | /* Initialize an already allocated agent domain. */ | |
143 | int agent_init(struct agent *agt); | |
fefd409b | 144 | struct agent *agent_create(enum lttng_domain_type domain); |
022d91ba | 145 | void agent_destroy(struct agent *agt); |
fefd409b | 146 | void agent_add(struct agent *agt, struct lttng_ht *ht); |
022d91ba DG |
147 | |
148 | /* Agent event API. */ | |
a9319624 | 149 | struct agent_event *agent_create_event(const char *name, |
28f23191 JG |
150 | enum lttng_loglevel_type loglevel_type, |
151 | int loglevel_value, | |
152 | struct lttng_bytecode *filter, | |
153 | char *filter_expression); | |
022d91ba DG |
154 | void agent_add_event(struct agent_event *event, struct agent *agt); |
155 | ||
a9319624 | 156 | struct agent_event *agent_find_event(const char *name, |
28f23191 JG |
157 | enum lttng_loglevel_type loglevel_type, |
158 | int loglevel_value, | |
159 | const char *filter_expression, | |
160 | struct agent *agt); | |
161 | void agent_find_events_by_name(const char *name, struct agent *agt, struct lttng_ht_iter *iter); | |
162 | void agent_event_next_duplicate(const char *name, struct agent *agt, struct lttng_ht_iter *iter); | |
022d91ba DG |
163 | void agent_delete_event(struct agent_event *event, struct agent *agt); |
164 | void agent_destroy_event(struct agent_event *event); | |
165 | ||
bdf64013 | 166 | /* Agent context API.*/ |
28f23191 JG |
167 | int agent_enable_context(const struct lttng_event_context *ctx, enum lttng_domain_type domain); |
168 | int agent_add_context(const struct lttng_event_context *ctx, struct agent *agt); | |
bdf64013 | 169 | |
022d91ba | 170 | /* Agent app API. */ |
28f23191 JG |
171 | struct agent_app * |
172 | agent_create_app(pid_t pid, enum lttng_domain_type domain, struct lttcomm_sock *sock); | |
022d91ba DG |
173 | void agent_add_app(struct agent_app *app); |
174 | void agent_delete_app(struct agent_app *app); | |
175 | struct agent_app *agent_find_app_by_sock(int sock); | |
176 | void agent_destroy_app(struct agent_app *app); | |
6a4e4039 | 177 | void agent_destroy_app_by_sock(int sock); |
022d91ba DG |
178 | int agent_send_registration_done(struct agent_app *app); |
179 | ||
180 | /* Agent action API */ | |
28f23191 JG |
181 | int agent_enable_event(struct agent_event *event, enum lttng_domain_type domain); |
182 | int agent_disable_event(struct agent_event *event, enum lttng_domain_type domain); | |
733c9165 | 183 | void agent_update(const struct agent *agt, const struct agent_app *app); |
28f23191 | 184 | int agent_list_events(struct lttng_event **events, enum lttng_domain_type domain); |
022d91ba | 185 | |
28f23191 JG |
186 | struct agent_event *agent_find_event_by_trigger(const struct lttng_trigger *trigger, |
187 | struct agent *agt); | |
44760c20 JR |
188 | |
189 | /* Global event notifier per-domain agents. */ | |
28f23191 | 190 | struct agent *agent_find_by_event_notifier_domain(enum lttng_domain_type domain_type); |
0f4aa1a8 JG |
191 | void agent_by_event_notifier_domain_ht_destroy(); |
192 | int agent_by_event_notifier_domain_ht_create(); | |
44760c20 | 193 | |
022d91ba | 194 | #endif /* LTTNG_SESSIOND_AGENT_H */ |