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 inter- face 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 exe- cutable.
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, email@example.com).
PIDFILE A file in which to write the process-ID of the adsl-connect pro- cess (for example, /var/run/pppoe.pid). Two additional files ($PIDFILE.pppd and $PIDFILE.pppoe) hold the process-IDs 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 configura- tion file as an argument to adsl-start and adsl-stop.
AUTHOR adsl-connect was written by David F. Skoll <firstname.lastname@example.org>.
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)