home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / utilities / _comms / comms / _tcpip / readme10 < prev    next >
Encoding:
Text File  |  1992-02-23  |  6.5 KB  |  139 lines
  1. Welcome to the Beta release of NET.EXE for the Acorn Archimedes
  2.  
  3. The version I have based this port on is 871225.33n by G1EMM. It is a good
  4. stable release of the program and was therefore chosen as the version to
  5. port from. I would have liked to port the 890421.1 release but I did not
  6. have the source code for that version to hand. The vast majority of the
  7. porting of the code was not involved with Archimedes specific features but
  8. with adding ANSI prototype definitions to header files and removing the
  9. typical UNIX style lax programming techniques. During the port a number of
  10. minor bugs were discovered because of the very strict type checking and
  11. printf() argument checking carried out by the Acorn C Compiler. The Acorn
  12. specific code is contained in three files one of which is a couple of
  13. assembler hooks to the serial port functions.
  14.  
  15. I would like to do a port of NOS to the Archimedes one day, but unfortunately
  16. NOS is undergoing development and I am not aware of an official user
  17. release in the same way that NET has. I have no easy access to either the
  18. Internet or JANET so I cannot get regular source updates except by
  19. pestering others to do it for me.
  20.  
  21. To install the software, create your sub-directory and copy the files and
  22. sub-directories into it. Create a directory called TMP (or tmp, Tmp, TmP etc)
  23. in your root directory, make the directory where you copied the program
  24. files your current working directory, press F12 and then type "net". All
  25. being well it should start working.
  26.  
  27. This program does assume a lot of familiarity with PC based versions of the
  28. program. A few obvious differences come to mind:
  29.  
  30. 1. The configuration file for BM (the mailer) is not BM.RC but is called
  31.    BMconfig.
  32.  
  33. 2. RISC OS commands can be executed directly from the net> prompt by
  34.    typing (for example ) "* ex". There is a space between the star and the
  35.    rest of the command is imposed by the command parser. In BM the command
  36.    can be "*EX" as normal.
  37.  
  38. 3. The command line under 871225.33n is a bit better than most copies of
  39.    net that I have seen. Pressing F3 recalls the last command line, control
  40.    U kills the present line, and control W deletes the latest word.
  41.  
  42. 4. In FTPusers, the users root directory must be in RISC OS format. This
  43.    limitation does not extend to normal FTP users, although the FTP RFC
  44.    allows such things as directory names to be in the native format, that
  45.    would confuse too many users.
  46.  
  47. 5. A known bug in this release (including the original PC version) is that
  48.    under some error conditions, the FTP client thinks that it is in data
  49.    transfer mode when it isn't so the user has to type "abort" before
  50.    continuing.
  51.  
  52. 6. A user doing a "dir" in FTP will get a full RISC OS "*EX" type directory
  53.    listing complete with file types etc. The "ls" command provides just the
  54.    file names, just the way the RFC specifies.
  55.  
  56. 7. Wild card lookup in FTP doesn't work. A user cannot do a "dir w*", it
  57.    should be done by the time the full release appears.
  58.  
  59. 8. I have added the MEMDUMP command. It allows memory to be dumped as the
  60.    program is running. By default it starts at 0x8000 and will dump 160
  61.    bytes every tume the command is given, the position of memory to be 
  62.    dumped is incremented every time the command is given (the F3 key is
  63.    useful here). You may give the starting address as an option when
  64.    giving the MEMDUMP command ie memdump 9000. I have included a copy of
  65.    the linker map listing to make navigation a little easier, and of course
  66.    the tcpstat, udpstat etc. give the address of the appropriate control
  67.    block.
  68.  
  69. 9. Because the program is designed to support only the internal serial port
  70.    of the Arc, the attach command is somewhat different. It is of the form
  71.    attach asy internal <slip|ax25|nrs> <label> <buffer> <mtu> <speed>
  72.           [<callsign>]
  73.    The internal label allows some options for supporting other serial
  74.    adapters but the concept of interrupt and address is redundant. The buffer
  75.    value is also ignored internally.
  76.  
  77. 10.The trace command has been modified to allow the tracing of packets to
  78.    be turned on only when in command mode, this is the default. As well as
  79.    the normal trace command "trace tnc 111" etc. You can also say
  80.    "trace tnc cmdmode|allmode" in allmode the packets are traced at all
  81.    times. Only the first character is significant in cmdmode and allmode.
  82.  
  83. 11.I have added the asystat command. It was missing in 871225.33n.
  84.  
  85. 12.I have removed the remote server and client. If there is demand I will
  86.    put it back in although I am suspicous of it myself.
  87.  
  88. Because of the lack of local IP use (none to be precise) most of my
  89. testing has been over a slip link to my PC running the same version of
  90. the software. This method allowed me to hammer the IP, TCP and servers
  91. without generating radio traffic. I tested the AX25 and NET/ROM support
  92. code by logging into the local mailbox, in fact my original bulletin about
  93. this software was sent using the program. I then went on to destroy a TNC
  94. in the excitement of getting this to work.
  95.  
  96. What I was getting around to saying was that certain sections of the code
  97. have not been tested much, or at all. The sections that I require you to test
  98. for me especially are:
  99.  
  100. SMTP                      - not tested at all
  101. IP over NET/ROM, AX25 ... - not tested at all
  102. NRS support               - not tested at all (does anyone care about it ?)
  103. AX25 and TELNET mailbox   - not tested at all
  104.  
  105. I will be very interested in ALL bug reports of course.
  106.  
  107. My eventual aim with this software is to convert the protocols and servers
  108. to run as a relocatable module, and to have the clients run as WIMP tasks.
  109. This is a very long term aim and so don't hold your breath waiting for it.
  110.  
  111. The example Hosts file is minimal to allow me to test the software with my
  112. PC attached via slip. In fact none of my configuration files are much good
  113. so a decent set of configuration file for eventual release would be nice to
  114. have.
  115.  
  116. Well thats about it for now. I hope my exercise in porting this program has
  117. been worthwhile and meets with your approval, I enjoyed doing it, and look
  118. forward to doing further modifications. As in the PC version of NOS, I would
  119. like to receive all modifications and bug fixes so that they can be
  120. incorporated into the main release of the program.
  121.  
  122. Some of the code, especially the Arc specific stuff, is a bit hacked and
  123. is in need of tidying up. Possibly better RISC OS calls can be made to
  124. improve the code but it does the job OK.
  125.  
  126. 73's
  127.  
  128. Jonathan Naylor G4KLX @ GB7HMZ [44.131.4.1]
  129.  
  130. 24 Castle View Drive
  131. Cromford
  132. Matlock
  133. Derbyshire
  134. DE4 3RL
  135.  
  136. Tel (Home): 0629 822037
  137. Tel (Work): 0629 580000 x7791
  138.  
  139.