X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=doc%2Frrdfetch.pod;h=9ef417a24b85c4158d84cbb0a778d86d5fc0510b;hb=23c3b21499345ac8450166291773c5f6f136099c;hp=3611928b9c122ce64de2a7288956cded462556e7;hpb=342b22c3e74a10d7049285c2cea7383676bcfc95;p=rrdtool.git

diff --git a/doc/rrdfetch.pod b/doc/rrdfetch.pod
index 3611928..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>
+
+Address of the L<rrdcached(1)> daemon. If specified, a C<flush> command is sent
+to the server before reading the RRD files. This allows B<rrdtool> 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<unix:>, see example below. Other
+addresses are interpreted as normal network addresses, i.E<nbsp>e. 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
+C<rrdtoolE<nbsp>fetch>:
+
+=over 4
+
+=item B<RRDCACHED_ADDRESS>
+
+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 <tobi@oetiker.ch>