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