ipguard(8)                  System Manager's Manual                 ipguard(8)



<?><?><?> (NAME)
       ipguard - <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> IP <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> ARP


<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       ipguard [-h] [-ajgrxziovd] [-f ethers] [-l log] [-p pid] [-m mac] [-c
       filter] [-u seconds] [-k seconds] [-n fakes] [-t mseconds] [-b buf] [-s
       user] <iface>


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> ipguard <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> ARP <?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       MAC-IP <?><?> <?><?><?><?><?><?><?><?> ethers <?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       MAC-IP <?><?><?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> ethers <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> ARP <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>.


<?><?><?><?><?><?><?><?> (OPTIONS)
       -f | -e  ethers
              <?><?><?><?><?><?><?><?> ethers. <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> ethers <?><?> ethers.sample <?>
              ethers(5) <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>.
              <?><?><?><?><?> <?><?><?><?><?><?><?>: /etc/ethers.

       -l  log
              <?><?><?><?><?><?><?><?> <?><?><?> (<?><?><?> <?><?><?><?><?>).
              <?><?><?><?><?> <?><?><?><?><?><?><?>:
              /var/log/ipguard_<iface>.log.

       -p  pid
              <?><?><?><?><?><?><?><?> PID (<?><?><?><?><?>
              <?><?><?><?><?><?>). <?><?><?><?><?> <?><?><?><?><?><?><?>:
              /var/run/ipguard_<iface>.pid.

       -m  mac
              <?><?><?><?><?> MAC <?><?><?><?>. <?><?> <?><?><?><?> ARP <?><?>
              <?><?><?><?><?> <?><?><?><?><?> MAC <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?>. <?><?><?><?><?> <?><?><?><?><?><?><?>:
              de:ad:xx:xx:xx:xx <?><?><?> <?><?> <?><?> <?><?> x <?><?>
              <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.

       -c  filter
              <?><?><?><?><?> <?><?><?><?><?> PCAP. <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

       -u  seconds
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> ethers. <?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              ethers <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?><?> <?><?><?><?> <?><?>. <?><?><?><?><?>
              <?><?><?><?><?><?><?>: 0 (<?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>).

       -k  seconds
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> MAC <?><?><?><?>. <?><?><?><?><?><?><?>: 0
              (<?><?><?><?> <?><?><?><?><?> <?><?><?><?>).

       -n  fakes
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>.
              <?><?><?><?><?> <?><?><?><?><?><?><?>: <?> <?><?><?><?>.

       -t  mseconds
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?>. <?><?><?><?><?>
              <?><?><?><?><?><?><?>: <?><?> <?><?><?><?><?><?><?><?><?><?>.

       -b  buf
              <?><?><?><?><?><?> <?><?><?><?> MAC. <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> MAC-
              IP <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?>: 0 (<?><?><?><?>
              <?><?><?><?>).

       -s  user
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> (root) <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?><?><?>
              <?><?><?><?><?><?><?>: <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?>.

       -a     <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              (<?><?><?><?><?> 0.0.0.0 <?><?> 00:00:00:00:00:00).

       -j     <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> MAC-IP <?><?>
              <?><?><?><?> <?><?><?><?>.

       -g     <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?> (Default to grant). <?><?> <?><?><?><?><?>
              <?><?> <?><?> <?><?> <?><?><?><?><?> MAC <?> IP <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?>.

       -r     <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?>.

       -x     <?><?><?><?> <?><?><?><?><?><?> (Duplex).
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> (pirate)<?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?>.

       -z     <?><?><?><?><?> <?><?><?><?><?><?><?> who-has <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> ARP <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>.

       -i     <?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?><?><?><?> ARP
              <?><?><?><?><?><?> (Gratuitous ARP) <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?>.

       -o     <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (Promiscuous mode).
              <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?> (<?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?>).

       -v     <?><?><?><?> <?><?><?><?> (Verbose). <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>.

       -d     <?><?><?> <?><?><?><?><?><?> (<?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?>). <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?> STDERR
              <?><?><?><?><?><?><?><?>.

       -dd    <?><?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?>).

       -ddd   <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>.

       -h     <?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>.


<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> etc/ethers/ <?><?>
       <?> <?><?><?><?><?> <?><?><?><?><?><?>:
              ipguard -xz -u 300 fxp0

       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> PCAP <?><?><?><?> <?><?><?><?> <?><?><?><?>
       192.168.1.0/24:
              ipguard -xz -u 300 -c 'net 192.168.0.0/24' fxp0

       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?> ethers <?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> MAC-IP:
              ipguard -r -b 100 -f /dev/null rl0

       <?><?><?><?><?> ipguard <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> killall -USR2 ipguard
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?> MAC-IP.

       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> ethers:
              ipguard -vd -f /tmp/ethers my1


<?><?><?><?> (TIPS)
       <?><?><?><?><?> <?><?><?> MAC-IP <?><?> <?><?><?><?><?><?><?><?> ethers
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> MAC/IP
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?>. <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> -j <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> MAC/IP <?><?><?><?> <?><?><?>.

       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> (Redundancy) <?><?><?> <?><?> <?><?> ipguard
       <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> MAC <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> ethers
       <?><?><?><?><?><?>.


<?><?><?><?><?><?><?><?><?> (SIGNALS)
       SIGHUP <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> ethers <?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?>.

       SIGUSR1
              <?><?><?><?><?> (Dump) <?><?><?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?> <?><?><?><?><?>.

       SIGUSR2
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> MAC-IP <?><?>
              <?><?><?><?> ethers(5).


<?><?><?><?><?><?><?> (FILES)
       /etc/ethers
              <?><?><?><?><?> <?><?><?><?><?><?><?> MAC-IP.

       /var/log/ipguard_<iface>.log
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> (log).

       /var/run/ipguard_<iface>.pid
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              (pid).


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       RFC 826, ethers(5), tcpdump(1), pcap(3), libnet


<?><?><?><?><?><?><?> (BUGS)
       <?><?> <?><?><?><?><?> <?><?><?> 0.0.0.0 <?><?>
       <?><?><?><?><?><?><?><?> ethers <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> -x <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       (<?><?><?><?><?><?><?> <?><?><?><?> irix).

       <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> ()libnet_get_hwaddr
       <?><?><?><?> <?><?><?><?> <?><?> <?><?> OpenBSD 4.0 <?><?><?>
       <?><?><?><?><?><?><?> (<?><?><?><?><?><?><?> <?><?><?><?> irix). <?><?>
       <?><?><?><?><?><?><?> -j <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?> ipguard <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> MAC <?><?>
       <?><?><?><?><?> IP <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?><?><?><?><?><?> HUP<?> USR1 <?><?> USR2 <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> ARP <?><?><?><?> <?><?><?><?><?><?> <?><?><?>. <?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> -s
       <user> <?><?><?><?><?> ipguard <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> log
       <?> pid <?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>!
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> etc/ethers/ <?><?><?><?>
       <?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?> ipguard <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> <?>
       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> SQL/LDAP <?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?>. <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.


<?><?><?><?><?><?><?><?><?> (AUTHORS)
       SeaD <sead at deep.perm.ru>

                                                                    ipguard(8)