Add a "FETCH" command to RRDCacheD which behaves like a (simplified
[rrdtool.git] / doc / rrdcached.pod
index 57eb655..3f72a23 100644 (file)
@@ -19,7 +19,7 @@ B<rrdcached>
 [-F]
 [-g]
 [B<-b>E<nbsp>I<base_dir>E<nbsp>[B<-B>]]
-[B<-m>E<nbsp>I<alloc_size>]
+[B<-a>E<nbsp>I<alloc_size>]
 
 =head1 DESCRIPTION
 
@@ -234,7 +234,7 @@ Only permit writes into the base directory specified in B<-b> (and any
 sub-directories).  This does B<NOT> detect symbolic links.  Paths
 containing C<../> will also be blocked.
 
-=item B<-m> I<alloc_size>
+=item B<-a> I<alloc_size>
 
 Allocate value pointers in chunks of I<alloc_size>.  This may improve CPU
 utilization on machines with slow C<realloc()> implementations, in
@@ -522,6 +522,13 @@ returns immediately, even though the writes may take a long time.
 Shows any "pending" updates for a file, in order.  The updates shown have
 not yet been written to the underlying RRD file.
 
+=item B<FETCH> I<filename> I<CF> [I<start> [I<end>]]
+
+Calls C<rrd_fetch> with the specified arguments and returns the result in text
+form. If necessary, the file is flushed to disk first. The client side function
+C<rrdc_fetch> (declared in C<rrd_client.h>) parses the output and behaves just
+like C<rrd_fetch_r> for easy integration of remote queries.
+
 =item B<FORGET> I<filename>
 
 Removes I<filename> from the cache.  Any pending updates B<WILL BE LOST>.