Debian Codegraph @

extras/bindings/swig/python/lttng.i.in

raw
1 /*
2 * Copyright (C) 2012 Danny Serres <[email protected]>
3 *
4 * SPDX-License-Identifier: GPL-2.0-only
5 *
6 */
7
8 %define DOCSTRING
9 "LTTNG_VERSION_STR
10
11 The LTTng project aims at providing highly efficient tracing tools for Linux.
12 It's tracers help tracking down performance issues and debugging problems involving
13 multiple concurrent processes and threads. Tracing across multiple systems is also possible."
14 %enddef
15
16 %module(docstring=DOCSTRING) lttng
17
18 %include "typemaps.i"
19 %include "stdint.i"
20 %include "pyabc.i"
21 %{
22 #define SWIG_FILE_WITH_INIT
23 #include <lttng/lttng.h>
24 %}
25
26 %{
27 #if PY_MAJOR_VERSION >= 3
28 // The PyInt and PyLong types were unified as of Python 3
29 // This makes the typemap code useable with both Python 2 and 3.
30 #define PyInt_AsSsize_t PyLong_AsSsize_t
31 #endif
32
33 // Avoid -Wmissing-declarations warning.
34 PyObject *SWIG_init(void);
35
36 // Avoid -Wmissing-prototypes warning with SWIG 3.0.10.
37 #if SWIG_VERSION < 0x30012
38 static size_t SWIG_strnlen(const char* s, size_t maxlen);
39 #endif
40 %}
41
42 typedef unsigned int uint32_t;
43 typedef int int32_t;
44 typedef unsigned long long uint64_t;
45 typedef long pid_t;
46
47
48 // =============================================
49 // ENUMS
50 // These are directly taken from lttng.h.
51 // Any change to these enums must also be
52 // made here.
53 // =============================================
54
55 %rename("DOMAIN_KERNEL") LTTNG_DOMAIN_KERNEL;
56 %rename("DOMAIN_UST") LTTNG_DOMAIN_UST;
57 enum lttng_domain_type {
58 LTTNG_DOMAIN_KERNEL = 1,
59 LTTNG_DOMAIN_UST = 2,
60 };
61
62 %rename("BUFFER_PER_PID") LTTNG_BUFFER_PER_PID;
63 %rename("BUFFER_PER_UID") LTTNG_BUFFER_PER_UID;
64 %rename("BUFFER_GLOBAL") LTTNG_BUFFER_GLOBAL;
65 enum lttng_buffer_type {
66 LTTNG_BUFFER_PER_PID,
67 LTTNG_BUFFER_PER_UID,
68 LTTNG_BUFFER_GLOBAL,
69 };
70
71 %rename("EVENT_ALL") LTTNG_EVENT_ALL;
72 %rename("EVENT_TRACEPOINT") LTTNG_EVENT_TRACEPOINT;
73 %rename("EVENT_PROBE") LTTNG_EVENT_PROBE;
74 %rename("EVENT_FUNCTION")LTTNG_EVENT_FUNCTION;
75 %rename("EVENT_FUNCTION_ENTRY") LTTNG_EVENT_FUNCTION_ENTRY;
76 %rename("EVENT_NOOP") LTTNG_EVENT_NOOP;
77 %rename("EVENT_SYSCALL") LTTNG_EVENT_SYSCALL;
78 enum lttng_event_type {
79 LTTNG_EVENT_ALL = -1,
80 LTTNG_EVENT_TRACEPOINT = 0,
81 LTTNG_EVENT_PROBE = 1,
82 LTTNG_EVENT_FUNCTION = 2,
83 LTTNG_EVENT_FUNCTION_ENTRY = 3,
84 LTTNG_EVENT_NOOP = 4,
85 LTTNG_EVENT_SYSCALL = 5,
86 };
87
88 %rename("EVENT_LOGLEVEL_ALL") LTTNG_EVENT_LOGLEVEL_ALL;
89 %rename("EVENT_LOGLEVEL_RANGE") LTTNG_EVENT_LOGLEVEL_RANGE;
90 %rename("EVENT_LOGLEVEL_SINGLE") LTTNG_EVENT_LOGLEVEL_SINGLE;
91 enum lttng_loglevel_type {
92 LTTNG_EVENT_LOGLEVEL_ALL = 0,
93 LTTNG_EVENT_LOGLEVEL_RANGE = 1,
94 LTTNG_EVENT_LOGLEVEL_SINGLE = 2,
95 };
96
97 %rename("LOGLEVEL_EMERG") LTTNG_LOGLEVEL_EMERG;
98 %rename("LOGLEVEL_ALERT") LTTNG_LOGLEVEL_ALERT;
99 %rename("LOGLEVEL_CRIT") LTTNG_LOGLEVEL_CRIT;
100 %rename("LOGLEVEL_ERR") LTTNG_LOGLEVEL_ERR;
101 %rename("LOGLEVEL_WARNING") LTTNG_LOGLEVEL_WARNING;
102 %rename("LOGLEVEL_NOTICE") LTTNG_LOGLEVEL_NOTICE;
103 %rename("LOGLEVEL_INFO") LTTNG_LOGLEVEL_INFO;
104 %rename("LOGLEVEL_DEBUG_SYSTEM") LTTNG_LOGLEVEL_DEBUG_SYSTEM;
105 %rename("LOGLEVEL_DEBUG_PROGRAM") LTTNG_LOGLEVEL_DEBUG_PROGRAM;
106 %rename("LOGLEVEL_DEBUG_PROCESS") LTTNG_LOGLEVEL_DEBUG_PROCESS;
107 %rename("LOGLEVEL_DEBUG_MODULE") LTTNG_LOGLEVEL_DEBUG_MODULE;
108 %rename("LOGLEVEL_DEBUG_UNIT") LTTNG_LOGLEVEL_DEBUG_UNIT;
109 %rename("LOGLEVEL_DEBUG_FUNCTION") LTTNG_LOGLEVEL_DEBUG_FUNCTION;
110 %rename("LOGLEVEL_DEBUG_LINE") LTTNG_LOGLEVEL_DEBUG_LINE;
111 %rename("LOGLEVEL_DEBUG") LTTNG_LOGLEVEL_DEBUG;
112 enum lttng_loglevel {
113 LTTNG_LOGLEVEL_EMERG = 0,
114 LTTNG_LOGLEVEL_ALERT = 1,
115 LTTNG_LOGLEVEL_CRIT = 2,
116 LTTNG_LOGLEVEL_ERR = 3,
117 LTTNG_LOGLEVEL_WARNING = 4,
118 LTTNG_LOGLEVEL_NOTICE = 5,
119 LTTNG_LOGLEVEL_INFO = 6,
120 LTTNG_LOGLEVEL_DEBUG_SYSTEM = 7,
121 LTTNG_LOGLEVEL_DEBUG_PROGRAM = 8,
122 LTTNG_LOGLEVEL_DEBUG_PROCESS = 9,
123 LTTNG_LOGLEVEL_DEBUG_MODULE = 10,
124 LTTNG_LOGLEVEL_DEBUG_UNIT = 11,
125 LTTNG_LOGLEVEL_DEBUG_FUNCTION = 12,
126 LTTNG_LOGLEVEL_DEBUG_LINE = 13,
127 LTTNG_LOGLEVEL_DEBUG = 14,
128 };
129
130 %rename("EVENT_SPLICE") LTTNG_EVENT_SPLICE;
131 %rename("EVENT_MMAP") LTTNG_EVENT_MMAP;
132 enum lttng_event_output {
133 LTTNG_EVENT_SPLICE = 0,
134 LTTNG_EVENT_MMAP = 1,
135 };
136
137 %rename("EVENT_CONTEXT_PID") LTTNG_EVENT_CONTEXT_PID;
138 %rename("EVENT_CONTEXT_PERF_COUNTER") LTTNG_EVENT_CONTEXT_PERF_COUNTER;
139 %rename("EVENT_CONTEXT_PROCNAME") LTTNG_EVENT_CONTEXT_PROCNAME;
140 %rename("EVENT_CONTEXT_PRIO") LTTNG_EVENT_CONTEXT_PRIO;
141 %rename("EVENT_CONTEXT_NICE") LTTNG_EVENT_CONTEXT_NICE;
142 %rename("EVENT_CONTEXT_VPID") LTTNG_EVENT_CONTEXT_VPID;
143 %rename("EVENT_CONTEXT_TID") LTTNG_EVENT_CONTEXT_TID;
144 %rename("EVENT_CONTEXT_VTID") LTTNG_EVENT_CONTEXT_VTID;
145 %rename("EVENT_CONTEXT_PPID") LTTNG_EVENT_CONTEXT_PPID;
146 %rename("EVENT_CONTEXT_VPPID") LTTNG_EVENT_CONTEXT_VPPID;
147 %rename("EVENT_CONTEXT_PTHREAD_ID") LTTNG_EVENT_CONTEXT_PTHREAD_ID;
148 %rename("EVENT_CONTEXT_HOSTNAME") LTTNG_EVENT_CONTEXT_HOSTNAME;
149 %rename("EVENT_CONTEXT_IP") LTTNG_EVENT_CONTEXT_IP;
150 %rename("EVENT_CONTEXT_PERF_CPU_COUNTER") LTTNG_EVENT_CONTEXT_PERF_CPU_COUNTER;
151 %rename("EVENT_CONTEXT_PERF_THREAD_COUNTER") LTTNG_EVENT_CONTEXT_PERF_THREAD_COUNTER;
152 %rename("EVENT_CONTEXT_APP_CONTEXT") LTTNG_EVENT_CONTEXT_APP_CONTEXT;
153 %rename("EVENT_CONTEXT_INTERRUPTIBLE") LTTNG_EVENT_CONTEXT_INTERRUPTIBLE;
154 %rename("EVENT_CONTEXT_PREEMPTIBLE") LTTNG_EVENT_CONTEXT_PREEMPTIBLE;
155 %rename("EVENT_CONTEXT_NEED_RESCHEDULE") LTTNG_EVENT_CONTEXT_NEED_RESCHEDULE;
156 %rename("EVENT_CONTEXT_MIGRATABLE") LTTNG_EVENT_CONTEXT_MIGRATABLE;
157 %rename("EVENT_CONTEXT_CALLSTACK_KERNEL") LTTNG_EVENT_CONTEXT_CALLSTACK_KERNEL;
158 %rename("EVENT_CONTEXT_CALLSTACK_USER") LTTNG_EVENT_CONTEXT_CALLSTACK_USER;
159 %rename("EVENT_CONTEXT_CGROUP_NS") LTTNG_EVENT_CONTEXT_CGROUP_NS;
160 %rename("EVENT_CONTEXT_IPC_NS") LTTNG_EVENT_CONTEXT_IPC_NS;
161 %rename("EVENT_CONTEXT_MNT_NS") LTTNG_EVENT_CONTEXT_MNT_NS;
162 %rename("EVENT_CONTEXT_NET_NS") LTTNG_EVENT_CONTEXT_NET_NS;
163 %rename("EVENT_CONTEXT_PID_NS") LTTNG_EVENT_CONTEXT_PID_NS;
164 %rename("EVENT_CONTEXT_USER_NS") LTTNG_EVENT_CONTEXT_USER_NS;
165 %rename("EVENT_CONTEXT_UTS_NS") LTTNG_EVENT_CONTEXT_UTS_NS;
166 %rename("EVENT_CONTEXT_UID") LTTNG_EVENT_CONTEXT_UID;
167 %rename("EVENT_CONTEXT_EUID") LTTNG_EVENT_CONTEXT_EUID;
168 %rename("EVENT_CONTEXT_SUID") LTTNG_EVENT_CONTEXT_SUID;
169 %rename("EVENT_CONTEXT_GID") LTTNG_EVENT_CONTEXT_GID;
170 %rename("EVENT_CONTEXT_EGID") LTTNG_EVENT_CONTEXT_EGID;
171 %rename("EVENT_CONTEXT_SGID") LTTNG_EVENT_CONTEXT_SGID;
172 %rename("EVENT_CONTEXT_VUID") LTTNG_EVENT_CONTEXT_VUID;
173 %rename("EVENT_CONTEXT_VEUID") LTTNG_EVENT_CONTEXT_VEUID;
174 %rename("EVENT_CONTEXT_VSUID") LTTNG_EVENT_CONTEXT_VSUID;
175 %rename("EVENT_CONTEXT_VGID") LTTNG_EVENT_CONTEXT_VGID;
176 %rename("EVENT_CONTEXT_VEGID") LTTNG_EVENT_CONTEXT_VEGID;
177 %rename("EVENT_CONTEXT_VSGID") LTTNG_EVENT_CONTEXT_VSGID;
178 %rename("EVENT_CONTEXT_TIME_NS") LTTNG_EVENT_CONTEXT_TIME_NS;
179 %rename("EVENT_CONTEXT_CPU_ID") LTTNG_EVENT_CONTEXT_CPU_ID;
180 enum lttng_event_context_type {
181 LTTNG_EVENT_CONTEXT_PID = 0,
182 LTTNG_EVENT_CONTEXT_PERF_COUNTER = 1,
183 LTTNG_EVENT_CONTEXT_PROCNAME = 2,
184 LTTNG_EVENT_CONTEXT_PRIO = 3,
185 LTTNG_EVENT_CONTEXT_NICE = 4,
186 LTTNG_EVENT_CONTEXT_VPID = 5,
187 LTTNG_EVENT_CONTEXT_TID = 6,
188 LTTNG_EVENT_CONTEXT_VTID = 7,
189 LTTNG_EVENT_CONTEXT_PPID = 8,
190 LTTNG_EVENT_CONTEXT_VPPID = 9,
191 LTTNG_EVENT_CONTEXT_PTHREAD_ID = 10,
192 LTTNG_EVENT_CONTEXT_HOSTNAME = 11,
193 LTTNG_EVENT_CONTEXT_IP = 12,
194 LTTNG_EVENT_CONTEXT_PERF_CPU_COUNTER = 13,
195 LTTNG_EVENT_CONTEXT_PERF_THREAD_COUNTER = 14,
196 LTTNG_EVENT_CONTEXT_APP_CONTEXT = 15,
197 LTTNG_EVENT_CONTEXT_INTERRUPTIBLE = 16,
198 LTTNG_EVENT_CONTEXT_PREEMPTIBLE = 17,
199 LTTNG_EVENT_CONTEXT_NEED_RESCHEDULE = 18,
200 LTTNG_EVENT_CONTEXT_MIGRATABLE = 19,
201 LTTNG_EVENT_CONTEXT_CALLSTACK_KERNEL = 20,
202 LTTNG_EVENT_CONTEXT_CALLSTACK_USER = 21,
203 LTTNG_EVENT_CONTEXT_CGROUP_NS = 22,
204 LTTNG_EVENT_CONTEXT_IPC_NS = 23,
205 LTTNG_EVENT_CONTEXT_MNT_NS = 24,
206 LTTNG_EVENT_CONTEXT_NET_NS = 25,
207 LTTNG_EVENT_CONTEXT_PID_NS = 26,
208 LTTNG_EVENT_CONTEXT_USER_NS = 27,
209 LTTNG_EVENT_CONTEXT_UTS_NS = 28,
210 LTTNG_EVENT_CONTEXT_UID = 29,
211 LTTNG_EVENT_CONTEXT_EUID = 30,
212 LTTNG_EVENT_CONTEXT_SUID = 31,
213 LTTNG_EVENT_CONTEXT_GID = 32,
214 LTTNG_EVENT_CONTEXT_EGID = 33,
215 LTTNG_EVENT_CONTEXT_SGID = 34,
216 LTTNG_EVENT_CONTEXT_VUID = 35,
217 LTTNG_EVENT_CONTEXT_VEUID = 36,
218 LTTNG_EVENT_CONTEXT_VSUID = 37,
219 LTTNG_EVENT_CONTEXT_VGID = 38,
220 LTTNG_EVENT_CONTEXT_VEGID = 39,
221 LTTNG_EVENT_CONTEXT_VSGID = 40,
222 LTTNG_EVENT_CONTEXT_TIME_NS = 41,
223 LTTNG_EVENT_CONTEXT_CPU_ID = 42,
224 };
225
226
227
228
229 // =============================================
230 // TYPEMAPS
231 // =============================================
232
233 //list_sessions
234 %typemap(argout) struct lttng_session **sessions{
235
236 int l = PyInt_AsSsize_t($result);
237 if (l >= 0)
238 {
239 PyObject *sessions = PyList_New(0);
240 int i;
241 for(i=0; i<l; i++)
242 {
243 PyObject *tmp = PyTuple_New(4);
244 PyObject *name = PyString_FromString((*$1)[i].name);
245 PyObject *path = PyString_FromString((*$1)[i].path);
246 PyObject *enabled = PyInt_FromSize_t((*$1)[i].enabled);
247
248 PyTuple_SetItem(tmp, 0, name);
249 PyTuple_SetItem(tmp, 1, path);
250 PyTuple_SetItem(tmp, 2, enabled);
251 PyList_Append(sessions, tmp);
252 }
253 $result = sessions;
254 }
255 }
256 %typemap(in,numinputs=0) struct lttng_session **sessions (struct lttng_session *temp){
257 $1=&temp;
258 }
259
260 //list_domains
261 %typemap(argout) struct lttng_domain **domains{
262
263 int l = PyInt_AsSsize_t($result);
264 if (l >= 0)
265 {
266 PyObject *dom = PyList_New(0);
267 int i;
268 for(i=0; i<l; i++)
269 {
270 PyObject *tmp = PyTuple_New(6);
271 PyObject *type = PyInt_FromSize_t((*$1)[i].type);
272 PyObject *buf_type = PyInt_FromSize_t((*$1)[i].buf_type);
273 PyObject *execname = PyString_FromString((*$1)[i].attr.exec_name);
274 PyObject *pid = PyInt_FromSize_t((*$1)[i].attr.pid);
275 PyObject *padding = PyString_FromString((*$1)[i].padding);
276 PyObject *attrpadding = PyString_FromString((*$1)[i].attr.padding);
277
278 PyTuple_SetItem(tmp, 0, type);
279 PyTuple_SetItem(tmp, 1, buf_type);
280 PyTuple_SetItem(tmp, 2, padding);
281 PyTuple_SetItem(tmp, 3, pid);
282 PyTuple_SetItem(tmp, 4, execname);
283 PyTuple_SetItem(tmp, 5, attrpadding);
284 PyList_Append(dom, tmp);
285 }
286 $result = dom;
287 }
288 }
289 %typemap(in,numinputs=0) struct lttng_domain **domains (struct lttng_domain *temp){
290 $1=&temp;
291 }
292
293 //list_channels
294 %typemap(argout) struct lttng_channel **channels{
295
296 int l = PyInt_AsSsize_t($result);
297 if (l >= 0)
298 {
299 PyObject *chan = PyList_New(0);
300 int i;
301 for(i=0; i<l; i++)
302 {
303 PyObject *tmp = PyTuple_New(4);
304 PyObject *name = PyString_FromString((*$1)[i].name);
305 PyObject *enabled = PyInt_FromSize_t((*$1)[i].enabled);
306 PyObject *padding = PyString_FromString((*$1)[i].padding);
307
308 PyObject *attrtmp = PyTuple_New(7);
309 PyObject *overwrite = PyInt_FromLong((*$1)[i].attr.overwrite);
310 PyObject *subbuf = PyInt_FromSize_t((*$1)[i].attr.subbuf_size);
311 PyObject *num = PyInt_FromSize_t((*$1)[i].attr.num_subbuf);
312 PyObject *switchtimer = PyInt_FromSize_t((*$1)[i].attr.switch_timer_interval);
313 PyObject *readtimer = PyInt_FromSize_t((*$1)[i].attr.read_timer_interval);
314 PyObject *output = PyInt_FromSize_t((*$1)[i].attr.output);
315 PyObject *attrpad = PyString_FromString((*$1)[i].attr.padding);
316
317 PyTuple_SetItem(attrtmp, 0, overwrite);
318 PyTuple_SetItem(attrtmp, 1, subbuf);
319 PyTuple_SetItem(attrtmp, 2, num);
320 PyTuple_SetItem(attrtmp, 3, switchtimer);
321 PyTuple_SetItem(attrtmp, 4, readtimer);
322 PyTuple_SetItem(attrtmp, 5, output);
323 PyTuple_SetItem(attrtmp, 6, attrpad);
324
325 PyTuple_SetItem(tmp, 0, name);
326 PyTuple_SetItem(tmp, 1, enabled);
327 PyTuple_SetItem(tmp, 2, padding);
328 PyTuple_SetItem(tmp, 3, attrtmp);
329 PyList_Append(chan, tmp);
330 }
331 $result = chan;
332 }
333 }
334 %typemap(in,numinputs=0) struct lttng_channel **channels (struct lttng_channel *temp){
335 $1=&temp;
336 }
337
338 //list_events & list_tracepoints
339 %typemap(argout) struct lttng_event **events{
340
341 int l = PyInt_AsSsize_t($result);
342 if (l >= 0)
343 {
344 PyObject *events = PyList_New(0);
345 int i;
346 for(i=0; i<l; i++)
347 {
348 PyObject *tmp = PyTuple_New(10);
349 PyObject *name = PyString_FromString((*$1)[i].name);
350 PyObject *type = PyInt_FromSize_t((*$1)[i].type);
351 PyObject *logleveltype = PyInt_FromSize_t((*$1)[i].loglevel_type);
352 PyObject *loglevel = PyInt_FromLong((*$1)[i].loglevel);
353 PyObject *enabled = PyInt_FromLong((*$1)[i].enabled);
354 PyObject *pid = PyInt_FromSize_t((*$1)[i].pid);
355 PyObject *padding = PyString_FromString((*$1)[i].padding);
356 PyObject *attrpadding = PyString_FromString((*$1)[i].attr.padding);
357
358 PyObject *probe = PyTuple_New(4);
359 PyObject *addr = PyInt_FromSize_t((*$1)[i].attr.probe.addr);
360 PyObject *offset = PyInt_FromSize_t((*$1)[i].attr.probe.offset);
361 PyObject *symbolname = PyString_FromString((*$1)[i].attr.probe.symbol_name);
362 PyObject *probepad = PyString_FromString((*$1)[i].attr.probe.padding);
363
364 PyObject *function = PyTuple_New(2);
365 PyObject *f_symbolname = PyString_FromString((*$1)[i].attr.ftrace.symbol_name);
366 PyObject *f_pad = PyString_FromString((*$1)[i].attr.ftrace.padding);
367
368 PyTuple_SetItem(function, 0, f_symbolname);
369 PyTuple_SetItem(function, 1, f_pad);
370
371 PyTuple_SetItem(probe, 0, addr);
372 PyTuple_SetItem(probe, 1, offset);
373 PyTuple_SetItem(probe, 2, symbolname);
374 PyTuple_SetItem(probe, 3, probepad);
375
376 PyTuple_SetItem(tmp, 0, name);
377 PyTuple_SetItem(tmp, 1, type);
378 PyTuple_SetItem(tmp, 2, logleveltype);
379 PyTuple_SetItem(tmp, 3, loglevel);
380 PyTuple_SetItem(tmp, 4, enabled);
381 PyTuple_SetItem(tmp, 5, pid);
382 PyTuple_SetItem(tmp, 6, padding);
383 PyTuple_SetItem(tmp, 7, probe);
384 PyTuple_SetItem(tmp, 8, function);
385 PyTuple_SetItem(tmp, 9, attrpadding);
386 PyList_Append(events, tmp);
387 }
388 $result = events;
389 }
390 }
391 %typemap(in,numinputs=0) struct lttng_event **events (struct lttng_event *temp){
392 $1=&temp;
393 }
394
395
396
397 // =============================================
398 // FUNCTIONS
399 // =============================================
400
401 %rename("create") lttng_create_session(const char *name, const char *path);
402 %rename("create_snapshot") lttng_create_session_snapshot(const char *name, const char *snapshot_url);
403 %rename("destroy") lttng_destroy_session(const char *name);
404 %rename("_lttng_create_handle") lttng_create_handle(const char *session_name, struct lttng_domain *domain);
405 %rename("_lttng_destroy_handle") lttng_destroy_handle(struct lttng_handle *handle);
406 %rename("_lttng_list_sessions") lttng_list_sessions(struct lttng_session **sessions);
407 %rename("_lttng_list_domains") lttng_list_domains(const char *session_name, struct lttng_domain **domains);
408 %rename("_lttng_list_channels") lttng_list_channels(struct lttng_handle *handle,struct lttng_channel **channels);
409 %rename("_lttng_list_events") lttng_list_events(struct lttng_handle *handle, const char *channel_name, struct lttng_event **events);
410 %rename("_lttng_list_tracepoints") lttng_list_tracepoints(struct lttng_handle *handle, struct lttng_event **events);
411 %rename("session_daemon_alive") lttng_session_daemon_alive(void);
412 %rename("set_tracing_group") lttng_set_tracing_group(const char *name);
413 %rename("strerror") lttng_strerror(int code);
414 %rename("_lttng_register_consumer") lttng_register_consumer(struct lttng_handle *handle, const char *socket_path);
415 %rename("start") lttng_start_tracing(const char *session_name);
416 %rename("stop") lttng_stop_tracing(const char *session_name);
417 %rename("_lttng_add_context") lttng_add_context(struct lttng_handle *handle, struct lttng_event_context *ctx, const char *event_name, const char *channel_name);
418 %rename("_lttng_enable_event") lttng_enable_event(struct lttng_handle *handle, struct lttng_event *ev, const char *channel_name);
419 %rename("_lttng_enable_channel") lttng_enable_channel(struct lttng_handle *handle, struct lttng_channel *chan);
420 %rename("_lttng_disable_event") lttng_disable_event(struct lttng_handle *handle, const char *name, const char *channel_name);
421 %rename("_lttng_disable_channel") lttng_disable_channel(struct lttng_handle *handle, const char *name);
422 %rename("channel_set_default_attr") lttng_channel_set_default_attr(struct lttng_domain *domain, struct lttng_channel_attr *attr);
423
424 //Redefined functions
425 struct lttng_handle *lttng_create_handle(const char *session_name,
426 struct lttng_domain *domain);
427 void lttng_destroy_handle(struct lttng_handle *handle);
428 int lttng_list_channels(struct lttng_handle *handle,struct lttng_channel **channels);
429 int lttng_list_events(struct lttng_handle *handle,
430 const char *channel_name, struct lttng_event **events);
431 int lttng_list_tracepoints(struct lttng_handle *handle, struct lttng_event **events);
432 int lttng_add_context(struct lttng_handle *handle, struct lttng_event_context *ctx,
433 const char *event_name, const char *channel_name);
434 int lttng_enable_event(struct lttng_handle *handle,
435 struct lttng_event *ev, const char *channel_name);
436 int lttng_enable_channel(struct lttng_handle *handle, struct lttng_channel *chan);
437 int lttng_disable_event(struct lttng_handle *handle,
438 const char *name, const char *channel_name);
439 int lttng_disable_channel(struct lttng_handle *handle, const char *name);
440 int lttng_register_consumer(struct lttng_handle *handle, const char *socket_path);
441 int lttng_list_sessions(struct lttng_session **sessions);
442 int lttng_list_domains(const char *session_name, struct lttng_domain **domains);
443
444 //Functions not needing redefinition
445 %feature("docstring")"create(str name, str path) -> int
446
447 Create a new recording session using name and path.
448 Returns 0 on success or a negative error code."
449 int lttng_create_session(const char *name, const char *path);
450
451 %feature("docstring")"create_snapshot(str name, str snapshot_url) -> int
452
453 Create a new recording session using name and snapshot_url in snapshot
454 mode (flight recorder).
455 Returns 0 on success or a negative error code."
456 int lttng_create_session_snapshot(const char *name, const char *path);
457
458 %feature("docstring")"destroy(str name) -> int
459
460 Tear down recording session using name.
461 Returns 0 on success or a negative error code."
462 int lttng_destroy_session(const char *name);
463
464
465 %feature("docstring")"session_daemon_alive() -> int
466
467 Check if session daemon is alive.
468 Return 1 if alive or 0 if not.
469 On error returns a negative value."
470 int lttng_session_daemon_alive(void);
471
472
473 %feature("docstring")"set_tracing_group(str name) -> int
474
475 Sets the tracing_group variable with name.
476 This function allocates memory pointed to by tracing_group.
477 On success, returns 0, on error, returns -1 (null name) or -ENOMEM."
478 int lttng_set_tracing_group(const char *name);
479
480
481 %feature("docstring")"strerror(int code) -> char
482
483 Returns a human readable string describing
484 the error code (a negative value)."
485 const char *lttng_strerror(int code);
486
487
488 %feature("docstring")"start(str session_name) -> int
489
490 Start tracing for all traces of the session.
491 Returns size of returned session payload data or a negative error code."
492 int lttng_start_tracing(const char *session_name);
493
494
495 %feature("docstring")"stop(str session_name) -> int
496
497 Stop tracing for all traces of the session.
498 Returns size of returned session payload data or a negative error code."
499 int lttng_stop_tracing(const char *session_name);
500
501
502 %feature("docstring")"channel_set_default_attr(Domain domain, ChannelAttr attr)
503
504 Set default channel attributes.
505 If either or both of the arguments are null, attr content is zeroe'd."
506 void lttng_channel_set_default_attr(struct lttng_domain *domain, struct lttng_channel_attr *attr);
507
508
509 // =============================================
510 // Python redefinition of some functions
511 // (List and Handle-related)
512 // =============================================
513
514 %feature("docstring")""
515 %pythoncode %{
516
517 def list_sessions():
518 """
519 list_sessions() -> dict
520
521 Ask the session daemon for all available sessions.
522 Returns a dict of Session instances, the key is the name;
523 on error, returns a negative value.
524 """
525
526 ses_list = _lttng_list_sessions()
527 if type(ses_list) is int:
528 return ses_list
529
530 sessions = {}
531
532 for ses_elements in ses_list:
533 ses = Session()
534 ses.name = ses_elements[0]
535 ses.path = ses_elements[1]
536 ses.enabled = ses_elements[2]
537 ses.padding = ses_elements[3]
538
539 sessions[ses.name] = ses
540
541 return sessions
542
543
544 def list_domains(session_name):
545 """
546 list_domains(str session_name) -> list
547
548 Ask the session daemon for all available domains of a session.
549 Returns a list of Domain instances;
550 on error, returns a negative value.
551 """
552
553 dom_list = _lttng_list_domains(session_name)
554 if type(dom_list) is int:
555 return dom_list
556
557 domains = []
558
559 for dom_elements in dom_list:
560 dom = Domain()
561 dom.type = dom_elements[0]
562 dom.buf_type = dom_elements[1]
563 dom.paddinf = dom_elements[2]
564 dom.attr.pid = dom_elements[3]
565 dom.attr.exec_name = dom_elements[4]
566 dom.attr.padding = dom_elements[5]
567
568 domains.append(dom)
569
570 return domains
571
572
573 def list_channels(handle):
574 """
575 list_channels(Handle handle) -> dict
576
577 Ask the session daemon for all available channels of a session.
578 Returns a dict of Channel instances, the key is the name;
579 on error, returns a negative value.
580 """
581
582 try:
583 chan_list = _lttng_list_channels(handle._h)
584 except AttributeError:
585 raise TypeError("in method 'list_channels', argument 1 must be a Handle instance")
586
587 if type(chan_list) is int:
588 return chan_list
589
590 channels = {}
591
592 for channel_elements in chan_list:
593 chan = Channel()
594 chan.name = channel_elements[0]
595 chan.enabled = channel_elements[1]
596 chan.padding = channel_elements[2]
597 chan.attr.overwrite = channel_elements[3][0]
598 chan.attr.subbuf_size = channel_elements[3][1]
599 chan.attr.num_subbuf = channel_elements[3][2]
600 chan.attr.switch_timer_interval = channel_elements[3][3]
601 chan.attr.read_timer_interval = channel_elements[3][4]
602 chan.attr.output = channel_elements[3][5]
603 chan.attr.padding = channel_elements[3][6]
604
605 channels[chan.name] = chan
606
607 return channels
608
609
610 def list_events(handle, channel_name):
611 """
612 list_events(Handle handle, str channel_name) -> dict
613
614 Ask the session daemon for all available events of a session channel.
615 Returns a dict of Event instances, the key is the name;
616 on error, returns a negative value.
617 """
618
619 try:
620 ev_list = _lttng_list_events(handle._h, channel_name)
621 except AttributeError:
622 raise TypeError("in method 'list_events', argument 1 must be a Handle instance")
623
624 if type(ev_list) is int:
625 return ev_list
626
627 events = {}
628
629 for ev_elements in ev_list:
630 ev = Event()
631 ev.name = ev_elements[0]
632 ev.type = ev_elements[1]
633 ev.loglevel_type = ev_elements[2]
634 ev.loglevel = ev_elements[3]
635 ev.enabled = ev_elements[4]
636 ev.pid = ev_elements[5]
637 ev.attr.padding = ev_elements[6]
638 ev.attr.probe.addr = ev_elements[7][0]
639 ev.attr.probe.offset = ev_elements[7][1]
640 ev.attr.probe.symbol_name = ev_elements[7][2]
641 ev.attr.probe.padding = ev_elements[7][3]
642 ev.attr.ftrace.symbol_name = ev_elements[8][0]
643 ev.attr.ftrace.padding = ev_elements[8][1]
644 ev.attr.padding = ev_elements[9]
645
646 events[ev.name] = ev
647
648 return events
649
650
651 def list_tracepoints(handle):
652 """
653 list_tracepoints(Handle handle) -> dict
654
655 Returns a dict of Event instances, the key is the name;
656 on error, returns a negative value.
657 """
658
659 try:
660 ev_list = _lttng_list_tracepoints(handle._h)
661 except AttributeError:
662 raise TypeError("in method 'list_tracepoints', argument 1 must be a Handle instance")
663
664 if type(ev_list) is int:
665 return ev_list
666
667 events = {}
668
669 for ev_elements in ev_list:
670 ev = Event()
671 ev.name = ev_elements[0]
672 ev.type = ev_elements[1]
673 ev.loglevel_type = ev_elements[2]
674 ev.loglevel = ev_elements[3]
675 ev.enabled = ev_elements[4]
676 ev.pid = ev_elements[5]
677 ev.attr.padding = ev_elements[6]
678 ev.attr.probe.addr = ev_elements[7][0]
679 ev.attr.probe.offset = ev_elements[7][1]
680 ev.attr.probe.symbol_name = ev_elements[7][2]
681 ev.attr.probe.padding = ev_elements[7][3]
682 ev.attr.ftrace.symbol_name = ev_elements[8][0]
683 ev.attr.ftrace.padding = ev_elements[8][1]
684 ev.attr.padding = ev_elements[9]
685
686 events[ev.name] = ev
687
688 return events
689
690
691 def register_consumer(handle, socket_path):
692 """
693 register_consumer(Handle handle, str socket_path) -> int
694
695 Register an outside consumer.
696 Returns size of returned session payload data or a negative error code.
697 """
698
699 try:
700 return _lttng_register_consumer(handle._h, socket_path)
701 except AttributeError:
702 raise TypeError("in method 'register_consumer', argument 1 must be a Handle instance")
703
704
705 def add_context(handle, event_context, event_name, channel_name):
706 """
707 add_context(Handle handle, EventContext ctx,
708 str event_name, str channel_name) -> int
709
710 Add context to event and/or channel.
711 If event_name is None, the context is applied to all events of the channel.
712 If channel_name is None, a lookup of the event's channel is done.
713 If both are None, the context is applied to all events of all channels.
714 Returns the size of the returned payload data or a negative error code.
715 """
716
717 try:
718 return _lttng_add_context(handle._h, event_context, event_name, channel_name)
719 except AttributeError:
720 raise TypeError("in method 'add_context', argument 1 must be a Handle instance")
721
722
723 def enable_event(handle, event, channel_name):
724 """
725 enable_event(Handle handle, Event event,
726 str channel_name) -> int
727
728 Enable event(s) for a channel.
729 If no event name is specified, all events are enabled.
730 If no channel name is specified, the default 'channel0' is used.
731 Returns size of returned session payload data or a negative error code.
732 """
733
734 try:
735 return _lttng_enable_event(handle._h, event, channel_name)
736 except AttributeError:
737 raise TypeError("in method 'enable_event', argument 1 must be a Handle instance")
738
739
740 def enable_channel(handle, channel):
741 """
742 enable_channel(Handle handle, Channel channel -> int
743
744 Enable channel per domain
745 Returns size of returned session payload data or a negative error code.
746 """
747
748 try:
749 return _lttng_enable_channel(handle._h, channel)
750 except AttributeError:
751 raise TypeError("in method 'enable_channel', argument 1 must be a Handle instance")
752
753
754 def disable_event(handle, name, channel_name):
755 """
756 disable_event(Handle handle, str name, str channel_name) -> int
757
758 Disable event(s) of a channel and domain.
759 If no event name is specified, all events are disabled.
760 If no channel name is specified, the default 'channel0' is used.
761 Returns size of returned session payload data or a negative error code
762 """
763
764 try:
765 return _lttng_disable_event(handle._h, name, channel_name)
766 except AttributeError:
767 raise TypeError("in method 'disable_event', argument 1 must be a Handle instance")
768
769
770 def disable_channel(handle, name):
771 """
772 disable_channel(Handle handle, str name) -> int
773
774 All tracing will be stopped for registered events of the channel.
775 Returns size of returned session payload data or a negative error code.
776 """
777
778 try:
779 return _lttng_disable_channel(handle._h, name)
780 except AttributeError:
781 raise TypeError("in method 'disable_channel', argument 1 must be a Handle instance")
782 %}
783
784
785 // =============================================
786 // Handle class
787 // Used to prevent freeing unallocated memory
788 // =============================================
789
790 %feature("docstring")""
791 %feature("autodoc", "1");
792
793 %pythoncode %{
794 class Handle:
795 """
796 Manages a handle.
797 Takes two arguments: (str session_name, Domain domain)
798 """
799
800 __frozen = False
801
802 def __init__(self, session_name, domain):
803 if type(session_name) is not str:
804 raise TypeError("in method '__init__', argument 2 of type 'str'")
805 if type(domain) is not Domain and domain is not None:
806 raise TypeError("in method '__init__', argument 3 of type 'lttng.Domain'")
807
808 self._sname = session_name
809 if domain is None:
810 self._domtype = None
811 else:
812 self._domtype = domain.type
813 self._h = _lttng_create_handle(session_name, domain)
814 self.__frozen = True
815
816 def __del__(self):
817 _lttng_destroy_handle(self._h)
818
819 def __repr__(self):
820 if self._domtype == 1:
821 domstr = "DOMAIN_KERNEL"
822 elif self._domtype == 2:
823 domstr = "DOMAIN_UST"
824 else:
825 domstr = self._domtype
826
827 return "lttng.Handle; session('{}'), domain.type({})".format(
828 self._sname, domstr)
829
830 def __setattr__(self, attr, val):
831 if self.__frozen:
832 raise NotImplementedError("cannot modify attributes")
833 else:
834 self.__dict__[attr] = val
835 %}
836
837
838 // =============================================
839 // STRUCTURES
840 // These are directly taken from lttng.h.
841 // Any change to these structures must also be
842 // made here.
843 // =============================================
844
845 %rename("Domain") lttng_domain;
846 %rename("EventContext") lttng_event_context;
847 %rename("Event") lttng_event;
848 %rename("ChannelAttr") lttng_channel_attr;
849 %rename("Channel") lttng_channel;
850 %rename("Session") lttng_session;
851
852 struct lttng_domain{
853 enum lttng_domain_type type;
854 enum lttng_buffer_type buf_type;
855 char padding[LTTNG_DOMAIN_PADDING1];
856
857 union {
858 pid_t pid;
859 char exec_name[NAME_MAX];
860 char padding[LTTNG_DOMAIN_PADDING2];
861 } attr;
862
863 %extend {
864 char *__repr__() {
865 static char temp[256];
866 static char domain_type[25];
867 static char buffer_type[25];
868 switch ( $self->type ) {
869 case 1:
870 sprintf(domain_type, "type(DOMAIN_KERNEL)");
871 break;
872 case 2:
873 sprintf(domain_type, "type(DOMAIN_UST)");
874 break;
875 default:
876 sprintf(domain_type, "type(%i)", $self->type);
877 break;
878 }
879
880 switch ( $self->buf_type ) {
881 case LTTNG_BUFFER_PER_UID:
882 sprintf(buffer_type, "buf_type(BUFFER_PER_UID)");
883 break;
884 case LTTNG_BUFFER_PER_PID:
885 sprintf(buffer_type, "buf_type(BUFFER_PER_PID)");
886 break;
887 case LTTNG_BUFFER_GLOBAL:
888 sprintf(buffer_type, "buf_type(BUFFER_GLOBAL)");
889 break;
890 default:
891 sprintf(buffer_type, "buf_type(%i)", $self->buf_type);
892 break;
893 }
894
895 sprintf(temp, "lttng.Domain; %s, %s",
896 domain_type,
897 buffer_type
898 );
899 return &temp[0];
900 }
901 }
902 };
903
904 struct lttng_event_context {
905 enum lttng_event_context_type ctx;
906 char padding[LTTNG_EVENT_CONTEXT_PADDING1];
907
908 union {
909 struct lttng_event_perf_counter_ctx perf_counter;
910 char padding[LTTNG_EVENT_CONTEXT_PADDING2];
911 } u;
912
913 %extend {
914 char *__repr__() {
915 static char temp[256];
916 switch ( $self->ctx ) {
917 case 0:
918 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_PID)");
919 break;
920 case 1:
921 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_PERF_COUNTER)");
922 break;
923 case 2:
924 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_PROCNAME)");
925 break;
926 case 3:
927 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_PRIO)");
928 break;
929 case 4:
930 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_NICE)");
931 break;
932 case 5:
933 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_VPID)");
934 break;
935 case 6:
936 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_TID)");
937 break;
938 case 7:
939 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_VTID)");
940 break;
941 case 8:
942 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_PPID)");
943 break;
944 case 9:
945 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_VPPID)");
946 break;
947 case 10:
948 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_PTHREAD_ID)");
949 break;
950 case 11:
951 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_HOSTNAME)");
952 break;
953 case 12:
954 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_IP)");
955 break;
956 case 13:
957 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_PERF_CPU_COUNTER)");
958 break;
959 case 14:
960 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_PERF_THREAD_COUNTER)");
961 break;
962 case 15:
963 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_APP_CONTEXT)");
964 break;
965 case 16:
966 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_INTERRUPTIBLE)");
967 break;
968 case 17:
969 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_PREEMPTIBLE)");
970 break;
971 case 18:
972 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_NEED_RESCHEDULE)");
973 break;
974 case 19:
975 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_MIGRATABLE)");
976 break;
977 case 20:
978 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_CALLSTACK_KERNEL)");
979 break;
980 case 21:
981 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_CALLSTACK_USER)");
982 break;
983 case 22:
984 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_CGROUP_NS)");
985 break;
986 case 23:
987 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_IPC_NS)");
988 break;
989 case 24:
990 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_MNT_NS)");
991 break;
992 case 25:
993 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_NET_NS)");
994 break;
995 case 26:
996 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_PID_NS)");
997 break;
998 case 27:
999 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_USER_NS)");
1000 break;
1001 case 28:
1002 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_UTS_NS)");
1003 break;
1004 case 29:
1005 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_UID)");
1006 break;
1007 case 30:
1008 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_EUID)");
1009 break;
1010 case 31:
1011 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_SUID)");
1012 break;
1013 case 32:
1014 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_GID)");
1015 break;
1016 case 33:
1017 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_EGID)");
1018 break;
1019 case 34:
1020 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_SGID)");
1021 break;
1022 case 35:
1023 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_VUID)");
1024 break;
1025 case 36:
1026 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_VEUID)");
1027 break;
1028 case 37:
1029 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_VSUID)");
1030 break;
1031 case 38:
1032 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_VGID)");
1033 break;
1034 case 39:
1035 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_VEGID)");
1036 break;
1037 case 40:
1038 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_VSGID)");
1039 break;
1040 case 41:
1041 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_TIME_NS)");
1042 break;
1043 case 42:
1044 sprintf(temp, "lttng.EventContext; ctx(EVENT_CONTEXT_CPU_ID)");
1045 break;
1046 default:
1047 sprintf(temp, "lttng.EventContext; type(%i)", $self->ctx);
1048 break;
1049 }
1050 return &temp[0];
1051 }
1052 }
1053 };
1054
1055 struct lttng_event_probe_attr {
1056 uint64_t addr;
1057 uint64_t offset;
1058 char symbol_name[LTTNG_SYMBOL_NAME_LEN];
1059 char padding[LTTNG_EVENT_PROBE_PADDING1];
1060 };
1061
1062 struct lttng_event_function_attr {
1063 char symbol_name[LTTNG_SYMBOL_NAME_LEN];
1064 char padding[LTTNG_EVENT_FUNCTION_PADDING1];
1065 };
1066
1067 struct lttng_event {
1068 enum lttng_event_type type;
1069 char name[LTTNG_SYMBOL_NAME_LEN];
1070
1071 enum lttng_loglevel_type loglevel_type;
1072 int loglevel;
1073
1074 int32_t enabled;
1075 pid_t pid;
1076
1077 char padding[LTTNG_EVENT_PADDING1];
1078
1079 union {
1080 struct lttng_event_probe_attr probe;
1081 struct lttng_event_function_attr ftrace;
1082
1083 char padding[LTTNG_EVENT_PADDING2];
1084 } attr;
1085
1086 %extend {
1087 char *__repr__() {
1088 static char temp[512];
1089 char evtype[50];
1090 char logtype[50];
1091
1092 switch ( $self->type ) {
1093 case -1:
1094 sprintf(evtype, "EVENT_ALL");
1095 break;
1096 case 0:
1097 sprintf(evtype, "EVENT_TRACEPOINT");
1098 break;
1099 case 1:
1100 sprintf(evtype, "EVENT_PROBE");
1101 break;
1102 case 2:
1103 sprintf(evtype, "EVENT_FUNCTION");
1104 break;
1105 case 3:
1106 sprintf(evtype, "EVENT_FUNCTION_ENTRY");
1107 break;
1108 case 4:
1109 sprintf(evtype, "EVENT_NOOP");
1110 break;
1111 case 5:
1112 sprintf(evtype, "EVENT_SYSCALL");
1113 break;
1114 default:
1115 sprintf(evtype, "%i", $self->type);
1116 break;
1117 }
1118
1119 switch ( $self->loglevel_type ) {
1120 case 0:
1121 sprintf(logtype, "EVENT_LOGLEVEL_ALL");
1122 break;
1123 case 1:
1124 sprintf(logtype, "EVENT_LOGLEVEL_RANGE");
1125 break;
1126 case 2:
1127 sprintf(logtype, "EVENT_LOGLEVEL_SINGLE");
1128 break;
1129 default:
1130 sprintf(logtype, "%i", $self->loglevel_type);
1131 break;
1132 }
1133
1134 sprintf(temp, "lttng.Event; name('%s'), type(%s), "
1135 "loglevel_type(%s), loglevel(%i), "
1136 "enabled(%s), pid(%i)",
1137 $self->name, evtype, logtype, $self->loglevel,
1138 $self->enabled ? "True" : "False", $self->pid);
1139 return &temp[0];
1140 }
1141 }
1142 };
1143
1144 struct lttng_channel_attr {
1145 int overwrite;
1146 uint64_t subbuf_size;
1147 uint64_t num_subbuf;
1148 unsigned int switch_timer_interval;
1149 unsigned int read_timer_interval;
1150 enum lttng_event_output output;
1151
1152 char padding[LTTNG_CHANNEL_ATTR_PADDING1];
1153
1154 %extend {
1155 char *__repr__() {
1156 static char temp[256];
1157 char evout[25];
1158
1159 switch ( $self->output ) {
1160 case 0:
1161 sprintf(evout, "EVENT_SPLICE");
1162 break;
1163 case 1:
1164 sprintf(evout, "EVENT_MMAP");
1165 break;
1166 default:
1167 sprintf(evout, "%i", $self->output);
1168 break;
1169 }
1170 sprintf(temp, "lttng.ChannelAttr; overwrite(%i), subbuf_size(%"PRIu64"), "
1171 "num_subbuf(%"PRIu64"), switch_timer_interval(%u), "
1172 "read_timer_interval(%u), output(%s)",
1173 $self->overwrite, $self->subbuf_size, $self->num_subbuf,
1174 $self->switch_timer_interval, $self->read_timer_interval,
1175 evout);
1176 return &temp[0];
1177 }
1178 }
1179 };
1180
1181 struct lttng_channel {
1182 char name[LTTNG_SYMBOL_NAME_LEN];
1183 uint32_t enabled;
1184 struct lttng_channel_attr attr;
1185 char padding[LTTNG_CHANNEL_PADDING1];
1186
1187 %extend {
1188 char *__repr__() {
1189 static char temp[512];
1190 snprintf(temp, sizeof(temp), "lttng.Channel; name('%s'), enabled(%s)",
1191 $self->name, $self->enabled ? "True" : "False");
1192 return &temp[0];
1193 }
1194 }
1195 };
1196
1197 struct lttng_session {
1198 char name[NAME_MAX];
1199 char path[PATH_MAX];
1200 uint32_t enabled;
1201 uint32_t snapshot_mode;
1202 unsigned int live_timer_interval;
1203 union {
1204 char padding[LTTNG_SESSION_PADDING1];
1205 void *ptr;
1206 } extended;
1207
1208 %extend {
1209 char *__repr__() {
1210 static char temp[PATH_MAX + NAME_MAX + 512];
1211 snprintf(temp, sizeof(temp), "lttng.Session; name('%s'), path('%s'), enabled(%s)",
1212 $self->name, $self->path,
1213 $self->enabled ? "True" : "False");
1214 return &temp[0];
1215 }
1216 }
1217 };