Bug 210189 - [handbook] CARP warning at boot if following configuration steps in section 30.10.1
Summary: [handbook] CARP warning at boot if following configuration steps in section 3...
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: Jason Helfman
URL: https://www.freebsd.org/doc/handbook/...
Keywords:
Depends on:
Blocks:
 
Reported: 2016-06-10 10:20 UTC by Andrew
Modified: 2016-06-13 15:29 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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