chiark / gitweb /
506b5b16358d70add6132533524881bde082bb39
[chiark-utils.git] / scripts / named-conf
1 #!/usr/bin/perl -w
2
3 use strict;
4 use IO::File;
5 use Data::Dumper;
6
7 use vars qw($quis
8             $mode $doall
9             $etcfile $where
10             $debug $needglue $localonly $verbosity);
11
12 $quis= $0; $quis =~ s,.*/,,;
13
14 $mode= '';
15 $doall= 0;
16 $etcfile= "/etc/bind/chiark-conf-gen.zones";
17 $where= '<built-in>';
18 $debug= 0;
19 $needglue= 2;
20 $localonly= 0;
21 $verbosity= 1;
22
23 use vars qw($dig_owner $dig_type $dig_rdata);
24
25 while (@ARGV && $ARGV[0] =~ m/^\-/) {
26     $_= shift @ARGV;
27     if (s/^\-\-//) {
28         last if m/^$/;
29         if (m/^(yes|no|force)$/) { m/^./; $mode= $&; }
30         elsif (m/^all$/) { $doall=1; }
31         elsif (m/^config$/) { $etcfile= loarg(); $where= '--config option'; }
32         elsif (m/^glueless$/) { $needglue--; }
33         elsif (m/^localonly$/) { $localonly=1; }
34         elsif (m/^quiet$/) { $verbosity=0; }
35         elsif (m/^verbose$/) { $verbosity=2; }
36         else { usageerr("unknown option --$_"); }
37     } else {
38         s/^\-//;
39         last if m/^$/;
40         while (m/^./) {
41             if (s/^[ynf]//) { $mode=$&; }
42             elsif (s/^A//) { $doall=1; }
43             elsif (s/^C//) { $etcfile= soarg(); $where= '-C option'; }
44             elsif (s/^D//) { $debug++; }
45             elsif (s/^g//) { $needglue--; }
46             elsif (s/^l//) { $localonly=1; }
47             elsif (s/^q//) { $verbosity=0; }
48             elsif (s/^v//) { $verbosity=2; }
49             else { usageerr("unknown option -$&"); }
50         }
51     }
52 }
53
54 sub loarg() { usageerr("missing option value") if !@ARGV; return shift @ARGV; }
55 sub soarg() { my ($rv); $rv=$_; $_=''; return length $rv ? $rv : loarg(); }
56
57 usageerr("-g may be specified at most twice") if $needglue<0;
58 usageerr("-D may be specified at most twice") if $debug>2;
59 usageerr("must specify either -f|-y|-n or zones (and not both)")
60     if !!$mode == !!@ARGV;
61
62 sub usageerr ($) {
63     die
64 "$_[0]
65 usage: named-conf-regen [-rvq] -f|-y|-n|<zone>...\n".
66 "operation modes:\n".
67 " -f --force   install without checking\n".
68 " -y --yes     check and install\n".
69 " -n --no      check only\n".
70 "additional options:\n".
71 " -q --quiet   no output for OK zones\n".
72 " -v --verbose extra verbose\n";
73 }
74
75 cfg_fail("config filename $etcfile should have been absolute path of a file")
76     unless $etcfile =~ m,^/, && $etcfile !~ m,/$,;
77
78 use vars qw($default_dir);
79 $default_dir= $etcfile;
80 $default_dir =~ s,/[^/]+$,,;
81
82 use vars qw($slave_dir $slave_prefix $slave_suffix);
83 $slave_dir= 'slave';
84 $slave_prefix= '';
85 $slave_suffix= '';
86
87 use vars qw(@self_ns @self_soa @self_addr);
88 @self_ns= @self_soa= @self_addr= ();
89
90 use vars qw(%zone_cfg @zone_cfg_list);
91 %zone_cfg= ();
92 @zone_cfg_list= ();
93
94 use vars qw($output $default_output %output_contents);
95 $output= '';
96 $default_output= '';
97 %output_contents= ();
98
99 use vars qw($check $install);
100 $check= $mode !~ m/^f/;
101 $install= $mode =~ m/^[yf]/;
102
103 read_config($etcfile);
104 debug_dump('@zone_cfg_list %zone_cfg');
105 process_zones($mode ? @zone_cfg_list : @ARGV);
106 debug_dump('%output_contents');
107
108 exit 0;
109
110 #-------------------- configuration reading
111
112 sub cfg_fail ($) { die "$quis: $where:\n $_[0]\n"; }
113
114 sub read_config ($) {
115     my ($if) = @_;
116     my ($fh,$z,@self, $mod,$dir,$prefix,$suffix,$lprefix,$lsuffix);
117     local ($_);
118
119     $fh= new IO::File $if,'r' or cfg_fail("open $if:\n $!");
120     for (;;) {
121         if (!defined($_= <$fh>)) {
122             cfg_fail("read config file $if:\n $!") if $fh->error();
123             last;
124         }
125         $where= "$if:$.";
126         s/^\s+//; chomp; s/\s+$//;
127         next if m/^\#/;
128         last if m/^end$/;
129         next unless m/\S/;
130         if (m/^self(\-ns|\-soa|)\s+(\S.*\S)/) {
131             @self= split /\s+/, $2;
132             @self_ns= @self if $1 ne '-soa';
133             @self_soa= @self if $1 ne '-ns';
134         } elsif (m/^self\-addr\s+([0-9. \t]+)/) {
135             @self_addr= split /\s+/, $1;
136         } elsif (m/^primary\-dir([*?]?)\s+(\S+)((?:\s+(\S+))?:\s+(\S+))?$/) {
137             ($mod, $dir, $prefix, $suffix) = ($1,qualify($2),$3,$4);
138             $suffix= '_db' if !defined $suffix;
139             $prefix= '' if !defined $prefix;
140             opendir D, $dir or cfg_fail("open primary-dir $dir:\n $!");
141             $lprefix= length $prefix; $lsuffix= length $suffix;
142             while (defined($_= readdir D)) {
143                 next if m/^\./ && !$lprefix;
144                 next unless length > $lprefix+$lsuffix;
145                 next unless substr($_,0,$lprefix) eq $prefix;
146                 next unless substr($_,length($_)-$lsuffix) eq $suffix;
147                 $z= substr($_,$lprefix,length($_)-($lprefix+$lsuffix));
148                 zone_conf($z,'primary','p',$mod,"$dir/$_");
149             }
150             closedir D or cfg_fail("close primary-dir $dir:\n $!");
151         } elsif (m/^primary([*?]?)\s+(\S+)\s+(\S+)$/) {
152             zone_conf($2,'primary','p',$1,qualify($3));
153         } elsif (m/^published([*?]?)\s+(\S+)\s+([0-9.\t]+)$/) {
154             zone_conf($2,'published','s',$1,'',$3);
155         } elsif (m/^stealth([*?]?)\s+(\S+)\s+([0-9. \t]+)$/) {
156             zone_conf($2,'stealth','u',$1,'',split /\s+/, $3);
157         } elsif (m/^slave\-dir\s+(\S+)((?:\s+(\S+))?:\s+(\S+))?$/) {
158             ($slave_dir, $slave_prefix, $slave_suffix) = (qualify($1),$2,$3);
159         } elsif (m/^output\s+bind8\+(\S+)$/) {
160             cfg_fail("default output may not apply to only some zones")
161                 if @zone_cfg_list && length $default_output;
162             set_output(qualify($1));
163         } elsif (m/^include\s+(\S+)$/) {
164             read_config($1);
165         } else {
166             cfg_fail("unknown configuration directive".
167                      " or incorrect syntax or arguments");
168         }
169     }
170     $fh->close or cfg_fail("close config file $if:\n $!");
171 }
172
173 sub qualify ($) {
174     my ($i) = @_;
175     $i= "$default_dir/$i" unless $i =~ m,^/,;
176     return $i;
177 }
178
179 sub zone_conf ($$$$$@) {
180     my ($zone,$style,$sabbr,$mod,$file,@servers) = @_;
181     my ($sfx,$aref);
182     $file= qualify("$slave_dir/$slave_prefix".$zone.$slave_suffix)
183         unless length $file;
184     if (!length $output) {
185         $default_output= qualify('chiark-conf-gen.bind8')
186             unless length $default_output;
187         set_output($default_output);
188     }
189     cfg_fail("redefined zone $zone") if exists $zone_cfg{$zone};
190     $zone_cfg{$zone}{'file'}= $file;
191     $zone_cfg{$zone}{'style_p'}= $style.$mod;
192     $zone_cfg{$zone}{'s'}= $sabbr.$mod; # p)rimary s)econdary u)npub f)oreign
193     $zone_cfg{$zone}{'servers'}= [ @servers ];
194     foreach $sfx (qw(soa ns addr)) {
195         $aref= [ @{ "self_$sfx" } ];
196         @$aref or cfg_fail("failed to specify self-$sfx before zone");
197         $zone_cfg{$zone}{'self_soa'}= $aref;
198     }
199     $zone_cfg{$zone}{'output'}= $output;
200     push @zone_cfg_list, $zone;
201 }
202
203 sub set_output($) {
204     my ($newout) = @_;
205     $output= $newout;
206     $output_contents{$output}= '';
207 }
208
209
210 #-------------------- checking
211
212 use vars qw($zone $cfg $warnings);
213 $warnings= 0;
214
215 sub progress ($) {
216     return if !$verbosity;
217     print "$_[0]\n";
218 }
219
220 sub verbose ($) {
221     return if $verbosity<2;
222     print "    $_[0]\n";
223 }
224
225 sub process_zones (@) {
226     my (@zones) = @_;
227     local ($zone,$cfg);
228
229     foreach $zone (@zones) {
230         $cfg= $zone_cfg{$zone} || {
231             'style_p' => 'foreign',
232             's' => 'f',
233             'servers' => [ ],
234             };
235         progress(sprintf "%-40s %s", $zone, $$cfg{'style_p'});
236         if ($check && ($doall || $cfg->{'s'} !~ m/\?/)) {
237             eval {
238                 if ($localonly && $cfg->{'s'} =~ m/f/) {
239                     zone_warning("foreign zone specified with -l");
240                 } elsif ($cfg->{'s'} =~ m/\*/ ||
241                          ($localonly && $cfg->{'s'} !~ m/p/)) {
242                     zone_check_local();
243                 } else {
244                     zone_check_full();
245                 }
246             };
247             zone_warning("checks failed: $@") if length $@;
248         }
249         zone_output() if $install;
250     }
251     print STDERR "$quis: $warnings warnings\n" or die $!
252         if $warnings;
253 }
254
255 sub zone_warning ($) {
256     my ($w) = @_;
257     $w =~ s/\n$//;
258     $w =~ s,\n, // ,g;
259     print STDERR "$zone: warning: $w\n" or die $!;
260     $warnings++;
261 }
262
263 sub zone_warnmore ($) {
264     print STDERR " $_[0]\n" or die $!;
265 }
266
267 use vars qw(%delgs); # $delgs{$nameserver_list} = [ $whosaidandwhy ]
268 use vars qw(%auths); # $auths{$nameserver_list} = [ $whosaidandwhy ]
269 use vars qw(%glue);  # $glue{$name}{$addr_list} = [ $whosaidandwhy ]
270 use vars qw(%soas);  # $soa{"$origin $serial"} = [ $whosaidandwhy ]
271 use vars qw(%addr_is_ok %gluelesswarned);
272 use vars qw(@to_check); # ($addr,$whyask,$is_auth,$glueless_ok, ...)
273 use vars qw(@to_check_soa); # ($addr,$whyask, ...)
274
275 sub zone_check_full () {
276     zone_reset();
277     zone_investigate();
278     zone_consistency();
279     zone_servers_ok();
280 }
281
282 sub zone_reset() {
283     %delgs= %auths= %glue= %soas= %gluelesswarned= %addr_is_ok= ();
284     @to_check= @to_check_soa= ();
285 }
286
287 sub zone_investigate() {
288     my ($super_zone, @super_nsnames,
289         $super_ns, @super_ns_addrs, $s, $wa, $is_auth,
290         %nsrrset_checked, %soa_checked, $addr, $glueless_ok, $rcode);
291
292     $super_zone= $zone;
293     for (;;) {
294         debug_trace("zone $zone superzone $super_zone");
295         $super_zone =~ s/^[^.]+\.// or die "no superzone ? ($super_zone)\n";
296         ($rcode,@super_nsnames)= lookup($super_zone,'ns-','06');
297         last if !$rcode;
298     }
299     for $super_ns (@super_nsnames) {
300         $super_ns= lc $super_ns;
301         ($rcode,@super_ns_addrs)= lookup($super_ns,'a','0');
302         foreach $addr (@super_ns_addrs) {
303             push @to_check,
304                  $addr,
305                  "$super_ns, server for $super_zone",
306                  0, 0;
307         }
308     }
309     for (;;) {
310         # We do these in order so that we always do NS RRset checks on
311         # nameservers that came from other NS RRsets first; otherwise
312         # we might set nsrrset_checked due to a glueless_ok check,
313         # and then not check for gluefulness later.
314         debug_dump('@to_check @to_check_soa');
315         if (($addr,$wa,$is_auth,$glueless_ok,@to_check) = @to_check) {
316             push @to_check_soa, $addr, $wa if $is_auth;
317             next if $nsrrset_checked{$addr}++;
318             zone_check_nsrrset($addr, "[$addr] $wa",
319                                $is_auth, $glueless_ok);
320         } elsif (($addr,$wa,@to_check_soa) = @to_check_soa) {
321             next if $soa_checked{$addr}++;
322             zone_check_soa($addr,"[$addr] $wa");
323         } else {
324             last;
325         }
326     }
327 }
328
329 sub zone_check_nsrrset ($$$$) {
330     my ($uaddr,$ww, $is_auth, $glueless_ok) = @_;
331     my (@s, $s, %s2g, @glue, $glue, $delgs_or_auths);
332     verbose("checking delegation by $ww");
333     dig(sub {
334         if ($dig_type eq 'ns' && $dig_owner eq $zone) {
335             $s2g{lc $dig_rdata} = [ ];
336         } elsif ($dig_type eq 'a' && exists $s2g{$dig_owner}) {
337             push @to_check,
338                  $dig_rdata,
339                  "$dig_owner, in glue from $ww",
340                  1, 0;
341             zone_server_addr($dig_rdata,$dig_owner,"NS [$uaddr]",0);
342             push @{ $s2g{$dig_owner} }, $dig_rdata;
343         }
344     },
345              $zone,'ns',$uaddr);
346     if (!%s2g) { zone_warning("unable to find NS RRset at $ww"); return; }
347     elsif (keys %s2g == 1) { zone_warning("only one nameserver at $ww"); }
348     @s= sort keys %s2g;
349     foreach $s (@s) {
350         @glue= @{ $s2g{$s} };
351         if (!@glue) {
352             zone_warning("glueless NS $s,".
353                          ($needglue<=1 ? " (eg)" : "").
354                          " from $ww")
355                 unless $glueless_ok || !$needglue ||
356                        ($needglue<=1 && $gluelesswarned{$s}++);
357             next;
358         }
359         $glue= join ' ', sort @glue;
360         push @{ $glue{$s}{$glue} }, $ww;
361     }
362     $s= join ' ', @s;
363     $delgs_or_auths= $is_auth ? \%auths : \%delgs;
364     push @{ $delgs_or_auths->{$s} }, $ww;
365 }
366
367 sub zone_server_addr ($$$$) {
368     my ($addr,$name,$ww,$is_soa) = @_;
369     $addr_is_ok{$addr}= "$name ($ww)"
370         if $is_soa || $cfg->{'s'} =~ m/u/;
371     zone_warning("configured as stealth but we [$addr]".
372                  " are published ($name $ww)")
373         if $cfg->{'s'} =~ m/u/ && grep { $_ eq $addr } @self_addr;
374
375     my ($name_is_self, $addr_is_self);
376     $name_is_self= grep { $_ eq $name }
377         @{ $cfg->{$is_soa ? 'self_soa' : 'self_ns'} };
378     $addr_is_self= grep { $_ eq $addr }
379         @{ $cfg->{'self_addr'} };
380     if ($name_is_self && !$addr_is_self) {
381         zone_warning("our name $name has wrong address $addr ($ww)");
382     } elsif (!$name_is_self && $addr_is_self) {
383         zone_warning(($is_soa ? "SOA ORIGIN maps to" : "delegated to").
384                      " our address $addr but to wrong".
385                      " name $name ($ww)");
386     }
387 }
388
389 sub zone_check_soa ($$) {
390     my ($uaddr,$ww) = @_;
391     my ($lame,$origin,$got,$rcode,@soa_addrs,$soa_addr);
392     verbose("checking service at $ww");
393     $lame= 'dead or lame';
394     dig(sub {
395         if ($dig_type eq 'flags:') {
396             $lame= $dig_rdata =~ m/ aa / ? '' : 'lame';
397         } elsif ($dig_type eq 'soa' && $dig_owner eq $zone && !$lame) {
398             die "several SOAs ? $ww" if defined $origin;
399             $got= $dig_rdata;
400             $got =~ m/^(\S+) \d+/ or die "$got ?";
401             $origin= $1;
402         }
403     },
404              $zone,'soa',$uaddr);
405     $lame= 'broken' if !$lame && !defined $origin;
406     if ($lame) { zone_warning("$lame server $ww"); return; }
407     push @{ $soas{$got} }, $ww;
408     ($rcode,@soa_addrs)= lookup($origin,'a','0');
409     foreach $soa_addr (@soa_addrs) {
410         zone_server_addr($soa_addr,$origin,"SOA [$uaddr]",1);
411         push @to_check,
412              $soa_addr,
413              "$origin, SOA ORIGIN from $ww";
414     }
415 }
416
417 sub zone_consistency() {
418     my ($d, $org_ser, $origin, $a, $h, $self_soa);
419     zone_consistency_set('delegations',\%delgs);
420     foreach $d (keys %delgs) { delete $auths{$d}; }
421     zone_consistency_set('zone nameserver rrset',\%auths);
422     foreach $h (keys %glue) {
423         zone_consistency_set("glue for $h", $glue{$h});
424     }
425     zone_consistency_set("SOA ORIGIN and SERIAL",\%soas);
426     $self_soa= $cfg->{'self_soa'};
427     if ($cfg->{'s'} =~ m/p/) {
428         foreach $org_ser (keys %soas) {
429             $org_ser =~ m/^(\S+) \d+$/ or die "$org_ser ?";
430             $origin= $1;
431             next if grep { $_ eq $origin } @$self_soa;
432             zone_warning("our name (@$self_soa) not in SOA ORIGIN $origin,".
433                          " eg from ".((values %{ $soas{$org_ser} })[1]));
434         }
435     }
436 }
437
438 sub zone_servers_ok () {
439     my ($showok);
440     if (%addr_is_ok) {
441         $showok= 0;
442         foreach $a (@{ $cfg->{'servers'} }) {
443             next if exists $addr_is_ok{$a};
444             zone_warning("we slave from $a"); $showok=1;
445         }
446         if ($showok) {
447             foreach $a (keys %addr_is_ok) {
448                 zone_warnmore("permitted master [$a] $addr_is_ok{$a}");
449             }
450         }
451     }
452 }
453
454 sub zone_consistency_set ($%) {
455     my ($msg,$set) = @_;
456     my ($d,$o);
457     if (keys(%$set) > 1) {
458         zone_warning("inconsistent $msg:");
459         foreach $d (keys %$set) {
460             foreach $o (@{ $set->{$d} }) { zone_warnmore(" $d from $o"); }
461         }
462     }
463 }
464
465 sub zone_check_local () {
466     zone_reset();
467     zone_servers_simplefind();
468     zone_servers_ok();
469 }
470
471 sub zone_servers_simplefind () {
472     my ($rcode,@nsnames,$ns,@soas,$origin);
473
474     ($rcode,@nsnames)= lookup($zone,'ns-','0');
475     foreach $ns (@nsnames) { zone_server_simple($ns,'NS',0); }
476
477     ($rcode,@soas)= lookup($zone,'soa','0');
478     die "multiple SOA RRs in set!  @soas ?" if @soas!=1;
479     $soas[0] =~ m/^(\S+)\s/ or die "SOA ? $_";
480     zone_server_simple(domain_canon($1),'SOA',1);
481 }
482
483 sub zone_server_simple ($$$) {
484     my ($name,$why,$is_soa) = @_;
485     my ($rcode,@addrs,$addr);
486     ($rcode,@addrs)= lookup($name,'a','0');
487     foreach $addr (@addrs) { zone_server_addr($addr,$name,$why,$is_soa); }
488 }
489
490 #-------------------- outputting
491
492 sub zone_output () {
493     $output_contents{$$cfg{'output'}}.=
494         sprintf(<<'END',
495 zone "%s" {
496     type %s;
497     file "%s";
498 };
499 END
500                 $zone,
501                 $$cfg{'s'} =~ m/p/ ? 'master' : 'slave',
502                 $$cfg{'file'});
503 }
504
505
506 #-------------------- general utilities
507
508 sub debug_dump ($) {
509     my ($vn);
510     return unless $debug>1;
511     local $Data::Dumper::Terse=1;
512     foreach $vn (split /\s+/, $_[0]) {
513         print "$vn := ", eval "Dumper(\\$vn)";
514     }
515 }
516
517 sub debug_trace ($) {
518     return unless $debug;
519     print "D $_[0]\n";
520 }
521
522 sub lookup ($$$) {
523     my ($domain,$type,$okrcodes) = @_;
524     my ($c,$h,@result);
525     debug_trace("lookup ==> (->$okrcodes) $domain $type");
526     $h= new IO::Handle;
527
528     defined($c= open $h, "-|") or die "$quis: fork adnshost:\n $!\n";
529     if (!$c) {
530         exec 'adnshost','-Fi','+Do','+Dt','+Dc','-Cf',"-t$type",
531              '-',"$domain.";
532         die "$quis: exec adnshost:\n $!\n";
533     }
534     @result= $h->getlines();
535     $h->error and die "$quis: read from adnshost:\n $!\n";
536     chomp @result;
537     $!=0; $h->close;
538     die "$quis: lookup -t$type $domain $okrcodes failed $? $!\n"
539         if $! or $?>6 or index($okrcodes,$?)<0;
540     debug_trace("lookup <== $? @result");
541     return ($?,@result);
542 }
543
544
545 sub dig (&$$$) {
546     my ($eachrr, $qowner,$qtype,$qaddr) = @_;
547     # also pseudo-rr with type `flags:'
548     my ($h,$inmid,$irdata,$c);
549     local ($_);
550
551     debug_trace("dig ==> \@$qaddr $qowner $qtype");
552
553     $h= new IO::Handle;
554     defined($c= open $h, "-|") or die "$quis: fork dig:\n $!\n";
555     if (!$c) {
556         open STDERR, ">&STDOUT" or die $!;
557         exec ('dig',
558               '+nodef','+nosea','+nodebug','+norecurse',
559               "\@$qaddr",'-t',$qtype,$qowner);
560         die "$quis: exec dig:\n $!\n";
561     }
562     $inmid='';
563     for (;;) {
564         if (!defined($_= $h->getline())) {
565             $h->error() and die "$quis: read from dig:\n $!\n";
566             last;
567         }
568         chomp;
569         if (length $inmid) {
570             s/^\s+/ / or die "$inmid // $_ ?";
571             s/\;.*$//;
572             $_= $inmid.$_;
573             $inmid='';
574             s/$/ \(/ unless s/\s*\)\s*$//;
575         }
576         if (s/\s*\(\s*$//) { $inmid= $_; next; }
577         if (m/^\;\; flags\:( [-0-9a-z ]+)\;/) {
578             $dig_owner=''; $dig_type='flags:'; $dig_rdata= "$1 ";
579             debug_trace("dig  f: $dig_rdata");
580             &$eachrr;
581         } elsif (m/^\;/) {
582         } elsif (!m/\S/) {
583         } elsif (m/^([-.0-9a-z]+)\s+\d\w+\s+in\s+([a-z]+)\s+(\S.*)/i) {
584             $dig_owner=domain_canon($1); $dig_type=lc $2; $irdata=$3;
585             if ($dig_type eq 'a') {
586                 $irdata =~ m/^[.0-9]+$/ or die "$irdata ?";
587                 $dig_rdata= $&;
588             } elsif ($dig_type eq 'ns') {
589                 $irdata =~ m/^[-.0-9a-z]+$/i or die "bad nameserver $irdata ?";
590                 $dig_rdata= domain_canon($irdata);
591             } elsif ($dig_type eq 'soa') {
592                 $irdata =~ m/^([-.0-9a-z]+)\s+.*\s+(\d+)(?:\s+\d\w+){4}$/i
593                     or die "bad SOA $irdata ?";
594                 $dig_rdata= domain_canon($1).' '.$2;
595             } else {
596                 debug_trace("ignoring uknown RR type $dig_type");
597                 next;
598             }
599             debug_trace("dig  $dig_owner $dig_type $dig_rdata");
600             &$eachrr;
601         } else {
602             debug_trace("ignoring unknown dig output $_");
603         }
604     }
605     $h->close;
606     debug_trace("dig <== gave $?");
607 }
608
609 sub domain_canon ($) {
610     local ($_) = @_;
611     s/(.)\.$/$1/;
612     die "domain $_ ?" unless m/^[0-9a-z]/i;
613     return lc $_;
614 }