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

<?><?><?> (NAME)
       ucarp - <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> IP
       <?><?><?><?><?> <?><?><?><?><?> (Failover)

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       ucarp [-i, --interface=INTERFACE]  [-s, --srcip=IPADDRESS]
       [-v, --vhid=VHID]  [-p, --pass=PASSWORD]  [-o, --passfile=PASSFILE]
       [-P, --preempt]  [-n, --neutral]  [-a, --addr=IPADDR]  [-h, --help]
       [-b, --advbase=SECS]  [-k, --advskew=SKEW]  [-u, --upscript=SCRIPT]
       [-d, --downscript=SCRIPT]  [-r, --deadratio=RATIO]  [-z, --shutdown]
       [-B, --daemonize]  [-f, --facility=FACILITY]  [-x, --xparam PARAM]
       [-S, --ignoreifstate]  [-M, --nomcast]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> ucarp <?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       IP <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       (failover) <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?>. <?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> (CARP)<?> <?><?><?><?> <?><?><?><?><?><?><?> OpenBSD
       <?><?><?><?> VRRP <?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?><?> ucarp <?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>:

       -i INTERFACE --interface=INTERFACE
                 <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
                 <?><?><?><?> <?><?> <?><?> <?><?><?><?> (bind) <?><?><?>.

       -s IPADDRESS --srcip=IPADDRESS
                 <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> (IP
                 <?><?><?><?><?>) <?><?><?><?><?> <?><?> <?><?><?>
                 <?><?><?><?> <?><?><?><?>.

       -v VHID --vhid=VHID
                 <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
                 [1-255].

       -p PASSWORD --pass=PASSWORD
                 <?><?><?><?><?><?><?> <?><?><?><?><?>
                 (<?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?>
                 <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?><?><?>).

       -o PASSFILE --passfile=PASSFILE
                 <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
                 <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
                 <?><?><?><?><?><?>. <?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
                 <?><?> <?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
                 <?><?><?><?>.

       -P --preempt
                 <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?><?><?> (preemptive failover).
                 <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
                 <?><?> <?><?><?><?><?> <?><?> ucarp <?><?><?><?><?><?><?><?>
                 <?><?><?><?><?> master <?><?> <?><?> <?><?><?><?>
                 <?><?><?><?><?>.

       -n --neutral
                 <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
                 <?><?> <?><?><?><?><?> <?><?><?><?><?> backup <?><?><?><?>
                 <?><?><?><?><?><?><?> downscript <?><?><?><?> <?><?><?><?>.

       -a IPADDRESS --addr=IPADDRESS
                 <?><?><?><?><?> IP <?><?><?><?><?> <?><?>
                 <?><?><?><?><?><?><?> <?><?><?><?><?>.

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

       -b SECONDS --advbase=SECONDS
                 <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
                 <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
                 (<?><?><?><?><?><?><?>: <?> <?><?><?><?><?>).

       -k SKEW --advskew=SKEW
                 <?><?><?><?><?> <?><?><?><?><?> (advskew) <?><?><?> [1-255]
                 (<?><?><?><?><?><?><?>: <?>).

       -u COMMAND --upscript=COMMAND
                 <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
                 <?><?> <?><?> <?><?> <?><?><?><?><?> ucarp <?><?>
                 <?><?><?><?><?><?> <?><?> master <?><?><?><?><?> <?><?>
                 <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
                 <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?><?>. <?><?><?><?><?><?><?>
                 <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
                 <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
                 <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
                 <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?> ARP <?> <?><?><?><?>
                 <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       -d COMMAND --downscript=COMMAND
                 <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
                 <?><?> <?><?> <?><?> <?><?><?><?> ucarp <?><?>
                 <?><?><?><?><?> backup <?><?><?><?> <?><?><?><?> <?><?><?>
                 <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
                 <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
                 <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?>
                 <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>.

       -r RATIO --deadratio=RATIO
                 <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> backup
                 <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
                 <?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
                 <?><?> master <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
                 <?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?>
                 <?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>.

       -z --shutdown
                 <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
                 <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
                 <?><?> <?><?><?><?><?><?><?> -d <?><?><?><?> <?><?><?>
                 <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> ucarp
                 <?><?><?><?><?><?><?><?> <?><?><?>.

       -B --daemonize
                 <?><?><?><?> <?><?><?><?><?><?> ucarp <?><?>
                 <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?> <?><?>
                 <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
                 <?><?><?><?> <?><?><?><?> <?><?><?>.

       -f --facility
                 <?><?><?><?><?> <?><?><?> (facility) <?><?><?><?><?> <?><?>
                 syslog (<?><?><?><?><?><?><?>: daemon).

       -x PARAMETER --xparam=PARAMETER
                 <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
                 <?><?><?><?><?> <?><?> <?><?>
                 <?><?><?><?><?><?><?><?><?><?><?> up/down <?><?><?><?><?>
                 <?><?><?>.

       -S --ignoreifstate
                 <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
                 <?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
                 <?><?><?><?><?><?><?> ucarp <?><?> <?><?> <?><?><?><?>
                 <?><?><?><?><?><?> (crossover) <?><?><?><?> <?><?><?>
                 <?><?><?><?><?>. <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
                 <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
                 <?><?><?><?><?> <?><?><?><?> <?><?><?> master <?><?>
                 <?><?><?><?> backup <?><?><?><?><?><?> <?><?><?><?>
                 <?><?><?><?> <?><?><?><?><?><?> (NO-CARRIER) <?><?><?><?><?>.

       -M --nomcast
                 <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
                 <?><?><?><?> (broadcast) <?><?><?><?><?><?>
                 <?><?><?><?><?><?><?> (multicast).

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?> <?><?><?><?><?><?> <?><?> IP <?><?><?><?><?> 10.1.1.10 <?><?>
       <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> master <?><?> IP <?><?><?><?><?> 10.1.1.252
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>:

           ucarp -i eth0 -s 10.1.1.10 -v 10 -p secret -a 10.1.1.252 \
           --upscript=/usr/local/sbin/vip-up.sh --downscript=/usr/local/sbin/vip-down.sh -P

       <?><?><?> <?><?><?><?><?><?><?> (backup) <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?>:

           ucarp -i eth0 -s 10.1.1.11 -v 10 -p secret -a 10.1.1.252 \
           --upscript=/usr/local/sbin/vip-up.sh --downscript=/usr/local/sbin/vip-down.sh

       <?><?><?><?><?><?> <?><?> IP <?><?><?><?><?> 192.168.1.19 <?><?> master
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> IP
       <?><?><?><?><?> 10.1.12.7 <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>:

           ucarp -b 5 -s 192.168.1.19 -v 27 -p badpass -a 10.1.12.7 \
           -u /usr/local/sbin/vip-up.sh -d /usr/local/sbin/vip-down.sh -z

       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> (hot standby) <?><?>
       IP <?><?><?><?><?> 192.168.1.20 <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> advskew <?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>):

           ucarp -b 5 -k 50 -s 192.168.1.20 -v 27 -p badpass -a 10.1.12.7 \
           -u /usr/local/sbin/vip-up.sh -d /usr/local/sbin/vip-down.sh -z

