Code

Imported Upstream version 1.4.7
[pkg-rrdtool.git] / doc / rrdfetch.1
index 7488b4d0710b964a90eb854b9425a316dbffad36..f23095c7a79927bf0ccbc081f36db3099d69b459 100644 (file)
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.05)
+.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
 .\" ========================================================================
 .\"
 .IX Title "RRDFETCH 1"
-.TH RRDFETCH 1 "2008-09-25" "1.4.3" "rrdtool"
+.TH RRDFETCH 1 "2010-11-11" "1.4.7" "rrdtool"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
@@ -276,11 +276,16 @@ single-number date is interpreted as MMDD[\s-1YY\s0]YY.
 \&\fI\s-1NOTE2\s0\fR: if you specify the \fIday\fR in this way, the \fItime-of-day\fR is
 \&\s-1REQUIRED\s0 as well.
 .PP
-Finally, you can use the words \fBnow\fR, \fBstart\fR, or \fBend\fR as your time
+Finally, you can use the words \fBnow\fR, \fBstart\fR, \fBend\fR or \fBepoch\fR as your time
 reference. \fBNow\fR refers to the current moment (and is also the default
 time reference). \fBStart\fR (\fBend\fR) can be used to specify a time
 relative to the start (end) time for those tools that use these
-categories (\fBrrdfetch\fR, rrdgraph).
+categories (\fBrrdfetch\fR, rrdgraph) and \fBepoch\fR indicates the 
+*IX epoch (*IX timestamp 0 = 1970\-01\-01 00:00:00 \s-1UTC\s0). \fBepoch\fR is
+useful to disambiguate between a timestamp value and some forms
+of abbreviated date/time specifications, because it allows to use 
+time offset specifications using units, eg. \fBepoch\fR+19711205s unambiguously
+denotes timestamp 19711205 and not 1971\-12\-05 00:00:00 \s-1UTC\s0.
 .PP
 Month and day of the week names can be used in their naturally
 abbreviated form (e.g., Dec for December, Sun for Sunday, etc.). The