1STAP-MERGE(1)               General Commands Manual              STAP-MERGE(1)
2
3
4

NAME

6       stap-merge - systemtap per-cpu binary merger
7
8
9

SYNOPSIS

11       stap-merge [ OPTIONS ] [ INPUT FILENAMES ]
12
13

DESCRIPTION

15       The  stap-merge  executable  applies  when  the -b option has been used
16       while running a  stap  script.   The  -b  option  will  generate  files
17       per-cpu,  based  on the timestamp field. Then stap-merge will merge and
18       sort through the per-cpu files based on the timestamp field.
19
20

OPTIONS

22       The systemtap merge executable supports the following options.
23
24       -v     Verbose mode, displays three extra fields per set  of  collected
25              data.
26
27              [cpunumber,sequencenumberofdata,thelengthofthedataset]
28
29
30       -o OUTPUT_FILENAME
31
32              Specify  the  name  of  the file you would like the output to be
33              redirected into.  If this option is not specified than the  out‐
34              put will be pushed to standard out.
35
36

EXAMPLES

38              $ stap -v -b -e 'probe syscall.open { printf("%s(%d) open\n",
39              execname(), pid()) }'
40
41
42
43       This should result in several stpd_cpu files (each labled with a number
44       representing which cpu the file was produced from).
45
46
47              $ stap-merge -v stpd_cpu0 stpd_cpu1
48
49
50
51       Running the stap-merge program in the same directory as the stap script
52       earlier  in  the  example,  will produce an ordered sequence of packets
53       with the three part label for each set of data.  This  result  will  be
54       pushed  through  the  standard  output.  An output file could have been
55       specified using the "-o" option.
56
57

FILES

59       Important files and their corresponding paths can be located in the
60              stappaths (7) manual page.
61
62

SEE ALSO

64       stapprobes(3stap),
65       stappaths(7),
66       staprun(8),
67       stapvars(3stap),
68       stapex(3stap),
69       stap-server(8),
70       gdb(1)
71
72

BUGS

74       Use the Bugzilla link of the project web  page  or  our  mailing  list.
75       http://sourceware.org/systemtap/,<systemtap@sourceware.org>.
76
77
78
79                                                                 STAP-MERGE(1)
Impressum