I think this needs documenting somewhere; I had to use the source to remember what triggered "carpdemote 32" on some routers. I am open to suggestions to improving the wording, the way I have it it's useful as a reminder but isn't a great explanation for someone just learning about it..
Index: pfsync.4 =================================================================== RCS file: /cvs/src/share/man/man4/pfsync.4,v retrieving revision 1.36 diff -u -p -r1.36 pfsync.4 --- pfsync.4 30 Aug 2016 13:56:14 -0000 1.36 +++ pfsync.4 1 Feb 2021 13:10:38 -0000 @@ -130,6 +130,14 @@ Only run the pfsync protocol on a truste dedicated to pfsync messages such as a crossover cable between two firewalls. .\" or specify a peer address and protect the traffic with .\" .Xr ipsec 4 . +.Pp +.Nm +will increase the +.Xr carp 4 +demote count for any interface groups associated with the interface +by 32 during initialisation, and by 1 if the +.Nm +link is down or if a bulk update fails. .Sh EXAMPLES .Nm and