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 con­
       nection using the Roaring Penguin user-space PPPoE client.
       If    you    omit    config_file,    the    default   file
       /etc/ppp/pppoe.conf 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-con­
       nect  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@sympa­
              tico.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


       By using different configuration files with different PID­
       FILE  settings, 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 <dfs@roaring­
       penguin.com>.

       The   pppoe   home    page    is    http://www.roaringpen­
       guin.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)


Man(1) output converted with man2html