## Process this file with automake to produce Makefile.in
-SUFFIXES = .pod .1 .man .html .txt .pm .pdf .src .inc
+SUFFIXES = .pod .1 .man .html .txt .pm .pdf .inc
#AUTOMAKE_OPTIONS = foreign
#ACLOCAL_M4 = $(top_srcdir)/config/aclocal.m4
-CLEANFILES = *.1 *.html *.txt *-dircache *.pm *.pdf *~ core *itemcache *.rej *.orig rrdgraph_*.pod *.tmp rrdgraph.pod
+CLEANFILES = *.1 *.html *.txt *-dircache RRD?.pod *.pdf *~ core *itemcache *.rej *.orig *.tmp
-SRC = rrdgraph.src rrdgraph_examples.src rrdgraph_rpn.src \
- rrdgraph_data.src rrdgraph_graph.src
+POD = bin_dec_hex.pod rrddump.pod rrdgraph_examples.pod rrdrestore.pod rrdupdate.pod \
+ cdeftutorial.pod rrdfetch.pod rrdgraph_graph.pod rrdthreads.pod rrdxport.pod \
+ rpntutorial.pod rrdfirst.pod rrdgraph_rpn.pod rrdtool.pod \
+ rrd-beginners.pod rrdinfo.pod rrdtune.pod \
+ rrdcgi.pod rrdgraph.pod rrdlast.pod \
+ rrdcreate.pod rrdgraph_data.pod rrdresize.pod rrdtutorial.pod
-PODOLD = rrdgraph-old.pod
-POD = rrdtool.pod rrdlast.pod rrdfirst.pod rrdcreate.pod rrdupdate.pod rrdtutorial.es.pod \
- cdeftutorial.pod rpntutorial.pod rrdthreads.pod bin_dec_hex.pod \
- rrdfetch.pod rrdrestore.pod rrddump.pod rrdtune.pod rrdresize.pod \
- rrdcgi.pod rrdtutorial.pod rrdinfo.pod rrdxport.pod rrd-beginners.pod \
- $(SRC:.src=.pod)
+PMP = RRDs.pod RRDp.pod
-PMP = RRDs.pm RRDp.pm
-
-MAN = $(POD:.pod=.1) $(PMP:.pm=.1)
+MAN = $(POD:.pod=.1)
TXT = $(MAN:.1=.txt)
-HTML = $(POD:.pod=.html) $(PMP:.pm=.html)
+HTML = $(POD:.pod=.html) $(PMP:.pod=.html)
PDF = $(MAN:.1=.pdf)
# what should go into the distribution
.pm.html .pod.html .pl.html:
pod2html --infile=$< --outfile=$@ --noindex --htmlroot=. --podpath=. --title=$*
-RRDs.pm:
- ln -s ../bindings/perl-shared/RRDs.pm .
+RRDs.pod:
+ ln -s ../bindings/perl-shared/RRDs.pm RRDs.pod
-RRDp.pm:
- ln -s ../bindings/perl-piped/RRDp.pm .
+RRDp.pod:
+ ln -s ../bindings/perl-piped/RRDp.pm RRDp.pod
index.html:
rm -f index.html; ln -s rrdtool.html index.html
-link: RRDp.pm RRDs.pm index.html
+link: RRDp.pod RRDs.pod index.html
man: $(MAN)
cdeftutorial - Alex van den Bogaerdt's CDEF tutorial
-=for html <div align="right"><a href="cdeftutorial.pdf">PDF</a> version.</div>
-
=head1 DESCRIPTION
-B<You provide a question and I will try to provide an answer in the next
-release>. B<No feedback equals no changes!>
-
-I<Additions to this document are also welcome.>
-
-Alex van den Bogaerdt E<lt>alex@ergens.op.het.netE<gt>
+If you provide a question, I will try to provide an answer in the next
+release of this tutorial. No feedback equals no changes! Additions to this document are also welcome.
+-- Alex van den Bogaerdt E<lt>alex@ergens.op.het.netE<gt>
=head2 Why this tutorial ?
data flow to update the RRDtool database.
=back
-
+
RRDtool has a lot to do with time. With every data update, it also needs to
know the time when that update occurred. Time is always expressed in
seconds passed since epoch (01-01-1971). RRDtool can be installed on Unix as
operations on RRD database. This command set can be accessed from the command line,
and from Shell or Perl scripts. The scripts
act as wrappers for accessing data stored in RRDtool database.
-
+
=head2 Understanding by an example
The structure of an RRD database is different than other linear databases.
The structure of a database and the terminology associated with it can be
best explained with an example.
- rrdtool create target.rrd
- --start 1023654125
- --step 300
- DS:mem:GAUGE:600:0:671744
- RRA:AVERAGE:0.5:12:24
+ rrdtool create target.rrd \
+ --start 1023654125 \
+ --step 300 \
+ DS:mem:GAUGE:600:0:671744 \
+ RRA:AVERAGE:0.5:12:24 \
RRA:AVERAGE:0.5:288:31
This example creates a database named F<target.rrd>. Start time (1023654125) is
use lib qw( /usr/local/rrdtool-1.0.41/lib/perl ../lib/perl );
use RRDs;
my $cur_time = time(); # setting current time
- my $end_time = $cur_time - 86400; # setting end time to 24 hours behind current time
- my $start_time = $end_time - 2592000; # setting start time to 30 days from end time
+ my $end_time = $cur_time - 86400; # setting end time 24 hours ago
+ my $start_time = $end_time - 2592000; # setting start 30 days in the future
#fetching average values from RRD database between start and end time
my ($start,$step,$ds_names,$data) =
"--rigid", \
"--base=1024", \
"DEF:tot_mem=target.rrd:mem:AVERAGE", \
- "CDEF:correct_tot_mem=tot_mem,0,671744,LIMIT,UN,0,tot_mem,IF,1024,/",\
+ "CDEF:tot_mem_cor=tot_mem,0,671744,LIMIT,UN,0,tot_mem,IF,1024,/",\
"CDEF:machine_mem=tot_mem,656,+,tot_mem,-",\
"COMMENT:Memory Consumption between $start_time",\
"COMMENT: and $end_time ",\
"HRULE:656#000000:Maximum Available Memory - 656 MB",\
"AREA:machine_mem#CCFFFF:Memory Unused", \
- "AREA:correct_tot_mem#6699CC:Total memory consumed in MB");
+ "AREA:tot_mem_cor#6699CC:Total memory consumed in MB");
my $err=RRDs::error;
if ($err) {print "problem generating the graph: $err\n";}
#printing the output
=head1 NAME
-=cut
-
-WARNING: DO NOT EDIT THE POD FILES. THEY ARE AUTO-GENERATED
-
-=pod
-
rrdgraph - Round Robin Database tool grapher functions
=head1 SYNOPSIS
etcetera). If you specify a number of seconds here the label is
centered in this interval (useful for Monday, January etcetera).
-Example: C<--x-grid MINUTE:10:HOUR:1:HOUR:4:0:%X>
+ --x-grid MINUTE:10:HOUR:1:HOUR:4:0:%X
This places grid lines every 10 minutes, major grid lines every hour
and labels every 4 hours. The labels are placed under the major grid
lines as they specify exactly that time.
-Example: C<--x-grid HOUR:8:DAY:1:DAY:1:0:%A>
+ --x-grid HOUR:8:DAY:1:DAY:1:0:%A
This places grid lines every 8 hours, major grid lines and labels
each day. The labels are placed exactly between two major grid lines
at least one print statement to generate a report.
See L<rrdgraph_graph> for exact format.
+=back
+
=head1 SEE ALSO
L<rrdgraph> gives an overview of how B<rrdtool graph> works.
rrdinfo - extract header information from an RRD
-=for html <div align="right"><a href="rrdinfo.pdf">PDF</a> version.</div>
-
=head1 SYNOPSIS
B<rrdtool> B<info> I<filename.rrd>
rrdlast - Return the date of the last data sample in an RRD
-=for html <div align="right"><a href="rrdlast.pdf">PDF</a> version.</div>
-
=head1 SYNOPSIS
B<rrdtool> B<last> I<filename>
rrdresize - alters the size of an RRA and creates new .rrd file
-=for html <div align="right"><a href="rrdresize.pdf">PDF</a> version.</div>
-
=head1 SYNOPSIS
B<rrdtool> B<resize> I<filename> I<rra-num> B<GROW>I<|>B<SHRINK> I<rows>
rrdrestore - Restore the contents of an RRD from its XML dump format
-=for html <div align="right"><a href="rrdrestore.pdf">PDF</a> version.</div>
-
=head1 SYNOPSIS
B<rrdtool> B<restore> I<filename.xml> I<filename.rrd>
rrdtune - Modify some basic properties of a Round Robin Database
-=for html <div align="right"><a href="rrdtune.pdf">PDF</a> version.</div>
-
=head1 SYNOPSIS
B<rrdtool> B<tune> I<filename>
rrdtutorial - Alex van den Bogaerdt's RRDtool tutorial
-=for html <div align="right">Go <a href="rrdtutorial.es.html">Spanish</a></div>
-
-=for html <div align="right"><a href="rrdtutorial.pdf">PDF</a> version.</div>
-
=head1 DESCRIPTION
RRDtool is written by Tobias Oetiker <oetiker@ee.ethz.ch> with
rrdupdate - Store a new set of values into the RRD
-=for html <div align="right"><a href="rrdupdate.pdf">PDF</a> version.</div>
-
=head1 SYNOPSIS
B<rrdtool> {B<update> | B<updatev>} I<filename>
rrdxport - Export data in XML format based on data from one or several RRD
-=for html <div align="right"><a href="rrdxport.pdf">PDF</a> version.</div>
-
=head1 SYNOPSIS
B<rrdtool> B<xport>
projects / thirdparty / rrdtool-1.x.git / commitdiff
