ng_fec (4)

Leading comments

Copyright (c) 2004 Gleb Smirnoff
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
   documentation and/or othe...

(The comments found at the beginning of the groff file "man4/ng_fec.4freebsd".)

NAME

ng_fec - netgraph Fast EtherChannel node

SYNOPSIS

In netgraph/ng_fec.h

DESCRIPTION

The fec node implements Ethernet port trunking using the ``Cisco Fast EtherChannel'' protocol. Upon creation, a fec node creates a network interface associated with it. Interfaces are named ``fec0 '' ``fec1 '' etc. New nodes take the first available unit.

HOOKS

The fec node accepts any hooks. However it does not use them. Under normal operation, a fec node should not have any hooks.

CONTROL MESSAGES

Interface membership in the FEC group is configured with the following control messages:

NGM_FEC_ADD_IFACE (add_iface )

Attach interface to the FEC group. The target interface name is passed as a string argument.

NGM_FEC_DEL_IFACE (del_iface )

Remove interface from the trunk. The target interface name is passed as a string argument.

The following control messages define the forwarding method for a node:

NGM_FEC_SET_MODE_MAC (set_mode_mac )

Forwarding decisions will be based on the link-layer MAC address of the destination.

NGM_FEC_SET_MODE_INET (set_mode_inet )

Forwarding decisions will be based on the IP address of the destination.

SHUTDOWN

This node shuts down upon receipt of a NGM_SHUTDOWN control message.

EXAMPLES

The following example script creates an fec node, attaches four Ethernet interfaces to it and sets the forwarding method to be IP-address based:

/usr/sbin/ngctl -f- << SEQ
        mkpeer fec dummy fec
        msg fec0: add_iface "dc0"
        msg fec0: add_iface "dc1"
        msg fec0: add_iface "dc2"
        msg fec0: add_iface "dc3"
        msg fec0: set_mode_inet
SEQ

SEE ALSO

netgraph(4)

HISTORY

The fec node type was implemented in Fx 5.0 .

AUTHORS

An -nosplit The fec node was written by An Bill Paul Aq wpaul@FreeBSD.org . This manual page was written by An Gleb Smirnoff Aq glebius@FreeBSD.org .