Imported Debian patch 1:1.05-8

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

diff --git a/debian/djbdns-man/tinydns-conf.8 b/debian/djbdns-man/tinydns-conf.8
new file mode 100644 (file)
index 0000000..9feebee
--- /dev/null
+++ b/debian/djbdns-man/tinydns-conf.8
@@ -0,0 +1,107 @@
+.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