Mi start command: support and validation
[lttng-tools.git] / src / bin / lttng / commands / enable_events.c
1 /*
2 * Copyright (C) 2011 - David Goulet <david.goulet@polymtl.ca>
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License, version 2 only,
6 * as published by the Free Software Foundation.
7 *
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
12 *
13 * You should have received a copy of the GNU General Public License along
14 * with this program; if not, write to the Free Software Foundation, Inc.,
15 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
16 */
17
18 #define _GNU_SOURCE
19 #include <assert.h>
20 #include <popt.h>
21 #include <stdio.h>
22 #include <stdlib.h>
23 #include <string.h>
24 #include <sys/stat.h>
25 #include <sys/types.h>
26 #include <unistd.h>
27 #include <inttypes.h>
28 #include <ctype.h>
29
30 #include "../command.h"
31 #include <src/common/sessiond-comm/sessiond-comm.h>
32
33 #if (LTTNG_SYMBOL_NAME_LEN == 256)
34 #define LTTNG_SYMBOL_NAME_LEN_SCANF_IS_A_BROKEN_API "255"
35 #endif
36
37 static char *opt_event_list;
38 static int opt_event_type;
39 static const char *opt_loglevel;
40 static int opt_loglevel_type;
41 static int opt_kernel;
42 static char *opt_session_name;
43 static int opt_userspace;
44 static int opt_jul;
45 static int opt_enable_all;
46 static char *opt_probe;
47 static char *opt_function;
48 static char *opt_function_entry_symbol;
49 static char *opt_channel_name;
50 static char *opt_filter;
51 static char *opt_exclude;
52 #if 0
53 /* Not implemented yet */
54 static char *opt_cmd_name;
55 static pid_t opt_pid;
56 #endif
57
58 enum {
59 OPT_HELP = 1,
60 OPT_TRACEPOINT,
61 OPT_PROBE,
62 OPT_FUNCTION,
63 OPT_FUNCTION_ENTRY,
64 OPT_SYSCALL,
65 OPT_USERSPACE,
66 OPT_LOGLEVEL,
67 OPT_LOGLEVEL_ONLY,
68 OPT_LIST_OPTIONS,
69 OPT_FILTER,
70 OPT_EXCLUDE,
71 };
72
73 static struct lttng_handle *handle;
74
75 static struct poptOption long_options[] = {
76 /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
77 {"help", 'h', POPT_ARG_NONE, 0, OPT_HELP, 0, 0},
78 {"session", 's', POPT_ARG_STRING, &opt_session_name, 0, 0, 0},
79 {"all", 'a', POPT_ARG_VAL, &opt_enable_all, 1, 0, 0},
80 {"channel", 'c', POPT_ARG_STRING, &opt_channel_name, 0, 0, 0},
81 {"kernel", 'k', POPT_ARG_VAL, &opt_kernel, 1, 0, 0},
82 {"userspace", 'u', POPT_ARG_NONE, 0, OPT_USERSPACE, 0, 0},
83 {"jul", 'j', POPT_ARG_VAL, &opt_jul, 1, 0, 0},
84 {"tracepoint", 0, POPT_ARG_NONE, 0, OPT_TRACEPOINT, 0, 0},
85 {"probe", 0, POPT_ARG_STRING, &opt_probe, OPT_PROBE, 0, 0},
86 {"function", 0, POPT_ARG_STRING, &opt_function, OPT_FUNCTION, 0, 0},
87 #if 0
88 /*
89 * Currently removed from lttng kernel tracer. Removed from
90 * lttng UI to discourage its use.
91 */
92 {"function:entry", 0, POPT_ARG_STRING, &opt_function_entry_symbol, OPT_FUNCTION_ENTRY, 0, 0},
93 #endif
94 {"syscall", 0, POPT_ARG_NONE, 0, OPT_SYSCALL, 0, 0},
95 {"loglevel", 0, POPT_ARG_STRING, 0, OPT_LOGLEVEL, 0, 0},
96 {"loglevel-only", 0, POPT_ARG_STRING, 0, OPT_LOGLEVEL_ONLY, 0, 0},
97 {"list-options", 0, POPT_ARG_NONE, NULL, OPT_LIST_OPTIONS, NULL, NULL},
98 {"filter", 'f', POPT_ARG_STRING, &opt_filter, OPT_FILTER, 0, 0},
99 {"exclude", 'x', POPT_ARG_STRING, &opt_exclude, OPT_EXCLUDE, 0, 0},
100 {0, 0, 0, 0, 0, 0, 0}
101 };
102
103 /*
104 * usage
105 */
106 static void usage(FILE *ofp)
107 {
108 fprintf(ofp, "usage: lttng enable-event NAME[,NAME2,...] [-k|-u] [OPTIONS] \n");
109 fprintf(ofp, "\n");
110 fprintf(ofp, "Options:\n");
111 fprintf(ofp, " -h, --help Show this help\n");
112 fprintf(ofp, " --list-options Simple listing of options\n");
113 fprintf(ofp, " -s, --session NAME Apply to session name\n");
114 fprintf(ofp, " -c, --channel NAME Apply to this channel\n");
115 fprintf(ofp, " -a, --all Enable all tracepoints and syscalls\n");
116 fprintf(ofp, " -k, --kernel Apply for the kernel tracer\n");
117 fprintf(ofp, " -u, --userspace Apply to the user-space tracer\n");
118 fprintf(ofp, " -j, --jul Apply for Java application using JUL\n");
119 fprintf(ofp, "\n");
120 fprintf(ofp, "Event options:\n");
121 fprintf(ofp, " --tracepoint Tracepoint event (default)\n");
122 fprintf(ofp, " - userspace tracer supports wildcards at end of string.\n");
123 fprintf(ofp, " Don't forget to quote to deal with bash expansion.\n");
124 fprintf(ofp, " e.g.:\n");
125 fprintf(ofp, " \"*\"\n");
126 fprintf(ofp, " \"app_component:na*\"\n");
127 fprintf(ofp, " --probe (addr | symbol | symbol+offset)\n");
128 fprintf(ofp, " Dynamic probe.\n");
129 fprintf(ofp, " Addr and offset can be octal (0NNN...),\n");
130 fprintf(ofp, " decimal (NNN...) or hexadecimal (0xNNN...)\n");
131 fprintf(ofp, " --function (addr | symbol | symbol+offset)\n");
132 fprintf(ofp, " Dynamic function entry/return probe.\n");
133 fprintf(ofp, " Addr and offset can be octal (0NNN...),\n");
134 fprintf(ofp, " decimal (NNN...) or hexadecimal (0xNNN...)\n");
135 #if 0
136 fprintf(ofp, " --function:entry symbol\n");
137 fprintf(ofp, " Function tracer event\n");
138 #endif
139 fprintf(ofp, " --syscall System call event\n");
140 fprintf(ofp, "\n");
141 fprintf(ofp, " --loglevel name\n");
142 fprintf(ofp, " Tracepoint loglevel range from 0 to loglevel.\n");
143 fprintf(ofp, " For JUL domain, see the table below for the range values.\n");
144 fprintf(ofp, " --loglevel-only name\n");
145 fprintf(ofp, " Tracepoint loglevel (only this loglevel)\n");
146 fprintf(ofp, "\n");
147 fprintf(ofp, " The loglevel or loglevel-only options should be\n");
148 fprintf(ofp, " combined with a tracepoint name or tracepoint\n");
149 fprintf(ofp, " wildcard.\n");
150 fprintf(ofp, " Available loglevels:\n");
151 fprintf(ofp, " (higher value is more verbose)\n");
152 fprintf(ofp, " TRACE_EMERG = 0\n");
153 fprintf(ofp, " TRACE_ALERT = 1\n");
154 fprintf(ofp, " TRACE_CRIT = 2\n");
155 fprintf(ofp, " TRACE_ERR = 3\n");
156 fprintf(ofp, " TRACE_WARNING = 4\n");
157 fprintf(ofp, " TRACE_NOTICE = 5\n");
158 fprintf(ofp, " TRACE_INFO = 6\n");
159 fprintf(ofp, " TRACE_DEBUG_SYSTEM = 7\n");
160 fprintf(ofp, " TRACE_DEBUG_PROGRAM = 8\n");
161 fprintf(ofp, " TRACE_DEBUG_PROCESS = 9\n");
162 fprintf(ofp, " TRACE_DEBUG_MODULE = 10\n");
163 fprintf(ofp, " TRACE_DEBUG_UNIT = 11\n");
164 fprintf(ofp, " TRACE_DEBUG_FUNCTION = 12\n");
165 fprintf(ofp, " TRACE_DEBUG_LINE = 13\n");
166 fprintf(ofp, " TRACE_DEBUG = 14\n");
167 fprintf(ofp, " (shortcuts such as \"system\" are allowed)\n");
168 fprintf(ofp, "\n");
169 fprintf(ofp, " Available JUL domain loglevels:\n");
170 fprintf(ofp, " JUL_OFF = INT32_MAX\n");
171 fprintf(ofp, " JUL_SEVERE = %d\n", LTTNG_LOGLEVEL_JUL_SEVERE);
172 fprintf(ofp, " JUL_WARNING = %d\n", LTTNG_LOGLEVEL_JUL_WARNING);
173 fprintf(ofp, " JUL_INFO = %d\n", LTTNG_LOGLEVEL_JUL_INFO);
174 fprintf(ofp, " JUL_CONFIG = %d\n", LTTNG_LOGLEVEL_JUL_CONFIG);
175 fprintf(ofp, " JUL_FINE = %d\n", LTTNG_LOGLEVEL_JUL_FINE);
176 fprintf(ofp, " JUL_FINER = %d\n", LTTNG_LOGLEVEL_JUL_FINER);
177 fprintf(ofp, " JUL_FINEST = %d\n", LTTNG_LOGLEVEL_JUL_FINEST);
178 fprintf(ofp, " JUL_ALL = INT32_MIN\n");
179 fprintf(ofp, " (shortcuts such as \"severe\" are allowed)\n");
180 fprintf(ofp, "\n");
181 fprintf(ofp, " -f, --filter \'expression\'\n");
182 fprintf(ofp, " Filter expression on event fields and context.\n");
183 fprintf(ofp, " Event recording depends on evaluation.\n");
184 fprintf(ofp, " Only specify on first activation of\n");
185 fprintf(ofp, " a given event within a session.\n");
186 fprintf(ofp, " Filter only allowed when enabling\n");
187 fprintf(ofp, " events within a session before tracing\n");
188 fprintf(ofp, " is started. If the filter fails to link\n");
189 fprintf(ofp, " with the event within the traced domain,\n");
190 fprintf(ofp, " the event will be discarded. Currently,\n");
191 fprintf(ofp, " filter is only implemented for the user-space\n");
192 fprintf(ofp, " tracer.\n");
193 fprintf(ofp, " Expression examples:.\n");
194 fprintf(ofp, " \n");
195 fprintf(ofp, " 'intfield > 500 && intfield < 503'\n");
196 fprintf(ofp, " '(strfield == \"test\" || intfield != 10) && intfield > 33'\n");
197 fprintf(ofp, " 'doublefield > 1.1 && intfield < 5.3'\n");
198 fprintf(ofp, " \n");
199 fprintf(ofp, " Wildcards are allowed at the end of strings:\n");
200 fprintf(ofp, " 'seqfield1 == \"te*\"'\n");
201 fprintf(ofp, " In string literals, the escape character is '\\'.\n");
202 fprintf(ofp, " Use '\\*' for the '*' character, and '\\\\' for\n");
203 fprintf(ofp, " the '\\' character. Wildcard match any sequence of,\n");
204 fprintf(ofp, " characters including an empty sub-string (match 0 or\n");
205 fprintf(ofp, " more characters).\n");
206 fprintf(ofp, "\n");
207 fprintf(ofp, " Context information can be used for filtering. The\n");
208 fprintf(ofp, " examples below show usage of context filtering on\n");
209 fprintf(ofp, " process name (with a wildcard), process ID range, and\n");
210 fprintf(ofp, " unique thread ID for filtering. The process and\n");
211 fprintf(ofp, " thread ID of running applications can be found under\n");
212 fprintf(ofp, " columns \"PID\" and \"LWP\" of the \"ps -eLf\" command.\n");
213 fprintf(ofp, "\n");
214 fprintf(ofp, " '$ctx.procname == \"demo*\"'\n");
215 fprintf(ofp, " '$ctx.vpid >= 4433 && $ctx.vpid < 4455'\n");
216 fprintf(ofp, " '$ctx.vtid == 1234'\n");
217 fprintf(ofp, " -x, --exclude LIST\n");
218 fprintf(ofp, " Add exclusions to UST tracepoints:\n");
219 fprintf(ofp, " Events that match any of the items\n");
220 fprintf(ofp, " in the comma-separated LIST are not\n");
221 fprintf(ofp, " enabled, even if they match a wildcard\n");
222 fprintf(ofp, " definition of the event.\n");
223 fprintf(ofp, "\n");
224 }
225
226 /*
227 * Parse probe options.
228 */
229 static int parse_probe_opts(struct lttng_event *ev, char *opt)
230 {
231 int ret;
232 char s_hex[19];
233 #define S_HEX_LEN_SCANF_IS_A_BROKEN_API "18" /* 18 is (19 - 1) (\0 is extra) */
234 char name[LTTNG_SYMBOL_NAME_LEN];
235
236 if (opt == NULL) {
237 ret = -1;
238 goto end;
239 }
240
241 /* Check for symbol+offset */
242 ret = sscanf(opt, "%" LTTNG_SYMBOL_NAME_LEN_SCANF_IS_A_BROKEN_API
243 "[^'+']+%" S_HEX_LEN_SCANF_IS_A_BROKEN_API "s", name, s_hex);
244 if (ret == 2) {
245 strncpy(ev->attr.probe.symbol_name, name, LTTNG_SYMBOL_NAME_LEN);
246 ev->attr.probe.symbol_name[LTTNG_SYMBOL_NAME_LEN - 1] = '\0';
247 DBG("probe symbol %s", ev->attr.probe.symbol_name);
248 if (*s_hex == '\0') {
249 ERR("Invalid probe offset %s", s_hex);
250 ret = -1;
251 goto end;
252 }
253 ev->attr.probe.offset = strtoul(s_hex, NULL, 0);
254 DBG("probe offset %" PRIu64, ev->attr.probe.offset);
255 ev->attr.probe.addr = 0;
256 goto end;
257 }
258
259 /* Check for symbol */
260 if (isalpha(name[0])) {
261 ret = sscanf(opt, "%" LTTNG_SYMBOL_NAME_LEN_SCANF_IS_A_BROKEN_API "s",
262 name);
263 if (ret == 1) {
264 strncpy(ev->attr.probe.symbol_name, name, LTTNG_SYMBOL_NAME_LEN);
265 ev->attr.probe.symbol_name[LTTNG_SYMBOL_NAME_LEN - 1] = '\0';
266 DBG("probe symbol %s", ev->attr.probe.symbol_name);
267 ev->attr.probe.offset = 0;
268 DBG("probe offset %" PRIu64, ev->attr.probe.offset);
269 ev->attr.probe.addr = 0;
270 goto end;
271 }
272 }
273
274 /* Check for address */
275 ret = sscanf(opt, "%" S_HEX_LEN_SCANF_IS_A_BROKEN_API "s", s_hex);
276 if (ret > 0) {
277 if (*s_hex == '\0') {
278 ERR("Invalid probe address %s", s_hex);
279 ret = -1;
280 goto end;
281 }
282 ev->attr.probe.addr = strtoul(s_hex, NULL, 0);
283 DBG("probe addr %" PRIu64, ev->attr.probe.addr);
284 ev->attr.probe.offset = 0;
285 memset(ev->attr.probe.symbol_name, 0, LTTNG_SYMBOL_NAME_LEN);
286 goto end;
287 }
288
289 /* No match */
290 ret = -1;
291
292 end:
293 return ret;
294 }
295
296 /*
297 * Maps JUL loglevel from string to value
298 */
299 static int loglevel_jul_str_to_value(const char *inputstr)
300 {
301 int i = 0;
302 char str[LTTNG_SYMBOL_NAME_LEN];
303
304 /*
305 * Loop up to LTTNG_SYMBOL_NAME_LEN minus one because the NULL bytes is
306 * added at the end of the loop so a the upper bound we avoid the overflow.
307 */
308 while (i < (LTTNG_SYMBOL_NAME_LEN - 1) && inputstr[i] != '\0') {
309 str[i] = toupper(inputstr[i]);
310 i++;
311 }
312 str[i] = '\0';
313
314 if (!strcmp(str, "JUL_OFF") || !strcmp(str, "OFF")) {
315 return LTTNG_LOGLEVEL_JUL_OFF;
316 } else if (!strcmp(str, "JUL_SEVERE") || !strcmp(str, "SEVERE")) {
317 return LTTNG_LOGLEVEL_JUL_SEVERE;
318 } else if (!strcmp(str, "JUL_WARNING") || !strcmp(str, "WARNING")) {
319 return LTTNG_LOGLEVEL_JUL_WARNING;
320 } else if (!strcmp(str, "JUL_INFO") || !strcmp(str, "INFO")) {
321 return LTTNG_LOGLEVEL_JUL_INFO;
322 } else if (!strcmp(str, "JUL_CONFIG") || !strcmp(str, "CONFIG")) {
323 return LTTNG_LOGLEVEL_JUL_CONFIG;
324 } else if (!strcmp(str, "JUL_FINE") || !strcmp(str, "FINE")) {
325 return LTTNG_LOGLEVEL_JUL_FINE;
326 } else if (!strcmp(str, "JUL_FINER") || !strcmp(str, "FINER")) {
327 return LTTNG_LOGLEVEL_JUL_FINER;
328 } else if (!strcmp(str, "JUL_FINEST") || !strcmp(str, "FINEST")) {
329 return LTTNG_LOGLEVEL_JUL_FINEST;
330 } else if (!strcmp(str, "JUL_ALL") || !strcmp(str, "ALL")) {
331 return LTTNG_LOGLEVEL_JUL_ALL;
332 } else {
333 return -1;
334 }
335 }
336
337 /*
338 * Maps loglevel from string to value
339 */
340 static
341 int loglevel_str_to_value(const char *inputstr)
342 {
343 int i = 0;
344 char str[LTTNG_SYMBOL_NAME_LEN];
345
346 /*
347 * Loop up to LTTNG_SYMBOL_NAME_LEN minus one because the NULL bytes is
348 * added at the end of the loop so a the upper bound we avoid the overflow.
349 */
350 while (i < (LTTNG_SYMBOL_NAME_LEN - 1) && inputstr[i] != '\0') {
351 str[i] = toupper(inputstr[i]);
352 i++;
353 }
354 str[i] = '\0';
355 if (!strcmp(str, "TRACE_EMERG") || !strcmp(str, "EMERG")) {
356 return LTTNG_LOGLEVEL_EMERG;
357 } else if (!strcmp(str, "TRACE_ALERT") || !strcmp(str, "ALERT")) {
358 return LTTNG_LOGLEVEL_ALERT;
359 } else if (!strcmp(str, "TRACE_CRIT") || !strcmp(str, "CRIT")) {
360 return LTTNG_LOGLEVEL_CRIT;
361 } else if (!strcmp(str, "TRACE_ERR") || !strcmp(str, "ERR")) {
362 return LTTNG_LOGLEVEL_ERR;
363 } else if (!strcmp(str, "TRACE_WARNING") || !strcmp(str, "WARNING")) {
364 return LTTNG_LOGLEVEL_WARNING;
365 } else if (!strcmp(str, "TRACE_NOTICE") || !strcmp(str, "NOTICE")) {
366 return LTTNG_LOGLEVEL_NOTICE;
367 } else if (!strcmp(str, "TRACE_INFO") || !strcmp(str, "INFO")) {
368 return LTTNG_LOGLEVEL_INFO;
369 } else if (!strcmp(str, "TRACE_DEBUG_SYSTEM") || !strcmp(str, "DEBUG_SYSTEM") || !strcmp(str, "SYSTEM")) {
370 return LTTNG_LOGLEVEL_DEBUG_SYSTEM;
371 } else if (!strcmp(str, "TRACE_DEBUG_PROGRAM") || !strcmp(str, "DEBUG_PROGRAM") || !strcmp(str, "PROGRAM")) {
372 return LTTNG_LOGLEVEL_DEBUG_PROGRAM;
373 } else if (!strcmp(str, "TRACE_DEBUG_PROCESS") || !strcmp(str, "DEBUG_PROCESS") || !strcmp(str, "PROCESS")) {
374 return LTTNG_LOGLEVEL_DEBUG_PROCESS;
375 } else if (!strcmp(str, "TRACE_DEBUG_MODULE") || !strcmp(str, "DEBUG_MODULE") || !strcmp(str, "MODULE")) {
376 return LTTNG_LOGLEVEL_DEBUG_MODULE;
377 } else if (!strcmp(str, "TRACE_DEBUG_UNIT") || !strcmp(str, "DEBUG_UNIT") || !strcmp(str, "UNIT")) {
378 return LTTNG_LOGLEVEL_DEBUG_UNIT;
379 } else if (!strcmp(str, "TRACE_DEBUG_FUNCTION") || !strcmp(str, "DEBUG_FUNCTION") || !strcmp(str, "FUNCTION")) {
380 return LTTNG_LOGLEVEL_DEBUG_FUNCTION;
381 } else if (!strcmp(str, "TRACE_DEBUG_LINE") || !strcmp(str, "DEBUG_LINE") || !strcmp(str, "LINE")) {
382 return LTTNG_LOGLEVEL_DEBUG_LINE;
383 } else if (!strcmp(str, "TRACE_DEBUG") || !strcmp(str, "DEBUG")) {
384 return LTTNG_LOGLEVEL_DEBUG;
385 } else {
386 return -1;
387 }
388 }
389
390 static
391 const char *print_channel_name(const char *name)
392 {
393 return name ? : DEFAULT_CHANNEL_NAME;
394 }
395
396 static
397 const char *print_raw_channel_name(const char *name)
398 {
399 return name ? : "<default>";
400 }
401
402 /*
403 * Return allocated string for pretty-printing exclusion names.
404 */
405 static
406 char *print_exclusions(int count, char **names)
407 {
408 int length = 0;
409 int i;
410 const char *preamble = " excluding ";
411 char *ret;
412
413 if (count == 0) {
414 return strdup("");
415 }
416
417 /* calculate total required length */
418 for (i = 0; i < count; i++) {
419 length += strlen(names[i]) + 1;
420 }
421
422 /* add length of preamble + one for NUL - one for last (missing) comma */
423 length += strlen(preamble);
424 ret = malloc(length);
425 strncpy(ret, preamble, length);
426 for (i = 0; i < count; i++) {
427 strcat(ret, names[i]);
428 if (i != count - 1) {
429 strcat(ret, ",");
430 }
431 }
432 return ret;
433 }
434
435 /*
436 * Compare list of exclusions against an event name.
437 * Return a list of legal exclusion names.
438 * Produce an error or a warning about others (depending on the situation)
439 */
440 static
441 int check_exclusion_subsets(const char *event_name,
442 const char *exclusions,
443 int *exclusion_count_ptr,
444 char ***exclusion_list_ptr)
445 {
446 const char *excluder_ptr;
447 const char *event_ptr;
448 const char *next_excluder;
449 int excluder_length;
450 int exclusion_count = 0;
451 char **exclusion_list = NULL;
452 int ret = CMD_SUCCESS;
453
454 if (event_name[strlen(event_name) - 1] != '*') {
455 ERR("Event %s: Excluders can only be used with wildcarded events", event_name);
456 goto error;
457 }
458
459 next_excluder = exclusions;
460 while (*next_excluder != 0) {
461 event_ptr = event_name;
462 excluder_ptr = next_excluder;
463 excluder_length = strcspn(next_excluder, ",");
464
465 /* Scan both the excluder and the event letter by letter */
466 while (1) {
467 char e, x;
468
469 e = *event_ptr;
470 x = *excluder_ptr;
471
472 if (x == '*') {
473 /* Event is a subset of the excluder */
474 ERR("Event %s: %.*s excludes all events from %s",
475 event_name,
476 excluder_length,
477 next_excluder,
478 event_name);
479 goto error;
480 }
481 if (e == '*') {
482 /* Excluder is a proper subset of event */
483 exclusion_count++;
484 exclusion_list = realloc(exclusion_list, sizeof(char **) * exclusion_count);
485 exclusion_list[exclusion_count - 1] = strndup(next_excluder, excluder_length);
486
487 break;
488 }
489 if (x != e) {
490 /* Excluder and event sets have no common elements */
491 WARN("Event %s: %.*s does not exclude any events from %s",
492 event_name,
493 excluder_length,
494 next_excluder,
495 event_name);
496 break;
497 }
498 excluder_ptr++;
499 event_ptr++;
500 }
501 /* next excluder */
502 next_excluder += excluder_length;
503 if (*next_excluder == ',') {
504 next_excluder++;
505 }
506 }
507 goto end;
508 error:
509 while (exclusion_count--) {
510 free(exclusion_list[exclusion_count]);
511 }
512 if (exclusion_list != NULL) {
513 free(exclusion_list);
514 }
515 exclusion_list = NULL;
516 exclusion_count = 0;
517 ret = CMD_ERROR;
518 end:
519 *exclusion_count_ptr = exclusion_count;
520 *exclusion_list_ptr = exclusion_list;
521 return ret;
522 }
523 /*
524 * Enabling event using the lttng API.
525 */
526 static int enable_events(char *session_name)
527 {
528 int ret = CMD_SUCCESS, warn = 0;
529 char *event_name, *channel_name = NULL;
530 struct lttng_event ev;
531 struct lttng_domain dom;
532 int exclusion_count = 0;
533 char **exclusion_list = NULL;
534
535 memset(&ev, 0, sizeof(ev));
536 memset(&dom, 0, sizeof(dom));
537
538 if (opt_kernel) {
539 if (opt_filter) {
540 ERR("Filter not implement for kernel tracing yet");
541 ret = CMD_ERROR;
542 goto error;
543 }
544 if (opt_loglevel) {
545 WARN("Kernel loglevels are not supported.");
546 }
547 }
548
549 /* Create lttng domain */
550 if (opt_kernel) {
551 dom.type = LTTNG_DOMAIN_KERNEL;
552 dom.buf_type = LTTNG_BUFFER_GLOBAL;
553 } else if (opt_userspace) {
554 dom.type = LTTNG_DOMAIN_UST;
555 /* Default. */
556 dom.buf_type = LTTNG_BUFFER_PER_UID;
557 } else if (opt_jul) {
558 dom.type = LTTNG_DOMAIN_JUL;
559 /* Default. */
560 dom.buf_type = LTTNG_BUFFER_PER_UID;
561 } else {
562 print_missing_domain();
563 ret = CMD_ERROR;
564 goto error;
565 }
566
567 if (opt_kernel && opt_exclude) {
568 ERR("Event name exclusions are not yet implemented for kernel events");
569 ret = CMD_ERROR;
570 goto error;
571 }
572
573 channel_name = opt_channel_name;
574
575 handle = lttng_create_handle(session_name, &dom);
576 if (handle == NULL) {
577 ret = -1;
578 goto error;
579 }
580
581 if (opt_enable_all) {
582 /* Default setup for enable all */
583 if (opt_kernel) {
584 ev.type = opt_event_type;
585 ev.name[0] = '\0';
586 /* kernel loglevels not implemented */
587 ev.loglevel_type = LTTNG_EVENT_LOGLEVEL_ALL;
588 } else {
589 ev.type = LTTNG_EVENT_TRACEPOINT;
590 strcpy(ev.name, "*");
591 ev.loglevel_type = opt_loglevel_type;
592 if (opt_loglevel) {
593 assert(opt_userspace || opt_jul);
594 if (opt_userspace) {
595 ev.loglevel = loglevel_str_to_value(opt_loglevel);
596 } else if (opt_jul) {
597 ev.loglevel = loglevel_jul_str_to_value(opt_loglevel);
598 }
599 if (ev.loglevel == -1) {
600 ERR("Unknown loglevel %s", opt_loglevel);
601 ret = -LTTNG_ERR_INVALID;
602 goto error;
603 }
604 } else {
605 assert(opt_userspace || opt_jul);
606 if (opt_userspace) {
607 ev.loglevel = -1;
608 } else if (opt_jul) {
609 ev.loglevel = LTTNG_LOGLEVEL_JUL_ALL;
610 }
611 }
612 }
613
614 if (opt_exclude) {
615 ret = check_exclusion_subsets("*", opt_exclude,
616 &exclusion_count, &exclusion_list);
617 if (ret == CMD_ERROR) {
618 goto error;
619 }
620 }
621 if (!opt_filter) {
622 ret = lttng_enable_event_with_exclusions(handle,
623 &ev, channel_name,
624 NULL,
625 exclusion_count, exclusion_list);
626 if (ret < 0) {
627 switch (-ret) {
628 case LTTNG_ERR_KERN_EVENT_EXIST:
629 WARN("Kernel events already enabled (channel %s, session %s)",
630 print_channel_name(channel_name), session_name);
631 break;
632 default:
633 ERR("Events: %s (channel %s, session %s)",
634 lttng_strerror(ret),
635 ret == -LTTNG_ERR_NEED_CHANNEL_NAME
636 ? print_raw_channel_name(channel_name)
637 : print_channel_name(channel_name),
638 session_name);
639 break;
640 }
641 goto end;
642 }
643
644 switch (opt_event_type) {
645 case LTTNG_EVENT_TRACEPOINT:
646 if (opt_loglevel && dom.type != LTTNG_DOMAIN_KERNEL) {
647 char *exclusion_string = print_exclusions(exclusion_count, exclusion_list);
648 MSG("All %s tracepoints%s are enabled in channel %s for loglevel %s",
649 get_domain_str(dom.type),
650 exclusion_string,
651 print_channel_name(channel_name),
652 opt_loglevel);
653 free(exclusion_string);
654 } else {
655 char *exclusion_string = print_exclusions(exclusion_count, exclusion_list);
656 MSG("All %s tracepoints%s are enabled in channel %s",
657 get_domain_str(dom.type),
658 exclusion_string,
659 print_channel_name(channel_name));
660 free(exclusion_string);
661 }
662 break;
663 case LTTNG_EVENT_SYSCALL:
664 if (opt_kernel) {
665 MSG("All kernel system calls are enabled in channel %s",
666 print_channel_name(channel_name));
667 }
668 break;
669 case LTTNG_EVENT_ALL:
670 if (opt_loglevel && dom.type != LTTNG_DOMAIN_KERNEL) {
671 char *exclusion_string = print_exclusions(exclusion_count, exclusion_list);
672 MSG("All %s events%s are enabled in channel %s for loglevel %s",
673 get_domain_str(dom.type),
674 exclusion_string,
675 print_channel_name(channel_name),
676 opt_loglevel);
677 free(exclusion_string);
678 } else {
679 char *exclusion_string = print_exclusions(exclusion_count, exclusion_list);
680 MSG("All %s events%s are enabled in channel %s",
681 get_domain_str(dom.type),
682 exclusion_string,
683 print_channel_name(channel_name));
684 free(exclusion_string);
685 }
686 break;
687 default:
688 /*
689 * We should not be here since lttng_enable_event should have
690 * failed on the event type.
691 */
692 goto error;
693 }
694 }
695 if (opt_filter) {
696 ret = lttng_enable_event_with_exclusions(handle, &ev, channel_name,
697 opt_filter, exclusion_count, exclusion_list);
698 if (ret < 0) {
699 switch (-ret) {
700 case LTTNG_ERR_FILTER_EXIST:
701 WARN("Filter on all events is already enabled"
702 " (channel %s, session %s)",
703 print_channel_name(channel_name), session_name);
704 break;
705 default:
706 ERR("All events: %s (channel %s, session %s, filter \'%s\')",
707 lttng_strerror(ret),
708 ret == -LTTNG_ERR_NEED_CHANNEL_NAME
709 ? print_raw_channel_name(channel_name)
710 : print_channel_name(channel_name),
711 session_name, opt_filter);
712 break;
713 }
714 goto error;
715 } else {
716 MSG("Filter '%s' successfully set", opt_filter);
717 }
718 }
719 goto end;
720 }
721
722 /* Strip event list */
723 event_name = strtok(opt_event_list, ",");
724 while (event_name != NULL) {
725 /* Copy name and type of the event */
726 strncpy(ev.name, event_name, LTTNG_SYMBOL_NAME_LEN);
727 ev.name[LTTNG_SYMBOL_NAME_LEN - 1] = '\0';
728 ev.type = opt_event_type;
729
730 /* Kernel tracer action */
731 if (opt_kernel) {
732 DBG("Enabling kernel event %s for channel %s",
733 event_name,
734 print_channel_name(channel_name));
735
736 switch (opt_event_type) {
737 case LTTNG_EVENT_ALL: /* Default behavior is tracepoint */
738 ev.type = LTTNG_EVENT_TRACEPOINT;
739 /* Fall-through */
740 case LTTNG_EVENT_TRACEPOINT:
741 break;
742 case LTTNG_EVENT_PROBE:
743 ret = parse_probe_opts(&ev, opt_probe);
744 if (ret < 0) {
745 ERR("Unable to parse probe options");
746 ret = 0;
747 goto error;
748 }
749 break;
750 case LTTNG_EVENT_FUNCTION:
751 ret = parse_probe_opts(&ev, opt_function);
752 if (ret < 0) {
753 ERR("Unable to parse function probe options");
754 ret = 0;
755 goto error;
756 }
757 break;
758 case LTTNG_EVENT_FUNCTION_ENTRY:
759 strncpy(ev.attr.ftrace.symbol_name, opt_function_entry_symbol,
760 LTTNG_SYMBOL_NAME_LEN);
761 ev.attr.ftrace.symbol_name[LTTNG_SYMBOL_NAME_LEN - 1] = '\0';
762 break;
763 case LTTNG_EVENT_SYSCALL:
764 MSG("per-syscall selection not supported yet. Use \"-a\" "
765 "for all syscalls.");
766 default:
767 ret = CMD_UNDEFINED;
768 goto error;
769 }
770
771 /* kernel loglevels not implemented */
772 ev.loglevel_type = LTTNG_EVENT_LOGLEVEL_ALL;
773 } else if (opt_userspace) { /* User-space tracer action */
774 #if 0
775 if (opt_cmd_name != NULL || opt_pid) {
776 MSG("Only supporting tracing all UST processes (-u) for now.");
777 ret = CMD_UNDEFINED;
778 goto error;
779 }
780 #endif
781
782 DBG("Enabling UST event %s for channel %s, loglevel %s", event_name,
783 print_channel_name(channel_name), opt_loglevel ? : "<all>");
784
785 switch (opt_event_type) {
786 case LTTNG_EVENT_ALL: /* Default behavior is tracepoint */
787 /* Fall-through */
788 case LTTNG_EVENT_TRACEPOINT:
789 /* Copy name and type of the event */
790 ev.type = LTTNG_EVENT_TRACEPOINT;
791 strncpy(ev.name, event_name, LTTNG_SYMBOL_NAME_LEN);
792 ev.name[LTTNG_SYMBOL_NAME_LEN - 1] = '\0';
793 break;
794 case LTTNG_EVENT_PROBE:
795 case LTTNG_EVENT_FUNCTION:
796 case LTTNG_EVENT_FUNCTION_ENTRY:
797 case LTTNG_EVENT_SYSCALL:
798 default:
799 ERR("Event type not available for user-space tracing");
800 ret = CMD_UNSUPPORTED;
801 goto error;
802 }
803
804 if (opt_exclude) {
805 if (opt_event_type != LTTNG_EVENT_ALL && opt_event_type != LTTNG_EVENT_TRACEPOINT) {
806 ERR("Exclusion option can only be used with tracepoint events");
807 ret = CMD_ERROR;
808 goto error;
809 }
810 /* Free previously allocated items */
811 if (exclusion_list != NULL) {
812 while (exclusion_count--) {
813 free(exclusion_list[exclusion_count]);
814 }
815 free(exclusion_list);
816 exclusion_list = NULL;
817 }
818 /* Check for proper subsets */
819 ret = check_exclusion_subsets(event_name, opt_exclude,
820 &exclusion_count, &exclusion_list);
821 if (ret == CMD_ERROR) {
822 goto error;
823 }
824 }
825
826 ev.loglevel_type = opt_loglevel_type;
827 if (opt_loglevel) {
828 ev.loglevel = loglevel_str_to_value(opt_loglevel);
829 if (ev.loglevel == -1) {
830 ERR("Unknown loglevel %s", opt_loglevel);
831 ret = -LTTNG_ERR_INVALID;
832 goto error;
833 }
834 } else {
835 ev.loglevel = -1;
836 }
837 } else if (opt_jul) {
838 if (opt_event_type != LTTNG_EVENT_ALL &&
839 opt_event_type != LTTNG_EVENT_TRACEPOINT) {
840 ERR("Event type not supported for JUL domain.");
841 ret = CMD_UNSUPPORTED;
842 goto error;
843 }
844
845 ev.loglevel_type = opt_loglevel_type;
846 if (opt_loglevel) {
847 ev.loglevel = loglevel_jul_str_to_value(opt_loglevel);
848 if (ev.loglevel == -1) {
849 ERR("Unknown loglevel %s", opt_loglevel);
850 ret = -LTTNG_ERR_INVALID;
851 goto error;
852 }
853 } else {
854 ev.loglevel = LTTNG_LOGLEVEL_JUL_ALL;
855 }
856 ev.type = LTTNG_EVENT_TRACEPOINT;
857 strncpy(ev.name, event_name, LTTNG_SYMBOL_NAME_LEN);
858 ev.name[LTTNG_SYMBOL_NAME_LEN - 1] = '\0';
859 } else {
860 print_missing_domain();
861 ret = CMD_ERROR;
862 goto error;
863 }
864
865 if (!opt_filter) {
866 char *exclusion_string;
867
868 ret = lttng_enable_event_with_exclusions(handle,
869 &ev, channel_name,
870 NULL, exclusion_count, exclusion_list);
871 exclusion_string = print_exclusions(exclusion_count, exclusion_list);
872 if (ret < 0) {
873 /* Turn ret to positive value to handle the positive error code */
874 switch (-ret) {
875 case LTTNG_ERR_KERN_EVENT_EXIST:
876 WARN("Kernel event %s%s already enabled (channel %s, session %s)",
877 event_name,
878 exclusion_string,
879 print_channel_name(channel_name), session_name);
880 break;
881 default:
882 ERR("Event %s%s: %s (channel %s, session %s)", event_name,
883 exclusion_string,
884 lttng_strerror(ret),
885 ret == -LTTNG_ERR_NEED_CHANNEL_NAME
886 ? print_raw_channel_name(channel_name)
887 : print_channel_name(channel_name),
888 session_name);
889 break;
890 }
891 warn = 1;
892 } else {
893 /* So we don't print the default channel name for JUL. */
894 if (dom.type == LTTNG_DOMAIN_JUL) {
895 MSG("%s event %s%s enabled.",
896 get_domain_str(dom.type), event_name,
897 exclusion_string);
898 } else {
899 MSG("%s event %s%s created in channel %s",
900 get_domain_str(dom.type), event_name,
901 exclusion_string,
902 print_channel_name(channel_name));
903 }
904 }
905 free(exclusion_string);
906 }
907
908 if (opt_filter) {
909 char *exclusion_string;
910
911 ret = lttng_enable_event_with_exclusions(handle, &ev, channel_name,
912 opt_filter, exclusion_count, exclusion_list);
913 exclusion_string = print_exclusions(exclusion_count, exclusion_list);
914
915 if (ret < 0) {
916 switch (-ret) {
917 case LTTNG_ERR_FILTER_EXIST:
918 WARN("Filter on event %s%s is already enabled"
919 " (channel %s, session %s)",
920 event_name,
921 exclusion_string,
922 print_channel_name(channel_name), session_name);
923 break;
924 default:
925 ERR("Event %s%s: %s (channel %s, session %s, filter \'%s\')", ev.name,
926 exclusion_string,
927 lttng_strerror(ret),
928 ret == -LTTNG_ERR_NEED_CHANNEL_NAME
929 ? print_raw_channel_name(channel_name)
930 : print_channel_name(channel_name),
931 session_name, opt_filter);
932 break;
933 }
934 free(exclusion_string);
935 goto error;
936 } else {
937 MSG("Event %s%s: Filter '%s' successfully set",
938 event_name, exclusion_string,
939 opt_filter);
940 }
941 free(exclusion_string);
942 }
943
944 /* Next event */
945 event_name = strtok(NULL, ",");
946 }
947
948 end:
949 error:
950 if (warn) {
951 ret = CMD_WARNING;
952 }
953 lttng_destroy_handle(handle);
954
955 if (exclusion_list != NULL) {
956 while (exclusion_count--) {
957 free(exclusion_list[exclusion_count]);
958 }
959 free(exclusion_list);
960 }
961
962 return ret;
963 }
964
965 /*
966 * Add event to trace session
967 */
968 int cmd_enable_events(int argc, const char **argv)
969 {
970 int opt, ret = CMD_SUCCESS;
971 static poptContext pc;
972 char *session_name = NULL;
973 int event_type = -1;
974
975 pc = poptGetContext(NULL, argc, argv, long_options, 0);
976 poptReadDefaultConfig(pc, 0);
977
978 /* TODO: mi support */
979 if (lttng_opt_mi) {
980 ret = -LTTNG_ERR_MI_NOT_IMPLEMENTED;
981 ERR("mi option not supported");
982 goto end;
983 }
984
985 /* Default event type */
986 opt_event_type = LTTNG_EVENT_ALL;
987
988 while ((opt = poptGetNextOpt(pc)) != -1) {
989 switch (opt) {
990 case OPT_HELP:
991 usage(stdout);
992 goto end;
993 case OPT_TRACEPOINT:
994 opt_event_type = LTTNG_EVENT_TRACEPOINT;
995 break;
996 case OPT_PROBE:
997 opt_event_type = LTTNG_EVENT_PROBE;
998 break;
999 case OPT_FUNCTION:
1000 opt_event_type = LTTNG_EVENT_FUNCTION;
1001 break;
1002 case OPT_FUNCTION_ENTRY:
1003 opt_event_type = LTTNG_EVENT_FUNCTION_ENTRY;
1004 break;
1005 case OPT_SYSCALL:
1006 opt_event_type = LTTNG_EVENT_SYSCALL;
1007 break;
1008 case OPT_USERSPACE:
1009 opt_userspace = 1;
1010 break;
1011 case OPT_LOGLEVEL:
1012 opt_loglevel_type = LTTNG_EVENT_LOGLEVEL_RANGE;
1013 opt_loglevel = poptGetOptArg(pc);
1014 break;
1015 case OPT_LOGLEVEL_ONLY:
1016 opt_loglevel_type = LTTNG_EVENT_LOGLEVEL_SINGLE;
1017 opt_loglevel = poptGetOptArg(pc);
1018 break;
1019 case OPT_LIST_OPTIONS:
1020 list_cmd_options(stdout, long_options);
1021 goto end;
1022 case OPT_FILTER:
1023 break;
1024 case OPT_EXCLUDE:
1025 break;
1026 default:
1027 usage(stderr);
1028 ret = CMD_UNDEFINED;
1029 goto end;
1030 }
1031
1032 /* Validate event type. Multiple event type are not supported. */
1033 if (event_type == -1) {
1034 event_type = opt_event_type;
1035 } else {
1036 if (event_type != opt_event_type) {
1037 ERR("Multiple event type not supported.");
1038 ret = CMD_ERROR;
1039 goto end;
1040 }
1041 }
1042 }
1043
1044 opt_event_list = (char*) poptGetArg(pc);
1045 if (opt_event_list == NULL && opt_enable_all == 0) {
1046 ERR("Missing event name(s).\n");
1047 usage(stderr);
1048 ret = CMD_ERROR;
1049 goto end;
1050 }
1051
1052 if (!opt_session_name) {
1053 session_name = get_session_name();
1054 if (session_name == NULL) {
1055 ret = CMD_ERROR;
1056 goto end;
1057 }
1058 } else {
1059 session_name = opt_session_name;
1060 }
1061
1062 ret = enable_events(session_name);
1063
1064 end:
1065 if (opt_session_name == NULL) {
1066 free(session_name);
1067 }
1068
1069 poptFreeContext(pc);
1070 return ret;
1071 }
This page took 0.057507 seconds and 4 git commands to generate.