Code

Changed `DataDir' to be a valid option for mode `Server' too, since it's the working...
authorocto <octo>
Mon, 16 Jan 2006 21:23:24 +0000 (21:23 +0000)
committerocto <octo>
Mon, 16 Jan 2006 21:23:24 +0000 (21:23 +0000)
Wrote a part of collectd.conf(5) (file `collectd.conf.pod')

src/Makefile.am
src/collectd.conf.pod [new file with mode: 0644]
src/collectd.pod
src/configfile.c

index 6710595080a207e1fe19f5a1f2fdbc99cad983e9..236821eb8c115fecddd45133d5ab24a55af7128e 100644 (file)
@@ -204,10 +204,13 @@ collectd_LDADD += "-dlopen" users.la
 collectd_DEPENDENCIES += users.la
 endif
 
-man_MANS = collectd.1
+man_MANS = collectd.1 collectd.conf.5
 #collectd_1_SOURCES = collectd.pod
 
 EXTRA_DIST = $(man_MANS)
 
 .pod.1:
        pod2man --release=$(VERSION) --center=$(PACKAGE) $< >$@
+
+.pod.5:
+       pod2man --section=5 --release=$(VERSION) --center=$(PACKAGE) $< >$@
diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod
new file mode 100644 (file)
index 0000000..e4d86e7
--- /dev/null
@@ -0,0 +1,103 @@
+=head1 NAME
+
+collectd.conf - Configuration for the system statistics collection daemon B<collectd>
+
+=head1 SYNOPSIS
+
+  Mode Client
+  DataDir /path/to/data/
+  PIDFile /path/to/pidfile/collectd.pid
+  LogFile /path/to/logfile/collectd.log
+  Server  123.123.123.123
+  Port    12345
+
+  LoadPlugin cpu
+  LoadPlugin load
+  LoadPlugin ping
+
+  <Plugin ping>
+    Host example.org
+    Host provider.net
+  </Plugin>
+
+=head1 DESCRIPTION
+
+The syntax of collectd's config file is similar to the config file of the famos
+I<Apache Webserver>. Each line either ... FIXME
+
+=head1 OPTIONS
+
+The available options.. Blah blah blah
+
+=head2 Glocal Options
+
+=over 4
+
+=item B<Mode> (B<Local>|B<Client>|B<Server>)
+
+Sets the operating mode. See the section B<MODES> in L<collectd(1)> for a
+description. This option determines which other options are allowed.
+
+=item B<LoadPlugin> I<Plugin>
+
+Loads the plugin I<Plugin>. There must be at least one such line or B<collectd>
+will be mostly useless. The names of the plugins are listed in L<collectd(1)>.
+
+=item B<PIDFile> I<File>
+
+Sets where to write the PID file to. This file is overwritten when it exists
+and deleted when the program ist stopped. Available in B<all modes>.
+
+=item B<DataDir> I<Directory>
+
+Sets the data directory. This is the directory beneath all RRD-files are
+created. Possibly more subdirectories are created. This is also the working
+directory for the daemon. Available in B<all modes>, though the B<Server> mode
+won't write to this directory.
+
+=item B<LogFile> I<File>
+
+Sets the file to write debugging output to. This is only used if compiled with
+debugging enabled. It's ignored otherwise. Available in B<all modes>.
+
+=item B<Server> I<Hostname or IP-address>
+
+The server to send data to. B<This is not yet implemented!> Maybe a better name
+for this was B<Receiver>, since I plan on detecting multicast groups
+automatically. On the other hand a extra MulticastGroup-option would be of
+interest for the server process. Anyhow, right now this is available for the
+B<Client> mode only.
+
+=item B<Port> I<Port number>
+
+(UDP-)Port to send packages to or to bind to and wait for packages. This option
+is available in the B<Client> and B<Server> mode.
+
+=back
+
+=head2 Plugin options
+
+=over
+
+=item B<ping>-Plugin
+
+=over 4
+
+=item B<Host> I<Hostname or IP-address>
+
+Host to ping periodically. This option may be repeated several times to ping
+multiple hosts.
+
+=back
+
+=back
+
+=head1 SEE ALSO
+
+L<collectd(1)>
+
+=head1 AUTHOR
+
+Florian Forster E<lt>octo@verplant.orgE<gt>
+
+=cut
index 935f2fe0603129fcb92e79ea9b17c57037e0edb7..4df62fa09a6ffd4aa0d8726ae05777f6a91323cd 100644 (file)
@@ -358,7 +358,8 @@ L<http://www.guzu.net/linux/hddtemp.php>.
 
 =head1 SEE ALSO
 
-L<rrdtool(1)>, L<sensors(1)>, L<hddtemp(8)>, L<kstat(3KSTAT)>
+L<collectd.conf(5)>, L<rrdtool(1)>, L<sensors(1)>, L<hddtemp(8)>,
+L<kstat(3KSTAT)>
 
 =head1 AUTHOR
 
index ed8cb77e438138aa01044f063d5f64bb94914936..988f7312b1fca159cffac54dfbc99ddbdc302fc9 100644 (file)
@@ -70,7 +70,7 @@ static cf_mode_item_t cf_mode_list[] =
        {"Server",      NULL, MODE_CLIENT                           },
        {"Port",        NULL, MODE_CLIENT | MODE_SERVER             },
        {"PIDFile",     NULL, MODE_CLIENT | MODE_SERVER | MODE_LOCAL},
-       {"DataDir",     NULL, MODE_SERVER |               MODE_LOCAL},
+       {"DataDir",     NULL, MODE_SERVER | MODE_SERVER | MODE_LOCAL},
        {"LogFile",     NULL, MODE_SERVER | MODE_SERVER | MODE_LOCAL}
 };
 static int cf_mode_num = 5;