.TH SREDIR.CONF 5 2021-01-11

.SH NAME
sredir.conf

.SH DESCRIPTION
Configuration file for rblsredir.

.SS checkaddr
Optional. '\fBcheckaddr on\fR' will lookup IP addresses in hosts.deny.

.SS debug
Optional. '\fBdebug on\fR' will enable debugging. 

.SS redirurl
Mandatory.
Syntax:
.br
\fBredirurl\fR \fIURL\fR
.br
The redirurl is the URL the redirector redirects to.
Usually a link to a small transparent GIF. E.G.;
.br
redirurl http://www.example.org/images/transparant.gif
.br
This won't work for HTTPS: The browser will complain.
The site still gets blocked though.

.SS tolow
Optional. '\fBtolow on\fR' will convert hostnames to lower case.
In case of non-ASCII, UTF-8 is assumed.

.SS dnsbl
Optional.
Syntax;
.br
\fBdnsbl\fR \fImode\fR \fIname\fR
.br
E.G.;
.br
dnsbl 4 blacklist.example.net
.br
\fImode\fR is a value between 1 and 15. It's an OR of;

.TS
allbox;
c c c
l l l.
Mode	Check	Type
1	Check hostname 	 Domain 
2	If alias, check CNAME 	 Domain 
4	Check IP address(es) 	 Address 
8	Log TXT record 	
.TE

Most RBLs list either IP addresses or domains/hostnames. Don't get them mixed up!
Below some Lookup examples;

.TS
allbox;
c c c c
l l l l.
Host or IP	Type	Modes	Lookup
www.example.org	Domain	1-3, 9-11	www.example.org.blacklist.example.net
192.168.2.1	Address	4, 12	1.2.168.192.blacklist.example.net
2001:db8:2::1	Address	4, 12	T{
1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0\%.2.0.0.0.8.b.d.0.1.0.0.2\%.blacklist.example.net
T}
.TE

You can use multiple blacklists
(one entry per line).

.SH COPYRIGHT
GPL.

.SH AUTHOR
Rob van der Putten, rob at sput dot nl

.SH SEE ALSO
.BR rblsredir (8)
.BR sredir_acls (5)
.BR sredir.log (5)
.BR squid (8)