NAME

       vrrpd - Virtual Router Redundancy Protocol Deamon

SYNOPSIS

       vrrpd -i ifname -v vrid [-f piddir] [-s] [-a auth] [-p prio] [-m ifname] [-c delta] [-nhD] ipaddr

DESCRIPTION

       vrrpd  is  an implementation of VRRPv2 as specified in rfc2338. It run in userspace for linux.  In short,
       VRRP is a protocol which elects a master server on a  LAN  and  the  master  answers  to  a  'virtual  ip
       address'. If it fails, a backup server takes over the ip address.

       A  longer  answer  in  the  rfc2338  abstract : "This memo defines the Virtual Router Redundancy Protocol
       (VRRP).  VRRP specifies an election protocol that dynamically assigns responsibility for a virtual router
       to  one  of  the VRRP routers on a LAN.  The VRRP router controlling the IP address(es) associated with a
       virtual router is called the Master, and forwards packets sent  to  these  IP  addresses.   The  election
       process provides dynamic fail over in the forwarding responsibility should the Master become unavailable.
       This allows any of the virtual router IP addresses on the LAN to be used as the default first hop  router
       by  end-hosts.   The  advantage  gained  from  using  VRRP  is a higher availability default path without
       requiring configuration of dynamic routing or router discovery protocols on every  end-host."   Copyright
       (C) The Internet Society (1998).  All Rights Reserved.

       Monitored  interface  functionality  is  useful  on high availability router or firewall platforms, where
       single interface failure can cause asymmetrical routing issues.

       Ideally, what is required is a method for a vrrpd process to detect a  failure  of  the  'other'  network
       interface,  and  lower  it's  own  VRRP  priority  below that of the 'backup' vrrpd process.  This allows
       failover to occur normally.

   OPTIONS
       -h     display this short inlined help

       -n     Don't handle the virtual mac address

       -D     Go into background mode, daemonize

       -i ifname
              the interface name to run on.  More than one interface can be monitored by the one vrrpd  process,
              a  list like "eth1 eth2 eth3 eth4 eth5" is acceptable. Losing link-beat on any of these will cause
              the priority of that vrrpd process to be decreased by the specified value, or a  default  of  100.
              Note  that  as  MII  calls  are  used, this implementation is limited to Fast and Gigabit Ethernet
              chipsets only - 10Mbps Ethernet cards will not work.

       -v vrid
              the id of the virtual server [1-255]

       -s     iqxSwitch the preemption mode (Enabled by default)

       -a auth
              set the authentification type auth=(none|pw/hexkey|ah/hexkey) hexkey=0x[0-9a-fA-F]+ Password is  a
              symbolic security, anybody with a sniffer can break it.  AH is a bit stronger.

       -p prio
              Set the priority of this host in the virtual server (dfl: 100)

       -f piddir
              specify the directory where the pid file is stored (dfl: /var/run)

       -d delay
              Set  the  advertisement  interval (in sec) (dfl: 1) -m ifname Interface(s) to monitor for failure.
              Use " " for multiple interfaces

       -c delta
              Set the delta to decrease priority by (dfl: 50)

       ipaddr the ip address(es) of the virtual server

EXAMPLES

       vrrpd -i eth0 -v 50 10.0.0.1

       run vrrp on the interface eth0 with the virtual id 50 and 10.0.0.1 as virtual ip address

AUTHOR

       vrrpd was written by Jerome Etienne <jetienne@arobas.net>, it was later  improved  by  Alexandre  Cassert
       <acassen@linux-vs.org> and David Hunter <david.hunter@gen-i.co.nz>

BUGS

       Suggestions,    bugs    or    questions    should   be   directed   to   the   Sourceforge   project   at
       http://sourceforge.net/projects/vrrpd/

       Bug reports regarding this package should be submitted to Debian using the reportbug or bug tool.

MORE INFO

       For more information please read the documents under /usr/share/doc/vrrpd/ : README,   README.Debian  FAQ
       and TODO.