Imported Debian patch 1:1.05-8

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

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