1opendkim-genzone(8) System Manager's Manual opendkim-genzone(8)
2
3
4
6 opendkim-genzone - DKIM public key zone file generation tool
7
9 opendkim-genzone [-C address] [-d domain] [-D] [-E secs] [-F] [-N
10 ns[,...]] [-o file] [-r secs] [-R secs] [-s] [-S] [-t secs] [-T secs]
11 [-u] [-v] [-x conffile] [dataset]
12
14 opendkim-genzone generates a file suitable for use with named(8) to
15 publish a set of public keys.
16
17 The dataset parameter should specify a set of data as described in the
18 opendkim(8) man page. It can currently refer to flat files, Sleepycat
19 databases, comma-separated lists, LDAP directories or SQL databases.
20 The dataset may be omitted if a configuration file (via the -x command
21 line flag) is specified referring to a configuration file that sets a
22 KeyTable parameter, in which case that value will be used.
23
24 The database contents should be formatted as described for the KeyTable
25 parameter, described in the opendkim.conf(5) man page.
26
28 -C contact
29 Uses contact as the contact information to be used when an SOA
30 record is generated (see -S below). If not specified, the
31 userid of the executing user and the local hostname will be
32 used; if the executing user can't be determined, "hostmaster"
33 will be used.
34
35 -d domain
36 Restricts output to those records for which the domain field is
37 the specified domain.
38
39 -D Adds a "._domainkey" suffix to selector names in the zone file.
40
41 -E secs
42 When generating an SOA record (see -S below), use secs as the
43 default record expiration time. The default is 604800.
44
45 -F Adds a "._domainkey" suffix and the domainname to selector names
46 in the zone file.
47
48 -N nslist
49 Specifies a comma-separated list of nameservers, which will be
50 output in NS records before the TXT records. The first name‐
51 server in this list will also be used in the SOA record (if -S
52 is also specified) as the authority hostname.
53
54 -o file
55 Sends output to the named file rather than standard output.
56
57 -r secs
58 When generating an SOA record (see -S below), use secs as the
59 zone refresh time. The default is 10800.
60
61 -R secs
62 When generating an SOA record (see -S below), use secs as the
63 zone retry time. The default is 1800.
64
65 -s Extends the logic of "-d" to include subdomains.
66
67 -S Asks for an SOA record to be generated at the top of the output.
68 The content of this output can be controlled using the -E, -r,
69 -R, -T options. The serial number will be generated based on
70 the current time of day.
71
72 -t ttl Puts a TTL (time-to-live) value of ttl on all records output.
73 The units are in seconds.
74
75 -T secs
76 When generating an SOA record (see -S below), use secs as the
77 default record TTL time. The default is 86400.
78
79 -u Produce output suitable for use as input to nsupdate(8).
80
81 -v Increases the verbosity of debugging output written to standard
82 error.
83
84 -x conffile
85 Names an opendkim.conf(5) file to be read for LDAP-specific
86 parameters when an LDAP dataset is given on the command line.
87 Not required for other dataset types. The default is
88 /etc/opendkim.conf.
89
91 This man page covers the version of opendkim-genzone that shipped with
92 version 2.11.0 of OpenDKIM.
93
95 Copyright (c) 2010, 2012, 2014, 2015, The Trusted Domain Project. All
96 rights reserved.
97
99 nsupdate(8), opendkim(8), opendkim.conf(5)
100
101
102
103 The Trusted Domain Project opendkim-genzone(8)