| 1 |
.Dd 2004-04-09 |
| 2 |
.Dt IFENSLAVE 8 |
| 3 |
.\" Manual page created by Guus Sliepen <[email protected]> |
| 4 |
.Sh NAME |
| 5 |
.Nm ifenslave |
| 6 |
.Nd Attach and detach slave network devices to a bonding device. |
| 7 |
.Sh SYNOPSIS |
| 8 |
.Nm |
| 9 |
.Op Fl acdfhuvV |
| 10 |
.Op Fl -all-interfaces |
| 11 |
.Op Fl -change-active |
| 12 |
.Op Fl -detach |
| 13 |
.Op Fl -force |
| 14 |
.Op Fl -help |
| 15 |
.Op Fl -usage |
| 16 |
.Op Fl -verbose |
| 17 |
.Op Fl -version |
| 18 |
.Ar master |
| 19 |
.Ar slave |
| 20 |
.No ... |
| 21 |
.Sh DESCRIPTION |
| 22 |
.Nm |
| 23 |
is a tool to attach and detach slave network devices to a bonding device. |
| 24 |
A bonding device will act like a normal Ethernet network device to the kernel, |
| 25 |
but will send out the packets via the slave devices using a simple round-robin scheduler. |
| 26 |
This allows for simple load-balancing, |
| 27 |
identical to "channel bonding" or "trunking" techniques used in switches. |
| 28 |
.Pp |
| 29 |
The kernel must have support for bonding devices for |
| 30 |
.Nm |
| 31 |
to be useful. |
| 32 |
.Sh OPTIONS |
| 33 |
.Bl -tag -width indent |
| 34 |
.It Fl a, -all-interfaces |
| 35 |
Show information about all interfaces. |
| 36 |
.It Fl c, -change-active |
| 37 |
Change active slave. |
| 38 |
.It Fl d, -detach |
| 39 |
Removes slave interfaces from the bonding device. |
| 40 |
.It Fl f, -force |
| 41 |
Force actions to be taken if one of the specified interfaces appears not to belong to an Ethernet device. |
| 42 |
.It Fl h, -help |
| 43 |
Display a help message and exit. |
| 44 |
.It Fl u, -usage |
| 45 |
Show usage information and exit. |
| 46 |
.It Fl v, -verbose |
| 47 |
Print warning and debug messages. |
| 48 |
.It Fl V, -version |
| 49 |
Show version information and exit. |
| 50 |
.El |
| 51 |
If not options are given, the default action will be to enslave interfaces. |
| 52 |
.Sh EXAMPLE |
| 53 |
The following example shows how to setup a bonding device and |
| 54 |
enslave two real Ethernet devices to it: |
| 55 |
.Bd -literal |
| 56 |
# modprobe bonding |
| 57 |
# ifconfig bond0 192.168.0.1 netmask 255.255.0.0 |
| 58 |
# ifenslave bond0 eth0 eth1 |
| 59 |
.Ed |
| 60 |
.Sh AUTHOR |
| 61 |
.Nm |
| 62 |
was originally written by |
| 63 |
.An Donald Becker Aq [email protected] , |
| 64 |
and has since been updated by various kernel developers. |
| 65 |
.Pp |
| 66 |
This manual page was written by |
| 67 |
.An Guus Sliepen Aq [email protected] |
| 68 |
for the Debian GNU/Linux system. |