X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=doc%2Frrdgraph-old.pod;h=ef730c4560022af4b88ee5c206ec34e0e74f77a1;hb=e6271afb13033053281a06abda00e06bd007fba6;hp=8e8038e98c1b56e1253d73907fd3a8b629fc1678;hpb=b7c278771851b0dfad0daf1c817fbc93316ef96e;p=rrdtool.git diff --git a/doc/rrdgraph-old.pod b/doc/rrdgraph-old.pod index 8e8038e..ef730c4 100644 --- a/doc/rrdgraph-old.pod +++ b/doc/rrdgraph-old.pod @@ -11,23 +11,23 @@ S<[B<-s>|B<--start> I]> S<[B<-e>|B<--end> I]> S<[B<-x>|B<--x-grid> I]> S<[B<-y>|B<--y-grid> I]> -S<[B<--alt-y-grid>]> -S<[B<--alt-autoscale>]> -S<[B<--alt-autoscale-max>]> -S<[B<--units-exponent>]> I]> +S<[B<-Y>|B<--alt-y-grid>]> +S<[B<-A>|B<--alt-autoscale>]> +S<[B<-M>|B<--alt-autoscale-max>]> +S<[B<-X>|B<--units-exponent>]> I]> S<[B<-v>|B<--vertical-label> I]> S<[B<-w>|B<--width> I]> S<[B<-h>|B<--height> I]> S<[B<-i>|B<--interlaced>]> S<[B<-f>|B<--imginfo> I]> -S<[B<-a>|B<--imgformat> B|B]> +S<[B<-a>|B<--imgformat> B|B]> S<[B<-z>|B<--lazy>]> S<[B<-o>|B<--logarithmic>]> S<[B<-u>|B<--upper-limit> I]> S<[B<-l>|B<--lower-limit> I]> S<[B<-g>|B<--no-legend>]> S<[B<-r>|B<--rigid>]> -S<[B<--step> I]> +S<[B<-S>|B<--step> I]> S<[B<-b>|B<--base> I]> S<[B<-c>|B<--color> IB<#>I]> S<[B<-t>|B<--title> I]> @@ -54,14 +54,11 @@ from generating graphs, it can also extract numerical reports. =item I The name of the graph to generate. Since B outputs -GIFs and PNGs, it's recommended that the filename end in either -F<.gif> or F<.png>. B does not enforce this, however. +SVGs and PNGs, it's recommended that the filename end in either +F<.svg> or F<.png>. B does not enforce this, however. If the I is set to '-' the image file will be written to standard out. All other output will get suppressed. -PNG output is recommended, since it takes up to 40% less disk space -and 20-30% less time to generate than a GIF file. - If no graph functions are called, the graph will not be created. =item B<-s>|B<--start> I (default end-1day) @@ -170,20 +167,20 @@ specify the units used. =item B<-w>|B<--width> I (default 400 pixel) Width of the drawing area within the graph. This affects the size of the -gif. +image. =item B<-h>|B<--height> I (default 100 pixel) Width of the drawing area within the graph. This affects the size of the -gif. +image. =item B<-i>|B<--interlaced> (default: false) -If you set this option, then the resulting GIF will be interlaced. +If you set this option, then the resulting image will be interlaced. Most web browsers display these incrementally as they load. If -you do not use this option, the GIFs default to being progressive +you do not use this option, the image defaults to being progressive scanned. The only effect of this option is to control the format -of the GIF on disk. It makes no changes to the layout or contents +of the image on disk. It makes no changes to the layout or contents of the graph. =item B<-f>|B<--imginfo> I @@ -197,13 +194,13 @@ would look like this: --imginfo 'Demo' -=item B<-a>|B<--imgformat> B|B (default: GIF) +=item B<-a>|B<--imgformat> B|B (default: PNG) Allows you to produce PNG output from rrdtool. =item B<-z>|B<--lazy> (default: false) -Only generate the graph, if the current gif is out of date or not +Only generate the graph, if the current image is out of date or not existent. =item B<-u>|B<--upper-limit> I (default autoconfigure) @@ -363,6 +360,13 @@ Push I<*UNKNOWN*> if its at the first value of a data set or otherwise the value of this CDEF at the previous time step. This allows you to perform calculations across the data. +=item COUNT + +Pushes the number 1 if it is at the first value of the data set, the +number 2 if it is at the second, and so on. This special value, allows +you to make calculations based on the position of the value within +the data set. + =item INF, NEGINF Push a positive or negative infinite (oo) value onto the stack. When @@ -402,7 +406,7 @@ message but not a I fourtytwo that's always equal to 42. Calculate the chosen consolidation function I over the data-source variable I and C the result to stdout using I. -In the I string there should be a '%lf' or '%le' marker in the +In the I string there should be a '%lf', '%le' or'%lg' marker in the place where the number should be printed. If an additional '%s' is found AFTER the marker, the value will be scaled @@ -521,11 +525,11 @@ before placing the next row of legends. =head1 NOTE on Return Values Whenever rrd_graph gets called, it prints a line telling the size of -the gif it has just created to STDOUT. This line looks like this: XSIZExYSIZE. +the image it has just created to STDOUT. This line looks like this: XSIZExYSIZE. =head1 EXAMPLE 1 - rrdtool graph demo.gif --title="Demo Graph" \ + rrdtool graph demo.png --title="Demo Graph" \ DEF:cel=demo.rrd:exhaust:AVERAGE \ "CDEF:far=cel,1.8,*,32,+"" \ LINE2:cel#00a000:"D. Celsius" \ @@ -538,7 +542,7 @@ I<*UNKNOWN*> values to 0. This technique is useful if you are aggregating interface data where the start dates of the data sets doesn't match. - rrdtool graph demo.gif --title="Demo Graph" \ + rrdtool graph demo.png --title="Demo Graph" \ DEF:idat1=interface1.rrd:ds0:AVERAGE \ DEF:idat2=interface2.rrd:ds0:AVERAGE \ DEF:odat1=interface1.rrd:ds1:AVERAGE \ @@ -602,7 +606,7 @@ If the specialized function B exist for aberrant behavior detection, they can be used to generate the graph of a time series with confidence bands and failures. - rrdtool graph example.gif \ + rrdtool graph example.png \ DEF:obs=monitor.rrd:ifOutOctets:AVERAGE \ DEF:pred=monitor.rrd:ifOutOctets:HWPREDICT \ DEF:dev=monitor.rrd:ifOutOctets:DEVPREDICT \