Commit 7dbd08c2 authored by Michael Stapelberg's avatar Michael Stapelberg
Browse files

fix documentation of ::Handler

parent 14553c45
......@@ -5,7 +5,7 @@ use warnings;
use inc::Module::Install;
name 'AllKnowingDNS';
all_from 'lib/App/AllKnowingDNS/Handler.pm';
all_from 'script/all-knowing-dns';
requires 'Net::DNS';
requires 'Privileges::Drop';
......
......@@ -11,9 +11,23 @@ use App::AllKnowingDNS::Zone;
use POSIX qw(strftime);
use v5.10;
=head1 NAME
App::AllKnowingDNS::Handler - main code of AllKnowingDNS
=head1 DESCRIPTION
Note: User documentation is in all-knowing-dns(1).
This module contains the C<Net::DNS::Nameserver> handler function.
=head1 FUNCTIONS
=cut
our @EXPORT = qw(reply_handler);
our $VERSION = '1.0';
our $VERSION = '1.1';
sub handle_ptr_query {
my ($querylog, $zone, $qname, $qclass, $qtype) = @_;
......@@ -107,29 +121,9 @@ sub reply_handler {
__END__
=head1 NAME
AllKnowingDNS - Tiny DNS server for IPv6 Reverse DNS
=head1 DESCRIPTION
AllKnowingDNS provides reverse DNS for IPv6 networks which use SLAAC
(autoconf), e.g. for a /64 network.
The problem with IPv6 reverse DNS and traditional nameservers is that the
nameserver requires you to provide a zone file. Assuming you want to provide
RDNS for a /64 network, you have 2**64 = 18446744073709551616 different usable
IP addresses (a little less if you are using SLAAC). Providing a zone file for
that, even in a very terse notation, would consume a huge amount of disk space
and could not possibly be held in the memory of the computers we have nowadays.
AllKnowingDNS instead generates PTR and AAAA records on the fly. You only
configure which network you want to serve and what your entries should look
like.
=head1 VERSION
Version 1.0
Version 1.1
=head1 AUTHOR
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment