  PPxP Quick Start Guide
  Takashi Manabe,manabe@amitaj.or.jp
  Akira YOSHIYAMA,yosshy@lyra.vega.or.jp

  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.

  11..  CCoonnffiirrmm UUsseerr aanndd GGrroouup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.

     RReedd HHaatt LLiinnuuxx
        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:

          # chmod /dev/ttyS* 660
          # chgrp uucp /dev/ttyS*

     DDeebbiiaann GGNNUU//LLiinnuuxx
        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.

     SSllaacckkwwaarree
        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.

     FFrreeeeBBSSDD
        Account uucp and members of dialer group can read and write
        /dev/cuaa*. So add PPxP users to dialer group.

  22..  QQuuiicckk DDiiaalluupp

  The standard user interface of PPxP is ppxp. First, run ppxp and the
  prompt ppxp> comes. Next, command 'qdial'.

       % ppxp
       PPxP version ...
       interface: ul0
       ppxp> qdial

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

     DDeevviiccee NNaammee[[//ddeevv//mmooddeemm]]
        Enter the device name of a serial port connected to a modem.
        /dev/ttyS0 means COM1 in DOS, /dev/ttyS2 as COM2.

     MMooddeemm TTyyppee[[ggeenneerriicc]]
        Specify a modem configuration file. Hit Enter key if you use a
        generic Heis AT compatible modem.

     AAuutthheennttiiccaattiioonn PPrroottooccooll[[PPAAPP CCHHAAPP]]
        Specify authentication protocol. If you know that whether PAP or
        CHAP is your ISP's authentication protocol, specify it.
        Otherwise hit Enter key.

     DDiiaall TTyyppee[[TToonnee]]
        If your telephone has push button and dials with tones, Specify
        Tone. Otherwise specify Pulse.

     PPhhoonnee NNuummbbeerr
        Specify your ISP's phone number. For example, you can also enter
        123456 as 12-3456.

     LLooggiinn NNaammee
        Enter your account name for PPP connection to your ISP. If you
        have two username for one account, specify one not for mail
        server.

     LLooggiinn PPaasssswwoorrdd
        Enter a password for PPP connection. No display entering. If
        you've mistaken, Push CTRL+u and enter the password from
        beginning again.

     LLooggiinn PPaasssswwoorrdd((aaggaaiinn))
        Re-enter your password. This confirms that your password isn't
        mis-entered.

  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.

       Dial now[yes]?
       ppxp>
               ...
       PPXP> quit
       %

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

  33..  UUsseerr//PPaasssswwoorrdd RReeggiissttrraattiioonn

  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.

       % ppxp
       PPxP version ...
       interface: ul0
       ppxp>

  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.

       ppxp> passwd quick
       Name:XYZ01234
       Password:
       ppxp> passwd
                    NAME         PASSWORD     GROUP        SCRIPT
       quick        XYZ01234     fCQ0UlE/clRl

  44..  MMooddeemm SSeettttiinngg

  To load generic modem settings, run ppxp command with qdial
  designation.

       % ppxp qdial
       PPxP version ...
       interface: ul0
       ppxp>

  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.

       ppxp> set auth.passwd quick

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

       ppxp> set auth.proto chap

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

       ppxp> set line /dev/ttyS1

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

       ppxp> set dial.list 123456

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

       ppxp> set dial.type tone

  55..  DDiiaalliinngg

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

       ppxp> connect
       PPXP>

  To exit, enter disconnect.

       PPXP> disconnect
       ppxp>

