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

.TH axfrdns-conf 8

.SH NAME
axfrdns-conf \- sets up a DNS zone-transfer service.

.SH SYNOPSIS
.B axfrdns-conf 
.I acct
.I logacct
.I D
.I tiny
.I ip

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

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 axfrdns-conf
arranges for
.BR tcpserver (1)
to listen for TCP connections on port 53 of
.IR ip .
It sets up
.IR D /tcp
in
.BR tcprules (1)
format
to control access to
.BR axfrdns (8);
initially all access is denied.
It also sets up
.IR D /Makefile
to compile
.I tcp
into
.I tcp.cdb
for
.BR tcpserver (1).

.B axfrdns-conf
arranges for
.BR axfrdns (8)
to chroot to
.IR tiny /root
and to run under the uid and gid of
.IR acct .
The name
.I tiny
must start with a slash
and must not contain any special characters;
normally it is
.IR /etc/tinydns .
The name
.I acct
must not contain any special characters.

.B axfrdns-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
axfrdns(8),
svscan(8),
svc(8),
multilog(8),
dnscache-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 axfrdns-conf 8
	2
	3	.SH NAME
	4	axfrdns-conf \- sets up a DNS zone-transfer service.
	5
	6	.SH SYNOPSIS
	7	.B axfrdns-conf
	8	.I acct
	9	.I logacct
	10	.I D
	11	.I tiny
	12	.I ip
	13
	14	.SH DESCRIPTION
	15	.B axfrdns-conf
	16	creates a service directory
	17	.I D
	18	that runs
	19	.BR axfrdns (8)
	20	under
	21	.BR tcpserver (1).
	22	The name
	23	.I D
	24	must start with a slash
	25	and must not contain any special characters.
	26	Normally
	27	.I D
	28	is
	29	.IR /etc/axfrdns .
	30
	31	You can run the service under
	32	.BR svscan (8)
	33	by using the
	34	.BR update-service (8)
	35	program on Debian GNU/Linux
	36
	37	update-service --add
	38	.I D
	39
	40	or by creating a symbolic link in the
	41	.BR svscan (8)
	42	directory (normally /service or /etc/service), e.g.:
	43
	44	ln -s
	45	.I D
	46	/service
	47
	48	The service will start within five seconds,
	49	and will be restarted upon reboot.
	50	You can use
	51	.BR svc (8)
	52	to control the service.
	53
	54	.B axfrdns-conf
	55	arranges for
	56	.BR tcpserver (1)
	57	to listen for TCP connections on port 53 of
	58	.IR ip .
	59	It sets up
	60	.IR D /tcp
	61	in
	62	.BR tcprules (1)
	63	format
	64	to control access to
65	.BR axfrdns (8);
66	initially all access is denied.
67	It also sets up
68	.IR D /Makefile
69	to compile
70	.I tcp
71	into
72	.I tcp.cdb
73	for
74	.BR tcpserver (1).
75
76	.B axfrdns-conf
77	arranges for
78	.BR axfrdns (8)
79	to chroot to
80	.IR tiny /root
81	and to run under the uid and gid of
82	.IR acct .
83	The name
84	.I tiny
85	must start with a slash
86	and must not contain any special characters;
87	normally it is
88	.IR /etc/tinydns .
89	The name
90	.I acct
91	must not contain any special characters.
92
93	.B axfrdns-conf
94	creates an automatically rotated log directory in
95	.IR D /log/main.
96	The logs are owned by
97	.IR logacct .
98	The corresponding
99	.BR multilog (8)
100	processes run under the uid and gid of
101	.IR logacct .
102	The name
103	.I logacct
104	must not contain any special characters.
105
106	.SH SEE ALSO
107	axfrdns(8),
108	svscan(8),
109	svc(8),
110	multilog(8),
111	dnscache-conf(8),
112	rbldns-conf(8),
113	tinydns-conf(8),
114	walldns-conf(8),
115	update-service(8)
116
117	http://cr.yp.to/djbdns.html