When zone contents do not change, version number is not incremented

[nsc-5.git] / README

diff --git a/README b/README
index 89496f93b990dc35bbd92d7350f2aab1e6e209f2..6ddfb09bbc6a31cac7b91db147c4b7859a1bff8d 100644 (file)
--- a/README
+++ b/README
@@ -1,7 +1,7 @@
 
 

-            Domain Name Server Configuration Utilities -- NSC 3.0
+            Domain Name Server Configuration Utilities -- NSC 3.1

 
 

-                   (c) 1997--2005 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".
 


@@ -306,20 +331,12 @@ MINTTL
 NSNAME                 Origin server (default: hostname of your machine)
 MAINTNAME              Domain maintainer name (default: root@NSNAME)
 
 NSNAME                 Origin server (default: hostname of your machine)
 MAINTNAME              Domain maintainer name (default: root@NSNAME)
 

-BIND_OPTIONS           Extra options to put to the options { ... } section of named.conf
-

 For the timing parameters, the following shortcuts are available:
 
 HOURS(n)               Convert hours to seconds
 MINUTES(n)             Convert minutes to seconds
 DAYS(n)                        Convert days to seconds
 
 For the timing parameters, the following shortcuts are available:
 
 HOURS(n)               Convert hours to seconds
 MINUTES(n)             Convert minutes to seconds
 DAYS(n)                        Convert days to seconds
 

-For the BIND_OPTIONS, we offer:
-
-FORWARD(ip...)         Try to ask the given name servers first to see if they
-                       have the reply cached.
-SLAVE(ip...)           Pass all non-local requests to the given name servers.
-

 
 5. Makefile targets
 ~~~~~~~~~~~~~~~~~~~
 
 5. Makefile targets
 ~~~~~~~~~~~~~~~~~~~