Section: Maintenance Commands (8)
Updated: 21 February 2000
Return to Main Contents
adsl-connect - Shell script to manage a PPPoE link
adsl-connect interface user [config_file]
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 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.
adsl-connect uses the following shell variables from the
The Ethernet interface connected to the ADSL modem (for example, eth0).
The ADSL user-id (for example, email@example.com).
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
configuration file as an argument to adsl-start and
adsl-connect was written by David F. Skoll <firstname.lastname@example.org>.
The pppoe home page is http://www.roaringpenguin.com/pppoe/.
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)
- TECHNICAL DETAILS
- SEE ALSO
linux.jgfs.net manual pages