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

.TH tinydns-conf 8

.SH NAME
tinydns-conf \- sets up a DNS publication service.

.SH SYNOPSIS
.B tinydns-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 running a DNS server
(http://cr.yp.to/djbdns/run-server.html).

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

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 tinydns-conf
arranges for 
.BR tinydns (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 tinydns-conf
creates
.IR D /root/Makefile
to run 
.BR tinydns-data (8)
upon request.

.B tinydns-conf
arranges for 
.BR tinydns (8)
to listen for UDP packets on port 53 of 
.IR ip ,
and to send outgoing packets from
.IR ip .

.B tinydns-conf
creates an automatically rotated log directory in
.IR D /log/main.
The logs are owned by 
.IR logacct .
The corresponding 
.IR 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
tinydns(8),
svscan(8),
svc(8),
multilog(8),
axfrdns-conf(8),
rbldns-conf(8),
dnscache-conf(8),
walldns-conf(8),
update-service(8)

http://cr.yp.to/djbdns.html
Commit	Line	Data
b4588d5c GP	1	.TH tinydns-conf 8
	2
	3	.SH NAME
	4	tinydns-conf \- sets up a DNS publication service.
	5
	6	.SH SYNOPSIS
	7	.B tinydns-conf
	8	.I acct
	9	.I logacct
	10	.I D
	11	.I ip
	12
	13	.SH DESCRIPTION
	14	This is a reference page.
	15	For tutorial information, see the instructions for
	16	.br
	17	.B running a DNS server
	18	(http://cr.yp.to/djbdns/run-server.html).
	19
	20	.B tinydns-conf
	21	creates a service directory
	22	.I D
	23	that runs
	24	.BR tinydns (8).
	25	The name
	26	.I D
	27	must start with a slash
	28	and must not contain any special characters.
	29	Normally
	30	.I D
	31	is
	32	.IR /etc/tinydns .
	33
	34	You can run the service under
	35	.BR svscan (8)
	36	by using the
	37	.BR update-service (8)
	38	program on Debian GNU/Linux
	39
	40	update-service --add
	41	.I D
	42
	43	or by creating a symbolic link in the
	44	.BR svscan (8)
	45	directory (normally /service or /etc/service), e.g.:
	46
	47	ln -s
	48	.I D
	49	/service
	50
	51	The service will start within five seconds,
	52	and will be restarted upon reboot.
	53	You can use
	54	.BR svc (8)
	55	to control the service.
	56
	57	.B tinydns-conf
	58	arranges for
	59	.BR tinydns (8)
	60	to chroot to
	61	.IR D /root
	62	and to run under the uid and gid of
	63	.IR acct .
	64	The name
65	.I acct
66	must not contain any special characters.
67
68	.B tinydns-conf
69	creates
70	.IR D /root/Makefile
71	to run
72	.BR tinydns-data (8)
73	upon request.
74
75	.B tinydns-conf
76	arranges for
77	.BR tinydns (8)
78	to listen for UDP packets on port 53 of
79	.IR ip ,
80	and to send outgoing packets from
81	.IR ip .
82
83	.B tinydns-conf
84	creates an automatically rotated log directory in
85	.IR D /log/main.
86	The logs are owned by
87	.IR logacct .
88	The corresponding
89	.IR multilog (8)
90	processes run under the uid and gid of
91	.IR logacct .
92	The name
93	.I logacct
94	must not contain any special characters.
95
96	.SH SEE ALSO
97	tinydns(8),
98	svscan(8),
99	svc(8),
100	multilog(8),
101	axfrdns-conf(8),
102	rbldns-conf(8),
103	dnscache-conf(8),
104	walldns-conf(8),
105	update-service(8)
106
107	http://cr.yp.to/djbdns.html