home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / beehive / program / unload.arc / UNLOAD.DOC < prev    next >
Encoding:
Text File  |  1990-07-22  |  3.0 KB  |  69 lines
  1.             DOCUMENTATION FOR "UNLOAD" - Ted Harper 21/12/86
  2.  
  3.  
  4. SYNOPSIS :
  5.  
  6.      UNLOAD is a program for CP/M (2.2 or 3.x) which takes a .COM file and
  7. unLOADs it back to a .HEX file. This is most useful when using PIP (or
  8. similar) to send programs between two computers - since HEX files are only
  9. 7-bit, contain only printable ASCII characters, and have a checksum byte on
  10. the end of each line which PIP can be told to check.
  11.  
  12.  
  13. BACKGROUND INFORMATION :
  14.  
  15.      This program is NOT my original work. It comes from one of the SIG/M
  16. disks, but was distributed without documentation or source code. Since I
  17. (and most other hard disk users) have a degree of paranoia about software
  18. to which source code is not supplied (because of such jolly ruses as "Trojan
  19. Horses", etc), I set about disassembling the program.
  20.  
  21.      I used the DazzleStar (Public Domain) disassembler, and consider it the
  22. best tool of its type I have ever used. The original UNLOAD.COM file may be
  23. examined under DZ using the UNLOAD.DZ DazzleStar data file (both of which
  24. are included in this .LBR file). I have reassembled the .MAC file, and it
  25. appears to be identical to the original .COM file in operation and content.
  26.  
  27.      The comments in the .MAC file are quite comprehensive and (in my opinion
  28. at least) quite accurate. There are a number of useful routines and techniques
  29. demonstrated in the program which are quite interesting to peruse.
  30.  
  31.      Many of the files in this library are CRUNCHed (not SQueezed), but
  32. UNLOAD.DZ is NOT CRUNCHED (i.e. .DZ is its real extension).
  33.  
  34.  
  35. USAGE :
  36.  
  37.      UNLOAD is extremely simple to use. Simply enter "UNLOAD filename.COM"
  38. from the CP/M prompt, and it will go to work, producing a filename.HEX file.
  39. I believe it will work for .OVL-type files as well, but haven't really
  40. figured out the mechanism. Perhaps someone with more time could do that and
  41. update this documentation. It is quite acceptable to rename an .OVR-type file
  42. to filename.COM, UNLOAD it, transfer it as filename.HEX, LOAD or HEXCOM
  43. it back to filename.COM, then rename it to whatever its original name and
  44. extension was.
  45.  
  46.      The HEX file can be re-converted to a .COM file by using the DRI-supplied
  47. LOAD.COM or HEXCOM.COM programs. I have only tested it with HEXCOM, as I only
  48. use CP/M 3.1 on my main system, and it seems to perform accurately (i.e. you
  49. can UNLOAD and HEXCOM a number of times with no obvious corruption of the
  50. subject file).
  51.  
  52.      As my time permits I will be undertaking commented disassemblies of a
  53. number of "object-code only" P.D. utilities. I wish to express my thanks to the
  54. original authors for their work, and all references to them in the object
  55. code have been left untouched. I trust that any person producing updated
  56. versions of the utilities will have the common decency to acknowledge the work
  57. of both the original authors and me, and to include source code with their
  58. offering.
  59.  
  60.  
  61. Ted Harper
  62. P.O. Box 105
  63. Baulkham Hills 2153
  64. N.S.W. Australia
  65. and me, and to include source code with their
  66. offering.
  67.  
  68.  
  69. T