NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | FILES | SEE ALSO | BUGS | COLOPHON

STAP-MERGE(1)              General Commands Manual             STAP-MERGE(1)

NAME         top

       stap-merge - systemtap per-cpu binary merger

SYNOPSIS         top

       stap-merge [ OPTIONS ] [ INPUT FILENAMES ]

DESCRIPTION         top

       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         top

       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         top

              $ 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 num‐
       ber 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         top

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

SEE ALSO         top

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

BUGS         top

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

COLOPHON         top

       This page is part of the systemtap (a tracing and live-system
       analysis tool) project.  Information about the project can be found
       at ⟨https://sourceware.org/systemtap/⟩.  If you have a bug report for
       this manual page, send it to systemtap@sourceware.org.  This page was
       obtained from the project's upstream Git repository 
       ⟨git://sourceware.org/git/systemtap.git⟩ on 2017-09-15.  If you dis‐
       cover any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail
       to man-pages@man7.org

                                                               STAP-MERGE(1)