home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 2 / AUCD2.iso / sharewre / ppp200.spk / !ReadMe < prev    next >
Text File  |  1996-01-28  |  12KB  |  268 lines
  1. PPPdriver (2.00) - PPP driver for Acorn TCP/IP stack
  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. PPPdriver allows the Acorn DCI4 TCP/IP stack to communicate with remote hosts
  9. using serial lines. PPPdriver conforms to the DCI4 specification: this means
  10. that it will currently work only with Acorn's Internet software (4.07 at the
  11. time of writing) but doesn't work with FreeNet (that is DCI2-compatible).
  12. A DCI2-compatible PPPdriver is available as a separate package. Both the
  13. DCI2 and DCI4 versions will be available until FreeNet will switch to DCI4;
  14. then the DCI2 version will not be supported anymore.
  15.  
  16. Since PPPdriver is a rather plain port of the Unix pppd command and supports
  17. the same command line interface, the documentation for PPPdriver will be
  18. limited, refer to the pppd manual (supplied in the 'pppd_man' file) for more
  19. detailed informations of the pppd syntax, authentication and routing.
  20.  
  21.  
  22. Index
  23. -----
  24.  
  25. - Installing
  26. - Commands provided
  27. - PPP files
  28. - Connecting to an Internet provider
  29. - SLIP vs PPP
  30. - Disclaimer
  31. - Known bugs
  32. - Limitation of the ShareWare version
  33. - Upgrades
  34. - Contacting the Author
  35.  
  36.  
  37. Installing
  38. ----------
  39.  
  40. PPPdriver can be installed either in the !Internet.drivers directory or in
  41. !System.Modules.Network, together with all the other drivers. You should also
  42. copy the "PPP" directory supplied in the PPPdriver archive in
  43. !Internet.files.
  44.  
  45. PPPdriver can be loaded just like SLIPdriver (2.00):
  46. RMRun INet:drivers.PPPdriver  (if you installed it in !Internet.drivers)
  47. or
  48. RMRun System:Modules.Network.PPPdriver  (if you installed it in !System.Modules.Network)
  49.  
  50.  
  51. Commands provided
  52. -----------------
  53.  
  54. PPPdriver provides 4 commands: pppd, pppstats, pppkill and pppreopen.
  55.  
  56. *pppd
  57.  
  58. This is the most important command since it deals with the setup of a PPP
  59. connection. pppd works like Unix's pppd (with a few restrictions and
  60. changes), refer to the pppd manual for a full documentation.
  61. Unlike its Unix counterpart (that requires a tty name and speed), RISC OS
  62. pppd accepts the name of the serial driver, the port number and the speed
  63. (just like SLIPdriver).
  64.  
  65. PPP is an 'intelligent' protocol, it negotiates all the options between the
  66. two connecting hosts in order to deal with different setups and requirements.
  67. This means that usually the command required to connect to an Internet
  68. provider is just:
  69. pppd modem defaultroute noipdefault <Driver> <Port> <Speed>
  70. - 'modem' means that PPPdriver will use modem control lines (Carrier Detect,
  71.   Data Terminal Ready) and hardware flow control (RTS/CTS)
  72. - 'defaultroute' causes PPPdriver to set the default route to the remote host
  73.   (ie it automatically execute a "route add default <RemoteIP> 1" command)
  74. - 'noipdefault' means that PPPdriver will ask the local IP address to the
  75.   remote host (this is needed for dynamically allocated IP addresses but
  76.   should also work for fixed IP addresses)
  77.  
  78. Note that PPPdriver, unlike SLIPdriver, doesn't need any "ifconfig" or "route
  79. add" command since pppd automatically executes them once the IP negotiation
  80. is done.
  81.  
  82. If your provider requires PAP authentication you need to use something like:
  83. pppd modem defaultroute noipdefault user <Username> pwd <Password> <Driver> <Port> <Speed>
  84.  
  85. If you need to specify your IP address or the remote IP address:
  86. pppd modem defaultroute noipdefault <LocalAddr>:<RemoteAddr> <Driver> <Port> <Speed>
  87. You can omit <RemoteAddr> or <LocalAddr> if you just need one of the two.
  88.  
  89. Other useful parameters:
  90. - 'local' is the opposite of 'modem' (ie don't use hardware flow control and
  91.   modem control lines). It can be used if you need to connect two computers
  92.   using a very simple nullmodem cable with just the send and receive line.
  93. - 'asyncmap 0' can be used to prevent PPP from sending control characters as
  94.   a two-character escape sequence. You should only need this option if you
  95.   are connecting together two computers using a nullmodem cable.
  96. - 'passive' prevents PPP from closing the connection if the remote host
  97.   doesn't reply to the negotiation packets. This can be used if you want to
  98.   try a PPP connection and eventually keep PPP listening if the remote host
  99.   isn't ready.
  100. - 'silent' is similar to 'passive' but doesn't even initiates a connection
  101.   (ie PPP will just wait to receive some valid negotiation packet)
  102. - 'debug' causes PPPdriver to print a lot of extra debug informations in the
  103.   debug file (see 'PPP files' below). You should only use this parameter if
  104.   PPPdriver fails the negotiation process; in fact it will log every packet
  105.   sent and received, so the debug file will grow very quickly.
  106.  
  107. If you need some esoteric pppd parameter you can have a look at the pppd
  108. manual. Note that the following commands are not implemeted because they are 
  109. very Unix-specific: connect, disconnect, file, lock, detach, kdebug, login.
  110. The configuration files (/etc/ppp/options and ~/.ppprc) mentioned in the pppd
  111. manual are not implemeted, while the files stored (under Unix) in /etc/ppp
  112. (eg ip-up) are stored (under RISC OS) in the InetDBase:PPP directory (ie
  113. !Internet.files.PPP, usually). Finally, the 'pwd' parameter (used to specify
  114. the PAP password) available in the RISC OS version is not available under
  115. Unix; if you want you can use the 'pap-secr' file as in Unix although this is
  116. not recommended nor useful.
  117.  
  118. *pppstats
  119.  
  120. This command shows some statistics about the PPP connections. The only
  121. parameter accepted by 'pppstats' is 'all' that allows more statistics to be
  122. displayed.
  123. You can use this command to monitor the efficiency of the BSD Compression (if
  124. it is used) and the quality of the serial line. When the serial line doesn't
  125. lose any packet the "receive parity errors", "receive framing errors",
  126. "unknown types received" and "input packets tossed" figures should be 0.
  127.  
  128. *pppkill
  129.  
  130. To close an active connection you should use the 'pppkill <ppp unit>'
  131. command. PPPdriver will then send the 'connection closed' packets to the
  132. remote host and drop the connection. An alternative way to close all the PPP
  133. connections is to 'RMKill PPPdriver' although this is a very rough and not
  134. recommended method!
  135.  
  136. *pppreopen
  137.  
  138. This command is only useful if BSD Compression is used and forces PPPdriver
  139. to restart the compression negotiation. This can be useful if the compression
  140. has been disabled due to some failures (eg packets lost due to serial line
  141. failures) but should not be used otherwise; to detect this case you should
  142. try the 'pppstats' command, if it says "BSD Compression (currently disabled)"
  143. you could try to reenable it using 'pppreopen'.
  144.  
  145.  
  146. PPP files
  147. ---------
  148.  
  149. PPPdriver prints some information about the connection in the file
  150. !Internet.DebugPPP. Unless you specify the 'debug' flag on the 'pppd' command
  151. line (see above) it just prints a few informations once the connection is
  152. established, otherwise it prints much more debug messages, including the dump
  153. of every sent and received packet.
  154. This file may grow larger and larger, especially if the system crashes (or
  155. you reset it) while PPPdriver is loaded; you must always "RMKill PPPdriver"
  156. before turning the computer off! If everything is working fine you should
  157. delete this file regularly, but if PPPdriver fails the negotiation process 
  158. or if you notice something strange (eg excessively slow or often dropped
  159. connections, incorrect routing, etc.) you should send this file to me so that
  160. I could hopefully find the cause of your problems.
  161.  
  162. PPPdriver uses the !Internet.files.PPP directory to store the 'ip-up' and
  163. 'ip-down' files; they are run, rispectively, when the connection is
  164. established and when it is dropped. The 'PPP' directory distributed with the
  165. PPPdriver archive contains two BASIC files that produce a sound, so you can
  166. 'hear' when the negotiation process is finished and the connection is active.
  167. You can modify them as you like, for example you can make 'ip-up' load some
  168. application (a WWW browser, maybe); I don't recommend you to 'RMKill' any
  169. Internet-related module (eg Internet, INetDB or PPPdriver itself) from the
  170. 'ip-down' script because this may cause some unpredictable result.
  171.  
  172. When you use the 'RegistPPP' program to register your copy of PPPdriver, it
  173. will create a file called !Internet.files.PPP.register. This file will
  174. contain your personal username and usercode, so you should not distribute it
  175. alongside your !Internet directory! For more informations about registering
  176. read the 'Licence' file.
  177.  
  178.  
  179. Connecting to an Internet provider
  180. ----------------------------------
  181.  
  182. To connect to an internet provider I suggest you to use the FreeWare
  183. application FreeDial (by Gert-Jan de Vos). It is very easy to configure and
  184. includes a few script to run either SLIP or PPP with a number of providers.
  185. Alternatively you could use SLIPdial or any other dialer, although I will not
  186. be really helpful if you have problems with them (while I actively support
  187. FreeDial when used in conjunction with PPPdriver).
  188.  
  189.  
  190. SLIP vs PPP
  191. -----------
  192.  
  193. Many people may wonder whether PPP is better than SLIP. PPP is more complex
  194. than SLIP and is used in situations where SLIP isn't suitable, but if you
  195. just need a protocol to connect your computer to Internet and your provider
  196. supports CSLIP (ie Van Jacobson compression of TCP headers over SLIP), then
  197. PPP and SLIP will have the same performance.
  198. SLIP may be more difficult to configure when dealing with dynamic IP (because
  199. you need to get your IP in the connection script while pppd deals with
  200. dynamic IP automatically) but once the configuration script has been written
  201. SLIP and PPP works in the same way.
  202. PPPdriver supports BSD Compression (ie every packet is compressed using the
  203. LZW scheme), if your provider supports it you may have some speed improvement
  204. over SLIP; remember that most modems automatically compress the data too, so
  205. BSD Compression may not give you any significant improvement in this case.
  206. When using a simple wire to connect two computers, BSD Compression may be
  207. really helpful (depending, of course, on the sort of data being transferred).
  208.  
  209.  
  210. Disclaimer
  211. ----------
  212.  
  213. PPPdriver has been tested and proved to be a stable and reliable program.
  214. However, if for any reason (either your mistake or a bug in PPPdriver) it
  215. causes you a loss of data, I am sorry for you but I WILL NOT BE HELD
  216. RESPONSIBLE.
  217.  
  218. Use PPPdriver at your own risk.
  219.  
  220.  
  221. Known bugs
  222. ----------
  223.  
  224. Sometimes the 'pppstats' command prints on the screen a lot of (apparently)
  225. random characters and never stops. You are adviced to use this command in a
  226. TaskWindow so that you can eventually close it; don't try to press Escape
  227. to stop it because probably the whole system will hang.
  228.  
  229. Please report any bug to me, possibly sending the 'DebugPPP' that PPPdriver
  230. creates in the !Internet directory (using the 'debug' option) and the output
  231. of the 'pppstats' command (if relevant).
  232.  
  233.  
  234. Limitation of the ShareWare version
  235. -----------------------------------
  236.  
  237. In the unregisterd version the connection time has been limited to (circa) 10
  238. minutes. When this time expires PPPdriver sends the packets required to close
  239. the connection to the remote host and then closes down: in doing this, it
  240. doesn't produce any error message but prints a message in
  241. '!Internet.DebugPPP'.
  242. The 'RegistPPP' program can be used to register your copy: read the 'Licence'
  243. file for more informations about how to obtain your user name and user code.
  244.  
  245.  
  246. Upgrades
  247. --------
  248.  
  249. The latest version of PPPdriver is always available via WWW at:
  250. http://cdc8g5.cdc.polimi.it/~pel0015/pppdriver.html
  251. You will probably find it also at:
  252. ftp://ftp.dsse.ecs.soton.ac.uk/pub/Acorn/freenet/s.monesi/
  253.  
  254.  
  255. Contacting the Author
  256. ---------------------
  257.  
  258. Post:  Sergio Monesi
  259.        Via Trento e Trieste 30
  260.        20046 Biassono (MI)
  261.        Italy
  262.  
  263. EMail: pel0015@cdc8g5.cdc.polimi.it
  264.        sergio@freebsd.first.gmd.de
  265.        msergio@mbox.vol.it
  266.  
  267. WWW:   http://cdc8g5.cdc.polimi.it/~pel0015/
  268.