1 /*
2  * trace-event-python.  Feed trace events to an embedded Python interpreter.
3  *
4  * Copyright (C) 2010 Tom Zanussi <tzanussi@gmail.com>
5  *
6  *  This program is free software; you can redistribute it and/or modify
7  *  it under the terms of the GNU General Public License as published by
8  *  the Free Software Foundation; either version 2 of the License, or
9  *  (at your option) any later version.
10  *
11  *  This program is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *  GNU General Public License for more details.
15  *
16  *  You should have received a copy of the GNU General Public License
17  *  along with this program; if not, write to the Free Software
18  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19  *
20  */
21 
22 #include <Python.h>
23 
24 #include <stdio.h>
25 #include <stdlib.h>
26 #include <string.h>
27 #include <stdbool.h>
28 #include <errno.h>
29 #include <linux/bitmap.h>
30 
31 #include "../../perf.h"
32 #include "../debug.h"
33 #include "../callchain.h"
34 #include "../evsel.h"
35 #include "../util.h"
36 #include "../event.h"
37 #include "../thread.h"
38 #include "../comm.h"
39 #include "../machine.h"
40 #include "../db-export.h"
41 #include "../thread-stack.h"
42 #include "../trace-event.h"
43 #include "../machine.h"
44 
45 PyMODINIT_FUNC initperf_trace_context(void);
46 
47 #define FTRACE_MAX_EVENT				\
48 	((1 << (sizeof(unsigned short) * 8)) - 1)
49 
50 static DECLARE_BITMAP(events_defined, FTRACE_MAX_EVENT);
51 
52 #define MAX_FIELDS	64
53 #define N_COMMON_FIELDS	7
54 
55 extern struct scripting_context *scripting_context;
56 
57 static char *cur_field_name;
58 static int zero_flag_atom;
59 
60 static PyObject *main_module, *main_dict;
61 
62 struct tables {
63 	struct db_export	dbe;
64 	PyObject		*evsel_handler;
65 	PyObject		*machine_handler;
66 	PyObject		*thread_handler;
67 	PyObject		*comm_handler;
68 	PyObject		*comm_thread_handler;
69 	PyObject		*dso_handler;
70 	PyObject		*symbol_handler;
71 	PyObject		*branch_type_handler;
72 	PyObject		*sample_handler;
73 	PyObject		*call_path_handler;
74 	PyObject		*call_return_handler;
75 	bool			db_export_mode;
76 };
77 
78 static struct tables tables_global;
79 
80 static void handler_call_die(const char *handler_name) NORETURN;
81 static void handler_call_die(const char *handler_name)
82 {
83 	PyErr_Print();
84 	Py_FatalError("problem in Python trace event handler");
85 	// Py_FatalError does not return
86 	// but we have to make the compiler happy
87 	abort();
88 }
89 
90 /*
91  * Insert val into into the dictionary and decrement the reference counter.
92  * This is necessary for dictionaries since PyDict_SetItemString() does not
93  * steal a reference, as opposed to PyTuple_SetItem().
94  */
95 static void pydict_set_item_string_decref(PyObject *dict, const char *key, PyObject *val)
96 {
97 	PyDict_SetItemString(dict, key, val);
98 	Py_DECREF(val);
99 }
100 
101 static PyObject *get_handler(const char *handler_name)
102 {
103 	PyObject *handler;
104 
105 	handler = PyDict_GetItemString(main_dict, handler_name);
106 	if (handler && !PyCallable_Check(handler))
107 		return NULL;
108 	return handler;
109 }
110 
111 static void call_object(PyObject *handler, PyObject *args, const char *die_msg)
112 {
113 	PyObject *retval;
114 
115 	retval = PyObject_CallObject(handler, args);
116 	if (retval == NULL)
117 		handler_call_die(die_msg);
118 	Py_DECREF(retval);
119 }
120 
121 static void try_call_object(const char *handler_name, PyObject *args)
122 {
123 	PyObject *handler;
124 
125 	handler = get_handler(handler_name);
126 	if (handler)
127 		call_object(handler, args, handler_name);
128 }
129 
130 static void define_value(enum print_arg_type field_type,
131 			 const char *ev_name,
132 			 const char *field_name,
133 			 const char *field_value,
134 			 const char *field_str)
135 {
136 	const char *handler_name = "define_flag_value";
137 	PyObject *t;
138 	unsigned long long value;
139 	unsigned n = 0;
140 
141 	if (field_type == PRINT_SYMBOL)
142 		handler_name = "define_symbolic_value";
143 
144 	t = PyTuple_New(4);
145 	if (!t)
146 		Py_FatalError("couldn't create Python tuple");
147 
148 	value = eval_flag(field_value);
149 
150 	PyTuple_SetItem(t, n++, PyString_FromString(ev_name));
151 	PyTuple_SetItem(t, n++, PyString_FromString(field_name));
152 	PyTuple_SetItem(t, n++, PyInt_FromLong(value));
153 	PyTuple_SetItem(t, n++, PyString_FromString(field_str));
154 
155 	try_call_object(handler_name, t);
156 
157 	Py_DECREF(t);
158 }
159 
160 static void define_values(enum print_arg_type field_type,
161 			  struct print_flag_sym *field,
162 			  const char *ev_name,
163 			  const char *field_name)
164 {
165 	define_value(field_type, ev_name, field_name, field->value,
166 		     field->str);
167 
168 	if (field->next)
169 		define_values(field_type, field->next, ev_name, field_name);
170 }
171 
172 static void define_field(enum print_arg_type field_type,
173 			 const char *ev_name,
174 			 const char *field_name,
175 			 const char *delim)
176 {
177 	const char *handler_name = "define_flag_field";
178 	PyObject *t;
179 	unsigned n = 0;
180 
181 	if (field_type == PRINT_SYMBOL)
182 		handler_name = "define_symbolic_field";
183 
184 	if (field_type == PRINT_FLAGS)
185 		t = PyTuple_New(3);
186 	else
187 		t = PyTuple_New(2);
188 	if (!t)
189 		Py_FatalError("couldn't create Python tuple");
190 
191 	PyTuple_SetItem(t, n++, PyString_FromString(ev_name));
192 	PyTuple_SetItem(t, n++, PyString_FromString(field_name));
193 	if (field_type == PRINT_FLAGS)
194 		PyTuple_SetItem(t, n++, PyString_FromString(delim));
195 
196 	try_call_object(handler_name, t);
197 
198 	Py_DECREF(t);
199 }
200 
201 static void define_event_symbols(struct event_format *event,
202 				 const char *ev_name,
203 				 struct print_arg *args)
204 {
205 	switch (args->type) {
206 	case PRINT_NULL:
207 		break;
208 	case PRINT_ATOM:
209 		define_value(PRINT_FLAGS, ev_name, cur_field_name, "0",
210 			     args->atom.atom);
211 		zero_flag_atom = 0;
212 		break;
213 	case PRINT_FIELD:
214 		free(cur_field_name);
215 		cur_field_name = strdup(args->field.name);
216 		break;
217 	case PRINT_FLAGS:
218 		define_event_symbols(event, ev_name, args->flags.field);
219 		define_field(PRINT_FLAGS, ev_name, cur_field_name,
220 			     args->flags.delim);
221 		define_values(PRINT_FLAGS, args->flags.flags, ev_name,
222 			      cur_field_name);
223 		break;
224 	case PRINT_SYMBOL:
225 		define_event_symbols(event, ev_name, args->symbol.field);
226 		define_field(PRINT_SYMBOL, ev_name, cur_field_name, NULL);
227 		define_values(PRINT_SYMBOL, args->symbol.symbols, ev_name,
228 			      cur_field_name);
229 		break;
230 	case PRINT_HEX:
231 		define_event_symbols(event, ev_name, args->hex.field);
232 		define_event_symbols(event, ev_name, args->hex.size);
233 		break;
234 	case PRINT_INT_ARRAY:
235 		define_event_symbols(event, ev_name, args->int_array.field);
236 		define_event_symbols(event, ev_name, args->int_array.count);
237 		define_event_symbols(event, ev_name, args->int_array.el_size);
238 		break;
239 	case PRINT_STRING:
240 		break;
241 	case PRINT_TYPE:
242 		define_event_symbols(event, ev_name, args->typecast.item);
243 		break;
244 	case PRINT_OP:
245 		if (strcmp(args->op.op, ":") == 0)
246 			zero_flag_atom = 1;
247 		define_event_symbols(event, ev_name, args->op.left);
248 		define_event_symbols(event, ev_name, args->op.right);
249 		break;
250 	default:
251 		/* gcc warns for these? */
252 	case PRINT_BSTRING:
253 	case PRINT_DYNAMIC_ARRAY:
254 	case PRINT_FUNC:
255 	case PRINT_BITMASK:
256 		/* we should warn... */
257 		return;
258 	}
259 
260 	if (args->next)
261 		define_event_symbols(event, ev_name, args->next);
262 }
263 
264 static PyObject *get_field_numeric_entry(struct event_format *event,
265 		struct format_field *field, void *data)
266 {
267 	bool is_array = field->flags & FIELD_IS_ARRAY;
268 	PyObject *obj, *list = NULL;
269 	unsigned long long val;
270 	unsigned int item_size, n_items, i;
271 
272 	if (is_array) {
273 		list = PyList_New(field->arraylen);
274 		item_size = field->size / field->arraylen;
275 		n_items = field->arraylen;
276 	} else {
277 		item_size = field->size;
278 		n_items = 1;
279 	}
280 
281 	for (i = 0; i < n_items; i++) {
282 
283 		val = read_size(event, data + field->offset + i * item_size,
284 				item_size);
285 		if (field->flags & FIELD_IS_SIGNED) {
286 			if ((long long)val >= LONG_MIN &&
287 					(long long)val <= LONG_MAX)
288 				obj = PyInt_FromLong(val);
289 			else
290 				obj = PyLong_FromLongLong(val);
291 		} else {
292 			if (val <= LONG_MAX)
293 				obj = PyInt_FromLong(val);
294 			else
295 				obj = PyLong_FromUnsignedLongLong(val);
296 		}
297 		if (is_array)
298 			PyList_SET_ITEM(list, i, obj);
299 	}
300 	if (is_array)
301 		obj = list;
302 	return obj;
303 }
304 
305 
306 static PyObject *python_process_callchain(struct perf_sample *sample,
307 					 struct perf_evsel *evsel,
308 					 struct addr_location *al)
309 {
310 	PyObject *pylist;
311 
312 	pylist = PyList_New(0);
313 	if (!pylist)
314 		Py_FatalError("couldn't create Python list");
315 
316 	if (!symbol_conf.use_callchain || !sample->callchain)
317 		goto exit;
318 
319 	if (thread__resolve_callchain(al->thread, evsel,
320 				      sample, NULL, NULL,
321 				      PERF_MAX_STACK_DEPTH) != 0) {
322 		pr_err("Failed to resolve callchain. Skipping\n");
323 		goto exit;
324 	}
325 	callchain_cursor_commit(&callchain_cursor);
326 
327 
328 	while (1) {
329 		PyObject *pyelem;
330 		struct callchain_cursor_node *node;
331 		node = callchain_cursor_current(&callchain_cursor);
332 		if (!node)
333 			break;
334 
335 		pyelem = PyDict_New();
336 		if (!pyelem)
337 			Py_FatalError("couldn't create Python dictionary");
338 
339 
340 		pydict_set_item_string_decref(pyelem, "ip",
341 				PyLong_FromUnsignedLongLong(node->ip));
342 
343 		if (node->sym) {
344 			PyObject *pysym  = PyDict_New();
345 			if (!pysym)
346 				Py_FatalError("couldn't create Python dictionary");
347 			pydict_set_item_string_decref(pysym, "start",
348 					PyLong_FromUnsignedLongLong(node->sym->start));
349 			pydict_set_item_string_decref(pysym, "end",
350 					PyLong_FromUnsignedLongLong(node->sym->end));
351 			pydict_set_item_string_decref(pysym, "binding",
352 					PyInt_FromLong(node->sym->binding));
353 			pydict_set_item_string_decref(pysym, "name",
354 					PyString_FromStringAndSize(node->sym->name,
355 							node->sym->namelen));
356 			pydict_set_item_string_decref(pyelem, "sym", pysym);
357 		}
358 
359 		if (node->map) {
360 			struct map *map = node->map;
361 			const char *dsoname = "[unknown]";
362 			if (map && map->dso && (map->dso->name || map->dso->long_name)) {
363 				if (symbol_conf.show_kernel_path && map->dso->long_name)
364 					dsoname = map->dso->long_name;
365 				else if (map->dso->name)
366 					dsoname = map->dso->name;
367 			}
368 			pydict_set_item_string_decref(pyelem, "dso",
369 					PyString_FromString(dsoname));
370 		}
371 
372 		callchain_cursor_advance(&callchain_cursor);
373 		PyList_Append(pylist, pyelem);
374 		Py_DECREF(pyelem);
375 	}
376 
377 exit:
378 	return pylist;
379 }
380 
381 
382 static void python_process_tracepoint(struct perf_sample *sample,
383 				      struct perf_evsel *evsel,
384 				      struct addr_location *al)
385 {
386 	struct event_format *event = evsel->tp_format;
387 	PyObject *handler, *context, *t, *obj, *callchain;
388 	PyObject *dict = NULL;
389 	static char handler_name[256];
390 	struct format_field *field;
391 	unsigned long s, ns;
392 	unsigned n = 0;
393 	int pid;
394 	int cpu = sample->cpu;
395 	void *data = sample->raw_data;
396 	unsigned long long nsecs = sample->time;
397 	const char *comm = thread__comm_str(al->thread);
398 
399 	t = PyTuple_New(MAX_FIELDS);
400 	if (!t)
401 		Py_FatalError("couldn't create Python tuple");
402 
403 	if (!event)
404 		die("ug! no event found for type %d", (int)evsel->attr.config);
405 
406 	pid = raw_field_value(event, "common_pid", data);
407 
408 	sprintf(handler_name, "%s__%s", event->system, event->name);
409 
410 	if (!test_and_set_bit(event->id, events_defined))
411 		define_event_symbols(event, handler_name, event->print_fmt.args);
412 
413 	handler = get_handler(handler_name);
414 	if (!handler) {
415 		dict = PyDict_New();
416 		if (!dict)
417 			Py_FatalError("couldn't create Python dict");
418 	}
419 	s = nsecs / NSECS_PER_SEC;
420 	ns = nsecs - s * NSECS_PER_SEC;
421 
422 	scripting_context->event_data = data;
423 	scripting_context->pevent = evsel->tp_format->pevent;
424 
425 	context = PyCObject_FromVoidPtr(scripting_context, NULL);
426 
427 	PyTuple_SetItem(t, n++, PyString_FromString(handler_name));
428 	PyTuple_SetItem(t, n++, context);
429 
430 	/* ip unwinding */
431 	callchain = python_process_callchain(sample, evsel, al);
432 
433 	if (handler) {
434 		PyTuple_SetItem(t, n++, PyInt_FromLong(cpu));
435 		PyTuple_SetItem(t, n++, PyInt_FromLong(s));
436 		PyTuple_SetItem(t, n++, PyInt_FromLong(ns));
437 		PyTuple_SetItem(t, n++, PyInt_FromLong(pid));
438 		PyTuple_SetItem(t, n++, PyString_FromString(comm));
439 		PyTuple_SetItem(t, n++, callchain);
440 	} else {
441 		pydict_set_item_string_decref(dict, "common_cpu", PyInt_FromLong(cpu));
442 		pydict_set_item_string_decref(dict, "common_s", PyInt_FromLong(s));
443 		pydict_set_item_string_decref(dict, "common_ns", PyInt_FromLong(ns));
444 		pydict_set_item_string_decref(dict, "common_pid", PyInt_FromLong(pid));
445 		pydict_set_item_string_decref(dict, "common_comm", PyString_FromString(comm));
446 		pydict_set_item_string_decref(dict, "common_callchain", callchain);
447 	}
448 	for (field = event->format.fields; field; field = field->next) {
449 		if (field->flags & FIELD_IS_STRING) {
450 			int offset;
451 			if (field->flags & FIELD_IS_DYNAMIC) {
452 				offset = *(int *)(data + field->offset);
453 				offset &= 0xffff;
454 			} else
455 				offset = field->offset;
456 			obj = PyString_FromString((char *)data + offset);
457 		} else { /* FIELD_IS_NUMERIC */
458 			obj = get_field_numeric_entry(event, field, data);
459 		}
460 		if (handler)
461 			PyTuple_SetItem(t, n++, obj);
462 		else
463 			pydict_set_item_string_decref(dict, field->name, obj);
464 
465 	}
466 
467 	if (!handler)
468 		PyTuple_SetItem(t, n++, dict);
469 
470 	if (_PyTuple_Resize(&t, n) == -1)
471 		Py_FatalError("error resizing Python tuple");
472 
473 	if (handler) {
474 		call_object(handler, t, handler_name);
475 	} else {
476 		try_call_object("trace_unhandled", t);
477 		Py_DECREF(dict);
478 	}
479 
480 	Py_DECREF(t);
481 }
482 
483 static PyObject *tuple_new(unsigned int sz)
484 {
485 	PyObject *t;
486 
487 	t = PyTuple_New(sz);
488 	if (!t)
489 		Py_FatalError("couldn't create Python tuple");
490 	return t;
491 }
492 
493 static int tuple_set_u64(PyObject *t, unsigned int pos, u64 val)
494 {
495 #if BITS_PER_LONG == 64
496 	return PyTuple_SetItem(t, pos, PyInt_FromLong(val));
497 #endif
498 #if BITS_PER_LONG == 32
499 	return PyTuple_SetItem(t, pos, PyLong_FromLongLong(val));
500 #endif
501 }
502 
503 static int tuple_set_s32(PyObject *t, unsigned int pos, s32 val)
504 {
505 	return PyTuple_SetItem(t, pos, PyInt_FromLong(val));
506 }
507 
508 static int tuple_set_string(PyObject *t, unsigned int pos, const char *s)
509 {
510 	return PyTuple_SetItem(t, pos, PyString_FromString(s));
511 }
512 
513 static int python_export_evsel(struct db_export *dbe, struct perf_evsel *evsel)
514 {
515 	struct tables *tables = container_of(dbe, struct tables, dbe);
516 	PyObject *t;
517 
518 	t = tuple_new(2);
519 
520 	tuple_set_u64(t, 0, evsel->db_id);
521 	tuple_set_string(t, 1, perf_evsel__name(evsel));
522 
523 	call_object(tables->evsel_handler, t, "evsel_table");
524 
525 	Py_DECREF(t);
526 
527 	return 0;
528 }
529 
530 static int python_export_machine(struct db_export *dbe,
531 				 struct machine *machine)
532 {
533 	struct tables *tables = container_of(dbe, struct tables, dbe);
534 	PyObject *t;
535 
536 	t = tuple_new(3);
537 
538 	tuple_set_u64(t, 0, machine->db_id);
539 	tuple_set_s32(t, 1, machine->pid);
540 	tuple_set_string(t, 2, machine->root_dir ? machine->root_dir : "");
541 
542 	call_object(tables->machine_handler, t, "machine_table");
543 
544 	Py_DECREF(t);
545 
546 	return 0;
547 }
548 
549 static int python_export_thread(struct db_export *dbe, struct thread *thread,
550 				u64 main_thread_db_id, struct machine *machine)
551 {
552 	struct tables *tables = container_of(dbe, struct tables, dbe);
553 	PyObject *t;
554 
555 	t = tuple_new(5);
556 
557 	tuple_set_u64(t, 0, thread->db_id);
558 	tuple_set_u64(t, 1, machine->db_id);
559 	tuple_set_u64(t, 2, main_thread_db_id);
560 	tuple_set_s32(t, 3, thread->pid_);
561 	tuple_set_s32(t, 4, thread->tid);
562 
563 	call_object(tables->thread_handler, t, "thread_table");
564 
565 	Py_DECREF(t);
566 
567 	return 0;
568 }
569 
570 static int python_export_comm(struct db_export *dbe, struct comm *comm)
571 {
572 	struct tables *tables = container_of(dbe, struct tables, dbe);
573 	PyObject *t;
574 
575 	t = tuple_new(2);
576 
577 	tuple_set_u64(t, 0, comm->db_id);
578 	tuple_set_string(t, 1, comm__str(comm));
579 
580 	call_object(tables->comm_handler, t, "comm_table");
581 
582 	Py_DECREF(t);
583 
584 	return 0;
585 }
586 
587 static int python_export_comm_thread(struct db_export *dbe, u64 db_id,
588 				     struct comm *comm, struct thread *thread)
589 {
590 	struct tables *tables = container_of(dbe, struct tables, dbe);
591 	PyObject *t;
592 
593 	t = tuple_new(3);
594 
595 	tuple_set_u64(t, 0, db_id);
596 	tuple_set_u64(t, 1, comm->db_id);
597 	tuple_set_u64(t, 2, thread->db_id);
598 
599 	call_object(tables->comm_thread_handler, t, "comm_thread_table");
600 
601 	Py_DECREF(t);
602 
603 	return 0;
604 }
605 
606 static int python_export_dso(struct db_export *dbe, struct dso *dso,
607 			     struct machine *machine)
608 {
609 	struct tables *tables = container_of(dbe, struct tables, dbe);
610 	char sbuild_id[BUILD_ID_SIZE * 2 + 1];
611 	PyObject *t;
612 
613 	build_id__sprintf(dso->build_id, sizeof(dso->build_id), sbuild_id);
614 
615 	t = tuple_new(5);
616 
617 	tuple_set_u64(t, 0, dso->db_id);
618 	tuple_set_u64(t, 1, machine->db_id);
619 	tuple_set_string(t, 2, dso->short_name);
620 	tuple_set_string(t, 3, dso->long_name);
621 	tuple_set_string(t, 4, sbuild_id);
622 
623 	call_object(tables->dso_handler, t, "dso_table");
624 
625 	Py_DECREF(t);
626 
627 	return 0;
628 }
629 
630 static int python_export_symbol(struct db_export *dbe, struct symbol *sym,
631 				struct dso *dso)
632 {
633 	struct tables *tables = container_of(dbe, struct tables, dbe);
634 	u64 *sym_db_id = symbol__priv(sym);
635 	PyObject *t;
636 
637 	t = tuple_new(6);
638 
639 	tuple_set_u64(t, 0, *sym_db_id);
640 	tuple_set_u64(t, 1, dso->db_id);
641 	tuple_set_u64(t, 2, sym->start);
642 	tuple_set_u64(t, 3, sym->end);
643 	tuple_set_s32(t, 4, sym->binding);
644 	tuple_set_string(t, 5, sym->name);
645 
646 	call_object(tables->symbol_handler, t, "symbol_table");
647 
648 	Py_DECREF(t);
649 
650 	return 0;
651 }
652 
653 static int python_export_branch_type(struct db_export *dbe, u32 branch_type,
654 				     const char *name)
655 {
656 	struct tables *tables = container_of(dbe, struct tables, dbe);
657 	PyObject *t;
658 
659 	t = tuple_new(2);
660 
661 	tuple_set_s32(t, 0, branch_type);
662 	tuple_set_string(t, 1, name);
663 
664 	call_object(tables->branch_type_handler, t, "branch_type_table");
665 
666 	Py_DECREF(t);
667 
668 	return 0;
669 }
670 
671 static int python_export_sample(struct db_export *dbe,
672 				struct export_sample *es)
673 {
674 	struct tables *tables = container_of(dbe, struct tables, dbe);
675 	PyObject *t;
676 
677 	t = tuple_new(21);
678 
679 	tuple_set_u64(t, 0, es->db_id);
680 	tuple_set_u64(t, 1, es->evsel->db_id);
681 	tuple_set_u64(t, 2, es->al->machine->db_id);
682 	tuple_set_u64(t, 3, es->al->thread->db_id);
683 	tuple_set_u64(t, 4, es->comm_db_id);
684 	tuple_set_u64(t, 5, es->dso_db_id);
685 	tuple_set_u64(t, 6, es->sym_db_id);
686 	tuple_set_u64(t, 7, es->offset);
687 	tuple_set_u64(t, 8, es->sample->ip);
688 	tuple_set_u64(t, 9, es->sample->time);
689 	tuple_set_s32(t, 10, es->sample->cpu);
690 	tuple_set_u64(t, 11, es->addr_dso_db_id);
691 	tuple_set_u64(t, 12, es->addr_sym_db_id);
692 	tuple_set_u64(t, 13, es->addr_offset);
693 	tuple_set_u64(t, 14, es->sample->addr);
694 	tuple_set_u64(t, 15, es->sample->period);
695 	tuple_set_u64(t, 16, es->sample->weight);
696 	tuple_set_u64(t, 17, es->sample->transaction);
697 	tuple_set_u64(t, 18, es->sample->data_src);
698 	tuple_set_s32(t, 19, es->sample->flags & PERF_BRANCH_MASK);
699 	tuple_set_s32(t, 20, !!(es->sample->flags & PERF_IP_FLAG_IN_TX));
700 
701 	call_object(tables->sample_handler, t, "sample_table");
702 
703 	Py_DECREF(t);
704 
705 	return 0;
706 }
707 
708 static int python_export_call_path(struct db_export *dbe, struct call_path *cp)
709 {
710 	struct tables *tables = container_of(dbe, struct tables, dbe);
711 	PyObject *t;
712 	u64 parent_db_id, sym_db_id;
713 
714 	parent_db_id = cp->parent ? cp->parent->db_id : 0;
715 	sym_db_id = cp->sym ? *(u64 *)symbol__priv(cp->sym) : 0;
716 
717 	t = tuple_new(4);
718 
719 	tuple_set_u64(t, 0, cp->db_id);
720 	tuple_set_u64(t, 1, parent_db_id);
721 	tuple_set_u64(t, 2, sym_db_id);
722 	tuple_set_u64(t, 3, cp->ip);
723 
724 	call_object(tables->call_path_handler, t, "call_path_table");
725 
726 	Py_DECREF(t);
727 
728 	return 0;
729 }
730 
731 static int python_export_call_return(struct db_export *dbe,
732 				     struct call_return *cr)
733 {
734 	struct tables *tables = container_of(dbe, struct tables, dbe);
735 	u64 comm_db_id = cr->comm ? cr->comm->db_id : 0;
736 	PyObject *t;
737 
738 	t = tuple_new(11);
739 
740 	tuple_set_u64(t, 0, cr->db_id);
741 	tuple_set_u64(t, 1, cr->thread->db_id);
742 	tuple_set_u64(t, 2, comm_db_id);
743 	tuple_set_u64(t, 3, cr->cp->db_id);
744 	tuple_set_u64(t, 4, cr->call_time);
745 	tuple_set_u64(t, 5, cr->return_time);
746 	tuple_set_u64(t, 6, cr->branch_count);
747 	tuple_set_u64(t, 7, cr->call_ref);
748 	tuple_set_u64(t, 8, cr->return_ref);
749 	tuple_set_u64(t, 9, cr->cp->parent->db_id);
750 	tuple_set_s32(t, 10, cr->flags);
751 
752 	call_object(tables->call_return_handler, t, "call_return_table");
753 
754 	Py_DECREF(t);
755 
756 	return 0;
757 }
758 
759 static int python_process_call_return(struct call_return *cr, void *data)
760 {
761 	struct db_export *dbe = data;
762 
763 	return db_export__call_return(dbe, cr);
764 }
765 
766 static void python_process_general_event(struct perf_sample *sample,
767 					 struct perf_evsel *evsel,
768 					 struct addr_location *al)
769 {
770 	PyObject *handler, *t, *dict, *callchain, *dict_sample;
771 	static char handler_name[64];
772 	unsigned n = 0;
773 
774 	/*
775 	 * Use the MAX_FIELDS to make the function expandable, though
776 	 * currently there is only one item for the tuple.
777 	 */
778 	t = PyTuple_New(MAX_FIELDS);
779 	if (!t)
780 		Py_FatalError("couldn't create Python tuple");
781 
782 	dict = PyDict_New();
783 	if (!dict)
784 		Py_FatalError("couldn't create Python dictionary");
785 
786 	dict_sample = PyDict_New();
787 	if (!dict_sample)
788 		Py_FatalError("couldn't create Python dictionary");
789 
790 	snprintf(handler_name, sizeof(handler_name), "%s", "process_event");
791 
792 	handler = get_handler(handler_name);
793 	if (!handler)
794 		goto exit;
795 
796 	pydict_set_item_string_decref(dict, "ev_name", PyString_FromString(perf_evsel__name(evsel)));
797 	pydict_set_item_string_decref(dict, "attr", PyString_FromStringAndSize(
798 			(const char *)&evsel->attr, sizeof(evsel->attr)));
799 
800 	pydict_set_item_string_decref(dict_sample, "pid",
801 			PyInt_FromLong(sample->pid));
802 	pydict_set_item_string_decref(dict_sample, "tid",
803 			PyInt_FromLong(sample->tid));
804 	pydict_set_item_string_decref(dict_sample, "cpu",
805 			PyInt_FromLong(sample->cpu));
806 	pydict_set_item_string_decref(dict_sample, "ip",
807 			PyLong_FromUnsignedLongLong(sample->ip));
808 	pydict_set_item_string_decref(dict_sample, "time",
809 			PyLong_FromUnsignedLongLong(sample->time));
810 	pydict_set_item_string_decref(dict_sample, "period",
811 			PyLong_FromUnsignedLongLong(sample->period));
812 	pydict_set_item_string_decref(dict, "sample", dict_sample);
813 
814 	pydict_set_item_string_decref(dict, "raw_buf", PyString_FromStringAndSize(
815 			(const char *)sample->raw_data, sample->raw_size));
816 	pydict_set_item_string_decref(dict, "comm",
817 			PyString_FromString(thread__comm_str(al->thread)));
818 	if (al->map) {
819 		pydict_set_item_string_decref(dict, "dso",
820 			PyString_FromString(al->map->dso->name));
821 	}
822 	if (al->sym) {
823 		pydict_set_item_string_decref(dict, "symbol",
824 			PyString_FromString(al->sym->name));
825 	}
826 
827 	/* ip unwinding */
828 	callchain = python_process_callchain(sample, evsel, al);
829 	pydict_set_item_string_decref(dict, "callchain", callchain);
830 
831 	PyTuple_SetItem(t, n++, dict);
832 	if (_PyTuple_Resize(&t, n) == -1)
833 		Py_FatalError("error resizing Python tuple");
834 
835 	call_object(handler, t, handler_name);
836 exit:
837 	Py_DECREF(dict);
838 	Py_DECREF(t);
839 }
840 
841 static void python_process_event(union perf_event *event,
842 				 struct perf_sample *sample,
843 				 struct perf_evsel *evsel,
844 				 struct addr_location *al)
845 {
846 	struct tables *tables = &tables_global;
847 
848 	switch (evsel->attr.type) {
849 	case PERF_TYPE_TRACEPOINT:
850 		python_process_tracepoint(sample, evsel, al);
851 		break;
852 	/* Reserve for future process_hw/sw/raw APIs */
853 	default:
854 		if (tables->db_export_mode)
855 			db_export__sample(&tables->dbe, event, sample, evsel, al);
856 		else
857 			python_process_general_event(sample, evsel, al);
858 	}
859 }
860 
861 static int run_start_sub(void)
862 {
863 	main_module = PyImport_AddModule("__main__");
864 	if (main_module == NULL)
865 		return -1;
866 	Py_INCREF(main_module);
867 
868 	main_dict = PyModule_GetDict(main_module);
869 	if (main_dict == NULL)
870 		goto error;
871 	Py_INCREF(main_dict);
872 
873 	try_call_object("trace_begin", NULL);
874 
875 	return 0;
876 
877 error:
878 	Py_XDECREF(main_dict);
879 	Py_XDECREF(main_module);
880 	return -1;
881 }
882 
883 #define SET_TABLE_HANDLER_(name, handler_name, table_name) do {		\
884 	tables->handler_name = get_handler(#table_name);		\
885 	if (tables->handler_name)					\
886 		tables->dbe.export_ ## name = python_export_ ## name;	\
887 } while (0)
888 
889 #define SET_TABLE_HANDLER(name) \
890 	SET_TABLE_HANDLER_(name, name ## _handler, name ## _table)
891 
892 static void set_table_handlers(struct tables *tables)
893 {
894 	const char *perf_db_export_mode = "perf_db_export_mode";
895 	const char *perf_db_export_calls = "perf_db_export_calls";
896 	PyObject *db_export_mode, *db_export_calls;
897 	bool export_calls = false;
898 	int ret;
899 
900 	memset(tables, 0, sizeof(struct tables));
901 	if (db_export__init(&tables->dbe))
902 		Py_FatalError("failed to initialize export");
903 
904 	db_export_mode = PyDict_GetItemString(main_dict, perf_db_export_mode);
905 	if (!db_export_mode)
906 		return;
907 
908 	ret = PyObject_IsTrue(db_export_mode);
909 	if (ret == -1)
910 		handler_call_die(perf_db_export_mode);
911 	if (!ret)
912 		return;
913 
914 	tables->dbe.crp = NULL;
915 	db_export_calls = PyDict_GetItemString(main_dict, perf_db_export_calls);
916 	if (db_export_calls) {
917 		ret = PyObject_IsTrue(db_export_calls);
918 		if (ret == -1)
919 			handler_call_die(perf_db_export_calls);
920 		export_calls = !!ret;
921 	}
922 
923 	if (export_calls) {
924 		tables->dbe.crp =
925 			call_return_processor__new(python_process_call_return,
926 						   &tables->dbe);
927 		if (!tables->dbe.crp)
928 			Py_FatalError("failed to create calls processor");
929 	}
930 
931 	tables->db_export_mode = true;
932 	/*
933 	 * Reserve per symbol space for symbol->db_id via symbol__priv()
934 	 */
935 	symbol_conf.priv_size = sizeof(u64);
936 
937 	SET_TABLE_HANDLER(evsel);
938 	SET_TABLE_HANDLER(machine);
939 	SET_TABLE_HANDLER(thread);
940 	SET_TABLE_HANDLER(comm);
941 	SET_TABLE_HANDLER(comm_thread);
942 	SET_TABLE_HANDLER(dso);
943 	SET_TABLE_HANDLER(symbol);
944 	SET_TABLE_HANDLER(branch_type);
945 	SET_TABLE_HANDLER(sample);
946 	SET_TABLE_HANDLER(call_path);
947 	SET_TABLE_HANDLER(call_return);
948 }
949 
950 /*
951  * Start trace script
952  */
953 static int python_start_script(const char *script, int argc, const char **argv)
954 {
955 	struct tables *tables = &tables_global;
956 	const char **command_line;
957 	char buf[PATH_MAX];
958 	int i, err = 0;
959 	FILE *fp;
960 
961 	command_line = malloc((argc + 1) * sizeof(const char *));
962 	command_line[0] = script;
963 	for (i = 1; i < argc + 1; i++)
964 		command_line[i] = argv[i - 1];
965 
966 	Py_Initialize();
967 
968 	initperf_trace_context();
969 
970 	PySys_SetArgv(argc + 1, (char **)command_line);
971 
972 	fp = fopen(script, "r");
973 	if (!fp) {
974 		sprintf(buf, "Can't open python script \"%s\"", script);
975 		perror(buf);
976 		err = -1;
977 		goto error;
978 	}
979 
980 	err = PyRun_SimpleFile(fp, script);
981 	if (err) {
982 		fprintf(stderr, "Error running python script %s\n", script);
983 		goto error;
984 	}
985 
986 	err = run_start_sub();
987 	if (err) {
988 		fprintf(stderr, "Error starting python script %s\n", script);
989 		goto error;
990 	}
991 
992 	free(command_line);
993 
994 	set_table_handlers(tables);
995 
996 	if (tables->db_export_mode) {
997 		err = db_export__branch_types(&tables->dbe);
998 		if (err)
999 			goto error;
1000 	}
1001 
1002 	return err;
1003 error:
1004 	Py_Finalize();
1005 	free(command_line);
1006 
1007 	return err;
1008 }
1009 
1010 static int python_flush_script(void)
1011 {
1012 	struct tables *tables = &tables_global;
1013 
1014 	return db_export__flush(&tables->dbe);
1015 }
1016 
1017 /*
1018  * Stop trace script
1019  */
1020 static int python_stop_script(void)
1021 {
1022 	struct tables *tables = &tables_global;
1023 
1024 	try_call_object("trace_end", NULL);
1025 
1026 	db_export__exit(&tables->dbe);
1027 
1028 	Py_XDECREF(main_dict);
1029 	Py_XDECREF(main_module);
1030 	Py_Finalize();
1031 
1032 	return 0;
1033 }
1034 
1035 static int python_generate_script(struct pevent *pevent, const char *outfile)
1036 {
1037 	struct event_format *event = NULL;
1038 	struct format_field *f;
1039 	char fname[PATH_MAX];
1040 	int not_first, count;
1041 	FILE *ofp;
1042 
1043 	sprintf(fname, "%s.py", outfile);
1044 	ofp = fopen(fname, "w");
1045 	if (ofp == NULL) {
1046 		fprintf(stderr, "couldn't open %s\n", fname);
1047 		return -1;
1048 	}
1049 	fprintf(ofp, "# perf script event handlers, "
1050 		"generated by perf script -g python\n");
1051 
1052 	fprintf(ofp, "# Licensed under the terms of the GNU GPL"
1053 		" License version 2\n\n");
1054 
1055 	fprintf(ofp, "# The common_* event handler fields are the most useful "
1056 		"fields common to\n");
1057 
1058 	fprintf(ofp, "# all events.  They don't necessarily correspond to "
1059 		"the 'common_*' fields\n");
1060 
1061 	fprintf(ofp, "# in the format files.  Those fields not available as "
1062 		"handler params can\n");
1063 
1064 	fprintf(ofp, "# be retrieved using Python functions of the form "
1065 		"common_*(context).\n");
1066 
1067 	fprintf(ofp, "# See the perf-trace-python Documentation for the list "
1068 		"of available functions.\n\n");
1069 
1070 	fprintf(ofp, "import os\n");
1071 	fprintf(ofp, "import sys\n\n");
1072 
1073 	fprintf(ofp, "sys.path.append(os.environ['PERF_EXEC_PATH'] + \\\n");
1074 	fprintf(ofp, "\t'/scripts/python/Perf-Trace-Util/lib/Perf/Trace')\n");
1075 	fprintf(ofp, "\nfrom perf_trace_context import *\n");
1076 	fprintf(ofp, "from Core import *\n\n\n");
1077 
1078 	fprintf(ofp, "def trace_begin():\n");
1079 	fprintf(ofp, "\tprint \"in trace_begin\"\n\n");
1080 
1081 	fprintf(ofp, "def trace_end():\n");
1082 	fprintf(ofp, "\tprint \"in trace_end\"\n\n");
1083 
1084 	while ((event = trace_find_next_event(pevent, event))) {
1085 		fprintf(ofp, "def %s__%s(", event->system, event->name);
1086 		fprintf(ofp, "event_name, ");
1087 		fprintf(ofp, "context, ");
1088 		fprintf(ofp, "common_cpu,\n");
1089 		fprintf(ofp, "\tcommon_secs, ");
1090 		fprintf(ofp, "common_nsecs, ");
1091 		fprintf(ofp, "common_pid, ");
1092 		fprintf(ofp, "common_comm,\n\t");
1093 		fprintf(ofp, "common_callchain, ");
1094 
1095 		not_first = 0;
1096 		count = 0;
1097 
1098 		for (f = event->format.fields; f; f = f->next) {
1099 			if (not_first++)
1100 				fprintf(ofp, ", ");
1101 			if (++count % 5 == 0)
1102 				fprintf(ofp, "\n\t");
1103 
1104 			fprintf(ofp, "%s", f->name);
1105 		}
1106 		fprintf(ofp, "):\n");
1107 
1108 		fprintf(ofp, "\t\tprint_header(event_name, common_cpu, "
1109 			"common_secs, common_nsecs,\n\t\t\t"
1110 			"common_pid, common_comm)\n\n");
1111 
1112 		fprintf(ofp, "\t\tprint \"");
1113 
1114 		not_first = 0;
1115 		count = 0;
1116 
1117 		for (f = event->format.fields; f; f = f->next) {
1118 			if (not_first++)
1119 				fprintf(ofp, ", ");
1120 			if (count && count % 3 == 0) {
1121 				fprintf(ofp, "\" \\\n\t\t\"");
1122 			}
1123 			count++;
1124 
1125 			fprintf(ofp, "%s=", f->name);
1126 			if (f->flags & FIELD_IS_STRING ||
1127 			    f->flags & FIELD_IS_FLAG ||
1128 			    f->flags & FIELD_IS_ARRAY ||
1129 			    f->flags & FIELD_IS_SYMBOLIC)
1130 				fprintf(ofp, "%%s");
1131 			else if (f->flags & FIELD_IS_SIGNED)
1132 				fprintf(ofp, "%%d");
1133 			else
1134 				fprintf(ofp, "%%u");
1135 		}
1136 
1137 		fprintf(ofp, "\" %% \\\n\t\t(");
1138 
1139 		not_first = 0;
1140 		count = 0;
1141 
1142 		for (f = event->format.fields; f; f = f->next) {
1143 			if (not_first++)
1144 				fprintf(ofp, ", ");
1145 
1146 			if (++count % 5 == 0)
1147 				fprintf(ofp, "\n\t\t");
1148 
1149 			if (f->flags & FIELD_IS_FLAG) {
1150 				if ((count - 1) % 5 != 0) {
1151 					fprintf(ofp, "\n\t\t");
1152 					count = 4;
1153 				}
1154 				fprintf(ofp, "flag_str(\"");
1155 				fprintf(ofp, "%s__%s\", ", event->system,
1156 					event->name);
1157 				fprintf(ofp, "\"%s\", %s)", f->name,
1158 					f->name);
1159 			} else if (f->flags & FIELD_IS_SYMBOLIC) {
1160 				if ((count - 1) % 5 != 0) {
1161 					fprintf(ofp, "\n\t\t");
1162 					count = 4;
1163 				}
1164 				fprintf(ofp, "symbol_str(\"");
1165 				fprintf(ofp, "%s__%s\", ", event->system,
1166 					event->name);
1167 				fprintf(ofp, "\"%s\", %s)", f->name,
1168 					f->name);
1169 			} else
1170 				fprintf(ofp, "%s", f->name);
1171 		}
1172 
1173 		fprintf(ofp, ")\n\n");
1174 
1175 		fprintf(ofp, "\t\tfor node in common_callchain:");
1176 		fprintf(ofp, "\n\t\t\tif 'sym' in node:");
1177 		fprintf(ofp, "\n\t\t\t\tprint \"\\t[%%x] %%s\" %% (node['ip'], node['sym']['name'])");
1178 		fprintf(ofp, "\n\t\t\telse:");
1179 		fprintf(ofp, "\n\t\t\t\tprint \"\t[%%x]\" %% (node['ip'])\n\n");
1180 		fprintf(ofp, "\t\tprint \"\\n\"\n\n");
1181 
1182 	}
1183 
1184 	fprintf(ofp, "def trace_unhandled(event_name, context, "
1185 		"event_fields_dict):\n");
1186 
1187 	fprintf(ofp, "\t\tprint ' '.join(['%%s=%%s'%%(k,str(v))"
1188 		"for k,v in sorted(event_fields_dict.items())])\n\n");
1189 
1190 	fprintf(ofp, "def print_header("
1191 		"event_name, cpu, secs, nsecs, pid, comm):\n"
1192 		"\tprint \"%%-20s %%5u %%05u.%%09u %%8u %%-20s \" %% \\\n\t"
1193 		"(event_name, cpu, secs, nsecs, pid, comm),\n");
1194 
1195 	fclose(ofp);
1196 
1197 	fprintf(stderr, "generated Python script: %s\n", fname);
1198 
1199 	return 0;
1200 }
1201 
1202 struct scripting_ops python_scripting_ops = {
1203 	.name = "Python",
1204 	.start_script = python_start_script,
1205 	.flush_script = python_flush_script,
1206 	.stop_script = python_stop_script,
1207 	.process_event = python_process_event,
1208 	.generate_script = python_generate_script,
1209 };
1210