1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
libnet-dns-perl for DEBIAN
--------------------------
The following text are parts of the upstream README file
/usr/doc/libnet-dns-perl/README.gz (with little changes
to fit in a Debian system).
General
-------
Net::DNS is a Perl interface to the DNS resolver. It allows the
programmer to perform any type of DNS query from a Perl script.
For details and examples, please read the Net::DNS manual page.
There are a few demonstration scripts in the
/usr/doc/libnet-dns-perl/demo/ directory.
See README there for more information.
Contributed scripts are in the
/usr/doc/libnet-dns-perl/contrib/ directory,
see README there for more information.
The author would be happy to include any contributed scripts in
future versions of this module. All he asks is that they be documented
(preferably using POD) and that the contributor's name and contact
information be mentioned somewhere.
Dynamic Updates
---------------
Net::DNS now supports DNS dynamic updates as documented in RFC 2136;
for more information and an example, please see the Net::DNS::Update
manual page.
The dynamic update code is still under development but the author decided
to make it available to those who'd like to try it; please see the
TODO file for some of the things the author still needs to work on. At this
time, the author recommends that you don't use Net::DNS to maintain a production
nameserver via dynamic updates.
Please note that there are some bugs in the BIND 8.1-REL nameserver
that can cause it to dump core when receiving certain dynamic
updates, so if you have problems using Net::DNS that might be the
cause. The author recommends using BIND 8.1.1 or later.
Here's a summary of the update semantics for those interested (see
RFC 2136 for details):
PREREQUISITE SECTION
# RRs NAME TTL CLASS TYPE RDLENGTH RDATA
----- ---- --- ----- ---- -------- -----
yxrrset 1 name 0 ANY type 0 empty
yxrrset 1+ name 0 class type rdlength rdata
nxrrset 1 name 0 NONE type 0 empty
yxdomain 1 name 0 ANY ANY 0 empty
nxdomain 1 name 0 NONE ANY 0 empty
UPDATE SECTION
# RRs NAME TTL CLASS TYPE RDLENGTH RDATA
----- ---- --- ----- ---- -------- -----
add RRs 1+ name ttl class type rdlength rdata
del RRset 1 name 0 ANY type 0 empty
del all RRsets 1 name 0 ANY ANY 0 empty
del RRs 1+ name 0 NONE type rdlength rdata
Bugs
----
*** THIS VERSION OF Net::DNS IS FOR TESTING AND STILL CONTAINS BUGS ***
Net::DNS is still in its early stages and is sure to contain a few
bugs. Please see the TODO and Changes files for more information.
As mentioned in the Dynamic Updates section above, the author doesn't recommend
using Net::DNS to maintain a production nameserver via dynamic
updates unless you've tested it *thoroughly*. This author takes no
blame if you corrupt your zone.
If you find a bug, please report it to the author along with the
following information:
* version of Perl
* version of Net::DNS
* version of IO
* operating system type and version
* version of nameserver (if known)
* exact text of error message or description of problem
* the shortest possible program that exhibits the problem
* the specific queries you're making, if the data is available
to Internet nameservers
If the author doesn't have access to a system similar to yours, he may ask you
to insert some debugging lines and report back on the results.
The more help and information you can provide, the better.
Certainly you may use the Debian Bug Tracking System
(http://www.debian.org/Bugs) as usual. If your bug is a
bug in the upstream package the Debian package maintainer will
forward it to the upstream author.
|
