invoke-plot_summary.texi revision 290000
1159248Srwatson@node plot_summary Invocation 2159248Srwatson@section Invoking plot_summary 3159248Srwatson@pindex plot_summary 4159248Srwatson@cindex plot statistics generated by summary script 5159248Srwatson@ignore 6159248Srwatson# 7159248Srwatson# EDIT THIS FILE WITH CAUTION (invoke-plot_summary.texi) 8159248Srwatson# 9159248Srwatson# It has been AutoGen-ed October 21, 2015 at 12:34:48 PM by AutoGen 5.18.5 10159248Srwatson# From the definitions plot_summary-opts.def 11159248Srwatson# and the template file agtexi-cmd.tpl 12159248Srwatson@end ignore 13168777Srwatson 14159248Srwatson 15159248SrwatsonThis section was generated by @strong{AutoGen}, 16159248Srwatsonusing the @code{agtexi-cmd} template and the option descriptions for the @code{plot_summary} program. 17159248Srwatson 18159248Srwatson@menu 19159248Srwatson* plot_summary usage:: plot_summary help/usage (@option{--help}) 20159248Srwatson* plot_summary directory:: directory option 21159248Srwatson* plot_summary identifier:: identifier option 22159248Srwatson* plot_summary peer:: peer option 23159248Srwatson* plot_summary plot-term:: plot-term option 24159248Srwatson* plot_summary output-file:: output-file option 25159248Srwatson* plot_summary exit status:: exit status 26168777Srwatson@end menu 27159248Srwatson 28159248Srwatson@node plot_summary usage 29159248Srwatson@subsection plot_summary help/usage (@option{--help}) 30159248Srwatson@cindex plot_summary help 31159248Srwatson 32162503SrwatsonThis is the automatically generated usage text for plot_summary. 33162503Srwatson 34162503SrwatsonThe text printed is the same whether selected with the @code{help} option 35159248Srwatson(@option{--help}) or the @code{more-help} option (@option{--more-help}). @code{more-help} will print 36162503Srwatsonthe usage text by passing it through a pager program. 37168777Srwatson@code{more-help} is disabled on platforms without a working 38159248Srwatson@code{fork(2)} function. The @code{PAGER} environment variable is 39159248Srwatsonused to select the program, defaulting to @file{more}. Both will exit 40159248Srwatsonwith a status code of 0. 41168777Srwatson 42159248Srwatson@exampleindent 0 43168777Srwatson@example 44159248Srwatsonplot_summary - plot statistics generated by summary script - Ver. 4.2.8p4 45159248SrwatsonUSAGE: plot_summary [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... 46159248Srwatson 47159248Srwatson --directory=str Where the summary files are 48159248Srwatson --identifier=str Origin of the data 49159248Srwatson --offset-limit=float Limit of absolute offset 50159248Srwatson --peer=str Peers to generate plots for 51159248Srwatson - may appear multiple times 52159248Srwatson --plot-term=str Gnuplot terminal 53159248Srwatson --output-file=str Output file 54159248Srwatson --dont-wait Don't wait for keystroke between plots 55159248Srwatson -?, --help Display usage information and exit 56159248Srwatson --more-help Pass the extended usage text through a pager 57159248Srwatson 58159248SrwatsonOptions are specified by doubled hyphens and their name or by a single 59159248Srwatsonhyphen and the flag character. 60159248Srwatson@end example 61159248Srwatson@exampleindent 4 62159248Srwatson 63159248Srwatson@node plot_summary directory 64159248Srwatson@subsection directory option 65159248Srwatson@cindex plot_summary-directory 66159248Srwatson 67159248SrwatsonThis is the ``where the summary files are'' option. 68159248SrwatsonThis option takes a string argument. 69159248Srwatson The directory where the @code{plot_summary} will search for the 70159248Srwatson *_summary files generated by @code{summary} script. 71159248Srwatson@node plot_summary identifier 72159248Srwatson@subsection identifier option 73159248Srwatson@cindex plot_summary-identifier 74159248Srwatson 75159248SrwatsonThis is the ``origin of the data'' option. 76168777SrwatsonThis option takes a string argument. 77159248Srwatson Where does the plotted data come from, default to string "host" plus 78159248Srwatson current hostname 79159248Srwatson@node plot_summary peer 80159248Srwatson@subsection peer option 81159248Srwatson@cindex plot_summary-peer 82159248Srwatson 83159248SrwatsonThis is the ``peers to generate plots for'' option. 84168777SrwatsonThis option takes a string argument. 85159248Srwatson 86159248Srwatson@noindent 87159248SrwatsonThis option has some usage constraints. It: 88159248Srwatson@itemize @bullet 89159248Srwatson@item 90159248Srwatsonmay appear an unlimited number of times. 91168777Srwatson@end itemize 92159248Srwatson 93159248Srwatson By default the peer_summary plots are not generated. Use this option to 94168777Srwatson specify list of peers if you want to generate plots for them. 95159248Srwatson@node plot_summary plot-term 96159248Srwatson@subsection plot-term option 97159248Srwatson@cindex plot_summary-plot-term 98159248Srwatson 99159248SrwatsonThis is the ``gnuplot terminal'' option. 100168777SrwatsonThis option takes a string argument. 101159248Srwatson This is string is passed directly to the @code{gnuplot set terminal} 102168777Srwatson command. Default is @code{x11} if @code{DISPLAY} is set and 103159248Srwatson @code{dumb} is it's not'. See output from @code(gnuplot -e "set 104168777Srwatson terminal") for the list of avalaible options. 105168777Srwatson@node plot_summary output-file 106159248Srwatson@subsection output-file option 107168777Srwatson@cindex plot_summary-output-file 108159248Srwatson 109159248SrwatsonThis is the ``output file'' option. 110159248SrwatsonThis option takes a str argument. 111159248Srwatson Output file for @code{gnuplot}, default to stdout. 112159248Srwatson@node plot_summary exit status 113159248Srwatson@subsection plot_summary exit status 114159248Srwatson 115159248SrwatsonOne of the following exit values will be returned: 116159248Srwatson@table @samp 117159248Srwatson@item 0 (EXIT_SUCCESS) 118159248SrwatsonSuccessful program execution. 119159248Srwatson@item 1 (EXIT_FAILURE) 120159248SrwatsonThe operation failed or the command syntax was not valid. 121159248Srwatson@end table 122159248Srwatson