Imported Debian patch 1:1.05-8
[hcoop/zz_old/debian/djbdns.git] / debian / djbdns-man / walldns-conf.8
diff --git a/debian/djbdns-man/walldns-conf.8 b/debian/djbdns-man/walldns-conf.8
new file mode 100644 (file)
index 0000000..331a215
--- /dev/null
@@ -0,0 +1,94 @@
+.TH walldns-conf 8
+
+.SH NAME
+walldns-conf \- sets up a DNS wall service.
+
+.SH SYNOPSIS
+walldns-conf 
+.I acct
+.I logacct
+.I D
+.I ip
+
+.SH DESCRIPTION
+.B walldns-conf
+creates a service directory 
+.I D
+that runs
+.BR walldns (8).
+The name 
+.I D
+must start with a slash
+and must not contain any special characters.
+Normally 
+.I D
+is 
+.IR /etc/walldns .
+
+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 walldns-conf
+arranges for 
+.I walldns
+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 walldns-conf
+arranges for 
+.BR walldns (8)
+to listen for UDP packets on port 53 of 
+.IR ip ,
+and to send outgoing packets from
+.IR ip .
+
+.B walldns-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
+walldns(8),
+svscan(8),
+svc(8),
+multilog(8),
+axfrdns-conf(8),
+rbldns-conf(8),
+tinydns-conf(8),
+dnscache-conf(8),
+update-service(8)
+
+http://cr.yp.to/djbdns.html