Added BLACKHOLE macro

[nsc-5.git] / README

diff --git a/README b/README
index aaaac15e0cf7feaf753c8e298090fe91dd72e63f..776108e27e072117b7cbadd9f2c82edf486800f7 100644 (file)
--- a/README
+++ b/README
@@ -1,5 +1,5 @@
 
-           Domain Name Server Configuration Utilities -- NSC 3.0.2
+            Domain Name Server Configuration Utilities -- NSC 3.1
 
                    (c) 1997--2008 Martin Mares <mj@ucw.cz>
 
@@ -109,6 +109,9 @@ PRIMARY(zone, [extra-files...])
                concatenated to produce a single configuration). See the next
                section for a look inside these files.
 
+               When the zone name contains a slash (as happens in classless
+               reverse zones), it is replaced by "@" in the cf file name.
+
 SECONDARY(zone, primary)
                Define a zone we run a secondary name server for.
                "primary" is an IP address of the primary name server.
@@ -136,6 +139,16 @@ REVERSE(network, primary-files...)
                You can also use the REV macro explicitly, which can be handy
                for example in SECONDARY declarations.
 
+FORWARDED(zone, ip...)
+               Define a forwarding zone. All queries are forwarded to the
+               specified name servers.
+
+BLACKHOLE(zone)
+               Define an empty zone according to RFC 6303. This is usually done
+               for zones for which clients are known to erroneously ask queries
+               (e.g., reverse resolving of link-local addresses). The contents
+               served for these zones is taken from cf/blackhole.
+
 ZONE_OPTIONS(`options;
        more options;
 ')
@@ -231,14 +244,17 @@ ALIAS(alias...)
                to the current host/domain.
 
 TXT(text)
-               Generate a TXT record for the current host or domain.
+               Specify a TXT record for the current host or domain.
 
 RP(mail, txt)
-               Generate a RP (responsible person) record for the current host or domain.
+               Specify a RP (responsible person) record for the current host or domain.
                The first argument is a mail address in DNS notation (with `@' replaced
                by `.' as in the SOA record), the second one is a name of a TXT record
                with contact information.
 
+SRV(service, protocol, priority, weight, port, target)
+               Specify a SRV (service) record for the current host or domain.
+
 CNAME(src, dest)
                Generate a CNAME record -- "src" points to "dest".