diff options
Diffstat (limited to 'mdk-stage1/rp-pppoe/man/adsl-connect.8')
-rw-r--r-- | mdk-stage1/rp-pppoe/man/adsl-connect.8 | 66 |
1 files changed, 66 insertions, 0 deletions
diff --git a/mdk-stage1/rp-pppoe/man/adsl-connect.8 b/mdk-stage1/rp-pppoe/man/adsl-connect.8 new file mode 100644 index 000000000..1b34a74e5 --- /dev/null +++ b/mdk-stage1/rp-pppoe/man/adsl-connect.8 @@ -0,0 +1,66 @@ +.\" $Id$ +.TH ADSL-CONNECT 8 "21 February 2000" +.UC 4 +.SH NAME +adsl-connect \- Shell script to manage a PPPoE link + +.SH SYNOPSIS +.B adsl-connect \fR[\fIconfig_file\fR] +.P +.B adsl-connect \fR\fIinterface user\fR [\fIconfig_file\fR] + + +.SH DESCRIPTION +\fBadsl-connect\fR is a shell script which manages an ADSL connection +using the Roaring Penguin user-space PPPoE client. If you omit +\fIconfig_file\fR, the default file \fB/etc/ppp/pppoe.conf\fR is used. +If you supply \fIinterface\fR and \fIuser\fR, then they override the +Ethernet interface and user-name settings in the configuration file. +.P +Note that normally, you should \fInot\fR invoke \fBadsl-connect\fR +directly. Instead, use \fBadsl-start\fR to bring up the ADSL connection. +.P +\fBadsl-connect\fR first reads a configuration file. It then brings +up a PPPoE connection. If the connection ever drops, a message is logged +to syslog, and \fBadsl-connect\fR re-establishes the connection. In addition, +each time the connection is dropped or cannot be established, +\fBadsl-connect\fR executes the script \fB/etc/ppp/adsl-lost\fR if it +exists and is executable. + +.P +The shell script \fBadsl-stop\fR causes \fBadsl-connect\fR to break out +of its loop, bring the connection down, and exit. + +.SH TECHNICAL DETAILS +\fBadsl-connect\fR uses the following shell variables from the +configuration file: + +.TP +.B ETH +The Ethernet interface connected to the ADSL modem (for example, eth0). + +.TP +.B USER +The ADSL user-id (for example, b1xxnxnx@sympatico.ca). + +.TP +.B PIDFILE +A file in which to write the process-ID of the adsl-connect process +(for example, \fB/var/run/pppoe.pid\fR). Two additional files +($PIDFILE.pppd and $PIDFILE.pppoe) hold the process-ID's of the +\fBpppd\fR and \fBpppoe\fR processes, respectively. + +.P +By using different configuration files with different PIDFILE +settings, you can manage multiple PPPoE connections. Just specify the +configuration file as an argument to \fBadsl-start\fR and +\fBadsl-stop\fR. + +.SH AUTHOR +\fBadsl-connect\fR was written by David F. Skoll <dfs@roaringpenguin.com>. + +The \fBpppoe\fR home page is \fIhttp://www.roaringpenguin.com/pppoe/\fR. + +.SH 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) + |