ADSL-CONNECT(8)ADSL-CONNECT(8)NAMEadsl-connect - Shell script to manage a PPPoE link
SYNOPSISadsl-connect [config_file]
adsl-connect interface user [config_file]
DESCRIPTIONadsl-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 DETAILSadsl-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
($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 settings,
you can manage multiple PPPoE connections. Just specify the configura‐
tion file as an argument to adsl-start and adsl-stop.
AUTHORadsl-connect was written by David F. Skoll <dfs@roaringpenguin.com>.
The pppoe home page is http://www.roaringpenguin.com/pppoe/.
SEE ALSOpppoe(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 2000ADSL-CONNECT(8)