perf probe: Add perf_probe_event__copy()
[deliverable/linux.git] / tools / perf / util / probe-event.c
1 /*
2 * probe-event.c : perf-probe definition to probe_events format converter
3 *
4 * Written by Masami Hiramatsu <mhiramat@redhat.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 <sys/utsname.h>
23 #include <sys/types.h>
24 #include <sys/stat.h>
25 #include <fcntl.h>
26 #include <errno.h>
27 #include <stdio.h>
28 #include <unistd.h>
29 #include <stdlib.h>
30 #include <string.h>
31 #include <stdarg.h>
32 #include <limits.h>
33 #include <elf.h>
34
35 #include "util.h"
36 #include "event.h"
37 #include "strlist.h"
38 #include "debug.h"
39 #include "cache.h"
40 #include "color.h"
41 #include "symbol.h"
42 #include "thread.h"
43 #include <api/fs/fs.h>
44 #include "trace-event.h" /* For __maybe_unused */
45 #include "probe-event.h"
46 #include "probe-finder.h"
47 #include "probe-file.h"
48 #include "session.h"
49
50 #define MAX_CMDLEN 256
51 #define PERFPROBE_GROUP "probe"
52
53 bool probe_event_dry_run; /* Dry run flag */
54 struct probe_conf probe_conf;
55
56 #define semantic_error(msg ...) pr_err("Semantic error :" msg)
57
58 int e_snprintf(char *str, size_t size, const char *format, ...)
59 {
60 int ret;
61 va_list ap;
62 va_start(ap, format);
63 ret = vsnprintf(str, size, format, ap);
64 va_end(ap);
65 if (ret >= (int)size)
66 ret = -E2BIG;
67 return ret;
68 }
69
70 static char *synthesize_perf_probe_point(struct perf_probe_point *pp);
71 static struct machine *host_machine;
72
73 /* Initialize symbol maps and path of vmlinux/modules */
74 int init_probe_symbol_maps(bool user_only)
75 {
76 int ret;
77
78 symbol_conf.sort_by_name = true;
79 symbol_conf.allow_aliases = true;
80 ret = symbol__init(NULL);
81 if (ret < 0) {
82 pr_debug("Failed to init symbol map.\n");
83 goto out;
84 }
85
86 if (host_machine || user_only) /* already initialized */
87 return 0;
88
89 if (symbol_conf.vmlinux_name)
90 pr_debug("Use vmlinux: %s\n", symbol_conf.vmlinux_name);
91
92 host_machine = machine__new_host();
93 if (!host_machine) {
94 pr_debug("machine__new_host() failed.\n");
95 symbol__exit();
96 ret = -1;
97 }
98 out:
99 if (ret < 0)
100 pr_warning("Failed to init vmlinux path.\n");
101 return ret;
102 }
103
104 void exit_probe_symbol_maps(void)
105 {
106 if (host_machine) {
107 machine__delete(host_machine);
108 host_machine = NULL;
109 }
110 symbol__exit();
111 }
112
113 static struct symbol *__find_kernel_function_by_name(const char *name,
114 struct map **mapp)
115 {
116 return machine__find_kernel_function_by_name(host_machine, name, mapp,
117 NULL);
118 }
119
120 static struct symbol *__find_kernel_function(u64 addr, struct map **mapp)
121 {
122 return machine__find_kernel_function(host_machine, addr, mapp, NULL);
123 }
124
125 static struct ref_reloc_sym *kernel_get_ref_reloc_sym(void)
126 {
127 /* kmap->ref_reloc_sym should be set if host_machine is initialized */
128 struct kmap *kmap;
129 struct map *map = machine__kernel_map(host_machine);
130
131 if (map__load(map, NULL) < 0)
132 return NULL;
133
134 kmap = map__kmap(map);
135 if (!kmap)
136 return NULL;
137 return kmap->ref_reloc_sym;
138 }
139
140 static int kernel_get_symbol_address_by_name(const char *name, u64 *addr,
141 bool reloc, bool reladdr)
142 {
143 struct ref_reloc_sym *reloc_sym;
144 struct symbol *sym;
145 struct map *map;
146
147 /* ref_reloc_sym is just a label. Need a special fix*/
148 reloc_sym = kernel_get_ref_reloc_sym();
149 if (reloc_sym && strcmp(name, reloc_sym->name) == 0)
150 *addr = (reloc) ? reloc_sym->addr : reloc_sym->unrelocated_addr;
151 else {
152 sym = __find_kernel_function_by_name(name, &map);
153 if (!sym)
154 return -ENOENT;
155 *addr = map->unmap_ip(map, sym->start) -
156 ((reloc) ? 0 : map->reloc) -
157 ((reladdr) ? map->start : 0);
158 }
159 return 0;
160 }
161
162 static struct map *kernel_get_module_map(const char *module)
163 {
164 struct map_groups *grp = &host_machine->kmaps;
165 struct maps *maps = &grp->maps[MAP__FUNCTION];
166 struct map *pos;
167
168 /* A file path -- this is an offline module */
169 if (module && strchr(module, '/'))
170 return machine__findnew_module_map(host_machine, 0, module);
171
172 if (!module)
173 module = "kernel";
174
175 for (pos = maps__first(maps); pos; pos = map__next(pos)) {
176 if (strncmp(pos->dso->short_name + 1, module,
177 pos->dso->short_name_len - 2) == 0) {
178 return pos;
179 }
180 }
181 return NULL;
182 }
183
184 static struct map *get_target_map(const char *target, bool user)
185 {
186 /* Init maps of given executable or kernel */
187 if (user)
188 return dso__new_map(target);
189 else
190 return kernel_get_module_map(target);
191 }
192
193 static void put_target_map(struct map *map, bool user)
194 {
195 if (map && user) {
196 /* Only the user map needs to be released */
197 map__put(map);
198 }
199 }
200
201
202 static int convert_exec_to_group(const char *exec, char **result)
203 {
204 char *ptr1, *ptr2, *exec_copy;
205 char buf[64];
206 int ret;
207
208 exec_copy = strdup(exec);
209 if (!exec_copy)
210 return -ENOMEM;
211
212 ptr1 = basename(exec_copy);
213 if (!ptr1) {
214 ret = -EINVAL;
215 goto out;
216 }
217
218 ptr2 = strpbrk(ptr1, "-._");
219 if (ptr2)
220 *ptr2 = '\0';
221 ret = e_snprintf(buf, 64, "%s_%s", PERFPROBE_GROUP, ptr1);
222 if (ret < 0)
223 goto out;
224
225 *result = strdup(buf);
226 ret = *result ? 0 : -ENOMEM;
227
228 out:
229 free(exec_copy);
230 return ret;
231 }
232
233 static void clear_perf_probe_point(struct perf_probe_point *pp)
234 {
235 free(pp->file);
236 free(pp->function);
237 free(pp->lazy_line);
238 }
239
240 static void clear_probe_trace_events(struct probe_trace_event *tevs, int ntevs)
241 {
242 int i;
243
244 for (i = 0; i < ntevs; i++)
245 clear_probe_trace_event(tevs + i);
246 }
247
248 static bool kprobe_blacklist__listed(unsigned long address);
249 static bool kprobe_warn_out_range(const char *symbol, unsigned long address)
250 {
251 u64 etext_addr = 0;
252 int ret;
253
254 /* Get the address of _etext for checking non-probable text symbol */
255 ret = kernel_get_symbol_address_by_name("_etext", &etext_addr,
256 false, false);
257
258 if (ret == 0 && etext_addr < address)
259 pr_warning("%s is out of .text, skip it.\n", symbol);
260 else if (kprobe_blacklist__listed(address))
261 pr_warning("%s is blacklisted function, skip it.\n", symbol);
262 else
263 return false;
264
265 return true;
266 }
267
268 /*
269 * NOTE:
270 * '.gnu.linkonce.this_module' section of kernel module elf directly
271 * maps to 'struct module' from linux/module.h. This section contains
272 * actual module name which will be used by kernel after loading it.
273 * But, we cannot use 'struct module' here since linux/module.h is not
274 * exposed to user-space. Offset of 'name' has remained same from long
275 * time, so hardcoding it here.
276 */
277 #ifdef __LP64__
278 #define MOD_NAME_OFFSET 24
279 #else
280 #define MOD_NAME_OFFSET 12
281 #endif
282
283 /*
284 * @module can be module name of module file path. In case of path,
285 * inspect elf and find out what is actual module name.
286 * Caller has to free mod_name after using it.
287 */
288 static char *find_module_name(const char *module)
289 {
290 int fd;
291 Elf *elf;
292 GElf_Ehdr ehdr;
293 GElf_Shdr shdr;
294 Elf_Data *data;
295 Elf_Scn *sec;
296 char *mod_name = NULL;
297
298 fd = open(module, O_RDONLY);
299 if (fd < 0)
300 return NULL;
301
302 elf = elf_begin(fd, PERF_ELF_C_READ_MMAP, NULL);
303 if (elf == NULL)
304 goto elf_err;
305
306 if (gelf_getehdr(elf, &ehdr) == NULL)
307 goto ret_err;
308
309 sec = elf_section_by_name(elf, &ehdr, &shdr,
310 ".gnu.linkonce.this_module", NULL);
311 if (!sec)
312 goto ret_err;
313
314 data = elf_getdata(sec, NULL);
315 if (!data || !data->d_buf)
316 goto ret_err;
317
318 mod_name = strdup((char *)data->d_buf + MOD_NAME_OFFSET);
319
320 ret_err:
321 elf_end(elf);
322 elf_err:
323 close(fd);
324 return mod_name;
325 }
326
327 #ifdef HAVE_DWARF_SUPPORT
328
329 static int kernel_get_module_dso(const char *module, struct dso **pdso)
330 {
331 struct dso *dso;
332 struct map *map;
333 const char *vmlinux_name;
334 int ret = 0;
335
336 if (module) {
337 char module_name[128];
338
339 snprintf(module_name, sizeof(module_name), "[%s]", module);
340 map = map_groups__find_by_name(&host_machine->kmaps, MAP__FUNCTION, module_name);
341 if (map) {
342 dso = map->dso;
343 goto found;
344 }
345 pr_debug("Failed to find module %s.\n", module);
346 return -ENOENT;
347 }
348
349 map = machine__kernel_map(host_machine);
350 dso = map->dso;
351
352 vmlinux_name = symbol_conf.vmlinux_name;
353 dso->load_errno = 0;
354 if (vmlinux_name)
355 ret = dso__load_vmlinux(dso, map, vmlinux_name, false, NULL);
356 else
357 ret = dso__load_vmlinux_path(dso, map, NULL);
358 found:
359 *pdso = dso;
360 return ret;
361 }
362
363 /*
364 * Some binaries like glibc have special symbols which are on the symbol
365 * table, but not in the debuginfo. If we can find the address of the
366 * symbol from map, we can translate the address back to the probe point.
367 */
368 static int find_alternative_probe_point(struct debuginfo *dinfo,
369 struct perf_probe_point *pp,
370 struct perf_probe_point *result,
371 const char *target, bool uprobes)
372 {
373 struct map *map = NULL;
374 struct symbol *sym;
375 u64 address = 0;
376 int ret = -ENOENT;
377
378 /* This can work only for function-name based one */
379 if (!pp->function || pp->file)
380 return -ENOTSUP;
381
382 map = get_target_map(target, uprobes);
383 if (!map)
384 return -EINVAL;
385
386 /* Find the address of given function */
387 map__for_each_symbol_by_name(map, pp->function, sym) {
388 if (uprobes)
389 address = sym->start;
390 else
391 address = map->unmap_ip(map, sym->start);
392 break;
393 }
394 if (!address) {
395 ret = -ENOENT;
396 goto out;
397 }
398 pr_debug("Symbol %s address found : %" PRIx64 "\n",
399 pp->function, address);
400
401 ret = debuginfo__find_probe_point(dinfo, (unsigned long)address,
402 result);
403 if (ret <= 0)
404 ret = (!ret) ? -ENOENT : ret;
405 else {
406 result->offset += pp->offset;
407 result->line += pp->line;
408 result->retprobe = pp->retprobe;
409 ret = 0;
410 }
411
412 out:
413 put_target_map(map, uprobes);
414 return ret;
415
416 }
417
418 static int get_alternative_probe_event(struct debuginfo *dinfo,
419 struct perf_probe_event *pev,
420 struct perf_probe_point *tmp)
421 {
422 int ret;
423
424 memcpy(tmp, &pev->point, sizeof(*tmp));
425 memset(&pev->point, 0, sizeof(pev->point));
426 ret = find_alternative_probe_point(dinfo, tmp, &pev->point,
427 pev->target, pev->uprobes);
428 if (ret < 0)
429 memcpy(&pev->point, tmp, sizeof(*tmp));
430
431 return ret;
432 }
433
434 static int get_alternative_line_range(struct debuginfo *dinfo,
435 struct line_range *lr,
436 const char *target, bool user)
437 {
438 struct perf_probe_point pp = { .function = lr->function,
439 .file = lr->file,
440 .line = lr->start };
441 struct perf_probe_point result;
442 int ret, len = 0;
443
444 memset(&result, 0, sizeof(result));
445
446 if (lr->end != INT_MAX)
447 len = lr->end - lr->start;
448 ret = find_alternative_probe_point(dinfo, &pp, &result,
449 target, user);
450 if (!ret) {
451 lr->function = result.function;
452 lr->file = result.file;
453 lr->start = result.line;
454 if (lr->end != INT_MAX)
455 lr->end = lr->start + len;
456 clear_perf_probe_point(&pp);
457 }
458 return ret;
459 }
460
461 /* Open new debuginfo of given module */
462 static struct debuginfo *open_debuginfo(const char *module, bool silent)
463 {
464 const char *path = module;
465 char reason[STRERR_BUFSIZE];
466 struct debuginfo *ret = NULL;
467 struct dso *dso = NULL;
468 int err;
469
470 if (!module || !strchr(module, '/')) {
471 err = kernel_get_module_dso(module, &dso);
472 if (err < 0) {
473 if (!dso || dso->load_errno == 0) {
474 if (!strerror_r(-err, reason, STRERR_BUFSIZE))
475 strcpy(reason, "(unknown)");
476 } else
477 dso__strerror_load(dso, reason, STRERR_BUFSIZE);
478 if (!silent)
479 pr_err("Failed to find the path for %s: %s\n",
480 module ?: "kernel", reason);
481 return NULL;
482 }
483 path = dso->long_name;
484 }
485 ret = debuginfo__new(path);
486 if (!ret && !silent) {
487 pr_warning("The %s file has no debug information.\n", path);
488 if (!module || !strtailcmp(path, ".ko"))
489 pr_warning("Rebuild with CONFIG_DEBUG_INFO=y, ");
490 else
491 pr_warning("Rebuild with -g, ");
492 pr_warning("or install an appropriate debuginfo package.\n");
493 }
494 return ret;
495 }
496
497 /* For caching the last debuginfo */
498 static struct debuginfo *debuginfo_cache;
499 static char *debuginfo_cache_path;
500
501 static struct debuginfo *debuginfo_cache__open(const char *module, bool silent)
502 {
503 const char *path = module;
504
505 /* If the module is NULL, it should be the kernel. */
506 if (!module)
507 path = "kernel";
508
509 if (debuginfo_cache_path && !strcmp(debuginfo_cache_path, path))
510 goto out;
511
512 /* Copy module path */
513 free(debuginfo_cache_path);
514 debuginfo_cache_path = strdup(path);
515 if (!debuginfo_cache_path) {
516 debuginfo__delete(debuginfo_cache);
517 debuginfo_cache = NULL;
518 goto out;
519 }
520
521 debuginfo_cache = open_debuginfo(module, silent);
522 if (!debuginfo_cache)
523 zfree(&debuginfo_cache_path);
524 out:
525 return debuginfo_cache;
526 }
527
528 static void debuginfo_cache__exit(void)
529 {
530 debuginfo__delete(debuginfo_cache);
531 debuginfo_cache = NULL;
532 zfree(&debuginfo_cache_path);
533 }
534
535
536 static int get_text_start_address(const char *exec, unsigned long *address)
537 {
538 Elf *elf;
539 GElf_Ehdr ehdr;
540 GElf_Shdr shdr;
541 int fd, ret = -ENOENT;
542
543 fd = open(exec, O_RDONLY);
544 if (fd < 0)
545 return -errno;
546
547 elf = elf_begin(fd, PERF_ELF_C_READ_MMAP, NULL);
548 if (elf == NULL) {
549 ret = -EINVAL;
550 goto out_close;
551 }
552
553 if (gelf_getehdr(elf, &ehdr) == NULL)
554 goto out;
555
556 if (!elf_section_by_name(elf, &ehdr, &shdr, ".text", NULL))
557 goto out;
558
559 *address = shdr.sh_addr - shdr.sh_offset;
560 ret = 0;
561 out:
562 elf_end(elf);
563 out_close:
564 close(fd);
565
566 return ret;
567 }
568
569 /*
570 * Convert trace point to probe point with debuginfo
571 */
572 static int find_perf_probe_point_from_dwarf(struct probe_trace_point *tp,
573 struct perf_probe_point *pp,
574 bool is_kprobe)
575 {
576 struct debuginfo *dinfo = NULL;
577 unsigned long stext = 0;
578 u64 addr = tp->address;
579 int ret = -ENOENT;
580
581 /* convert the address to dwarf address */
582 if (!is_kprobe) {
583 if (!addr) {
584 ret = -EINVAL;
585 goto error;
586 }
587 ret = get_text_start_address(tp->module, &stext);
588 if (ret < 0)
589 goto error;
590 addr += stext;
591 } else if (tp->symbol) {
592 /* If the module is given, this returns relative address */
593 ret = kernel_get_symbol_address_by_name(tp->symbol, &addr,
594 false, !!tp->module);
595 if (ret != 0)
596 goto error;
597 addr += tp->offset;
598 }
599
600 pr_debug("try to find information at %" PRIx64 " in %s\n", addr,
601 tp->module ? : "kernel");
602
603 dinfo = debuginfo_cache__open(tp->module, verbose == 0);
604 if (dinfo)
605 ret = debuginfo__find_probe_point(dinfo,
606 (unsigned long)addr, pp);
607 else
608 ret = -ENOENT;
609
610 if (ret > 0) {
611 pp->retprobe = tp->retprobe;
612 return 0;
613 }
614 error:
615 pr_debug("Failed to find corresponding probes from debuginfo.\n");
616 return ret ? : -ENOENT;
617 }
618
619 static int add_exec_to_probe_trace_events(struct probe_trace_event *tevs,
620 int ntevs, const char *exec)
621 {
622 int i, ret = 0;
623 unsigned long stext = 0;
624
625 if (!exec)
626 return 0;
627
628 ret = get_text_start_address(exec, &stext);
629 if (ret < 0)
630 return ret;
631
632 for (i = 0; i < ntevs && ret >= 0; i++) {
633 /* point.address is the addres of point.symbol + point.offset */
634 tevs[i].point.address -= stext;
635 tevs[i].point.module = strdup(exec);
636 if (!tevs[i].point.module) {
637 ret = -ENOMEM;
638 break;
639 }
640 tevs[i].uprobes = true;
641 }
642
643 return ret;
644 }
645
646 static int add_module_to_probe_trace_events(struct probe_trace_event *tevs,
647 int ntevs, const char *module)
648 {
649 int i, ret = 0;
650 char *mod_name = NULL;
651
652 if (!module)
653 return 0;
654
655 mod_name = find_module_name(module);
656
657 for (i = 0; i < ntevs; i++) {
658 tevs[i].point.module =
659 strdup(mod_name ? mod_name : module);
660 if (!tevs[i].point.module) {
661 ret = -ENOMEM;
662 break;
663 }
664 }
665
666 free(mod_name);
667 return ret;
668 }
669
670 /* Post processing the probe events */
671 static int post_process_probe_trace_events(struct probe_trace_event *tevs,
672 int ntevs, const char *module,
673 bool uprobe)
674 {
675 struct ref_reloc_sym *reloc_sym;
676 char *tmp;
677 int i, skipped = 0;
678
679 if (uprobe)
680 return add_exec_to_probe_trace_events(tevs, ntevs, module);
681
682 /* Note that currently ref_reloc_sym based probe is not for drivers */
683 if (module)
684 return add_module_to_probe_trace_events(tevs, ntevs, module);
685
686 reloc_sym = kernel_get_ref_reloc_sym();
687 if (!reloc_sym) {
688 pr_warning("Relocated base symbol is not found!\n");
689 return -EINVAL;
690 }
691
692 for (i = 0; i < ntevs; i++) {
693 if (!tevs[i].point.address || tevs[i].point.retprobe)
694 continue;
695 /* If we found a wrong one, mark it by NULL symbol */
696 if (kprobe_warn_out_range(tevs[i].point.symbol,
697 tevs[i].point.address)) {
698 tmp = NULL;
699 skipped++;
700 } else {
701 tmp = strdup(reloc_sym->name);
702 if (!tmp)
703 return -ENOMEM;
704 }
705 /* If we have no realname, use symbol for it */
706 if (!tevs[i].point.realname)
707 tevs[i].point.realname = tevs[i].point.symbol;
708 else
709 free(tevs[i].point.symbol);
710 tevs[i].point.symbol = tmp;
711 tevs[i].point.offset = tevs[i].point.address -
712 reloc_sym->unrelocated_addr;
713 }
714 return skipped;
715 }
716
717 /* Try to find perf_probe_event with debuginfo */
718 static int try_to_find_probe_trace_events(struct perf_probe_event *pev,
719 struct probe_trace_event **tevs)
720 {
721 bool need_dwarf = perf_probe_event_need_dwarf(pev);
722 struct perf_probe_point tmp;
723 struct debuginfo *dinfo;
724 int ntevs, ret = 0;
725
726 dinfo = open_debuginfo(pev->target, !need_dwarf);
727 if (!dinfo) {
728 if (need_dwarf)
729 return -ENOENT;
730 pr_debug("Could not open debuginfo. Try to use symbols.\n");
731 return 0;
732 }
733
734 pr_debug("Try to find probe point from debuginfo.\n");
735 /* Searching trace events corresponding to a probe event */
736 ntevs = debuginfo__find_trace_events(dinfo, pev, tevs);
737
738 if (ntevs == 0) { /* Not found, retry with an alternative */
739 ret = get_alternative_probe_event(dinfo, pev, &tmp);
740 if (!ret) {
741 ntevs = debuginfo__find_trace_events(dinfo, pev, tevs);
742 /*
743 * Write back to the original probe_event for
744 * setting appropriate (user given) event name
745 */
746 clear_perf_probe_point(&pev->point);
747 memcpy(&pev->point, &tmp, sizeof(tmp));
748 }
749 }
750
751 debuginfo__delete(dinfo);
752
753 if (ntevs > 0) { /* Succeeded to find trace events */
754 pr_debug("Found %d probe_trace_events.\n", ntevs);
755 ret = post_process_probe_trace_events(*tevs, ntevs,
756 pev->target, pev->uprobes);
757 if (ret < 0 || ret == ntevs) {
758 clear_probe_trace_events(*tevs, ntevs);
759 zfree(tevs);
760 }
761 if (ret != ntevs)
762 return ret < 0 ? ret : ntevs;
763 ntevs = 0;
764 /* Fall through */
765 }
766
767 if (ntevs == 0) { /* No error but failed to find probe point. */
768 pr_warning("Probe point '%s' not found.\n",
769 synthesize_perf_probe_point(&pev->point));
770 return -ENOENT;
771 }
772 /* Error path : ntevs < 0 */
773 pr_debug("An error occurred in debuginfo analysis (%d).\n", ntevs);
774 if (ntevs < 0) {
775 if (ntevs == -EBADF)
776 pr_warning("Warning: No dwarf info found in the vmlinux - "
777 "please rebuild kernel with CONFIG_DEBUG_INFO=y.\n");
778 if (!need_dwarf) {
779 pr_debug("Trying to use symbols.\n");
780 return 0;
781 }
782 }
783 return ntevs;
784 }
785
786 #define LINEBUF_SIZE 256
787 #define NR_ADDITIONAL_LINES 2
788
789 static int __show_one_line(FILE *fp, int l, bool skip, bool show_num)
790 {
791 char buf[LINEBUF_SIZE], sbuf[STRERR_BUFSIZE];
792 const char *color = show_num ? "" : PERF_COLOR_BLUE;
793 const char *prefix = NULL;
794
795 do {
796 if (fgets(buf, LINEBUF_SIZE, fp) == NULL)
797 goto error;
798 if (skip)
799 continue;
800 if (!prefix) {
801 prefix = show_num ? "%7d " : " ";
802 color_fprintf(stdout, color, prefix, l);
803 }
804 color_fprintf(stdout, color, "%s", buf);
805
806 } while (strchr(buf, '\n') == NULL);
807
808 return 1;
809 error:
810 if (ferror(fp)) {
811 pr_warning("File read error: %s\n",
812 strerror_r(errno, sbuf, sizeof(sbuf)));
813 return -1;
814 }
815 return 0;
816 }
817
818 static int _show_one_line(FILE *fp, int l, bool skip, bool show_num)
819 {
820 int rv = __show_one_line(fp, l, skip, show_num);
821 if (rv == 0) {
822 pr_warning("Source file is shorter than expected.\n");
823 rv = -1;
824 }
825 return rv;
826 }
827
828 #define show_one_line_with_num(f,l) _show_one_line(f,l,false,true)
829 #define show_one_line(f,l) _show_one_line(f,l,false,false)
830 #define skip_one_line(f,l) _show_one_line(f,l,true,false)
831 #define show_one_line_or_eof(f,l) __show_one_line(f,l,false,false)
832
833 /*
834 * Show line-range always requires debuginfo to find source file and
835 * line number.
836 */
837 static int __show_line_range(struct line_range *lr, const char *module,
838 bool user)
839 {
840 int l = 1;
841 struct int_node *ln;
842 struct debuginfo *dinfo;
843 FILE *fp;
844 int ret;
845 char *tmp;
846 char sbuf[STRERR_BUFSIZE];
847
848 /* Search a line range */
849 dinfo = open_debuginfo(module, false);
850 if (!dinfo)
851 return -ENOENT;
852
853 ret = debuginfo__find_line_range(dinfo, lr);
854 if (!ret) { /* Not found, retry with an alternative */
855 ret = get_alternative_line_range(dinfo, lr, module, user);
856 if (!ret)
857 ret = debuginfo__find_line_range(dinfo, lr);
858 }
859 debuginfo__delete(dinfo);
860 if (ret == 0 || ret == -ENOENT) {
861 pr_warning("Specified source line is not found.\n");
862 return -ENOENT;
863 } else if (ret < 0) {
864 pr_warning("Debuginfo analysis failed.\n");
865 return ret;
866 }
867
868 /* Convert source file path */
869 tmp = lr->path;
870 ret = get_real_path(tmp, lr->comp_dir, &lr->path);
871
872 /* Free old path when new path is assigned */
873 if (tmp != lr->path)
874 free(tmp);
875
876 if (ret < 0) {
877 pr_warning("Failed to find source file path.\n");
878 return ret;
879 }
880
881 setup_pager();
882
883 if (lr->function)
884 fprintf(stdout, "<%s@%s:%d>\n", lr->function, lr->path,
885 lr->start - lr->offset);
886 else
887 fprintf(stdout, "<%s:%d>\n", lr->path, lr->start);
888
889 fp = fopen(lr->path, "r");
890 if (fp == NULL) {
891 pr_warning("Failed to open %s: %s\n", lr->path,
892 strerror_r(errno, sbuf, sizeof(sbuf)));
893 return -errno;
894 }
895 /* Skip to starting line number */
896 while (l < lr->start) {
897 ret = skip_one_line(fp, l++);
898 if (ret < 0)
899 goto end;
900 }
901
902 intlist__for_each(ln, lr->line_list) {
903 for (; ln->i > l; l++) {
904 ret = show_one_line(fp, l - lr->offset);
905 if (ret < 0)
906 goto end;
907 }
908 ret = show_one_line_with_num(fp, l++ - lr->offset);
909 if (ret < 0)
910 goto end;
911 }
912
913 if (lr->end == INT_MAX)
914 lr->end = l + NR_ADDITIONAL_LINES;
915 while (l <= lr->end) {
916 ret = show_one_line_or_eof(fp, l++ - lr->offset);
917 if (ret <= 0)
918 break;
919 }
920 end:
921 fclose(fp);
922 return ret;
923 }
924
925 int show_line_range(struct line_range *lr, const char *module, bool user)
926 {
927 int ret;
928
929 ret = init_probe_symbol_maps(user);
930 if (ret < 0)
931 return ret;
932 ret = __show_line_range(lr, module, user);
933 exit_probe_symbol_maps();
934
935 return ret;
936 }
937
938 static int show_available_vars_at(struct debuginfo *dinfo,
939 struct perf_probe_event *pev,
940 struct strfilter *_filter)
941 {
942 char *buf;
943 int ret, i, nvars;
944 struct str_node *node;
945 struct variable_list *vls = NULL, *vl;
946 struct perf_probe_point tmp;
947 const char *var;
948
949 buf = synthesize_perf_probe_point(&pev->point);
950 if (!buf)
951 return -EINVAL;
952 pr_debug("Searching variables at %s\n", buf);
953
954 ret = debuginfo__find_available_vars_at(dinfo, pev, &vls);
955 if (!ret) { /* Not found, retry with an alternative */
956 ret = get_alternative_probe_event(dinfo, pev, &tmp);
957 if (!ret) {
958 ret = debuginfo__find_available_vars_at(dinfo, pev,
959 &vls);
960 /* Release the old probe_point */
961 clear_perf_probe_point(&tmp);
962 }
963 }
964 if (ret <= 0) {
965 if (ret == 0 || ret == -ENOENT) {
966 pr_err("Failed to find the address of %s\n", buf);
967 ret = -ENOENT;
968 } else
969 pr_warning("Debuginfo analysis failed.\n");
970 goto end;
971 }
972
973 /* Some variables are found */
974 fprintf(stdout, "Available variables at %s\n", buf);
975 for (i = 0; i < ret; i++) {
976 vl = &vls[i];
977 /*
978 * A probe point might be converted to
979 * several trace points.
980 */
981 fprintf(stdout, "\t@<%s+%lu>\n", vl->point.symbol,
982 vl->point.offset);
983 zfree(&vl->point.symbol);
984 nvars = 0;
985 if (vl->vars) {
986 strlist__for_each(node, vl->vars) {
987 var = strchr(node->s, '\t') + 1;
988 if (strfilter__compare(_filter, var)) {
989 fprintf(stdout, "\t\t%s\n", node->s);
990 nvars++;
991 }
992 }
993 strlist__delete(vl->vars);
994 }
995 if (nvars == 0)
996 fprintf(stdout, "\t\t(No matched variables)\n");
997 }
998 free(vls);
999 end:
1000 free(buf);
1001 return ret;
1002 }
1003
1004 /* Show available variables on given probe point */
1005 int show_available_vars(struct perf_probe_event *pevs, int npevs,
1006 struct strfilter *_filter)
1007 {
1008 int i, ret = 0;
1009 struct debuginfo *dinfo;
1010
1011 ret = init_probe_symbol_maps(pevs->uprobes);
1012 if (ret < 0)
1013 return ret;
1014
1015 dinfo = open_debuginfo(pevs->target, false);
1016 if (!dinfo) {
1017 ret = -ENOENT;
1018 goto out;
1019 }
1020
1021 setup_pager();
1022
1023 for (i = 0; i < npevs && ret >= 0; i++)
1024 ret = show_available_vars_at(dinfo, &pevs[i], _filter);
1025
1026 debuginfo__delete(dinfo);
1027 out:
1028 exit_probe_symbol_maps();
1029 return ret;
1030 }
1031
1032 #else /* !HAVE_DWARF_SUPPORT */
1033
1034 static void debuginfo_cache__exit(void)
1035 {
1036 }
1037
1038 static int
1039 find_perf_probe_point_from_dwarf(struct probe_trace_point *tp __maybe_unused,
1040 struct perf_probe_point *pp __maybe_unused,
1041 bool is_kprobe __maybe_unused)
1042 {
1043 return -ENOSYS;
1044 }
1045
1046 static int try_to_find_probe_trace_events(struct perf_probe_event *pev,
1047 struct probe_trace_event **tevs __maybe_unused)
1048 {
1049 if (perf_probe_event_need_dwarf(pev)) {
1050 pr_warning("Debuginfo-analysis is not supported.\n");
1051 return -ENOSYS;
1052 }
1053
1054 return 0;
1055 }
1056
1057 int show_line_range(struct line_range *lr __maybe_unused,
1058 const char *module __maybe_unused,
1059 bool user __maybe_unused)
1060 {
1061 pr_warning("Debuginfo-analysis is not supported.\n");
1062 return -ENOSYS;
1063 }
1064
1065 int show_available_vars(struct perf_probe_event *pevs __maybe_unused,
1066 int npevs __maybe_unused,
1067 struct strfilter *filter __maybe_unused)
1068 {
1069 pr_warning("Debuginfo-analysis is not supported.\n");
1070 return -ENOSYS;
1071 }
1072 #endif
1073
1074 void line_range__clear(struct line_range *lr)
1075 {
1076 free(lr->function);
1077 free(lr->file);
1078 free(lr->path);
1079 free(lr->comp_dir);
1080 intlist__delete(lr->line_list);
1081 memset(lr, 0, sizeof(*lr));
1082 }
1083
1084 int line_range__init(struct line_range *lr)
1085 {
1086 memset(lr, 0, sizeof(*lr));
1087 lr->line_list = intlist__new(NULL);
1088 if (!lr->line_list)
1089 return -ENOMEM;
1090 else
1091 return 0;
1092 }
1093
1094 static int parse_line_num(char **ptr, int *val, const char *what)
1095 {
1096 const char *start = *ptr;
1097
1098 errno = 0;
1099 *val = strtol(*ptr, ptr, 0);
1100 if (errno || *ptr == start) {
1101 semantic_error("'%s' is not a valid number.\n", what);
1102 return -EINVAL;
1103 }
1104 return 0;
1105 }
1106
1107 /* Check the name is good for event, group or function */
1108 static bool is_c_func_name(const char *name)
1109 {
1110 if (!isalpha(*name) && *name != '_')
1111 return false;
1112 while (*++name != '\0') {
1113 if (!isalpha(*name) && !isdigit(*name) && *name != '_')
1114 return false;
1115 }
1116 return true;
1117 }
1118
1119 /*
1120 * Stuff 'lr' according to the line range described by 'arg'.
1121 * The line range syntax is described by:
1122 *
1123 * SRC[:SLN[+NUM|-ELN]]
1124 * FNC[@SRC][:SLN[+NUM|-ELN]]
1125 */
1126 int parse_line_range_desc(const char *arg, struct line_range *lr)
1127 {
1128 char *range, *file, *name = strdup(arg);
1129 int err;
1130
1131 if (!name)
1132 return -ENOMEM;
1133
1134 lr->start = 0;
1135 lr->end = INT_MAX;
1136
1137 range = strchr(name, ':');
1138 if (range) {
1139 *range++ = '\0';
1140
1141 err = parse_line_num(&range, &lr->start, "start line");
1142 if (err)
1143 goto err;
1144
1145 if (*range == '+' || *range == '-') {
1146 const char c = *range++;
1147
1148 err = parse_line_num(&range, &lr->end, "end line");
1149 if (err)
1150 goto err;
1151
1152 if (c == '+') {
1153 lr->end += lr->start;
1154 /*
1155 * Adjust the number of lines here.
1156 * If the number of lines == 1, the
1157 * the end of line should be equal to
1158 * the start of line.
1159 */
1160 lr->end--;
1161 }
1162 }
1163
1164 pr_debug("Line range is %d to %d\n", lr->start, lr->end);
1165
1166 err = -EINVAL;
1167 if (lr->start > lr->end) {
1168 semantic_error("Start line must be smaller"
1169 " than end line.\n");
1170 goto err;
1171 }
1172 if (*range != '\0') {
1173 semantic_error("Tailing with invalid str '%s'.\n", range);
1174 goto err;
1175 }
1176 }
1177
1178 file = strchr(name, '@');
1179 if (file) {
1180 *file = '\0';
1181 lr->file = strdup(++file);
1182 if (lr->file == NULL) {
1183 err = -ENOMEM;
1184 goto err;
1185 }
1186 lr->function = name;
1187 } else if (strchr(name, '/') || strchr(name, '.'))
1188 lr->file = name;
1189 else if (is_c_func_name(name))/* We reuse it for checking funcname */
1190 lr->function = name;
1191 else { /* Invalid name */
1192 semantic_error("'%s' is not a valid function name.\n", name);
1193 err = -EINVAL;
1194 goto err;
1195 }
1196
1197 return 0;
1198 err:
1199 free(name);
1200 return err;
1201 }
1202
1203 /* Parse probepoint definition. */
1204 static int parse_perf_probe_point(char *arg, struct perf_probe_event *pev)
1205 {
1206 struct perf_probe_point *pp = &pev->point;
1207 char *ptr, *tmp;
1208 char c, nc = 0;
1209 bool file_spec = false;
1210 /*
1211 * <Syntax>
1212 * perf probe [EVENT=]SRC[:LN|;PTN]
1213 * perf probe [EVENT=]FUNC[@SRC][+OFFS|%return|:LN|;PAT]
1214 *
1215 * TODO:Group name support
1216 */
1217 if (!arg)
1218 return -EINVAL;
1219
1220 ptr = strpbrk(arg, ";=@+%");
1221 if (ptr && *ptr == '=') { /* Event name */
1222 *ptr = '\0';
1223 tmp = ptr + 1;
1224 if (strchr(arg, ':')) {
1225 semantic_error("Group name is not supported yet.\n");
1226 return -ENOTSUP;
1227 }
1228 if (!is_c_func_name(arg)) {
1229 semantic_error("%s is bad for event name -it must "
1230 "follow C symbol-naming rule.\n", arg);
1231 return -EINVAL;
1232 }
1233 pev->event = strdup(arg);
1234 if (pev->event == NULL)
1235 return -ENOMEM;
1236 pev->group = NULL;
1237 arg = tmp;
1238 }
1239
1240 /*
1241 * Check arg is function or file name and copy it.
1242 *
1243 * We consider arg to be a file spec if and only if it satisfies
1244 * all of the below criteria::
1245 * - it does not include any of "+@%",
1246 * - it includes one of ":;", and
1247 * - it has a period '.' in the name.
1248 *
1249 * Otherwise, we consider arg to be a function specification.
1250 */
1251 if (!strpbrk(arg, "+@%") && (ptr = strpbrk(arg, ";:")) != NULL) {
1252 /* This is a file spec if it includes a '.' before ; or : */
1253 if (memchr(arg, '.', ptr - arg))
1254 file_spec = true;
1255 }
1256
1257 ptr = strpbrk(arg, ";:+@%");
1258 if (ptr) {
1259 nc = *ptr;
1260 *ptr++ = '\0';
1261 }
1262
1263 if (arg[0] == '\0')
1264 tmp = NULL;
1265 else {
1266 tmp = strdup(arg);
1267 if (tmp == NULL)
1268 return -ENOMEM;
1269 }
1270
1271 if (file_spec)
1272 pp->file = tmp;
1273 else {
1274 pp->function = tmp;
1275
1276 /*
1277 * Keep pp->function even if this is absolute address,
1278 * so it can mark whether abs_address is valid.
1279 * Which make 'perf probe lib.bin 0x0' possible.
1280 *
1281 * Note that checking length of tmp is not needed
1282 * because when we access tmp[1] we know tmp[0] is '0',
1283 * so tmp[1] should always valid (but could be '\0').
1284 */
1285 if (tmp && !strncmp(tmp, "0x", 2)) {
1286 pp->abs_address = strtoul(pp->function, &tmp, 0);
1287 if (*tmp != '\0') {
1288 semantic_error("Invalid absolute address.\n");
1289 return -EINVAL;
1290 }
1291 }
1292 }
1293
1294 /* Parse other options */
1295 while (ptr) {
1296 arg = ptr;
1297 c = nc;
1298 if (c == ';') { /* Lazy pattern must be the last part */
1299 pp->lazy_line = strdup(arg);
1300 if (pp->lazy_line == NULL)
1301 return -ENOMEM;
1302 break;
1303 }
1304 ptr = strpbrk(arg, ";:+@%");
1305 if (ptr) {
1306 nc = *ptr;
1307 *ptr++ = '\0';
1308 }
1309 switch (c) {
1310 case ':': /* Line number */
1311 pp->line = strtoul(arg, &tmp, 0);
1312 if (*tmp != '\0') {
1313 semantic_error("There is non-digit char"
1314 " in line number.\n");
1315 return -EINVAL;
1316 }
1317 break;
1318 case '+': /* Byte offset from a symbol */
1319 pp->offset = strtoul(arg, &tmp, 0);
1320 if (*tmp != '\0') {
1321 semantic_error("There is non-digit character"
1322 " in offset.\n");
1323 return -EINVAL;
1324 }
1325 break;
1326 case '@': /* File name */
1327 if (pp->file) {
1328 semantic_error("SRC@SRC is not allowed.\n");
1329 return -EINVAL;
1330 }
1331 pp->file = strdup(arg);
1332 if (pp->file == NULL)
1333 return -ENOMEM;
1334 break;
1335 case '%': /* Probe places */
1336 if (strcmp(arg, "return") == 0) {
1337 pp->retprobe = 1;
1338 } else { /* Others not supported yet */
1339 semantic_error("%%%s is not supported.\n", arg);
1340 return -ENOTSUP;
1341 }
1342 break;
1343 default: /* Buggy case */
1344 pr_err("This program has a bug at %s:%d.\n",
1345 __FILE__, __LINE__);
1346 return -ENOTSUP;
1347 break;
1348 }
1349 }
1350
1351 /* Exclusion check */
1352 if (pp->lazy_line && pp->line) {
1353 semantic_error("Lazy pattern can't be used with"
1354 " line number.\n");
1355 return -EINVAL;
1356 }
1357
1358 if (pp->lazy_line && pp->offset) {
1359 semantic_error("Lazy pattern can't be used with offset.\n");
1360 return -EINVAL;
1361 }
1362
1363 if (pp->line && pp->offset) {
1364 semantic_error("Offset can't be used with line number.\n");
1365 return -EINVAL;
1366 }
1367
1368 if (!pp->line && !pp->lazy_line && pp->file && !pp->function) {
1369 semantic_error("File always requires line number or "
1370 "lazy pattern.\n");
1371 return -EINVAL;
1372 }
1373
1374 if (pp->offset && !pp->function) {
1375 semantic_error("Offset requires an entry function.\n");
1376 return -EINVAL;
1377 }
1378
1379 if (pp->retprobe && !pp->function) {
1380 semantic_error("Return probe requires an entry function.\n");
1381 return -EINVAL;
1382 }
1383
1384 if ((pp->offset || pp->line || pp->lazy_line) && pp->retprobe) {
1385 semantic_error("Offset/Line/Lazy pattern can't be used with "
1386 "return probe.\n");
1387 return -EINVAL;
1388 }
1389
1390 pr_debug("symbol:%s file:%s line:%d offset:%lu return:%d lazy:%s\n",
1391 pp->function, pp->file, pp->line, pp->offset, pp->retprobe,
1392 pp->lazy_line);
1393 return 0;
1394 }
1395
1396 /* Parse perf-probe event argument */
1397 static int parse_perf_probe_arg(char *str, struct perf_probe_arg *arg)
1398 {
1399 char *tmp, *goodname;
1400 struct perf_probe_arg_field **fieldp;
1401
1402 pr_debug("parsing arg: %s into ", str);
1403
1404 tmp = strchr(str, '=');
1405 if (tmp) {
1406 arg->name = strndup(str, tmp - str);
1407 if (arg->name == NULL)
1408 return -ENOMEM;
1409 pr_debug("name:%s ", arg->name);
1410 str = tmp + 1;
1411 }
1412
1413 tmp = strchr(str, ':');
1414 if (tmp) { /* Type setting */
1415 *tmp = '\0';
1416 arg->type = strdup(tmp + 1);
1417 if (arg->type == NULL)
1418 return -ENOMEM;
1419 pr_debug("type:%s ", arg->type);
1420 }
1421
1422 tmp = strpbrk(str, "-.[");
1423 if (!is_c_varname(str) || !tmp) {
1424 /* A variable, register, symbol or special value */
1425 arg->var = strdup(str);
1426 if (arg->var == NULL)
1427 return -ENOMEM;
1428 pr_debug("%s\n", arg->var);
1429 return 0;
1430 }
1431
1432 /* Structure fields or array element */
1433 arg->var = strndup(str, tmp - str);
1434 if (arg->var == NULL)
1435 return -ENOMEM;
1436 goodname = arg->var;
1437 pr_debug("%s, ", arg->var);
1438 fieldp = &arg->field;
1439
1440 do {
1441 *fieldp = zalloc(sizeof(struct perf_probe_arg_field));
1442 if (*fieldp == NULL)
1443 return -ENOMEM;
1444 if (*tmp == '[') { /* Array */
1445 str = tmp;
1446 (*fieldp)->index = strtol(str + 1, &tmp, 0);
1447 (*fieldp)->ref = true;
1448 if (*tmp != ']' || tmp == str + 1) {
1449 semantic_error("Array index must be a"
1450 " number.\n");
1451 return -EINVAL;
1452 }
1453 tmp++;
1454 if (*tmp == '\0')
1455 tmp = NULL;
1456 } else { /* Structure */
1457 if (*tmp == '.') {
1458 str = tmp + 1;
1459 (*fieldp)->ref = false;
1460 } else if (tmp[1] == '>') {
1461 str = tmp + 2;
1462 (*fieldp)->ref = true;
1463 } else {
1464 semantic_error("Argument parse error: %s\n",
1465 str);
1466 return -EINVAL;
1467 }
1468 tmp = strpbrk(str, "-.[");
1469 }
1470 if (tmp) {
1471 (*fieldp)->name = strndup(str, tmp - str);
1472 if ((*fieldp)->name == NULL)
1473 return -ENOMEM;
1474 if (*str != '[')
1475 goodname = (*fieldp)->name;
1476 pr_debug("%s(%d), ", (*fieldp)->name, (*fieldp)->ref);
1477 fieldp = &(*fieldp)->next;
1478 }
1479 } while (tmp);
1480 (*fieldp)->name = strdup(str);
1481 if ((*fieldp)->name == NULL)
1482 return -ENOMEM;
1483 if (*str != '[')
1484 goodname = (*fieldp)->name;
1485 pr_debug("%s(%d)\n", (*fieldp)->name, (*fieldp)->ref);
1486
1487 /* If no name is specified, set the last field name (not array index)*/
1488 if (!arg->name) {
1489 arg->name = strdup(goodname);
1490 if (arg->name == NULL)
1491 return -ENOMEM;
1492 }
1493 return 0;
1494 }
1495
1496 /* Parse perf-probe event command */
1497 int parse_perf_probe_command(const char *cmd, struct perf_probe_event *pev)
1498 {
1499 char **argv;
1500 int argc, i, ret = 0;
1501
1502 argv = argv_split(cmd, &argc);
1503 if (!argv) {
1504 pr_debug("Failed to split arguments.\n");
1505 return -ENOMEM;
1506 }
1507 if (argc - 1 > MAX_PROBE_ARGS) {
1508 semantic_error("Too many probe arguments (%d).\n", argc - 1);
1509 ret = -ERANGE;
1510 goto out;
1511 }
1512 /* Parse probe point */
1513 ret = parse_perf_probe_point(argv[0], pev);
1514 if (ret < 0)
1515 goto out;
1516
1517 /* Copy arguments and ensure return probe has no C argument */
1518 pev->nargs = argc - 1;
1519 pev->args = zalloc(sizeof(struct perf_probe_arg) * pev->nargs);
1520 if (pev->args == NULL) {
1521 ret = -ENOMEM;
1522 goto out;
1523 }
1524 for (i = 0; i < pev->nargs && ret >= 0; i++) {
1525 ret = parse_perf_probe_arg(argv[i + 1], &pev->args[i]);
1526 if (ret >= 0 &&
1527 is_c_varname(pev->args[i].var) && pev->point.retprobe) {
1528 semantic_error("You can't specify local variable for"
1529 " kretprobe.\n");
1530 ret = -EINVAL;
1531 }
1532 }
1533 out:
1534 argv_free(argv);
1535
1536 return ret;
1537 }
1538
1539 /* Return true if this perf_probe_event requires debuginfo */
1540 bool perf_probe_event_need_dwarf(struct perf_probe_event *pev)
1541 {
1542 int i;
1543
1544 if (pev->point.file || pev->point.line || pev->point.lazy_line)
1545 return true;
1546
1547 for (i = 0; i < pev->nargs; i++)
1548 if (is_c_varname(pev->args[i].var))
1549 return true;
1550
1551 return false;
1552 }
1553
1554 /* Parse probe_events event into struct probe_point */
1555 int parse_probe_trace_command(const char *cmd, struct probe_trace_event *tev)
1556 {
1557 struct probe_trace_point *tp = &tev->point;
1558 char pr;
1559 char *p;
1560 char *argv0_str = NULL, *fmt, *fmt1_str, *fmt2_str, *fmt3_str;
1561 int ret, i, argc;
1562 char **argv;
1563
1564 pr_debug("Parsing probe_events: %s\n", cmd);
1565 argv = argv_split(cmd, &argc);
1566 if (!argv) {
1567 pr_debug("Failed to split arguments.\n");
1568 return -ENOMEM;
1569 }
1570 if (argc < 2) {
1571 semantic_error("Too few probe arguments.\n");
1572 ret = -ERANGE;
1573 goto out;
1574 }
1575
1576 /* Scan event and group name. */
1577 argv0_str = strdup(argv[0]);
1578 if (argv0_str == NULL) {
1579 ret = -ENOMEM;
1580 goto out;
1581 }
1582 fmt1_str = strtok_r(argv0_str, ":", &fmt);
1583 fmt2_str = strtok_r(NULL, "/", &fmt);
1584 fmt3_str = strtok_r(NULL, " \t", &fmt);
1585 if (fmt1_str == NULL || strlen(fmt1_str) != 1 || fmt2_str == NULL
1586 || fmt3_str == NULL) {
1587 semantic_error("Failed to parse event name: %s\n", argv[0]);
1588 ret = -EINVAL;
1589 goto out;
1590 }
1591 pr = fmt1_str[0];
1592 tev->group = strdup(fmt2_str);
1593 tev->event = strdup(fmt3_str);
1594 if (tev->group == NULL || tev->event == NULL) {
1595 ret = -ENOMEM;
1596 goto out;
1597 }
1598 pr_debug("Group:%s Event:%s probe:%c\n", tev->group, tev->event, pr);
1599
1600 tp->retprobe = (pr == 'r');
1601
1602 /* Scan module name(if there), function name and offset */
1603 p = strchr(argv[1], ':');
1604 if (p) {
1605 tp->module = strndup(argv[1], p - argv[1]);
1606 if (!tp->module) {
1607 ret = -ENOMEM;
1608 goto out;
1609 }
1610 p++;
1611 } else
1612 p = argv[1];
1613 fmt1_str = strtok_r(p, "+", &fmt);
1614 /* only the address started with 0x */
1615 if (fmt1_str[0] == '0') {
1616 /*
1617 * Fix a special case:
1618 * if address == 0, kernel reports something like:
1619 * p:probe_libc/abs_0 /lib/libc-2.18.so:0x (null) arg1=%ax
1620 * Newer kernel may fix that, but we want to
1621 * support old kernel also.
1622 */
1623 if (strcmp(fmt1_str, "0x") == 0) {
1624 if (!argv[2] || strcmp(argv[2], "(null)")) {
1625 ret = -EINVAL;
1626 goto out;
1627 }
1628 tp->address = 0;
1629
1630 free(argv[2]);
1631 for (i = 2; argv[i + 1] != NULL; i++)
1632 argv[i] = argv[i + 1];
1633
1634 argv[i] = NULL;
1635 argc -= 1;
1636 } else
1637 tp->address = strtoul(fmt1_str, NULL, 0);
1638 } else {
1639 /* Only the symbol-based probe has offset */
1640 tp->symbol = strdup(fmt1_str);
1641 if (tp->symbol == NULL) {
1642 ret = -ENOMEM;
1643 goto out;
1644 }
1645 fmt2_str = strtok_r(NULL, "", &fmt);
1646 if (fmt2_str == NULL)
1647 tp->offset = 0;
1648 else
1649 tp->offset = strtoul(fmt2_str, NULL, 10);
1650 }
1651
1652 tev->nargs = argc - 2;
1653 tev->args = zalloc(sizeof(struct probe_trace_arg) * tev->nargs);
1654 if (tev->args == NULL) {
1655 ret = -ENOMEM;
1656 goto out;
1657 }
1658 for (i = 0; i < tev->nargs; i++) {
1659 p = strchr(argv[i + 2], '=');
1660 if (p) /* We don't need which register is assigned. */
1661 *p++ = '\0';
1662 else
1663 p = argv[i + 2];
1664 tev->args[i].name = strdup(argv[i + 2]);
1665 /* TODO: parse regs and offset */
1666 tev->args[i].value = strdup(p);
1667 if (tev->args[i].name == NULL || tev->args[i].value == NULL) {
1668 ret = -ENOMEM;
1669 goto out;
1670 }
1671 }
1672 ret = 0;
1673 out:
1674 free(argv0_str);
1675 argv_free(argv);
1676 return ret;
1677 }
1678
1679 /* Compose only probe arg */
1680 char *synthesize_perf_probe_arg(struct perf_probe_arg *pa)
1681 {
1682 struct perf_probe_arg_field *field = pa->field;
1683 struct strbuf buf;
1684 char *ret = NULL;
1685 int err;
1686
1687 if (strbuf_init(&buf, 64) < 0)
1688 return NULL;
1689
1690 if (pa->name && pa->var)
1691 err = strbuf_addf(&buf, "%s=%s", pa->name, pa->var);
1692 else
1693 err = strbuf_addstr(&buf, pa->name ?: pa->var);
1694 if (err)
1695 goto out;
1696
1697 while (field) {
1698 if (field->name[0] == '[')
1699 err = strbuf_addstr(&buf, field->name);
1700 else
1701 err = strbuf_addf(&buf, "%s%s", field->ref ? "->" : ".",
1702 field->name);
1703 field = field->next;
1704 if (err)
1705 goto out;
1706 }
1707
1708 if (pa->type)
1709 if (strbuf_addf(&buf, ":%s", pa->type) < 0)
1710 goto out;
1711
1712 ret = strbuf_detach(&buf, NULL);
1713 out:
1714 strbuf_release(&buf);
1715 return ret;
1716 }
1717
1718 /* Compose only probe point (not argument) */
1719 static char *synthesize_perf_probe_point(struct perf_probe_point *pp)
1720 {
1721 struct strbuf buf;
1722 char *tmp, *ret = NULL;
1723 int len, err = 0;
1724
1725 if (strbuf_init(&buf, 64) < 0)
1726 return NULL;
1727
1728 if (pp->function) {
1729 if (strbuf_addstr(&buf, pp->function) < 0)
1730 goto out;
1731 if (pp->offset)
1732 err = strbuf_addf(&buf, "+%lu", pp->offset);
1733 else if (pp->line)
1734 err = strbuf_addf(&buf, ":%d", pp->line);
1735 else if (pp->retprobe)
1736 err = strbuf_addstr(&buf, "%return");
1737 if (err)
1738 goto out;
1739 }
1740 if (pp->file) {
1741 tmp = pp->file;
1742 len = strlen(tmp);
1743 if (len > 30) {
1744 tmp = strchr(pp->file + len - 30, '/');
1745 tmp = tmp ? tmp + 1 : pp->file + len - 30;
1746 }
1747 err = strbuf_addf(&buf, "@%s", tmp);
1748 if (!err && !pp->function && pp->line)
1749 err = strbuf_addf(&buf, ":%d", pp->line);
1750 }
1751 if (!err)
1752 ret = strbuf_detach(&buf, NULL);
1753 out:
1754 strbuf_release(&buf);
1755 return ret;
1756 }
1757
1758 #if 0
1759 char *synthesize_perf_probe_command(struct perf_probe_event *pev)
1760 {
1761 char *buf;
1762 int i, len, ret;
1763
1764 buf = synthesize_perf_probe_point(&pev->point);
1765 if (!buf)
1766 return NULL;
1767
1768 len = strlen(buf);
1769 for (i = 0; i < pev->nargs; i++) {
1770 ret = e_snprintf(&buf[len], MAX_CMDLEN - len, " %s",
1771 pev->args[i].name);
1772 if (ret <= 0) {
1773 free(buf);
1774 return NULL;
1775 }
1776 len += ret;
1777 }
1778
1779 return buf;
1780 }
1781 #endif
1782
1783 static int __synthesize_probe_trace_arg_ref(struct probe_trace_arg_ref *ref,
1784 struct strbuf *buf, int depth)
1785 {
1786 int err;
1787 if (ref->next) {
1788 depth = __synthesize_probe_trace_arg_ref(ref->next, buf,
1789 depth + 1);
1790 if (depth < 0)
1791 return depth;
1792 }
1793 err = strbuf_addf(buf, "%+ld(", ref->offset);
1794 return (err < 0) ? err : depth;
1795 }
1796
1797 static int synthesize_probe_trace_arg(struct probe_trace_arg *arg,
1798 struct strbuf *buf)
1799 {
1800 struct probe_trace_arg_ref *ref = arg->ref;
1801 int depth = 0, err;
1802
1803 /* Argument name or separator */
1804 if (arg->name)
1805 err = strbuf_addf(buf, " %s=", arg->name);
1806 else
1807 err = strbuf_addch(buf, ' ');
1808 if (err)
1809 return err;
1810
1811 /* Special case: @XXX */
1812 if (arg->value[0] == '@' && arg->ref)
1813 ref = ref->next;
1814
1815 /* Dereferencing arguments */
1816 if (ref) {
1817 depth = __synthesize_probe_trace_arg_ref(ref, buf, 1);
1818 if (depth < 0)
1819 return depth;
1820 }
1821
1822 /* Print argument value */
1823 if (arg->value[0] == '@' && arg->ref)
1824 err = strbuf_addf(buf, "%s%+ld", arg->value, arg->ref->offset);
1825 else
1826 err = strbuf_addstr(buf, arg->value);
1827
1828 /* Closing */
1829 while (!err && depth--)
1830 err = strbuf_addch(buf, ')');
1831
1832 /* Print argument type */
1833 if (!err && arg->type)
1834 err = strbuf_addf(buf, ":%s", arg->type);
1835
1836 return err;
1837 }
1838
1839 char *synthesize_probe_trace_command(struct probe_trace_event *tev)
1840 {
1841 struct probe_trace_point *tp = &tev->point;
1842 struct strbuf buf;
1843 char *ret = NULL;
1844 int i, err;
1845
1846 /* Uprobes must have tp->module */
1847 if (tev->uprobes && !tp->module)
1848 return NULL;
1849
1850 if (strbuf_init(&buf, 32) < 0)
1851 return NULL;
1852
1853 if (strbuf_addf(&buf, "%c:%s/%s ", tp->retprobe ? 'r' : 'p',
1854 tev->group, tev->event) < 0)
1855 goto error;
1856 /*
1857 * If tp->address == 0, then this point must be a
1858 * absolute address uprobe.
1859 * try_to_find_absolute_address() should have made
1860 * tp->symbol to "0x0".
1861 */
1862 if (tev->uprobes && !tp->address) {
1863 if (!tp->symbol || strcmp(tp->symbol, "0x0"))
1864 goto error;
1865 }
1866
1867 /* Use the tp->address for uprobes */
1868 if (tev->uprobes)
1869 err = strbuf_addf(&buf, "%s:0x%lx", tp->module, tp->address);
1870 else if (!strncmp(tp->symbol, "0x", 2))
1871 /* Absolute address. See try_to_find_absolute_address() */
1872 err = strbuf_addf(&buf, "%s%s0x%lx", tp->module ?: "",
1873 tp->module ? ":" : "", tp->address);
1874 else
1875 err = strbuf_addf(&buf, "%s%s%s+%lu", tp->module ?: "",
1876 tp->module ? ":" : "", tp->symbol, tp->offset);
1877 if (err)
1878 goto error;
1879
1880 for (i = 0; i < tev->nargs; i++)
1881 if (synthesize_probe_trace_arg(&tev->args[i], &buf) < 0)
1882 goto error;
1883
1884 ret = strbuf_detach(&buf, NULL);
1885 error:
1886 strbuf_release(&buf);
1887 return ret;
1888 }
1889
1890 static int find_perf_probe_point_from_map(struct probe_trace_point *tp,
1891 struct perf_probe_point *pp,
1892 bool is_kprobe)
1893 {
1894 struct symbol *sym = NULL;
1895 struct map *map;
1896 u64 addr = tp->address;
1897 int ret = -ENOENT;
1898
1899 if (!is_kprobe) {
1900 map = dso__new_map(tp->module);
1901 if (!map)
1902 goto out;
1903 sym = map__find_symbol(map, addr, NULL);
1904 } else {
1905 if (tp->symbol && !addr) {
1906 if (kernel_get_symbol_address_by_name(tp->symbol,
1907 &addr, true, false) < 0)
1908 goto out;
1909 }
1910 if (addr) {
1911 addr += tp->offset;
1912 sym = __find_kernel_function(addr, &map);
1913 }
1914 }
1915
1916 if (!sym)
1917 goto out;
1918
1919 pp->retprobe = tp->retprobe;
1920 pp->offset = addr - map->unmap_ip(map, sym->start);
1921 pp->function = strdup(sym->name);
1922 ret = pp->function ? 0 : -ENOMEM;
1923
1924 out:
1925 if (map && !is_kprobe) {
1926 map__put(map);
1927 }
1928
1929 return ret;
1930 }
1931
1932 static int convert_to_perf_probe_point(struct probe_trace_point *tp,
1933 struct perf_probe_point *pp,
1934 bool is_kprobe)
1935 {
1936 char buf[128];
1937 int ret;
1938
1939 ret = find_perf_probe_point_from_dwarf(tp, pp, is_kprobe);
1940 if (!ret)
1941 return 0;
1942 ret = find_perf_probe_point_from_map(tp, pp, is_kprobe);
1943 if (!ret)
1944 return 0;
1945
1946 pr_debug("Failed to find probe point from both of dwarf and map.\n");
1947
1948 if (tp->symbol) {
1949 pp->function = strdup(tp->symbol);
1950 pp->offset = tp->offset;
1951 } else {
1952 ret = e_snprintf(buf, 128, "0x%" PRIx64, (u64)tp->address);
1953 if (ret < 0)
1954 return ret;
1955 pp->function = strdup(buf);
1956 pp->offset = 0;
1957 }
1958 if (pp->function == NULL)
1959 return -ENOMEM;
1960
1961 pp->retprobe = tp->retprobe;
1962
1963 return 0;
1964 }
1965
1966 static int convert_to_perf_probe_event(struct probe_trace_event *tev,
1967 struct perf_probe_event *pev, bool is_kprobe)
1968 {
1969 struct strbuf buf = STRBUF_INIT;
1970 int i, ret;
1971
1972 /* Convert event/group name */
1973 pev->event = strdup(tev->event);
1974 pev->group = strdup(tev->group);
1975 if (pev->event == NULL || pev->group == NULL)
1976 return -ENOMEM;
1977
1978 /* Convert trace_point to probe_point */
1979 ret = convert_to_perf_probe_point(&tev->point, &pev->point, is_kprobe);
1980 if (ret < 0)
1981 return ret;
1982
1983 /* Convert trace_arg to probe_arg */
1984 pev->nargs = tev->nargs;
1985 pev->args = zalloc(sizeof(struct perf_probe_arg) * pev->nargs);
1986 if (pev->args == NULL)
1987 return -ENOMEM;
1988 for (i = 0; i < tev->nargs && ret >= 0; i++) {
1989 if (tev->args[i].name)
1990 pev->args[i].name = strdup(tev->args[i].name);
1991 else {
1992 if ((ret = strbuf_init(&buf, 32)) < 0)
1993 goto error;
1994 ret = synthesize_probe_trace_arg(&tev->args[i], &buf);
1995 pev->args[i].name = strbuf_detach(&buf, NULL);
1996 }
1997 if (pev->args[i].name == NULL && ret >= 0)
1998 ret = -ENOMEM;
1999 }
2000 error:
2001 if (ret < 0)
2002 clear_perf_probe_event(pev);
2003
2004 return ret;
2005 }
2006
2007 void clear_perf_probe_event(struct perf_probe_event *pev)
2008 {
2009 struct perf_probe_arg_field *field, *next;
2010 int i;
2011
2012 free(pev->event);
2013 free(pev->group);
2014 free(pev->target);
2015 clear_perf_probe_point(&pev->point);
2016
2017 for (i = 0; i < pev->nargs; i++) {
2018 free(pev->args[i].name);
2019 free(pev->args[i].var);
2020 free(pev->args[i].type);
2021 field = pev->args[i].field;
2022 while (field) {
2023 next = field->next;
2024 zfree(&field->name);
2025 free(field);
2026 field = next;
2027 }
2028 }
2029 free(pev->args);
2030 memset(pev, 0, sizeof(*pev));
2031 }
2032
2033 #define strdup_or_goto(str, label) \
2034 ({ char *__p = NULL; if (str && !(__p = strdup(str))) goto label; __p; })
2035
2036 static int perf_probe_point__copy(struct perf_probe_point *dst,
2037 struct perf_probe_point *src)
2038 {
2039 dst->file = strdup_or_goto(src->file, out_err);
2040 dst->function = strdup_or_goto(src->function, out_err);
2041 dst->lazy_line = strdup_or_goto(src->lazy_line, out_err);
2042 dst->line = src->line;
2043 dst->retprobe = src->retprobe;
2044 dst->offset = src->offset;
2045 return 0;
2046
2047 out_err:
2048 clear_perf_probe_point(dst);
2049 return -ENOMEM;
2050 }
2051
2052 static int perf_probe_arg__copy(struct perf_probe_arg *dst,
2053 struct perf_probe_arg *src)
2054 {
2055 struct perf_probe_arg_field *field, **ppfield;
2056
2057 dst->name = strdup_or_goto(src->name, out_err);
2058 dst->var = strdup_or_goto(src->var, out_err);
2059 dst->type = strdup_or_goto(src->type, out_err);
2060
2061 field = src->field;
2062 ppfield = &(dst->field);
2063 while (field) {
2064 *ppfield = zalloc(sizeof(*field));
2065 if (!*ppfield)
2066 goto out_err;
2067 (*ppfield)->name = strdup_or_goto(field->name, out_err);
2068 (*ppfield)->index = field->index;
2069 (*ppfield)->ref = field->ref;
2070 field = field->next;
2071 ppfield = &((*ppfield)->next);
2072 }
2073 return 0;
2074 out_err:
2075 return -ENOMEM;
2076 }
2077
2078 int perf_probe_event__copy(struct perf_probe_event *dst,
2079 struct perf_probe_event *src)
2080 {
2081 int i;
2082
2083 dst->event = strdup_or_goto(src->event, out_err);
2084 dst->group = strdup_or_goto(src->group, out_err);
2085 dst->target = strdup_or_goto(src->target, out_err);
2086 dst->uprobes = src->uprobes;
2087
2088 if (perf_probe_point__copy(&dst->point, &src->point) < 0)
2089 goto out_err;
2090
2091 dst->args = zalloc(sizeof(struct perf_probe_arg) * src->nargs);
2092 if (!dst->args)
2093 goto out_err;
2094 dst->nargs = src->nargs;
2095
2096 for (i = 0; i < src->nargs; i++)
2097 if (perf_probe_arg__copy(&dst->args[i], &src->args[i]) < 0)
2098 goto out_err;
2099 return 0;
2100
2101 out_err:
2102 clear_perf_probe_event(dst);
2103 return -ENOMEM;
2104 }
2105
2106 void clear_probe_trace_event(struct probe_trace_event *tev)
2107 {
2108 struct probe_trace_arg_ref *ref, *next;
2109 int i;
2110
2111 free(tev->event);
2112 free(tev->group);
2113 free(tev->point.symbol);
2114 free(tev->point.realname);
2115 free(tev->point.module);
2116 for (i = 0; i < tev->nargs; i++) {
2117 free(tev->args[i].name);
2118 free(tev->args[i].value);
2119 free(tev->args[i].type);
2120 ref = tev->args[i].ref;
2121 while (ref) {
2122 next = ref->next;
2123 free(ref);
2124 ref = next;
2125 }
2126 }
2127 free(tev->args);
2128 memset(tev, 0, sizeof(*tev));
2129 }
2130
2131 struct kprobe_blacklist_node {
2132 struct list_head list;
2133 unsigned long start;
2134 unsigned long end;
2135 char *symbol;
2136 };
2137
2138 static void kprobe_blacklist__delete(struct list_head *blacklist)
2139 {
2140 struct kprobe_blacklist_node *node;
2141
2142 while (!list_empty(blacklist)) {
2143 node = list_first_entry(blacklist,
2144 struct kprobe_blacklist_node, list);
2145 list_del(&node->list);
2146 free(node->symbol);
2147 free(node);
2148 }
2149 }
2150
2151 static int kprobe_blacklist__load(struct list_head *blacklist)
2152 {
2153 struct kprobe_blacklist_node *node;
2154 const char *__debugfs = debugfs__mountpoint();
2155 char buf[PATH_MAX], *p;
2156 FILE *fp;
2157 int ret;
2158
2159 if (__debugfs == NULL)
2160 return -ENOTSUP;
2161
2162 ret = e_snprintf(buf, PATH_MAX, "%s/kprobes/blacklist", __debugfs);
2163 if (ret < 0)
2164 return ret;
2165
2166 fp = fopen(buf, "r");
2167 if (!fp)
2168 return -errno;
2169
2170 ret = 0;
2171 while (fgets(buf, PATH_MAX, fp)) {
2172 node = zalloc(sizeof(*node));
2173 if (!node) {
2174 ret = -ENOMEM;
2175 break;
2176 }
2177 INIT_LIST_HEAD(&node->list);
2178 list_add_tail(&node->list, blacklist);
2179 if (sscanf(buf, "0x%lx-0x%lx", &node->start, &node->end) != 2) {
2180 ret = -EINVAL;
2181 break;
2182 }
2183 p = strchr(buf, '\t');
2184 if (p) {
2185 p++;
2186 if (p[strlen(p) - 1] == '\n')
2187 p[strlen(p) - 1] = '\0';
2188 } else
2189 p = (char *)"unknown";
2190 node->symbol = strdup(p);
2191 if (!node->symbol) {
2192 ret = -ENOMEM;
2193 break;
2194 }
2195 pr_debug2("Blacklist: 0x%lx-0x%lx, %s\n",
2196 node->start, node->end, node->symbol);
2197 ret++;
2198 }
2199 if (ret < 0)
2200 kprobe_blacklist__delete(blacklist);
2201 fclose(fp);
2202
2203 return ret;
2204 }
2205
2206 static struct kprobe_blacklist_node *
2207 kprobe_blacklist__find_by_address(struct list_head *blacklist,
2208 unsigned long address)
2209 {
2210 struct kprobe_blacklist_node *node;
2211
2212 list_for_each_entry(node, blacklist, list) {
2213 if (node->start <= address && address <= node->end)
2214 return node;
2215 }
2216
2217 return NULL;
2218 }
2219
2220 static LIST_HEAD(kprobe_blacklist);
2221
2222 static void kprobe_blacklist__init(void)
2223 {
2224 if (!list_empty(&kprobe_blacklist))
2225 return;
2226
2227 if (kprobe_blacklist__load(&kprobe_blacklist) < 0)
2228 pr_debug("No kprobe blacklist support, ignored\n");
2229 }
2230
2231 static void kprobe_blacklist__release(void)
2232 {
2233 kprobe_blacklist__delete(&kprobe_blacklist);
2234 }
2235
2236 static bool kprobe_blacklist__listed(unsigned long address)
2237 {
2238 return !!kprobe_blacklist__find_by_address(&kprobe_blacklist, address);
2239 }
2240
2241 static int perf_probe_event__sprintf(const char *group, const char *event,
2242 struct perf_probe_event *pev,
2243 const char *module,
2244 struct strbuf *result)
2245 {
2246 int i, ret;
2247 char *buf;
2248
2249 if (asprintf(&buf, "%s:%s", group, event) < 0)
2250 return -errno;
2251 ret = strbuf_addf(result, " %-20s (on ", buf);
2252 free(buf);
2253 if (ret)
2254 return ret;
2255
2256 /* Synthesize only event probe point */
2257 buf = synthesize_perf_probe_point(&pev->point);
2258 if (!buf)
2259 return -ENOMEM;
2260 ret = strbuf_addstr(result, buf);
2261 free(buf);
2262
2263 if (!ret && module)
2264 ret = strbuf_addf(result, " in %s", module);
2265
2266 if (!ret && pev->nargs > 0) {
2267 ret = strbuf_add(result, " with", 5);
2268 for (i = 0; !ret && i < pev->nargs; i++) {
2269 buf = synthesize_perf_probe_arg(&pev->args[i]);
2270 if (!buf)
2271 return -ENOMEM;
2272 ret = strbuf_addf(result, " %s", buf);
2273 free(buf);
2274 }
2275 }
2276 if (!ret)
2277 ret = strbuf_addch(result, ')');
2278
2279 return ret;
2280 }
2281
2282 /* Show an event */
2283 int show_perf_probe_event(const char *group, const char *event,
2284 struct perf_probe_event *pev,
2285 const char *module, bool use_stdout)
2286 {
2287 struct strbuf buf = STRBUF_INIT;
2288 int ret;
2289
2290 ret = perf_probe_event__sprintf(group, event, pev, module, &buf);
2291 if (ret >= 0) {
2292 if (use_stdout)
2293 printf("%s\n", buf.buf);
2294 else
2295 pr_info("%s\n", buf.buf);
2296 }
2297 strbuf_release(&buf);
2298
2299 return ret;
2300 }
2301
2302 static bool filter_probe_trace_event(struct probe_trace_event *tev,
2303 struct strfilter *filter)
2304 {
2305 char tmp[128];
2306
2307 /* At first, check the event name itself */
2308 if (strfilter__compare(filter, tev->event))
2309 return true;
2310
2311 /* Next, check the combination of name and group */
2312 if (e_snprintf(tmp, 128, "%s:%s", tev->group, tev->event) < 0)
2313 return false;
2314 return strfilter__compare(filter, tmp);
2315 }
2316
2317 static int __show_perf_probe_events(int fd, bool is_kprobe,
2318 struct strfilter *filter)
2319 {
2320 int ret = 0;
2321 struct probe_trace_event tev;
2322 struct perf_probe_event pev;
2323 struct strlist *rawlist;
2324 struct str_node *ent;
2325
2326 memset(&tev, 0, sizeof(tev));
2327 memset(&pev, 0, sizeof(pev));
2328
2329 rawlist = probe_file__get_rawlist(fd);
2330 if (!rawlist)
2331 return -ENOMEM;
2332
2333 strlist__for_each(ent, rawlist) {
2334 ret = parse_probe_trace_command(ent->s, &tev);
2335 if (ret >= 0) {
2336 if (!filter_probe_trace_event(&tev, filter))
2337 goto next;
2338 ret = convert_to_perf_probe_event(&tev, &pev,
2339 is_kprobe);
2340 if (ret < 0)
2341 goto next;
2342 ret = show_perf_probe_event(pev.group, pev.event,
2343 &pev, tev.point.module,
2344 true);
2345 }
2346 next:
2347 clear_perf_probe_event(&pev);
2348 clear_probe_trace_event(&tev);
2349 if (ret < 0)
2350 break;
2351 }
2352 strlist__delete(rawlist);
2353 /* Cleanup cached debuginfo if needed */
2354 debuginfo_cache__exit();
2355
2356 return ret;
2357 }
2358
2359 /* List up current perf-probe events */
2360 int show_perf_probe_events(struct strfilter *filter)
2361 {
2362 int kp_fd, up_fd, ret;
2363
2364 setup_pager();
2365
2366 ret = init_probe_symbol_maps(false);
2367 if (ret < 0)
2368 return ret;
2369
2370 ret = probe_file__open_both(&kp_fd, &up_fd, 0);
2371 if (ret < 0)
2372 return ret;
2373
2374 if (kp_fd >= 0)
2375 ret = __show_perf_probe_events(kp_fd, true, filter);
2376 if (up_fd >= 0 && ret >= 0)
2377 ret = __show_perf_probe_events(up_fd, false, filter);
2378 if (kp_fd > 0)
2379 close(kp_fd);
2380 if (up_fd > 0)
2381 close(up_fd);
2382 exit_probe_symbol_maps();
2383
2384 return ret;
2385 }
2386
2387 static int get_new_event_name(char *buf, size_t len, const char *base,
2388 struct strlist *namelist, bool allow_suffix)
2389 {
2390 int i, ret;
2391 char *p, *nbase;
2392
2393 if (*base == '.')
2394 base++;
2395 nbase = strdup(base);
2396 if (!nbase)
2397 return -ENOMEM;
2398
2399 /* Cut off the dot suffixes (e.g. .const, .isra)*/
2400 p = strchr(nbase, '.');
2401 if (p && p != nbase)
2402 *p = '\0';
2403
2404 /* Try no suffix number */
2405 ret = e_snprintf(buf, len, "%s", nbase);
2406 if (ret < 0) {
2407 pr_debug("snprintf() failed: %d\n", ret);
2408 goto out;
2409 }
2410 if (!strlist__has_entry(namelist, buf))
2411 goto out;
2412
2413 if (!allow_suffix) {
2414 pr_warning("Error: event \"%s\" already exists.\n"
2415 " Hint: Remove existing event by 'perf probe -d'\n"
2416 " or force duplicates by 'perf probe -f'\n"
2417 " or set 'force=yes' in BPF source.\n",
2418 buf);
2419 ret = -EEXIST;
2420 goto out;
2421 }
2422
2423 /* Try to add suffix */
2424 for (i = 1; i < MAX_EVENT_INDEX; i++) {
2425 ret = e_snprintf(buf, len, "%s_%d", nbase, i);
2426 if (ret < 0) {
2427 pr_debug("snprintf() failed: %d\n", ret);
2428 goto out;
2429 }
2430 if (!strlist__has_entry(namelist, buf))
2431 break;
2432 }
2433 if (i == MAX_EVENT_INDEX) {
2434 pr_warning("Too many events are on the same function.\n");
2435 ret = -ERANGE;
2436 }
2437
2438 out:
2439 free(nbase);
2440 return ret;
2441 }
2442
2443 /* Warn if the current kernel's uprobe implementation is old */
2444 static void warn_uprobe_event_compat(struct probe_trace_event *tev)
2445 {
2446 int i;
2447 char *buf = synthesize_probe_trace_command(tev);
2448
2449 /* Old uprobe event doesn't support memory dereference */
2450 if (!tev->uprobes || tev->nargs == 0 || !buf)
2451 goto out;
2452
2453 for (i = 0; i < tev->nargs; i++)
2454 if (strglobmatch(tev->args[i].value, "[$@+-]*")) {
2455 pr_warning("Please upgrade your kernel to at least "
2456 "3.14 to have access to feature %s\n",
2457 tev->args[i].value);
2458 break;
2459 }
2460 out:
2461 free(buf);
2462 }
2463
2464 /* Set new name from original perf_probe_event and namelist */
2465 static int probe_trace_event__set_name(struct probe_trace_event *tev,
2466 struct perf_probe_event *pev,
2467 struct strlist *namelist,
2468 bool allow_suffix)
2469 {
2470 const char *event, *group;
2471 char buf[64];
2472 int ret;
2473
2474 if (pev->event)
2475 event = pev->event;
2476 else
2477 if (pev->point.function &&
2478 (strncmp(pev->point.function, "0x", 2) != 0) &&
2479 !strisglob(pev->point.function))
2480 event = pev->point.function;
2481 else
2482 event = tev->point.realname;
2483 if (pev->group)
2484 group = pev->group;
2485 else
2486 group = PERFPROBE_GROUP;
2487
2488 /* Get an unused new event name */
2489 ret = get_new_event_name(buf, 64, event,
2490 namelist, allow_suffix);
2491 if (ret < 0)
2492 return ret;
2493
2494 event = buf;
2495
2496 tev->event = strdup(event);
2497 tev->group = strdup(group);
2498 if (tev->event == NULL || tev->group == NULL)
2499 return -ENOMEM;
2500
2501 /* Add added event name to namelist */
2502 strlist__add(namelist, event);
2503 return 0;
2504 }
2505
2506 static int __add_probe_trace_events(struct perf_probe_event *pev,
2507 struct probe_trace_event *tevs,
2508 int ntevs, bool allow_suffix)
2509 {
2510 int i, fd, ret;
2511 struct probe_trace_event *tev = NULL;
2512 struct strlist *namelist;
2513
2514 fd = probe_file__open(PF_FL_RW | (pev->uprobes ? PF_FL_UPROBE : 0));
2515 if (fd < 0)
2516 return fd;
2517
2518 /* Get current event names */
2519 namelist = probe_file__get_namelist(fd);
2520 if (!namelist) {
2521 pr_debug("Failed to get current event list.\n");
2522 ret = -ENOMEM;
2523 goto close_out;
2524 }
2525
2526 ret = 0;
2527 for (i = 0; i < ntevs; i++) {
2528 tev = &tevs[i];
2529 /* Skip if the symbol is out of .text or blacklisted */
2530 if (!tev->point.symbol)
2531 continue;
2532
2533 /* Set new name for tev (and update namelist) */
2534 ret = probe_trace_event__set_name(tev, pev, namelist,
2535 allow_suffix);
2536 if (ret < 0)
2537 break;
2538
2539 ret = probe_file__add_event(fd, tev);
2540 if (ret < 0)
2541 break;
2542
2543 /*
2544 * Probes after the first probe which comes from same
2545 * user input are always allowed to add suffix, because
2546 * there might be several addresses corresponding to
2547 * one code line.
2548 */
2549 allow_suffix = true;
2550 }
2551 if (ret == -EINVAL && pev->uprobes)
2552 warn_uprobe_event_compat(tev);
2553
2554 strlist__delete(namelist);
2555 close_out:
2556 close(fd);
2557 return ret;
2558 }
2559
2560 static int find_probe_functions(struct map *map, char *name,
2561 struct symbol **syms)
2562 {
2563 int found = 0;
2564 struct symbol *sym;
2565 struct rb_node *tmp;
2566
2567 if (map__load(map, NULL) < 0)
2568 return 0;
2569
2570 map__for_each_symbol(map, sym, tmp) {
2571 if (strglobmatch(sym->name, name)) {
2572 found++;
2573 if (syms && found < probe_conf.max_probes)
2574 syms[found - 1] = sym;
2575 }
2576 }
2577
2578 return found;
2579 }
2580
2581 void __weak arch__fix_tev_from_maps(struct perf_probe_event *pev __maybe_unused,
2582 struct probe_trace_event *tev __maybe_unused,
2583 struct map *map __maybe_unused,
2584 struct symbol *sym __maybe_unused) { }
2585
2586 /*
2587 * Find probe function addresses from map.
2588 * Return an error or the number of found probe_trace_event
2589 */
2590 static int find_probe_trace_events_from_map(struct perf_probe_event *pev,
2591 struct probe_trace_event **tevs)
2592 {
2593 struct map *map = NULL;
2594 struct ref_reloc_sym *reloc_sym = NULL;
2595 struct symbol *sym;
2596 struct symbol **syms = NULL;
2597 struct probe_trace_event *tev;
2598 struct perf_probe_point *pp = &pev->point;
2599 struct probe_trace_point *tp;
2600 int num_matched_functions;
2601 int ret, i, j, skipped = 0;
2602 char *mod_name;
2603
2604 map = get_target_map(pev->target, pev->uprobes);
2605 if (!map) {
2606 ret = -EINVAL;
2607 goto out;
2608 }
2609
2610 syms = malloc(sizeof(struct symbol *) * probe_conf.max_probes);
2611 if (!syms) {
2612 ret = -ENOMEM;
2613 goto out;
2614 }
2615
2616 /*
2617 * Load matched symbols: Since the different local symbols may have
2618 * same name but different addresses, this lists all the symbols.
2619 */
2620 num_matched_functions = find_probe_functions(map, pp->function, syms);
2621 if (num_matched_functions == 0) {
2622 pr_err("Failed to find symbol %s in %s\n", pp->function,
2623 pev->target ? : "kernel");
2624 ret = -ENOENT;
2625 goto out;
2626 } else if (num_matched_functions > probe_conf.max_probes) {
2627 pr_err("Too many functions matched in %s\n",
2628 pev->target ? : "kernel");
2629 ret = -E2BIG;
2630 goto out;
2631 }
2632
2633 /* Note that the symbols in the kmodule are not relocated */
2634 if (!pev->uprobes && !pp->retprobe && !pev->target) {
2635 reloc_sym = kernel_get_ref_reloc_sym();
2636 if (!reloc_sym) {
2637 pr_warning("Relocated base symbol is not found!\n");
2638 ret = -EINVAL;
2639 goto out;
2640 }
2641 }
2642
2643 /* Setup result trace-probe-events */
2644 *tevs = zalloc(sizeof(*tev) * num_matched_functions);
2645 if (!*tevs) {
2646 ret = -ENOMEM;
2647 goto out;
2648 }
2649
2650 ret = 0;
2651
2652 for (j = 0; j < num_matched_functions; j++) {
2653 sym = syms[j];
2654
2655 tev = (*tevs) + ret;
2656 tp = &tev->point;
2657 if (ret == num_matched_functions) {
2658 pr_warning("Too many symbols are listed. Skip it.\n");
2659 break;
2660 }
2661 ret++;
2662
2663 if (pp->offset > sym->end - sym->start) {
2664 pr_warning("Offset %ld is bigger than the size of %s\n",
2665 pp->offset, sym->name);
2666 ret = -ENOENT;
2667 goto err_out;
2668 }
2669 /* Add one probe point */
2670 tp->address = map->unmap_ip(map, sym->start) + pp->offset;
2671
2672 /* Check the kprobe (not in module) is within .text */
2673 if (!pev->uprobes && !pev->target &&
2674 kprobe_warn_out_range(sym->name, tp->address)) {
2675 tp->symbol = NULL; /* Skip it */
2676 skipped++;
2677 } else if (reloc_sym) {
2678 tp->symbol = strdup_or_goto(reloc_sym->name, nomem_out);
2679 tp->offset = tp->address - reloc_sym->addr;
2680 } else {
2681 tp->symbol = strdup_or_goto(sym->name, nomem_out);
2682 tp->offset = pp->offset;
2683 }
2684 tp->realname = strdup_or_goto(sym->name, nomem_out);
2685
2686 tp->retprobe = pp->retprobe;
2687 if (pev->target) {
2688 if (pev->uprobes) {
2689 tev->point.module = strdup_or_goto(pev->target,
2690 nomem_out);
2691 } else {
2692 mod_name = find_module_name(pev->target);
2693 tev->point.module =
2694 strdup(mod_name ? mod_name : pev->target);
2695 free(mod_name);
2696 if (!tev->point.module)
2697 goto nomem_out;
2698 }
2699 }
2700 tev->uprobes = pev->uprobes;
2701 tev->nargs = pev->nargs;
2702 if (tev->nargs) {
2703 tev->args = zalloc(sizeof(struct probe_trace_arg) *
2704 tev->nargs);
2705 if (tev->args == NULL)
2706 goto nomem_out;
2707 }
2708 for (i = 0; i < tev->nargs; i++) {
2709 if (pev->args[i].name)
2710 tev->args[i].name =
2711 strdup_or_goto(pev->args[i].name,
2712 nomem_out);
2713
2714 tev->args[i].value = strdup_or_goto(pev->args[i].var,
2715 nomem_out);
2716 if (pev->args[i].type)
2717 tev->args[i].type =
2718 strdup_or_goto(pev->args[i].type,
2719 nomem_out);
2720 }
2721 arch__fix_tev_from_maps(pev, tev, map, sym);
2722 }
2723 if (ret == skipped) {
2724 ret = -ENOENT;
2725 goto err_out;
2726 }
2727
2728 out:
2729 put_target_map(map, pev->uprobes);
2730 free(syms);
2731 return ret;
2732
2733 nomem_out:
2734 ret = -ENOMEM;
2735 err_out:
2736 clear_probe_trace_events(*tevs, num_matched_functions);
2737 zfree(tevs);
2738 goto out;
2739 }
2740
2741 static int try_to_find_absolute_address(struct perf_probe_event *pev,
2742 struct probe_trace_event **tevs)
2743 {
2744 struct perf_probe_point *pp = &pev->point;
2745 struct probe_trace_event *tev;
2746 struct probe_trace_point *tp;
2747 int i, err;
2748
2749 if (!(pev->point.function && !strncmp(pev->point.function, "0x", 2)))
2750 return -EINVAL;
2751 if (perf_probe_event_need_dwarf(pev))
2752 return -EINVAL;
2753
2754 /*
2755 * This is 'perf probe /lib/libc.so 0xabcd'. Try to probe at
2756 * absolute address.
2757 *
2758 * Only one tev can be generated by this.
2759 */
2760 *tevs = zalloc(sizeof(*tev));
2761 if (!*tevs)
2762 return -ENOMEM;
2763
2764 tev = *tevs;
2765 tp = &tev->point;
2766
2767 /*
2768 * Don't use tp->offset, use address directly, because
2769 * in synthesize_probe_trace_command() address cannot be
2770 * zero.
2771 */
2772 tp->address = pev->point.abs_address;
2773 tp->retprobe = pp->retprobe;
2774 tev->uprobes = pev->uprobes;
2775
2776 err = -ENOMEM;
2777 /*
2778 * Give it a '0x' leading symbol name.
2779 * In __add_probe_trace_events, a NULL symbol is interpreted as
2780 * invalud.
2781 */
2782 if (asprintf(&tp->symbol, "0x%lx", tp->address) < 0)
2783 goto errout;
2784
2785 /* For kprobe, check range */
2786 if ((!tev->uprobes) &&
2787 (kprobe_warn_out_range(tev->point.symbol,
2788 tev->point.address))) {
2789 err = -EACCES;
2790 goto errout;
2791 }
2792
2793 if (asprintf(&tp->realname, "abs_%lx", tp->address) < 0)
2794 goto errout;
2795
2796 if (pev->target) {
2797 tp->module = strdup(pev->target);
2798 if (!tp->module)
2799 goto errout;
2800 }
2801
2802 if (tev->group) {
2803 tev->group = strdup(pev->group);
2804 if (!tev->group)
2805 goto errout;
2806 }
2807
2808 if (pev->event) {
2809 tev->event = strdup(pev->event);
2810 if (!tev->event)
2811 goto errout;
2812 }
2813
2814 tev->nargs = pev->nargs;
2815 tev->args = zalloc(sizeof(struct probe_trace_arg) * tev->nargs);
2816 if (!tev->args) {
2817 err = -ENOMEM;
2818 goto errout;
2819 }
2820 for (i = 0; i < tev->nargs; i++)
2821 copy_to_probe_trace_arg(&tev->args[i], &pev->args[i]);
2822
2823 return 1;
2824
2825 errout:
2826 if (*tevs) {
2827 clear_probe_trace_events(*tevs, 1);
2828 *tevs = NULL;
2829 }
2830 return err;
2831 }
2832
2833 bool __weak arch__prefers_symtab(void) { return false; }
2834
2835 static int convert_to_probe_trace_events(struct perf_probe_event *pev,
2836 struct probe_trace_event **tevs)
2837 {
2838 int ret;
2839
2840 if (!pev->group) {
2841 /* Set group name if not given */
2842 if (!pev->uprobes) {
2843 pev->group = strdup(PERFPROBE_GROUP);
2844 ret = pev->group ? 0 : -ENOMEM;
2845 } else
2846 ret = convert_exec_to_group(pev->target, &pev->group);
2847 if (ret != 0) {
2848 pr_warning("Failed to make a group name.\n");
2849 return ret;
2850 }
2851 }
2852
2853 ret = try_to_find_absolute_address(pev, tevs);
2854 if (ret > 0)
2855 return ret;
2856
2857 if (arch__prefers_symtab() && !perf_probe_event_need_dwarf(pev)) {
2858 ret = find_probe_trace_events_from_map(pev, tevs);
2859 if (ret > 0)
2860 return ret; /* Found in symbol table */
2861 }
2862
2863 /* Convert perf_probe_event with debuginfo */
2864 ret = try_to_find_probe_trace_events(pev, tevs);
2865 if (ret != 0)
2866 return ret; /* Found in debuginfo or got an error */
2867
2868 return find_probe_trace_events_from_map(pev, tevs);
2869 }
2870
2871 int convert_perf_probe_events(struct perf_probe_event *pevs, int npevs)
2872 {
2873 int i, ret;
2874
2875 /* Loop 1: convert all events */
2876 for (i = 0; i < npevs; i++) {
2877 /* Init kprobe blacklist if needed */
2878 if (!pevs[i].uprobes)
2879 kprobe_blacklist__init();
2880 /* Convert with or without debuginfo */
2881 ret = convert_to_probe_trace_events(&pevs[i], &pevs[i].tevs);
2882 if (ret < 0)
2883 return ret;
2884 pevs[i].ntevs = ret;
2885 }
2886 /* This just release blacklist only if allocated */
2887 kprobe_blacklist__release();
2888
2889 return 0;
2890 }
2891
2892 int apply_perf_probe_events(struct perf_probe_event *pevs, int npevs)
2893 {
2894 int i, ret = 0;
2895
2896 /* Loop 2: add all events */
2897 for (i = 0; i < npevs; i++) {
2898 ret = __add_probe_trace_events(&pevs[i], pevs[i].tevs,
2899 pevs[i].ntevs,
2900 probe_conf.force_add);
2901 if (ret < 0)
2902 break;
2903 }
2904 return ret;
2905 }
2906
2907 void cleanup_perf_probe_events(struct perf_probe_event *pevs, int npevs)
2908 {
2909 int i, j;
2910
2911 /* Loop 3: cleanup and free trace events */
2912 for (i = 0; i < npevs; i++) {
2913 for (j = 0; j < pevs[i].ntevs; j++)
2914 clear_probe_trace_event(&pevs[i].tevs[j]);
2915 zfree(&pevs[i].tevs);
2916 pevs[i].ntevs = 0;
2917 clear_perf_probe_event(&pevs[i]);
2918 }
2919 }
2920
2921 int add_perf_probe_events(struct perf_probe_event *pevs, int npevs)
2922 {
2923 int ret;
2924
2925 ret = init_probe_symbol_maps(pevs->uprobes);
2926 if (ret < 0)
2927 return ret;
2928
2929 ret = convert_perf_probe_events(pevs, npevs);
2930 if (ret == 0)
2931 ret = apply_perf_probe_events(pevs, npevs);
2932
2933 cleanup_perf_probe_events(pevs, npevs);
2934
2935 exit_probe_symbol_maps();
2936 return ret;
2937 }
2938
2939 int del_perf_probe_events(struct strfilter *filter)
2940 {
2941 int ret, ret2, ufd = -1, kfd = -1;
2942 char *str = strfilter__string(filter);
2943
2944 if (!str)
2945 return -EINVAL;
2946
2947 /* Get current event names */
2948 ret = probe_file__open_both(&kfd, &ufd, PF_FL_RW);
2949 if (ret < 0)
2950 goto out;
2951
2952 ret = probe_file__del_events(kfd, filter);
2953 if (ret < 0 && ret != -ENOENT)
2954 goto error;
2955
2956 ret2 = probe_file__del_events(ufd, filter);
2957 if (ret2 < 0 && ret2 != -ENOENT) {
2958 ret = ret2;
2959 goto error;
2960 }
2961 ret = 0;
2962
2963 error:
2964 if (kfd >= 0)
2965 close(kfd);
2966 if (ufd >= 0)
2967 close(ufd);
2968 out:
2969 free(str);
2970
2971 return ret;
2972 }
2973
2974 /* TODO: don't use a global variable for filter ... */
2975 static struct strfilter *available_func_filter;
2976
2977 /*
2978 * If a symbol corresponds to a function with global binding and
2979 * matches filter return 0. For all others return 1.
2980 */
2981 static int filter_available_functions(struct map *map __maybe_unused,
2982 struct symbol *sym)
2983 {
2984 if (strfilter__compare(available_func_filter, sym->name))
2985 return 0;
2986 return 1;
2987 }
2988
2989 int show_available_funcs(const char *target, struct strfilter *_filter,
2990 bool user)
2991 {
2992 struct map *map;
2993 int ret;
2994
2995 ret = init_probe_symbol_maps(user);
2996 if (ret < 0)
2997 return ret;
2998
2999 /* Get a symbol map */
3000 if (user)
3001 map = dso__new_map(target);
3002 else
3003 map = kernel_get_module_map(target);
3004 if (!map) {
3005 pr_err("Failed to get a map for %s\n", (target) ? : "kernel");
3006 return -EINVAL;
3007 }
3008
3009 /* Load symbols with given filter */
3010 available_func_filter = _filter;
3011 if (map__load(map, filter_available_functions)) {
3012 pr_err("Failed to load symbols in %s\n", (target) ? : "kernel");
3013 goto end;
3014 }
3015 if (!dso__sorted_by_name(map->dso, map->type))
3016 dso__sort_by_name(map->dso, map->type);
3017
3018 /* Show all (filtered) symbols */
3019 setup_pager();
3020 dso__fprintf_symbols_by_name(map->dso, map->type, stdout);
3021 end:
3022 if (user) {
3023 map__put(map);
3024 }
3025 exit_probe_symbol_maps();
3026
3027 return ret;
3028 }
3029
3030 int copy_to_probe_trace_arg(struct probe_trace_arg *tvar,
3031 struct perf_probe_arg *pvar)
3032 {
3033 tvar->value = strdup(pvar->var);
3034 if (tvar->value == NULL)
3035 return -ENOMEM;
3036 if (pvar->type) {
3037 tvar->type = strdup(pvar->type);
3038 if (tvar->type == NULL)
3039 return -ENOMEM;
3040 }
3041 if (pvar->name) {
3042 tvar->name = strdup(pvar->name);
3043 if (tvar->name == NULL)
3044 return -ENOMEM;
3045 } else
3046 tvar->name = NULL;
3047 return 0;
3048 }
This page took 0.155881 seconds and 6 git commands to generate.