PPPCONFIG(8)

NAME
pppconfig - configure pppd

SYNOPSIS
pppconfig [--help] | [--version]

DESCRIPTION

pppconfig is a 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. 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 theschool'.

FILES
/etc/ppp/peers/provider is the standard pppd options file for the default service provider. /etc/ppp/peers/<name> is the pppd options file for the provider that you have named <name>. /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. /etc/chatscripts/provider is the standard chat script for the default service provider. /etc/chatscripts/<name> is the chat script for the provider that you have named <name . /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. /var/lib/pppconfig is a private directory for files decribed below. pppconfig creates it if necessary, with permission that permit access only to root. /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. /var/lib/pppconfig/<name> is as above, for the provider named <name>. /etc/ppp/pap-secrets and /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. /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.

NOTES
pppconfig creates temporary files in /tmp. It cleans up after all of these. It requires pppd -2.3 or higher.

CAVEATS
pppconfig 0.9 is beta software.

TO DO
Add full support for multiple providers and MSCHAP. The whole thing should be rewritten in perl.

BUGS
Many, no doubt, though I haven't found them yet. The doFiles get stuff is an ugly hack.

SEE ALSO
pon(1), poff(1), plog(1), pppd(8), chat(8), and whiptail(1).

AUTHOR
pppconfig was written by John Hasler <jhasler@debian.org>.

COPYRIGHT
pppconfig is free software; see the GNU General Public Licence version 2 or later for copying conditions. There is no warranty.