X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=doc%2Frrdfetch.pod;h=9ef417a24b85c4158d84cbb0a778d86d5fc0510b;hb=c68ae5a3674d315df30bc7729b3d89fa7ab83923;hp=7ebd9d603bb84dc0705f0c2a621fb6343b03be48;hpb=cb092381724e4ba8a1f18712fefc541a3d370f99;p=rrdtool.git diff --git a/doc/rrdfetch.pod b/doc/rrdfetch.pod index 7ebd9d6..9ef417a 100644 --- a/doc/rrdfetch.pod +++ b/doc/rrdfetch.pod @@ -48,6 +48,17 @@ the end of the time series in seconds since epoch. See also AT-STYLE TIME SPECIFICATION section for a detailed explanation of how to specify the end time. +=item B<--daemon> I
+ +Address of the L daemon. If specified, a C command is sent +to the server before reading the RRD files. This allows B to return +fresh data even if the daemon is configured to cache values for a long time. To +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 + =back =head2 RESOLUTION INTERVAL @@ -103,7 +114,7 @@ Using the bash shell, this could look be: TIME=$(date +%s) RRDRES=900 rrdtool fetch subdata.rrd AVERAGE -r $RRDRES \ - -e $(echo $(($TIME/$RRDRES*$RRDRES))) -s e-1h + -e $(($TIME/$RRDRES*$RRDRES)) -s e-1h Or in Perl: @@ -257,6 +268,21 @@ I<931225537> -- 18:45 July 5th, 1999 I<19970703 12:45> -- 12:45 July 3th, 1997 (my favorite, and its even got an ISO number (8601)). +=head1 ENVIRONMENT VARIABLES + +The following environment variables may be used to change the behavior of +Cfetch>: + +=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 AUTHOR -Tobias Oetiker +Tobias Oetiker