wm: doc

Download patch

ref: 557a546e9b44cb160f2d1d634a7049f791d801a0
parent: db7ee8703cf1458c4a6651bddc9fd7fea4c87586
author: Aaron Lin <jrmu@inter9.org>
date: Wed Oct 16 01:34:45 EDT 2024 

Add notes about -rR flags for ndb/dns, minor format updates


--- a/ndb-p9.ms
+++ b/ndb-p9.ms
@@ -1,9 +1,14 @@
 .PP
 To run an authoritative DNS server, modify /cfg/$sysname/termrc or /cfg/$sysname/cpurc (whichever is appropriate) to include the following: 
 .P1
-ndb/dns -s
+ndb/dns -srR
 .P2
+
 .PP
+The flag -s allows the DNS server to answer requests sent to UDP port 53.
+-r allows ndb/dns to act as a resolver; -R causes ndb/dns to ignore
+recursive lookups on behalf of remote systems.
+.PP
 Note: You *must* run ip/ipconfig before running ndb/dns (and possibly other
 network services). Otherwise, you might see errors like:
 
@@ -14,7 +19,9 @@
 .PP
 You will want to add your records to /lib/ndb/local, similar to the following:
 
-sys=example.com ether=f2b2b3daeb89 ip=198.51.100.2 ipmask=255.255.255.0 ipgw=198.51.100.1
+sys=example dom=example.com
+	ether=f2b2b3daeb89
+	ip=198.51.100.2 ipmask=255.255.255.0 ipgw=198.51.100.1
 	ntp=pool.ntp.org
 	dns=198.51.100.1
 	auth=198.51.100.1
@@ -42,10 +49,10 @@
 	ns=ns1.example.com
 	ns=ns2.example.com
 
-
+.PP
 Replace 198.51.100.1, 198.51.100.2, example.com, and postmaster@example.com with your actual values.
 
-NOTE: ndb is extremely sensitive to poorly formatted whitespace! If ndb is not recognizing your tuples properly, double check your whitespace.
+NOTE: ndb may be sensitive to poorly formatted whitespace. If ndb is not recognizing your tuples properly, double check your whitespace.
 
 To refresh cs and dns after an update to /lib/ndb/local:
 
@@ -58,14 +65,17 @@
 
 In example.com, you need to have something like this in /lib/ndb/local:
 
+.P1
 dom=subdomain.example.com soa=delegated
     ns=ns1.subdomain.example.com
     ns=ns2.subdomain.example.com
     dom=ns1.subdomain.example.com ip=198.51.100.3
     dom=ns2.subdomain.example.com ip=198.51.100.4
+.P2
 
 Then, in subdomain.example.com, add this to /lib/ndb/local:
 
+.P1
 sys=ns1 dom=ns1.subdomain.example.com ip=198.51.100.3
 sys=ns2 dom=ns2.subdomain.example.com ip=198.51.100.4
 
@@ -83,3 +93,4 @@
    refresh=300 ttl=300
    ns=ns1.subdomain.example.com
    ns=ns2.subdomain.example.com
+.P2