Provided by: systemtap-runtime_2.3-1ubuntu1.4_amd64 bug

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)