zoneserver(8)

NAME
zoneserver - handle zone transfers and other TCP functions for MaraDNS

DESCRIPTIONx"
zoneserver listens on port 53/tcp and handles DNS zone transfers and all other DNS queries which utilize TCP instead of UDP. zoneserver uses a configuration file, /etc/mararc by default, to determine various parameters, such as the IP to bind to, and who is allowed to perform zone transfers.

USAGE
zoneserver -f pointer_to_mararc_file

OPTIONS

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

CONFIGURATION FILE FORMAT
The file format for the mararc file can be found in the mararc(5) manual page.

SEE ALSO
The man pages maradns(8) and mararc(5) http://www.maradns.org

BUGS
The DNS specification assumes that any DNS query that can be processed on UDP port 53 (e.g. The main maradns dns server) can also be processed on TCP port 53. However, the zoneserver can only process SOA, AXFR, and IXFR requests. In addtion, when a SOA request is sent, it assumes that the next query will be an AXFR or IXFR request. 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.

LEGAL DISCLAIMER
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.

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