Bug 58586

Summary: [patch] ng_one2many interface status requirements
Product: Documentation Reporter: Christian S. Peron <maneo>
Component: Books & ArticlesAssignee: Wes Peters <wes>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Christian S. Peron 2003-10-27 01:30:15 UTC
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 ,
Comment 1 Wes Peters freebsd_committer freebsd_triage 2004-01-23 05:24:36 UTC
State Changed
From-To: open->closed

Fix from PR committed: 

wes         2004/01/22 21:24:06 PST

  FreeBSD src repository

  Modified files:
share/man/man4       ng_one2many.4 
  Log:
  PR:             docs/58586
  Submitted by:   Chris S.J. Peron <maneo@bsdpro.com>
  
  Revision  Changes    Path
  1.13      +19 -0     src/share/man/man4/ng_one2many.4


Comment 2 Wes Peters freebsd_committer freebsd_triage 2004-01-23 05:24:36 UTC
Responsible Changed
From-To: freebsd-doc->wes

Fixed it.
Comment 3 Wes Peters freebsd_committer freebsd_triage 2004-01-23 05:34:26 UTC
State Changed
From-To: closed->feedback

Oops, we usually put these in feedback first, right?
Comment 4 Wes Peters freebsd_committer freebsd_triage 2004-02-18 05:33:56 UTC
State Changed
From-To: feedback->closed

Nobody has freaked yet, this one MUST have been OK.