zone.lisp, frontend.lisp: New configuration-variable machinery.
[zone] / zone.lisp
1 ;;; -*-lisp-*-
2 ;;;
3 ;;; DNS zone generation
4 ;;;
5 ;;; (c) 2005 Straylight/Edgeware
6 ;;;
7
8 ;;;----- Licensing notice ---------------------------------------------------
9 ;;;
10 ;;; This program is free software; you can redistribute it and/or modify
11 ;;; it under the terms of the GNU General Public License as published by
12 ;;; the Free Software Foundation; either version 2 of the License, or
13 ;;; (at your option) any later version.
14 ;;;
15 ;;; This program is distributed in the hope that it will be useful,
16 ;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;;; GNU General Public License for more details.
19 ;;;
20 ;;; You should have received a copy of the GNU General Public License
21 ;;; along with this program; if not, write to the Free Software Foundation,
22 ;;; Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
23
24 ;;;--------------------------------------------------------------------------
25 ;;; Packaging.
26
27 (defpackage #:zone
28 (:use #:common-lisp
29 #:mdw.base #:mdw.str #:collect #:safely
30 #:net #:services)
31 (:import-from #:net #:round-down #:round-up))
32
33 (in-package #:zone)
34
35 ;;;--------------------------------------------------------------------------
36 ;;; Various random utilities.
37
38 (export '*zone-config*)
39 (defparameter *zone-config* nil
40 "A list of configuration variables.
41
42 This is for the benefit of the frontend, which will dynamically bind them
43 so that input files can override them independently. Not intended for use
44 by users.")
45
46 (defun to-integer (x)
47 "Convert X to an integer in the most straightforward way."
48 (floor (rational x)))
49
50 (defun from-mixed-base (base val)
51 "BASE is a list of the ranges for the `digits' of a mixed-base
52 representation. Convert VAL, a list of digits, into an integer."
53 (do ((base base (cdr base))
54 (val (cdr val) (cdr val))
55 (a (car val) (+ (* a (car base)) (car val))))
56 ((or (null base) (null val)) a)))
57
58 (defun to-mixed-base (base val)
59 "BASE is a list of the ranges for the `digits' of a mixed-base
60 representation. Convert VAL, an integer, into a list of digits."
61 (let ((base (reverse base))
62 (a nil))
63 (loop
64 (unless base
65 (push val a)
66 (return a))
67 (multiple-value-bind (q r) (floor val (pop base))
68 (push r a)
69 (setf val q)))))
70
71 (export 'timespec-seconds)
72 (defun timespec-seconds (ts)
73 "Convert a timespec TS to seconds.
74
75 A timespec may be a real count of seconds, or a list (COUNT UNIT). UNIT
76 may be any of a number of obvious time units."
77 (cond ((null ts) 0)
78 ((realp ts) (floor ts))
79 ((atom ts)
80 (error "Unknown timespec format ~A" ts))
81 ((null (cdr ts))
82 (timespec-seconds (car ts)))
83 (t (+ (to-integer (* (car ts)
84 (case (intern (string-upcase
85 (stringify (cadr ts)))
86 '#:zone)
87 ((s sec secs second seconds) 1)
88 ((m min mins minute minutes) 60)
89 ((h hr hrs hour hours) #.(* 60 60))
90 ((d dy dys day days) #.(* 24 60 60))
91 ((w wk wks week weeks) #.(* 7 24 60 60))
92 ((y yr yrs year years) #.(* 365 24 60 60))
93 (t (error "Unknown time unit ~A"
94 (cadr ts))))))
95 (timespec-seconds (cddr ts))))))
96
97 (defun hash-table-keys (ht)
98 "Return a list of the keys in hashtable HT."
99 (collecting ()
100 (maphash (lambda (key val) (declare (ignore val)) (collect key)) ht)))
101
102 (defun iso-date (&optional time &key datep timep (sep #\ ))
103 "Construct a textual date or time in ISO format.
104
105 The TIME is the universal time to convert, which defaults to now; DATEP is
106 whether to emit the date; TIMEP is whether to emit the time, and
107 SEP (default is space) is how to separate the two."
108 (multiple-value-bind
109 (sec min hr day mon yr dow dstp tz)
110 (decode-universal-time (if (or (null time) (eq time :now))
111 (get-universal-time)
112 time))
113 (declare (ignore dow dstp tz))
114 (with-output-to-string (s)
115 (when datep
116 (format s "~4,'0D-~2,'0D-~2,'0D" yr mon day)
117 (when timep
118 (write-char sep s)))
119 (when timep
120 (format s "~2,'0D:~2,'0D:~2,'0D" hr min sec)))))
121
122 (deftype octet () '(unsigned-byte 8))
123 (deftype octet-vector (&optional n) `(array octet (,n)))
124
125 (defun decode-hex (hex &key (start 0) end)
126 "Decode a hexadecimal-encoded string, returning a vector of octets."
127 (let* ((end (or end (length hex)))
128 (len (- end start))
129 (raw (make-array (floor len 2) :element-type 'octet)))
130 (unless (evenp len)
131 (error "Invalid hex string `~A' (odd length)" hex))
132 (do ((i start (+ i 2)))
133 ((>= i end) raw)
134 (let ((high (digit-char-p (char hex i) 16))
135 (low (digit-char-p (char hex (1+ i)) 16)))
136 (unless (and high low)
137 (error "Invalid hex string `~A' (bad digit)" hex))
138 (setf (aref raw (/ (- i start) 2)) (+ (* 16 high) low))))))
139
140 (defun slurp-file (file &optional (element-type 'character))
141 "Read and return the contents of FILE as a vector."
142 (with-open-file (in file :element-type element-type)
143 (let ((buf (make-array 1024 :element-type element-type))
144 (pos 0))
145 (loop
146 (let ((end (read-sequence buf in :start pos)))
147 (when (< end (length buf))
148 (return (adjust-array buf end)))
149 (setf pos end
150 buf (adjust-array buf (* 2 pos))))))))
151
152 (defmacro defenum (name (&key export) &body values)
153 "Set up symbol properties for manifest constants.
154
155 The VALUES are a list of (TAG VALUE) pairs. Each TAG is a symbol; we set
156 the NAME property on TAG to VALUE, and export TAG. There are also handy
157 hash-tables mapping in the forward and reverse directions, in the name
158 symbol's `enum-forward' and `enum-reverse' properties."
159 `(eval-when (:compile-toplevel :load-toplevel :execute)
160 ,(let*/gensyms (export)
161 (with-gensyms (forward reverse valtmp)
162 `(let ((,forward (make-hash-table))
163 (,reverse (make-hash-table)))
164 (when ,export (export ',name))
165 ,@(mapcar (lambda (item)
166 (destructuring-bind (tag value) item
167 (let ((constant
168 (intern (concatenate 'string
169 (symbol-name name)
170 "/"
171 (symbol-name tag)))))
172 `(let ((,valtmp ,value))
173 (when ,export
174 (export ',constant)
175 (when (eq (symbol-package ',tag) *package*)
176 (export ',tag)))
177 (defconstant ,constant ,valtmp)
178 (setf (get ',tag ',name) ,value
179 (gethash ',tag ,forward) ,valtmp
180 (gethash ,valtmp ,reverse) ',tag)))))
181 values)
182 (setf (get ',name 'enum-forward) ,forward
183 (get ',name 'enum-reverse) ,reverse))))))
184
185 (defun lookup-enum (name tag &key min max)
186 "Look up a TAG in an enumeration.
187
188 If TAG is a symbol, check its NAME property; if it's a fixnum then take it
189 as it is. Make sure that it's between MIN and MAX, if they're not nil."
190 (let ((value (etypecase tag
191 (fixnum tag)
192 (symbol (or (get tag name)
193 (error "~S is not a known ~A" tag name))))))
194 (unless (and (or (null min) (<= min value))
195 (or (null max) (<= value max)))
196 (error "Value ~S out of range for ~A" value name))
197 value))
198
199 (defun reverse-enum (name value)
200 "Reverse-lookup of a VALUE in enumeration NAME.
201
202 If a tag for the VALUE is found, return it and `t'; otherwise return VALUE
203 unchanged and `nil'."
204 (multiple-value-bind (tag foundp) (gethash value (get name 'enum-reverse))
205 (if foundp
206 (values tag t)
207 (values value nil))))
208
209 (defun mapenum (func name)
210 "Call FUNC on TAG/VALUE pairs from the enumeration called NAME."
211 (maphash func (get name 'enum-forward)))
212
213 (defun hash-file (hash file context)
214 "Hash the FILE using the OpenSSL HASH function, returning an octet string.
215
216 CONTEXT is a temporary-files context."
217 (let ((temp (temporary-file context "hash")))
218 (run-program (list "openssl" "dgst" (concatenate 'string "-" hash))
219 :input file :output temp)
220 (with-open-file (in temp)
221 (let ((line (read-line in)))
222 (assert (and (>= (length line) 9)
223 (string= line "(stdin)= " :end1 9)))
224 (decode-hex line :start 9)))))
225
226 ;;;--------------------------------------------------------------------------
227 ;;; Zone types.
228
229 (export 'soa)
230 (defstruct (soa (:predicate soap))
231 "Start-of-authority record information."
232 source
233 admin
234 refresh
235 retry
236 expire
237 min-ttl
238 serial)
239
240 (export 'zone-text-name)
241 (defun zone-text-name (zone)
242 (princ-to-string (zone-name zone)))
243
244 (export 'mx)
245 (defstruct (mx (:predicate mxp))
246 "Mail-exchange record information."
247 priority
248 domain)
249
250 (export 'zone)
251 (defstruct (zone (:predicate zonep))
252 "Zone information."
253 soa
254 default-ttl
255 name
256 records)
257
258 ;;;--------------------------------------------------------------------------
259 ;;; Zone defaults. It is intended that scripts override these.
260
261 (export '*default-zone-source*)
262 (defvar *default-zone-source*
263 (let ((hn (gethostname)))
264 (and hn (concatenate 'string (canonify-hostname hn) ".")))
265 "The default zone source: the current host's name.")
266
267 (export '*default-zone-refresh*)
268 (defvar *default-zone-refresh* (* 24 60 60)
269 "Default zone refresh interval: one day.")
270
271 (export '*default-zone-admin*)
272 (defvar *default-zone-admin* nil
273 "Default zone administrator's email address.")
274
275 (export '*default-zone-retry*)
276 (defvar *default-zone-retry* (* 60 60)
277 "Default znoe retry interval: one hour.")
278
279 (export '*default-zone-expire*)
280 (defvar *default-zone-expire* (* 14 24 60 60)
281 "Default zone expiry time: two weeks.")
282
283 (export '*default-zone-min-ttl*)
284 (defvar *default-zone-min-ttl* (* 4 60 60)
285 "Default zone minimum TTL/negative TTL: four hours.")
286
287 (export '*default-zone-ttl*)
288 (defvar *default-zone-ttl* (* 8 60 60)
289 "Default zone TTL (for records without explicit TTLs): 8 hours.")
290
291 (export '*default-mx-priority*)
292 (defvar *default-mx-priority* 50
293 "Default MX priority.")
294
295 ;;;--------------------------------------------------------------------------
296 ;;; Zone variables and structures.
297
298 (defvar *zones* (make-hash-table :test #'equal)
299 "Map of known zones.")
300
301 (export 'zone-find)
302 (defun zone-find (name)
303 "Find a zone given its NAME."
304 (gethash (string-downcase (stringify name)) *zones*))
305 (defun (setf zone-find) (zone name)
306 "Make the zone NAME map to ZONE."
307 (setf (gethash (string-downcase (stringify name)) *zones*) zone))
308
309 (export 'zone-record)
310 (defstruct (zone-record (:conc-name zr-))
311 "A zone record."
312 (name '<unnamed>)
313 ttl
314 type
315 (make-ptr-p nil)
316 data)
317
318 (export 'zone-subdomain)
319 (defstruct (zone-subdomain (:conc-name zs-))
320 "A subdomain.
321
322 Slightly weird. Used internally by `zone-process-records', and shouldn't
323 escape."
324 name
325 ttl
326 records)
327
328 (export '*zone-output-path*)
329 (defvar *zone-output-path* nil
330 "Pathname defaults to merge into output files.
331
332 If this is nil then use the prevailing `*default-pathname-defaults*'.
333 This is not the same as capturing the `*default-pathname-defaults*' from
334 load time.")
335
336 (export '*preferred-subnets*)
337 (defvar *preferred-subnets* nil
338 "Subnets to prefer when selecting defaults.")
339
340 ;;;--------------------------------------------------------------------------
341 ;;; Zone infrastructure.
342
343 (defun zone-file-name (zone type)
344 "Choose a file name for a given ZONE and TYPE."
345 (merge-pathnames (make-pathname :name (string-downcase zone)
346 :type (string-downcase type))
347 (or *zone-output-path* *default-pathname-defaults*)))
348
349 (export 'zone-preferred-subnet-p)
350 (defun zone-preferred-subnet-p (name)
351 "Answer whether NAME (a string or symbol) names a preferred subnet."
352 (member name *preferred-subnets* :test #'string-equal))
353
354 (export 'preferred-subnet-case)
355 (defmacro preferred-subnet-case (&body clauses)
356 "Execute a form based on which networks are considered preferred.
357
358 The CLAUSES have the form (SUBNETS . FORMS) -- evaluate the first FORMS
359 whose SUBNETS (a list or single symbol, not evaluated) are listed in
360 `*preferred-subnets*'. If SUBNETS is the symbol `t' then the clause
361 always matches."
362 `(cond
363 ,@(mapcar (lambda (clause)
364 (let ((subnets (car clause)))
365 (cons (cond ((eq subnets t)
366 t)
367 ((listp subnets)
368 `(or ,@(mapcar (lambda (subnet)
369 `(zone-preferred-subnet-p
370 ',subnet))
371 subnets)))
372 (t
373 `(zone-preferred-subnet-p ',subnets)))
374 (cdr clause))))
375 clauses)))
376
377 (export 'zone-parse-host)
378 (defun zone-parse-host (form &optional tail)
379 "Parse a host name FORM from a value in a zone form.
380
381 The underlying parsing is done using `parse-domain-name'. Here, we
382 interpret various kinds of Lisp object specially. In particular: `nil'
383 refers to the TAIL zone (just like a plain `@'); and a symbol is downcased
384 before use."
385 (let ((name (etypecase form
386 (null (make-domain-name :labels nil :absolutep nil))
387 (domain-name form)
388 (symbol (parse-domain-name (string-downcase form)))
389 (string (parse-domain-name form)))))
390 (if (null tail) name
391 (domain-name-concat name tail))))
392
393 (export 'zone-records-sorted)
394 (defun zone-records-sorted (zone)
395 "Return the ZONE's records, in a pleasant sorted order."
396 (sort (copy-seq (zone-records zone))
397 (lambda (zr-a zr-b)
398 (multiple-value-bind (precp follp)
399 (domain-name< (zr-name zr-a) (zr-name zr-b))
400 (cond (precp t)
401 (follp nil)
402 (t (string< (zr-type zr-a) (zr-type zr-b))))))))
403
404 ;;;--------------------------------------------------------------------------
405 ;;; Serial numbering.
406
407 (export 'make-zone-serial)
408 (defun make-zone-serial (name)
409 "Given a zone NAME, come up with a new serial number.
410
411 This will (very carefully) update a file ZONE.serial in the current
412 directory."
413 (let* ((file (zone-file-name name :serial))
414 (last (with-open-file (in file
415 :direction :input
416 :if-does-not-exist nil)
417 (if in (read in)
418 (list 0 0 0 0))))
419 (now (multiple-value-bind
420 (sec min hr dy mon yr dow dstp tz)
421 (get-decoded-time)
422 (declare (ignore sec min hr dow dstp tz))
423 (list dy mon yr)))
424 (seq (cond ((not (equal now (cdr last))) 0)
425 ((< (car last) 99) (1+ (car last)))
426 (t (error "Run out of sequence numbers for ~A" name)))))
427 (safely-writing (out file)
428 (format out
429 ";; Serial number file for zone ~A~%~
430 ;; (LAST-SEQ DAY MONTH YEAR)~%~
431 ~S~%"
432 name
433 (cons seq now)))
434 (from-mixed-base '(100 100 100) (reverse (cons seq now)))))
435
436 ;;;--------------------------------------------------------------------------
437 ;;; Zone form parsing.
438
439 (defun zone-process-records (rec ttl func)
440 "Sort out the list of records in REC, calling FUNC for each one.
441
442 TTL is the default time-to-live for records which don't specify one.
443
444 REC is a list of records of the form
445
446 ({ :ttl TTL | TYPE DATA | (LABEL . REC) }*)
447
448 The various kinds of entries have the following meanings.
449
450 :ttl TTL Set the TTL for subsequent records (at this level of
451 nesting only).
452
453 TYPE DATA Define a record with a particular TYPE and DATA.
454 Record types are defined using `defzoneparse' and
455 the syntax of the data is idiosyncratic.
456
457 ((LABEL ...) . REC) Define records for labels within the zone. Any
458 records defined within REC will have their domains
459 prefixed by each of the LABELs. A singleton list
460 of labels may instead be written as a single
461 label. Note, therefore, that
462
463 (host (sub :a \"169.254.1.1\"))
464
465 defines a record for `host.sub' -- not `sub.host'.
466
467 If REC contains no top-level records, but it does define records for a
468 label listed in `*preferred-subnets*', then the records for the first such
469 label are also promoted to top-level.
470
471 The FUNC is called for each record encountered, represented as a
472 `zone-record' object. Zone parsers are not called: you get the record
473 types and data from the input form; see `zone-parse-records' if you want
474 the raw output."
475
476 (labels ((sift (rec ttl)
477 ;; Parse the record list REC into lists of `zone-record' and
478 ;; `zone-subdomain' objects, sorting out TTLs and so on.
479 ;; Returns them as two values.
480
481 (collecting (top sub)
482 (loop
483 (unless rec
484 (return))
485 (let ((r (pop rec)))
486 (cond ((eq r :ttl)
487 (setf ttl (pop rec)))
488 ((symbolp r)
489 (collect (make-zone-record :type r
490 :ttl ttl
491 :data (pop rec))
492 top))
493 ((listp r)
494 (dolist (name (listify (car r)))
495 (collect (make-zone-subdomain
496 :name (zone-parse-host name)
497 :ttl ttl :records (cdr r))
498 sub)))
499 (t
500 (error "Unexpected record form ~A" (car r))))))))
501
502 (process (rec dom ttl)
503 ;; Recursirvely process the record list REC, with a list DOM of
504 ;; prefix labels, and a default TTL. Promote records for a
505 ;; preferred subnet to toplevel if there are no toplevel records
506 ;; already.
507
508 (multiple-value-bind (top sub) (sift rec ttl)
509 (if (and dom (null top) sub)
510 (let ((preferred
511 (or (find-if
512 (lambda (s)
513 (let ((ll (domain-name-labels (zs-name s))))
514 (and (consp ll) (null (cdr ll))
515 (zone-preferred-subnet-p (car ll)))))
516 sub)
517 (car sub))))
518 (when preferred
519 (process (zs-records preferred)
520 dom
521 (zs-ttl preferred))))
522 (let ((name dom))
523 (dolist (zr top)
524 (setf (zr-name zr) name)
525 (funcall func zr))))
526 (dolist (s sub)
527 (process (zs-records s)
528 (if (null dom) (zs-name s)
529 (domain-name-concat dom (zs-name s)))
530 (zs-ttl s))))))
531
532 ;; Process the records we're given with no prefix.
533 (process rec nil ttl)))
534
535 (defun zone-parse-head (head)
536 "Parse the HEAD of a zone form.
537
538 This has the form
539
540 (NAME &key :source :admin :refresh :retry
541 :expire :min-ttl :ttl :serial)
542
543 though a singleton NAME needn't be a list. Returns the default TTL and an
544 soa structure representing the zone head."
545 (destructuring-bind
546 (raw-zname
547 &key
548 (source *default-zone-source*)
549 (admin (or *default-zone-admin*
550 (format nil "hostmaster@~A" raw-zname)))
551 (refresh *default-zone-refresh*)
552 (retry *default-zone-retry*)
553 (expire *default-zone-expire*)
554 (min-ttl *default-zone-min-ttl*)
555 (ttl min-ttl)
556 (serial (make-zone-serial raw-zname))
557 &aux
558 (zname (zone-parse-host raw-zname root-domain)))
559 (listify head)
560 (values zname
561 (timespec-seconds ttl)
562 (make-soa :admin admin
563 :source (zone-parse-host source zname)
564 :refresh (timespec-seconds refresh)
565 :retry (timespec-seconds retry)
566 :expire (timespec-seconds expire)
567 :min-ttl (timespec-seconds min-ttl)
568 :serial serial))))
569
570 (export 'defzoneparse)
571 (defmacro defzoneparse (types (name data list
572 &key (prefix (gensym "PREFIX"))
573 (zname (gensym "ZNAME"))
574 (ttl (gensym "TTL")))
575 &body body)
576 "Define a new zone record type.
577
578 The arguments are as follows:
579
580 TYPES A singleton type symbol, or a list of aliases.
581
582 NAME The name of the record to be added.
583
584 DATA The content of the record to be added (a single object,
585 unevaluated).
586
587 LIST A function to add a record to the zone. See below.
588
589 PREFIX The prefix tag used in the original form.
590
591 ZNAME The name of the zone being constructed.
592
593 TTL The TTL for this record.
594
595 You get to choose your own names for these. ZNAME, PREFIX and TTL are
596 optional: you don't have to accept them if you're not interested.
597
598 The LIST argument names a function to be bound in the body to add a new
599 low-level record to the zone. It has the prototype
600
601 (LIST &key :name :type :data :ttl :make-ptr-p)
602
603 These (except MAKE-PTR-P, which defaults to nil) default to the above
604 arguments (even if you didn't accept the arguments)."
605
606 (setf types (listify types))
607 (let* ((type (car types))
608 (func (intern (format nil "ZONE-PARSE/~:@(~A~)" type))))
609 (with-parsed-body (body decls doc) body
610 (with-gensyms (col tname ttype tttl tdata tmakeptrp i)
611 `(progn
612 (dolist (,i ',types)
613 (setf (get ,i 'zone-parse) ',func))
614 (defun ,func (,prefix ,zname ,data ,ttl ,col)
615 ,@doc
616 ,@decls
617 (let ((,name (if (null ,prefix) ,zname
618 (domain-name-concat ,prefix ,zname))))
619 (flet ((,list (&key ((:name ,tname) ,name)
620 ((:type ,ttype) ,type)
621 ((:data ,tdata) ,data)
622 ((:ttl ,tttl) ,ttl)
623 ((:make-ptr-p ,tmakeptrp) nil))
624 #+cmu (declare (optimize ext:inhibit-warnings))
625 (collect (make-zone-record :name ,tname
626 :type ,ttype
627 :data ,tdata
628 :ttl ,tttl
629 :make-ptr-p ,tmakeptrp)
630 ,col)))
631 ,@body)))
632 ',type)))))
633
634 (export 'zone-parse-records)
635 (defun zone-parse-records (zname ttl records)
636 "Parse a sequence of RECORDS and return a list of raw records.
637
638 The records are parsed relative to the zone name ZNAME, and using the
639 given default TTL."
640 (collecting (rec)
641 (flet ((parse-record (zr)
642 (let ((func (or (get (zr-type zr) 'zone-parse)
643 (error "No parser for record ~A."
644 (zr-type zr))))
645 (name (and (zr-name zr) (zr-name zr))))
646 (funcall func name zname (zr-data zr) (zr-ttl zr) rec))))
647 (zone-process-records records ttl #'parse-record))))
648
649 (export 'zone-parse)
650 (defun zone-parse (zf)
651 "Parse a ZONE form.
652
653 The syntax of a zone form is as follows:
654
655 ZONE-FORM:
656 ZONE-HEAD ZONE-RECORD*
657
658 ZONE-RECORD:
659 ((NAME*) ZONE-RECORD*)
660 | SYM ARGS"
661 (multiple-value-bind (zname ttl soa) (zone-parse-head (car zf))
662 (make-zone :name zname
663 :default-ttl ttl
664 :soa soa
665 :records (zone-parse-records zname ttl (cdr zf)))))
666
667 (export 'zone-create)
668 (defun zone-create (zf)
669 "Zone construction function.
670
671 Given a zone form ZF, construct the zone and add it to the table."
672 (let* ((zone (zone-parse zf))
673 (name (zone-text-name zone)))
674 (setf (zone-find name) zone)
675 name))
676
677 (export 'defzone)
678 (defmacro defzone (soa &body zf)
679 "Zone definition macro."
680 `(zone-create '(,soa ,@zf)))
681
682 (export '*address-family*)
683 (defvar *address-family* t
684 "The default address family. This is bound by `defrevzone'.")
685
686 (export 'defrevzone)
687 (defmacro defrevzone (head &body zf)
688 "Define a reverse zone, with the correct name."
689 (destructuring-bind (nets &rest args
690 &key &allow-other-keys
691 (family '*address-family*)
692 prefix-bits)
693 (listify head)
694 (with-gensyms (ipn)
695 `(dolist (,ipn (net-parse-to-ipnets ',nets ,family))
696 (let ((*address-family* (ipnet-family ,ipn)))
697 (zone-create `((,(format nil "~A." (reverse-domain ,ipn
698 ,prefix-bits))
699 ,@',(loop for (k v) on args by #'cddr
700 unless (member k
701 '(:family :prefix-bits))
702 nconc (list k v)))
703 ,@',zf)))))))
704
705 (export 'map-host-addresses)
706 (defun map-host-addresses (func addr &key (family *address-family*))
707 "Call FUNC for each address denoted by ADDR (a `host-parse' address)."
708
709 (dolist (a (host-addrs (host-parse addr family)))
710 (funcall func a)))
711
712 (export 'do-host)
713 (defmacro do-host ((addr spec &key (family *address-family*)) &body body)
714 "Evaluate BODY, binding ADDR to each address denoted by SPEC."
715 `(dolist (,addr (host-addrs (host-parse ,spec ,family)))
716 ,@body))
717
718 (export 'zone-set-address)
719 (defun zone-set-address (rec addrspec &rest args
720 &key (family *address-family*) name ttl make-ptr-p)
721 "Write records (using REC) defining addresses for ADDRSPEC."
722 (declare (ignore name ttl make-ptr-p))
723 (let ((key-args (loop for (k v) on args by #'cddr
724 unless (eq k :family)
725 nconc (list k v))))
726 (do-host (addr addrspec :family family)
727 (apply rec :type (ipaddr-rrtype addr) :data addr key-args))))
728
729 ;;;--------------------------------------------------------------------------
730 ;;; Building raw record vectors.
731
732 (defvar *record-vector* nil
733 "The record vector under construction.")
734
735 (defun rec-ensure (n)
736 "Ensure that at least N octets are spare in the current record."
737 (let ((want (+ n (fill-pointer *record-vector*)))
738 (have (array-dimension *record-vector* 0)))
739 (unless (<= want have)
740 (adjust-array *record-vector*
741 (do ((new (* 2 have) (* 2 new)))
742 ((<= want new) new))))))
743
744 (export 'rec-octet-vector)
745 (defun rec-octet-vector (vector &key (start 0) end)
746 "Copy (part of) the VECTOR to the output."
747 (let* ((end (or end (length vector)))
748 (len (- end start)))
749 (rec-ensure len)
750 (do ((i start (1+ i)))
751 ((>= i end))
752 (vector-push (aref vector i) *record-vector*))))
753
754 (export 'rec-byte)
755 (defun rec-byte (octets value)
756 "Append an unsigned byte, OCTETS octets wide, with VALUE, to the record."
757 (rec-ensure octets)
758 (do ((i (1- octets) (1- i)))
759 ((minusp i))
760 (vector-push (ldb (byte 8 (* 8 i)) value) *record-vector*)))
761
762 (export 'rec-u8)
763 (defun rec-u8 (value)
764 "Append an 8-bit VALUE to the current record."
765 (rec-byte 1 value))
766
767 (export 'rec-u16)
768 (defun rec-u16 (value)
769 "Append a 16-bit VALUE to the current record."
770 (rec-byte 2 value))
771
772 (export 'rec-u32)
773 (defun rec-u32 (value)
774 "Append a 32-bit VALUE to the current record."
775 (rec-byte 4 value))
776
777 (export 'rec-raw-string)
778 (defun rec-raw-string (s &key (start 0) end)
779 "Append (a (substring of) a raw string S to the current record.
780
781 No arrangement is made for reporting the length of the string. That must
782 be done by the caller, if necessary."
783 (setf-default end (length s))
784 (rec-ensure (- end start))
785 (do ((i start (1+ i)))
786 ((>= i end))
787 (vector-push (char-code (char s i)) *record-vector*)))
788
789 (export 'rec-string)
790 (defun rec-string (s &key (start 0) end (max 255))
791 (let* ((end (or end (length s)))
792 (len (- end start)))
793 (unless (<= len max)
794 (error "String `~A' too long" (subseq s start end)))
795 (rec-u8 (- end start))
796 (rec-raw-string s :start start :end end)))
797
798 (export 'rec-name)
799 (defun rec-name (name)
800 "Append a domain NAME.
801
802 No attempt is made to perform compression of the name."
803 (dolist (label (reverse (domain-name-labels name)))
804 (rec-string label :max 63))
805 (rec-u8 0))
806
807 (export 'build-record)
808 (defmacro build-record (&body body)
809 "Build a raw record, and return it as a vector of octets."
810 `(let ((*record-vector* (make-array 256
811 :element-type '(unsigned-byte 8)
812 :fill-pointer 0
813 :adjustable t)))
814 ,@body
815 (copy-seq *record-vector*)))
816
817 (export 'zone-record-rrdata)
818 (defgeneric zone-record-rrdata (type zr)
819 (:documentation "Emit (using the `build-record' protocol) RRDATA for ZR.
820
821 The TYPE is a keyword naming the record type. Return the numeric RRTYPE
822 code."))
823
824 ;;;--------------------------------------------------------------------------
825 ;;; Zone record parsers.
826
827 (defzoneparse :a (name data rec)
828 ":a IPADDR"
829 (zone-set-address #'rec data :make-ptr-p t :family :ipv4))
830
831 (defmethod zone-record-rrdata ((type (eql :a)) zr)
832 (rec-u32 (ipaddr-addr (zr-data zr)))
833 1)
834
835 (defzoneparse :aaaa (name data rec)
836 ":aaaa IPADDR"
837 (zone-set-address #'rec data :make-ptr-p t :family :ipv6))
838
839 (defmethod zone-record-rrdata ((type (eql :aaaa)) zr)
840 (rec-byte 16 (ipaddr-addr (zr-data zr)))
841 28)
842
843 (defzoneparse :addr (name data rec)
844 ":addr IPADDR"
845 (zone-set-address #'rec data :make-ptr-p t))
846
847 (defzoneparse :svc (name data rec)
848 ":svc IPADDR"
849 (zone-set-address #'rec data))
850
851 (defzoneparse :ptr (name data rec :zname zname)
852 ":ptr HOST"
853 (rec :data (zone-parse-host data zname)))
854
855 (defmethod zone-record-rrdata ((type (eql :ptr)) zr)
856 (rec-name (zr-data zr))
857 12)
858
859 (defzoneparse :cname (name data rec :zname zname)
860 ":cname HOST"
861 (rec :data (zone-parse-host data zname)))
862
863 (defmethod zone-record-rrdata ((type (eql :cname)) zr)
864 (rec-name (zr-data zr))
865 5)
866
867 (defzoneparse :txt (name data rec)
868 ":txt (TEXT*)"
869 (rec :data (listify data)))
870
871 (defmethod zone-record-rrdata ((type (eql :txt)) zr)
872 (mapc #'rec-string (zr-data zr))
873 16)
874
875 (export '*dkim-pathname-defaults*)
876 (defvar *dkim-pathname-defaults*
877 (make-pathname :directory '(:relative "keys")
878 :type "dkim"))
879 (pushnew '*dkim-pathname-defaults* *zone-config*)
880
881 (defzoneparse :dkim (name data rec)
882 ":dkim (KEYFILE {:TAG VALUE}*)"
883 (destructuring-bind (file &rest plist) (listify data)
884 (let ((things nil) (out nil))
885 (labels ((flush ()
886 (when out
887 (push (get-output-stream-string out) things)
888 (setf out nil)))
889 (emit (text)
890 (let ((len (length text)))
891 (when (and out (> (+ (file-position out)
892 (length text))
893 64))
894 (flush))
895 (when (plusp len)
896 (cond ((< len 64)
897 (unless out
898 (setf out (make-string-output-stream)))
899 (write-string text out))
900 (t
901 (do ((i 0 j)
902 (j 64 (+ j 64)))
903 ((>= i len))
904 (push (subseq text i (min j len))
905 things))))))))
906 (do ((p plist (cddr p)))
907 ((endp p))
908 (emit (format nil "~(~A~)=~A;" (car p) (cadr p))))
909 (emit (with-output-to-string (out)
910 (write-string "p=" out)
911 (when file
912 (with-open-file
913 (in (merge-pathnames file *dkim-pathname-defaults*))
914 (loop
915 (when (string= (read-line in)
916 "-----BEGIN PUBLIC KEY-----")
917 (return)))
918 (loop
919 (let ((line (read-line in)))
920 (if (string= line "-----END PUBLIC KEY-----")
921 (return)
922 (write-string line out)))))))))
923 (rec :type :txt
924 :data (nreverse things)))))
925
926 (defenum sshfp-algorithm () (:rsa 1) (:dsa 2) (:ecdsa 3))
927 (defenum sshfp-type () (:sha-1 1) (:sha-256 2))
928
929 (export '*sshfp-pathname-defaults*)
930 (defvar *sshfp-pathname-defaults*
931 (make-pathname :directory '(:relative "keys") :type "sshfp")
932 "Default pathname components for SSHFP records.")
933 (pushnew '*sshfp-pathname-defaults* *zone-config*)
934
935 (defzoneparse :sshfp (name data rec)
936 ":sshfp { FILENAME | ((FPR :alg ALG :type HASH)*) }"
937 (if (stringp data)
938 (with-open-file (in (merge-pathnames data *sshfp-pathname-defaults*))
939 (loop (let ((line (read-line in nil)))
940 (unless line (return))
941 (let ((words (str-split-words line)))
942 (pop words)
943 (when (string= (car words) "IN") (pop words))
944 (unless (and (string= (car words) "SSHFP")
945 (= (length words) 4))
946 (error "Invalid SSHFP record."))
947 (pop words)
948 (destructuring-bind (alg type fpr) words
949 (rec :data (list (parse-integer alg)
950 (parse-integer type)
951 fpr)))))))
952 (dolist (item (listify data))
953 (destructuring-bind (fpr &key (alg 'rsa) (type 'sha-1))
954 (listify item)
955 (rec :data (list (lookup-enum alg 'sshfp-algorithm :min 0 :max 255)
956 (lookup-enum type 'sshfp-type :min 0 :max 255)
957 fpr))))))
958
959 (defmethod zone-record-rrdata ((type (eql :sshfp)) zr)
960 (destructuring-bind (alg type fpr) (zr-data zr)
961 (rec-u8 alg)
962 (rec-u8 type)
963 (do ((i 0 (+ i 2))
964 (n (length fpr)))
965 ((>= i n))
966 (rec-u8 (parse-integer fpr :start i :end (+ i 2) :radix 16))))
967 44)
968
969 (defenum tlsa-usage ()
970 (:ca-constraint 0)
971 (:service-certificate-constraint 1)
972 (:trust-anchor-assertion 2)
973 (:domain-issued-certificate 3))
974
975 (defenum tlsa-selector ()
976 (:certificate 0)
977 (:public-key 1))
978
979 (defenum tlsa-match ()
980 (:exact 0)
981 (:sha-256 1)
982 (:sha-512 2))
983
984 (defparameter tlsa-pem-alist
985 `(("CERTIFICATE" . ,tlsa-selector/certificate)
986 ("PUBLIC-KEY" . ,tlsa-selector/public-key)))
987
988 (defgeneric raw-tlsa-assoc-data (have want file context)
989 (:documentation
990 "Convert FILE, and strip off PEM encoding.
991
992 The FILE contains PEM-encoded data of type HAVE -- one of the
993 `tlsa-selector' codes. Return the name of a file containing binary
994 DER-encoded data of type WANT instead. The CONTEXT is a temporary-files
995 context.")
996
997 (:method (have want file context)
998 (declare (ignore context))
999 (error "Can't convert `~A' from selector type ~S to type ~S" file
1000 (reverse-enum 'tlsa-selector have)
1001 (reverse-enum 'tlsa-selector want)))
1002
1003 (:method ((have (eql tlsa-selector/certificate))
1004 (want (eql tlsa-selector/certificate))
1005 file context)
1006 (let ((temp (temporary-file context "cert")))
1007 (run-program (list "openssl" "x509" "-outform" "der")
1008 :input file :output temp)
1009 temp))
1010
1011 (:method ((have (eql tlsa-selector/public-key))
1012 (want (eql tlsa-selector/public-key))
1013 file context)
1014 (let ((temp (temporary-file context "pubkey-der")))
1015 (run-program (list "openssl" "pkey" "-pubin" "-outform" "der")
1016 :input file :output temp)
1017 temp))
1018
1019 (:method ((have (eql tlsa-selector/certificate))
1020 (want (eql tlsa-selector/public-key))
1021 file context)
1022 (let ((temp (temporary-file context "pubkey")))
1023 (run-program (list "openssl" "x509" "-noout" "-pubkey")
1024 :input file :output temp)
1025 (raw-tlsa-assoc-data want want temp context))))
1026
1027 (defgeneric tlsa-match-data-valid-p (match data)
1028 (:documentation
1029 "Check whether the DATA (an octet vector) is valid for the MATCH type.")
1030
1031 (:method (match data)
1032 (declare (ignore match data))
1033 ;; We don't know: assume the user knows what they're doing.
1034 t)
1035
1036 (:method ((match (eql tlsa-match/sha-256)) data) (= (length data) 32))
1037 (:method ((match (eql tlsa-match/sha-512)) data) (= (length data) 64)))
1038
1039 (defgeneric read-tlsa-match-data (match file context)
1040 (:documentation
1041 "Read FILE, and return an octet vector for the correct MATCH type.
1042
1043 CONTEXT is a temporary-files context.")
1044 (:method ((match (eql tlsa-match/exact)) file context)
1045 (declare (ignore context))
1046 (slurp-file file 'octet))
1047 (:method ((match (eql tlsa-match/sha-256)) file context)
1048 (hash-file "sha256" file context))
1049 (:method ((match (eql tlsa-match/sha-512)) file context)
1050 (hash-file "sha512" file context)))
1051
1052 (defgeneric tlsa-selector-pem-boundary (selector)
1053 (:documentation
1054 "Return the PEM boundary string for objects of the SELECTOR type")
1055 (:method ((selector (eql tlsa-selector/certificate))) "CERTIFICATE")
1056 (:method ((selector (eql tlsa-selector/public-key))) "PUBLIC KEY")
1057 (:method (selector) (declare (ignore selector)) nil))
1058
1059 (defun identify-tlsa-selector-file (file)
1060 "Return the selector type for the data stored in a PEM-format FILE."
1061 (with-open-file (in file)
1062 (loop
1063 (let* ((line (read-line in nil))
1064 (len (length line)))
1065 (unless line
1066 (error "No PEM boundary in `~A'" file))
1067 (when (and (>= len 11)
1068 (string= line "-----BEGIN " :end1 11)
1069 (string= line "-----" :start1 (- len 5)))
1070 (mapenum (lambda (tag value)
1071 (declare (ignore tag))
1072 (when (string= line
1073 (tlsa-selector-pem-boundary value)
1074 :start1 11 :end1 (- len 5))
1075 (return value)))
1076 'tlsa-selector))))))
1077
1078 (defun convert-tlsa-selector-data (data selector match)
1079 "Convert certificate association DATA as required by SELECTOR and MATCH.
1080
1081 If DATA is a hex string, we assume that it's already in the appropriate
1082 form (but if MATCH specifies a hash then we check that it's the right
1083 length). If DATA is a pathname, then it should name a PEM file: we
1084 identify the kind of object stored in the file from the PEM header, and
1085 convert as necessary.
1086
1087 The output is an octet vector containing the raw certificate association
1088 data to include in rrdata."
1089
1090 (etypecase data
1091 (string
1092 (let ((bin (decode-hex data)))
1093 (unless (tlsa-match-data-valid-p match bin)
1094 (error "Invalid data for match type ~S"
1095 (reverse-enum 'tlsa-match match)))
1096 bin))
1097 (pathname
1098 (with-temporary-files (context :base "tmpfile.tmp")
1099 (let* ((kind (identify-tlsa-selector-file data))
1100 (raw (raw-tlsa-assoc-data kind selector data context)))
1101 (read-tlsa-match-data match raw context))))))
1102
1103 (defzoneparse :tlsa (name data rec)
1104 ":tlsa (((SERVICE|PORT &key :protocol)*) (USAGE SELECTOR MATCH DATA)*)"
1105
1106 (destructuring-bind (services &rest certinfos) data
1107
1108 ;; First pass: build the raw-format TLSA record data.
1109 (let ((records nil))
1110 (dolist (certinfo certinfos)
1111 (destructuring-bind (usage-tag selector-tag match-tag data) certinfo
1112 (let* ((usage (lookup-enum 'tlsa-usage usage-tag :min 0 :max 255))
1113 (selector (lookup-enum 'tlsa-selector selector-tag
1114 :min 0 :max 255))
1115 (match (lookup-enum 'tlsa-match match-tag :min 0 :max 255))
1116 (raw (convert-tlsa-selector-data data selector match)))
1117 (push (list usage selector match raw) records))))
1118 (setf records (nreverse records))
1119
1120 ;; Second pass: attach records for the requested services.
1121 (dolist (service (listify services))
1122 (destructuring-bind (svc &key (protocol :tcp)) (listify service)
1123 (let* ((port (etypecase svc
1124 (integer svc)
1125 (keyword (let ((serv (serv-by-name svc protocol)))
1126 (unless serv
1127 (error "Unknown service `~A'" svc))
1128 (serv-port serv)))))
1129 (prefixed (domain-name-concat
1130 (make-domain-name
1131 :labels (list (format nil "_~(~A~)" protocol)
1132 (format nil "_~A" port)))
1133 name)))
1134 (dolist (record records)
1135 (rec :name prefixed :data record))))))))
1136
1137 (defmethod zone-record-rrdata ((type (eql :tlsa)) zr)
1138 (destructuring-bind (usage selector match data) (zr-data zr)
1139 (rec-u8 usage)
1140 (rec-u8 selector)
1141 (rec-u8 match)
1142 (rec-octet-vector data))
1143 52)
1144
1145 (defzoneparse :mx (name data rec :zname zname)
1146 ":mx ((HOST :prio INT :ip IPADDR)*)"
1147 (dolist (mx (listify data))
1148 (destructuring-bind
1149 (mxname &key (prio *default-mx-priority*) ip)
1150 (listify mx)
1151 (let ((host (zone-parse-host mxname zname)))
1152 (when ip (zone-set-address #'rec ip :name host))
1153 (rec :data (cons host prio))))))
1154
1155 (defmethod zone-record-rrdata ((type (eql :mx)) zr)
1156 (let ((name (car (zr-data zr)))
1157 (prio (cdr (zr-data zr))))
1158 (rec-u16 prio)
1159 (rec-name name))
1160 15)
1161
1162 (defzoneparse :ns (name data rec :zname zname)
1163 ":ns ((HOST :ip IPADDR)*)"
1164 (dolist (ns (listify data))
1165 (destructuring-bind
1166 (nsname &key ip)
1167 (listify ns)
1168 (let ((host (zone-parse-host nsname zname)))
1169 (when ip (zone-set-address #'rec ip :name host))
1170 (rec :data host)))))
1171
1172 (defmethod zone-record-rrdata ((type (eql :ns)) zr)
1173 (rec-name (zr-data zr))
1174 2)
1175
1176 (defzoneparse :alias (name data rec :zname zname)
1177 ":alias (LABEL*)"
1178 (dolist (a (listify data))
1179 (rec :name (zone-parse-host a zname)
1180 :type :cname
1181 :data name)))
1182
1183 (defzoneparse :srv (name data rec :zname zname)
1184 ":srv (((SERVICE &key :port :protocol)
1185 (PROVIDER &key :port :prio :weight :ip)*)*)"
1186 (dolist (srv data)
1187 (destructuring-bind (servopts &rest providers) srv
1188 (destructuring-bind
1189 (service &key ((:port default-port)) (protocol :tcp))
1190 (listify servopts)
1191 (unless default-port
1192 (let ((serv (serv-by-name service protocol)))
1193 (setf default-port (and serv (serv-port serv)))))
1194 (let ((rname (flet ((prepend (tag tail)
1195 (domain-name-concat
1196 (make-domain-name
1197 :labels (list (format nil "_~(~A~)" tag)))
1198 tail)))
1199 (prepend service (prepend protocol name)))))
1200 (dolist (prov providers)
1201 (destructuring-bind
1202 (srvname
1203 &key
1204 (port default-port)
1205 (prio *default-mx-priority*)
1206 (weight 0)
1207 ip)
1208 (listify prov)
1209 (let ((host (zone-parse-host srvname zname)))
1210 (when ip (zone-set-address #'rec ip :name host))
1211 (rec :name rname
1212 :data (list prio weight port host))))))))))
1213
1214 (defmethod zone-record-rrdata ((type (eql :srv)) zr)
1215 (destructuring-bind (prio weight port host) (zr-data zr)
1216 (rec-u16 prio)
1217 (rec-u16 weight)
1218 (rec-u16 port)
1219 (rec-name host))
1220 33)
1221
1222 (defzoneparse :net (name data rec)
1223 ":net (NETWORK*)"
1224 (dolist (net (listify data))
1225 (dolist (ipn (net-ipnets (net-must-find net)))
1226 (let* ((base (ipnet-net ipn))
1227 (rrtype (ipaddr-rrtype base)))
1228 (flet ((frob (kind addr)
1229 (when addr
1230 (rec :name (zone-parse-host kind name)
1231 :type rrtype
1232 :data addr))))
1233 (frob "net" base)
1234 (frob "mask" (ipaddr (ipnet-mask ipn) (ipnet-family ipn)))
1235 (frob "bcast" (ipnet-broadcast ipn)))))))
1236
1237 (defzoneparse (:rev :reverse) (name data rec)
1238 ":reverse ((NET &key :prefix-bits :family) ZONE*)
1239
1240 Add a reverse record each host in the ZONEs (or all zones) that lies
1241 within NET."
1242 (setf data (listify data))
1243 (destructuring-bind (net &key prefix-bits (family *address-family*))
1244 (listify (car data))
1245
1246 (dolist (ipn (net-parse-to-ipnets net family))
1247 (let* ((seen (make-hash-table :test #'equal))
1248 (width (ipnet-width ipn))
1249 (frag-len (if prefix-bits (- width prefix-bits)
1250 (ipnet-changeable-bits width (ipnet-mask ipn)))))
1251 (dolist (z (or (cdr data) (hash-table-keys *zones*)))
1252 (dolist (zr (zone-records (zone-find z)))
1253 (when (and (eq (zr-type zr) (ipaddr-rrtype (ipnet-net ipn)))
1254 (zr-make-ptr-p zr)
1255 (ipaddr-networkp (ipaddr-addr (zr-data zr)) ipn))
1256 (let* ((frag (reverse-domain-fragment (zr-data zr)
1257 0 frag-len))
1258 (name (domain-name-concat frag name))
1259 (name-string (princ-to-string name)))
1260 (unless (gethash name-string seen)
1261 (rec :name name :type :ptr
1262 :ttl (zr-ttl zr) :data (zr-name zr))
1263 (setf (gethash name-string seen) t))))))))))
1264
1265 (defzoneparse :multi (name data rec :zname zname :ttl ttl)
1266 ":multi (((NET*) &key :start :end :family :suffix) . REC)
1267
1268 Output multiple records covering a portion of the reverse-resolution
1269 namespace corresponding to the particular NETs. The START and END bounds
1270 default to the most significant variable component of the
1271 reverse-resolution domain.
1272
1273 The REC tail is a sequence of record forms (as handled by
1274 `zone-process-records') to be emitted for each covered address. Within
1275 the bodies of these forms, the symbol `*' will be replaced by the
1276 domain-name fragment corresponding to the current host, optionally
1277 followed by the SUFFIX.
1278
1279 Examples:
1280
1281 (:multi ((delegated-subnet :start 8)
1282 :ns (some.ns.delegated.example :ip \"169.254.5.2\")))
1283
1284 (:multi ((tiny-subnet :suffix \"128.10.254.169.in-addr.arpa\")
1285 :cname *))
1286
1287 Obviously, nested `:multi' records won't work well."
1288
1289 (destructuring-bind (nets
1290 &key start end ((:suffix raw-suffix))
1291 (family *address-family*))
1292 (listify (car data))
1293 (let ((suffix (if (not raw-suffix)
1294 (make-domain-name :labels nil :absolutep nil)
1295 (zone-parse-host raw-suffix))))
1296 (dolist (net (listify nets))
1297 (dolist (ipn (net-parse-to-ipnets net family))
1298 (let* ((addr (ipnet-net ipn))
1299 (width (ipaddr-width addr))
1300 (comp-width (reverse-domain-component-width addr))
1301 (end (round-up (or end
1302 (ipnet-changeable-bits width
1303 (ipnet-mask ipn)))
1304 comp-width))
1305 (start (round-down (or start (- end comp-width))
1306 comp-width))
1307 (map (ipnet-host-map ipn)))
1308 (multiple-value-bind (host-step host-limit)
1309 (ipnet-index-bounds map start end)
1310 (do ((index 0 (+ index host-step)))
1311 ((> index host-limit))
1312 (let* ((addr (ipnet-index-host map index))
1313 (frag (reverse-domain-fragment addr start end))
1314 (target (reduce #'domain-name-concat
1315 (list frag suffix zname)
1316 :from-end t
1317 :initial-value root-domain)))
1318 (dolist (zr (zone-parse-records (domain-name-concat frag
1319 zname)
1320 ttl
1321 (subst target '*
1322 (cdr data))))
1323 (rec :name (zr-name zr)
1324 :type (zr-type zr)
1325 :data (zr-data zr)
1326 :ttl (zr-ttl zr)
1327 :make-ptr-p (zr-make-ptr-p zr))))))))))))
1328
1329 ;;;--------------------------------------------------------------------------
1330 ;;; Zone file output.
1331
1332 (export 'zone-write)
1333 (defgeneric zone-write (format zone stream)
1334 (:documentation "Write ZONE's records to STREAM in the specified FORMAT."))
1335
1336 (defvar *writing-zone* nil
1337 "The zone currently being written.")
1338
1339 (defvar *zone-output-stream* nil
1340 "Stream to write zone data on.")
1341
1342 (export 'zone-write-raw-rrdata)
1343 (defgeneric zone-write-raw-rrdata (format zr type data)
1344 (:documentation "Write an otherwise unsupported record in a given FORMAT.
1345
1346 ZR gives the record object, which carries the name and TTL; the TYPE is
1347 the numeric RRTYPE code; and DATA is an octet vector giving the RRDATA.
1348 This is used by the default `zone-write-record' method to handle record
1349 types which aren't directly supported by the format driver."))
1350
1351 (export 'zone-write-header)
1352 (defgeneric zone-write-header (format zone)
1353 (:documentation "Emit the header for a ZONE, in a given FORMAT.
1354
1355 The header includes any kind of initial comment, the SOA record, and any
1356 other necessary preamble. There is no default implementation.
1357
1358 This is part of the protocol used by the default method on `zone-write';
1359 if you override that method."))
1360
1361 (export 'zone-write-trailer)
1362 (defgeneric zone-write-trailer (format zone)
1363 (:documentation "Emit the header for a ZONE, in a given FORMAT.
1364
1365 The footer may be empty, and is so by default.
1366
1367 This is part of the protocol used by the default method on `zone-write';
1368 if you override that method.")
1369 (:method (format zone)
1370 (declare (ignore format zone))
1371 nil))
1372
1373 (export 'zone-write-record)
1374 (defgeneric zone-write-record (format type zr)
1375 (:documentation "Emit a record of the given TYPE (a keyword).
1376
1377 The default implementation builds the raw RRDATA and passes it to
1378 `zone-write-raw-rrdata'.")
1379 (:method (format type zr)
1380 (let* (code
1381 (data (build-record (setf code (zone-record-rrdata type zr)))))
1382 (zone-write-raw-rrdata format zr code data))))
1383
1384 (defmethod zone-write (format zone stream)
1385 "This default method calls `zone-write-header', then `zone-write-record'
1386 for each record in the zone, and finally `zone-write-trailer'. While it's
1387 running, `*writing-zone*' is bound to the zone object, and
1388 `*zone-output-stream*' to the output stream."
1389 (let ((*writing-zone* zone)
1390 (*zone-output-stream* stream))
1391 (zone-write-header format zone)
1392 (dolist (zr (zone-records-sorted zone))
1393 (zone-write-record format (zr-type zr) zr))
1394 (zone-write-trailer format zone)))
1395
1396 (export 'zone-save)
1397 (defun zone-save (zones &key (format :bind))
1398 "Write the named ZONES to files. If no zones are given, write all the
1399 zones."
1400 (unless zones
1401 (setf zones (hash-table-keys *zones*)))
1402 (safely (safe)
1403 (dolist (z zones)
1404 (let ((zz (zone-find z)))
1405 (unless zz
1406 (error "Unknown zone `~A'." z))
1407 (let ((stream (safely-open-output-stream safe
1408 (zone-file-name z :zone))))
1409 (zone-write format zz stream)
1410 (close stream))))))
1411
1412 ;;;--------------------------------------------------------------------------
1413 ;;; Bind format output.
1414
1415 (defvar *bind-last-record-name* nil
1416 "The previously emitted record name.
1417
1418 Used for eliding record names on output.")
1419
1420 (export 'bind-hostname)
1421 (defun bind-hostname (hostname)
1422 (let ((zone (domain-name-labels (zone-name *writing-zone*)))
1423 (name (domain-name-labels hostname)))
1424 (loop
1425 (unless (and zone name (string= (car zone) (car name)))
1426 (return))
1427 (pop zone) (pop name))
1428 (flet ((stitch (labels absolutep)
1429 (format nil "~{~A~^.~}~@[.~]"
1430 (reverse (mapcar #'quotify-label labels))
1431 absolutep)))
1432 (cond (zone (stitch (domain-name-labels hostname) t))
1433 (name (stitch name nil))
1434 (t "@")))))
1435
1436 (export 'bind-output-hostname)
1437 (defun bind-output-hostname (hostname)
1438 (let ((name (bind-hostname hostname)))
1439 (cond ((and *bind-last-record-name*
1440 (string= name *bind-last-record-name*))
1441 "")
1442 (t
1443 (setf *bind-last-record-name* name)
1444 name))))
1445
1446 (defmethod zone-write :around ((format (eql :bind)) zone stream)
1447 (declare (ignorable zone stream))
1448 (let ((*bind-last-record-name* nil))
1449 (call-next-method)))
1450
1451 (defmethod zone-write-header ((format (eql :bind)) zone)
1452 (format *zone-output-stream* "~
1453 ;;; Zone file `~(~A~)'
1454 ;;; (generated ~A)
1455
1456 $ORIGIN ~0@*~(~A.~)
1457 $TTL ~2@*~D~2%"
1458 (zone-name zone)
1459 (iso-date :now :datep t :timep t)
1460 (zone-default-ttl zone))
1461 (let* ((soa (zone-soa zone))
1462 (admin (let* ((name (soa-admin soa))
1463 (at (position #\@ name))
1464 (copy (format nil "~(~A~)." name)))
1465 (when at
1466 (setf (char copy at) #\.))
1467 copy)))
1468 (format *zone-output-stream* "~
1469 ~A~30TIN SOA~40T~A (
1470 ~55@A~60T ;administrator
1471 ~45T~10D~60T ;serial
1472 ~45T~10D~60T ;refresh
1473 ~45T~10D~60T ;retry
1474 ~45T~10D~60T ;expire
1475 ~45T~10D )~60T ;min-ttl~2%"
1476 (bind-output-hostname (zone-name zone))
1477 (bind-hostname (soa-source soa))
1478 admin
1479 (soa-serial soa)
1480 (soa-refresh soa)
1481 (soa-retry soa)
1482 (soa-expire soa)
1483 (soa-min-ttl soa))))
1484
1485 (export 'bind-format-record)
1486 (defun bind-format-record (zr format &rest args)
1487 (format *zone-output-stream*
1488 "~A~20T~@[~8D~]~30TIN ~A~40T~?"
1489 (bind-output-hostname (zr-name zr))
1490 (let ((ttl (zr-ttl zr)))
1491 (and (/= ttl (zone-default-ttl *writing-zone*))
1492 ttl))
1493 (string-upcase (symbol-name (zr-type zr)))
1494 format args))
1495
1496 (export 'bind-write-hex)
1497 (defun bind-write-hex (vector remain)
1498 "Output the VECTOR as hex, in Bind format.
1499
1500 If the length (in bytes) is less than REMAIN then it's placed on the
1501 current line; otherwise the Bind line-continuation syntax is used."
1502 (flet ((output-octet (octet)
1503 (format *zone-output-stream* "~(~2,'0X~)" octet)))
1504 (let ((len (length vector)))
1505 (cond ((< len remain)
1506 (dotimes (i len) (output-octet (aref vector i)))
1507 (terpri *zone-output-stream*))
1508 (t
1509 (format *zone-output-stream* "(")
1510 (let ((i 0))
1511 (loop
1512 (when (>= i len) (return))
1513 (let ((limit (min len (+ i 64))))
1514 (format *zone-output-stream* "~%~8T")
1515 (loop
1516 (when (>= i limit) (return))
1517 (output-octet (aref vector i))
1518 (incf i)))))
1519 (format *zone-output-stream* " )~%"))))))
1520
1521 (defmethod zone-write-raw-rrdata ((format (eql :bind)) zr type data)
1522 (format *zone-output-stream*
1523 "~A~20T~@[~8D~]~30TIN TYPE~A~40T\\# ~A "
1524 (bind-output-hostname (zr-name zr))
1525 (let ((ttl (zr-ttl zr)))
1526 (and (/= ttl (zone-default-ttl *writing-zone*))
1527 ttl))
1528 type
1529 (length data))
1530 (bind-write-hex data 12))
1531
1532 (defmethod zone-write-record ((format (eql :bind)) (type (eql :a)) zr)
1533 (bind-format-record zr "~A~%" (ipaddr-string (zr-data zr))))
1534
1535 (defmethod zone-write-record ((format (eql :bind)) (type (eql :aaaa)) zr)
1536 (bind-format-record zr "~A~%" (ipaddr-string (zr-data zr))))
1537
1538 (defmethod zone-write-record ((format (eql :bind)) (type (eql :ptr)) zr)
1539 (bind-format-record zr "~A~%" (bind-hostname (zr-data zr))))
1540
1541 (defmethod zone-write-record ((format (eql :bind)) (type (eql :cname)) zr)
1542 (bind-format-record zr "~A~%" (bind-hostname (zr-data zr))))
1543
1544 (defmethod zone-write-record ((format (eql :bind)) (type (eql :ns)) zr)
1545 (bind-format-record zr "~A~%" (bind-hostname (zr-data zr))))
1546
1547 (defmethod zone-write-record ((format (eql :bind)) (type (eql :mx)) zr)
1548 (bind-format-record zr "~2D ~A~%"
1549 (cdr (zr-data zr))
1550 (bind-hostname (car (zr-data zr)))))
1551
1552 (defmethod zone-write-record ((format (eql :bind)) (type (eql :srv)) zr)
1553 (destructuring-bind (prio weight port host) (zr-data zr)
1554 (bind-format-record zr "~2D ~5D ~5D ~A~%"
1555 prio weight port (bind-hostname host))))
1556
1557 (defmethod zone-write-record ((format (eql :bind)) (type (eql :sshfp)) zr)
1558 (bind-format-record zr "~{~2D ~2D ~A~}~%" (zr-data zr)))
1559
1560 (defmethod zone-write-record ((format (eql :bind)) (type (eql :tlsa)) zr)
1561 (destructuring-bind (usage selector match data) (zr-data zr)
1562 (bind-format-record zr "~2D ~2D ~2D " usage selector match)
1563 (bind-write-hex data 12)))
1564
1565 (defmethod zone-write-record ((format (eql :bind)) (type (eql :txt)) zr)
1566 (bind-format-record zr "~{~#[\"\"~;~S~:;(~@{~%~8T~S~} )~]~}~%"
1567 (zr-data zr)))
1568
1569 ;;;--------------------------------------------------------------------------
1570 ;;; tinydns-data output format.
1571
1572 (export 'tinydns-output)
1573 (defun tinydns-output (code &rest fields)
1574 (format *zone-output-stream* "~C~{~@[~A~]~^:~}~%" code fields))
1575
1576 (defmethod zone-write-raw-rrdata ((format (eql :tinydns)) zr type data)
1577 (tinydns-output #\: (zr-name zr) type
1578 (with-output-to-string (out)
1579 (dotimes (i (length data))
1580 (let ((byte (aref data i)))
1581 (if (or (<= byte 32)
1582 (>= byte 127)
1583 (member byte '(#\: #\\) :key #'char-code))
1584 (format out "\\~3,'0O" byte)
1585 (write-char (code-char byte) out)))))
1586 (zr-ttl zr)))
1587
1588 (defmethod zone-write-record ((format (eql :tinydns)) (type (eql :a)) zr)
1589 (tinydns-output #\+ (zr-name zr)
1590 (ipaddr-string (zr-data zr)) (zr-ttl zr)))
1591
1592 (defmethod zone-write-record ((format (eql :tinydns)) (type (eql :aaaa)) zr)
1593 (tinydns-output #\3 (zr-name zr)
1594 (format nil "~(~32,'0X~)" (ipaddr-addr (zr-data zr)))
1595 (zr-ttl zr)))
1596
1597 (defmethod zone-write-record ((format (eql :tinydns)) (type (eql :ptr)) zr)
1598 (tinydns-output #\^ (zr-name zr) (zr-data zr) (zr-ttl zr)))
1599
1600 (defmethod zone-write-record ((format (eql :tinydns)) (type (eql :cname)) zr)
1601 (tinydns-output #\C (zr-name zr) (zr-data zr) (zr-ttl zr)))
1602
1603 (defmethod zone-write-record ((format (eql :tinydns)) (type (eql :ns)) zr)
1604 (tinydns-output #\& (zr-name zr) nil (zr-data zr) (zr-ttl zr)))
1605
1606 (defmethod zone-write-record ((format (eql :tinydns)) (type (eql :mx)) zr)
1607 (let ((name (car (zr-data zr)))
1608 (prio (cdr (zr-data zr))))
1609 (tinydns-output #\@ (zr-name zr) nil name prio (zr-ttl zr))))
1610
1611 (defmethod zone-write-header ((format (eql :tinydns)) zone)
1612 (format *zone-output-stream* "~
1613 ### Zone file `~(~A~)'
1614 ### (generated ~A)
1615 ~%"
1616 (zone-name zone)
1617 (iso-date :now :datep t :timep t))
1618 (let ((soa (zone-soa zone)))
1619 (tinydns-output #\Z
1620 (zone-name zone)
1621 (soa-source soa)
1622 (let* ((name (copy-seq (soa-admin soa)))
1623 (at (position #\@ name)))
1624 (when at (setf (char name at) #\.))
1625 name)
1626 (soa-serial soa)
1627 (soa-refresh soa)
1628 (soa-expire soa)
1629 (soa-min-ttl soa)
1630 (zone-default-ttl zone))))
1631
1632 ;;;----- That's all, folks --------------------------------------------------