NAME

delphinusdnsd — the Delphinus DNS daemon

SYNOPSIS

DESCRIPTION

delphinusdnsd is the daemon that runs Delphinus DNS.

The options are as follows:

-b

address Adds an address that delphinusdnsd should bind(2) to. This option can be repeated multiple times to add more. May not be used in conjunction with -i.

-d

Turn on debug mode. delphinusdnsd does not fork into the background with this. Messages are printed in the foreground.

-f

file The configuration file to be used is found at file.

-I

identstring Allows the operator to specify an identification string to reflect in the process listing and subsequent dddctl(8) start/stop/restart commands. This helps identifying the processes when many delphinusdnsd run in a system. May not be used in conjunction with -s.

-i

interface The particular interface that delphinusdnsd should listen on. This option can be specified multiple times. May not be used in conjunction with -b.

-l

Turn logging of queries on.

-n

instances is the number of instances plus one that should be forked for delphinusdnsd. This may be good for multi-cpu/core boxes.

-p

port Specifies the port that delphinusdnsd should listen on.

-s

path Specifies the socket path to use with dddctl(8). May not be used in conjunction with -I.

-v

Be more verbose in debug mode. This shows configfile parsing logic.

delphinusdnsd 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.

It should be noted that delphinusdnsd has a forwarding mode since version 1.5. This mode should be treated as experimental.

FILES

/var/delphinusdnsd/etc/delphinusdns.conf

default delphinusdnsd config file

/var/delphinusdnsd/replicant/

default replicant directory for AXFR zones

/var/run/delphinusdnsd.sock

default delphinusdnsd control socket

SEE ALSO

delphinusdns.conf(5), dddctl(8)

STANDARDS

P. Mockapetris, DOMAIN NAMES - IMPLEMENTATION AND SPECIFICATION, RFC 1035, November 1987.

P. Vixie, A Mechanism for Prompt Notification of Zone Changes (DNS NOTIFY), RFC 1996, August 1996.

S. Thomson, C. Huitema, V. Ksinant, and M. Souissi, DNS Extensions to Support IP Version 6, RFC 3596, October 2003.

R. Arends, R. Austein, M. Larson, D. Massey, and S. Rose, Resource Records for the DNS Security Extensions, RFC 4034, March 2005.

B. Laurie, G. Sisson, R. Arends, and D. Blacka, DNS Security (DNSSEC) Hashed Authenticated Denial of Existence, RFC 5155, March 2008.

J. Damas, M. Graff, and P. Vixie, Extension Mechanisms for DNS (EDNS(0)), RFC 6891, April 2013.

J. Dickinson, S. Dickinson, R. Bellis, A. Mankin, and D. Wessels, DNS Transport over TCP - Implementation Requirements, RFC 7766, March 2016.

F. Dupont, S. Morris, P. Vixie, D. Eastlake 3rd, O. Gudmundsson, and B. Wellington, Secret Key Transaction Authentication for DNS (TSIG), RFC 8945, November 2020.

O. Sury, W. Toorop, D. Eastlake 3rd, and M. Andrews, Interoperable Domain Name System (DNS) Server Cookies, RFC 9018, April 2021.

AUTHORS

This software was written by Peter J. Philipp ⟨pbug44@delphinusdns.org⟩