srcpkgs/ifenslave/files/ifenslave.8

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