<?><?><?><?><?><?><?><?><?> (SIGNALS)
       <?><?><?><?><?> <?><?><?><?><?><?> SIGUSR1 <?><?> <?><?><?><?><?><?>
       ucarp <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?> syslog <?><?><?> <?><?><?><?> <?><?><?><?><?>: <<Sep 13 12:59:56
       localhost ucarp[2654]: [INFO] MASTER on eth0 id 1>> <?><?> <<Sep 13
       13:00:25 localhost ucarp[2644]: [INFO] BACKUP on eth0 id 1>>

       <?><?><?><?><?> <?><?><?><?><?><?> SIGUSR2 <?><?> <?><?><?><?><?><?>
       ucarp <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?> master <?><?> backup <?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?> <?><?><?> <?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> master<?><?>
       <?><?><?><?><?> <?><?><?> <?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?> master
       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>.


<?><?><?><?><?><?><?> (AUTHOR)
       <?><?><?><?><?><?><?><?><?> ucarp <?><?><?><?> Frank Denis <?><?>
       <?><?><?><?><?> <j@ucarp.org> <?><?><?><?><?> <?><?><?> <?><?><?>.

       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> Eric Evans
       <eevans@debian.org> <?><?><?><?> Debian <?><?><?><?><?> <?><?><?> <?>
       <?><?><?><?> Sebastien Luttringer <seblu@archlinux.org> <?><?><?><?>
       Archlinux <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>.
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?>/<?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?> <?><?><?><?><?><?><?><?><?> Arch Linux<?> <?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> /usr/share/licenses/common/GPL
       <?><?><?><?>.

                                                                      UCARP(8)