index 6146e43b5b752ad5657d94ea48749dbc497199ed..fbb885ad839f20a4a9ff60165a860b6e5fa67570 100644 (file)
require DynaLoader;
-$VERSION = 1.000331;
+$VERSION = 1.100001;
bootstrap RRDs $VERSION;
RRDs::graph ...
RRDs::fetch ...
RRDs::tune ...
+ RRDs::times(start, end)
=head1 DESCRIPTION
is also valid.
+The RRDs::times function takes two parameters: a "start" and "end" time.
+These should be specified in the B<AT-STYLE TIME SPECIFICATION> format
+used by rrdtool. See the B<rrdfetch> documentation for a detailed
+explanation on how to specify time.
=head2 Error Handling
=head2 Return Values
-The functions RRDs::last, RRDs::graph, RRDs::info and RRDs::fetch return their
-findings.
+The functions RRDs::last, RRDs::graph, RRDs::info, RRDs::fetch and RRDs::times
+return their findings.
B<RRDs::last> returns a single INTEGER representing the last update time.
print "$key = $$hash{$key}\n";
}
+B<RRDs::updatev> also returns a pointer to hash. The keys of the hash
+are concatenated strings of a timestamp, RRA index, and data source name for
+each consolidated data point (CDP) written to disk as a result of the
+current update call. The hash values are CDP values.
+
B<RRDs::fetch> is the most complex of
the pack regarding return values. There are 4 values. Two normal
integers, a pointer to an array and a pointer to a array of pointers.
print "\n";
}
+B<RRDs::times> returns two integers which are the number of seconds since
+epoch (1970-01-01) for the supplied "start" and "end" arguments, respectively.
+
See the examples directory for more ways to use this extension.
=head1 NOTE