X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=doc%2Frrdgraph.pod;h=1d6081ddc0a45d36200deb3cfabb6ce5975b55f3;hb=8fdbf4660969f9bde7f0f434f2d1002028d36814;hp=592cb9b76ceff102d59f60017638ce48776622ad;hpb=6d19d9d651c2b710f26ba98417f280d1b6cd9cf4;p=rrdtool.git diff --git a/doc/rrdgraph.pod b/doc/rrdgraph.pod index 592cb9b..1d6081d 100644 --- a/doc/rrdgraph.pod +++ b/doc/rrdgraph.pod @@ -43,7 +43,7 @@ it. For instance, you might be collecting B per second, but want to display B per second. This is what the B> command is designed for. After B the data, a copy is made and this copy is modified -using a rather powerful B> command set. +using a rather powerful B> command set. When you are done fetching and processing the data, it is time to graph it (or print it). This ends the B sequence. @@ -77,7 +77,7 @@ The start and end of the time series you would like to display, and which B the data should come from. Defaults are: 1 day ago until now, with the best possible resolution. B and B can be specified in several formats, see -L and L. +L and L. By default, B calculates the width of one pixel in the time domain and tries to get data from an B with that resolution. With the B option you can alter this behaviour. @@ -262,8 +262,10 @@ Note that for linear graphs, SI notation is used by default. [B<-z>|B<--lazy>] -Only generate the graph if the current graph is out of date or not -existent. +Only generate the graph if the current graph is out of date or not existent. +Note, that only the image size will be returned, if you run with lazy even +when using graphv and even when using PRINT. + [B<--daemon> I
] @@ -274,7 +276,7 @@ specify a UNIX domain socket use the prefix C, see example below. Other addresses are interpreted as normal network addresses, i.Ee. IPv4 or IPv6 addresses in most cases. - rrdtool fetch --daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd AVERAGE + rrdtool graph [...] --daemon unix:/var/run/rrdcached.sock [...] [B<-f>|B<--imginfo> I] @@ -361,7 +363,7 @@ no text is rendered bitmapped. All text in rrdtool is rendered using Pango. With the B<--pango-markup> option, all text will be processed by pango markup. This allows to embed some simple html like markup tags using - + text Apart from the verbose syntax, there are also the following short tags available. @@ -375,7 +377,7 @@ Apart from the verbose syntax, there are also the following short tags available small Makes font relatively smaller, equivalent to tt Monospace font u Underline - + More details on L. [B<-G>|B<--graph-render-mode> {B,B}] @@ -443,15 +445,12 @@ You need at least one B statement to generate anything. The other statements are useful but optional. See L and L for the exact format. -=head2 Graph and print elements +NOTE: B You need at least one graph element to generate an image and/or at least one print statement to generate a report. See L for the exact format. - -=back - =head2 graphv Calling rrdtool with the graphv option will return information in the @@ -480,6 +479,21 @@ There is more information returned than in the standard interface. Especially the 'graph_*' keys are new. They help applications that want to know what is where on the graph. +=head1 ENVIRONMENT VARIABLES + +The following environment variables may be used to change the behavior of +Cgraph>: + +=over 4 + +=item B + +If this environment variable is set it will have the same effect as specifying +the C<--daemon> option on the command line. If both are present, the command +line argument takes precedence. + +=back + =head1 SEE ALSO L gives an overview of how B works.