X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=doc%2Frrdfetch.pod;h=80053f3a2cd3405e99df1b3c9953fe3b023ef35c;hb=1f8fb56f90e611d4b636c8cb32d0dfbae4afeeb2;hp=0b57340ca0c0721c3b76fda6784ac08c70b2c8ab;hpb=d53241d45f61489bd1bd2fb1aab5e6183db6009d;p=rrdtool.git diff --git a/doc/rrdfetch.pod b/doc/rrdfetch.pod index 0b57340..80053f3 100644 --- a/doc/rrdfetch.pod +++ b/doc/rrdfetch.pod @@ -1,6 +1,6 @@ =head1 NAME -rrdtool fetch - fetch data from an rrd. +rrdfetch - Fetch data from an RRD. =for html
PDF version.
@@ -17,7 +17,7 @@ The B function is normally used internally by the graph function, to get data from Bs. B will analyze the B and will try to retrieve the data in the resolution requested. The data fetched is printed to stdout. I<*UNKNOWN*> data is often -represented by the string "NaN" depending on your OSs printf +represented by the string "NaN" depending on your OS's printf function. =over 8 @@ -54,7 +54,7 @@ end time. =head2 RESOLUTION INTERVAL -In order to get rrdtool to fetch anything other than the finest resolution RRA +In order to get RRDtool to fetch anything other than the finest resolution RRA B the start and end time must be specified on boundaries that are multiples of the wanted resolution. Consider the following example: @@ -102,7 +102,7 @@ In e.g. bash this could look as: TIME=$(date +%s); RRDRES=900; rrdtool fetch subdata.rrd AVERAGE -r $RRDRES \ -e $(echo $(($TIME/$RRDRES*$RRDRES))) -s e-1h -Or in perl: +Or in Perl: perl -e '$ctime = time; $rrdres = 900; system "rrdtool fetch subdata.rrd AVERAGE \ -r $rrdres -e @{[int($ctime/$rrdres)*$rrdres]} -s e-1h"' @@ -110,7 +110,7 @@ Or in perl: =head2 AT-STYLE TIME SPECIFICATION -Apart from the traditional I, rrdtool does also +Apart from the traditional I, RRDtool does also understand at-style time specification. The specification is called "at-style" after Unix command at(1) that has moderately complex ways to specify time to run your job at. The at-style specification @@ -148,7 +148,7 @@ Finally, you can use words B, B, or B as your time reference. B refers to the current moment (and is also a default time reference). B (B) can be used to specify time relative to the start (end) time for those tools that use these -categories (rrdfetch, rrdgraph). +categories (B, L). Month and weekday names can be used in their naturally abbreviated form (e.g., Dec for December, Sun for Sunday, etc.). The words B, @@ -248,8 +248,7 @@ I<931225537> -- 18:45 July 5th, 1999 (yes, seconds since 1970 are valid as well) I<19970703 12:45> -- 12:45 July 3th, 1997 -(not quote standard, but I love this ...) - +(my favorite, and its even got an ISO number (8601)) =head1 AUTHOR