[Guessnet-devel] [svn] r133 - in trunk: . debian
Enrico Zini
enrico at costa.debian.org
Sun Oct 23 12:38:05 UTC 2005
Author: enrico
Date: Sun Oct 23 12:38:05 2005
New Revision: 133
Added:
trunk/FAQ
- copied, changed from r132, web/index.html
Modified:
trunk/debian/docs
Log:
Added a FAQ
Copied: trunk/FAQ (from r132, web/index.html)
==============================================================================
--- web/index.html (original)
+++ trunk/FAQ Sun Oct 23 12:38:05 2005
@@ -1,130 +1,144 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "file:///usr/share/xml/xhtml/schema/dtd/1.1/xhtml11-flat.dtd">
-<html>
- <head>
- <title>Guessnet</title>
- <meta name="generator" content="screem 0.12.1" >
- <meta name="author" content="Enrico Zini" >
- <meta http-equiv="Content-Type" content="text/html;charset=UTF-8" >
- <meta http-equiv="Content-Script-Type" content="text/javascript" >
- <meta http-equiv="Content-Style-Type" content="text/css" >
- <link rel="stylesheet" type="text/css" href="enrico.css" >
- </head>
- <body>
- <h1>Guessnet resources</h1>
-
- <h2>Description</h2>
- <p>Guessnet is a network detection tool to use when moving a machine among
- networks which don't necessarily provide DHCP.</p>
- <p>Guessnet takes in input a list of candidate network profiles,
- each of which includes a test description; then it runs all
- the tests in parallel and prints the name of the profile whose
- test was the first one to succeed.</p>
- <p>Available tests are:
- <ul>
- <li>ARP probes to check for known hosts in the network;</li>
- <li>Link beat check, to check if the interface is connected to anything;</li>
- <li>Wireless lan checks, to look for access points found by waproamd;</li>
- <li>PPPOE check to see if there is a concentrator accessible via PPPOE;</li>
- <li>Miscellaneous other checks provided by custom arbitrary scripts.</li>
- </ul>
- </p>
- <p>Guessnet can be used in either native mode or "ifupdown mode".
- In the latter case,
-h1
-{
- color: #ea5a1b;
-}
- guessnet integrates nicely with ifupdown
- as a "mapping script".</p>
-
-
- <h2>FAQ</h2>
-
- <h3>Can you show me a simple <tt>/etc/network/interfaces</tt> file enhanced with guessnet?</h3>
- <p>Sure:</p>
- <div class="example"><pre>
-auto lo eth0
-iface lo inet loopback
-
-mapping eth0
- # Too bad there's no way to pass commandline options to script
- # script /usr/sbin/guessnet -i
- script /usr/sbin/guessnet-ifupdown
-
- # List of stanzas guessnet should scan for
- # If none is specified, scans for all stanzas
- #map home work
-
- # Profile to select when all tests fail
- map default: none
-
- # If no test succeed after this amount of seconds,
- # then guessnet selects the default profile
- map timeout: 3
-
- # Uncomment if something goes wrong:
- #map verbose: true
- #map debug: true
-
-# Home network configuration
-iface home inet static
- address 192.168.1.2
- netmask 255.255.255.0
- broadcast 192.168.1.255
- gateway 192.168.1.1
- dns-search home.loc
- dns-nameservers 192.168.1.1
- # Check for one of these hosts:
- test peer address 192.168.1.1 mac 00:01:02:03:04:05
-
-# Bogus configuration to use when there is no cable plugged on the
-# interface. This avoids those long, boring DHCP timeouts at boot!
-#
-# Many network drivers want some real-looking data anyway. I'd really
-# appreciate a way to just keep the interface down (see bug #275326).
-iface disconnected inet static
- address 192.168.1.2
- netmask 255.255.255.0
- test missing-cable
-
-# If nothing is found, try negotiating DHCP
-iface none inet dhcp
+============
+Guessnet FAQ
+============
+
+-----------------
+General questions
+-----------------
+
+Can you show me a simple ``/etc/network/interfaces`` file enhanced with guessnet?
+---------------------------------------------------------------------------------
+
+Sure::
+ auto lo eth0
+ iface lo inet loopback
+
+ mapping eth0
+ # Too bad there's no way to pass commandline options to script
+ # script /usr/sbin/guessnet -i
+ script /usr/sbin/guessnet-ifupdown
+
+ # List of stanzas guessnet should scan for
+ # If none is specified, scans for all stanzas
+ #map home work
+
+ # Profile to select when all tests fail
+ map default: none
+
+ # If no test succeed after this amount of seconds,
+ # then guessnet selects the default profile
+ map timeout: 3
+
+ # Uncomment if something goes wrong:
+ #map verbose: true
+ #map debug: true
+
+ # Home network configuration
+ iface home inet static
+ address 192.168.1.2
+ netmask 255.255.255.0
+ broadcast 192.168.1.255
+ gateway 192.168.1.1
+ dns-search home.loc
+ dns-nameservers 192.168.1.1
+ # Check for one of these hosts:
+ test peer address 192.168.1.1 mac 00:01:02:03:04:05
+
+ # Bogus configuration to use when there is no cable plugged on the
+ # interface. This avoids those long, boring DHCP timeouts at boot!
+ #
+ # Many network drivers want some real-looking data anyway. I'd really
+ # appreciate a way to just keep the interface down (see bug #275326).
+ iface disconnected inet static
+ address 192.168.1.2
+ netmask 255.255.255.0
+ test missing-cable
+
+ # If nothing is found, try negotiating DHCP
+ iface none inet dhcp
</pre></div>
-
- <h3>What is the difference between guessnet and whereami, intuitively, laptop-net, divine, ...</h3>
- <p>The main difference is that guessnet only cares about selecting a network profile, and has no functionalities to reconfigure the system.</p>
- <p>The main purpose of guessnet is integrating with <a href="http://packages.debian.org/ifupdown" ><tt>ifupdown</tt></a>, adding automatic
- network detection to a Debian system with very minimum changes.<p>
-
-
- <h2>Troubleshooting</h2>
-
- <h3>Link beat does not work: when guessnet tries to check it, the interface is still down for configuration</h3>
- <p>This problem is caused by some network drivers going down and needing
- lots of time to go up again after being configured.</p>
- <p>Try working around the problem by adding:<br/>
- <tt>map init-time: 5</tt>
- (or higher numbers) to the mapping stanza of your interfaces file: that
- asks guessnet to wait for 5 seconds (instead of the default 3 seconds)
- after bringing up the interface.</p>
- <p>If it doesn't work with 5 seconds, try with 10 :) At some point, it
- should work, then you try smaller numbers to fit your needs.</p>
-
-
- <h2>Development resources</h2>
- <dl>
- <dt>APT Repository</dt>
- <dd><tt>deb http://guessnet.alioth.debian.org/debian unstable main</tt></dd>
- <dt>APT Repository</dt>
- <dd><tt>deb http://guessnet.alioth.debian.org/debian unstable main</tt></dd>
- <dt>Development mailing list</dt>
- <dd><a href="http://lists.alioth.debian.org/mailman/listinfo/guessnet-devel">http://lists.alioth.debian.org/mailman/listinfo/guessnet-devel</a></dd>
- <dt>Subversion repository</dt>
- <dd><tt>svn co svn://svn.debian.org/guessnet/trunk guessnet</tt></dd>
- </dl>
-
- <h2>Authors</h2>
- Guessnet is written by <a href="http://www.enricozini.org" >Enrico Zini</a> with the help of Thomas Hood.
- </body>
-</html>
+What is the difference between guessnet and whereami, intuitively, laptop-net, divine, ...
+------------------------------------------------------------------------------------------
+
+The main difference is that guessnet only cares about selecting a network
+profile, and has no functionalities to reconfigure the system.
+
+The main purpose of guessnet is integrating with ifupdown_, adding
+automatic network detection to a Debian system with very minimum changes.
+
+---------------
+Troubleshooting
+---------------
+
+Link beat does not work: when guessnet tries to check it, the interface is still down for configuration
+-------------------------------------------------------------------------------------------------------
+
+This problem is caused by some network drivers going down and needing lots of
+time to go up again after being configured.
+
+Try working around the problem by adding::
+ map init-time: 5
+(or higher numbers) to the mapping stanza of your interfaces file: that asks
+guessnet to wait for 5 seconds (instead of the default 3 seconds) after
+bringing up the interface.
+
+If it doesn't work with 5 seconds, try with 10 :) At some point, it should
+work, then you try smaller numbers to fit your needs.
+
+
+I can't find a host that answers ARP requests coming from 0.0.0.0: can I use a peer scan anyway?
+------------------------------------------------------------------------------------------------
+
+Yes, using the source address. If you had this::
+
+ iface work inet static
+ address 192.168.1.41
+ test peer address 192.168.1.1 mac 00:0C:CE:03:0F:E0
+
+try this::
+
+ iface work inet static
+ address 192.168.1.41
+ test peer address 192.168.1.1 mac 00:0C:CE:03:0F:E0 source 192.168.1.42
+
+If instead you don't know the IP address you're going to get, try using a
+broadcast address as a source address::
+
+ iface work inet dhcp
+ test peer address 192.168.1.1 mac 00:0C:CE:03:0F:E0 source 192.168.1.0
+
+If using a broadcast address (that is, ending with 0) as a source address
+doesn't work either, using a valid IP (possibly one you know it's unused) might
+work.
+
+
+pppoe scans do not work
+-----------------------
+
+Unfortunately I implemented the PPPOE scans some time ago when I had a PPPOE
+modem, but after that I never needed that feature myself, and now I don't even
+have a PPPOE modem anymore.
+
+This means that I'm in need of someone to maintain the PPPOE scans; I'm sorry I
+can't help much.
+
+However, going through old mail I just found that someone had problems with
+pppoe scans and solved using a stanza like this::
+
+ iface home inet ppp
+ test pppoe
+ provider providername
+ up ifconfig eth0 up
+ down ifconfig eth0 down
+
+If those 'up' and 'down' commands work for you, please let me know.
+
+If you also happen to know *why* they work, I'd be even more interested :)
+
+
+
+.. _ifupdown: http://packages.debian.org/ifupdown
+
+..
+ vim:set syntax=rst:
Modified: trunk/debian/docs
==============================================================================
--- trunk/debian/docs (original)
+++ trunk/debian/docs Sun Oct 23 12:38:05 2005
@@ -1,2 +1,3 @@
README
+FAQ
doc/Saner-Defaults-HOWTO
More information about the Guessnet-devel
mailing list