1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
.TH tinydyndns-data 8
.SH NAME
tinydyndns-data \- add or remove TYPE A record to or from data.cdb
.SH SYNOPSIS
.B tinydyndns-data
add|remove
.I fqdns
.SH DESCRIPTION
.I fqdns
consists of one or more argument, each specifying a fully qualified domain
name (fqdn).
.P
.B tinydyndns-data
adds a TYPE A record to or removes it from data.cdb in the current directory.
Other than
.BR tinydns-data (8),
.B tinydyndns-data
does not know about the source file data but changes the binary database
data.cdb directly.
.P
.B tinydyndns-data
reads data.cdb and copies its data to data.tmp.
While reading the records,
.B tinydyndns-data
checks for each
.I fqdn
in
.I fqdns
if this hostname has a TYPE A record in data.cdb, drops the record when
called with the option
.IR remove ,
or refuses to add the record when called with the option
.IR add .
.P
When called with the option
.IR add ,
.B tinydyndns-data
then adds all new
.IR fqdn s
to data.tmp.
The data of the newly created records can optionally be controlled through
the environment, see below.
Finally
.B tinydyndns-data
renames data.tmp to data.cdb.
.SH OPTIONS
.TP
add
For each
.I fqdn
in
.IR fqdns ,
add a TYPE A record for
.I fqdn
to data.cdb with the default IP address (127.14.14.14).
.TP
remove
For each
.I fqdn
in
.IR fqdns ,
remove all TYPE A records for
.I fqdn
from data.cdb.
.SH ENVIRONMENT
.TP
.I IP
The environment variable
.I IP
overrides the default IP address (``127.14.14.14'') for newly created records.
.I $IP
must be a valid IP address.
.TP
.I TTL
time-to-live.
The environment variable
.I TTL
overrides the default time-to-live in seconds (0 if
.I TTD
is set, otherwise 5).
.I $TTL
must be an integer.
.TP
.I TTD
time-to-die.
.I $TTD
must be an integer, specifying a number of seconds.
If
.I TTD
is set, the timestamp of newly created records is set to the current time plus
.I $TTD
seconds, and
.I TTL
is set to zero by default, so that
.BR tinydns (8)
interprets the timestamp as time-to-die.
Note: you probably want to adjust SOA ttl, or create a wildcard record, to
prevent DNS caches from caching nxdomain, when using this feature.
.TP
.I LOC
location.
.I $LOC
must be two characters long.
If
.I LOC
is set, it specifies the client location for newly created records.
.SH EXIT CODES
.B tinydyndns-data
exits 111 if anything goes wrong and leaves data.cdb unchanged.
.P
.B tinydyndns-data
exits 0 if all
.I fqdns
were processed and the new data.cdb was written.
.P
For each
.I fqdn
in
.I fqdns
that
.B tinydyndns-data
was not able to remove or add (e.g., not there, or already there), it
increases the exit code by one and exits non-zero (maximum is 100).
.SH FILES
./data.cdb
./data.tmp
.SH SEE ALSO
tinydyndns-update(8),
tinydyndns-conf(8)
.P
http://smarden.org/tinydyndns/
.SH AUTHOR
Gerrit Pape <pape@smarden.org>
|
