version 1, including all changes.
.
| Rev |
Author |
# |
Line |
| 1 |
perry |
1 |
PPPCONFIG |
| |
|
2 |
!!!PPPCONFIG |
| |
|
3 |
NAME |
| |
|
4 |
SYNOPSIS |
| |
|
5 |
DESCRIPTION |
| |
|
6 |
FILES |
| |
|
7 |
NOTES |
| |
|
8 |
TO DO |
| |
|
9 |
BUGS |
| |
|
10 |
SEE ALSO |
| |
|
11 |
AUTHOR |
| |
|
12 |
COPYRIGHT |
| |
|
13 |
---- |
| |
|
14 |
!!NAME |
| |
|
15 |
|
| |
|
16 |
|
| |
|
17 |
pppconfig - configure pppd |
| |
|
18 |
!!SYNOPSIS |
| |
|
19 |
|
| |
|
20 |
|
| |
|
21 |
__pppconfig__ [[--version] | [[--help] | [[[[--dialog] | |
| |
|
22 |
[[--whiptail] | [[--gdialog] [[--noname] | |
| |
|
23 |
[[providername]] |
| |
|
24 |
!!DESCRIPTION |
| |
|
25 |
|
| |
|
26 |
|
| |
|
27 |
__pppconfig__ is a __dialog__ based interactive, menu |
| |
|
28 |
driven utility to help automate setting up a dial out ppp |
| |
|
29 |
connection. It provides extensive explanations at each step. |
| |
|
30 |
pppconfig supports PAP, CHAP, and chat methods of |
| |
|
31 |
authentication. It uses the standard ppp configuration files |
| |
|
32 |
and sets ppp up so that the standard pon and poff commands |
| |
|
33 |
can be used to control ppp. Some features supported by |
| |
|
34 |
pppconfig are: |
| |
|
35 |
- Multiple ISP's with seperate nameservers. |
| |
|
36 |
- Modem detection. |
| |
|
37 |
- Dynamic DNS. |
| |
|
38 |
- Dial on demand. |
| |
|
39 |
- Allow non-root users to run ppp. |
| |
|
40 |
- Uses the gdialog GUI dialog replacement if |
| |
|
41 |
possible. |
| |
|
42 |
|
| |
|
43 |
|
| |
|
44 |
Before running pppconfig you should know what sort of |
| |
|
45 |
authentication your isp requires, the username and password |
| |
|
46 |
that they want you to use, and the phone number. If they |
| |
|
47 |
require you to use chat authentication, you will also need |
| |
|
48 |
to know the login and password prompts and any other prompts |
| |
|
49 |
and responses required for login. If you can't get this |
| |
|
50 |
information from your isp you could try dialing in with |
| |
|
51 |
minicom and working through the procedure until you get the |
| |
|
52 |
garbage that indicates that ppp has started on the other |
| |
|
53 |
end. |
| |
|
54 |
|
| |
|
55 |
|
| |
|
56 |
__pppconfig__ allows you to configure connections to |
| |
|
57 |
multiple providers. For example, you might call your isp |
| |
|
58 |
'provider', your employer 'theoffice' and your university |
| |
|
59 |
'theschool'. Then you can connect to your isp with |
| |
|
60 |
theschool'. |
| |
|
61 |
|
| |
|
62 |
|
| |
|
63 |
It can determine which serial port your modem is on, but the |
| |
|
64 |
serial port must already be configured. This is normally |
| |
|
65 |
done when installing Linux. |
| |
|
66 |
|
| |
|
67 |
|
| |
|
68 |
It can help you set your nameservers, or, if your ISP uses |
| |
|
69 |
'dynamic DNS', it can set up ppp to use that. |
| |
|
70 |
|
| |
|
71 |
|
| |
|
72 |
It can configure ppp for demand dialing, so that your ppp |
| |
|
73 |
connection will come up automatically. It will not, however, |
| |
|
74 |
start pppd for you. You must still start pppd yourself |
| |
|
75 |
('pon' will do it). Pppd will then wait in the background |
| |
|
76 |
for you to attempt to access the Net and bring up the |
| |
|
77 |
link. |
| |
|
78 |
!!FILES |
| |
|
79 |
|
| |
|
80 |
|
| |
|
81 |
__/etc/ppp/peers/provider__ is the standard pppd options |
| |
|
82 |
file for the default service provider. |
| |
|
83 |
|
| |
|
84 |
|
| |
|
85 |
__/etc/ppp/peers/__ is the pppd options file |
| |
|
86 |
for the provider that you have named |
| |
|
87 |
__ |
| |
|
88 |
|
| |
|
89 |
|
| |
|
90 |
__/etc/ppp/peers/provider.bak__ is a backup copy of |
| |
|
91 |
/etc/ppp/peers/provider. |
| |
|
92 |
|
| |
|
93 |
|
| |
|
94 |
__/etc/chatscripts/provider__ is the standard chat script |
| |
|
95 |
for the default service provider. |
| |
|
96 |
|
| |
|
97 |
|
| |
|
98 |
__/etc/chatscripts/__ is the chat script for |
| |
|
99 |
the provider that you have named __ |
| |
|
100 |
|
| |
|
101 |
|
| |
|
102 |
__/etc/chatscripts/provider.bak__ is a backup copy of |
| |
|
103 |
/etc/chatscripts/provider. |
| |
|
104 |
|
| |
|
105 |
|
| |
|
106 |
__/etc/ppp/resolv__ is a directory where resolv.conf |
| |
|
107 |
files for each provider are stored. |
| |
|
108 |
|
| |
|
109 |
|
| |
|
110 |
__/etc/ppp/ip-up.d/0dns-up__ is a script that arranges |
| |
|
111 |
for the correct resolv.conf file to be copied into place |
| |
|
112 |
when a connection comes up. |
| |
|
113 |
|
| |
|
114 |
|
| |
|
115 |
__/etc/ppp/ip-down.d/0dns-down__ is a script that |
| |
|
116 |
arranges for the original resolv.conf file to be copied into |
| |
|
117 |
place when a connection goes down. |
| |
|
118 |
|
| |
|
119 |
|
| |
|
120 |
__/etc/init.d/dns-clean__ is a script that runs 0dns-down |
| |
|
121 |
at bootup to clean up any mess left by a crash. |
| |
|
122 |
|
| |
|
123 |
|
| |
|
124 |
__/etc/ppp/pap-secrets__ and __/etc/ppp/chap-secrets__ |
| |
|
125 |
are described in the pppd documentation. pppconfig may add |
| |
|
126 |
lines to these files and will change lines that it |
| |
|
127 |
proviously added. |
| |
|
128 |
!!NOTES |
| |
|
129 |
|
| |
|
130 |
|
| |
|
131 |
__pppconfig__ requires pppd 2.3.7 or higher. |
| |
|
132 |
!!TO DO |
| |
|
133 |
|
| |
|
134 |
|
| |
|
135 |
Add full support for MSCHAP. |
| |
|
136 |
!!BUGS |
| |
|
137 |
|
| |
|
138 |
|
| |
|
139 |
Don't tell pppconfig to find your modem while pppd is |
| |
|
140 |
running. |
| |
|
141 |
!!SEE ALSO |
| |
|
142 |
|
| |
|
143 |
|
| |
|
144 |
__pon(1), poff(1), gpppon(1), plog(1), pppd(8), |
| |
|
145 |
chat(8),__ and __whiptail(1).__ |
| |
|
146 |
!!AUTHOR |
| |
|
147 |
|
| |
|
148 |
|
| |
|
149 |
__pppconfig__ was written by John Hasler |
| |
|
150 |
__ |
| |
|
151 |
!!COPYRIGHT |
| |
|
152 |
|
| |
|
153 |
|
| |
|
154 |
__This man page may be treated as if it was__ in the |
| |
|
155 |
public domain. |
| |
|
156 |
---- |
