ioHOSTSRULES

[Grendel]

ioHOSTSRULES v1.0
(tested on WinXP/Win2003 only)


Syntax:


.---[HostsRules]----------------------------------------------.
| |
| Usage: SITE HR <opt> [<action> <ip|host> <ipadr|hostname> |
| <class|log> [<connections_per_ip>]] |
| |
| <opt> LIST or L : List complete Hosts.Rules |
| ADD or A : Add a rule |
| DEL or D : Delete a rule |
| |
| <action> ACCEPT or A : ACCEPT rule |
| DENY or D : DENY rule |
| |
| <ip|host> IP or I : define ip-adress |
| HOST or H : define hostname |
| |
| <ipadr|hostname> any ip-adress, ip-range or host |
| |
| <class> in case of IP defines a class |
| (case sensitive) |
| (only necessary for ACCEPT rules) |
| |
| <log> defines a Log-string |
| (only necessary for DENY rules) |
| |
| <connections_per_ip> defines number of connects per ip/host |
| (only necessary for ACCEPT rules) |
| |
| Note: add or delete rules to/from Hosts.Rules |
| |
| Info: if deleting a DENY rule, a log text is not necessary |
| script doesn't check, if ip/host-syntax is correct. |
| |
| List-Examples: |
| ~~~~~~~~~~~~~~ |
| |
| SITE HR L |
| SITE HR LIST |
| |
| Add-Examples: |
| ~~~~~~~~~~~~~ |
| |
| SITE HR ADD ACCEPT I 66.66.66. USER 20 |
| SITE HR ADD A I 66.66.66. USER 20 |
| SITE HR A A I 66.66.66. USER 20 |
| SITE HR ADD DENY I 193.193. "No Access from 193.193." |
| SITE HR A DENY H .aol.com "No Access allowed: .aol.com" |
| SITE HR A D H .aol.com "This range sux ;-) : .aol.com" |
| |
| Delete-Examples: |
| ~~~~~~~~~~~~~~~~ |
| |
| SITE HR DEL A I 66.66.66. USER 20 |
| SITE HR D A I 66.66.66. USER 20 |
| SITE HR D D H .aol.com "This range sux: .aol.com" |
| SITE HR D D H .aol.com |
| |
.----------------------------------------------------[ioHelp]-.


Installation:

1) copy ioHOSTSRULES.exe and ioHOSTSRULES.ini
to ..\scripts\ioHOSTSRULES\

2) configure fullpath to your Hosts.Rules in ioHOSTSRULES.ini

3) add the lines below to ioFTPD.ini


[FTP_Custom_Commands]
hr = EXEC ..\scripts\ioHOSTSRULES\ioHOSTSRULES.exe

[FTP_SITE_Permissions]
hr = M

4) rehash config

Additionally:

5) if you use ioHELP v1.10, copy "hr.site" to your ioHELP\Site dir


Known limitations:

- no syntax check for hostnames/ips
- no add/delete for CLASS or POLICY supported
- it does not sort the rules, adds new one at the end of file

About "REHASH"

so...and before someone tell me something about this matter below...

http://www.inicom.net/pages/en.ioftpd-kb.php

Q: What is the Hosts.Rules file ? How do I configure it ?

Note: You need to restart ioFTPD.exe each time you modify Hosts.Rules. A rehash won't do.

... this KB seems to be incorrect !
a simple rehash is enough (tested out with ioFTPD versions 0.5.85r and above.)


...and now be careful playing around with your Hosts.Rules :D
(i case of problems your will find a .BAK file in .\etc dir ;) )

bugreports and suggestions are welcome...
have fun :)