Blackhole zones should not contain localhost

[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>
 
 
                    (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.
 
                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.
 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.
 
                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;
 ')
 ZONE_OPTIONS(`options;
        more options;
 ')


@@ -231,14 +244,17 @@ ALIAS(alias...)
                to the current host/domain.
 
 TXT(text)
                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)
 
 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.
 
                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".
 
 CNAME(src, dest)
                Generate a CNAME record -- "src" points to "dest".