[Guessnet-devel] [svn] r121 - trunk

[Thomas Hood]

Author: jdthood-guest
Date: Mon May  2 14:33:45 2005
New Revision: 121

Modified:
   trunk/guessnet.8
Log:
Improve description of missing-cable test in guessnet.8

Modified: trunk/guessnet.8
==============================================================================
--- trunk/guessnet.8	(original)
+++ trunk/guessnet.8	Mon May  2 14:33:45 2005
@@ -146,7 +146,7 @@
 .P
 In ifupdown mode
 if names are passed to \fBguessnet\fP on its standard input then
-\fBguessnet\fP considers only those logical interfaces;
+\fBguessnet\fP considers only those logical interface definitions;
 otherwise it considers them all.
 You can have \fBifupdown\fP deliver data to \fBguessnet\fP's standard input using
 the \fImap\fP directive.
@@ -262,10 +262,24 @@
 This feature allows guessnet to detect the case
 where there is no cable plugged into a network socket;
 in this case it makes no sense to go through other detection phases.
-This can dramatically increase boot time for system that try DHCP when
-nothing is found.
+.sp
+This test can be used in ifupdown mode too if
+a dummy logical interface is defined
+that includes the \fBtest missing\-cable\fP option.
+Bear in mind that when the cable is unplugged,
+ifupdown will consider the interface to be configured
+as this dummy logical interface.
+That is somewhat counterintuitive;
+one might prefer the interface to be deconfigured in that case.
+Unfortunately, guessnet is not currently able to tell ifup
+to refrain from configuring an interface.
+The problem can be solved, however, by means of the
+.BR ifplugd (8)
+program.
 .sp
 Link beat detection is not supported on all network hardware.
+If the interface or its driver does not support link beat detection
+then this test does not succeed.
 
 .SS command
 .TP
@@ -351,7 +365,7 @@
 to make sure that you have the information in the cache.
 You can also take a look at the /usr/share/doc/guessnet/examples/getmac script.
 .SS "Multiple tests"
-Currently \fBguessnet\fP only supports specifying a single test per profile.
+Currently \fBguessnet\fP only supports specifying one kind of test per profile.
 
 .SH SEE ALSO
 .BR ifup (8),
@@ -359,6 +373,7 @@
 .BR arping (8),
 .BR sh (1),
 .BR pppoe (8),
+.BR ifplugd (8),
 .BR waproamd (8).
 
 .SH AUTHOR