See CHANGES.tcpserver-limits-patch for changes summary. :::COMPILING::: For MAXLOAD variable to have effect, you have 3 options: (1) By default the patch assumes that you have working getloadavg(3) (most modern UN*Xoids have, including Linux and FreeBSD). No changes are needed to standard ucspi-tcp compilation procedures. (2) If you have Solaris system: - conf-cc needs to be modified to include "-DSOLARIS" - Makefile needs to be modified so that tcpserver links with "-lkstat" (add "-lkstat" to the end of line 748 after "`cat socket.lib`") (3) If you have a non-Solaris system without getloadavg(3), but with readable '/proc/loadavg' (in linux-2.4.x/2.6.x syntax); for example if you're compiling on Linux system with dietlibc: - conf-cc needs to be modified to include "-DNO_GETLOADAVG" :::USING::: This patch (20060126) makes tcpserver from DJB's ucspi-tcp-0.88 package (see http://cr.yp.to/ucspi-tcp.html) to modify its behavior if some environment variables are present. The variables can be preset before starting tcpserver (thus acting as default for all connections), or, if you use 'tcpserver -x xxx.cdb', they can be set (or overridden) from xxx.cdb. If none of the variables are set, tcpserver behaves same as non patched version (except for negligible performance loss). Any or all variables can be set, as soon as first limit is reached the connection is dropped. I'd recommend using .cdb files exclusively though, as you can then modify configuration without killing tcpserver. The variables are: (1) MAXLOAD maximum 1-minute load average * 100. For example, if you have line :allow,MAXLOAD="350" in your rules file from which you created .cdb, the connection will be accepted only if load average is below 3.50 See COMPILING instructions above for info on supported systems. (2) MAXCONNIP maximum connections from one IP address. tcpserver's -c flag defines maximum number of allowed connections, but it can be abused if just one host goes wild and eats all the connections - no other host would be able to connect then. If you created your .cdb with: :allow,MAXCONNIP="5" and run tcpserver -c 50, then each IP address would be able to have at most 5 concurrent connections, while there still could connect 50 clients total. 0 is valid value and means 'always reject' (3) MAXCONNC maximum connections from whole C-class (256 addresses). Extension of MAXCONNIP, as sometimes the problematic client has a whole farm of client machines with different IP addresses instead of just one IP address, and they all try to connect. It might have been more useful to be able to specify CIDR block than C-class, but I've decided to KISS. for example tcpserver -c 200, and .cdb with: :allow,MAXCONNC="15" will allow at most 15 host from any x.y.z.0/24 address block, while still allowing up to 200 total connections. 0 is valid value and means 'always reject' (4) DIEMSG if set and one of the above limits is exceeded, this is the message to be sent to client (CRLF is always added to the text) before terminating connection. If unset, the connection simply terminates (after 1 sec delay) if limit is exceeded. For example: DIEMSG="421 example.com Service temporarily not available, closing transmission channel" (5) DIEMSG_MAXLOAD If set, and a connection is denied because the MAXLOAD limit is exceeded, this value will be used instead of DIEMSG. For example: DIEMSG_MAXLOAD="421 example.com Server busy, try again later." (6) DIEMSG_MAXCONNIP If set, and a connection is denied because the MAXCONNIP limit is exceeded, this value will be used instead of DIEMSG. For example: DIEMSG_MAXCONNIP="421 example.com Too many connections from your IP." (7) DIEMSG_MAXCONNC If set, and a connection is denied because the MAXCONNC limit is exceeded, this value will be used instead of DIEMSG. For example: DIEMSG_MAXCONNC="421 example.com Too many connections from your network." Notes: - if a connection is dropped due to some of those variables set, it will be flagged (if you run tcpserver -v) with "MAXLOAD:", "MAXCONNIP:" or "MAXCONNC:" at the end of the "tcpserver: deny" line. If that bothers you (eg. you have a strict log parsers), don't apply that chunk of the patch. - the idea for this patch came from my previous experience with xinetd, and need to limit incoming bursts of virus/spam SMTP connections, since I was running qmail-scanner to scan incoming and outgoing messages for viruses and spam. When you make changes, please check that they work as expected. Examples (for tcprules created .cdb) (a) 192.168.:allow,MAXLOAD="1000" :allow,MAXCONNIP="3" this would allow any connection from your local LAN (192.168.*.* addresses) if system load is less than 10.00. non-LAN connections would be accepted only if clients from that IP address have not already opened more than 2 connections (as your connection would be last allowed -- 3rd) (b) 192.168.:allow 5.6.7.8:allow,MAXCONNIP="3" 1.2.:allow,MAXLOAD="500",MAXCONNIP="1",MAXCONNC="5" :allow,MAXLOAD="1000",MAXCONNIP="3",DIEMSG="421 example.com unavailable" if client connects from 192.168.*.* (ex: your LAN), it is allowed. if it connects from 5.6.7.8 (ex: little abusive customer of yours), it is allowed unless there are already 3active connections from 5.6.7.8 to this service if it connects from 1.2.*.* (ex: some problematic networks which caused you grief in the past) it will connect only if load is less than 5.0, there is less than 5 active connections from whole C class (1.2.*.0/24), and if that specific IP address does not already have connection open. in all other cases, the client will be permitted to connect if load is less than 10.00 and client has 2 or less connections open. If load is higher than 10.00 or there are 3 or more connections open from this client, the message "421 example.com unavailable" will be returned to the client and connection terminated. Any bugs introduced are ours, do not bother DJB with them. If you find any, or have neat ideas, or better documentation, or whatever, contact me. the 2006-01-26 version of the patch can be found at: http://linux.voyager.hr/ucspi-tcp/ the 2007-12-22 version of the patch can be found at: http://qmail.jms1.net/ucspi-tcp/ Enjoy, Matija Nalis < mnalis-tcpserver _at_ voyager.hr > John Simpson (2007-12-22 version)