From 33df5c014df769dddc6df97bb7071ad1afb3e4eb Mon Sep 17 00:00:00 2001
From: Sebastian Harl
Date: Wed, 23 Jul 2008 21:40:04 +0200
Subject: [PATCH] Imported upstream version 1.3.1.
---
CHANGES | 81 ++++++++
NEWS | 126 ++++++------
bindings/perl-piped/RRDp.pm | 2 +-
bindings/perl-shared/RRDs.pm | 2 +-
bindings/python/rrdtoolmodule.c | 2 +-
configure | 22 +--
configure.ac | 4 +-
doc/bin_dec_hex.1 | 2 +-
doc/bin_dec_hex.txt | 2 +-
doc/cdeftutorial.1 | 2 +-
doc/cdeftutorial.txt | 2 +-
doc/rpntutorial.1 | 2 +-
doc/rpntutorial.txt | 2 +-
doc/rrd-beginners.1 | 2 +-
doc/rrd-beginners.txt | 2 +-
doc/rrdbuild.1 | 137 +++++++------
doc/rrdbuild.html | 131 ++++++-------
doc/rrdbuild.pod | 60 +++---
doc/rrdbuild.txt | 333 +++++++++++++++++---------------
doc/rrdcgi.1 | 2 +-
doc/rrdcgi.txt | 2 +-
doc/rrdcreate.1 | 2 +-
doc/rrdcreate.txt | 2 +-
doc/rrddump.1 | 2 +-
doc/rrddump.txt | 2 +-
doc/rrdfetch.1 | 2 +-
doc/rrdfetch.txt | 2 +-
doc/rrdfirst.1 | 2 +-
doc/rrdfirst.txt | 2 +-
doc/rrdgraph.1 | 7 +-
doc/rrdgraph.html | 5 +-
doc/rrdgraph.pod | 6 +-
doc/rrdgraph.txt | 5 +-
doc/rrdgraph_data.1 | 2 +-
doc/rrdgraph_data.txt | 2 +-
doc/rrdgraph_examples.1 | 2 +-
doc/rrdgraph_examples.txt | 2 +-
doc/rrdgraph_graph.1 | 7 +-
doc/rrdgraph_graph.html | 7 +-
doc/rrdgraph_graph.pod | 6 +-
doc/rrdgraph_graph.txt | 13 +-
doc/rrdgraph_rpn.1 | 2 +-
doc/rrdgraph_rpn.txt | 2 +-
doc/rrdinfo.1 | 2 +-
doc/rrdinfo.txt | 2 +-
doc/rrdlast.1 | 2 +-
doc/rrdlast.txt | 2 +-
doc/rrdlastupdate.1 | 2 +-
doc/rrdlastupdate.txt | 2 +-
doc/rrdresize.1 | 2 +-
doc/rrdresize.txt | 2 +-
doc/rrdrestore.1 | 2 +-
doc/rrdrestore.txt | 2 +-
doc/rrdthreads.1 | 2 +-
doc/rrdthreads.txt | 2 +-
doc/rrdtool.1 | 2 +-
doc/rrdtool.txt | 2 +-
doc/rrdtune.1 | 2 +-
doc/rrdtune.txt | 2 +-
doc/rrdtutorial.1 | 2 +-
doc/rrdtutorial.txt | 2 +-
doc/rrdupdate.1 | 2 +-
doc/rrdupdate.txt | 2 +-
doc/rrdxport.1 | 2 +-
doc/rrdxport.txt | 2 +-
rrdtool.spec | 17 +-
src/pngsize.c | 2 +-
src/rrd.h | 4 +-
src/rrd_cgi.c | 2 +-
src/rrd_create.c | 4 +-
src/rrd_diff.c | 4 +-
src/rrd_dump.c | 4 +-
src/rrd_error.c | 4 +-
src/rrd_fetch.c | 4 +-
src/rrd_first.c | 2 +-
src/rrd_format.c | 4 +-
src/rrd_format.h | 2 +-
src/rrd_gfx.c | 2 +-
src/rrd_graph.c | 27 ++-
src/rrd_graph_helper.c | 2 +-
src/rrd_hw.c | 2 +-
src/rrd_hw.h | 2 +-
src/rrd_i18n.h | 2 +-
src/rrd_info.c | 2 +-
src/rrd_is_thread_safe.h | 4 +-
src/rrd_last.c | 2 +-
src/rrd_lastupdate.c | 2 +-
src/rrd_not_thread_safe.c | 4 +-
src/rrd_open.c | 4 +-
src/rrd_resize.c | 2 +-
src/rrd_restore.c | 59 ++----
src/rrd_rpncalc.c | 2 +-
src/rrd_rpncalc.h | 2 +-
src/rrd_thread_safe.c | 4 +-
src/rrd_thread_safe_nt.c | 4 +-
src/rrd_tool.c | 2 +-
src/rrd_tool.h | 2 +-
src/rrd_tune.c | 4 +-
src/rrd_update.c | 13 +-
src/rrd_version.c | 2 +-
src/rrd_xport.c | 2 +-
src/rrd_xport.h | 2 +-
src/rrdupdate.c | 4 +-
103 files changed, 701 insertions(+), 559 deletions(-)
diff --git a/CHANGES b/CHANGES
index 059edee..c4e9062 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,84 @@
+2008-07-23 13:02 oetiker
+
+ * bindings/perl-piped/RRDp.pm, bindings/perl-shared/RRDs.pm,
+ configure.ac, doc/rrdbuild.pod, rrdtool.spec, src/pngsize.c,
+ src/rrd.h, src/rrd_cgi.c, src/rrd_create.c, src/rrd_datalang.c,
+ src/rrd_diff.c, src/rrd_dump.c, src/rrd_error.c, src/rrd_fetch.c,
+ src/rrd_first.c, src/rrd_format.c, src/rrd_format.h,
+ src/rrd_gfx.c, src/rrd_graph.c, src/rrd_graph_helper.c,
+ src/rrd_hw.c, src/rrd_hw.h, src/rrd_i18n.h, src/rrd_info.c,
+ src/rrd_is_thread_safe.h, src/rrd_last.c, src/rrd_lastupdate.c,
+ src/rrd_not_thread_safe.c, src/rrd_open.c, src/rrd_resize.c,
+ src/rrd_restore.c, src/rrd_rpncalc.c, src/rrd_rpncalc.h,
+ src/rrd_thread_safe.c, src/rrd_thread_safe_nt.c, src/rrd_tool.c,
+ src/rrd_tool.h, src/rrd_tune.c, src/rrd_update.c,
+ src/rrd_version.c, src/rrd_xport.c, src/rrd_xport.h,
+ src/rrdupdate.c: prepare for the release of rrdtool-1.3.1
+
+2008-07-23 12:45 oetiker
+
+ * src/rrd_restore.c: added support for restoring rrdtool 1.0.x files
+ ... removed support for old HW patched rrd format created by an
+ early patched version of 1.0.x
+
+2008-07-22 15:15 oetiker
+
+ * branches/1.2/program/src/rrd_create.c, src/rrd_create.c: Fix for
+ #167 - rrdcreate is arguably missing a check for 'step>=1' for
+ RRAs with AVERAGE as a CF. I ran into this when specifying 0.6 as
+ a step value, assuming floats were also accepted. Patch attached
+ here. -- Bogdan
+
+2008-07-01 06:35 oetiker
+
+ * doc/rrdbuild.pod: header-fix
+
+2008-07-01 06:34 oetiker
+
+ * doc/rrdbuild.pod: improve layout
+
+2008-06-29 16:23 oetiker
+
+ * src/rrd_update.c: added rrd filename to illegal update message --
+ he at uninett.no
+
+2008-06-29 14:08 oetiker
+
+ * rrdtool.spec: rrdtool.spec fix by Anton Blanchard to build without
+ php patch
+
+2008-06-29 13:57 oetiker
+
+ * doc/rrdgraph.pod, src/rrd_graph.c: make sure image-with and
+ image-height get returned even when rrdtool is called with --lazy
+ as reported in bug #163
+
+2008-06-27 06:08 zaucker
+
+ * trunk/tutorial/lisa2008/abstract-rrdexample.txt,
+ trunk/tutorial/lisa2008/abstract-rrdtut.txt: Etwas ueberarbeitet
+
+2008-06-24 15:05 oetiker
+
+ * trunk/tutorial/lisa2008,
+ trunk/tutorial/lisa2008/abstract-rrdexample.txt,
+ trunk/tutorial/lisa2008/abstract-rrdtut.txt: intial
+
+2008-06-19 13:18 oetiker
+
+ * branches/1.2/program/bindings/python/rrdtoolmodule.c,
+ bindings/python/rrdtoolmodule.c: rrdtool.fetch is returning an
+ extra, bogus, data point. Attached is a patch to correct this. -
+ Gilad Raphaelli. Fix for #161
+
+2008-06-12 13:54 oetiker
+
+ * doc/rrdgraph_graph.pod: added note on %S
+
+2008-06-11 15:49 oetiker
+
+ * NEWS: made news the same as the announcement
+
2008-06-10 23:12 oetiker
* bindings/perl-piped/RRDp.pm, bindings/perl-shared/RRDs.pm,
diff --git a/NEWS b/NEWS
index ec85692..5497a67 100644
--- a/NEWS
+++ b/NEWS
@@ -5,89 +5,101 @@ RRDTOOL NEWS
Major Changes between 1.2.x and 1.3.x
-------------------------------------
-RRdtool dump / restore Incompatibilities
-----------------------------------------
-rrdtool dump 1.3 does emit completely legal xml. Basically this means that
-it contains an xml header and a DOCTYPE definition. Unfortunately this
-causes older versions of rrdtool restore to be unhappy.
-
-To restore a new dump with ann old rrdtool restore version, either remove
-the xml header and the doctype by hand (both on the first line of the dump)
-or use rrdtool dump --no-header.
-
-NEW File access methods (Bernhard Fischer)
--------------------
+NEW Fast file access methods (Bernhard Fischer / Tobi Oetiker)
+----------------------------
* introduced file-accessor functions rrd_read/rrd_seek/rrd_write
-* implemented full mmap-based file access with madvise hints for improved
- scalability, much reduced memory-footprint and much less blocking on
- disk
-* implemented optional full file-descriptor access instead of FILE* access
+
+* implemented full mmap-based file access with madvise hints for
+ improved scalability, much reduced memory-footprint and much less
+ blocking while accessing the disk
+
+* implemented optional full file-descriptor access instead of FILE*
+ access
NEW Graphing (Tobi Oetiker)
---------
+------------
* libart has been replaced by cairo/pango
+
* pango markup is supported (--pango-markup)
-* full gridfitting
-* --graph-render-mode=mono for non antialiased graphing
-* --font-render-mode=mono for non antialiased fonts
-* fonts come through fontconfig, use the Pango fontnameing
- scheme -> 'Times 20' ... it is not possible to use
- truetype fonts directly anymore.
+
+* full grid fitting
+
+* --graph-render-mode=mono for non anti aliased graphing
+
+* --font-render-mode=mono for non anti aliased fonts
+
+* fonts come through fontconfig, use the Pango font nameing scheme
+ -> 'Times 20' ... it is not possible to use truetype fonts
+ directly anymore.
+
* Tabs are position independent.
-* TRENDNAN filter that ignores NAN values while caculating the TREND data. (Timo Stripf)
-* --full-size-mode to specify the outer border of the image and not just of the graphing canvas (Matthew Chambers)
-* TEXTALIGN command to alter default text alignment behaviour
+
+* TRENDNAN filter that ignores NAN values while calculating the
+ TREND data. (Timo Stripf)
+
+* --full-size-mode to specify the outer border of the image and not
+ just of the graphing canvas (Matthew Chambers)
+
+* TEXTALIGN command to alter default text alignment behavior
+
* C API in-memory graphing with rrd_graph_v (Evan Miller)
+
* draw dashed lines in graphs (Thomas Gutzler)
-* new interface graphv which returns inforamation using the rrd_info
+
+* new interface graphv which returns information using the rrd_info
interface (Tobi Oetiker and Mark Plaksin)
-* improved horizontal grid. Have a bit more grid lines and y-axis labels
- while keeping them fahr enough apart to not run into each other.
+
+* improved horizontal grid. Have a bit more grid lines and y-axis
+ labels while keeping them far enough apart to not run into each
+ other.
NEW Forecasting (Evan Miller)
------------
-* the new MHWPREDICT consolidation function uses a variation of the Holt-Winters
- method. It is a drop-in replacement for HWPREDICT, and is better suited for
- data whose seasonal variations grow or shrink in proportion to the average.
+---------------
+* the new MHWPREDICT consolidation function uses a variation of the
+ Holt-Winters method. It is a drop-in replacement for HWPREDICT,
+ and is better suited for data whose seasonal variations grow or
+ shrink in proportion to the average.
-* If you create an RRD with the new MHWPREDICT function, the resulting
- rrdfile will be version 0004 and can only be used in rrdtool 1.3.
+* If you create an RRD with the new MHWPREDICT function, the
+ resulting rrd file will be version 0004 and can only be used in
+ rrdtool 1.3.
Rewrites
--------
-* rrd_restore now uses libxml for parsing which makes things much more
- tolerant towards xml variations. The old code could mostly just parse the
- xml as it was output by rrdtool dump. See also: 'incompatibilities' at the
- top of this document. (by Florian octo Forster)
+* rrd_restore now uses libxml for parsing which makes things much
+ more tolerant towards xml variations. The old code could mostly
+ just parse the XML as it was output by rrdtool dump. See also:
+ the note at the bottom of this document. (by Florian octo
+ Forster)
-* rrd_update rewritten to make it more modular. Fixed two longstanding
- HW bugs in the process (Evan Miller)
+* rrd_update rewritten to make it more modular. Fixed two
+ longstanding HW bugs in the process (Evan Miller)
Internationalization (Takao Fujiwara and Tobi Oetiker)
--------------------
-* The help output by rrdtool has been internationalized. There are no real
- translations included with rrdtool yet, contributions are welcome.
-* The internationalization will only be compiled if libintl and friends are
- available on your system. Use the configure option --disable-libintl if
- you want to disable this feature
+* The help output by rrdtool has been internationalized. There are
+ no real translations included with rrdtool yet, contributions are
+ welcome.
+
+* The internationalization will only be compiled if libintl and
+ friends are available on your system. Use the configure option
+ --disable-libintl if you want to disable this feature
Language Bindings
-----------------
* ruby rrd_fetch will return step as a last property -- Mike Perham
-* python rrdtool.info does now conform with the data structure returned
- by the other language bindings. This is incompatible with the
- previous (broken) version --tobi
-
-* python bindings got updatev support --tobi
+RRDtool dump / restore incompatibility
+--------------------------------------
+* rrdtool dump 1.3 does emit completely legal XML. Basically this
+ means that it contains an XML header and a DOCTYPE definition.
+ Unfortunately this causes older versions of rrdtool restore to be
+ unhappy.
-* ruby, perl, python bindings support the new graphv interface --tobi
+* To restore a new dump with an old rrdtool restore version, either
+ remove the XML header and the doctype by hand (both on the first
+ line of the dump) or use rrdtool dump --no-header.
-Locale Independent Numeric Input
---------------------------------
-* Regardles of locale you are in, rrdtool always expects input to be numbers
- (LC_NUMERIC) in C or POSIX locale for numbers. (not 1,1 but 1.1) this is
- necessary to make things like RPN work as it uses , as a separator.
######################################################################################
Major Changes between 1.0.x and 1.2.x
diff --git a/bindings/perl-piped/RRDp.pm b/bindings/perl-piped/RRDp.pm
index a99e56e..0a28506 100644
--- a/bindings/perl-piped/RRDp.pm
+++ b/bindings/perl-piped/RRDp.pm
@@ -120,7 +120,7 @@ sub cmd (@);
sub end ();
sub read ();
-$VERSION=1.3000;
+$VERSION=1.3001;
sub start ($){
croak "rrdtool is already running"
diff --git a/bindings/perl-shared/RRDs.pm b/bindings/perl-shared/RRDs.pm
index d151db4..df115c1 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.3000;
+$VERSION=1.3001;
bootstrap RRDs $VERSION;
diff --git a/bindings/python/rrdtoolmodule.c b/bindings/python/rrdtoolmodule.c
index 1b85f96..2771720 100644
--- a/bindings/python/rrdtoolmodule.c
+++ b/bindings/python/rrdtoolmodule.c
@@ -184,7 +184,7 @@ static PyObject *PyRRD_fetch(
unsigned long i, j, row;
rrd_value_t dv;
- row = ((end - start) / step + 1);
+ row = (end - start) / step;
r = PyTuple_New(3);
range_tup = PyTuple_New(3);
diff --git a/configure b/configure
index 3985c27..38cd899 100755
--- a/configure
+++ b/configure
@@ -1,6 +1,6 @@
#! /bin/sh
# Guess values for system-dependent variables and create Makefiles.
-# Generated by GNU Autoconf 2.61 for rrdtool 1.3.0.
+# Generated by GNU Autoconf 2.61 for rrdtool 1.3.1.
#
# Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001,
# 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
@@ -726,8 +726,8 @@ SHELL=${CONFIG_SHELL-/bin/sh}
# Identity of this package.
PACKAGE_NAME='rrdtool'
PACKAGE_TARNAME='rrdtool'
-PACKAGE_VERSION='1.3.0'
-PACKAGE_STRING='rrdtool 1.3.0'
+PACKAGE_VERSION='1.3.1'
+PACKAGE_STRING='rrdtool 1.3.1'
PACKAGE_BUGREPORT=''
ac_default_prefix=/usr/local/rrdtool-$PACKAGE_VERSION
@@ -1510,7 +1510,7 @@ if test "$ac_init_help" = "long"; then
# Omit some internal or obsolete options to make the list less imposing.
# This message is too long to be a string in the A/UX 3.1 sh.
cat <<_ACEOF
-\`configure' configures rrdtool 1.3.0 to adapt to many kinds of systems.
+\`configure' configures rrdtool 1.3.1 to adapt to many kinds of systems.
Usage: $0 [OPTION]... [VAR=VALUE]...
@@ -1581,7 +1581,7 @@ fi
if test -n "$ac_init_help"; then
case $ac_init_help in
- short | recursive ) echo "Configuration of rrdtool 1.3.0:";;
+ short | recursive ) echo "Configuration of rrdtool 1.3.1:";;
esac
cat <<\_ACEOF
@@ -1721,7 +1721,7 @@ fi
test -n "$ac_init_help" && exit $ac_status
if $ac_init_version; then
cat <<\_ACEOF
-rrdtool configure 1.3.0
+rrdtool configure 1.3.1
generated by GNU Autoconf 2.61
Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001,
@@ -1735,7 +1735,7 @@ cat >config.log <<_ACEOF
This file contains any messages produced by compilers while
running configure, to aid debugging if configure makes a mistake.
-It was created by rrdtool $as_me 1.3.0, which was
+It was created by rrdtool $as_me 1.3.1, which was
generated by GNU Autoconf 2.61. Invocation command line was
$ $0 $@
@@ -2089,7 +2089,7 @@ ac_compiler_gnu=$ac_cv_c_compiler_gnu
-NUMVERS=1.3000
+NUMVERS=1.3001
LIBVERS=4:0:0
@@ -2538,7 +2538,7 @@ fi
# Define the identity of the package.
PACKAGE='rrdtool'
- VERSION='1.3.0'
+ VERSION='1.3.1'
cat >>confdefs.h <<_ACEOF
@@ -32973,7 +32973,7 @@ exec 6>&1
# report actual input values of CONFIG_FILES etc. instead of their
# values after options handling.
ac_log="
-This file was extended by rrdtool $as_me 1.3.0, which was
+This file was extended by rrdtool $as_me 1.3.1, which was
generated by GNU Autoconf 2.61. Invocation command line was
CONFIG_FILES = $CONFIG_FILES
@@ -33026,7 +33026,7 @@ Report bugs to ."
_ACEOF
cat >>$CONFIG_STATUS <<_ACEOF
ac_cs_version="\\
-rrdtool config.status 1.3.0
+rrdtool config.status 1.3.1
configured by $0, generated by GNU Autoconf 2.61,
with options \\"`echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`\\"
diff --git a/configure.ac b/configure.ac
index 7a15b5c..80ada60 100644
--- a/configure.ac
+++ b/configure.ac
@@ -9,14 +9,14 @@ dnl tell automake the this script is for rrdtool
dnl the official version number is
dnl a.b.c
-AC_INIT([rrdtool],[1.3.0])
+AC_INIT([rrdtool],[1.3.1])
dnl for testing a numberical version number comes handy
dnl the released version are
dnl a.bccc
dnl the devel versions will be something like
dnl a.b999yymmddhh
-NUMVERS=1.3000
+NUMVERS=1.3001
AC_SUBST(NUMVERS)
dnl for the linker to understand which version the library is compatible with
diff --git a/doc/bin_dec_hex.1 b/doc/bin_dec_hex.1
index dd06561..f6ba28b 100644
--- a/doc/bin_dec_hex.1
+++ b/doc/bin_dec_hex.1
@@ -129,7 +129,7 @@
.\" ========================================================================
.\"
.IX Title "BIN_DEC_HEX 1"
-.TH BIN_DEC_HEX 1 "2008-03-15" "1.3.0" "rrdtool"
+.TH BIN_DEC_HEX 1 "2008-03-15" "1.3.1" "rrdtool"
.SH "NAME"
bin_dec_hex \- How to use binary, decimal, and hexadecimal notation.
.SH "DESCRIPTION"
diff --git a/doc/bin_dec_hex.txt b/doc/bin_dec_hex.txt
index 3fe4075..f4f7acb 100644
--- a/doc/bin_dec_hex.txt
+++ b/doc/bin_dec_hex.txt
@@ -371,4 +371,4 @@ AAUUTTHHOORR
-1.3.0 2008-03-15 BIN_DEC_HEX(1)
+1.3.1 2008-03-15 BIN_DEC_HEX(1)
diff --git a/doc/cdeftutorial.1 b/doc/cdeftutorial.1
index dd5d9c9..0da42ff 100644
--- a/doc/cdeftutorial.1
+++ b/doc/cdeftutorial.1
@@ -129,7 +129,7 @@
.\" ========================================================================
.\"
.IX Title "CDEFTUTORIAL 1"
-.TH CDEFTUTORIAL 1 "2008-03-15" "1.3.0" "rrdtool"
+.TH CDEFTUTORIAL 1 "2008-03-15" "1.3.1" "rrdtool"
.SH "NAME"
cdeftutorial \- Alex van den Bogaerdt's CDEF tutorial
.SH "DESCRIPTION"
diff --git a/doc/cdeftutorial.txt b/doc/cdeftutorial.txt
index 0b0ec47..7365bac 100644
--- a/doc/cdeftutorial.txt
+++ b/doc/cdeftutorial.txt
@@ -799,4 +799,4 @@ AAUUTTHHOORR
-1.3.0 2008-03-15 CDEFTUTORIAL(1)
+1.3.1 2008-03-15 CDEFTUTORIAL(1)
diff --git a/doc/rpntutorial.1 b/doc/rpntutorial.1
index 8cdfbaa..ae733c0 100644
--- a/doc/rpntutorial.1
+++ b/doc/rpntutorial.1
@@ -129,7 +129,7 @@
.\" ========================================================================
.\"
.IX Title "RPNTUTORIAL 1"
-.TH RPNTUTORIAL 1 "2008-03-15" "1.3.0" "rrdtool"
+.TH RPNTUTORIAL 1 "2008-03-15" "1.3.1" "rrdtool"
.SH "NAME"
rpntutorial \- Reading RRDtool RPN Expressions by Steve Rader
.SH "DESCRIPTION"
diff --git a/doc/rpntutorial.txt b/doc/rpntutorial.txt
index 9605c4b..690693b 100644
--- a/doc/rpntutorial.txt
+++ b/doc/rpntutorial.txt
@@ -187,4 +187,4 @@ AAUUTTHHOORR
-1.3.0 2008-03-15 RPNTUTORIAL(1)
+1.3.1 2008-03-15 RPNTUTORIAL(1)
diff --git a/doc/rrd-beginners.1 b/doc/rrd-beginners.1
index 906e235..8534a1f 100644
--- a/doc/rrd-beginners.1
+++ b/doc/rrd-beginners.1
@@ -129,7 +129,7 @@
.\" ========================================================================
.\"
.IX Title "RRD-BEGINNERS 1"
-.TH RRD-BEGINNERS 1 "2008-03-15" "1.3.0" "rrdtool"
+.TH RRD-BEGINNERS 1 "2008-03-15" "1.3.1" "rrdtool"
.SH "NAME"
rrd\-beginners \- RRDtool Beginners' Guide
.SH "SYNOPSIS"
diff --git a/doc/rrd-beginners.txt b/doc/rrd-beginners.txt
index 27ae855..9d2aed1 100644
--- a/doc/rrd-beginners.txt
+++ b/doc/rrd-beginners.txt
@@ -318,4 +318,4 @@ AAUUTTHHOORR
-1.3.0 2008-03-15 RRD-BEGINNERS(1)
+1.3.1 2008-03-15 RRD-BEGINNERS(1)
diff --git a/doc/rrdbuild.1 b/doc/rrdbuild.1
index 1ba620b..80dae58 100644
--- a/doc/rrdbuild.1
+++ b/doc/rrdbuild.1
@@ -129,7 +129,7 @@
.\" ========================================================================
.\"
.IX Title "RRDBUILD 1"
-.TH RRDBUILD 1 "2008-06-11" "1.3.0" "rrdtool"
+.TH RRDBUILD 1 "2008-07-23" "1.3.1" "rrdtool"
.SH "NAME"
rrdbuild \- Instructions for building RRDtool
.SH "OVERVIEW"
@@ -163,7 +163,7 @@ Once you have decided. Save the two locations into environment variables.
.PP
.Vb 2
\& BUILD_DIR=/tmp/rrdbuild
-\& INSTALL_DIR=/usr/local/rrdtool\-1.3.0
+\& INSTALL_DIR=/usr/local/rrdtool\-1.3.1
.Ve
.PP
If your \fI/tmp\fR is mounted with the option noexec (\s-1RHEL\s0 seems todo that) you have to choose
@@ -180,9 +180,9 @@ Lets first assume you already have all the necessary libraries
pre\-installed.
.PP
.Vb 4
-\& wget http://oss.oetiker.ch/rrdtool/pub/rrdtool\-1.3.0.tar.gz
-\& gunzip \-c rrdtool\-1.3.0.tar.gz | tar xf \-
-\& cd rrdtool\-1.3.0
+\& wget http://oss.oetiker.ch/rrdtool/pub/rrdtool\-1.3.1.tar.gz
+\& gunzip \-c rrdtool\-1.3.1.tar.gz | tar xf \-
+\& cd rrdtool\-1.3.1
\& ./configure \-\-prefix=$INSTALL_DIR && make && make install
.Ve
.PP
@@ -256,10 +256,8 @@ libpng and zlib are pretty standard so you will probably have them on your
system anyway. Freetype, Fontinst, Cairo, Pango may be installed, but it is
possible that they are pretty old and thus don't live up to our
expectations, so you may want to compile their latest versions.
-.PP
-\fIBuild Tips for \s-1AIX\s0\fR
-.IX Subsection "Build Tips for AIX"
-.PP
+.Sh "General build tips for \s-1AIX\s0"
+.IX Subsection "General build tips for AIX"
If you are working with \s-1AIX\s0, you may find the the \fB\-\-disable\-shared\fR option
will cause things to break for you. In that case you may have to install the
shared libraries into the rrdtool \s-1PREFIX\s0 and work with \fB\-\-disable\-static\fR
@@ -273,33 +271,32 @@ Another hint to get rrdtool working on \s-1AIX\s0 is to use the \s-1IBM\s0 \s-1X
.Ve
.PP
(Better instructions for \s-1AIX\s0 welcome!)
-.Sh "Building Libraries"
-.IX Subsection "Building Libraries"
-In order to build the libraries you need a compiler on your system.
-Unfortunately compilers are not all alike. This has an effect on the \s-1CFLAGS\s0
-you want to set. The examples below are for the popular \s-1GCC\s0 compiler suite.
-If you have an other compilers here are some ides:
+.Sh "Build Instructions"
+.IX Subsection "Build Instructions"
+In order to build rrdtool need a compiler on your system. Unfortunately
+compilers are not all alike. This has an effect on the \s-1CFLAGS\s0 you want to
+set. The examples below are for the popular \s-1GCC\s0 compiler suite. If you have
+an other compilers here are some ides:
.IP "Sun Forte" 4
.IX Item "Sun Forte"
.Vb 1
\& CFLAGS="\-xO3 \-kPIC"
.Ve
-.Sp
-.RS 4
+.PP
Some libraries want to know where other libraries are. For this to work,
set the following environment variable
-.Sp
+.PP
.Vb 2
\& export PKG_CONFIG_PATH=${INSTALL_DIR}/lib/pkgconfig
\& export PATH=$INSTALL_DIR/bin:$PATH
.Ve
-.Sp
-This relies on the presence of the \fIpkgconfig\fR program. Below you find instructions
-on how to compile pkgconfig as well.
-.Sp
-Since we are compiling libraries dynamically, they must know
-where to find each other. This is done by setting an appropriate \s-1LDFLAGS\s0.
-Unfortunately, the syntax again differs from system to system:
+.PP
+The above relies on the presence of the \fIpkgconfig\fR program. Below you find instructions
+on how to compile pkgconfig.
+.PP
+Since we are compiling libraries dynamically, they must know where to find
+each other. This is done by setting an appropriate \s-1LDFLAGS\s0. Unfortunately,
+the syntax again differs from system to system:
.IP "Solaris" 4
.IX Item "Solaris"
.Vb 1
@@ -320,29 +317,28 @@ Unfortunately, the syntax again differs from system to system:
.Vb 1
\& export LDFLAGS="\-Wl,\-blibpath:${INSTALL_DIR}/lib"
.Ve
-.RE
-.RS 4
-.Sp
+.PP
If you have GNUmake installed and it is not called 'make',
then do
-.Sp
+.PP
.Vb 2
\& export MAKE=gmake
\& export GNUMAKE=gmake
.Ve
-.Sp
+.PP
otherwise just do
-.Sp
+.PP
.Vb 1
\& export MAKE=make
.Ve
-.RE
-.IP "Building pkgconfig" 4
-.IX Item "Building pkgconfig"
+.PP
+\fIBuilding pkgconfig\fR
+.IX Subsection "Building pkgconfig"
+.PP
As mentioned above, without pkgconfig the whole build process will be lots
of pain and suffering, so make sure you have a copy on your system. If it is
not available natively, here is how to compile it.
-.Sp
+.PP
.Vb 6
\& wget http://pkgconfig.freedesktop.org/releases/pkg\-config\-0.23.tar.gz
\& gunzip \-c pkg\-config\-0.23.tar.gz | tar xf \-
@@ -351,10 +347,12 @@ not available natively, here is how to compile it.
\& $MAKE
\& $MAKE install
.Ve
-.IP "Building zlib" 4
-.IX Item "Building zlib"
+.PP
+\fIBuilding zlib\fR
+.IX Subsection "Building zlib"
+.PP
Chances are very high that you already have that on your system ...
-.Sp
+.PP
.Vb 7
\& cd $BUILD_DIR
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/zlib\-1.2.3.tar.gz
@@ -364,13 +362,15 @@ Chances are very high that you already have that on your system ...
\& $MAKE
\& $MAKE install
.Ve
-.IP "Building libpng" 4
-.IX Item "Building libpng"
+.PP
+\fIBuilding libpng\fR
+.IX Subsection "Building libpng"
+.PP
Libpng itself requires zlib to build, so we need to help a bit. If you
already have a copy of zlib on your system (which is very likely) you can
drop the settings of \s-1LDFLAGS\s0 and \s-1CPPFLAGS\s0. Note that the backslash (\e) at
the end of line 4 means that line 4 and line 5 are on one line.
-.Sp
+.PP
.Vb 7
\& cd $BUILD_DIR
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/libpng\-1.2.18.tar.gz
@@ -380,8 +380,10 @@ the end of line 4 means that line 4 and line 5 are on one line.
\& $MAKE
\& $MAKE install
.Ve
-.IP "Building freetype" 4
-.IX Item "Building freetype"
+.PP
+\fIBuilding freetype\fR
+.IX Subsection "Building freetype"
+.PP
.Vb 7
\& cd $BUILD_DIR
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/freetype\-2.3.5.tar.gz
@@ -391,15 +393,17 @@ the end of line 4 means that line 4 and line 5 are on one line.
\& $MAKE
\& $MAKE install
.Ve
-.Sp
+.PP
If you run into problems building freetype on Solaris, you may want to try to
add the following at the start the configure line:
-.Sp
+.PP
.Vb 1
\& env EGREP=egrep
.Ve
-.IP "Building LibXML2" 4
-.IX Item "Building LibXML2"
+.PP
+\fIBuilding LibXML2\fR
+.IX Subsection "Building LibXML2"
+.PP
.Vb 7
\& cd $BUILD_DIR
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/libxml2\-sources\-2.6.31.tar.gz
@@ -409,13 +413,15 @@ add the following at the start the configure line:
\& $MAKE
\& $MAKE install
.Ve
-.IP "Building fontconfig" 4
-.IX Item "Building fontconfig"
+.PP
+\fIBuilding fontconfig\fR
+.IX Subsection "Building fontconfig"
+.PP
Note that fontconfig has a run time configuration file in INSTALL_DIR/etc you
may want to adjust that so that fontconfig finds the fonts on your system.
Run the fc-cache program to build the fontconfig cache after changing the
config file.
-.Sp
+.PP
.Vb 7
\& cd $BUILD_DIR
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/fontconfig\-2.4.2.tar.gz
@@ -425,8 +431,10 @@ config file.
\& $MAKE
\& $MAKE install
.Ve
-.IP "Building Pixman" 4
-.IX Item "Building Pixman"
+.PP
+\fIBuilding Pixman\fR
+.IX Subsection "Building Pixman"
+.PP
.Vb 7
\& cd $BUILD_DIR
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/pixman\-0.10.0.tar.gz
@@ -436,8 +444,10 @@ config file.
\& $MAKE
\& $MAKE install
.Ve
-.IP "Building Cairo" 4
-.IX Item "Building Cairo"
+.PP
+\fIBuilding Cairo\fR
+.IX Subsection "Building Cairo"
+.PP
.Vb 11
\& cd $BUILD_DIR
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/cairo\-1.6.4.tar.gz
@@ -451,8 +461,10 @@ config file.
\& $MAKE
\& $MAKE install
.Ve
-.IP "Building Glib" 4
-.IX Item "Building Glib"
+.PP
+\fIBuilding Glib\fR
+.IX Subsection "Building Glib"
+.PP
.Vb 7
\& cd $BUILD_DIR
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/glib\-2.15.4.tar.gz
@@ -462,8 +474,10 @@ config file.
\& $MAKE
\& $MAKE install
.Ve
-.IP "Building Pango" 4
-.IX Item "Building Pango"
+.PP
+\fIBuilding Pango\fR
+.IX Subsection "Building Pango"
+.PP
.Vb 7
\& cd $BUILD_DIR
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/pango\-1.21.1.tar.gz
@@ -473,7 +487,8 @@ config file.
\& $MAKE
\& $MAKE install
.Ve
-.PP
+.Sh "Building rrdtool (second try)"
+.IX Subsection "Building rrdtool (second try)"
Now all the dependent libraries are built and you can try again. This time
you tell configure where it should be looking for libraries and include
files. This is done via environment variables. Depending on the shell you
@@ -485,7 +500,7 @@ tcl setups that would prevent rrdtool from building if they are included in
their current state.
.PP
.Vb 5
-\& cd $BUILD_DIR/rrdtool\-1.3.0
+\& cd $BUILD_DIR/rrdtool\-1.3.1
\& ./configure \-\-prefix=$INSTALL_DIR \-\-disable\-tcl \-\-disable\-python
\& $MAKE clean
\& $MAKE
@@ -493,7 +508,7 @@ their current state.
.Ve
.PP
\&\s-1SOLARIS\s0 \s-1HINT:\s0 if you want to build the perl module for the native perl (the
-one shipping with Solaris) you will need the sun forte compiler installed on
+one shipping with Solaris) you will need the Sun Forte compiler installed on
your box or you have to hand-tune bindings/perl\-shared/Makefile while
building!
.PP
diff --git a/doc/rrdbuild.html b/doc/rrdbuild.html
index 01a9efc..c003c10 100644
--- a/doc/rrdbuild.html
+++ b/doc/rrdbuild.html
@@ -29,12 +29,23 @@
BUILDING DEPENDENCIES
AUTHOR
@@ -79,7 +90,7 @@ tar and GNU make respectively. It could be that they a
Once you have decided. Save the two locations into environment variables.
BUILD_DIR=/tmp/rrdbuild
- INSTALL_DIR=/usr/local/rrdtool-1.3.0
+ INSTALL_DIR=/usr/local/rrdtool-1.3.1
If your /tmp is mounted with the option noexec (RHEL seems todo that) you have to choose
a different directory!
Now make sure the BUILD_DIR exists and go there:
@@ -89,9 +100,9 @@ a different directory!
Lets first assume you already have all the necessary libraries
pre-installed.
- wget http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.3.0.tar.gz
- gunzip -c rrdtool-1.3.0.tar.gz | tar xf -
- cd rrdtool-1.3.0
+ wget http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.3.1.tar.gz
+ gunzip -c rrdtool-1.3.1.tar.gz | tar xf -
+ cd rrdtool-1.3.1
./configure --prefix=$INSTALL_DIR && make && make install
Ok, this was very optimistic. This try will probably have ended with
configure complaining about several missing libraries.
@@ -158,7 +169,7 @@ possible that they are pretty old and thus don't live up to our
expectations, so you may want to compile their latest versions.
-
+
If you are working with AIX, you may find the the --disable-shared option
will cause things to break for you. In that case you may have to install the
shared libraries into the rrdtool PREFIX and work with --disable-static
@@ -170,11 +181,11 @@ instead.
(Better instructions for AIX welcome!)
-
-In order to build the libraries you need a compiler on your system.
-Unfortunately compilers are not all alike. This has an effect on the CFLAGS
-you want to set. The examples below are for the popular GCC compiler suite.
-If you have an other compilers here are some ides:
+
+In order to build rrdtool need a compiler on your system. Unfortunately
+compilers are not all alike. This has an effect on the CFLAGS you want to
+set. The examples below are for the popular GCC compiler suite. If you have
+an other compilers here are some ides:
- Sun Forte
@@ -188,11 +199,11 @@ set the following environment variable
export PKG_CONFIG_PATH=${INSTALL_DIR}/lib/pkgconfig
export PATH=$INSTALL_DIR/bin:$PATH
-This relies on the presence of the pkgconfig program. Below you find instructions
-on how to compile pkgconfig as well.
-Since we are compiling libraries dynamically, they must know
-where to find each other. This is done by setting an appropriate LDFLAGS.
-Unfortunately, the syntax again differs from system to system:
+The above relies on the presence of the pkgconfig program. Below you find instructions
+on how to compile pkgconfig.
+Since we are compiling libraries dynamically, they must know where to find
+each other. This is done by setting an appropriate LDFLAGS. Unfortunately,
+the syntax again differs from system to system:
- Solaris
@@ -210,7 +221,6 @@ Unfortunately, the syntax again differs from system to system:
-
-
export LDFLAGS="+b${INSTALL_DIR}/lib"
- AIX
@@ -218,6 +228,8 @@ Unfortunately, the syntax again differs from system to system:
-
export LDFLAGS="-Wl,-blibpath:${INSTALL_DIR}/lib"
+
+
If you have GNUmake installed and it is not called 'make',
then do
@@ -226,10 +238,9 @@ then do
otherwise just do
export MAKE=make
-
-- Building pkgconfig
-
--
+
+
+
As mentioned above, without pkgconfig the whole build process will be lots
of pain and suffering, so make sure you have a copy on your system. If it is
not available natively, here is how to compile it.
@@ -240,10 +251,9 @@ not available natively, here is how to compile it.
./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
$MAKE
$MAKE install
-
-- Building zlib
-
--
+
+
+
Chances are very high that you already have that on your system ...
cd $BUILD_DIR
@@ -253,10 +263,9 @@ not available natively, here is how to compile it.
./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC" --shared
$MAKE
$MAKE install
-
-- Building libpng
-
--
+
+
+
Libpng itself requires zlib to build, so we need to help a bit. If you
already have a copy of zlib on your system (which is very likely) you can
drop the settings of LDFLAGS and CPPFLAGS. Note that the backslash (\) at
@@ -269,10 +278,9 @@ the end of line 4 means that line 4 and line 5 are on one line.
env CFLAGS="-O3 -fPIC" ./configure --prefix=$INSTALL_DIR
$MAKE
$MAKE install
-
-- Building freetype
-
--
+
+
+
cd $BUILD_DIR
wget http://oss.oetiker.ch/rrdtool/pub/libs/freetype-2.3.5.tar.gz
@@ -285,10 +293,9 @@ the end of line 4 means that line 4 and line 5 are on one line.
add the following at the start the configure line:
env EGREP=egrep
-
-- Building LibXML2
-
--
+
+
+
cd $BUILD_DIR
wget http://oss.oetiker.ch/rrdtool/pub/libs/libxml2-sources-2.6.31.tar.gz
@@ -297,10 +304,9 @@ add the following at the start the configure line:
./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
$MAKE
$MAKE install
-
-- Building fontconfig
-
--
+
+
+
Note that fontconfig has a run time configuration file in INSTALL_DIR/etc you
may want to adjust that so that fontconfig finds the fonts on your system.
Run the fc-cache program to build the fontconfig cache after changing the
@@ -313,10 +319,9 @@ config file.
./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
$MAKE
$MAKE install
-
-- Building Pixman
-
--
+
+
+
cd $BUILD_DIR
wget http://oss.oetiker.ch/rrdtool/pub/libs/pixman-0.10.0.tar.gz
@@ -325,10 +330,9 @@ config file.
./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
$MAKE
$MAKE install
-
-- Building Cairo
-
--
+
+
+
cd $BUILD_DIR
wget http://oss.oetiker.ch/rrdtool/pub/libs/cairo-1.6.4.tar.gz
@@ -341,10 +345,9 @@ config file.
CFLAGS="-O3 -fPIC"
$MAKE
$MAKE install
-
-- Building Glib
-
--
+
+
+
cd $BUILD_DIR
wget http://oss.oetiker.ch/rrdtool/pub/libs/glib-2.15.4.tar.gz
@@ -353,10 +356,9 @@ config file.
./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
$MAKE
$MAKE install
-
-- Building Pango
-
--
+
+
+
cd $BUILD_DIR
wget http://oss.oetiker.ch/rrdtool/pub/libs/pango-1.21.1.tar.gz
@@ -365,8 +367,9 @@ config file.
./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC" --without-x
$MAKE
$MAKE install
-
-
+
+
+
Now all the dependent libraries are built and you can try again. This time
you tell configure where it should be looking for libraries and include
files. This is done via environment variables. Depending on the shell you
@@ -376,13 +379,13 @@ because it seems that a fair number of people have ill configured python and
tcl setups that would prevent rrdtool from building if they are included in
their current state.
- cd $BUILD_DIR/rrdtool-1.3.0
+ cd $BUILD_DIR/rrdtool-1.3.1
./configure --prefix=$INSTALL_DIR --disable-tcl --disable-python
$MAKE clean
$MAKE
$MAKE install
SOLARIS HINT: if you want to build the perl module for the native perl (the
-one shipping with Solaris) you will need the sun forte compiler installed on
+one shipping with Solaris) you will need the Sun Forte compiler installed on
your box or you have to hand-tune bindings/perl-shared/Makefile while
building!
Now go to $INSTALL_DIR/share/rrdtool/examples/ and run them to see if
@@ -391,9 +394,7 @@ your build has been successful.
-Tobias Oetiker <tobi@oetiker.ch>
-
-
+Tobias Oetiker <tobi@oetiker.ch>