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

NAME

4     ifenslave — Attach and detach slave network devices to a bonding device.
5

SYNOPSIS

7     ifenslave [-acdfhuvV] [--all-interfaces] [--change-active] [--detach]
8               [--force] [--help] [--usage] [--verbose] [--version] master
9               slave ...
10

DESCRIPTION

12     ifenslave is a tool to attach and detach slave network devices to a bond‐
13     ing device.  A bonding device will act like a normal Ethernet network
14     device to the kernel, but will send out the packets via the slave devices
15     using a simple round-robin scheduler.  This allows for simple load-bal‐
16     ancing, identical to "channel bonding" or "trunking" techniques used in
17     switches.
18
19     The kernel must have support for bonding devices for ifenslave to be use‐
20     ful.
21

OPTIONS

23     -a, --all-interfaces
24             Show information about all interfaces.
25
26     -c, --change-active
27             Change active slave.
28
29     -d, --detach
30             Removes slave interfaces from the bonding device.
31
32     -f, --force
33             Force actions to be taken if one of the specified interfaces
34             appears not to belong to an Ethernet device.
35
36     -h, --help
37             Display a help message and exit.
38
39     -u, --usage
40             Show usage information and exit.
41
42     -v, --verbose
43             Print warning and debug messages.
44
45     -V, --version
46             Show version information and exit.
47     If not options are given, the default action will be to enslave inter‐
48     faces.
49

EXAMPLE

51     The following example shows how to setup a bonding device and enslave two
52     real Ethernet devices to it:
53
54     # modprobe bonding
55     # ifconfig bond0 192.168.0.1 netmask 255.255.0.0
56     # ifenslave bond0 eth0 eth1
57

AUTHOR

59     ifenslave was originally written by Donald Becker
60     <becker@cesdis.gsfc.nasa.gov>, and has since been updated by various ker‐
61     nel developers.
62
63     This manual page was written by Guus Sliepen <guus@debian.org> for the
64     Debian GNU/Linux system.
65
66                                 June 20, 2019
Impressum