stap-merge(1) — Linux manual page

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
       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         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 2024-06-14.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2024-06-13.)  If you discover 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)