X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;ds=sidebyside;f=README;h=e79fab060353e1e56408145ec31677f4ccc513a5;hb=HEAD;hp=57379a16960ace7077c20d19a769c017b9f5222f;hpb=bc67ca425528a7f2cb3563f343a9aacbfdcd3c0a;p=nsc-5.git diff --git a/README b/README index 57379a1..e79fab0 100644 --- a/README +++ b/README @@ -1,7 +1,7 @@ - Domain Name Server Configuration Utilities -- NSC 5.0 + Domain Name Server Configuration Utilities -- NSC 5.1 - (c) 1997--2019 Martin Mares + (c) 1997--2023 Martin Mares ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -67,9 +67,8 @@ An interesting companion to this package is the DNS Sleuth -- a DNS zone consistency checker. It's a simple utility written in Perl with help of the DNS module and it should be able to detect all common errors in DNS setup (I have written it after much disappointment with the other checkers). -The Sleuth is available online on http://atrey.karlin.mff.cuni.cz/~mj/sleuth/, -follow the links to download the source. However, I haven't updated Sleuth -for a long time, so it does not know about DNSSEC yet. +The Sleuth is available from http://mj.ucw.cz/sw/sleuth/. However, I haven't +updated Sleuth for a long time, so it does not know about DNSSEC yet. 1. Directory structure @@ -109,7 +108,7 @@ files and subdirectories: ~~~~~~~~~~~~~~~~~~~~~~~ The domain list contains configuration commands describing all domains handled by your server and their parameters. In fact, it's a M4 script, but viewing it as -a config file is a good approximation (however, see Section 8 for some caveats). +a config file is a good approximation (however, see Section 9 for some caveats). Lines starting with a semicolon are treated as comments and ignored. Text outside declarations is silently ignored. @@ -152,7 +151,7 @@ REVERSE(network, primary-files...) You can also use the REV macro explicitly, which can be handy for example in SECONDARY declarations. -FORWARDED(zone, ip...) +FORWARDING(zone, ip...) Define a forwarding zone. All queries are forwarded to the specified name servers. @@ -195,9 +194,8 @@ output with your own records. All host or domain names are either names relative to the current domain with no dots inside or absolute names (in this case, NSC automatically -ensures that the trailing dot is present in the resource records). Relative -names with dots are not supported, but they are rare and you can always write -them as absolute anyway. +ensures that the trailing dot is present in the resource records). If you +really need a relative name with dots, escape all dots as "\.". Your menu: @@ -219,7 +217,8 @@ SOA(domain-name) H(host) Start declaration of a host. Doesn't generate anything, only - remembers the host's name. + remembers the host's name. If you want to amend records for the + current domain, use "H(@)" or "D(@)". ADDR(addr...) Specify addresses for the current host. In the normal mode, it @@ -292,6 +291,9 @@ PTR(src, dest) to have your PTR's generated by the REVERSE directive. But if you need anything special, here is the tool. +CAA(text) + Specify a CAA record for the current host or domain. + REVBLOCK(subdomain, min, max) Generate a series of CNAME records numbered from `min' to `max' and pointing to the same name in the given sub-domain, finally @@ -546,8 +548,8 @@ However, there is a couple of things you need to care about: o Don't use commas, quotes nor parentheses in your record names. -9. Other utilities -~~~~~~~~~~~~~~~~~~ +10. Other utilities +~~~~~~~~~~~~~~~~~~~ convert A simple Perl script for conversion of zone files to NSC domain files. Requires the Net::DNS module (available from CPAN at ftp.cpan.org; present in recent versions of Perl).