.\" Copyright (c) 2005-2021 Peter J. Philipp
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. The name of the author may not be used to endorse or promote products
.\"    derived from this software without specific prior written permission
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' 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 AUTHOR 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.
.\"
.Dd January 6, 2021
.Dt DELPHINUSDNSD 8
.Os 
.Sh NAME
.Nm delphinusdnsd
.Nd the Delphinus DNS daemon
.Sh SYNOPSIS
.Nm delphinusdnsd
.Op Fl dlv
.Op Fl b Ar address
.Op Fl f Ar file
.Op Fl I Ar identstring
.Op Fl i Ar interface
.Op Fl n Ar instances
.Op Fl p Ar port
.Op Fl s Ar path
.Sh DESCRIPTION
.Nm
is the daemon that runs Delphinus DNS.
.Pp
The options are as follows:
.Pp
.Bl -tag -width Ds
.It Fl b
.Ar address
Adds an 
.Ar address 
that
.Nm
should 
.Xr bind 2
to.  This option can be repeated multiple times to add more. May
not be used in conjunction with 
.Fl i .
.It Fl d
Turn on debug mode.  
.Nm 
does not fork into the background with this.  Messages are printed in the 
foreground.
.It Fl f
.Ar file
The configuration file to be used is found at 
.Ar file .
.It Fl I
.Ar identstring
Allows the operator to specify an identification string to reflect in the
process listing and subsequent 
.Xr dddctl 8 
start/stop/restart commands.  This helps identifying the processes when many
.Nm
run in a system.  May not be used in conjunction with
.Fl s .
.It Fl i
.Ar interface
The particular
.Ar interface 
that 
.Nm
should listen on.  This option can be specified multiple times.  May not be
used in conjunction with 
.Fl b .
.It Fl l
Turn logging of queries on.
.It Fl n
.Ar instances
is the number of instances plus one that should be forked for 
.Nm .
This may be good for multi-cpu/core boxes.
.It Fl p
.Ar port
Specifies the 
.Ar port
that 
.Nm 
should listen on.
.It Fl s
.Ar path
Specifies the socket path to use with 
.Xr dddctl 8 .
May not be used in conjunction with 
.Fl I .
.It Fl v
Be more verbose in debug mode.  This shows configfile parsing logic.
.El
.Pp
.Nm 
is an authoritative and forwarding DNS server.  It can run as master or 
replicant.
When new configfiles are written it must be restarted.  For replicants that
receive notifies or timeout on the refresh or retry SOA values the daemon is
restarted automatically. 
.Sh FILES
.Bl -tag -width /var/delphinusdnsd/etc/delphinusdns.conf -compact
.It Pa /var/delphinusdnsd/etc/delphinusdns.conf
default 
.Nm
config file
.It Pa /var/delphinusdnsd/replicant/
default replicant directory for AXFR zones
.It Pa /var/run/delphinusdnsd.sock
default 
.Nm
control socket
.El
.Sh SEE ALSO
.Xr delphinusdns.conf 5 , 
.Xr dddctl 8
.Sh AUTHORS
This software was written by
.An Peter J. Philipp Aq petphi@delphinusdns.org