Standards, Environments, and Macros                qmail-spamt(5)



NNNNAAAAMMMMEEEE
     qmail-spamt - assign spam throttle parameters to IP blocks

OOOOVVVVEEEERRRRVVVVIIIIEEEEWWWW
     The  file  ////vvvvaaaarrrr////qqqqmmmmaaaaiiiillll////ccccoooonnnnttttrrrroooollll////ssssppppaaaammmmtttt  assigns  spam  throttle
     parameters to IP blocks. For example,

        192.168.0.0/24:private:2000:120000::::::

     says that mail originating from IP block 111199992222....111166668888....0000....0000////22224444 will
     use  ////vvvvaaaarrrr////qqqqmmmmaaaaiiiillll////ssssppppaaaammmm////pppprrrriiiivvvvaaaatttteeee as the spam throttle directory,
     with a spam throttle delay of 2000 and a spam throttle  max-
     imum delay of 120000 (both in milliseconds).  All other spam
     throttle parameters are unaffected.  To define  the  default
     spam    throttle    parameters,    define    an   entry   in
     ////vvvvaaaarrrr////qqqqmmmmaaaaiiiillll////ccccoooonnnnttttrrrroooollll////ssssppppaaaammmmtttt with an empty IP block.

     Assignments fed to qqqqmmmmaaaaiiiillll----nnnneeeewwwwsssstttt will be used  by  qqqqmmmmaaaaiiiillll----ssssmmmmttttppppdddd
     to  control  spam throttling.  See qqqqmmmmaaaaiiiillll----nnnneeeewwwwsssstttt(8).  A change
     to  ////vvvvaaaarrrr////qqqqmmmmaaaaiiiillll////ccccoooonnnnttttrrrroooollll////ssssppppaaaammmmtttt  will  have  no  effect   until
     qqqqmmmmaaaaiiiillll----nnnneeeewwwwsssstttt is run.

SSSSTTTTRRRRUUUUCCCCTTTTUUUURRRREEEE
     ////vvvvaaaarrrr////qqqqmmmmaaaaiiiillll////ccccoooonnnnttttrrrroooollll////ssssppppaaaammmmtttt is a series of assignments, one per
     line.   It  ends with a line containing a single dot.  Lines
     must not contain NUL.

AAAASSSSSSSSIIIIGGGGNNNNMMMMEEEENNNNTTTTSSSS
     A simple assignment is a line of the form

        ipblock:dir:st:stmax:flush:rcpt:tg:tg_resp:

     Here _i_p_b_l_o_c_k is an IP block  (format  [_a._b._c._d][/_n]]);  _d_i_r,
     _s_t,  _s_t_m_a_x, _f_l_u_s_h, _r_c_p_t, _t_g, and _t_g__r_e_s_p are the spam throt-
     tle parameters for directory (relative  path),  delay  (ms),
     maximum  delay  (ms),  post-DATA  flush,  reasonable receipt
     count, teergrube periodicity (s),  and  teergrube  response.
     Real-time   values   for   _i_p_b_l_o_c_k   will   be   stored   in
     ////vvvvaaaarrrr////qqqqmmmmaaaaiiiillll////ssssppppaaaammmm////_d_i_r.  See qqqqmmmmaaaaiiiillll----ssssppppaaaammmmtttthhhhrrrroooottttttttlllleeee(9).

     If there are  several  assignments  for  the  same  _i_p_b_l_o_c_k,
     qqqqmmmmaaaaiiiillll----ssssmmmmttttppppdddd will use the first one.

     If an entry exists with an empty _i_p_b_l_o_c_k, it is always  used
     to define default (initial) values.

     If several, distinct _i_p_b_l_o_c_ks match a given IP  address,  as
     specified  by  environment  variable  TTTTCCCCPPPPRRRREEEEMMMMOOOOTTTTEEEEIIIIPPPP,  the most
     specific (smallest network block) entry is used.

     If, after applying all applicable rules, _d_i_r is empty,  then
     it  will  be  set  to  _a/_b/_c/_d, where _a, _b, _c, and _d are the



SunOS 5.11                Last change:                          1






Standards, Environments, and Macros                qmail-spamt(5)



     first four octets (in decimal) for the  remote  IP  address,
     _a._b._c._d.

     If _d_i_r starts with a slash (////), then it will be used to gen-
     erate  an _n-bit masked IP address (format [/_n]) based on the
     remote IP address.  For example, if _d_i_r is set  to  ////11116666  and
     the  remote IP address is 111199992222....111166668888....11110000....3333, then the spam throt-
     tle directory will be 111199992222////111166668888////0000////0000.



EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
        192.168.0.0/24::0::::::
        192.168.0.2:specific:2000::::::
        192.168.1.0/16:testing:10000:::1:2:hold your horses!:
        # empty network ==> default entry
        ::1501:120000::::::

     The IP address 111199992222....111166668888....2222....1111 is handled by  the  fourth  line;
     the IP address 111199992222....111166668888....1111....2222 is handled by the third line; the
     IP address 111199992222....111166668888....0000....2222 is handled by the  second  line;  the
     address 111199992222....111166668888....0000....1111 is handled by the first line.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     qmail-newst(8), qmail-spamthrottle(5)


AAAAUUUUTTTTHHHHOOOORRRR
     Dale Woolridge, James Law, and Moto Kawasaki.   Contact  the
     authors via email: <spamthrottle@qmail.ca>.

























SunOS 5.11                Last change:                          2