Return to README CVS log

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

ipguard

    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.1.1.1 2012/02/21 21:59:41 misho Exp $