Return to README CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / ipguard / doc

Annotation of embedaddon/ipguard/doc/README, revision 1.1.1.1

1.1       misho       1: ##  ipguard
                      2: 
                      3:     ipguard v1.04
                      4:     Copyright (c) 2010 SeaD <sead at deep.perm.ru>
                      5: 
                      6:     See COPYRIGHT for copying info
                      7: 
                      8: ##  what is ipguard
                      9: 
                     10:     ipguard - tool designed to protect Ethernet LAN IP address space
                     11:     by ARP spoofing.
                     12: 
                     13:     ipguard listens network for ARP packets. All permitted MAC-IP pairs
                     14:     listed in 'ethers' file. If it recieves one with MAC-IP pair, which is
                     15:     not listed in 'ethers' file, it will send ARP reply with configured
                     16:     fake address. This will prevent not permitted host to work properly
                     17:     in local ethernet segment.
                     18: 
                     19: 
                     20: ##  installation
                     21: 
                     22:     NOTE: libnet 1.0 and libnet 1.1 has totally incompatible API
                     23:           so there are no more support for libnet 1.0. Sorry.
                     24: 
                     25:     Use *BSD ports(7):
                     26:     # cd /usr/ports/security/ipguard && make install clean
                     27: 
                     28:     or
                     29: 
                     30:     Download from: http://ipguard.deep.perm.ru/files/
                     31: 
                     32:     Note: you will need two libs for ipguard:
                     33:         libpcap (ftp://ftp.ee.lbl.gov/)
                     34:         libnet 1.1.x (http://www.packetfactory.net/libnet/dist/)
                     35: 
                     36:     # edit Makefile for your system
                     37: 
                     38:     # make
                     39:     # make install
                     40: 
                     41:     How to start and use ipguard please see man page ipguard(8)
                     42: 
                     43:     Example of ipguard actions in tcpdump(1) format in README.tcpdump
                     44: 
                     45:     Log file description in README.log
                     46: 
                     47: ##  platforms
                     48: 
                     49:     Developed on:
                     50:     Gentoo Linux, gcc-4.4.2, libnet-1.1.4-r1, i386
                     51: 
                     52:     Compiled and tested on:
                     53:     FreeBSD 4.11, gcc-2.95.4, libnet-1.1.2, i386
                     54:     FreeBSD 5.5, gcc-3.4.2, libnet-1.1.2, i386
                     55:     FreeBSD 7.0, gcc-4.2.1, libnet-1.1.2, i386
                     56:     FreeBSD 8.0, gcc-4.2.1, libnet-1.1.2, i386
                     57:     OpenBSD 3.6, gcc-2.95.3, libnet-1.1.2.1, i386
                     58:     Gentoo Linux 2007.1, gcc-3.4.5, libnet-1.1.2, i386
                     59:     Debian Linux 4.0, gcc-4.1.2, libnet-1.1.2, i386
                     60: 
                     61:     Any reports or patches for other platforms are welcome.
                     62: 
                     63: 
                     64: ##  credits
                     65: 
                     66:     Authors of libpcap, libnet, ip-sentinel
                     67:     citrin <citrin at citrin.ru> for testing assistance
                     68:     irix <irix at ukr.net> for testing assistance
                     69: 
                     70: 
                     71: SeaD <sead at deep.perm.ru>
                     72: 
                     73: ##  $Id: README,v 1.15 2010/07/12 03:46:52 sead Exp $