1ZONESERVER(8)                     zoneserver                     ZONESERVER(8)
2
3
4

NAME

6       zoneserver - handle zone transfers and other TCP functions for MaraDNS
7

DESCRIPTION

9       zoneserver listens on port 53/tcp and handles DNS zone transfers and
10       any DNS query done over TCP instead of UDP.  zoneserver uses a
11       configuration file, /etc/mararc by default, to determine its
12       parameters.
13

USAGE

15       zoneserver -f pointer_to_mararc_file
16

OPTIONS

18       -f  Specifies the location of the configuration file. MaraDNS uses the
19           same configuration file for both the main dns server and the
20           zoneserver.
21

CONFIGURATION FILE FORMAT

23       The file format for the mararc file can be found in the mararc(5)
24       manual page. In particular, the zoneserver uses the zone_transfer_acl,
25       tcp_convert_acl, tcp_convert_server, and bind_address mararc
26       parameters.
27

EXAMPLE MARARC FILE

29       In this example mararc file, which is used both by maradns and
30       zoneserver, we allow 10.1.2.3, 10.1.14.7, and 192.168.116.{any} to
31       transfer zones, and we allow anyone on the internet to perform TCP
32       queries. The only zone served in this example is example.com:
33
34       ipv4_bind_addresses = "10.1.1.1" # Our IP
35       tcp_convert_server = "10.1.1.1" # IP of UDP DNS server
36       tcp_convert_acl = "0.0.0.0/0" # Anyone may do DNS-over-TCP
37       chroot_dir = "/etc/maradns" # Where zone files are
38       csv2 = {} # Initialize list of zone files
39       csv2["example.com."] = "db.example.com" # example.com zone file
40       # The next line is a list of who can transfer zones from us
41       zone_transfer_acl = "10.1.2.3, 10.1.14.7, 192,168.116.0/24"
42
43

SEE ALSO

45       The man pages maradns(8) and mararc(5)
46
47       http://www.maradns.org
48

BUGS

50       zoneserver assumes that the authoritative NS records are immediately
51       after the SOA record, and that there is at least one non-NS between
52       that last authority NS record for the zone and the first delegation NS
53       record.
54
55       IXFR requests are incremental zone transfers, meaning that the DNS
56       server should only display records changed since the last IXFR request.
57       zoneserver, however, treats an IXFR as if it were an AXFR request,
58       outputting all of the records for the zone in question.
59
60       zoneserver closes the TCP connection after transferring the requested
61       zone.
62
63       If an unauthorized client attempts to connect to the zoneserver,
64       zoneserver immediately disconnects the unauthorized client.
65
67       THIS SOFTWARE IS PROVIDED BY THE AUTHORS ''AS IS'' AND ANY EXPRESS OR
68       IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
69       WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
70       DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR
71       ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
72       DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
73       OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
74       HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
75       STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
76       IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
77       POSSIBILITY OF SUCH DAMAGE.
78

AUTHOR

80       MaraDNS is written by Sam Trenholme. Jaakko Niemi used 5 minutes to put
81       the original version this manpage together.  Sam has subsequently
82       revised this manual page.
83
84
85
86
87October 2001                      zoneserver                     ZONESERVER(8)
Impressum