Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help

       dnscheck-dispatcher - daemon program to run tests from a	database queue

	   dnscheck-dispatcher [--debug]

       This daemon puts	itself into the	background (unless the --debug flag is
       given) and repeatedly queries the table "queue" in the configured
       database	for domains to test. When it gets one, it spawns a new process
       to run the tests.  If there are no domains to check, or if the
       configured maximum number of active child processes has been reached,
       it sleeps 0.25 seconds and then tries again. It keeps doing this	until
       it is terminated	by a SIGTERM. At that point, it	will wait until	all
       children	have died and cleanups been performed before it	removes	its
       PID file	and then exits.

	   Prevents the	daemon from going into the background and duplicates
	   log information to standard output (it still	goes to	syslog as

       dnscheck-dispatcher shares configuration	files with the DNSCheck	perl
       modules.	Or, to be more precise,	it creates such	an object and then
       queries its configuration object	for its	configuration information. It
       also uses the DNSCheck object to	get its	database connection.

       There are two keys in the configuration YAML files that are of interest
       for the dispatcher. The first one is "syslog". It has the subkeys
       "ident",	which specifies	the name the daemon will use when talking to
       syslogd,	and "facility",	which specifies	the syslog facility to use.

       The second one is "daemon". It has the subkeys "pidfile", "errorlog",
       "maxchild" and "savelevel". They	specify, in order, the file where the
       daemon will write its PID after it has detached,	the file it will
       redirect	its standard error to, the maximum number of concurrent	child
       processes it may	have and the minumum log level to save to the
       database. Make sure to set the pathnames	to values where	the user the
       daemon is running under has write permission, since it will terminated
       if they are specified but can't be written to. Additionally, running
       with a maxchild value of	n means	that at	least n+1 simultaneous
       connections to the database will	be opened. Make	sure that the database
       can actually handle that, or everything will die	with more or less
       understandable error messages.

       If everything works as intended nothing should ever be written to the
       errorlog. All normal log	outout goes to syslog (and, with the debug
       flag, standard output).

perl v5.32.1			  2022-04-03		DNSCHECK-DISPATCHER(1)


Want to link to this manual page? Use this URL:

home | help