Bug 210189

Summary: [handbook] CARP warning at boot if following configuration steps in section 30.10.1
Product: Documentation Reporter: Andrew <andrew.hotlab>
Component: Books & ArticlesAssignee: Jason Helfman <jgh>
Status: Closed FIXED    
Severity: Affects Many People CC: jgh, smh
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://www.freebsd.org/doc/handbook/carp.html

Description Andrew 2016-06-10 10:20:10 UTC 
If CARP is configured following the current Handbook examples on FreeBSD 10 hosts, at system boot this message is displayed:

/etc/rc: WARNING: $ifconfig_em0_alias0 needs leading "inet" keyword for an IPv4 address.

The examples in that section should be changed from this:

ifconfig_em0_alias0="vhid 1 pass testpass alias 192.168.1.50/32"

to this:

ifconfig_em0_alias0="inet vhid 1 pass testpass alias 192.168.1.50/32"
Comment 1 Andrew 2016-06-10 10:24:15 UTC 
The problem has been disclosed by this user:
https://lists.freebsd.org/pipermail/freebsd-doc/2016-January/026296.html

I can confirm that the same applies on FreeBSD 10.3
Comment 2 Jason Helfman freebsd_committer freebsd_triage 2016-06-10 15:58:30 UTC 
Would you be able to confirm if this is any different on a 9.x supported release?

Thanks!
Comment 3 Andrew 2016-06-10 22:28:56 UTC 
(In reply to Jason Helfman from comment #2)

I've just tested on a FreeBSD 9.3 host: what is written in the Handbook works as expected for it!
Comment 4 Jason Helfman freebsd_committer freebsd_triage 2016-06-12 16:26:46 UTC 
Does having the base device configured with 'inet' not apply?  I would think that would apply, and if not could potentially be a software bug.

hostname="hosta.example.org"
ifconfig_em0="inet 192.168.1.3 netmask 255.255.255.0"
ifconfig_em0_alias0="vhid 1 pass testpass alias 192.168.1.50/32"
Comment 5 Andrew 2016-06-12 17:50:39 UTC 
(In reply to Jason Helfman from comment #4)

Honestly I do not know if it can be considered a software bug, but if you follow the Handbook (the same lines you pasted here) you surely obtain the warning at boot time. It's only a warning in effect, since the device is configured properly after all.
Comment 6 Steven Hartland freebsd_committer freebsd_triage 2016-06-12 22:17:55 UTC 
The correct form for this should start with either inet or inet6 prefix since https://svnweb.freebsd.org/base?view=revision&revision=252015

Without is still maintained as backwards compatibility but generates a warning and as such the handbook should indeed be updated.
Comment 7 Jason Helfman freebsd_committer freebsd_triage 2016-06-13 15:29:32 UTC 
Thanks for the report!
Comment 8 commit-hook freebsd_committer freebsd_triage 2016-06-13 15:29:52 UTC 
A commit references this bug:

Author: jgh
Date: Mon Jun 13 15:29:18 UTC 2016
New revision: 48922
URL: https://svnweb.freebsd.org/changeset/doc/48922

Log:
  - correct syntax for carp 10 interfaces

  PR:		210189
  Reported by:	andrew.hotlab@hotmail.com
  Reviewed by:	smh@

Changes:
  head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml