ADSL-CONNECT(8)						      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 config_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	addi-
       tion,  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 exam-
	      ple, 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 ($PIDFILE.pppd and $PIDFILE.pppoe) hold the	 process-ID's
	      of the pppd and pppoe processes, respectively.


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


AUTHOR
       adsl-connect was written by David F. Skoll .

       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)

UNIX/Linux commands referenced on this page:

1. script
2. which
3. file
4. adsl-start
5. time
6. adsl-stop
7. write
8. pppd
9. pppoe
10. as