home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / ppp221 / !ReadMe < prev    next >
Text File  |  1996-12-20  |  13KB  |  278 lines
  1. PPPdriver (2.21) - PPP driver for Acorn TCP/IP stack and FreeNet 2.XX
  2.  
  3. NOTE: this program is SHAREWARE. Read the 'Licence' file for more info.
  4.  
  5. PPP is a network protocol that allows two computers to exchange IP packets
  6. over serial lines. It is used by most Internet providers to allow remote
  7. computers to connect to Internet via a modem dialup.
  8.  
  9. PPPdriver allows the Acorn TCP/IP stack or FreeNet to communicate with remote
  10. hosts using serial lines. PPPdriver conforms to the DCI4 specification: this
  11. means that it will currently work with Acorn's Internet software (both
  12. version 4.07 and 5.02) and with FreeNet 2.00 or later but doesn't work with
  13. older versions of FreeNet (eg. 1.02) that are DCI2-compatible.
  14.  
  15. A DCI2-compatible PPPdriver is available as a separate package. Note that the
  16. DCI2 PPPdriver is no longer supported since a DCI4 version of FreeNet is
  17. finally available (version 2.00 or later) and Acorn includes its own DCI4
  18. Internet stack in RISC OS 3.60 or later.
  19.  
  20. Since PPPdriver is a rather plain port of the Unix pppd command and supports
  21. the same command line interface, the documentation for PPPdriver will be
  22. limited, refer to the pppd manual (supplied in the 'pppd_man' file) for more
  23. detailed informations of the pppd syntax, authentication and routing.
  24.  
  25.  
  26. Index
  27. -----
  28.  
  29. - Installing
  30. - Commands provided
  31. - PPP files
  32. - Connecting to an Internet provider
  33. - SLIP vs PPP
  34. - Disclaimer
  35. - Known bugs
  36. - Limitation of the ShareWare version
  37. - Upgrades
  38. - Contacting the Author
  39.  
  40.  
  41. Installing
  42. ----------
  43.  
  44. PPPdriver can be installed either in the !Internet.drivers directory or in
  45. !System.Modules.Network, together with all the other drivers. You should also
  46. copy the "PPP" directory supplied in the PPPdriver archive in
  47. !Internet.files.
  48. If you are using PPPdriver with FreeNet 2.XX you should install PPPdriver in
  49. the !FreeNet.Drivers directory alongside SLIPdriver and copy the "PPP"
  50. directory in !FreeUser.Files.
  51.  
  52. PPPdriver can be loaded just like SLIPdriver (2.00):
  53. RMRun INet:drivers.PPPdriver            (if you installed it in !Internet.drivers)
  54. or
  55. RMRun System:Modules.Network.PPPdriver  (if you installed it in !System.Modules.Network)
  56. or
  57. RMRun FreeNet:Drivers.PPPdriver         (if you are using it with FreeNet 2.XX)
  58.  
  59.  
  60. Commands provided
  61. -----------------
  62.  
  63. PPPdriver provides 4 commands: pppd, pppstats, pppkill and pppreopen.
  64.  
  65. *pppd
  66.  
  67. This is the most important command since it deals with the setup of a PPP
  68. connection. pppd works like Unix's pppd (with a few restrictions and
  69. changes), refer to the pppd manual for a full documentation.
  70. Unlike its Unix counterpart (that requires a tty name and speed), RISC OS
  71. pppd accepts the name of the serial driver, the port number and the speed
  72. (just like SLIPdriver).
  73.  
  74. PPP is an 'intelligent' protocol, it negotiates all the options between the
  75. two connecting hosts in order to deal with different setups and requirements.
  76. This means that usually the command required to connect to an Internet
  77. provider is just:
  78. pppd modem defaultroute noipdefault <Driver> <Port> <Speed>
  79. - 'modem' means that PPPdriver will use modem control lines (Carrier Detect,
  80.   Data Terminal Ready) and hardware flow control (RTS/CTS)
  81. - 'defaultroute' causes PPPdriver to set the default route to the remote host
  82.   (ie it automatically execute a "route add default <RemoteIP> 1" command)
  83. - 'noipdefault' means that PPPdriver will ask the local IP address to the
  84.   remote host (this is needed for dynamically allocated IP addresses but
  85.   should also work for fixed IP addresses)
  86.  
  87. Note that PPPdriver, unlike SLIPdriver, doesn't need any "ifconfig" or "route
  88. add" command since pppd automatically executes them once the IP negotiation
  89. is done.
  90.  
  91. If your provider requires PAP authentication you need to use something like:
  92. pppd modem defaultroute noipdefault user <Username> pwd <Password> <Driver> <Port> <Speed>
  93.  
  94. If you need to specify your IP address or the remote IP address:
  95. pppd modem defaultroute noipdefault <LocalAddr>:<RemoteAddr> <Driver> <Port> <Speed>
  96. You can omit <RemoteAddr> or <LocalAddr> if you just need one of the two.
  97.  
  98. Other useful parameters:
  99. - 'local' is the opposite of 'modem' (ie don't use hardware flow control and
  100.   modem control lines). It can be used if you need to connect two computers
  101.   using a very simple nullmodem cable with just the send and receive line.
  102. - 'asyncmap 0' can be used to prevent PPP from sending control characters as
  103.   a two-character escape sequence. You should only need this option if you
  104.   are connecting together two computers using a nullmodem cable.
  105. - 'passive' prevents PPP from closing the connection if the remote host
  106.   doesn't reply to the negotiation packets. This can be used if you want to
  107.   try a PPP connection and eventually keep PPP listening if the remote host
  108.   isn't ready.
  109. - 'silent' is similar to 'passive' but doesn't even initiates a connection
  110.   (ie PPP will just wait to receive some valid negotiation packet)
  111. - 'debug' causes PPPdriver to print a lot of extra debug informations in the
  112.   debug file (see 'PPP files' below). You should only use this parameter if
  113.   PPPdriver fails the negotiation process; in fact it will log every packet
  114.   sent and received, so the debug file will grow very quickly.
  115.  
  116. If you need some esoteric pppd parameter you can have a look at the pppd
  117. manual. Note that the following commands are not implemeted because they are 
  118. very Unix-specific: connect, disconnect, file, lock, detach, kdebug, login.
  119. The configuration files (/etc/ppp/options and ~/.ppprc) mentioned in the pppd
  120. manual are not implemeted, while the files stored (under Unix) in /etc/ppp
  121. (eg ip-up) are stored (under RISC OS) in the InetDBase:PPP directory (ie
  122. !Internet.files.PPP, usually). Finally, the 'pwd' parameter (used to specify
  123. the PAP password) available in the RISC OS version is not available under
  124. Unix; if you want you can use the 'pap-secr' file as in Unix although this is
  125. not recommended nor useful.
  126.  
  127. *pppstats
  128.  
  129. This command shows some statistics about the PPP connections. The only
  130. parameter accepted by 'pppstats' is 'all' that allows more statistics to be
  131. displayed.
  132. You can use this command to monitor the efficiency of the BSD Compression (if
  133. it is used) and the quality of the serial line. When the serial line doesn't
  134. lose any packet the "receive parity errors", "receive framing errors",
  135. "unknown types received" and "input packets tossed" figures should be 0.
  136.  
  137. *pppkill
  138.  
  139. To close an active connection you should use the 'pppkill <ppp unit>' command
  140. (eg. 'pppkill 0' if you want to close the first connection). PPPdriver will
  141. then send the 'connection closed' packets to the remote host and drop the
  142. connection. An alternative way to close all the PPP connections is to 'RMKill
  143. PPPdriver' although this is a very rough and not recommended method!
  144.  
  145. *pppreopen
  146.  
  147. This command is only useful if BSD Compression is used and forces PPPdriver
  148. to restart the compression negotiation. This can be useful if the compression
  149. has been disabled due to some failures (eg packets lost due to serial line
  150. failures) but should not be used otherwise; to detect this case you should
  151. try the 'pppstats' command, if it says "BSD Compression (currently disabled)"
  152. you could try to reenable it using 'pppreopen'.
  153.  
  154.  
  155. PPP files
  156. ---------
  157.  
  158. PPPdriver prints some information about the connection in the file
  159. !Internet.DebugPPP (or !FreeUser.DebugPPP). Unless you specify the 'debug'
  160. flag on the 'pppd' command line (see above) it just prints a few informations
  161. once the connection is established, otherwise it prints much more debug
  162. messages, including the dump of every sent and received packet.
  163. This file may grow larger and larger, especially if the system crashes (or
  164. you reset it) while PPPdriver is loaded; you must always "RMKill PPPdriver"
  165. before turning the computer off! If everything is working fine you should
  166. delete this file regularly, but if PPPdriver fails the negotiation process 
  167. or if you notice something strange (eg excessively slow or often dropped
  168. connections, incorrect routing, etc.) you should send this file to me so that
  169. I could hopefully find the cause of your problems.
  170.  
  171. PPPdriver uses the !Internet.files.PPP (or !FreeUser.Files.PPP) directory to
  172. store the 'i