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
|
.\" Someone tell emacs that this is an -*- nroff -*- source file.
.\" This is free software; see the GNU General Public License version
.\" 2 or later for copying conditions. There is NO warranty.
.TH PPPCONFIG 8 "Version 1.1" "Debian GNU/Linux"
.SH NAME
pppconfig \- configure pppd
.SH SYNOPSIS
.B pppconfig
[--help] | [--version]
.br
.SH DESCRIPTION
.PP
.B pppconfig
is a
.B whiptail
based interactive, menu driven utility to help automate setting up a dial
out ppp connection. It currently supports PAP, CHAP, and chat
authentication. It uses the standard pppd configuration files. Since it
makes changes to system configuration files, you must be logged in as root
or use sudo to run it.
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'.
.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.old
is a backup copy of /etc/ppp/peers/provider. pppconfig creates it if
/etc/ppp/peers/provider exists and does not contain the comment lines
pppconfig inserts to document its changes.
.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.old
is a backup copy of /etc/chatscripts/provider. It is created if
/etc/chatscripts/provider existed when pppconfig was first run, or if it
has been changed since last time pppconfig was run.
.B /var/lib/pppconfig
is a private directory for files decribed below. pppconfig creates it
if necessary, with permission that permit access only to root.
.B /var/lib/pppconfig/provider
is a private file used by pppconfig to remember the chat strings for
provider so that when you re-run pppconfig it will bring up your previously
set values as defaults. It is not used at all when making connections. If
you delete it and run pppconfig again, pppconfig will just use built-in
values as defaults and then recreate the file when you finish. It is
accessible only to root.
.B /var/lib/pppconfig/<name>
is as above, for the provider named <name>.
.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.
.B /etc/resolv.conf
is described in resolv.conf(5). Pppconfig may add nameservers to this file
if it is empty and may create it if it does not exist.
.SH NOTES
.B pppconfig
creates temporary files in
.B /tmp.
It cleans up after all of these. It requires pppd -2.3 or higher.
.SH CAVEATS
.B pppconfig 0.9
is beta software.
.SH TO DO
Add full support for multiple providers and MSCHAP.
The whole thing should be rewritten in perl.
.SH BUGS
Many, no doubt, though I haven't found them yet. The doFiles get stuff is an ugly hack.
.SH "SEE ALSO"
.B pon(1), poff(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 pppconfig
is free software; see the GNU General Public Licence version 2 or
later for copying conditions. There is no warranty.
|
