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