.\" extracted from ppp.pl by cmt2doc.pl
.TH PPP 8 "23 January 1999" "FreeWare" "MAINTENANCE COMMANDS"
.PD .8v
.SH NAME

ppp\&.pl \- setup PPP connection.

.SH SYNOPSIS
.nf
\fBppp\&.pl\fR [options]
.fi

.SH DESCRIPTION

A bit more flexible than chat(1).
It picks up defaults from .${Myname}rc\&.pl so linking different
names to it is a handy way of picking a configuration.

Essentially, the script runs tip(1), and drives it to
establish an authenticated login.  This is all driven by
regexps in the %RE table.  For example:
.nf

%RE = (\fBCONNECT\fR, '',
       \fBOK\fR, \fIATDT$opt_X$opt_P\\r\fR,
       \fBogin:\fR, \fI$opt_u\\r\fR,
       \fBsername:\fR, \fI$opt_u\\r\fR,
       \fBword:\fR, \fI$opt_p\\r\fR,
       \fBhallenge:\fR, \fBinteract::Acce\fR,
       \fBPPP\fR, \fBsub:pppd:\fR,
       \fBDevice Busy\fR, \fBsub:exit:1\fR,
       );
.fi

The keys are strings received from the remote node, and the
values are either simple strings to respond with or actions to
perform \- like calling pppd if PPP is seen.

The pppd routine, suspends tip(1), and runs pppd(8) in
background before returning to tip and terminating it.
.TP
Options:
.TP
\fB\-X\fR \fIxtras\fR
Any extra magic needed for dialing.  Lets you set
$opt_P in a \&.rc file and use \-X 0, for when a dial
prefix is needed to get past a PABX.
.TP
\fB\-P\fR \fIphoneNo\fR
The \fIphoneNo\fR to call \- should include pauses etc as
needed by your modem.
.TP
\fB\-u\fR \fIuser\fR
The user you need to authenticate as.
.TP
\fB\-p\fR \fIpassword\fR
The \fIpassword\fR for \fIuser\fR.  If serious challenge
response is being used, this \fIpassword\fR is often
irrelevant. 
.TP
\fB\-d\fR \fIdevice\fR
The \fIdevice\fR that tip(1) will be told to use.
Default is \fBmodem\fR.
.TP
\fB\-f\fR \fItty\fR
The device that pppd(8) will be told to use.
.TP
\fB\-c\fR \fIconfig\fR
Read more settings from \fIconfig\fR this is processed
_after_ both \&.rc file and command line options.
Can be useful for extending the %RE table.
.TP
\fB\-v\fR
Be verbose.

.SH AUTHOR
.PP
Simon J. Gerraty <sjg@quick\&.com\&.au>
