Commit | Line | Data |
---|---|---|
826d496d | 1 | /* |
b7384347 DG |
2 | * lttng.h |
3 | * | |
4 | * Linux Trace Toolkit Control Library Header File | |
5 | * | |
ab5be9fa | 6 | * Copyright (C) 2011 David Goulet <david.goulet@polymtl.ca> |
fac6795d | 7 | * |
ab5be9fa | 8 | * SPDX-License-Identifier: LGPL-2.1-only |
82a3637f | 9 | * |
fac6795d DG |
10 | */ |
11 | ||
73db5be4 DG |
12 | #ifndef LTTNG_H |
13 | #define LTTNG_H | |
fac6795d | 14 | |
03b1319d DG |
15 | /* Error codes that can be returned by API calls */ |
16 | #include <lttng/lttng-error.h> | |
17 | ||
1239a312 | 18 | /* Include every LTTng ABI/API available. */ |
a58c490f | 19 | #include <lttng/action/action.h> |
0c51e8f3 | 20 | #include <lttng/action/group.h> |
a58c490f | 21 | #include <lttng/action/notify.h> |
7f4d5b07 | 22 | #include <lttng/action/rate-policy.h> |
bfb2ec6a | 23 | #include <lttng/action/rotate-session.h> |
757c48a2 | 24 | #include <lttng/action/snapshot-session.h> |
58397d0d | 25 | #include <lttng/action/start-session.h> |
931bdbaa | 26 | #include <lttng/action/stop-session.h> |
260625bb | 27 | #include <lttng/channel.h> |
685ad3fc | 28 | #include <lttng/clear-handle.h> |
347f2c91 | 29 | #include <lttng/clear.h> |
a58c490f | 30 | #include <lttng/condition/buffer-usage.h> |
260625bb JR |
31 | #include <lttng/condition/condition.h> |
32 | #include <lttng/condition/evaluation.h> | |
e393070a | 33 | #include <lttng/condition/on-event.h> |
e8360425 | 34 | #include <lttng/condition/session-consumed-size.h> |
c19092cd | 35 | #include <lttng/condition/session-rotation.h> |
685ad3fc | 36 | #include <lttng/constant.h> |
260625bb JR |
37 | #include <lttng/destruction-handle.h> |
38 | #include <lttng/domain.h> | |
39 | #include <lttng/endpoint.h> | |
b99a0cb3 | 40 | #include <lttng/error-query.h> |
48c47564 | 41 | #include <lttng/event-expr.h> |
d28fcdec | 42 | #include <lttng/event-field-value.h> |
7a3dcaf6 | 43 | #include <lttng/event-rule/event-rule.h> |
a3c51653 | 44 | #include <lttng/event-rule/kernel-probe.h> |
e6a39346 | 45 | #include <lttng/event-rule/syscall.h> |
6d420eff | 46 | #include <lttng/event-rule/tracepoint.h> |
e957bf98 | 47 | #include <lttng/event-rule/userspace-probe.h> |
347f2c91 | 48 | #include <lttng/event.h> |
260625bb JR |
49 | #include <lttng/handle.h> |
50 | #include <lttng/health.h> | |
685ad3fc | 51 | #include <lttng/kernel-probe.h> |
11a49e7e JR |
52 | #include <lttng/load.h> |
53 | #include <lttng/location.h> | |
85b05318 | 54 | #include <lttng/log-level-rule.h> |
347f2c91 | 55 | #include <lttng/lttng-error.h> |
a58c490f JG |
56 | #include <lttng/notification/channel.h> |
57 | #include <lttng/notification/notification.h> | |
259c2674 | 58 | #include <lttng/rotation.h> |
260625bb JR |
59 | #include <lttng/save.h> |
60 | #include <lttng/session-descriptor.h> | |
61 | #include <lttng/session.h> | |
62 | #include <lttng/snapshot.h> | |
2d97a006 | 63 | #include <lttng/tracker.h> |
260625bb | 64 | #include <lttng/trigger/trigger.h> |
11a49e7e | 65 | #include <lttng/userspace-probe.h> |
1239a312 | 66 | |
5168918c DG |
67 | #ifdef __cplusplus |
68 | extern "C" { | |
69 | #endif | |
70 | ||
1239a312 DG |
71 | enum lttng_calibrate_type { |
72 | LTTNG_CALIBRATE_FUNCTION = 0, | |
54c90d10 | 73 | }; |
f3ed775e | 74 | |
c7e35b03 JR |
75 | /* Machine interface output type */ |
76 | enum lttng_mi_output_type { | |
77 | LTTNG_MI_XML = 1 /* XML output */ | |
78 | }; | |
79 | ||
8d326ab9 | 80 | #define LTTNG_CALIBRATE_PADDING1 16 |
d0254c7c MD |
81 | struct lttng_calibrate { |
82 | enum lttng_calibrate_type type; | |
8d326ab9 DG |
83 | |
84 | char padding[LTTNG_CALIBRATE_PADDING1]; | |
54c90d10 | 85 | }; |
d0254c7c | 86 | |
7d29a247 DG |
87 | /* |
88 | * Check if a session daemon is alive. | |
1e46a50f | 89 | * |
06662f07 DG |
90 | * Return 1 if alive or 0 if not. On error, returns a negative negative LTTng |
91 | * error code. | |
7d29a247 | 92 | */ |
947308c4 | 93 | extern int lttng_session_daemon_alive(void); |
f3ed775e | 94 | |
7d29a247 | 95 | /* |
1e46a50f TD |
96 | * Set the tracing group for the *current* flow of execution. |
97 | * | |
06662f07 | 98 | * On success, returns 0 else a negative LTTng error code. |
7d29a247 | 99 | */ |
b7384347 | 100 | extern int lttng_set_tracing_group(const char *name); |
f3ed775e | 101 | |
d9800920 | 102 | /* |
1e46a50f TD |
103 | * This call registers an "outside consumer" for a session and an lttng domain. |
104 | * No consumer will be spawned and all fds/commands will go through the socket | |
105 | * path given (socket_path). | |
d9800920 | 106 | * |
06662f07 DG |
107 | * NOTE that this is not recommended unless you absolutely know what you are |
108 | * doing. | |
109 | * | |
110 | * Return 0 on success else a negative LTTng error code. | |
d9800920 DG |
111 | */ |
112 | extern int lttng_register_consumer(struct lttng_handle *handle, | |
113 | const char *socket_path); | |
114 | ||
7d29a247 | 115 | /* |
06662f07 DG |
116 | * Start tracing for *all* domain(s) in the session. |
117 | * | |
118 | * Return 0 on success else a negative LTTng error code. | |
7d29a247 | 119 | */ |
6a4f824d | 120 | extern int lttng_start_tracing(const char *session_name); |
f3ed775e | 121 | |
7d29a247 | 122 | /* |
06662f07 | 123 | * Stop tracing for *all* domain(s) in the session. |
38ee087f DG |
124 | * |
125 | * This call will wait for data availability for each domain of the session so | |
126 | * this can take an abritrary amount of time. However, when returning you have | |
06662f07 | 127 | * the guarantee that the data is ready to be read and analyze. Use the |
38ee087f | 128 | * _no_wait call below to avoid this behavior. |
41039c06 DG |
129 | * |
130 | * The session_name can't be NULL. | |
06662f07 DG |
131 | * |
132 | * Return 0 on success else a negative LTTng error code. | |
7d29a247 | 133 | */ |
6a4f824d | 134 | extern int lttng_stop_tracing(const char *session_name); |
f3ed775e | 135 | |
38ee087f DG |
136 | /* |
137 | * Behave exactly like lttng_stop_tracing but does not wait for data | |
138 | * availability. | |
139 | */ | |
140 | extern int lttng_stop_tracing_no_wait(const char *session_name); | |
141 | ||
d0254c7c | 142 | /* |
b812e5ca PP |
143 | * Deprecated: As of LTTng 2.9, this function always returns |
144 | * -LTTNG_ERR_UND. | |
d0254c7c | 145 | */ |
cd80958d | 146 | extern int lttng_calibrate(struct lttng_handle *handle, |
d0254c7c MD |
147 | struct lttng_calibrate *calibrate); |
148 | ||
00e2e675 | 149 | /* |
a4b92340 DG |
150 | * Set URL for a consumer for a session and domain. |
151 | * | |
152 | * Both data and control URL must be defined. If both URLs are the same, only | |
153 | * the control URL is used even for network streaming. | |
00e2e675 | 154 | * |
a4b92340 DG |
155 | * Default port are 5342 and 5343 respectively for control and data which uses |
156 | * the TCP protocol. | |
06662f07 DG |
157 | * |
158 | * URL format: proto://[HOST|IP][:PORT1[:PORT2]][/TRACE_PATH] | |
159 | * | |
160 | * Possible protocols are: | |
161 | * > file://... | |
162 | * Local filesystem full path. | |
163 | * | |
164 | * > net[6]://... | |
165 | * This will use the default network transport layer which is TCP for both | |
166 | * control (PORT1) and data port (PORT2). | |
167 | * | |
168 | * > tcp[6]://... | |
169 | * TCP only streaming. For this one, both data and control URL must be given. | |
170 | * | |
171 | * Return 0 on success else a negative LTTng error code. | |
00e2e675 | 172 | */ |
a4b92340 DG |
173 | extern int lttng_set_consumer_url(struct lttng_handle *handle, |
174 | const char *control_url, const char *data_url); | |
00e2e675 | 175 | |
806e2684 DG |
176 | /* |
177 | * For a given session name, this call checks if the data is ready to be read | |
6d805429 DG |
178 | * or is still being extracted by the consumer(s) (pending) hence not ready to |
179 | * be used by any readers. | |
806e2684 | 180 | * |
6d805429 DG |
181 | * Return 0 if there is _no_ data pending in the buffers thus having a |
182 | * guarantee that the data can be read safely. Else, return 1 if there is still | |
183 | * traced data is pending. On error, a negative value is returned and readable | |
184 | * by lttng_strerror(). | |
806e2684 | 185 | */ |
6d805429 | 186 | extern int lttng_data_pending(const char *session_name); |
806e2684 | 187 | |
eded6438 JD |
188 | /* |
189 | * Deprecated, replaced by lttng_regenerate_metadata. | |
190 | */ | |
191 | LTTNG_DEPRECATED() | |
192 | extern int lttng_metadata_regenerate(const char *session_name); | |
193 | ||
93ec662e JD |
194 | /* |
195 | * Trigger the regeneration of the metadata for a session. | |
196 | * The new metadata overwrite the previous one locally or remotely (through | |
197 | * the lttng-relayd). Only kernel, per-uid and non-live sessions are supported. | |
198 | * Return 0 on success, a negative LTTng error code on error. | |
199 | */ | |
eded6438 | 200 | extern int lttng_regenerate_metadata(const char *session_name); |
93ec662e | 201 | |
c2561365 JD |
202 | /* |
203 | * Trigger the regeneration of the statedump for a session. The new statedump | |
204 | * information is appended to the currently active trace, the session needs to | |
205 | * be active. | |
206 | * | |
207 | * Return 0 on success, a negative LTTng error code on error. | |
208 | */ | |
209 | extern int lttng_regenerate_statedump(const char *session_name); | |
210 | ||
5168918c DG |
211 | #ifdef __cplusplus |
212 | } | |
213 | #endif | |
214 | ||
73db5be4 | 215 | #endif /* LTTNG_H */ |