home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / MISC / mtp.shar / README < prev    next >
Text File  |  2009-11-06  |  4KB  |  106 lines
  1.  
  2.         MTP - a Module Transfer Programme
  3.         =================================
  4.  
  5.     Mtp is one solution to the missing link needed to make OS-9 usable
  6. in much the same sort of environment as VxWorks provides. That is, an
  7. embedded diskless OS-9 node (or nodes) connected to a cross-development
  8. workstation via TCP/IP, with executables being downloaded from the host
  9. directly into the memory of the targets for execution.
  10.  
  11.     What does mtp consist of? Mtp allows you to transfer OS-9 memory
  12. modules stored in files on the host's file system into the OS-9 system's
  13. memory space, where they are added into the memory module list. Just the
  14. same effect as the OS-9 load command. EXCEPT that if you try to download a
  15. module and there already exists one with that name, then the one in the
  16. memory is removed and replaced with the new one. It is also possible to
  17. copy modules from the OS-9 system's memory into files on the host. In
  18. operation, the user interface on the host is very much like ftp. See the
  19. man page mtp.l for more details.
  20.  
  21.     Details on the communication sequence are given in the file ReadMe.
  22. There is a daemon (mtpd) that runs on the OS-9 target. There is programme
  23. for the host (mtp) that makes contact with the daemon. (The port number
  24. used is currently fixed within the code.) The daemon forks off a handler
  25. (mtpdc) which interacts with mtp to handle module transfers. The handler
  26. uses a child process (mtpvalid) to add modules to the memory module list.
  27.  
  28.     By the way, mtp was written long before Microware fixed the bug in
  29. their ftp implementation which meant that it was necessary to have a 
  30. harddisk to use ftp. So an alternative to mtp nowadays is to use ftp from
  31. a ramdisk. But I still think mtp is better.
  32.  
  33.  
  34.  
  35. INSTALLATION
  36. ============
  37.  
  38.     We use a Sun cross-development system to compile the code (V3.2). Our
  39. target is a Motorola MVME147 running OS-9 V2.4. I have only created the
  40. host side for a Sun workstation. Before compiling, you probably need to
  41. change some of the paths inside the Makefile. The target routines (mtpd,
  42. mtpdc, mtpvalid) must have super-user privileges (I think) - hence the
  43. fixmod commands in the Makefile.
  44.  
  45.     I have mtpd, mtpdc, and mtpvalid in my boot proms, and a modified
  46. startup routine which forks off mtpd after starting up the ISP package.
  47.  
  48.  
  49. FILES
  50. =====
  51.  
  52.  
  53. Makefile    -    make file
  54. README        -    this
  55. ReadMe        -    describes the communications protocol
  56. mtp.c        -    host side user interface
  57. mtp.h        -    defs common to both sides
  58. mtp.l        -    UNIX man page
  59. mtpcmds.c    -    host side comms handler
  60. mtpcommon.c    -    code common to host and target
  61. mtpd.c        -    target side daemon
  62. mtpdc.c        -    target side connection handler
  63. mtpvalid.c    -    target side process to add module to directory
  64.  
  65.  
  66. BUGS
  67. ====
  68.  
  69.  
  70.     Since mtp uses a TCP/IP connection, it assumes that the socket
  71. connection is error-free. This is not the case on one of our machines (a
  72. hardware fault we think) and occassionally the data gets corrupted (e.g.,
  73. modules are downloaded that cannot be validated) or gets lost and so mtp
  74. hangs up. It should really recover from the latter type of error.
  75.  
  76.  
  77.  
  78. WISHES
  79. ======
  80.  
  81.     
  82.     I think it would be useful if mtp could pack/unpack data between
  83. data modules on the OS-9 side and "ordinary" files on the host side - but
  84. I haven't done that yet.
  85.  
  86.  
  87.  
  88. AUTHOR
  89. ======
  90.  
  91.  
  92.     This is my current address
  93.  
  94.  
  95.     Dr Alan M. McIvor        Tel: +44 932 764252
  96.     BP International        Fax: +44 932 764469
  97.     Research Centre Sunbury     Eunet:    alanm%bprcsitu.uucp@uknet.ac.uk
  98.     Chertsey Road            Internet: alanm%bprcsitu.uucp@relay.net.eu
  99.     Sunbury on Thames
  100.     Middlesex TW16 7LN
  101.     U. K.
  102.  
  103. but since I am 90% certain that I will be made redundant on 6 March 1991
  104. this may not be particularly useful for trying to contact me.
  105.  
  106.