X-Git-Url: https://git.octo.it/?p=rrdtool.git;a=blobdiff_plain;f=bindings%2Fperl-shared%2FRRDs.pm;h=757e5ceb4951053247aff070417a2397588c67f7;hp=6ee4b3d36cb21e5712e6bcc8054724a14cbb1f6d;hb=ea8c705cc27ef33dee2cc6561ed51e16ddc5d0a9;hpb=07c45ee5163cc2c621c356f437f1bf584f10c14c diff --git a/bindings/perl-shared/RRDs.pm b/bindings/perl-shared/RRDs.pm index 6ee4b3d..757e5ce 100644 --- a/bindings/perl-shared/RRDs.pm +++ b/bindings/perl-shared/RRDs.pm @@ -7,7 +7,7 @@ use vars qw(@ISA $VERSION); require DynaLoader; -$VERSION = 1.100001; +$VERSION=1.299907080300; bootstrap RRDs $VERSION; @@ -16,7 +16,7 @@ __END__ =head1 NAME -RRDs - Access rrdtool as a shared module +RRDs - Access RRDtool as a shared module =head1 SYNOPSIS @@ -26,18 +26,21 @@ RRDs - Access rrdtool as a shared module RRDs::info ... RRDs::create ... RRDs::update ... + RRDs::updatev ... RRDs::graph ... RRDs::fetch ... RRDs::tune ... RRDs::times(start, end) + RRDs::dump ... + RRDs::restore ... =head1 DESCRIPTION =head2 Calling Sequence -This module accesses rrdtool functionality directly from within perl. The +This module accesses RRDtool functionality directly from within perl. The arguments to the functions listed in the SYNOPSIS are explained in the regular -rrdtool documentation. The commandline call +RRDtool documentation. The commandline call rrdtool update mydemo.rrd --template in:out N:12:13 @@ -51,10 +54,9 @@ Note that is also valid. - The RRDs::times function takes two parameters: a "start" and "end" time. -These should be specified in the U format -used by rrdtool. See the U documentation for a detailed +These should be specified in the B format +used by RRDtool. See the B documentation for a detailed explanation on how to specify time. =head2 Error Handling @@ -88,7 +90,7 @@ created image and results of the PRINT arguments. print "Averages: ", (join ", ", @$averages); B returns a pointer to a hash. The keys of the hash -represent the property names of the rrd and the values of the hash are +represent the property names of the RRD and the values of the hash are the values of the properties. $hash = RRDs::info "example.rrd"; @@ -96,6 +98,12 @@ the values of the properties. print "$key = $$hash{$key}\n"; } +B takes the same paramters as B but it returns a +pointer to hash. The hash returned contains meta information about the +graph. Like its size as well as the position of the graph area on the image. +When calling with and empty filename than the contents of the graph will be +returned in the hash as well (key 'image'). + B 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 @@ -138,6 +146,6 @@ operating in the timezone of your choice. =head1 AUTHOR -Tobias Oetiker Eoetiker@ee.ethz.chE +Tobias Oetiker Etobi@oetiker.chE =cut