adsl-connect(8) [redhat man page]

ADSL-CONNECT(8) 					      System Manager's Manual						   ADSL-CONNECT(8)

NAME

       adsl-connect - Shell script to manage a PPPoE link

SYNOPSIS

       adsl-connect [config_file]

       adsl-connect interface user [config_file]

DESCRIPTION

       adsl-connect  is  a  shell  script  which  manages  an ADSL connection using the Roaring Penguin user-space PPPoE client.  If you omit con-
       fig_file, the default file /etc/sysconfig/network-scripts/ifcfg-ppp0 is used.  If you supply interface and user,  then  they  override  the
       Ethernet interface and user-name settings in the configuration file.

       Note that normally, you should not invoke adsl-connect directly.  Instead, use adsl-start to bring up the ADSL connection.

       adsl-connect first reads a configuration file.  It then brings up a PPPoE connection.  If the connection ever drops, a message is logged to
       syslog, and adsl-connect re-establishes the connection.	In addition, each time the connection is dropped or cannot be  established,  adsl-
       connect executes the script /etc/ppp/adsl-lost if it exists and is executable.

       The shell script adsl-stop causes adsl-connect to break out of its loop, bring the connection down, and exit.

TECHNICAL DETAILS

       adsl-connect uses the following shell variables from the configuration file:

       ETH    The Ethernet interface connected to the ADSL modem (for example, eth0).

       USER   The ADSL user-id (for example, b1xxnxnx@sympatico.ca).

       PIDFILE
	      A  file in which to write the process-ID of the adsl-connect process (for example, /var/run/pppoe.pid).  Two additional files ($PID-
	      FILE.pppd and $PIDFILE.pppoe) hold the process-ID's of the pppd and pppoe processes, respectively.

       By using different configuration files with different PIDFILE settings, you can manage multiple PPPoE connections.  Just specify  the  con-
       figuration file as an argument to adsl-start and adsl-stop.

AUTHOR

       adsl-connect was written by David F. Skoll <dfs@roaringpenguin.com>.

       The pppoe home page is http://www.roaringpenguin.com/pppoe/.

SEE ALSO

       pppoe(8),  adsl-start(8),  adsl-stop(8),  pppd(8),  pppoe.conf(5),  adsl-setup(8),  adsl-status(8), pppoe-sniff(8), pppoe-server(8), pppoe-
       relay(8)

4th Berkeley Distribution					 21 February 2000						   ADSL-CONNECT(8)

PPPOE-SNIFF(8)						      System Manager's Manual						    PPPOE-SNIFF(8)

NAME

       pppoe-sniff - examine network for non-standard PPPoE frames

SYNOPSIS

       pppoe-sniff [options]

DESCRIPTION

       pppoe-sniff listens for likely-looking PPPoE PADR and session frames and deduces extra options required for pppoe(8) to work.

       Some  DSL providers seem to use non-standard frame types for PPPoE frames, and/or require a certain value in the Service-Name field.  It is
       often easier to sniff those values from a machine which can successfully connect rather than try to pry them out of the DSL provider.

       To use pppoe-sniff, you need two computers, a DSL modem and an Ethernet hub (not an Ethernet switch.)

       If the DSL modem normally connects directly to your computer's Ethernet card, connect it to the "uplink" port on the  Ethernet  hub.   Plug
       two  computers into normal ports on the hub.  On one computer, run whatever software the DSL provider gave you on whatever operating system
       the DSL provider supports.  On the other computer, run Linux and log in as root.

       On the Linux machine, put the Ethernet interface into promiscuous mode and start pppoe-sniff.  If the ethernet interface is eth0, for exam-
       ple, type these commands:

	    ifconfig eth0 promisc
	    pppoe-sniff -I eth0

       On  the	other  machine, start your DSL connection as usual.  After a short time, pppoe-sniff should print recommendations for the value of
       PPPOE_EXTRA.  Set this value in /etc/ppp/pppoe.conf.  If pppoe-sniff indicates that something special is required in PPPOE_EXTRA, please e-
       mail this to pppoe@roaringpenguin.com along with the name of your ISP and the manufacturer and model number of your DSL modem.  This infor-
       mation will be collated and provided on the PPPoE web page for users who do not have two computers.

       After pppoe-sniff finishes (or you stop it if it seems hung), remember to turn off promiscuous mode:

	    ifconfig eth0 -promisc

OPTIONS

       -I interface
	      The -I option specifies the Ethernet interface to use.  Under Linux, it is typically eth0 or eth1.  The interface should be "up" and
	      in promiscuous mode before you start pppoe-sniff.

       -V     The -V option causes pppoe-sniff to print its version number and exit.

BUGS

       pppoe-sniff only works on Linux.

AUTHORS

       pppoe-sniff was written by David F. Skoll <dfs@roaringpenguin.com>.

       The pppoe home page is http://www.roaringpenguin.com/pppoe/.

SEE ALSO

       adsl-start(8),  adsl-stop(8),  adsl-connect(8),	pppd(8),  pppoe.conf(5),  pppoe(8), adsl-setup(8), adsl-status(8), pppoe-server(8), pppoe-
       relay(8)

4th Berkeley Distribution					    3 July 2000 						    PPPOE-SNIFF(8)