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              [cpunumber,sequencenumberofdata,thelengthofthedataset]
27
28       -o OUTPUT_FILENAME
29
30              Specify  the  name  of  the file you would like the output to be
31              redirected into.  If this option is not specified than the  out‐
32              put will be pushed to standard out.
33
34

EXAMPLES

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

FILES

54       Important files and their corresponding paths can be located in the
55              stappaths (7) manual page.
56
57

SEE ALSO

59       stapprobes(3stap), stapfuncs(3stap),  stappaths(7),  staprun(8),  stap‐
60       vars(3stap), stapex(3stap), stap-server(8), gdb(1)
61
62

BUGS

64       Use  the  Bugzilla  link  of  the project web page or our mailing list.
65       http://sourceware.org/systemtap/,<systemtap@sourceware.org>.
66
67
68
69                                                                 STAP-MERGE(1)
Impressum