1
.TH "PDNSD" "8" "May 2004" "pdnsd 1.1.10\-par" "System Administration Commands"
4
\fBpdnsd\fP \- proxy DNS daemon
8
\fBpdnsd\fP [\-h] [\-V] [\-s] [\-d] [\-g] [\-v\fIn\fR] [\-m\fIxx\fR] [\-c \fIfile\fR] [\-4] [\-6]
12
\fBpdnsd\fP is an IPv6 capable proxy domain name system (DNS) server
13
which caches the results of DNS lookups to disk.
20
enables IPv4 support. IPv6 support is automatically
21
disabled (should it be available). On by default.
24
enables IPv6 support. IPv4 support is automatically
25
disabled (should it be available). Off by default.
27
\fB\-V\fP, \fB\-\-version\fP
28
Print version information and exit.
30
\fB\-c\fP, \fB\-\-config\-file\fP \fIFILE\fP
31
Read configuration from \fIFILE\fP.
32
The default is \fI/etc/pdnsd.conf\fP.
34
\fB\-d\fP, \fB\-\-daemon\fP
35
Start \fBpdnsd\fP in daemon mode (i.e., as a background process).
37
\fB\-g\fP, \fB\-\-debug\fP
38
Print debug messages on the console (in non-daemon mode)
39
or to the file \fIpdnsd.debug\fP in the cache directory
42
\fB\-h\fP, \fB\-\-help\fP
45
\fB\-p\fP \fIPIDFILE\fP
46
While running store the process ID of the parent
48
process in \fIPIDFILE\fP.
51
Print the user as whom \fBpdnsd\fP will run and exit.
53
\fB\-s\fP, \fB\-\-status\fP
54
Enable the status control socket.
55
This option must be passed to the command line if you want
58
to control \fBpdnsd\fP at run time.
60
\fB\-t\fP, \fB\-\-tcp\fP
61
Enable the TCP server thread.
62
\fBpdnsd\fP will then serve TCP and UDP queries.
65
Set the verbosity of \fBpdnsd\fP.
66
\fIn\fP is a numeric argument between 0 (normal operation)
67
and 3 (many messages for debugging).
70
Set the query method \fBpdnsd\fP uses.
71
Possible values for \fIxx\fP are:
75
\- pdnsd will use TCP only. TCP queries usually take longer time than
76
UDP queries, but are more secure against certain attacks, where an
77
attacker tries to guess your query id and to send forged answers. TCP
78
queries are not supported by some name servers.
83
\- pdnsd will try to use TCP, and will fall back to UDP if its
84
connection is refused.
89
\- pdnsd will use UDP only. This is the fastest method, and should
90
be supported by all name servers on the Internet.
93
Additionally, \fBno\fP can be prepended to the
96
.BR \-\-debug and \-\-tcp
99
to reverse their effect.
104
\fBpdnsd\fP is usually run from an init script.
106
For \fBpdnsd\fP to work, You need to do two things.
109
1. Tell your system to use \fBpdnsd\fP as the primary DNS server.
111
To do this, put the following line in \fI/etc/resolv.conf\fP
117
where X can be any number. (I use 3).
118
This line should precede all other \fBnameserver\fP lines.
119
You should put the same value in the \fBserver_ip=\fP line in the
120
\fBglobal\fP section of \fI/etc/pdnsd.conf\fP.
124
2. Tell \fBpdnsd\fP where to get DNS information.
127
To tell \fBpdnsd\fP where to get DNS information, add the
128
following lines in \fI/etc/pdnsd.conf\fP:
133
ip="123.123.123.123"; /* Put your ISP's DNS server address here */
143
Note the opening and closing braces.
144
You can add another \fBserver\fP section
145
for each DNS server you want \fBpdnsd\fP to query.
148
Note that interface configurers sometimes replace
149
\fI/etc/resolv.conf\fP when an interface is brought up.
150
You need to disable such features.
151
If you use pppconfig, for example, you specify `none' in the
152
`nameservers' option in the `advanced' tab.
153
If you use multiple ISPs, you should do this for
154
each connection/account.
157
Note that if you have the
159
package installed and properly configured and you have
167
in \fI/etc/pdnsd.conf\fP then both \fI/etc/resolv.conf\fP and
169
nameserver list will be updated automatically.
173
\fI/etc/init.d/pdnsd\fP
175
\fI/etc/pdnsd.conf\fP
177
\fI/etc/resolv.conf\fP
179
\fI/etc/defaults/pdnsd\fP contains additional parameters or options
180
which may be passed to pdnsd at boot time. This saves the hassle of
181
fiddling with initscripts.
185
Report bugs to the authors.
189
\fBpdnsd\fP should comply with RFCs 1034 and 1035. As of version
190
1.0.0, RFC compliance has been improved and pdnsd is now believed (or
191
hoped?) to be fully RFC compatible. It completely follows RFC 2181
192
(except for one minor issue in the FreeBSD port, see the
195
It does \fINOT\fP support the following features, of which most are
196
marked optional, experimental or obsolete in these RFCs:
204
\(bu Completion queries
206
\(bu Namespaces other than IN (Internet)
208
\(bu AXFR and IXFR queries (whole zone transfers); since pdnsd does not maintain zones, that should not violate the standard
211
The following record types, that are extensions to the original DNS
212
standard, are supported if given as options at compile time. (if you
213
do not need them, you do not need to compile support for them into
214
pdnsd and save cache and executable space):
217
\(bu RP (responsible person, RFC 1183)
219
\(bu AFSDB (AFS database location, RFC 1183)
221
\(bu X25 (X25 address, RFC 1183)
223
\(bu ISDN (ISDN number/address, RFC 1183)
225
\(bu RT (route through, RFC 1183)
227
\(bu NSAP (Network Service Access Protocol address , RFC 1348)
229
\(bu PX (X.400/RFC822 mapping information, RFC 1995)
231
\(bu GPOS (geographic position, deprecated)
233
\(bu AAAA (IPv6 address, RFC 1886)
235
\(bu LOC (location, RFC 1876)
237
\(bu EID (Nimrod EID)
239
\(bu NIMLOC (Nimrod locator)
241
\(bu SRV (service record, RFC 2052)
243
\(bu ATMA (ATM address)
245
\(bu NAPTR (URI mapping, RFC 2168)
247
\(bu KX (key exchange, RFC 2230)
255
More documentation is available in the \fI/usr/share/doc/pdnsd/\fP directory.
259
\fBpdnsd\fP was originally written by Thomas Moestl,
263
and was extensively revised by Paul Rombouts
265
<p.a.rombouts@home.nl>
267
(for versions 1.1.10\-par and later).
269
Several others have contributed to \fBpdnsd\fP; see files in the
270
\fI/usr/share/doc/pdnsd/\fP directory.
272
This man page was written by Mahesh T. Pai
274
<paivakil@yahoo.co.in>
276
using the documents in \fI/usr/share/docs/pdnsd/\fP directory for Debian,
277
but can be used on other distributions too.
283
This man page is a part of the pdnsd package, and may be distributed
284
in original or modified form under terms of the GNU General Public
285
License, as published by the Free Software Foundation; either version
286
2, or (at your option) any later version.
289
You can find a copy of the GNU GPL in
290
the\fI/usr/share/common\-licenses/\fP directory if you are using a