<!doctype linuxdoc system>

<article>

<title>PPxP Quick Start Guide

<author>Takashi Manabe,<tt/manabe@amitaj.or.jp/ <newline>
	Akira YOSHIYAMA,<tt/yosshy@lyra.vega.or.jp/

<abstract>

This is a document for trying making PPP connection with PPxP via
telephone lines (modems or terminal adapter) quickly. So see another
document for install, command meaning, and more configuration. This
describes an example with PAP/CHAP authentication.

</abstract>

<sect>Confirm User and Group
<p>
PPxP has uid of root, but usually works with uid of its user. So the
PPxP users need uid or gid that can access to special file of modem
device or its lock directory.

<descrip>
<tag>Red Hat Linux</tag>
Gid of /dev/ttyS* is root, so a user can't write these. And one with
gid of uucp can create a file in /var/lock directory. First, add PPxP
users to uucp group, and command below as root:

<tscreen>
<verb>
# chmod /dev/ttyS* 660
# chgrp uucp /dev/ttyS*
</verb>
</tscreen>

<tag>Debian GNU/Linux</tag>
Members of dialout group can read and write /dev/ttyS*, and any user
can create a file in /var/lock directory. So add PPxP users to dialout
group.

<tag>Slackware</tag>
Members of tty group can read and write /dev/ttyS*, and any user can
create a file in /var/lock directory. So add PPxP users to tty group.

<tag>FreeBSD</tag>
Account uucp and members of dialer group can read and write
/dev/cuaa*. So add PPxP users to dialer group.

</descrip>

<sect>Quick Dialup
<p>
The standard user interface of PPxP is ppxp. First, run ppxp and the
prompt <tt>ppxp&gt;</tt> comes. Next, command 'qdial'.

<tscreen>
<verb>
&percnt; ppxp
PPxP version ...
interface: ul0
ppxp&gt; qdial
</verb>
</tscreen>

You will make PPP connection with some configuration like a telephone
number of ISP in quick dialup. Strings fenced with '&lsqb;&rsqb;' in
query message is the default value that will be used with no input.
Push CTRL+d and you will exit this mode.

<descrip>
<tag>Device Name&lsqb;/dev/modem&rsqb;</tag>
Enter the device name of a serial port connected to a
modem. /dev/ttyS0 means COM1 in DOS, /dev/ttyS2 as COM2.

<tag>Modem Type&lsqb;generic&rsqb;</tag>
Specify a modem configuration file. Hit Enter key if you use a generic
Heis AT compatible modem.

<tag>Authentication Protocol&lsqb;PAP CHAP&rsqb;</tag>
Specify authentication protocol. If you know that whether PAP or CHAP
is your ISP's authentication protocol, specify it. Otherwise hit Enter
key.

<tag>Dial Type&lsqb;Tone&rsqb;</tag>
If your telephone has push button and dials with tones, Specify
Tone. Otherwise specify Pulse.

<tag>Phone Number</tag>
Specify your ISP's phone number. For example, you can also enter
123456 as 12-3456.

<tag>Login Name</tag>
Enter your account name for PPP connection to your ISP. If you have
two username for one account, specify one not for mail server.

<tag>Login Password</tag>
Enter a password for PPP connection. No display entering. If you've
mistaken, Push CTRL+u and enter the password from beginning again.

<tag>Login Password(again)</tag>
Re-enter your password. This confirms that your password isn't
mis-entered.

</descrip>

Finary, messages for confirming will be displayed. Hit Enter key and
PPxP will begin dialing. If you enter any strings except 'yes', PPxP
will exit this mode.

<tscreen>
<verb>
Dial now[yes]?
ppxp&gt;
	...
PPXP&gt; quit
&percnt;
</verb>
</tscreen>

If all prompt characters change to large 'PPXP', the PPP connection is
established. enter 'quit' command and ppxp will be exit.

<sect>User/Password Registration
<p>
The quick dial up is one of functions in ppxp command. It's
troublesome to enter your password each time, so ppxp is usually used
with a database file containing your account and password. To register
your password is done with ppxp command.

<tscreen>
<verb>
&percnt; ppxp
PPxP version ...
interface: ul0
ppxp&gt; 
</verb>
</tscreen>

For registration, you need your account name and password on your ISP,
and also need its entry name for password management in PPxP. A entry
name is allowed anything if it's not doubled. Specify a entry name for
a argument of passwd command in ppxp, and ppxp register or changes its
entry. For example, an account 'XYZ01234' and its password 'Test' for 'quick'
entry is registered. Note that entering password isn't be
displayed. If you finish registering, enter passwd command in ppxp and
confirm the registration. Note that the password entry is encoded, so
it's different from your entering. If you command passwd in ppxp and
no entry is displayed, exit and rerun ppxp, and command 'passwd'
again.

<tscreen>
<verb>
ppxp&gt; passwd quick
Name:XYZ01234
Password:
ppxp&gt; passwd
             NAME         PASSWORD     GROUP        SCRIPT
quick        XYZ01234     fCQ0UlE/clRl
</verb>
</tscreen>

<sect>Modem Setting
<p>
To load generic modem settings, run ppxp command with qdial
designation.

<tscreen>
<verb>
&percnt; ppxp qdial
PPxP version ...
interface: ul0
ppxp&gt; 
</verb>
</tscreen>

And generic configuration iss loaded. Next, you need to set some local
configuration. First, specify auth and passwd to use the entry quick
made above.

<tscreen>
<verb>
ppxp&gt; set auth.passwd quick
</verb>
</tscreen>

Enter 'PAP' in auth.proto if the allowed authentication is PAP, 'CHAP'
for CHAP, either if you don't know that.

<tscreen>
<verb>
ppxp&gt; set auth.proto chap
</verb>
</tscreen>

Set modem deivce to line.  '/dev/ttyS0' means COM1 on DOS, '
/dev/ttyS1' as COM2.

<tscreen>
<verb>
ppxp&gt; set line /dev/ttyS1
</verb>
</tscreen>

Set phone numbers of your ISP to dial.list. For example, setting
12-3456 is:

<tscreen>
<verb>
ppxp&gt; set dial.list 123456
</verb>
</tscreen>

Specify 'tone' to dial.type if you use tone dialed telephone line, 'pulse'
if pulse dialed one.

<tscreen>
<verb>
ppxp&gt; set dial.type tone
</verb>
</tscreen>

<sect>Dialing
<p>
Here, it's done. Only to do is dialing. Enter 'connect' and PPP
connection is established if prompt changes to 'PPXP'.

<tscreen>
<verb>
ppxp&gt; connect
PPXP&gt; 
</verb>
</tscreen>

To exit, enter disconnect.

<tscreen>
<verb>
PPXP&gt; disconnect
ppxp&gt; 
</verb>
</tscreen>

</article>