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