Annotation of embedaddon/freevrrpd/freevrrpd.8, revision 1.1

1.1     ! misho       1: .Dd 30 January, 2015
        !             2: .Dt FREEVRRPD 8
        !             3: .Sh NAME
        !             4: .Nm freevrrpd
        !             5: .Nd Virtual Redundancy Router Protocol Daemon
        !             6: .Sh SYNOPSIS
        !             7: .Nm freevrrpd
        !             8: .Bk -words
        !             9: .Op Fl F
        !            10: .Op Fl f Ar config_file
        !            11: .Op Fl c Ar chroot_directory
        !            12: .Sh DESCRIPTION
        !            13: .Nm freevrrpd
        !            14: is a RFC2338/5798 compliant daemon. VRRP can be used with multiple
        !            15: interfaces as well as multiple VRIDs. For each VRID defined in the
        !            16: configuration file,
        !            17: .Nm freevrrpd
        !            18: creates a thread for managing a poll of one or multiple virtual IP
        !            19: addresses. The daemon currently only supports IPv4 but IPv6 is being
        !            20: developed.
        !            21: .Pp
        !            22: When
        !            23: .Nm freevrrpd 
        !            24: start, it reads /usr/local/etc/freevrrpd.conf file and then daemonizes
        !            25: itself.  All of the options are defined in the config file. 
        !            26: .Pp
        !            27: .Nm freevrrpd is compatible with FreeBSD.
        !            28: .Pp
        !            29: Functionality includes :
        !            30: .Bl -bullet -compact
        !            31: .It
        !            32: Support of multiple VRIDs
        !            33: .It
        !            34: State announcements are multicast using the
        !            35: .Xr bpf 4
        !            36: device.
        !            37: .It
        !            38: Changing routes and IP in 3 seconds
        !            39: .It
        !            40: Sending gratuitous ARP requests to clean the ARP cache of all hosts listening hosts.
        !            41: .It
        !            42: Election between different backup and master servers with differing priorities
        !            43: .It
        !            44: THe same host can be both a SLAVE and MASTER at the same time for different VRIDs.
        !            45: .It
        !            46: Automatic downgrade to BACKUP state if the MASTER returns to service.
        !            47: .It
        !            48: Support of netmasks for virtual IP addresses.
        !            49: .El
        !            50: .Sh CONFIGURATION
        !            51: .Pp
        !            52: .Nm freevrrpd
        !            53: reads its configuration data from /usr/local/etc/freevrrpd.conf, or
        !            54: the file specified with -f on the command line. The config file
        !            55: contains keyword-argument pairs, one per line. Each VRID definition is
        !            56: define by the [VRID] keyword. Lines statring with '#' and empty lines
        !            57: are interpreted as comments.
        !            58: .Pp
        !            59: The possible keywords and their meanings are as follows (note that keywords and arguments are cas-sensitive):
        !            60: .Bl -tag -width Ds
        !            61: .It Cm serverid
        !            62: This keyword is followed by a decimal number between 1 and 255 and represent the group identifier (Virtual Router Identifier).
        !            63: .It Cm interface
        !            64: This keyword is followed by an interface name where multicast VRRP annonce on the specified serverid group will be sent.
        !            65: .It Cm useVMAC
        !            66: Specifies wheter Virtual MAC adress (like 00:5E:00:...) is permitted.
        !            67: The default is
        !            68: .Dq yes .
        !            69: Note that disabling useVMAC is a RFC infragment but must be necessary for some specific cases. If disabled,
        !            70: .Dq sendgratuitousarp
        !            71: must be enabled.
        !            72: .It Cm priority
        !            73: This keyword can be followed by a decimal number between 0 to 255. a priority of 255 mean a MASTER server. a priority between 0 to 254 is a BACKUP priority.
        !            74: Note that 0 is the minimal BACKUP priority and 254 is the higher. If the VRID MASTER fail, tha higher BACKUP priority will become MASTER.
        !            75: .It Cm addr
        !            76: Specifies all Virtual IP adresses separated by commas of the corresponded VRID. a VIP syntax will be: 
        !            77: .Dq xxx.xxx.xxx.xxx/yy 
        !            78: or 
        !            79: .Dq device:xxx.xxx.xxx.xxx/yy. 
        !            80: .Dq xxx.xxx.xxx.xxx 
        !            81: represent the IP adress and 
        !            82: .Dq yy 
        !            83: is a netmask in CIDR format. device is an optional device where VIP will be setted.
        !            84: .It Cm monitoredcirctuis
        !            85: Specifies whether NIC monitoring is enabled. This option use a special ioctl for getting carrier, duplex and health of the network card.
        !            86: The default is 
        !            87: .Dq yes .
        !            88: Note that your NIC driver must support mii bus functionnality. Some old drivers cannot use this option and must be disabled.
        !            89: .It Cm MCClearErrorsCount
        !            90: This keyword can be followed by a decimal number that represent the number of concurrent valid checks (monitored circuits) before nberrors flag will be resetted at 0.
        !            91: The default is
        !            92: .Dq 3600 .
        !            93: Note that the default value mean that 30 concurrent checks ok on a NIC by monitored circuits will reset the error counter for this NIC.
        !            94: If a value of 
        !            95: .It Cm masterscript
        !            96: This keyword can be followed by a script name with an absolute path and will be executed during MASTER transition state.
        !            97: .It Cm backupscript
        !            98: This keyword take same argument as 
        !            99: .Dq masterscript 
        !           100: except that this script is executed during BACKUP transition state.
        !           101: .It Cm vridsdep
        !           102: This keyword can be followed by a list of VRID in decimal format separated by commas and depends from this one. If this VRID become BACKUP, all VRIDs specified will become BACKUP too.
        !           103: .It Cm password
        !           104: This keyword can be followed by a password for authenticate VRRP packets on a specific VRID.
        !           105: Note that the password will be transmitted in clear with this method.
        !           106: .It Cm AHencryption
        !           107: Not implemented yet
        !           108: .It Cm useIKE
        !           109: Not implemented yet
        !           110: .It Cm presharedkey
        !           111: Not implemented yet
        !           112: .Sh IMPLEMENTATION NOTES
        !           113: This utility doesn't quit properly if you use the -KILL signal. If you want to stop freevrrpd, you can use kill [PID] and not kill -9 [PID], then it can delete virtual IP addresses and routes properly on shutdown.
        !           114: .Sh BUGS
        !           115: .Nm freevrrpd
        !           116: is in active developpement, please send me bugs report and suggestions.
        !           117: .Sh AUTHORS
        !           118: .An Sebastien Petit Aq spe@bsdfr.org
        !           119: .Sh HISTORY
        !           120: first appeared in FreeBSD-4.3

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>