.\" Do *not* edit this file; it was automatically generated by ej2man
.\" Look for a name.ej file with the same name as this filename
.\"
.\" Process this file with the following
.\" nroff -man -Tutf8 maradns.8 | tr '\020' ' '
.\"
.\" Last updated Tue Sep  9 06:40:20 2008
.\"
.TH DUENDE 8 "duende" "January 2003" "duende"
.\" We don't want hyphenation (it's too ugly)
.\" We also disable justification when using nroff
.\" Due to the way the -mandoc macro works, this needs to be placed
.\" after the .TH heading
.hy 0
.if n .na
.\"
.\" We need the following stuff so that we can have single quotes
.\" In both groff and other UNIX *roff processors
.if \n(.g .mso www.tmac
.ds aq \(aq
.if !\n(.g .if '\(aq'' .ds aq \'

.SH "NAME"
.PP
duende - run a child process as a daemon
.SH "DESCRIPTION"
.PP
.B "duende"
makes a given child process a daemon. The standard output
and standard error
of the child process is logged via syslog() with a priority of
LOG_INFO.
.SH "USAGE"
.PP
.B "duende"
child_process [ all subsequent arguments passed on to child ]
.SH "DETAILS"
.PP
When
.B "duende"
is invoked, it spawns two processes. In addition to
spawning the daemonized child process,
.B "duende"
also spawns a process
which reads and logs the standard output of the daemonized process. The
parent process stays alive so as to monitor the daemonized process.
.PP
.B "duende"
requires a blank directory named /etc/maradns/logger
to run.
.PP
Should the parent duende process a
HUP signal,
.B "duende"
will restart the child process. Should the
daemonized or logging process received an untrapped HUP signal or exit
with an exit
code of 8,
.B "duende"
will restart the process. Should the daemonized
or logging
process exit for any other reason,
.B "duende"
will send the logger
process a TERM signal and exit.
Should the duende
parent process receive a TERM or INT signal,
.B "duende"
sends all of its
children TERM signals, then exits.
.PP
The duende process must be started as the superuser; this is because
Duende\(aqs intended child processes (maradns and zoneserver) need to
bind
to privileged ports, and because
duende uses a setuid() call to change the user ID of the logging
process
to the user with ID 66.
.SH "LOGGING"
.PP
.B "duende"
uses the syslog() facility to log the standard output of the
program that it invokes. The name of the program (in other words, the
"ident" given to openlog()) is the full path of the first argument
given
to
.BR "duende" "."
All messages created by the child process are sent
to syslog() with a priority of LOG_INFO and a "facility"
of LOG_DAEMON (daemon.info in /etc/syslog.conf); since daemon.info
messages are not logged by default in FreeBSD, on FreeBSD systems
messages generated by the child process are logged with a priority of
LOG_ALERT and a "facility" of LOG_DAEMON (daemon.alert in
/etc/syslog.conf).
Should duende itself encounter an error, it will send
messages to syslog() with a priority of LOG_ALERT.
.PP
For example, suppose one invokes duende thusly:

.nf
	duende /usr/local/sbin/maradns
.fi

If invoked thusly, duende will log all messages with the "ident"
(program
name) of "/usr/local/sbin/maradns". If this is not desired, invoke
duende
with something like:

.nf
	export PATH=$PATH:/usr/local/sbin
	duende maradns
.fi

This will log messages with a (more sensible) "ident" of maradns.
.PP
Note: If a non-POSIX Bourne shell (such as csh, es, rc, or fish) is
used to
invoke MaraDNS, the above syntax needs to be changed.
.PP
Also, the directory /etc/maradns/logger, while used by duende, is not
used
to store any log messages. That is unless, for some reason, one
configures syslog to store messages there.
.SH "EXAMPLES"
.PP
Using duende to start maradns, where the mararc file is /etc/mararc.2

.nf
	duende maradns -f /etc/mararc.2
.fi

Using duende to start zoneserver, where the mararc file is
/etc/mararc.4

.nf
	duende zoneserver -f /etc/mararc.4
.fi

.SH "BUGS"
.PP
.B "Duende"
assumes that all of its children are well-behaved, eating
their vegetables, going to bed when told, and terminating
when receiving a TERM signal.
.SH "SEE ALSO"
.PP
.BR "maradns(8)" ","
.B "syslog(3)"

.br
http://www.maradns.org
.SH "LEGAL DISCLAIMER"
.PP
THIS SOFTWARE IS PROVIDED BY THE AUTHORS \(aq\(aqAS IS\(aq\(aq AND ANY
EXPRESS
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.SH "AUTHOR"
.PP
Duende and this man page are written by Sam Trenholme. D Richard Felker
III provided some invaluable assistance with the piping code which
.B "duende"
uses.