\input texinfo   @c -*-texinfo-*-
@setfilename knot.info
@include version.texi
@documentencoding UTF-8
@settitle Knot DNS @value{VERSION}

@paragraphindent 0

@defindex st
@syncodeindex vr st

@copying
This manual is for Knot DNS (version @value{VERSION}, @value{UPDATED}),
which is a high-performance authoritative-only DNS server.

Copyright @copyright{} 2012 CZ.NIC, z.s.p.o.

@quotation
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
@end quotation
@end copying

@dircategory Internet-application/server
@direntry
* Knot DNS: (Knot DNS) An authoritative-only DNS server
@end direntry

@titlepage
@title Knot DNS Reference Manual
@subtitle for version @value{VERSION}, @value{UPDATED}
@author Jan Kadlec (@email{jan.kadlec@@nic.cz})
@author Daniel Salzman (@email{daniel.salzman@@nic.cz})
@author Lubos Slovak (@email{lubos.slovak@@nic.cz})
@author Ondrej Sury (@email{ondrej@@sury.org})
@author Marek Vavrusa (@email{marek.vavrusa@@nic.cz})
@author Jan Vcelak (@email{jan.vcelak@@nic.cz})
@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage

@contents

@ifnottex
@node Top, Introduction, (dir), (dir)
@top Knot DNS

This manual is for Knot DNS (version @value{VERSION}, @value{UPDATED}).
@end ifnottex

@menu
* Introduction::
* Knot DNS Resource Requirements::
* Knot DNS Installation::
* Knot DNS Configuration::
* Running Knot DNS::
* Troubleshooting::
* Statement Index::
* Knot DNS Configuration Reference::
* Migration from other DNS servers::

@detailmenu
 --- The Detailed Node Listing ---

Introduction

* What is Knot DNS::
* Knot DNS features::
* Scope of this document::

Knot DNS Resource Requirements

* Hardware requirements::
* CPU requirements::
* Memory requirements::
* Supported operating system::

Knot DNS Installation

* Required build environment::
* Required libraries::
* Installation from the sources::
* Installation from packages::

Required libraries

* Userspace RCU::

Installation from the sources

* Configuring and generating Makefiles::
* Compilation::
* Installation::

Installation from packages

* Installing Knot DNS packages on Debian::
* Installing Knot DNS packages on Ubuntu::
* Installing Knot DNS packages on Fedora::
* Installing Knot DNS from ports on FreeBSD::

Installing Knot DNS packages on Ubuntu

* Adding official PPA repository for Knot DNS::

Knot DNS Configuration

* Minimal configuration::
* Slave configuration::
* Master configuration::
* Configuring multiple interfaces::

Sample Configurations

* Minimal configuration::
* Slave configuration::
* Master configuration::
* Configuring multiple interfaces::
* Enabling zone semantic checks::
* Creating IXFR differences from zone file changes::

Running Knot DNS

* Running a slave server::
* Running a master server::
* Controlling running daemon::

Troubleshooting

* Submitting a bugreport::
* Generating backtrace::
* Debug messages::

Debug messages

* Enabling debug messages in server::

Enabling debug messages in server

* Example::

Knot DNS Configuration Reference

* system::
* keys::
* interfaces::
* remotes::
* groups::
* zones::
* log::
* include::

@code{system} Statement

* system Syntax::
* system Statement Definition and Usage::
* system Example::

Statement Definition and Usage

* identity::
* version::
* nsid::
* storage::
* rundir::
* pidfile::
* workers::
* user::
* max-conn-idle::
* max-conn-handshake::
* max-conn-reply::
* rate-limit::
* rate-limit-size::
* rate-limit-slip::

@code{keys} Statement

* keys Syntax::
* keys Statement Definition and Usage::
* Example::

Statement Definition and Usage

* key_id::

interfaces

* interfaces Syntax::
* interfaces Statement Definition and Usage::
* interfaces Examples::

Statement Definition and Usage

* interface_id::

@code{remotes} Statement

* remotes Syntax::
* remotes Statement Definition and Grammar::

@code{groups} Statement

* groups Syntax::
* groups Statement Definition and Grammar::

@code{zones} Statement

* zones Syntax::
* zones Statement Definition and Grammar::
* zones List of zone semantic checks::

@code{log} Statement

* log Syntax::
* log Statement Definition and Grammar::

@code{include} Statement

* include Syntax::

@end detailmenu
@end menu

@c main chapters

@include introduction.texi
@include requirements.texi
@include installation.texi
@include configuration.texi
@include running.texi
@include troubleshooting.texi

@c indices
@include indices.texi

@c appendixes
@include reference.texi
@include migration.texi

@bye