root/src/udns/rblcheck.1

Revision 5a9b91bc0a14543e0995eba973fbeacc05aaee8b, 3.8 kB (checked in by Theo Schlossnagle <jesus@omniti.com>, 6 years ago)

svn merge -r 327:330 https://labs.omniti.com/reconnoiter/branches/dev/udns .

closes #38

  • Property mode set to 100644
Line 
1 .\" $Id: rblcheck.1,v 1.1 2005/04/24 23:14:23 mjt Exp $
2 .\" rblckeck manpage
3 .\"
4 .\" Copyright (C) 2005  Michael Tokarev <mjt@corpit.ru>
5 .\" This file is part of UDNS library, an async DNS stub resolver.
6 .\"
7 .\" This library is free software; you can redistribute it and/or
8 .\" modify it under the terms of the GNU Lesser General Public
9 .\" License as published by the Free Software Foundation; either
10 .\" version 2.1 of the License, or (at your option) any later version.
11 .\"
12 .\" This library is distributed in the hope that it will be useful,
13 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
14 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15 .\" Lesser General Public License for more details.
16 .\"
17 .\" You should have received a copy of the GNU Lesser General Public
18 .\" License along with this library, in file named COPYING.LGPL; if not,
19 .\" write to the Free Software Foundation, Inc., 59 Temple Place,
20 .\" Suite 330, Boston, MA  02111-1307  USA
21
22 .TH rblckeck 1 "Apr 2005" "User Utilities"
23
24 .SH NAME
25 rblckeck \- DNSBL lookup utility
26
27 .SH SYNOPSYS
28 .B rblcheck
29 .RB [\| \-s
30 .IR zone \|]
31 .RB [\| \-S
32 .IR zone\-file \|]
33 .RB [\| \-c \|]
34 .RB [\| \-tmvq \|]
35 .RB [\| \-n
36 .IR nsaddr \|]
37 .IR address \|.\|.\|.
38
39 .SH DESCRIPTION
40 .B rblcheck
41 is a simple command-line to perform DNSBL (DNS-based blocklists) lookups.
42 For every IP address (or a name, in which case it will be resolved to an
43 address first), the utility verifies whenever it is listed in a (list of)
44 DNS blocklists specified with
45 .B \-s
46 or
47 .B \-S
48 options, optionally obtains text assotiated with the listing (usually it
49 is either some description about the reason of the listing or an URL
50 referring to such a description), and displays results on standard output.
51 .PP
52 The program is implemented on top of
53 .BR udns (3)
54 library.
55
56 .SH OPTIONS
57
58 The following options are recognized by
59 .BR rblcheck :
60
61 .TP
62 .B \-s \fIzone\fR
63 add the given \fIzone\fR DNSBL name to the list of active zones.
64 .TP
65 .B \-S \fIzone-file\fR
66 add list of zones from the named \fIzone-file\fR to the list of
67 active zones (the file specifies one zone as the first word on a
68 line, empty lines and lines starting with `#' character are ignored).
69 .TP
70 .B \-c
71 reset active zone list.
72 .TP
73 .B \-v
74 be more verbose, produce more detailed output.
75 .TP
76 .B \-q
77 the opposite for \fB\-v\fR -- produce less detailed output.
78 .TP
79 .B \-t
80 obtain text for listed addresses.
81 .TP
82 .B \-n \fInsaddr\fR
83 Use the given nameserver (given as IPv4 or IPv6 address) instead of the
84 default.  The same effect may be achieved by setting $NSCACHEIP environment
85 variable.
86 .TP
87 .B \-m
88 stop after first hit, ie after the first address which is found to be
89 listed.
90
91 .TP
92 .B \-h
93 print short help and exit.
94
95 .PP
96 If no
97 .BR \-s ,
98 .BR \-S
99 and
100 .B \-c
101 options are given,
102 .B rblcheck
103 will try to obtain list of zones using $RBLCHECK_ZONES environment variable,
104 or ~/.rblcheckrc, or /etc/rblckechrc files, in that order.  If no zones are
105 found, it will exit unsuccessefully.
106
107 .SH "RETURN VALUE"
108 When no addresses given are listed and no errors occured,
109 .B rblcheck
110 exits with code 0.  If at least one address is listed,
111 .B rblcheck
112 returns 100.  In case of DNS errors,
113 .B rblcheck
114 returns 2.
115
116 .SH ENVIRONMENT
117
118 .TP
119 .B $RBLCHECK_ZONES
120 if no
121 .BR \-s ,
122 .B \-S
123 or
124 .B \-c
125 option is given,
126 .B rblcheck
127 tries this variable to obtain list of DNSBL zones to check against.
128
129 .SH FILES
130
131 .TP
132 $HOME/.rblcheckrc and /etc/rblcheckrc
133 if no
134 .BR \-s ,
135 .B \-S
136 or
137 .B \-c
138 option is given, and no $RBLCHECK_ZONES environment variable is set,
139 .B rblcheck
140 will try the two files (the first one that exists) to obtain list of
141 DNSBL zones to check against.
142 Each line specifies one zone (only first word in each line is used).
143 Empty lines and lines starting with `#' character are ignored.
144
145 .SH "SEE ALSO"
146 .BR dnsget (1)
147 .BR resolv.conf (5)
148 .BR udns (3).
149
150 .SH AUTHOR
151 This program and manual pages are written by Michael Tokarev.
Note: See TracBrowser for help on using the browser.