togatherd - SNMP data gatherer daemon


  togatherd [options] configfile...


togatherd collects data from SNMP devices regularly and saves them via the program rrdtool(1). The TGcgi(1) scripts use this data to display WWW pages with graphs of the data.



Displays a short usage information and exits.


Names a configuration file. Can be given multiple times. Configuration files can be given as arguments on the command line too.


Specify a file which contains the names of configuration files, one on each line.


Names a MRTG configuration file. togatherd can use MRTG config files to ease the transition from MRTG to ToGather. Only one MRTG config file can be given but you can use the MRTG option ``include: otherfile'' to merge several files to one. See reference in the MRTG documentation.


Don't fork to background. Won't disconnect from the terminal and will display any messages on STDOUT/STDERR (instead of syslog).


Test only. Checks if the configuration is correct and reports errors. Won't touch the config cache so you can test a config file while another daemon is running on it.


Be verbose. Will tell you sometimes what it's doing. Accepts a number for the verbosity level (useful: 1-3).


With this option togatherd will rebuild the config cache rergardless whether it thinks it hasn't changed or --test is set. Won't touch the cache if another daemon is running on the config file.


togatherd will switch its process owners user id to this user if given.


togatherd will switch its process owners group id to this group if given.


Check a configuration:

  togatherd -t -v /var/netstat/config.cfg

And start the daemon if it's correct:

  togatherd -u netstat -g netadm /var/netstat/config.cfg


togatherd can be control by some SIGNALs:

 SIGINT    causes togatherd to exit
 SIGHUP    reload the config file
 SIGUSR1   increase the verbosity level
 SIGUSR2   set the verbosity level to 0

You can use the program tgctl to send some of the SIGNALs to the daemon. See tgctl(1) for how to tell togatherd to reload a config or to stop.


togatherd only collects data and populates the database (represented by some rrd files). It does not create any graphs or web pages like MRTG does. The ToGather package contains some CGIs to create web pages and graphs from the collected data.

The ToGather applications don't access a config file directly. Instead the file is parsed once and a 'cache' is created which allows faster access. The drawback is that at least the daemon togatherd needs write access to this cache file which usually means write access to the config files' directory.

Calling togatherd -t configfile after changing the configfile recreates the cache. Any other ToGather application shouldn't need write access to the cache file later.


ToGather(1), tg_config(1), tgweb.cgi(1), rrdtool(1)


 Rainer Bawidamann,
 University of Ulm, University Computer Centre


This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA