stap-merge(1) [debian man page]

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

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
",
	      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), stapfuncs(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)

STAP(1) 						      General Commands Manual							   STAP(1)

NAME

       stapgraph - systemtap grapher

SYNOPSIS

       stapgraph [ OPTIONS ] FILENAME [ ARGUMENTS ]
       stapgraph [ OPTIONS ] - [ ARGUMENTS ]
       stapgraph [ OPTIONS ] -e SCRIPT [ ARGUMENTS ]

DESCRIPTION

       The stapgraph program is a simple frontend to stap that produces graphs from the output of stap scripts.

       This manual corresponds to version 1.7.

OPTIONS

       stapgraph accepts all options accepted by stap.	They are passed through to the stap process running the script or probe points.

USER INTERFACE

       The script that produces results can be started from a dialog within the program, in addition to being launched using the program's command
       line arguments. This dialog allows arguments to be passed to stap and to the script.

       When running, a mouse left click on a graph pauses the display of data, even though it is still collected  by  the  program.  Dragging  the
       mouse scrolls the graph backwards and forwards in time; clicking the displayed pause button restarts the display of new data.

       The scroll wheel can be used to zoom in and out on the graph.

SCRIPT OUTPUT SYNTAX

       Scripts can output  Comma Separated Values (CSV) which will be interpreted by stapgraph.  The first value is the X coordinate of the graph,
       usually a time value.  stapgraph assumes that this value is constantly increasing.

       A different syntax allows the script to specify many details of the graph's appearance.

       %DataSet: DATA-SET-NAME	SCALE  COLOR  GRAPHSTYLE

       The data set name identifies a data set that will be emitted by the script.  "SCALE" is the overall vertical scale of the  graph  for  this
       data  set.  "COLOR"  is a red-green-blue hex color. "GRAPHSTYLE" is one of bar - a traditional bar graph dot - plotted points discreet - An
       event style timeline that records that an event happened at a certain time.

       %Title: TITLE
	      A title for the whole graph.

       %XAxisTitle: TITLE
	      The legend for the X axis

       %YAxisTitle: TITLE
	      The legend for the Y axis.

       %YMax: MAX VALUE
	      The maximum value displayed on the graph.

GRAPH DATA

	DATA SET  TIME	VALUE Each data point that is to be plotted is tagged with the data set name, followed by the time and value of the point.

SEE ALSO

       stap(3stap), staprun(3stap),

BUGS

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

Red Hat 							    2013-05-14								   STAP(1)