[hcoop/zz_old/debian/djbdns.git] / debian / djbdns-man / rbldns-data.8

.TH rbldns-data 8

.SH NAME
rbldns-data \- data tool for rbldns

.SH DESCRIPTION
.B rbldns-data
reads an IP address list
from a file named 
.I data
in the current directory.
It creates 
.I data.cdb
in a binary format designed for
fast access by 
.BR rbldns (8).
It may also create some other files
with names beginning with 
.IR data .

.B rbldns-data
updates 
.I data.cdb
atomically,
so you can use it safely while 
.BR rbldns (8)
is running.
If anything goes wrong with the creation of 
.IR data.cdb ,
.B rbldns-data
stops and leaves the old 
.I data.cdb
in place.

.SH Data format

.I ip

The IP address 
.I ip
is on the list.

.I ip\fR/\fIn

All IP addresses that share the first 
.I n
bits
of the IP address 
.I ip
are on the list.
For example, 
.I 1.2.3.0/24
means all 
.I 1.2.3.*
addresses.
.I n
must be at least 8,
and all bits past the 
.IR n th
in 
.I ip
must be 0.

.RI : a\fR:\fItxt\fR

DNS queries for addresses on the list
will receive an A record of 
.I a
and a TXT record of 
.IR txt .
Typically 
.I a
is 
.I 127.0.0.2
and 
.I txt
is a pointer to a web page about the list.

If 
.I txt
ends with 
.IR $ ,
.BR rbldns (8)
replaces the 
.I $
with the IP address.

.RI # comment

Comment line. The line is ignored.

.SH SEE ALSO
rbldns(8)

http://cr.yp.to/djbdns.html
Commit	Line	Data
b4588d5c GP	1	.TH rbldns-data 8
	2
	3	.SH NAME
	4	rbldns-data \- data tool for rbldns
	5
	6	.SH DESCRIPTION
	7	.B rbldns-data
	8	reads an IP address list
	9	from a file named
	10	.I data
	11	in the current directory.
	12	It creates
	13	.I data.cdb
	14	in a binary format designed for
	15	fast access by
	16	.BR rbldns (8).
	17	It may also create some other files
	18	with names beginning with
	19	.IR data .
	20
	21	.B rbldns-data
	22	updates
	23	.I data.cdb
	24	atomically,
	25	so you can use it safely while
	26	.BR rbldns (8)
	27	is running.
	28	If anything goes wrong with the creation of
	29	.IR data.cdb ,
	30	.B rbldns-data
	31	stops and leaves the old
	32	.I data.cdb
	33	in place.
	34
	35	.SH Data format
	36
	37	.I ip
	38
	39	The IP address
	40	.I ip
	41	is on the list.
	42
	43	.I ip\fR/\fIn
	44
	45	All IP addresses that share the first
	46	.I n
	47	bits
	48	of the IP address
	49	.I ip
	50	are on the list.
	51	For example,
	52	.I 1.2.3.0/24
	53	means all
	54	.I 1.2.3.*
	55	addresses.
	56	.I n
	57	must be at least 8,
	58	and all bits past the
	59	.IR n th
	60	in
	61	.I ip
	62	must be 0.
	63
	64	.RI : a\fR:\fItxt\fR
65
66	DNS queries for addresses on the list
67	will receive an A record of
68	.I a
69	and a TXT record of
70	.IR txt .
71	Typically
72	.I a
73	is
74	.I 127.0.0.2
75	and
76	.I txt
77	is a pointer to a web page about the list.
78
79	If
80	.I txt
81	ends with
82	.IR $ ,
83	.BR rbldns (8)
84	replaces the
85	.I $
86	with the IP address.
87
88	.RI # comment
89
90	Comment line. The line is ignored.
91
92	.SH SEE ALSO
93	rbldns(8)
94
95	http://cr.yp.to/djbdns.html