zoneserver - handle zone transfers and other TCP functions for MaraDNS
zoneserver listens on port 53/tcp and handles DNS zone transfers and any
DNS query done over TCP instead of UDP.
zoneserver uses a configuration
file,
/usr/local/etc/maradns by default, to determine its parameters.
zoneserver -f pointer_to_mararc_file
- -f
- Specifies the location of the configuration file. MaraDNS uses the same
configuration file for both the main dns server and the zoneserver.
The file format for the mararc file can be found in the
mararc(5) manual
page. In particular, the zoneserver uses the zone_transfer_acl,
tcp_convert_acl, tcp_convert_server, and bind_address mararc parameters.
In this example mararc file, which is used both by maradns and zoneserver, we
allow 10.1.2.3, 10.1.14.7, and 192.168.116.{any} to transfer zones, and we
allow anyone on the internet to perform TCP queries. The only zone served in
this example is example.com:
ipv4_bind_addresses = "10.1.1.1" # Our IP
tcp_convert_server = "10.1.1.1" # IP of UDP DNS server
tcp_convert_acl = "0.0.0.0/0" # Anyone may do DNS-over-TCP
chroot_dir = "/usr/local/etc/maradns" # Where zone files are
csv2 = {} # Initialize list of zone files
csv2["example.com."] = "db.example.com" # example.com zone file
# The next line is a list of who can transfer zones from us
zone_transfer_acl = "10.1.2.3, 10.1.14.7, 192,168.116.0/24"
The man pages
maradns(8) and
mararc(5)
http://www.maradns.org
zoneserver assumes that the authoritative NS records are immediately
after the SOA record, and that there is at least one non-NS between that last
authority NS record for the zone and the first delegation NS record.
IXFR requests are incremental zone transfers, meaning that the DNS server should
only display records changed since the last IXFR request.
zoneserver,
however, treats an IXFR as if it were an AXFR request, outputting all of the
records for the zone in question.
zoneserver closes the TCP connection after transferring the requested
zone.
If an unauthorized client attempts to connect to the zoneserver,
zoneserver immediately disconnects the unauthorized client.
THIS SOFTWARE IS PROVIDED BY THE AUTHORS ''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 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.
MaraDNS is written by Sam Trenholme. Jaakko Niemi used 5 minutes to put the
original version this manpage together. Sam has subsequently revised this
manual page.