Code

be more careful when finding pic flags
[rrdtool-all.git] / program / README
1 Round Robin Database Tools
2 ==========================
3 $Id$
5 It is pretty easy to gather status information from all sorts of things,
6 ranging from the temperature in your office to the number of octets which
7 have passed through the FDDI interface of your router. But it is not so
8 trivial to store this data in a efficient and systematic manner. This is
9 where RRDtool kicks in. It lets you log and analyze the data you gather from
10 all kinds of data-sources (DS). The data analysis part of RRDtool is based
11 on the ability to quickly generate graphical representations of the data
12 values collected over a definable time period.
15 To compile:
16 -----------
18 check out the instructions in doc/rrdbuild.txt
20 Getting Started:
21 ----------------
23 Either after compiling or after installing you can try the example
24 RRDtool applications in the examples directory.
26 To learn:
27 ---------
29 Read the documentation in the doc directory. Start of with
30 RRDtool. All documents are available as html and as ASCII text.  
32 If you are looking for a more slow paced introduction, make sure to read
33 Alex van den Bogaerdt's rrdtutorial which is also available from the doc
34 directory. Also read his cdeftutorial and Steve Rader's rpntutorial.
35  
36 If you want to know about the format of the log files check
37 src/rrd_format.h there are a lot of comments in there ...
39 How to make Tobi happy:
40 -----------------------
42 If you want to show your appreciation for RRDtool you could make me happy
43 by going to http://tobi.oetiker.ch/wish and ordering a CD from
44 my CD wish list ... 
47 How to keep in touch:
48 ---------------------
50 There are 3 Mailing lists for RRDtool:
52 rrd-announce    LOW volume RRDtool Announcements List (Only Stable Releases)
53 rrd-users       For discussion amongst people who use RRDtool in their applications
54 rrd-developers  For people who actually HACK RRDtool code
56 To subscribe to <MAILGLIST> send a message with the subject 'subscribe'
57 to <MAILGLIST>-request@lists.oetiker.ch
59 Note, that postings to rrd-announce will always be cross-posted 
60 to rrd-users and rrd-developers as well.
62 To Contribute:
63 --------------
65 Contributed feature and bug patches are most welcome. But please
66 send complete patches. A complete patch patches the CODE as well
67 as the CHANGES, CONTRIBUTORS and the POD files.
69 Use GNU   diff --unified --recursive olddir newdir   to build your patches.
71 The latest Version:
72 -------------------
73 Is available from http://oss.oetiker.ch/rrdtool/
76 Tobias Oetiker <tobi@oetiker.ch>