Fix incorrect stristr() parameter order
[squirrelmail.git] / plugins / filters / bulkquery / INSTALL
CommitLineData
b1b8988d 1First off, you MUST have BIND 9.x or later compiled and installed. You
2need the lwres libraries and bind libraries (and include files) and you
3will also need lwresd. Once you have it compiled and installed, try running
4lwresd. On solaris I had to use the -i flag to specify where to write
5the pid file, and on linux I didn't. (shrug) Go figure. But you gotta get
6lwresd running before moving on. Don't panic, this is FAR easier to get
7going than a full-blown BIND server (grin).
8
9Building bulkquery
10
11First, edit the Makefile and uncomment out the section of CC, CFLAGS, and
12LDFLAGS settings for your operating system and set DESTDIR to the directory
13you want to install it in.
14
15Then, edit bulkquery.c and edit the MAXTHREADS and DEFTTL values. You probably
16don't need to fiddle with anything else and the defaults for MAXTHREADS and
17DEFTTL should be fine.
18
19MAXTHREADS is the maximum number of threads you will spawn. The more you
20spawn, the harder you will work your DNS server (and the RBLs) and the
21more resources you'll use up on your own machine -- AND the faster the
22queries will complete. If you set this too high your operating system might
23not permit bulkquery to run. The default of 50 works fine on Solaris and
24and Linux.
25
26DEFTTL is the default time to live value. This is sort of a misnomer, since
27the REAL time to live values will be obtained in the replies for queries
28that were found. But for the queries that were NOT found, DEFTTL will be
29used. This is so that the non-existence of an IP in one of the RBLs will be
30cached by the filters plugin for DEFTTL seconds.
31
32After looking at bulkquery.c, just run "make" to compile it. If it compiles
33without errors, you can run "make install" (you may need to be root to
34write to DESTDIR). You can test it with the included sample input file
35bq.in
36
37If all you get back are entries with the default TTL value (ie. 7200), then
38something isn't working. Make sure you have lwresd running. You should also
39make sure the machine you're running it on CAN make DNS queries (grin). So
40check your /etc/resolv.conf file (on UNIX machines anyway). I'll include
41the file bq.out to show what the output of bulkquery looked like at the time
42of this writing (assuming everything was working).