home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / internet / other / ka9q / nhclb120.zoo / readme.0 < prev    next >
Encoding:
Text File  |  1992-12-09  |  6.7 KB  |  225 lines
  1. README and FAQ for the ka9q source code for Unix, Atari-ST and other machines.
  2. ======     ===         ================
  3.  
  4. by Dave Evans ( devans@hclb.demon.co.uk )
  5.  
  6. 1 December 1992, ver 1.20,   from nhclb120.lzh README.0
  7.  
  8. So, you want to compile ka9q for your machine ?  Good for you ! - I
  9. need all the help I can get.  I have to warn you that the job you have
  10. taken on is not a piece of cake.  The sources are in a mess, there are
  11. innumerable makefiles and readme files, of which this is only the
  12. first.
  13.  
  14. The current (1/12/92) source file is "nhclb120.lzh",  but later versions may
  15. soon exist.
  16.  
  17. If you are reading this on an Atari ST, you will notice that all files
  18. have the Unix line ending convention.  Sorry about that.  There are at
  19. least 2 editors that don't make a big deal about about Unix files:
  20. MICROEMACS and EMACS.  I suggest you use one of them if your favourite
  21. editor is barfing.
  22.  
  23. If you haven't already done so, I suggest you try out the executbale
  24. file for your machine and set up a working net.  Execuables (binaries)
  25. for the Atari and SCO Unix can be found on gate.demon.co.uk in the
  26. pub/atari and pub/unix directories,(I think) and on CIX in the
  27. tenner.a.month/atari and tenner.a.month/files conferences.  I suspect
  28. that the files in /files are more up-to-date.
  29.  
  30. Make sure you get the latest version, usaully called N89*.lzh. I don't
  31. have any control over either of the two sites, so the files may get
  32. moved or deleted without my knowing.  You've probably noticed by now
  33. that my favourite archiver is LHA/LHARC.  Sorry about that, but it
  34. does create files 20% smaller than compress, hence saving YOUR BT/Hg
  35. bill.  I will always use LHARC version that is compatible with the
  36. oldest ST LHARC.
  37.  
  38. New versions of net source and executables will be uploaded to
  39. gate.demon.co.uk *ONLY*_, now that Cix has got access to the Internet.
  40. This means, if you are on CIX, that you will have to download the NET
  41. files from the tenner.a.month/files conference first to get access
  42. into gate. Alternatively, you can use the CIX Internet ftp gateway to
  43. get files from gate.demon.co.uk direct into your local Cix directory,
  44. and then download them from there.
  45.  
  46.  
  47. The executable archives come with more wonderfull docuemtation, and
  48. some useful configuration files.  You will have to edit them for your
  49. setup and hostname, IP address, etc.
  50.  
  51. CONFESSION 
  52. ----------
  53.  
  54. I've never actually got around to trying the NET programs on DIS
  55. (Demon Internet Services ).  Other people are using the programs, and
  56. I've had very few complaints -maybe they are too polite.
  57.  
  58. The ATARI ST version has been tested against the latest PC KA9q, and
  59. also on 386BSD and my SCO Unix version.  The SCO Unix version has been
  60. tested against the ST version.  The source code for both my versions
  61. is 95% identical, so bugs may be cancelling out.
  62.  
  63.  
  64. MAKEFILES
  65. ---------
  66.  
  67. makefile.bsd     for BSD Unix,  I've tried it and it does not work on 386BSD
  68. makefile.scg +   SCO UNIX 3.2.2,  gcc 1,39
  69. makefile.stg +   ATARI ST,  gcc 1,39  gcc 2.0 and later
  70. makefile.stm     ATARI ST,  Mark Williams C.  Probably broken, tested long ago.
  71. makefile.ung     Unix, gcc 1.39  not really tested by me
  72. makefile.unx     Unix, native compiler, not tested by me
  73. makefile.lnx     Linux, under development.
  74.  
  75. + = tested and supported by me.
  76.  
  77. depend.out
  78. ----------
  79.  
  80. The existing depend.out file has been shrunk to save space in the
  81. archive. If you start changing the source, you will have to create a
  82. proper depend.out file.  "make depend" on Unix.  On the ST there is a GCC
  83. option, which I've forgotten at this moment, to create a dependency
  84. file.  You will probably have to edit it by habd into the makefile - I
  85. don't think "include depend.out" works in make files on the ST.
  86. You may find a depend.st file lying around, but I would not bank on it working
  87. properly.
  88.  
  89.  
  90. COMPILING
  91. ---------
  92. I've tried to get rid of most of the compiler warnings.  There are still
  93. a few left, mostly in the AX25 stuff, which we never use ( Amateur
  94. Radio networking).  Ignore.
  95.  
  96. "gcc -Wall"  will rip everything to shreds.  I daren't uuse it !
  97.  
  98.  
  99. BUGS
  100. ----
  101.  
  102. SCO UNIX 3.2.2
  103.  
  104. You may see the message "bad file descriptor passed for device 0" This
  105. just means that you don't have the serial device set up in your
  106. net.rc.  There is no way of quitting form this message - you have to
  107. kill from another terminal
  108.  
  109.  
  110. ATARI ST
  111.  
  112. Telnet crashes when conmnecting to some hosts, it is trying to pass
  113. the ntype of the termial (vt52 or tty).  Only vt52 emulation is
  114. supported, and I'm not sure about even that.
  115.  
  116. Control-C in telnet is buggy,
  117.  
  118. CR and LF handling is a mess.  The gcc library deals with it, and it
  119. conflict with net's .  You can see this if someone fingers your finger
  120. files.
  121.  
  122. The maximum serial buufer size is 32k. I was under the impression it
  123. could be as much as you could allocate.
  124.  
  125.  
  126. ENHANCEMENTS from original ka9q
  127. ------------
  128.  
  129. net -x 
  130. displays where net expects to find files and directories 
  131.  
  132. telnet host service,    service can be a name, eg smtp or telnet - save
  133. looking up RFCs - yeah, big deal.
  134.  
  135.  
  136. / or \ in filenames (ST only)
  137. -----------------------------
  138.  
  139. nets compiled with gcc libraries don't really care which one you use
  140. on the ST.
  141.  
  142.  
  143.  
  144. VERSION
  145. -------
  146.  
  147. The curenet verson of net is 1.20 (1/12/92) This is purely a
  148. renumbering exercise, there is no difference from net 1.13.
  149.  
  150. ORIGINS
  151. -------
  152.  
  153. The source code for NET came from a site at rutgers.edu.  I've
  154. forgetten where exactly where though.  It was meant for Linux.
  155.  
  156.  
  157. FUTURES
  158. -------
  159.  
  160. It should be possible to re-integrate the source back into the the
  161. current Linux version.
  162.  
  163. If I find a suitable NNTP CLIENT source then I will put it in.  The
  164. Archimedes can do NNTP, so there is hope yet.
  165.  
  166.  
  167. INSTALL
  168. ------- 
  169.  
  170. There is an INSTALL file.  I think it is meant for Linux.  Not tested.
  171. Read the docs.
  172.  
  173.  
  174. MORE INFO
  175. ---------
  176.  
  177. see README.*
  178.  
  179. The latest PC KA9Q
  180.  
  181. docs in the other ka9q files,  N89*.lzh 
  182.  
  183. RFCs from nic.ddn.mil, can be found on gate.demon.co.uk and on Cix in
  184. the RFC conference.
  185.  
  186. books:
  187. Unix Network Programming,   Stevens W. R.,  ISBN 0-13-949876-1
  188. Computer Networks,          Tanenbaum, A. S, ISBN  ???
  189. Internetworking with TCP/IP Comer,  2 vols, ISBN ???
  190.  
  191. Usenet: comp.protocols.tcp-ip.*, comp.os.linux,comp.unix.bsd and many more.
  192.  
  193. CIX:
  194. conferencces: packet, tenner.a.month, unix, linux, free.software, atari.st (for
  195. the lharc program), cix/internet,  internet, sco
  196.  
  197. DEMON
  198. demon.ip.suppport.*,  demon.*
  199.  
  200. Linux mailing lists fro NET and SLIP 
  201.  
  202.  
  203.  
  204.  
  205. DOCUMEBTATION
  206. -------------
  207. Guy Kewney says it is all incomprehensiblie  I don't dispute that.
  208.  
  209.  
  210.  
  211.  
  212. COPYRIGHTS
  213. ----------
  214. The original source code is copyrighted by Phil Karn.   My mods are
  215. copyright by me, but can be distributed under whatever conditions the
  216. original source is distributed.
  217.  
  218. This file can be distributed under the term of the Free Software Foundation'
  219. General Public Licence (GPL).
  220.  
  221.  
  222. THE END
  223. -------
  224.  
  225.