IFENSLAVE(8)		 BSD System Manager's Manual		 IFENSLAVE(8)

NAME
     ifenslave - Attach and detach slave network devices to a bonding device.

SYNOPSIS
     ifenslave [-acdfhuvV] [--all-interfaces] [--change-active] [--detach]
	       [--force] [--help] [--usage] [--verbose] [--version] master
	       slave ...

DESCRIPTION
     ifenslave is a tool to attach and detach slave network devices to a
     bonding device.  A bonding device will act like a normal Ethernet net-
     work device to the kernel, but will send out the packets via the slave
     devices using a simple round-robin scheduler.  This allows for simple
     load-balancing, identical to "channel bonding" or "trunking" techniques
     used in switches.

     The kernel must have support for bonding devices for ifenslave to be
     useful.

OPTIONS
     -a, --all-interfaces
	     Show information about all interfaces.

     -c, --change-active
	     Change active slave.

     -d, --detach
	     Removes slave interfaces from the bonding device.

     -f, --force
	     Force actions to be taken if one of the specified interfaces
	     appears not to belong to an Ethernet device.

     -h, --help
	     Display a help message and exit.

     -u, --usage
	     Show usage information and exit.

     -v, --verbose
	     Print warning and debug messages.

     -V, --version
	     Show version information and exit.
     If not options are given, the default action will be to enslave inter-
     faces.

EXAMPLE
     The following example shows how to setup a bonding device and enslave
     two real Ethernet devices to it:

     # modprobe bonding
     # ifconfig bond0 192.168.0.1 netmask 255.255.0.0
     # ifenslave bond0 eth0 eth1

AUTHOR
     ifenslave was originally written by Donald Becker
     ?becker@cesdis.gsfc.nasa.gov?, and has since been updated by various
     kernel developers.

     This manual page was written by Guus Sliepen ?guus@debian.org? for the
     Debian GNU/Linux system.

GNU/Linux		      February 11, 2007			    GNU/Linux

UNIX/Linux commands referenced on this page:

1. setup
2. modprobe
3. ifconfig