src/rrd_{client,daemon}.c: Move to a ASCII only protocol.
[rrdtool.git] / doc / rrdd.pod
1 =pod
2
3 =head1 NAME
4
5 RRDd - Data caching daemon for rrdtool
6
7 =head1 SYNOPSIS
8
9 B<rrdd> [B<-l> I<address>] [B<-w> I<timeout>] [B<-f> I<timeout>]
10
11 =head1 DESCRIPTION
12
13 RRDd is a daemon that receives updates to existing RRD files, accumulates them
14 and, if enough have been received or a defined time has passed, writes the
15 updates to the RRD file. A I<flush> command may be used to force writing of
16 values to disk, so that graphing facilities and similar can work with
17 up-to-date data.
18
19 =head1 OPTIONS
20
21 =over 4
22
23 =item B<-l> I<address>
24
25 Tells the daemon to bind to I<address> and accept incoming connections on that
26 socket. If I<address> begins with C<unix:>, everthing following that prefix is
27 interpreted as the path to a UNIX domain socket. Otherwise the address or node
28 name are resolved using L<getaddrinfo(3)>.
29
30 =item B<-w> I<timeout>
31
32 Data is written to disk every I<timeout> seconds.
33
34 =item B<-f> I<timeout>
35
36 Every I<timeout> seconds the entire cache is searched for old values which are
37 written to disk. This only concerns files to which updates have stopped, so
38 setting this to a high value, such as 3600 seconds, is acceptable in most
39 cases.
40
41 =head1 BUGS
42
43 =over 4
44
45 =item 
46
47 Uses way too much CPU time after running for a while.
48
49 =item
50
51 Base directory is currently hard coded. The daemon will chdir to C</tmp/>.
52
53 =back
54
55 =head1 SEE ALSO
56
57 L<rrdtool(1)>, L<rrdgraph(1)>
58
59 =head1 AUHOR
60
61 RRDd and this manual page have been written by Florian Forster
62 E<lt>octoE<nbsp>atE<nbsp>verplant.orgE<gt>.