pppd: Check tdb pointer before closing
[ppp.git] / SETUP
1                 Configuring a PPP link.
2
3 After you have compiled and installed this package, there are some
4 configuration files which will generally need to be set up.  The
5 pppd(8) man page is the best reference for the full details; this file
6 outlines the configuration process for the most common case, where
7 this package is being used to enable a machine to dial an ISP and
8 connect to the internet.  The FAQ and README.linux files also provide
9 useful information about setting up PPP.
10
11 Dialling an ISP.
12 ****************
13
14 Usually, an ISP will assign an IP address to your machine, and will
15 refuse to authenticate itself to you.  Some ISPs require a username
16 and password to be entered before PPP service commences, while others
17 use PPP authentication (using either the PAP or CHAP protocols).
18
19 The recommended way to set up to dial an ISP is for the system
20 administrator to create a file under /etc/ppp/peers, named for the ISP
21 that you will be dialling.  For example, suppose the file is called
22 /etc/ppp/peers/isp.  This file would contain something like this:
23
24 ttyS0           # modem is connected to /dev/ttyS0
25 38400           # run the serial port at 38400 baud
26 crtscts         # use hardware flow control
27 noauth          # don't require the ISP to authenticate itself
28 defaultroute    # use the ISP as our default route
29 connect '/usr/sbin/chat -v -f /etc/ppp/chat-isp'
30
31 If there are any other pppd options that should apply when calling
32 this ISP, they can also be placed in this file.
33
34 The /etc/ppp/chat-isp file named in the last line contains the script
35 for chat(8) to use to dial the ISP and go through any username/
36 password authentication required before PPP service starts.  Here is
37 an example (for dialling an Annex terminal server):
38
39 ABORT "NO CARRIER"
40 ABORT "NO DIALTONE"
41 ABORT "ERROR"
42 ABORT "NO ANSWER"
43 ABORT "BUSY"
44 ABORT "Username/Password Incorrect"
45 "" "at"
46 OK "at&d2&c1"
47 OK "atdt2479381"
48 "name:" "^Uusername"
49 "word:" "\qpassword"
50 "annex" "ppp"
51 "Switching to PPP-ppp-Switching to PPP"
52
53 See the chat(8) man page for details of the script.  If you are not
54 sure how the initial dialog with your ISP will go, you could use
55 a terminal emulator such as kermit or minicom to go through the
56 process manually.
57
58 If your ISP requires PAP or CHAP authentication, you will have to
59 create a line in /etc/ppp/pap-secrets or /etc/ppp/chap-secrets like
60 this:
61
62 myhostname      *       "password"
63
64 (Replace myhostname with the hostname of your machine.)
65
66 At this point, you can initiate the link with the command:
67
68 /usr/sbin/pppd call isp
69
70 (N.B.: pppd might be installed in a different directory on some
71 systems).
72
73 This will return to the shell prompt immediately, as pppd will detach
74 itself from its controlling terminal.  (If you don't want it to do
75 this, use the "nodetach" option.)
76
77 Pppd will log messages describing the progress of the connection and
78 any errors using the syslog facility (see the syslogd(8) and
79 syslog.conf(5) man pages).  Pppd issues messages using syslog facility
80 daemon (or local2 if it has been compiled with debugging enabled);
81 chat uses facility local2.  It is often useful to see messages of
82 priority notice or higher on the console.  To see these, find the line
83 in /etc/syslog.conf which has /dev/console on the right-hand side, and
84 add `daemon.notice' on the left.  This line should end up something
85 like this:
86
87 *.err;kern.debug;daemon,local2,auth.notice;mail.crit    /dev/console
88
89 If you want to see more messages from pppd, request messages of
90 priority info or higher for facility daemon, like this:
91
92 *.err;kern.debug;daemon.info;local2,auth.notice;mail.crit  /dev/console
93
94 It is also useful to add a line like this:
95
96 daemon,local2.debug             /etc/ppp/ppp-log
97
98 If you do this, you will need to create an empty /etc/ppp/ppp-log
99 file.
100
101 After modifying syslog.conf, you will then need to send a HUP signal
102 to syslogd (or reboot).
103
104 When you wish terminate the PPP link, you should send a TERM or INTR
105 signal to pppd.  Pppd writes its process ID to a file called
106 ppp<n>.pid in /var/run (or /etc/ppp on older systems such as SunOS or
107 Ultrix).  Here <n> is the PPP interface unit number, which will be 0
108 unless you have more than one PPP link running simultaneously.  Thus
109 you can terminate the link with a command like
110
111         kill `cat /var/run/ppp0.pid`