Blame
Date:
Mon Jan 11 09:00:47 2021 UTC
Message:
a usleep makes it unnecessary slow, I guess it forces a context switch...
001
2018-06-19
pjp
.\" In parts copyright (template) by:
002
2018-06-19
pjp
.\"
003
2018-06-19
pjp
.\" $OpenBSD: vmctl.8,v 1.39 2018/02/24 13:14:09 jmc Exp $
004
2018-06-19
pjp
.\"
005
2021-01-06
pjp
.\" Copyright (c) 2018-2021 Peter J. Philipp
006
2018-06-19
pjp
.\" Copyright (c) 2015 Mike Larkin <mlarkin@openbsd.org>
007
2018-06-19
pjp
.\"
008
2018-06-19
pjp
.\" Permission to use, copy, modify, and distribute this software for any
009
2018-06-19
pjp
.\" purpose with or without fee is hereby granted, provided that the above
010
2018-06-19
pjp
.\" copyright notice and this permission notice appear in all copies.
011
2018-06-19
pjp
.\"
012
2018-06-19
pjp
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
013
2018-06-19
pjp
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
014
2018-06-19
pjp
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
015
2018-06-19
pjp
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
016
2018-06-19
pjp
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
017
2018-06-19
pjp
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
018
2018-06-19
pjp
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
019
2018-06-19
pjp
.\"
020
2021-01-06
pjp
.Dd $Mdocdate: January 6 2021 $
021
2018-06-19
pjp
.Dt DDDCTL 8
022
2018-06-19
pjp
.Os
023
2018-06-19
pjp
.Sh NAME
024
2018-06-19
pjp
.Nm dddctl
025
2018-06-19
pjp
.Nd control and manage delphinusdnsd
026
2018-06-19
pjp
.Sh SYNOPSIS
027
2018-06-19
pjp
.Nm
028
2018-06-19
pjp
.Ar command
029
2018-06-19
pjp
.Op Ar arg ...
030
2018-06-19
pjp
.Sh DESCRIPTION
031
2018-06-19
pjp
The
032
2018-06-19
pjp
.Nm
033
2018-06-19
pjp
utility is used to control, manage and sign delphinusdnsd (zone files)
034
2018-06-19
pjp
.Pp
035
2018-06-19
pjp
The commands are as follows:
036
2018-06-19
pjp
.Bl -tag -width Ds
037
2018-06-19
pjp
.It Cm bindfile Ar zonename zonefile
038
2018-06-19
pjp
Convert a
039
2018-06-19
pjp
.Xr delphinusdns.conf 5
040
2018-06-19
pjp
zonefile to BIND format with the specified zonename domain name.
041
2019-11-07
pjp
.It Xo Cm configtest
042
2019-11-14
pjp
.Op Fl cn
043
2019-11-07
pjp
.Op Ar configfile
044
2019-11-07
pjp
.Xc
045
2018-06-19
pjp
Test the entire config, alternatively you can test a
046
2018-06-19
pjp
.Xr delphinusdns.conf 5
047
2019-11-07
pjp
config file by specifying such a file. In case of configured rzones, when
048
2020-09-25
pjp
there is no .repl file in /var/delphinusdnsd/replicant/ it will pull the
049
2019-11-14
pjp
replicant file via a socket, unless the
050
2019-11-14
pjp
.Op Fl n
051
2019-11-14
pjp
flag has been specified.
052
2018-06-19
pjp
.It Cm help Ar [command]
053
2018-06-19
pjp
provides an in-binary help. Alternatively you can specify a subcommand
054
2018-06-19
pjp
to provide help for. Ie.
055
2018-06-19
pjp
.Nm
056
2018-06-19
pjp
help sign.
057
2019-12-27
pjp
.It Xo Cm query
058
2019-12-27
pjp
.Op Fl DITZ
059
2019-12-27
pjp
.Op Fl @ Ar server
060
2019-12-27
pjp
.Op Fl P Ar port
061
2019-12-27
pjp
.Op Fl p Ar file
062
2019-12-27
pjp
.Op Fl Q Ar server
063
2019-12-27
pjp
.Op Fl y Ar keyname:password
064
2019-12-27
pjp
.Xc
065
2019-12-27
pjp
performs rudamentary query operations on a DNS server.
066
2019-12-27
pjp
.Bl -tag -width "-I iterations"
067
2019-12-27
pjp
.It Fl D
068
2019-12-27
pjp
use the DO bit, to get DNSSEC answers.
069
2019-12-27
pjp
.It Fl I
070
2019-12-27
pjp
indent output.
071
2019-12-27
pjp
.It Fl T
072
2019-12-27
pjp
use TCP instead of UDP.
073
2019-12-27
pjp
.It Fl Z
074
2019-12-27
pjp
output in delphinusdnsd zonefile format.
075
2019-12-27
pjp
.It Fl @ Ar server
076
2019-12-27
pjp
queries the specified server (in IPv4 IP).
077
2019-12-27
pjp
.It Fl P Ar port
078
2019-12-27
pjp
query on the specified port.
079
2019-12-27
pjp
.It Fl p Ar file
080
2019-12-27
pjp
output/pipe to the specified file.
081
2019-12-27
pjp
.It Fl Q Ar server
082
2019-12-27
pjp
queries the specified server (is synonymous with -@).
083
2019-12-27
pjp
.It Fl y Ar keyname:password
084
2019-12-27
pjp
Use a TSIG keyname and password. The keyname is plaintext in a DNS name format
085
2019-12-27
pjp
, the password is in BASE64. This differs from dig in that the leading HMAC
086
2019-12-27
pjp
type is omitted because it's always type 'hmac-sha256'.
087
2019-12-27
pjp
.El
088
2018-06-19
pjp
.It Xo Cm sign
089
2019-10-08
pjp
.Op Fl KXZ
090
2018-06-19
pjp
.Op Fl a Ar algorithm
091
2018-06-19
pjp
.Op Fl B Ar bits
092
2018-06-19
pjp
.Op Fl e Ar seconds
093
2018-06-19
pjp
.Op Fl I Ar iterations
094
2018-06-19
pjp
.Op Fl i Ar inputfile
095
2018-06-19
pjp
.Op Fl k Ar KSK
096
2018-06-19
pjp
.Op Fl m Ar mask
097
2018-06-19
pjp
.Op Fl n Ar zonename
098
2018-06-19
pjp
.Op Fl o Ar output
099
2020-03-06
pjp
.Op Fl R Ar keyword
100
2018-06-19
pjp
.Op Fl S Ar pid
101
2018-06-19
pjp
.Op Fl s Ar salt
102
2018-06-19
pjp
.Op Fl t Ar ttl
103
2019-10-08
pjp
.Op Fl x Ar serial
104
2018-06-19
pjp
.Op Fl z Ar ZSK
105
2018-06-19
pjp
.Xc
106
2018-06-19
pjp
performs signing operations on a zonefile for DNSSEC operations.
107
2018-06-19
pjp
.Bl -tag -width "-I iterations"
108
2018-06-19
pjp
.It Fl K
109
2018-06-19
pjp
create a new KSK key.
110
2019-10-08
pjp
.It Fl X
111
2019-10-08
pjp
update serial to YYYYMMDD01.
112
2018-06-19
pjp
.It Fl Z
113
2018-06-19
pjp
create a new ZSK key.
114
2018-06-19
pjp
.It Fl a Ar algorithm
115
2018-06-19
pjp
use algorithm (integer).
116
2018-06-19
pjp
.It Fl B Ar bits
117
2018-06-19
pjp
use number of bits (integer).
118
2018-06-19
pjp
.It Fl e Ar seconds
119
2018-06-19
pjp
expiry in seconds.
120
2018-06-19
pjp
.It Fl I Ar iterations
121
2018-06-19
pjp
use (integer) NSEC3 iterations.
122
2018-06-19
pjp
.It Fl i Ar inputfile
123
2018-06-19
pjp
use the inputfile of unsigned zone.
124
2018-06-19
pjp
.It Fl k Ar KSK
125
2018-06-19
pjp
use provided KSK key-signing keyname.
126
2018-06-19
pjp
.It Fl m Ar mask
127
2018-06-19
pjp
run the following masked functions (used for debug).
128
2018-06-19
pjp
.It Fl n Ar zonename
129
2018-06-19
pjp
run for zonename zone.
130
2018-06-19
pjp
.It Fl o Ar output
131
2018-06-19
pjp
output to file, may be '-' for stdout.
132
2020-03-06
pjp
.It Fl R Ar keyword
133
2020-03-06
pjp
chooses a roll-over method. Current keywords are 'prep' and 'double' for
134
2020-03-06
pjp
Pre Publication Rollover Method or Double-Signature Rollover method
135
2020-03-06
pjp
respectively. Default is 'prep'.
136
2018-06-19
pjp
.It Fl S Ar pid
137
2018-06-19
pjp
sign with this pid ('KSK' or 'ZSK' if used in conjunction with [-ZK]).
138
2018-06-19
pjp
.It Fl s Ar salt
139
2018-06-19
pjp
salt for NSEC3 (in hexadecimal).
140
2018-06-19
pjp
.It Fl t Ar ttl
141
2018-06-19
pjp
time-to-live for DNSKEY's.
142
2019-10-08
pjp
.It Fl x Ar serial
143
2019-10-08
pjp
update serial in SOA to serial.
144
2018-06-19
pjp
.It Fl z Ar ZSK
145
2018-06-19
pjp
use provided ZSK zone-signing keyname.
146
2018-06-19
pjp
.El
147
2018-06-19
pjp
.It Cm sshfp Ar hostname [-k keyfile] [-t ttl]
148
2018-06-19
pjp
produces an SSHFP output on stdout in
149
2018-06-19
pjp
.Xr delphinusdnsd 8
150
2018-06-19
pjp
format.
151
2021-01-06
pjp
.It Cm start Ar [-f configfile] [-I identstring] [-s path]
152
2018-06-19
pjp
starts
153
2018-06-19
pjp
.Xr delphinusdnsd 8
154
2019-01-29
pjp
with an optional configfile and control socket path.
155
2021-01-06
pjp
.It Cm stop Ar [-I identstring] [-s path]
156
2019-01-29
pjp
stops delphinusdnsd with optional control socket path.
157
2021-01-06
pjp
.It Cm restart Ar [-I identstring] [-s path]
158
2019-01-29
pjp
restarts delphinusdnsd with optional control socket path.
159
2019-11-07
pjp
.Sh EXAMPLES
160
2020-10-09
pjp
To create a ZSK and a KSK key the first time one may do:
161
2020-10-09
pjp
.Pp
162
2020-10-09
pjp
dddctl sign -Z -K -n delphinusdns.org
163
2020-10-09
pjp
.Pp
164
2019-11-07
pjp
To sign a delphinusdns zone the first time one may do:
165
2019-11-07
pjp
.Pp
166
2019-11-07
pjp
dddctl sign -Z -K -a 13 -B 2048 -n delphinusdns.org -i delphinusdns.org.zone -o delphinusdns.org.zone.signed
167
2019-11-07
pjp
.Pp
168
2019-11-07
pjp
Please see the https://delphinusdns.org website for more examples.
169
2018-06-19
pjp
.Sh SEE ALSO
170
2018-06-19
pjp
.Xr delphinusdnsd 8
171
2018-06-19
pjp
.Xr delphinusdns.conf 5
172
2019-11-07
pjp
.Sh FILES
173
2020-09-25
pjp
.Bl -tag -width /var/delphinusdnsd/etc/delphinusdns.conf -compact
174
2020-09-25
pjp
.It Pa /var/delphinusdnsd/etc/delphinusdns.conf
175
2019-11-19
pjp
default configfile
176
2020-09-25
pjp
.It Pa /var/delphinusdnsd/replicant/
177
2019-11-19
pjp
replicant zone files pulled via AXFR
178
2019-11-07
pjp
.It Pa /var/run/delphinusdnsd.sock
179
2019-11-07
pjp
default
180
2019-11-07
pjp
.Nm
181
2019-11-07
pjp
control socket
182
2019-11-19
pjp
.El
183
2019-12-06
pjp
.Sh BUGS
184
2019-12-06
pjp
On Linux, with a replicant zone set up in the configfile, a
185
2019-12-06
pjp
.Nm
186
2019-12-06
pjp
configtest will error out (at least on the Raspberry Pi), the first time.
187
2019-12-06
pjp
Subsequent configtests should state OK, so check for this. I haven't found
188
2019-12-27
pjp
the bug for this yet. Another bug is that dddctl query will not sanitize
189
2019-12-27
pjp
input from the net. This could be used to change characteristics of the
190
2019-12-27
pjp
terminal with means of escape codes.
191
2018-06-19
pjp
.Sh AUTHORS
192
2018-06-19
pjp
.An -nosplit
193
2018-06-19
pjp
.An Peter J. Philipp Aq Mt petphi@delphinusdns.org
repomaster@centroid.eu