X-Git-Url: https://git.octo.it/?p=rrdtool.git;a=blobdiff_plain;f=doc%2Frrdlast.pod;h=f0eaad0c7d86ed761f738f977db35fad89c5576d;hp=20e20daae364a9e4c44572381423c17d4b9cbc6e;hb=65b54b38e49ad2b56672111c039a5777cea98e40;hpb=5837606887a6d81e8b1f7588525cb1c8783fb62b

diff --git a/doc/rrdlast.pod b/doc/rrdlast.pod
index 20e20da..f0eaad0 100644
--- a/doc/rrdlast.pod
+++ b/doc/rrdlast.pod
@@ -1,17 +1,16 @@
 =head1 NAME
 
-rrdtool last - Return the date of the last data sample in an B<RRD>
-
-=for html <div align="right"><a href="rrdlast.pdf">PDF</a> version.</div>
+rrdlast - Return the date of the last data sample in an RRD
 
 =head1 SYNOPSIS
 
 B<rrdtool> B<last> I<filename>
+S<[B<--daemon> I<address>]>
 
 =head1 DESCRIPTION
 
-The B<last> function returns the UNIX timestamp when the RRD was last
-updated.
+The B<last> function returns the UNIX timestamp of the most recent
+update of the RRD.
 
 =over 8
 
@@ -19,11 +18,42 @@ updated.
 
 The name of the B<RRD> that contains the data.
 
+=item B<--daemon> I<address>
+
+Address of the L<rrdcached> 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.
+For a list of accepted formats, see the B<-l> option in the L<rrdcached> manual.
+
+ rrdtool last --daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd
+
+=item B<--noflush> 
+
+If the L<rrdcached> daemon is being used, then omit the flush normally 
+send before returning the last update.  If you add this option, you get the 
+last time the file on disk was updated; if you have relatively low cache times
+and are calling this frequently it will preserve the caching benefit
+
+=back
+
+=head1 ENVIRONMENT VARIABLES
+
+The following environment variables may be used to change the behavior of
+C<rrdtoolE<nbsp>last>:
+
+=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
 
 Russ Wright <rwwright@home.com>
-
+Daemon support added by Steve Shipway <steve@steveshipway.org>