delphinusdnsd.8

.\" 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 June 2, 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 DNS server.  It can run as primary 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. 
.Pp
It should be noted that 
.Nm
has a forwarding mode since version 1.5.  This mode should be treated as 
experimental.
.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 STANDARDS
.Rs
.%A P. Mockapetris
.%D November 1987
.%R RFC 1035
.%T DOMAIN NAMES - IMPLEMENTATION AND SPECIFICATION
.Re
.Pp
.Rs
.%A P. Vixie
.%D August 1996
.%R RFC 1996
.%T A Mechanism for Prompt Notification of Zone Changes (DNS NOTIFY)
.Re
.Pp
.Rs
.%A S. Thomson
.%A C. Huitema
.%A V. Ksinant
.%A M. Souissi
.%D October 2003
.%R RFC 3596
.%T DNS Extensions to Support IP Version 6
.Re
.Pp
.Rs
.%A R. Arends
.%A R. Austein
.%A M. Larson
.%A D. Massey
.%A S. Rose
.%D March 2005
.%R RFC 4034
.%T Resource Records for the DNS Security Extensions
.Re
.Pp
.Rs
.%A B. Laurie
.%A G. Sisson
.%A R. Arends
.%A D. Blacka
.%D March 2008
.%R RFC 5155
.%T DNS Security (DNSSEC) Hashed Authenticated Denial of Existence
.Re
.Pp
.Rs
.%A J. Damas
.%A M. Graff
.%A P. Vixie
.%D April 2013
.%R RFC 6891
.%T Extension Mechanisms for DNS (EDNS(0))
.Re
.Pp
.Rs
.%A J. Dickinson
.%A S. Dickinson
.%A R. Bellis
.%A A. Mankin
.%A D. Wessels
.%D March 2016
.%R RFC 7766
.%T DNS Transport over TCP - Implementation Requirements
.Re
.Pp
.Rs
.%A F. Dupont
.%A S. Morris
.%A P. Vixie
.%A D. Eastlake 3rd
.%A O. Gudmundsson
.%A B. Wellington
.%D November 2020
.%R RFC 8945
.%T Secret Key Transaction Authentication for DNS (TSIG)
.Re
.Pp
.Rs
.%A O. Sury
.%A W. Toorop
.%A D. Eastlake 3rd
.%A M. Andrews
.%D April 2021
.%R RFC 9018
.%T Interoperable Domain Name System (DNS) Server Cookies
.Re
.Pp
.Sh AUTHORS
This software was written by
.An Peter J. Philipp Aq pbug44@delphinusdns.org