From owner-freebsd-doc@FreeBSD.ORG Thu Sep 8 07:10:03 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 30B8C1065670 for ; Thu, 8 Sep 2011 07:10:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 070E28FC0A for ; Thu, 8 Sep 2011 07:10:03 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p887A2b7024248 for ; Thu, 8 Sep 2011 07:10:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p887A2GI024247; Thu, 8 Sep 2011 07:10:02 GMT (envelope-from gnats) Resent-Date: Thu, 8 Sep 2011 07:10:02 GMT Resent-Message-Id: <201109080710.p887A2GI024247@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Peter Maloney Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 84F101065670 for ; Thu, 8 Sep 2011 07:04:37 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 7262D8FC08 for ; Thu, 8 Sep 2011 07:04:37 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p8874bIs029634 for ; Thu, 8 Sep 2011 07:04:37 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id p8874b5K029633; Thu, 8 Sep 2011 07:04:37 GMT (envelope-from nobody) Message-Id: <201109080704.p8874b5K029633@red.freebsd.org> Date: Thu, 8 Sep 2011 07:04:37 GMT From: Peter Maloney To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/160549: handbook - link aggreggation (lagg) page does not have any static IP examples and whether or not to use inet keyword is ambiguous X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 08 Sep 2011 07:10:03 -0000 >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@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: