X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=doc%2Frrdfetch.pod;h=51b5ccd99c8441f8f7f12021836ba22a902ccc56;hb=7bd35b8d099910071a57c66687f6ef79c5df9a5c;hp=6eb10d140921bb768ecac32159a9dd09e402fed0;hpb=4b7345f9345915c8061e4b37b26ce8887828c973;p=rrdtool.git diff --git a/doc/rrdfetch.pod b/doc/rrdfetch.pod index 6eb10d1..51b5ccd 100644 --- a/doc/rrdfetch.pod +++ b/doc/rrdfetch.pod @@ -4,10 +4,10 @@ rrdfetch - Fetch data from an RRD. =head1 SYNOPSIS -B B I I -S<[B<--resolution>|B<-r> I]> -S<[B<--start>|B<-s> I]> -S<[B<--end>|B<-e> I]> +B B I I +S<[B<--resolution>|B<-r> I]> +S<[B<--start>|B<-s> I]> +S<[B<--end>|B<-e> I]> =head1 DESCRIPTION @@ -20,11 +20,11 @@ function. =over 8 -=item I +=item I the name of the B you want to fetch the data from. -=item I +=item I the consolidation function that is applied to the data you want to fetch (AVERAGE,MIN,MAX,LAST) @@ -52,8 +52,8 @@ specify the end time. =head2 RESOLUTION INTERVAL -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 +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 desired resolution. Consider the following example: rrdtool create subdata.rrd -s 10 DS:ds0:GAUGE:300:0:U \ @@ -92,10 +92,10 @@ both start and end time are within the desired RRA =back -So, if time now is called "t", do +So, if time now is called "t", do end time == int(t/900)*900, - start time == end time - 1hour, + start time == end time - 1hour, resolution == 900. Using the bash shell, this could look be: @@ -103,7 +103,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: @@ -135,14 +135,12 @@ or just B. You can suffix it with B or B or use including B (00:00), B (12:00) and British B (16:00). -=for comment -XXX Wouldn't it be nice to have z'N\"uni and z'Vieri for Switzerland? - -The I can be specified as I I -and optional a 2- or 4-digit I number (e.g. March 8 1999). -Alternatively, you can use I (e.g. Monday), -or one of the words: B, B, B. -You can also specify the I as a full date in several numerical formats, including B, B, or B. +The I can be specified as I I and +optional a 2- or 4-digit I number (e.g. March 8 1999). Alternatively, +you can use I (e.g. Monday), or one of the words: +B, B, B. You can also specify the I as a +full date in several numerical formats, including B, +B, or B. I: this is different from the original at(1) behavior, where a single-number date is interpreted as MMDD[YY]YY. @@ -261,4 +259,4 @@ I<19970703 12:45> -- 12:45 July 3th, 1997 =head1 AUTHOR -Tobias Oetiker +Tobias Oetiker