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.