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     ! 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 $