mirror/freebsd
1
0
Fork 0
mirror of https://git.FreeBSD.org/src.git synced 2025-01-02 12:20:51 +00:00
Code Issues Releases Activity

- Rewrite paragraphs about preemption.

Browse Source 
- Avoid word combination "carp interface".

Prodded by:	az
This commit is contained in:
Gleb Smirnoff 2012-01-26 19:11:08 +00:00
parent 3e85ab1008
commit a1ae564ebf
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=230594
1 changed files with 11 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
share/man/man4/carp.4
View File

@ -26,7 +26,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd December 20, 2011 .Dd January 26, 2012
.Dt CARP 4 .Dt CARP 4
.Os .Os
.Sh NAME .Sh NAME
@ -99,24 +99,14 @@ packets.
Enabled by default. Enabled by default.
.It Va net.inet.carp.preempt .It Va net.inet.carp.preempt
Allow virtual hosts to preempt each other. Allow virtual hosts to preempt each other.
It is also used to failover When enabled, a vhid in a backup state would preempt a master that
.Nm is announcing itself with a lower advskew.
interfaces as a group.
When the option is enabled and one of the
.Nm
enabled physical interfaces
goes down,
.Cm advskew
is changed to 240 on all
.Nm
interfaces.
See also the first example.
Disabled by default. Disabled by default.
.It Va net.inet.carp.log .It Va net.inet.carp.log
Value of 0 disables any logging. Value of 0 disables any logging.
Value of 1 enables logging state changes of Value of 1 enables logging state changes of
.Nm .Nm
interfaces. vhids.
Values above 1 enable logging of bad Values above 1 enable logging of bad
.Nm .Nm
packets. packets.
@ -202,9 +192,9 @@ and
section for more information. section for more information.
.Sh EXAMPLES .Sh EXAMPLES
For firewalls and routers with multiple interfaces, it is desirable to For firewalls and routers with multiple interfaces, it is desirable to
failover all of the failover all of the addresses running
.Nm .Nm
interfaces together, when one of the physical interfaces goes down. together, when one of the physical interfaces goes down.
This is achieved by the preempt option. This is achieved by the preempt option.
Enable it on both host A and B: Enable it on both host A and B:
.Pp .Pp
@ -225,14 +215,13 @@ ifconfig em0 vhid 1 advskew 100 pass mekmitasdigoat 192.168.1.1/24
ifconfig em1 vhid 2 advskew 100 pass mekmitasdigoat 192.168.2.1/24 ifconfig em1 vhid 2 advskew 100 pass mekmitasdigoat 192.168.2.1/24
.Ed .Ed
.Pp .Pp
Because of the preempt option, when one of the physical interfaces of When one of the physical interfaces of host A fails,
host A fails,
.Cm advskew .Cm advskew
is adjusted to 240 on all its is demoted to a configured value on all its
.Nm .Nm
interfaces. vhids.
This will cause host B to preempt on both interfaces instead of Due to the preempt option, host B would start announcing itself, and thus
just the failed one. preempt host A on both interfaces instead of just the failed one.
.\".Pp .\".Pp
.\"In order to set up an ARP balanced virtual host, it is necessary to configure .\"In order to set up an ARP balanced virtual host, it is necessary to configure
.\"one virtual host for each physical host which would respond to ARP requests .\"one virtual host for each physical host which would respond to ARP requests