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

.TH dnscache-conf 8

.SH NAME
dnscache-conf \- sets up a DNS cache service.

.SH SYNOPSIS
.B dnscache-conf 
.I acct
.I logacct
.I D
[
.I ip
]

.SH DESCRIPTION
This is a reference page.
For tutorial information, see the instructions for
.br
.B workstations
(http://cr.yp.to/djbdns/run-cache.html),
.br
.B home computers
(http://cr.yp.to/djbdns/run-cache-home.html),
.br
.B external caches
(http://cr.yp.to/djbdns/run-cache-x.html),
or
.br
.B upgrading from BIND
(http://cr.yp.to/djbdns/run-cache-bind-1.html).

.B dnscache-conf
creates a service directory 
.I D
that runs
.BR dnscache (8).
The name 
.I D
must start with a slash
and must not contain any special characters.
Normally 
.I D
is 
.IR /etc/dnscache .

You can run the service under
.BR svscan (8)
by using the
.BR update-service (8)
program on Debian GNU/Linux

update-service --add
.I D

or by creating a symbolic link in the
.BR svscan (8)
directory (normally /service or /etc/service), e.g.:

ln -s 
.I D
/service

The service will start within five seconds,
and will be restarted upon reboot.
You can use
.BR svc (8)
to control the service.

.B dnscache-conf
arranges for 
.BR dnscache (8)
to chroot to 
.IR D /root
and to run under the uid and gid of 
.IR acct .
The name
.I acct
must not contain any special characters.

.B dnscache-conf
arranges for 
.BR dnscache (8)
to listen for UDP packets and TCP connections on port 53 of 
.IR ip .

.I ip
is optional;
if it is not supplied,
.B dnscache-conf
arranges for 
.BR dnscache (8)
to listen on 127.0.0.1.

.B dnscache-conf
creates 
.IR D /root/ip/127.0.0.1
so that 
.BR dnscache (8)
will accept queries from 127.0.0.1.

.B dnscache-conf
puts 128 bytes of not-particularly-secret data
into 
.IR D /seed
and arranges for 
.BR dnscache (8)
to pass 
.IR D /seed
to 
.BR dns_random_init (3).
If your system has a good source of random data,
you can replace 
.IR D /seed
with 128 bytes of data from that source.

.B dnscache-conf
creates an automatically rotated log directory in
.IR D /log/main.
The logs are owned by 
.IR logacct .
The corresponding 
.BR multilog (8)
processes run under the uid and gid of 
.IR logacct .
The name 
.I logacct
must not contain any special characters.

.SH SEE ALSO
dnscache(8),
svscan(8),
svc(8),
multilog(8),
axfrdns-conf(8),
rbldns-conf(8),
tinydns-conf(8),
walldns-conf(8),
update-service(8)

http://cr.yp.to/djbdns.html
Commit	Line	Data
b4588d5c GP	1	.TH dnscache-conf 8
	2
	3	.SH NAME
	4	dnscache-conf \- sets up a DNS cache service.
	5
	6	.SH SYNOPSIS
	7	.B dnscache-conf
	8	.I acct
	9	.I logacct
	10	.I D
	11	[
	12	.I ip
	13	]
	14
	15	.SH DESCRIPTION
	16	This is a reference page.
	17	For tutorial information, see the instructions for
	18	.br
	19	.B workstations
	20	(http://cr.yp.to/djbdns/run-cache.html),
	21	.br
	22	.B home computers
	23	(http://cr.yp.to/djbdns/run-cache-home.html),
	24	.br
	25	.B external caches
	26	(http://cr.yp.to/djbdns/run-cache-x.html),
	27	or
	28	.br
	29	.B upgrading from BIND
	30	(http://cr.yp.to/djbdns/run-cache-bind-1.html).
	31
	32	.B dnscache-conf
	33	creates a service directory
	34	.I D
	35	that runs
	36	.BR dnscache (8).
	37	The name
	38	.I D
	39	must start with a slash
	40	and must not contain any special characters.
	41	Normally
	42	.I D
	43	is
	44	.IR /etc/dnscache .
	45
	46	You can run the service under
	47	.BR svscan (8)
	48	by using the
	49	.BR update-service (8)
	50	program on Debian GNU/Linux
	51
	52	update-service --add
	53	.I D
	54
	55	or by creating a symbolic link in the
	56	.BR svscan (8)
	57	directory (normally /service or /etc/service), e.g.:
	58
	59	ln -s
	60	.I D
	61	/service
	62
	63	The service will start within five seconds,
	64	and will be restarted upon reboot.
65	You can use
66	.BR svc (8)
67	to control the service.
68
69	.B dnscache-conf
70	arranges for
71	.BR dnscache (8)
72	to chroot to
73	.IR D /root
74	and to run under the uid and gid of
75	.IR acct .
76	The name
77	.I acct
78	must not contain any special characters.
79
80	.B dnscache-conf
81	arranges for
82	.BR dnscache (8)
83	to listen for UDP packets and TCP connections on port 53 of
84	.IR ip .
85
86	.I ip
87	is optional;
88	if it is not supplied,
89	.B dnscache-conf
90	arranges for
91	.BR dnscache (8)
92	to listen on 127.0.0.1.
93
94	.B dnscache-conf
95	creates
96	.IR D /root/ip/127.0.0.1
97	so that
98	.BR dnscache (8)
99	will accept queries from 127.0.0.1.
100
101	.B dnscache-conf
102	puts 128 bytes of not-particularly-secret data
103	into
104	.IR D /seed
105	and arranges for
106	.BR dnscache (8)
107	to pass
108	.IR D /seed
109	to
110	.BR dns_random_init (3).
111	If your system has a good source of random data,
112	you can replace
113	.IR D /seed
114	with 128 bytes of data from that source.
115
116	.B dnscache-conf
117	creates an automatically rotated log directory in
118	.IR D /log/main.
119	The logs are owned by
120	.IR logacct .
121	The corresponding
122	.BR multilog (8)
123	processes run under the uid and gid of
124	.IR logacct .
125	The name
126	.I logacct
127	must not contain any special characters.
128
129	.SH SEE ALSO
130	dnscache(8),
131	svscan(8),
132	svc(8),
133	multilog(8),
134	axfrdns-conf(8),
135	rbldns-conf(8),
136	tinydns-conf(8),
137	walldns-conf(8),
138	update-service(8)
139
140	http://cr.yp.to/djbdns.html