Yet another fix of blackhole zones

[nsc-5.git] / README

diff --git a/README b/README
index 47393e279d1e83ee5e323d67799c3cb5a9be52f8..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;
 ')


@@ -230,6 +243,18 @@ ALIAS(alias...)
                Generates a series of CNAME records pointing from the aliases
                to the current host/domain.
 
                Generates a series of CNAME records pointing from the aliases
                to the current host/domain.
 

+TXT(text)
+               Specify a TXT record for the current host or domain.
+
+RP(mail, txt)
+               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".
 
 CNAME(src, dest)
                Generate a CNAME record -- "src" points to "dest".