mention failover mode and add examples

1 files changed, 25 insertions, 4 deletions

diff --git a/share/man/man4/trunk.4 b/share/man/man4/trunk.4
index 2a3d16c4228..fddd2bba41f 100644
--- a/share/man/man4/trunk.4
+++ b/share/man/man4/trunk.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: trunk.4,v 1.3 2005/05/31 20:57:49 jmc Exp $
+.\"	$OpenBSD: trunk.4,v 1.4 2005/10/03 02:22:13 reyk Exp $
 .\"
 .\" Copyright (c) 2005 Reyk Floeter <reyk@vantronix.net>
 .\"
@@ -48,7 +48,8 @@ The driver currently supports the trunk protocols
 .Ic roundrobin
 .Oo
 .Ic default
-.Oc
+.Oc ,
+.Ic failover ,
 and
 .Ic none
 for link aggregation and link failover.
@@ -57,6 +58,28 @@ The configuration can be done at runtime or by setting up a
 .Xr hostname.if 5
 configuration file for
 .Xr netstart 8 .
+.Sh EXAMPLES
+Create a simple round robin trunk with two bge(4) gigabit ethernet
+interfaces:
+.Bd -literal -offset indent
+# ifconfig bge0 up
+# ifconfig bge1 up
+# ifconfig trunk0 create
+# ifconfig trunk0 trunkport bge0 trunkport bge1 192.168.1.1 \e
+	netmask 255.255.255.0 up
+.Ed
+.Pp
+The following example uses an active failover trunk to realise roaming
+between wired and wireless networks using two network devices.
+Whenever the wired master interface is unplugged, the wireless failover
+device will be used:
+.Bd -literal -offset indent
+# ifconfig em0 up
+# ifconfig ath0 192.168.1.1 netmask 255.255.255.0 nwid my_net up
+# ifconfig trunk0 create
+# ifconfig trunk0 trunkport em0 trunkport ath0 192.168.1.1 \e
+	netmask 255.255.255.0 up
+.Ed
 .Sh SEE ALSO
 .Xr inet 4 ,
 .Xr hostname.if 5 ,
@@ -72,5 +95,3 @@ The
 .Nm
 driver was written by
 .An Reyk Floeter Aq reyk@openbsd.org .
-.Sh CAVEATS
-Currently only the roundrobin trunk protocol is supported.