| ng_one2many.4 (129354) | ng_one2many.4 (130582) |
|---|---|
| 1.\" Copyright (c) 2000 Whistle Communications, Inc. 2.\" All rights reserved. 3.\" 4.\" Subject to the following obligations and disclaimer of warranty, use and 5.\" redistribution of this software, in source or object code forms, with or 6.\" without modifications are expressly permitted by Whistle Communications; 7.\" provided, however, that: 8.\" 1. Any and all reproductions of the source or object code must include the --- 18 unchanged lines hidden (view full) --- 27.\" SERVICES, LOSS OF USE, DATA OR PROFITS, HOWEVER CAUSED AND UNDER ANY 28.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 29.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 30.\" THIS SOFTWARE, EVEN IF WHISTLE COMMUNICATIONS IS ADVISED OF THE POSSIBILITY 31.\" OF SUCH DAMAGE. 32.\" 33.\" Author: Archie Cobbs <archie@FreeBSD.org> 34.\" | 1.\" Copyright (c) 2000 Whistle Communications, Inc. 2.\" All rights reserved. 3.\" 4.\" Subject to the following obligations and disclaimer of warranty, use and 5.\" redistribution of this software, in source or object code forms, with or 6.\" without modifications are expressly permitted by Whistle Communications; 7.\" provided, however, that: 8.\" 1. Any and all reproductions of the source or object code must include the --- 18 unchanged lines hidden (view full) --- 27.\" SERVICES, LOSS OF USE, DATA OR PROFITS, HOWEVER CAUSED AND UNDER ANY 28.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 29.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 30.\" THIS SOFTWARE, EVEN IF WHISTLE COMMUNICATIONS IS ADVISED OF THE POSSIBILITY 31.\" OF SUCH DAMAGE. 32.\" 33.\" Author: Archie Cobbs <archie@FreeBSD.org> 34.\" |
| 35.\" $FreeBSD: head/share/man/man4/ng_one2many.4 129354 2004-05-17 19:35:40Z pjd $ | 35.\" $FreeBSD: head/share/man/man4/ng_one2many.4 130582 2004-06-16 08:33:57Z ru $ |
| 36.\" 37.Dd January 26, 2001 38.Dt NG_ONE2MANY 4 39.Os 40.Sh NAME 41.Nm ng_one2many 42.Nd packet multiplexing netgraph node type 43.Sh SYNOPSIS --- 27 unchanged lines hidden (view full) --- 71Packets are never delivered out a many hook that is down. 72How a link is determined to be up or down depends on the node's 73configured link failure detection algorithm. 74.Pp 75Before an interface or link can be plumbed into a group, its status 76must be marked as being 77.Dq up . 78This is normally setup during the initial boot stages by | 36.\" 37.Dd January 26, 2001 38.Dt NG_ONE2MANY 4 39.Os 40.Sh NAME 41.Nm ng_one2many 42.Nd packet multiplexing netgraph node type 43.Sh SYNOPSIS --- 27 unchanged lines hidden (view full) --- 71Packets are never delivered out a many hook that is down. 72How a link is determined to be up or down depends on the node's 73configured link failure detection algorithm. 74.Pp 75Before an interface or link can be plumbed into a group, its status 76must be marked as being 77.Dq up . 78This is normally setup during the initial boot stages by |
| 79.Xr rc.conf 5 . 80It is also possible to change an interfaces status to 81.Dq up | 79.Xr rc.conf 5 . 80It is also possible to change an interface's status to 81.Dq up |
| 82by using the 83.Xr ifconfig 8 | 82by using the 83.Xr ifconfig 8 |
| 84utility. | 84utility. |
| 85.Sh TRANSMIT ALGORITHMS 86.Bl -tag -width foo 87.It NG_ONE2MANY_XMIT_ROUNDROBIN 88Packets are delivered out the many hooks in sequential order. 89Each packet goes out on a different 90.Dv many 91hook. 92.It NG_ONE2MANY_XMIT_ALL --- 27 unchanged lines hidden (view full) --- 120.Sh CONTROL MESSAGES 121This node type supports the generic control messages, plus the 122following: 123.Bl -tag -width foo 124.It Dv NGM_ONE2MANY_SET_CONFIG 125Sets the node configuration using a 126.Dv "struct ng_one2many_link_config" 127as the control message argument: | 85.Sh TRANSMIT ALGORITHMS 86.Bl -tag -width foo 87.It NG_ONE2MANY_XMIT_ROUNDROBIN 88Packets are delivered out the many hooks in sequential order. 89Each packet goes out on a different 90.Dv many 91hook. 92.It NG_ONE2MANY_XMIT_ALL --- 27 unchanged lines hidden (view full) --- 120.Sh CONTROL MESSAGES 121This node type supports the generic control messages, plus the 122following: 123.Bl -tag -width foo 124.It Dv NGM_ONE2MANY_SET_CONFIG 125Sets the node configuration using a 126.Dv "struct ng_one2many_link_config" 127as the control message argument: |
| 128.Bd -literal -offset 0n | 128.Bd -literal |
| 129/* Node configuration structure */ 130struct ng_one2many_config { 131 u_int32_t xmitAlg; /* how to distribute packets */ 132 u_int32_t failAlg; /* how to detect link failure */ 133 u_char enabledLinks[NG_ONE2MANY_MAX_LINKS]; 134}; 135.Ed 136.Pp --- 13 unchanged lines hidden (view full) --- 150.Dv "struct ng_one2many_link_config" . 151.It Dv NGM_ONE2MANY_GET_STATS 152This command takes a 32 bit link number as an argument and 153returns a 154.Dv "struct ng_one2many_link_stats" 155containing statistics for the corresponding 156.Dv many 157link, which may or may not be currently connected: | 129/* Node configuration structure */ 130struct ng_one2many_config { 131 u_int32_t xmitAlg; /* how to distribute packets */ 132 u_int32_t failAlg; /* how to detect link failure */ 133 u_char enabledLinks[NG_ONE2MANY_MAX_LINKS]; 134}; 135.Ed 136.Pp --- 13 unchanged lines hidden (view full) --- 150.Dv "struct ng_one2many_link_config" . 151.It Dv NGM_ONE2MANY_GET_STATS 152This command takes a 32 bit link number as an argument and 153returns a 154.Dv "struct ng_one2many_link_stats" 155containing statistics for the corresponding 156.Dv many 157link, which may or may not be currently connected: |
| 158.Bd -literal -offset 0n | 158.Bd -literal |
| 159/* Statistics structure (one for each link) */ 160struct ng_one2many_link_stats { 161 u_int64_t recvOctets; /* total octets rec'd on link */ 162 u_int64_t recvPackets; /* total pkts rec'd on link */ 163 u_int64_t xmitOctets; /* total octets xmit'd on link */ 164 u_int64_t xmitPackets; /* total pkts xmit'd on link */ 165}; 166.Ed --- 17 unchanged lines hidden (view full) --- 184.Sh EXAMPLES 185The following commands will set up Ethernet interfaces 186.Dv fxp0 187to deliver packets alternating over the physical interfaces 188corresponding to networking interfaces 189.Dv fxp0 190through 191.Dv fxp3 : | 159/* Statistics structure (one for each link) */ 160struct ng_one2many_link_stats { 161 u_int64_t recvOctets; /* total octets rec'd on link */ 162 u_int64_t recvPackets; /* total pkts rec'd on link */ 163 u_int64_t xmitOctets; /* total octets xmit'd on link */ 164 u_int64_t xmitPackets; /* total pkts xmit'd on link */ 165}; 166.Ed --- 17 unchanged lines hidden (view full) --- 184.Sh EXAMPLES 185The following commands will set up Ethernet interfaces 186.Dv fxp0 187to deliver packets alternating over the physical interfaces 188corresponding to networking interfaces 189.Dv fxp0 190through 191.Dv fxp3 : |
| 192.Bd -literal -offset 0n | 192.Bd -literal |
| 193 # Plumb nodes together 194 195 ngctl mkpeer fxp0: one2many upper one 196 ngctl connect fxp0: fxp0:upper lower many0 197 ngctl connect fxp1: fxp0:upper lower many1 198 ngctl connect fxp2: fxp0:upper lower many2 199 ngctl connect fxp3: fxp0:upper lower many3 200 --- 48 unchanged lines hidden --- | 193 # Plumb nodes together 194 195 ngctl mkpeer fxp0: one2many upper one 196 ngctl connect fxp0: fxp0:upper lower many0 197 ngctl connect fxp1: fxp0:upper lower many1 198 ngctl connect fxp2: fxp0:upper lower many2 199 ngctl connect fxp3: fxp0:upper lower many3 200 --- 48 unchanged lines hidden --- |