"SfR Fresh" - the SfR Freeware/Shareware Archive 
Member "rp-pppoe-3.10/man/pppoe-connect.8" of archive rp-pppoe-3.10.tar.gz:
Caution: As a special service "SfR Fresh" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even errorneous.
Alternatively you can here view or download the uninterpreted manual source code.
That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.
Table of Contents
pppoe-connect - Shell script to manage a PPPoE link
pppoe-connect
[config_file]
pppoe-connect interface user [config_file]
pppoe-connect
is a shell script which manages a PPPoE connection 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 pppoe-connect directly. Instead, use pppoe-start to
bring up the PPPoE connection.
pppoe-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 pppoe-connect re-establishes the connection.
In addition, each time the connection is dropped or cannot be established,
pppoe-connect executes the script /etc/ppp/pppoe-lost if it exists and is
executable.
The shell script pppoe-stop causes pppoe-connect to break out
of its loop, bring the connection down, and exit.
pppoe-connect
uses the following shell variables from the configuration file:
- ETH
- The
Ethernet interface connected to the DSL modem (for example, eth0).
- USER
- The PPPoE user-id (for example, b1xxnxnx@sympatico.ca).
- PIDFILE
- A file in
which to write the process-ID of the pppoe-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 pppoe-start and pppoe-stop.
pppoe-connect was written
by David F. Skoll <dfs@roaringpenguin.com>.
The pppoe home page is http://www.roaringpenguin.com/pppoe/.
pppoe(8), pppoe-start(8), pppoe-stop(8), pppd(8), pppoe.conf(5),
pppoe-setup(8), pppoe-status(8), pppoe-sniff(8), pppoe-server(8), pppoe-relay(8)
Table of Contents