# The &kppp; Handbook

## Introduction

&kppp; is a dialer and front end for pppd. It allows for interactive script generation and network setup. It will automate the dialing in process to your ISP while letting you conveniently monitor the entire process.

Once connected &kppp; will provide a rich set of statistics and keep track of the time spent online for you.

A built-in terminal and script generator will enable you to set up your connection with ease. You will no longer need an additional terminal program such as seyon or minicom to test and setup your connection.

&kppp; features elaborate phone cost accounting, which enables you to easily track your online costs.

We hope you enjoy this dialer, and that it eases your way onto the internet.

&getting-online; &wizard; &dialog-setup; &global-settings; &security; &chap-and-pap; &tricks; &callback; &kppp-faq;

## Credits and License

&kppp;

&kppp; is derived from ezppp 0.6, by Jay Painter. However, nearly everything in &kppp; was rewritten so ezppp and &kppp; do not have much in common any longer.

Primary Developers:

- Bernd Johannes Wuebben wuebben@kde.org

- Mario Weilguni mweilguni@sime.com

- Harri Porten porten@kde.org (Current maintainer)

Many thanks to the following people who have contributed code to &kppp;

- Jesus Fuentes Saaverdra jesus.fuentes@etsi.tel.uva.esfor implementing several options and miscellaneous work.

- Markus Wuebben wuebben@eure.de for the ATI query dialog

- Peter Silva peter.silva@videotron.ca for pop up dialogs and other contributions

- Martin A. Brown MABrown@etcconnect.org

- Martin Häfner mh@ap-dec717c.physik.uni-karlsruhe.de for the section on callback.

- Olaf Kirch okir@caldera.de for the introduction to the mysteries of file descriptor passing.

Documentation copyright 2001 Lauri Watts lauri@kde.org, although largely based on the original by Bernd Johannes Wuebben wuebben@kde.org

&underFDL; &underGPL;

## Installation

### How to obtain &kppp;

&install.intro.documentation;

### Compilation and Installation

&install.compile.documentation;

### Preparing your Computer for a PPP Connection

The following sections contain some fairly generic information for several common operating systems which might run &kppp;. The following sites may be of interest for further information about the ppp protocol, pppd and networking in general:

- The &Linux; PPP &FAQ;: http://metalab.unc.edu/mdw/FAQ/PPP-FAQ.html

- The &Linux; PPP HOWTO: http://metalab.unc.edu/mdw/HOWTO/PPP-HOWTO.html

- http://www.thoughtport.com:8080/PPP/index.html

- The Network Administrators' Guide: http://metalab.unc.edu/mdw/LDP/nag/nag.html

#### Preparing a &Linux; system for PPP

In order for &kppp; (or indeed, pppd) to work, your kernel must have ppp support compiled in. If this is not the case, get yourself the latest version of pppd from any of the popular &Linux; archives (such as ftp://sunsite.unc.edu/pub/Linux/system/Network/serial/ppp/, and recompile your kernel with ppp support enabled.

Don't fret, since this sounds a lot scarier than it actually is. Don't forget to install pppd afterwards.

If you're not sure if you have a kernel with ppp support, issue the `dmesg` at the command prompt and look for something like this:

    PPP: version 2.3.0 (demand dialing)
    TCP compression code copyright 1989 Regents of the University of California
    PPP Dynamic channel allocation code copyright 1995 Caldera, Inc.
    PPP line discipline registered

&kppp; tries to find out for itself if your kernel supports PPP. If not, you will be notified as soon as &kppp; starts up.

For &Linux; 2.x kernels, the pppd daemon should be version 2.3 or greater. You can find out what version your system has, by issuing the command ``pppd` `--version`` on the command line. None of the pppd daemons actually have a `--version`, but putting the option in will cause the pppd daemon to issue an error message, and then to print out a list of options and other information, which includes the version of the ppd daemon.

&hayes-reference; &accounting; &documentation.index;