Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   26626 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

STAP(1)								       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  dis‐
       played 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 inter‐
       preted 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				  2012-10-04			       STAP(1)

Vote for polarhome