docs/160549: handbook - link aggreggation (lagg) page does not have any static IP examples and whether or not to use inet keyword is ambiguous

[Peter Maloney]

>Number:         160549
>Category:       docs
>Synopsis:       handbook - link aggreggation (lagg) page does not have any static IP examples and whether or not to use inet keyword is ambiguous
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Sep 08 07:10:02 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Peter Maloney
>Release:        8.2-STABLE-201105
>Organization:
Brockmann Consult
>Environment:
FreeBSD thatmachineoverthere 8.2-STABLE-201105 FreeBSD 8.2-STABLE-201105 #2: Mon Sep  5 12:21:38 CEST 2011     root at thatmachineoverthere:/usr/obj/usr/src/sys/GENERIC  amd64

>Description:
The link aggreggation (lagg) handbook page http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-aggregation.html does not have any static IP examples, and whether or not to use inet keyword is ambiguous.

This is a problem because many people would think to put the keyword "inet" before the IP address, as you would in other static IP situations.

For example, in this thread, the posters were using the inet keyword; I used their examples and tested, and it wasn't working until I removed the inet keyword. 
http://forums.freebsd.org/showthread.php?t=20263

Please add a static IP example, with a special note that the "inet" keyword should not be used.

>How-To-Repeat:
Look in http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-aggregation.html to determine whether or not to use the "inet" keyword in specifying an ip address.
>Fix:
You could just add a note to the end of "Example 31-2. Failover mode", something like this:

To use a static IP address, add it to the command like this:
# ifconfig lagg0 create
# ifconfig lagg0 up laggproto failover laggport fxp0 laggport fxp1 1.2.3.4 netmask 255.255.255.0

Where 1.2.3.4 is your static IPv4 address, and 255.255.255.0 is your netmask.

>Release-Note:
>Audit-Trail:
>Unformatted: