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
       produce 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)