xref: /src/external/bsd/ppp/dist/SETUP

		Configuring a PPP link.

After you have compiled and installed this package, there are some
configuration files which will generally need to be set up.  The
pppd(8) man page is the best reference for the full details; this file
outlines the configuration process for the most common case, where
this package is being used to enable a machine to dial an ISP and
connect to the internet.  The FAQ and README.linux files also provide
useful information about setting up PPP.

Dialling an ISP.
****************

Usually, an ISP will assign an IP address to your machine, and will
refuse to authenticate itself to you.  Some ISPs require a username
and password to be entered before PPP service commences, while others
use PPP authentication (using either the PAP or CHAP protocols).

The recommended way to set up to dial an ISP is for the system
administrator to create a file under /etc/ppp/peers, named for the ISP
that you will be dialling.  For example, suppose the file is called
/etc/ppp/peers/isp.  This file would contain something like this:

ttyS0		# modem is connected to /dev/ttyS0
38400		# run the serial port at 38400 baud
crtscts		# use hardware flow control
noauth		# don't require the ISP to authenticate itself
defaultroute	# use the ISP as our default route
connect '/usr/sbin/chat -v -f /etc/ppp/chat-isp'

If there are any other pppd options that should apply when calling
this ISP, they can also be placed in this file.

The /etc/ppp/chat-isp file named in the last line contains the script
for chat(8) to use to dial the ISP and go through any username/
password authentication required before PPP service starts.  Here is
an example (for dialling an Annex terminal server):

ABORT "NO CARRIER"
ABORT "NO DIALTONE"
ABORT "ERROR"
ABORT "NO ANSWER"
ABORT "BUSY"
ABORT "Username/Password Incorrect"
"" "at"
OK "at&d2&c1"
OK "atdt2479381"
"name:" "^Uusername"
"word:" "\qpassword"
"annex" "ppp"
"Switching to PPP-ppp-Switching to PPP"

See the chat(8) man page for details of the script.  If you are not
sure how the initial dialog with your ISP will go, you could use
a terminal emulator such as kermit or minicom to go through the
process manually.

If your ISP requires PAP or CHAP authentication, you will have to
create a line in /etc/ppp/pap-secrets or /etc/ppp/chap-secrets like
this:

myhostname	*	"password"

(Replace myhostname with the hostname of your machine.)

At this point, you can initiate the link with the command:

/usr/sbin/pppd call isp

(N.B.: pppd might be installed in a different directory on some
systems).

This will return to the shell prompt immediately, as pppd will detach
itself from its controlling terminal.  (If you don't want it to do
this, use the "nodetach" option.)

Pppd will log messages describing the progress of the connection and
any errors using the syslog facility (see the syslogd(8) and
syslog.conf(5) man pages).  Pppd issues messages using syslog facility
daemon (or local2 if it has been compiled with debugging enabled);
chat uses facility local2.  It is often useful to see messages of
priority notice or higher on the console.  To see these, find the line
in /etc/syslog.conf which has /dev/console on the right-hand side, and
add `daemon.notice' on the left.  This line should end up something
like this:

*.err;kern.debug;daemon,local2,auth.notice;mail.crit	/dev/console

If you want to see more messages from pppd, request messages of
priority info or higher for facility daemon, like this:

*.err;kern.debug;daemon.info;local2,auth.notice;mail.crit  /dev/console

It is also useful to add a line like this:

daemon,local2.debug		/etc/ppp/ppp-log

If you do this, you will need to create an empty /etc/ppp/ppp-log
file.

After modifying syslog.conf, you will then need to send a HUP signal
to syslogd (or reboot).

When you wish terminate the PPP link, you should send a TERM or INTR
signal to pppd.  Pppd writes its process ID to a file called
ppp<n>.pid in /var/run (or /etc/ppp on older systems such as SunOS or
Ultrix).  Here <n> is the PPP interface unit number, which will be 0
unless you have more than one PPP link running simultaneously.  Thus
you can terminate the link with a command like

	kill `cat /var/run/ppp0.pid`