1DONUTSD(1) User Contributed Perl Documentation DONUTSD(1)
2
3
4
6 donutsd - Run the donuts syntax checker periodically and report the
7 results to an administrator
8
10 donutsd [-z FREQ] [-t TMPDIR] [-f FROM] [-s SMTPSERVER] [-a DONUTSARGS]
11 [-x] [-v] [-i zonelistfile] [ZONEFILE ZONENAME ZONECONTACT]
12
14 donutsd runs donuts on a set of zone files every so often (the fre‐
15 quency is specified by the -z flag which defaults to 24 hours) and
16 watches for changes in the results. These changes may be due to the
17 time-sensitive nature of DNSSEC-related records (e.g., RRSIG validity
18 periods) or because parent/child relationships have changed. If any
19 changes have occurred in the output since the last run of donuts on a
20 particular zone file, the results are emailed to the specified zone
21 administrator's email address.
22
24 -v Turns on more verbose output.
25
26 -o Run once and quit, as opposed to sleeping or re-running forever.
27
28 -a ARGUMENTS
29 Passes arguments to command line arguments of donuts runs.
30
31 -z TIME
32 Sleeps TIME seconds between calls to donuts.
33
34 -e ADDRESS
35 Mail ADDRESS with a summary of the results from all the files.
36 These are the last few lines of the donuts output for each zone
37 that details the number of errors found.
38
39 -s SMTPSERVER
40 When sending mail, send it to the SMTPSERVER specified. The
41 default is localhost.
42
43 -f FROMADDR
44 When sending mail, use FROMADDR for the From: address.
45
46 -x Send the diff output in the email message as well as the donuts
47 output.
48
49 -t TMPDIR
50 Store temporary files in TMPDIR.
51
52 -i INPUTZONES
53 See the next section details.
54
56 The rest of the arguments to donutsd should be triplets of the follow‐
57 ing information:
58
59 ZONEFILE
60 The zone file to examine.
61
62 ZONENAME
63 The zonename that file is supposed to be defining.
64
65 ZONECONTACT
66 An email address of the zone administrator (or a comma-separated
67 list of addresses.) The results will be sent to this email
68 address.
69
70 Additionally, instead of listing all the zones you wish to monitor on
71 the command line, you can use the -i flag which specifies a file to be
72 read listing the TRIPLES instead. Each line in this file should con‐
73 tain one triple with white-space separating the arguments.
74
75 Example:
76
77 db.zonefile1.com zone1.com admin@zone1.com
78 db.zonefile2.com zone2.com admin@zone2.com,admin2@zone2.com
79
80 For even more control, you can specify an XML file (whose name must end
81 in .xml) that describes the same information. This also allows for
82 per-zone customization of the donuts arguments. The XML::Smart Perl
83 module must be installed in order to use this feature.
84
85 <donutsd>
86 <zones>
87 <zone>
88 <file>db.example.com</file>
89 <name>example.com</name>
90 <contact>admin@example.com</contact>
91 <!-- this is not a signed zone therefore we'll
92 add these args so we don't display DNSSEC errors -->
93 <donutsargs>-i DNSSEC</donutsargs>
94 </zone>
95 </zones>
96 </donutsd>
97
98 The donutsd tree may also contain a configs section where command-line
99 flags can be specified:
100
101 <donutsd>
102 <configs>
103 <config><flag>a</flag><value>--live --level 8</value></config>
104 <config><flag>e</flag><value>wes@example.com</value></config>
105 </configs>
106 <zones>
107 ...
108 </zones>
109 </donutsd>
110
111 Real command line flags will be used in preference to those specified
112 in the .xml file, however.
113
115 donutsd -a "--live --level 8" -f root@somewhere.com \
116 db.example.com example.com admin@example.com
117
119 Copyright 2005-2007 SPARTA, Inc. All rights reserved. See the COPYING
120 file included with the DNSSEC-Tools package for details.
121
123 Wes Hardaker <hardaker@users.sourceforge.net>
124
126 donuts(8)
127
128 http://dnssec-tools.sourceforge.net
129
130
131
132perl v5.8.8 2007-09-14 DONUTSD(1)