From owner-freebsd-doc@FreeBSD.ORG Sun Oct 26 17:30:16 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C7D6D16A4B3 for ; Sun, 26 Oct 2003 17:30:16 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7D1C643FB1 for ; Sun, 26 Oct 2003 17:30:15 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h9R1UFFY089568 for ; Sun, 26 Oct 2003 17:30:15 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h9R1UFLB089567; Sun, 26 Oct 2003 17:30:15 -0800 (PST) (envelope-from gnats) Resent-Date: Sun, 26 Oct 2003 17:30:15 -0800 (PST) Resent-Message-Id: <200310270130.h9R1UFLB089567@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, "Chris S.J.Peron" Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7D6B316A4B3 for ; Sun, 26 Oct 2003 17:20:57 -0800 (PST) Received: from staff.seccuris.com (staff.seccuris.com [204.112.0.40]) by mx1.FreeBSD.org (Postfix) with SMTP id 98A7343F93 for ; Sun, 26 Oct 2003 17:20:54 -0800 (PST) (envelope-from maneo@staff.seccuris.com) Received: (qmail 46048 invoked by uid 1006); 27 Oct 2003 01:20:53 -0000 Message-Id: <20031027012053.46047.qmail@staff.seccuris.com> Date: 27 Oct 2003 01:20:53 -0000 From: "Chris S.J.Peron" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/58586: [patch] ng_one2many interface status requirements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: "Chris S.J.Peron" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 27 Oct 2003 01:30:17 -0000 >Number: 58586 >Category: docs >Synopsis: [patch] ng_one2many interface status requirements >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Sun Oct 26 17:30:15 PST 2003 >Closed-Date: >Last-Modified: >Originator: Chris S.J. Peron >Release: FreeBSD 4.8-RELEASE-p13 i386 >Organization: >Environment: System: FreeBSD staff 4.8-RELEASE-p13 FreeBSD 4.8-RELEASE-p13 #1: Sat Oct 25 16:45:55 UTC 2003 yboily@staff:/usr/src/sys/compile/STAFF i386 >Description: ng_one2many(4) does not tell the users their network interface must be ``up'' before they can link them into a group properly. >How-To-Repeat: N/A Fix: --- share/man/man4/ng_one2many.4.0 Sun Oct 26 02:38:51 2003 +++ share/man/man4/ng_one2many.4 Sun Oct 26 02:15:05 2003 @@ -71,6 +71,17 @@ Packets are never delivered out a many hook that is down. How a link is determined to be up or down depends on the node's configured link failure detection algorithm. +.Pp +Before an interface or link can be plumbed into a group, its status +must be marked as being +.Dq up . +This is normally setup during the initial boot stages by +.Xr rc.conf 5 . +It's also possible to change an interfaces status to +.Dq up +by using the +.Xr ifconfig 8 +utility. .Sh TRANSMIT ALGORITHMS .Bl -tag -width foo .It NG_ONE2MANY_XMIT_ROUNDROBIN @@ -179,22 +190,29 @@ .Dv fxp3 : .Bd -literal -offset 0n # Plumb nodes together + ngctl mkpeer fxp0: one2many upper one ngctl connect fxp0: fxp0:upper lower many0 ngctl connect fxp1: fxp0:upper lower many1 ngctl connect fxp2: fxp0:upper lower many2 ngctl connect fxp3: fxp0:upper lower many3 + # Allow fxp1 through fxp3 to xmit/recv fxp0 frames + ngctl msg fxp1: setpromisc 1 ngctl msg fxp2: setpromisc 1 ngctl msg fxp3: setpromisc 1 ngctl msg fxp1: setautosrc 0 ngctl msg fxp2: setautosrc 0 ngctl msg fxp3: setautosrc 0 + # Configure all four links as up + ngctl msg fxp0:upper \\ setconfig "{ xmitAlg=1 failAlg=1 enabledLinks=[ 1 1 1 1 ] }" + # Bring up interface + ifconfig fxp0 192.168.1.1 netmask 0xfffffffc .Ed .Pp @@ -206,6 +224,7 @@ More transmit and link failure algorithms should be supported. A good candidate is Cisco's Etherchannel. .Sh SEE ALSO +.Xr ifconfig 8 , .Xr netgraph 4 , .Xr ng_bridge 4 , .Xr ng_ether 4 , >Fix: >Release-Note: >Audit-Trail: >Unformatted: