Debian Codegraph @

upstream/mageia-cauldron/man8/ifenslave.8

raw
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.