NAME

       stap-merge - systemtap per-cpu binary merger

SYNOPSIS

       stap-merge [ OPTIONS ] [ INPUT FILENAMES ]

DESCRIPTION

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

OPTIONS

       The systemtap merge executable supports the following options.

       -v     Verbose mode, displays three extra fields per set of collected data.

              [cpunumber,sequencenumberofdata,thelengthofthedataset]

       -o OUTPUT_FILENAME

              Specify  the  name of the file you would like the output to be redirected into.  If this option is
              not specified than the output will be pushed to standard out.

EXAMPLES

              $ stap -v -b -e 'probe syscall.open { printf("%s(%d) open\n",
              execname(), pid()) }'

       This should result in several stpd_cpu files (each labled with a number representing which cpu  the  file
       was produced from).

              $ stap-merge -v stpd_cpu0 stpd_cpu1

       Running the stap-merge program in the same directory as the stap script earlier in the example, will pro‐
       duce  an ordered sequence of packets with the three part label for each set of data.  This result will be
       pushed through the standard output.  An output file could have been specified using the "-o" option.

FILES

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

SEE ALSO

       stapprobes(3stap),
       stappaths(7),
       staprun(8),
       stapvars(3stap),
       stapex(3stap),
       stap-server(8),
       gdb(1)

BUGS

       Use    the    Bugzilla    link    of    the    project    web    page    or     our     mailing     list.
       http://sourceware.org/systemtap/,<systemtap@sourceware.org>.

                                                                                                   STAP-MERGE(1)