[hcoop/zz_old/debian/djbdns.git] / debian / djbdns-man / tinydns.8

.TH tinydns 8

.SH NAME
tinydns \- a DNS server.

.SH DESCRIPTION
.B tinydns
accepts iterative DNS queries
from hosts around the Internet,
and responds with locally configured information.

.SH Configuration
This is a reference page.
For tutorial information, see the instructions for
.br
.B running a DNS server
(http://cr.yp.to/djbdns/run-server.html).

Normally 
.B tinydns
is set up by the
.BR tinydns-conf (8)
program.

.B tinydns
runs chrooted in the directory
specified by the 
.I $ROOT
environment variable,
under the uid and gid
specified by the 
.I $UID
and 
.I $GID
environment variables.

.B tinydns
listens for incoming UDP packets
addressed to port 53 of 
.IR $IP .
It does not listen for TCP queries.

.B tinydns
answers queries
as specified by 
.IR data.cdb ,
a binary file created by
.BR tinydns-data (8).

.SH Further details

.B tinydns
rejects
zone-transfer requests,
inverse queries, non-Internet-class queries, truncated packets, and
packets that contain anything other than a single query.

.BR tinydns ,
like BIND,
includes NS records with answers to most queries.
This increases DNS packet sizes,
but it draws queries away from parent servers,
and reduces the frequency of long DNS delays.
With the default 
.BR tinydns-data (8)
cache times,
a client that uses a normal record at least once every day
will always have the corresponding NS records cached
and will never have to talk to parent servers.

.SH SEE ALSO
tinydns-conf(8),
tinydns-data(8)

http://cr.yp.to/djbdns.html
Commit	Line	Data
b4588d5c GP	1	.TH tinydns 8
	2
	3	.SH NAME
	4	tinydns \- a DNS server.
	5
	6	.SH DESCRIPTION
	7	.B tinydns
	8	accepts iterative DNS queries
	9	from hosts around the Internet,
	10	and responds with locally configured information.
	11
	12	.SH Configuration
	13	This is a reference page.
	14	For tutorial information, see the instructions for
	15	.br
	16	.B running a DNS server
	17	(http://cr.yp.to/djbdns/run-server.html).
	18
	19	Normally
	20	.B tinydns
	21	is set up by the
	22	.BR tinydns-conf (8)
	23	program.
	24
	25	.B tinydns
	26	runs chrooted in the directory
	27	specified by the
	28	.I $ROOT
	29	environment variable,
	30	under the uid and gid
	31	specified by the
	32	.I $UID
	33	and
	34	.I $GID
	35	environment variables.
	36
	37	.B tinydns
	38	listens for incoming UDP packets
	39	addressed to port 53 of
	40	.IR $IP .
	41	It does not listen for TCP queries.
	42
	43	.B tinydns
	44	answers queries
	45	as specified by
	46	.IR data.cdb ,
	47	a binary file created by
	48	.BR tinydns-data (8).
	49
	50	.SH Further details
	51
	52	.B tinydns
	53	rejects
	54	zone-transfer requests,
	55	inverse queries, non-Internet-class queries, truncated packets, and
	56	packets that contain anything other than a single query.
	57
	58	.BR tinydns ,
	59	like BIND,
	60	includes NS records with answers to most queries.
	61	This increases DNS packet sizes,
	62	but it draws queries away from parent servers,
	63	and reduces the frequency of long DNS delays.
	64	With the default
65	.BR tinydns-data (8)
66	cache times,
67	a client that uses a normal record at least once every day
68	will always have the corresponding NS records cached
69	and will never have to talk to parent servers.
70
71	.SH SEE ALSO
72	tinydns-conf(8),
73	tinydns-data(8)
74
75	http://cr.yp.to/djbdns.html